Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
golem
command
|
|
|
Package embedding defines the provider-neutral boundary between a generated Golem semantic index and an application-selected embedding service.
|
Package embedding defines the provider-neutral boundary between a generated Golem semantic index and an application-selected embedding service. |
|
Package events contains Golem's narrow event transport and operations ABI.
|
Package events contains Golem's narrow event transport and operations ABI. |
|
cdctest
Package cdctest provides the common checkpoint/replay contract harness that every optional CDC adapter must pass before it can be called supported.
|
Package cdctest provides the common checkpoint/replay contract harness that every optional CDC adapter must pass before it can be called supported. |
|
nats
Package nats provides Golem's maintained Core NATS event transport.
|
Package nats provides Golem's maintained Core NATS event transport. |
|
transporttest
Package transporttest provides the common behavioral conformance harness for every Golem EventTransport.
|
Package transporttest provides the common behavioral conformance harness for every Golem EventTransport. |
|
Package golem exposes compile-time declaration shells and generated-handle types.
|
Package golem exposes compile-time declaration shells and generated-handle types. |
|
Package golemtest is a static policy inspection and proof kit for applications generated by Golem.
|
Package golemtest is a static policy inspection and proof kit for applications generated by Golem. |
|
Package graphql provides Golem's bounded caller-only GraphQL transport.
|
Package graphql provides Golem's bounded caller-only GraphQL transport. |
|
internal
|
|
|
analytics/contract
Package contract normalizes the compiler-owned analytical contract.
|
Package contract normalizes the compiler-owned analytical contract. |
|
codegen/bindings
Package bindings emits and discovers P1 model-attached policy and hook bindings.
|
Package bindings emits and discovers P1 model-attached policy and hook bindings. |
|
codegen/event
Package event emits deterministic typed event values and event-schema registries for subscription-enabled models.
|
Package event emits deterministic typed event values and event-schema registries for subscription-enabled models. |
|
codegen/manifest
Package manifest builds the deterministic inventory that owns generated P1 artifacts.
|
Package manifest builds the deterministic inventory that owns generated P1 artifacts. |
|
codegen/model
Package model emits the same-package descriptor bootstrap used by generated Golem model code.
|
Package model emits the same-package descriptor bootstrap used by generated Golem model code. |
|
codegen/registry
Package registry emits the generated application-level binding registry that composes every model package accessor in canonical import-path order.
|
Package registry emits the generated application-level binding registry that composes every model package accessor in canonical import-path order. |
|
compiler/compile
Package compile composes the provider-neutral schema compiler passes.
|
Package compile composes the provider-neutral schema compiler passes. |
|
compiler/concurrency
Package concurrency owns compiler normalization for the explicit optimistic concurrency declaration.
|
Package concurrency owns compiler normalization for the explicit optimistic concurrency declaration. |
|
compiler/ir
Package ir defines the versioned, provider-neutral compiler interchange representations.
|
Package ir defines the versioned, provider-neutral compiler interchange representations. |
|
compiler/keyindex
Package keyindex resolves keys, indexes, checks, and generated-column assignments against an already resolved scalar ModelIR.
|
Package keyindex resolves keys, indexes, checks, and generated-column assignments against an already resolved scalar ModelIR. |
|
compiler/load
Package load performs the syntax-only package load used by the first compiler pass.
|
Package load performs the syntax-only package load used by the first compiler pass. |
|
compiler/methods
Package methods type-checks and statically interprets GolemModel and GraphQL extension declarations.
|
Package methods type-checks and statically interprets GolemModel and GraphQL extension declarations. |
|
compiler/relation
Package relation links authored relation fields into canonical logical edges.
|
Package relation links authored relation fields into canonical logical edges. |
|
compiler/resolve
Package resolve converts source-located declarations into the base logical model and contract registries.
|
Package resolve converts source-located declarations into the base logical model and contract registries. |
|
compiler/scalar
Package scalar owns provider-neutral logical scalar and default validation.
|
Package scalar owns provider-neutral logical scalar and default validation. |
|
compiler/schema
Package schema extracts source-located unresolved declarations from the accepted closed DefineSchema function and registered model source.
|
Package schema extracts source-located unresolved declarations from the accepted closed DefineSchema function and registered model source. |
|
compiler/schemaexpr
Package schemaexpr constructs and validates the closed P1 database-schema expression language.
|
Package schemaexpr constructs and validates the closed P1 database-schema expression language. |
|
compiler/tags
Package tags parses the deliberately small db and golem struct-tag languages.
|
Package tags parses the deliberately small db and golem struct-tag languages. |
|
concurrencyclaim
Package concurrencyclaim owns the primitive, authority-free representation of optimistic-concurrency claims shared by the public construction facade and the mutation runtime.
|
Package concurrencyclaim owns the primitive, authority-free representation of optimistic-concurrency claims shared by the public construction facade and the mutation runtime. |
|
event/cdc
Package cdc implements the adapter-neutral CDC validation and publication boundary.
|
Package cdc implements the adapter-neutral CDC validation and publication boundary. |
|
event/codec
Package codec owns the canonical, bounded golem.event.v1 transport envelope.
|
Package codec owns the canonical, bounded golem.event.v1 transport envelope. |
|
event/metadatavalue
Package metadatavalue owns the internal capability used to materialize golem.EventMetadata.
|
Package metadatavalue owns the internal capability used to materialize golem.EventMetadata. |
|
event/outbox
Package outbox coordinates immutable mutation facts through durable, causation-level at-least-once publication.
|
Package outbox coordinates immutable mutation facts through durable, causation-level at-least-once publication. |
|
event/provider
Package provider defines the provider-neutral durable delivery coordination contract.
|
Package provider defines the provider-neutral durable delivery coordination contract. |
|
event/provider/providertest
Package providertest contains the provider-neutral P7 delivery state-machine conformance harness.
|
Package providertest contains the provider-neutral P7 delivery state-machine conformance harness. |
|
event/typedvalue
Package typedvalue owns the unforgeable runtime-to-generated-event handoff.
|
Package typedvalue owns the unforgeable runtime-to-generated-event handoff. |
|
event/value
Package value owns the representation of P7's sealed transport values.
|
Package value owns the representation of P7's sealed transport values. |
|
generate/pipeline
Package pipeline composes the complete P1 generation graph in memory.
|
Package pipeline composes the complete P1 generation graph in memory. |
|
generate/publication
Package publication validates, checks, and crash-recoverably publishes a complete manifest-owned generated artifact set.
|
Package publication validates, checks, and crash-recoverably publishes a complete manifest-owned generated artifact set. |
|
graphql/analytics
Package analytics lowers validated GraphQL analytics roots into the same frozen requests consumed by generated Go clients.
|
Package analytics lowers validated GraphQL analytics roots into the same frozen requests consumed by generated Go clients. |
|
graphql/bind
Package bind lowers already-coerced GraphQL inputs into the existing P2/P3 request IR.
|
Package bind lowers already-coerced GraphQL inputs into the existing P2/P3 request IR. |
|
graphql/codegen
Package codegen owns the pinned gqlgen integration.
|
Package codegen owns the pinned gqlgen integration. |
|
graphql/contract
Package contract materializes and validates provider-neutral GraphQL facts.
|
Package contract materializes and validates provider-neutral GraphQL facts. |
|
graphql/custom
Package custom validates and dispatches statically declared custom GraphQL roots.
|
Package custom validates and dispatches statically declared custom GraphQL roots. |
|
graphql/extension
Package extension owns provider-neutral computed-field and custom-operation metadata.
|
Package extension owns provider-neutral computed-field and custom-operation metadata. |
|
graphql/mutation
Package mutation lowers already-coerced, stable-identity GraphQL mutation inputs into P4's frozen public boundary.
|
Package mutation lowers already-coerced, stable-identity GraphQL mutation inputs into P4's frozen public boundary. |
|
graphql/operation
Package operation compiles one validated GraphQL operation into the closed P3/P4 requests owned by the existing engines.
|
Package operation compiles one validated GraphQL operation into the closed P3/P4 requests owned by the existing engines. |
|
graphql/scalar
Package scalar owns exact, provider-neutral GraphQL scalar coercion.
|
Package scalar owns exact, provider-neutral GraphQL scalar coercion. |
|
graphql/schema
Package schema lowers normalized ContractIR plus logical ModelIR into a deterministic provider-neutral GraphQL schema.
|
Package schema lowers normalized ContractIR plus logical ModelIR into a deterministic provider-neutral GraphQL schema. |
|
graphql/select
Package selectset lowers validated GraphQL selection sets into the existing occurrence-aware P3 projection IR.
|
Package selectset lowers validated GraphQL selection sets into the existing occurrence-aware P3 projection IR. |
|
migration
Package migration defines provider-neutral migration planning, immutable history, and execution contracts.
|
Package migration defines provider-neutral migration planning, immutable history, and execution contracts. |
|
migration/explain
Package explain owns the closed, provider-neutral presentation model for Golem migration plans.
|
Package explain owns the closed, provider-neutral presentation model for Golem migration plans. |
|
migration/failpoint
Package failpoint provides context-local migration boundary probes for internal crash-recovery tests.
|
Package failpoint provides context-local migration boundary probes for internal crash-recovery tests. |
|
migration/workflow
Package workflow composes reviewed provider migration history in memory.
|
Package workflow composes reviewed provider migration history in memory. |
|
mutation/batch
Package batch owns the execution-neutral, bounded exact-set contract for update-many and delete-many.
|
Package batch owns the execution-neutral, bounded exact-set contract for update-many and delete-many. |
|
mutation/bind
Package bind validates frozen public mutations against the active immutable schema registry and converts them into provider-neutral mutation IR.
|
Package bind validates frozen public mutations against the active immutable schema registry and converts them into provider-neutral mutation IR. |
|
mutation/decode
Package decode owns immutable, closed persisted-row images for P4 mutations.
|
Package decode owns immutable, closed persisted-row images for P4 mutations. |
|
mutation/fact
Package fact owns the lossless, versioned P4 mutation-fact envelope.
|
Package fact owns the lossless, versioned P4 mutation-fact envelope. |
|
mutation/ir
Package ir owns the closed, immutable, provider-neutral representation of a bound mutation.
|
Package ir owns the closed, immutable, provider-neutral representation of a bound mutation. |
|
mutation/nested
Package nested binds and plans the closed nested-mutation vocabulary before any transaction or provider boundary.
|
Package nested binds and plans the closed nested-mutation vocabulary before any transaction or provider boundary. |
|
mutation/plan
Package plan derives immutable provider-neutral mutation authorization plans.
|
Package plan derives immutable provider-neutral mutation authorization plans. |
|
mutation/sql
Package sql renders validated P4 scalar mutation plans into deterministic, provider-specific statement programs.
|
Package sql renders validated P4 scalar mutation plans into deterministic, provider-specific statement programs. |
|
mutation/upsert
Package upsert prepares and runs the truthful root-upsert selection kernel.
|
Package upsert prepares and runs the truthful root-upsert selection kernel. |
|
observation
Package observation owns the private value behind the public immutable observation record.
|
Package observation owns the private value behind the public immutable observation record. |
|
observeexec
Package observeexec owns request-local observation spans.
|
Package observeexec owns request-local observation spans. |
|
p7oracle
Package p7oracle contains the independent P7 provider and social-event acceptance oracle.
|
Package p7oracle contains the independent P7 provider and social-event acceptance oracle. |
|
p8oracle
Package p8oracle provides external-consumer, live-provider orchestration for P8 independent evidence.
|
Package p8oracle provides external-consumer, live-provider orchestration for P8 independent evidence. |
|
physical
Package physical defines the normalized, provider-specific schema boundary between Golem's logical compiler IR and provider lowering, migration, rendering, and introspection.
|
Package physical defines the normalized, provider-specific schema boundary between Golem's logical compiler IR and provider lowering, migration, rendering, and introspection. |
|
policy/bind
Package bind converts schema-agnostic frozen public policy values into the closed, schema-validated policy IR.
|
Package bind converts schema-agnostic frozen public policy values into the closed, schema-validated policy IR. |
|
policy/classify
Package classify turns frozen read policy into deterministic field-access facts for one concrete statement reach.
|
Package classify turns frozen read policy into deterministic field-access facts for one concrete statement reach. |
|
policy/dependency
Package dependency derives the deterministic hydration plan required to evaluate policy conditions without guessing about under-selected records.
|
Package dependency derives the deterministic hydration plan required to evaluate policy conditions without guessing about under-selected records. |
|
policy/evaluate
Package evaluate owns the one provider-neutral in-memory policy evaluator.
|
Package evaluate owns the one provider-neutral in-memory policy evaluator. |
|
policy/imply
Package imply proves conservative implications between normalized policy conditions using structural rules and a bounded exact propositional fallback.
|
Package imply proves conservative implications between normalized policy conditions using structural rules and a bounded exact propositional fallback. |
|
policy/ir
Package ir defines the closed, provider-neutral policy representation.
|
Package ir defines the closed, provider-neutral policy representation. |
|
policy/normalize
Package normalize applies the conservative, provider-neutral condition rewrites admitted by the P2 policy contract.
|
Package normalize applies the conservative, provider-neutral condition rewrites admitted by the P2 policy contract. |
|
policy/operator
Package operator owns the single closed metadata registry for policy operators.
|
Package operator owns the single closed metadata registry for policy operators. |
|
policy/resolve
Package resolve compiles an immutable ordered policy into row and field conditions.
|
Package resolve compiles an immutable ordered policy into row and field conditions. |
|
policy/runtime
Package runtime builds execution-scoped, actor-specific policy sets from generated bindings and validates them against the active schema/provider.
|
Package runtime builds execution-scoped, actor-specific policy sets from generated bindings and validates them against the active schema/provider. |
|
policy/schema
Package schema owns the one-time, fail-closed conversion from the public representation-opaque SchemaBundle into immutable, ID-keyed runtime facts.
|
Package schema owns the one-time, fail-closed conversion from the public representation-opaque SchemaBundle into immutable, ID-keyed runtime facts. |
|
policy/schematest
Package schematest provides the smallest complete, fingerprinted two-model schema used by policy and read integration tests.
|
Package schematest provides the smallest complete, fingerprinted two-model schema used by policy and read integration tests. |
|
policy/sql
Package sql compiles validated policy conditions into provider-rendered, parameterized SQL predicate fragments.
|
Package sql compiles validated policy conditions into provider-rendered, parameterized SQL predicate fragments. |
|
provider/handle
Package handle owns the sealed, provider-verified database state used by the public provider packages.
|
Package handle owns the sealed, provider-verified database state used by the public provider packages. |
|
provider/postgresql
Package postgresql implements the PostgreSQL 15+ physical-schema provider.
|
Package postgresql implements the PostgreSQL 15+ physical-schema provider. |
|
provider/sqlite
Package sqlite implements Golem's SQLite physical-schema provider.
|
Package sqlite implements Golem's SQLite physical-schema provider. |
|
queryplanbuild
Package queryplanbuild owns provider-neutral assembly of sanitized provider structure and typed operation plans into the validated query-plan report.
|
Package queryplanbuild owns provider-neutral assembly of sanitized provider structure and typed operation plans into the validated query-plan report. |
|
queryplancapture
Package queryplancapture is the private, provider-neutral handoff between renderer-owned identity maps and provider plan parsers.
|
Package queryplancapture is the private, provider-neutral handoff between renderer-owned identity maps and provider plan parsers. |
|
queryplanreport
Package queryplanreport owns the validated producer representation behind the public immutable queryplan report.
|
Package queryplanreport owns the validated producer representation behind the public immutable queryplan report. |
|
read/bind
Package bind validates frozen public P3 reads against the active schema and converts them into the closed internal read IR.
|
Package bind validates frozen public P3 reads against the active schema and converts them into the closed internal read IR. |
|
read/decode
Package decode owns exact, logical-type-directed row scanning for P3 reads.
|
Package decode owns exact, logical-type-directed row scanning for P3 reads. |
|
read/ir
Package ir owns the closed, immutable provider-neutral P3 read request.
|
Package ir owns the closed, immutable provider-neutral P3 read request. |
|
read/plan
Package plan builds deterministic provider-neutral authorized read plans.
|
Package plan builds deterministic provider-neutral authorized read plans. |
|
read/sql
Package sql renders complete deterministic P3 root read statements from authorized provider-neutral plans.
|
Package sql renders complete deterministic P3 root read statements from authorized provider-neutral plans. |
|
scoped
Package scoped owns the closed, provider-neutral planning and SQL lowering for P6 typed scoped reads.
|
Package scoped owns the closed, provider-neutral planning and SQL lowering for P6 typed scoped reads. |
|
semantic/contract
Package contract owns the canonical provider-extension payloads used by the compiler, provider lowerers, generated registries, and runtime.
|
Package contract owns the canonical provider-extension payloads used by the compiler, provider lowerers, generated registries, and runtime. |
|
semantic/key
Package key owns the closed canonical identity encoding shared by source scans and authorized typed rows.
|
Package key owns the closed canonical identity encoding shared by source scans and authorized typed rows. |
|
semantic/runtime
Package runtime validates and owns the provider-neutral runtime inventory for generated semantic indexes.
|
Package runtime validates and owns the provider-neutral runtime inventory for generated semantic indexes. |
|
semantic/sqlitevec
Package sqlitevec owns Golem's sqlite-vec driver boundary.
|
Package sqlitevec owns Golem's sqlite-vec driver boundary. |
|
semantic/storage
Package storage maps the portable semantic-index compiler contract into the closed physical extension consumed by SQLite and PostgreSQL providers.
|
Package storage maps the portable semantic-index compiler contract into the closed physical extension consumed by SQLite and PostgreSQL providers. |
|
Package observe exposes Golem's immutable, bounded, label-only production observation stream.
|
Package observe exposes Golem's immutable, bounded, label-only production observation stream. |
|
internal/adapter
Package adapter owns the one safe, closed normalization shared by public observation adapters.
|
Package adapter owns the one safe, closed normalization shared by public observation adapters. |
|
otel
Package otel exports Golem observations as fixed-name OpenTelemetry spans and metrics with only closed, checked attributes.
|
Package otel exports Golem observations as fixed-name OpenTelemetry spans and metrics with only closed, checked attributes. |
|
slog
Package slog exports Golem observations through the standard library's structured logger using only the checked, closed telemetry vocabulary.
|
Package slog exports Golem observations through the standard library's structured logger using only the checked, closed telemetry vocabulary. |
|
Package provider exposes provider-verified database ownership shared by generated Golem applications.
|
Package provider exposes provider-verified database ownership shared by generated Golem applications. |
|
postgresql
Package postgresql opens the verified PostgreSQL database profile required by Golem.
|
Package postgresql opens the verified PostgreSQL database profile required by Golem. |
|
sqlite
Package sqlite opens the verified SQLite database profile required by Golem.
|
Package sqlite opens the verified SQLite database profile required by Golem. |
|
Package queryplan contains Golem's immutable, provider-neutral query-plan diagnostic report.
|
Package queryplan contains Golem's immutable, provider-neutral query-plan diagnostic report. |
|
Package runtime is the public application-runtime boundary used by generated Golem application packages.
|
Package runtime is the public application-runtime boundary used by generated Golem application packages. |
Click to show internal directories.
Click to hide internal directories.