kernel/

directory
v0.1.0-develop.2026061... Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 12, 2026 License: MIT

Directories

Path Synopsis
Package assembly provides the CoreAssembly that orchestrates Cell lifecycle (register, start, stop, health).
Package assembly provides the CoreAssembly that orchestrates Cell lifecycle (register, start, stop, health).
Package auth holds the kernel-level authentication plan model: the sealed AuthPlan / ListenerAuth interfaces, their five typed implementations (None, JWT, JWTFromAssembly, MTLS, ServiceToken), and the narrow dependency interfaces (IntentTokenVerifier, NonceStore, HMACKeyring, AuthProvider, ...) that runtime/auth concrete types satisfy structurally.
Package auth holds the kernel-level authentication plan model: the sealed AuthPlan / ListenerAuth interfaces, their five typed implementations (None, JWT, JWTFromAssembly, MTLS, ServiceToken), and the narrow dependency interfaces (IntentTokenVerifier, NonceStore, HMACKeyring, AuthProvider, ...) that runtime/auth concrete types satisfy structurally.
authtest
Package authtest provides composition-root convenience helpers for AuthPlan constructors.
Package authtest provides composition-root convenience helpers for AuthPlan constructors.
Package cell defines the core Cell and Slice abstractions for the GoCell framework: interfaces (CellIdentity / CellLifecycle / CellStatus / CellInventory composed into Cell), the BaseCell implementation, and the Registrar surface a Cell uses to declare routes / subscriptions / health probes / lifecycle hooks / config-reload callbacks.
Package cell defines the core Cell and Slice abstractions for the GoCell framework: interfaces (CellIdentity / CellLifecycle / CellStatus / CellInventory composed into Cell), the BaseCell implementation, and the Registrar surface a Cell uses to declare routes / subscriptions / health probes / lifecycle hooks / config-reload callbacks.
celltest
Package celltest provides test utilities for kernel/cell types.
Package celltest provides test utilities for kernel/cell types.
Package cellvocab is the single source of truth for the GoCell metadata vocabulary — the typed enums (CellType, ContractKind, ContractRole, CellLifecycle, ContractLifecycle, Level), their parsers/predicates, and the canonical consistency level ordering.
Package cellvocab is the single source of truth for the GoCell metadata vocabulary — the typed enums (CellType, ContractKind, ContractRole, CellLifecycle, ContractLifecycle, Level), their parsers/predicates, and the canonical consistency level ordering.
Package clock is GoCell's platform-level Clock abstraction.
Package clock is GoCell's platform-level Clock abstraction.
clockmock
Package clockmock provides a deterministic clock.Clock implementation driven by explicit FakeClock.Advance and FakeClock.Set calls.
Package clockmock provides a deterministic clock.Clock implementation driven by explicit FakeClock.Advance and FakeClock.Set calls.
Package command provides L4 (DeviceLatent) command queue primitives for unicast device commands with durable ack semantics.
Package command provides L4 (DeviceLatent) command queue primitives for unicast device commands with durable ack semantics.
commandtest
Package commandtest provides shared conformance assertions for command.Queue + command.ActiveScanner implementations.
Package commandtest provides shared conformance assertions for command.Queue + command.ActiveScanner implementations.
Package contractspec defines the runtime descriptor type for one contract endpoint, shared by the layers that bind contracts to wire protocols.
Package contractspec defines the runtime descriptor type for one contract endpoint, shared by the layers that bind contracts to wire protocols.
Package crypto defines the kernel-level cryptographic interfaces: KeyProvider, KeyHandle, ValueTransformer, and CurrentKeyIDProvider.
Package crypto defines the kernel-level cryptographic interfaces: KeyProvider, KeyHandle, ValueTransformer, and CurrentKeyIDProvider.
Package ctxkeys provides typed context keys for Cell-model identifiers (cell, slice, journey, contract) propagated through context.Context.
Package ctxkeys provides typed context keys for Cell-model identifiers (cell, slice, journey, contract) propagated through context.Context.
Package depgraph defines the core data model for the GoCell package-level dependency graph: Graph, Node, Stats, and the layer/cell/slice classifiers.
Package depgraph defines the core data model for the GoCell package-level dependency graph: Graph, Node, Stats, and the layer/cell/slice classifiers.
Package fsm provides generic helpers for map-based finite-state-machine transition tables used by kernel state machines.
Package fsm provides generic helpers for map-based finite-state-machine transition tables used by kernel state machines.
Package governance implements validation rules for GoCell metadata.
Package governance implements validation rules for GoCell metadata.
Package healthz defines the kernel-level interface for readiness probes.
Package healthz defines the kernel-level interface for readiness probes.
Package idempotency defines the consumer-side idempotency interface (Claimer with two-phase Claim / Commit / Release semantics) used by kernel/outbox.ConsumerBase to deduplicate event delivery.
Package idempotency defines the consumer-side idempotency interface (Claimer with two-phase Claim / Commit / Release semantics) used by kernel/outbox.ConsumerBase to deduplicate event delivery.
Package journey provides query access to Journey metadata and status.
Package journey provides query access to Journey metadata and status.
Package lifecycle provides the ContextCloser interface and adapters for managing resource teardown with context-aware shutdown budgets.
Package lifecycle provides the ContextCloser interface and adapters for managing resource teardown with context-aware shutdown budgets.
Package metadata implements structural derivation for AssemblyMeta and related types.
Package metadata implements structural derivation for AssemblyMeta and related types.
metadatatest
Package metadatatest provides typed builders for constructing kernel/metadata fixtures in *_test.go files.
Package metadatatest provides typed builders for constructing kernel/metadata fixtures in *_test.go files.
Package metautil holds shared metadata limits and validation primitives used by kernel-level transports (kernel/outbox, kernel/command).
Package metautil holds shared metadata limits and validation primitives used by kernel-level transports (kernel/outbox, kernel/command).
Package observability is the namespace root for GoCell's provider-neutral metrics and pool-stats abstractions.
Package observability is the namespace root for GoCell's provider-neutral metrics and pool-stats abstractions.
correlation
Package correlation provides a sealed read-model carrying the three cross-cutting observability IDs (trace, request, correlation) for use in issue #1048 (trace → audit reverse lookup).
Package correlation provides a sealed read-model carrying the three cross-cutting observability IDs (trace, request, correlation) for use in issue #1048 (trace → audit reverse lookup).
metrics
Package metrics defines a provider-neutral metrics abstraction used by kernel modules that emit counters and histograms without importing any specific backend (Prometheus, OTel, …).
Package metrics defines a provider-neutral metrics abstraction used by kernel modules that emit counters and histograms without importing any specific backend (Prometheus, OTel, …).
metrics/metricstest
Package metricstest provides the cross-implementation conformance harness for the kernel metrics no-skip-on-cancel contract.
Package metricstest provides the cross-implementation conformance harness for the kernel metrics no-skip-on-cancel contract.
poolstats
Package poolstats defines a provider-neutral connection-pool snapshot interface.
Package poolstats defines a provider-neutral connection-pool snapshot interface.
Package outbox defines interfaces for the transactional outbox pattern: Writer (insert within a transaction), Emitter (write-or-direct abstraction), Relay (poll-and-publish), Publisher (fire-and-forget), and Subscriber (consume).
Package outbox defines interfaces for the transactional outbox pattern: Writer (insert within a transaction), Emitter (write-or-direct abstraction), Relay (poll-and-publish), Publisher (fire-and-forget), and Subscriber (consume).
outboxtest
Package outboxtest provides a reusable conformance test suite for outbox.Publisher and outbox.Subscriber implementations.
Package outboxtest provides a reusable conformance test suite for outbox.Publisher and outbox.Subscriber implementations.
Package persistence defines shared persistence abstractions for the GoCell framework.
Package persistence defines shared persistence abstractions for the GoCell framework.
persistencetest
Package persistencetest provides conformance suites for persistence.TxRunner implementations.
Package persistencetest provides conformance suites for persistence.TxRunner implementations.
Package projection declares the kernel-level contracts for the CQRS projection lifecycle harness: the business event→state Apply hook, the CheckpointStore offset abstraction, the MemCursor / MemReplaySource demo helpers, the functional Option seam, and the rebuild-lifecycle Phase enum.
Package projection declares the kernel-level contracts for the CQRS projection lifecycle harness: the business event→state Apply hook, the CheckpointStore offset abstraction, the MemCursor / MemReplaySource demo helpers, the functional Option seam, and the rebuild-lifecycle Phase enum.
projectiontest
Package projectiontest provides conformance test helpers for projection.CheckpointStore, projection.ReplaySource, and projection.Cursor implementations.
Package projectiontest provides conformance test helpers for projection.CheckpointStore, projection.ReplaySource, and projection.Cursor implementations.
Package reconcile is GoCell's L4 desired-state convergence harness, a level-triggered control loop modeled on Kubernetes controller-runtime's Reconciler.
Package reconcile is GoCell's L4 desired-state convergence harness, a level-triggered control loop modeled on Kubernetes controller-runtime's Reconciler.
reconciletest
Package reconciletest provides public test-support fakes and conformance suites for kernel/reconcile consumers and LeaderElector adapters.
Package reconciletest provides public test-support fakes and conformance suites for kernel/reconcile consumers and LeaderElector adapters.
Package registry provides indexed, read-only access to parsed GoCell project metadata (cells, slices, contracts).
Package registry provides indexed, read-only access to parsed GoCell project metadata (cells, slices, contracts).
Package saga provides the L3 (WorkflowEventual) saga orchestration state machine: the Status lifecycle, the Instance record, and the pure transition functions (AdvanceSaga, AdvanceStep, Transition) that advance an instance.
Package saga provides the L3 (WorkflowEventual) saga orchestration state machine: the Status lifecycle, the Instance record, and the pure transition functions (AdvanceSaga, AdvanceStep, Transition) that advance an instance.
journal
Package journal provides the durable, append-only Journal for L3 (WorkflowEventual) saga orchestration: the interface the runtime Coordinator (PR-03) and the PostgreSQL store (PR-04) build on, plus an in-memory implementation (MemJournal) for tests and development.
Package journal provides the durable, append-only Journal for L3 (WorkflowEventual) saga orchestration: the interface the runtime Coordinator (PR-03) and the PostgreSQL store (PR-04) build on, plus an in-memory implementation (MemJournal) for tests and development.
sagajournaltest
Package sagajournaltest provides a reusable conformance suite for implementations of journal.Journal.
Package sagajournaltest provides a reusable conformance suite for implementations of journal.Journal.
sagaprojection
Package sagaprojection bridges kernel/saga/journal.GlobalReader to the projection harness (projection.ReplaySource + projection.Cursor + cellvocab.ProjectionEvent).
Package sagaprojection bridges kernel/saga/journal.GlobalReader to the projection harness (projection.ReplaySource + projection.Cursor + cellvocab.ProjectionEvent).
sagaregtest
Package sagaregtest provides a reusable conformance suite for implementations of saga.Resolver.
Package sagaregtest provides a reusable conformance suite for implementations of saga.Resolver.
Package verify provides verify-command introspection used by `gocell verify` and by kernel/governance VERIFY-* rules.
Package verify provides verify-command introspection used by `gocell verify` and by kernel/governance VERIFY-* rules.
Package webhook is the kernel-level pure-computation core for GoCell's bidirectional webhook capability (KERNEL-WEBHOOK-01): inbound receiver verification and outbound dispatcher signing.
Package webhook is the kernel-level pure-computation core for GoCell's bidirectional webhook capability (KERNEL-WEBHOOK-01): inbound receiver verification and outbound dispatcher signing.
webhooktest
Package webhooktest provides a sign↔verify conformance suite for webhook.Signer and webhook.Verifier implementations.
Package webhooktest provides a sign↔verify conformance suite for webhook.Signer and webhook.Verifier implementations.
Package worker defines the Worker domain contract.
Package worker defines the Worker domain contract.
Package wrapper binds contracts to runtime observability primitives.
Package wrapper binds contracts to runtime observability primitives.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL