factory

module
v0.3.0 Latest Latest
Warning

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

Go to latest
Published: Oct 29, 2026 License: AGPL-3.0

README

CCF Factory

An event-driven, LLM-powered software factory for the compliance-framework org, starting with the docs.

GitHub events (a finished release train, an issue, a pull request) go to a central dispatcher, where declarative rules decide which task spec runs, on which harness (Codex or Claude Code, loaded with ccf-skills) and on which pool of agents.

Layout

Path What
cmd/factory The dispatcher binary
cmd/factory-agent The agent binary (registered workers)
cmd/factory-mock A mock dispatcher serving the HTTP contract's examples, for agent and UI development
api/ The HTTP contract (openapi.yaml) and one example per operation
internal/ Go packages (see repo-layout LLD)
web/ The Factory UI (Vue), built separately and embedded with go:embed
catalog/ The factory's configuration: providers, rules, task specs, queues, pools
deploy/poc/ PoC run kit (secrets live in the gitignored deploy/poc/.env)

Build

make build           # bin/factory, bin/factory-agent, bin/factory-mock with a placeholder UI (no Node needed)
make test            # go test -race
make reviewable      # what CI runs for Go
make openapi-lint    # lint the HTTP contract, api/openapi.yaml
bin/factory-mock     # serve the HTTP contract with canned examples on 127.0.0.1:8081
make build-release   # builds web/ and embeds it (-tags webui); needs web/ (WEB-S0-T01)

Requires Go 1.26 and golangci-lint v2. The UI needs Node 20. CI runs ci / required (shared compliance-framework/workflows Go CI plus a local web job).

Licence

AGPL-3.0.

Directories

Path Synopsis
api
Package api holds the factory's HTTP contract: openapi.yaml and one example per operation's success response under examples/.
Package api holds the factory's HTTP contract: openapi.yaml and one example per operation's success response under examples/.
componentsgen command
Command componentsgen writes the OpenAPI components of the v1alpha1 types into api/openapi.yaml, between its BEGIN GENERATED and END GENERATED markers (make generate).
Command componentsgen writes the OpenAPI components of the v1alpha1 types into api/openapi.yaml, between its BEGIN GENERATED and END GENERATED markers (make generate).
cmd
factory command
Command factory is the CCF Factory dispatcher.
Command factory is the CCF Factory dispatcher.
factory-agent command
Command factory-agent is the CCF Factory agent.
Command factory-agent is the CCF Factory agent.
factory-mock command
Command factory-mock serves the factory's HTTP contract (api/openapi.yaml) with canned responses from api/examples, for agent and web development before the real dispatcher exists.
Command factory-mock serves the factory's HTTP contract (api/openapi.yaml) with canned responses from api/examples, for agent and web development before the real dispatcher exists.
internal
agent/config
Package config is factory-agent's local, owner-controlled configuration (design/workstreams/agent/LLD/supervise.md §The local config): the dispatcher, the pool, the enrollment token file, labels, the harnesses' dedicated config dirs, the owner's lending consent, and how the agent polls for tasks.
Package config is factory-agent's local, owner-controlled configuration (design/workstreams/agent/LLD/supervise.md §The local config): the dispatcher, the pool, the enrollment token file, labels, the harnesses' dedicated config dirs, the owner's lending consent, and how the agent polls for tasks.
agent/effector
Package effector is the Effector (design/workstreams/agent/LLD/effector.md): every change a run makes on GitHub goes through it.
Package effector is the Effector (design/workstreams/agent/LLD/effector.md): every change a run makes on GitHub goes through it.
agent/enroll
Package enroll keeps an enrolled agent's registration credential (P1 §6): the refresh token in the supervisor's state dir, 0600, and before the first registration the one-time enrollment token from the file the config names.
Package enroll keeps an enrolled agent's registration credential (P1 §6): the refresh token in the supervisor's state dir, 0600, and before the first registration the one-time enrollment token from the file the config names.
agent/envrun
Package envrun brings a task's VM workspace environment up and down (P1 §4, workspace-run.md §internal/agent/envrun): it runs spec.environment's setup and up scripts, waits for its ready checks, and runs its down script at the end.
Package envrun brings a task's VM workspace environment up and down (P1 §4, workspace-run.md §internal/agent/envrun): it runs spec.environment's setup and up scripts, waits for its ready checks, and runs its down script at the end.
agent/gateway
Package gateway is the workspace gateway (gateway.md): an explicit forward proxy that is the workspace's only TCP route out.
Package gateway is the workspace gateway (gateway.md): an explicit forward proxy that is the workspace's only TCP route out.
agent/gateway/ca
Package ca is the agent host's gateway CA (gateway.md, "The CA"): a name-constrained ECDSA P-256 certificate authority whose leaves the gateway presents for the hosts it intercepts.
Package ca is the agent host's gateway CA (gateway.md, "The CA"): a name-constrained ECDSA P-256 certificate authority whose leaves the gateway presents for the hosts it intercepts.
agent/gateway/chatgpt
Package chatgpt is the codex ChatGPT login the gateway sends to chatgpt.com, and its Refresher (gateway.md, "ChatGPT refresh").
Package chatgpt is the codex ChatGPT login the gateway sends to chatgpt.com, and its Refresher (gateway.md, "ChatGPT refresh").
agent/gateway/policy
Package policy holds the workspace gateway's decisions as data (gateway.md): the host classes and what a CONNECT or a plain HTTP request to each gets, the egress check (the task's mode and allow list, the deny table, the open addresses), the github.com, api.github.com (with the GraphQL read check), dispatcher and model host (methods and path lists) request rules, the refusal codes and bodies, and the cookie filter of the model hosts.
Package policy holds the workspace gateway's decisions as data (gateway.md): the host classes and what a CONNECT or a plain HTTP request to each gets, the egress check (the task's mode and allow list, the deny table, the open addresses), the github.com, api.github.com (with the GraphQL read check), dispatcher and model host (methods and path lists) request rules, the refusal codes and bodies, and the cookie filter of the model hosts.
agent/gitcred
Package gitcred is the run pipeline's in-memory git credential helper (run-pipeline.md §Steps 2): git asks `factory-agent fx git-credential get` for a credential, and the helper asks the worker over a Unix socket that only the worker's user can open.
Package gitcred is the run pipeline's in-memory git credential helper (run-pipeline.md §Steps 2): git asks `factory-agent fx git-credential get` for a credential, and the helper asks the worker over a Unix socket that only the worker's user can open.
agent/harness
Package harness is the seam between the run pipeline and the coding-agent CLIs it drives (design/workstreams/agent/LLD/harness-adapters.md): the Adapter interface each harness implements (Codex in AGT-S1-T03, Claude Code in AGT-S1-T04, the scriptable fake in harness/fake), the Workspace the pipeline prepares for it, and the EventSink it reports progress, usage and rate limits to.
Package harness is the seam between the run pipeline and the coding-agent CLIs it drives (design/workstreams/agent/LLD/harness-adapters.md): the Adapter interface each harness implements (Codex in AGT-S1-T03, Claude Code in AGT-S1-T04, the scriptable fake in harness/fake), the Workspace the pipeline prepares for it, and the EventSink it reports progress, usage and rate limits to.
agent/harness/claudecode
Package claudecode is the Claude Code CLI harness adapter (design/workstreams/agent/LLD/ harness-adapters.md §Claude Code).
Package claudecode is the Claude Code CLI harness adapter (design/workstreams/agent/LLD/ harness-adapters.md §Claude Code).
agent/harness/clirun
Package clirun is what the harness adapters (codex, claudecode) share to drive a coding agent's CLI: running it in its own process group and killing the whole group when the run ends, splitting its stdout into lines for the stream parser, keeping a bounded transcript and stderr tail, and the text helpers their parsers need (rate-limit resets, versions, summaries).
Package clirun is what the harness adapters (codex, claudecode) share to drive a coding agent's CLI: running it in its own process group and killing the whole group when the run ends, splitting its stdout into lines for the stream parser, keeping a bounded transcript and stderr tail, and the text helpers their parsers need (rate-limit resets, versions, summaries).
agent/harness/codex
Package codex is the Codex CLI harness adapter (design/workstreams/agent/LLD/ harness-adapters.md §Codex).
Package codex is the Codex CLI harness adapter (design/workstreams/agent/LLD/ harness-adapters.md §Codex).
agent/harness/fake
Package fake is a scriptable harness.Adapter for pipeline and worker tests (harness-adapters.md §Fake adapter): scripted progress, usage and results, a scripted repair turn, and ways to simulate a rate limit or a run that only ends when it's stopped.
Package fake is a scriptable harness.Adapter for pipeline and worker tests (harness-adapters.md §Fake adapter): scripted progress, usage and results, a scripted repair turn, and ways to simulate a rate limit or a run that only ends when it's stopped.
agent/harness/harnesstest
Package harnesstest has what the harness adapters' tests share: a recording EventSink and an end-to-end rig that runs the real run pipeline against an in-process smart-HTTP git server and dispatcher.
Package harnesstest has what the harness adapters' tests share: a recording EventSink and an end-to-end rig that runs the real run pipeline against an in-process smart-HTTP git server and dispatcher.
agent/host
Package host checks and sets up an agent host for VM workspaces (P1 §7, design/workstreams/agent/LLD/workspace-host.md).
Package host checks and sets up an agent host for VM workspaces (P1 §7, design/workstreams/agent/LLD/workspace-host.md).
agent/host/provision
Package provision holds the agent hosts' workspace bases: base.sh, the provisioning script the tart base VM runs (package host embeds it too), and the kata driver's image, whose build context is kata/ plus base.sh (design/workstreams/agent/LLD/workspace-kata.md, "The image").
Package provision holds the agent hosts' workspace bases: base.sh, the provisioning script the tart base VM runs (package host embeds it too), and the kata driver's image, whose build context is kata/ plus base.sh (design/workstreams/agent/LLD/workspace-kata.md, "The image").
agent/host/provision/katacontext command
Command katacontext writes the kata image's build context (provision.WriteKataContext) to a directory and prints its contextSHA256, so a person (make kata-context) and CI build the same context factory-agent does: docker build <dir>.
Command katacontext writes the kata image's build context (provision.WriteKataContext) to a directory and prints its contextSHA256, so a person (make kata-context) and CI build the same context factory-agent does: docker build <dir>.
agent/internal/execfile
Package execfile writes files that will be exec'd (the factory shim, a skill's scripts, a harness's copied plugins, the environment's scripts, extracted binaries) so that exec'ing them can't fail with ETXTBSY ("text file busy").
Package execfile writes files that will be exec'd (the factory shim, a skill's scripts, a harness's copied plugins, the environment's scripts, extracted binaries) so that exec'ing them can't fail with ETXTBSY ("text file busy").
agent/internal/exectest
Package exectest writes the scripts factory-agent's tests exec (fake harnesses, wrappers, stubs) through execfile, so that exec'ing them can't fail with ETXTBSY while parallel tests fork.
Package exectest writes the scripts factory-agent's tests exec (fake harnesses, wrappers, stubs) through execfile, so that exec'ing them can't fail with ETXTBSY while parallel tests fork.
agent/internal/fakegateway
Package fakegateway is a test-only stand-in for phase 4's gateway (P1 §3): an explicit forward proxy that injects every credential, so the workspace under test never holds one.
Package fakegateway is a test-only stand-in for phase 4's gateway (P1 §3): an explicit forward proxy that injects every credential, so the workspace under test never holds one.
agent/katahelper
Package katahelper is the kata driver's root helper (design/workstreams/agent/LLD/ workspace-kata.md#the-helper-internalagentkatahelper), and the host layout it shares with host init's kata steps.
Package katahelper is the kata driver's root helper (design/workstreams/agent/LLD/ workspace-kata.md#the-helper-internalagentkatahelper), and the host layout it shares with host init's kata steps.
agent/login
Package login is the supervisor's store of the owner's model logins (supervise.md, "The workspace runner"): the Claude token `factory-agent login claude` reads on stdin and the codex ChatGPT login `factory-agent login codex` imports from codex's auth.json.
Package login is the supervisor's store of the owner's model logins (supervise.md, "The workspace runner"): the Claude token `factory-agent login claude` reads on stdin and the codex ChatGPT login `factory-agent login codex` imports from codex's auth.json.
agent/pipeline
Package pipeline is the run pipeline (design/workstreams/agent/LLD/run-pipeline.md): it turns one leased Task into a harness run and the run into a validated Result.
Package pipeline is the run pipeline (design/workstreams/agent/LLD/run-pipeline.md): it turns one leased Task into a harness run and the run into a validated Result.
agent/probe
Package probe works out what this machine can offer the dispatcher (supervise.md §factory-agent probe): a HarnessOffer per configured harness, the configured labels, and the base tooling the host itself needs.
Package probe works out what this machine can offer the dispatcher (supervise.md §factory-agent probe): a HarnessOffer per configured harness, the configured labels, and the base tooling the host itself needs.
agent/runbundle
Package runbundle is the run bundle the supervisor writes for a VM workspace, the outcome the VM writes back and the event stream between them (workspace-run.md §The run bundle).
Package runbundle is the run bundle the supervisor writes for a VM workspace, the outcome the VM writes back and the event stream between them (workspace-run.md §The run bundle).
agent/runner
Package runner is the seam between the worker's lease loop and what executes a leased task: the worker hands a Runner each Job and reports the Outcome to the dispatcher.
Package runner is the seam between the worker's lease loop and what executes a leased task: the worker hands a Runner each Job and reports the Outcome to the dispatcher.
agent/sudocancel
Package sudocancel is how factory-agent cancels a command it runs with a context: a sudo call gets SIGTERM, which sudo relays to its command, and SIGKILL only after a grace; anything else gets SIGKILL at once.
Package sudocancel is how factory-agent cancels a command it runs with a context: a sudo call gets SIGTERM, which sudo relays to its command, and SIGKILL only after a grace; anything else gets SIGKILL at once.
agent/sudocancel/sudocanceltest
Package sudocanceltest checks that a runner cancels commands the sudocancel way, with a stand-in for sudo: real sudo never runs.
Package sudocanceltest checks that a runner cancels commands the sudocancel way, with a stand-in for sudo: real sudo never runs.
agent/vmrun
Package vmrun is factory-agent run's runtime inside a VM workspace (workspace-run.md).
Package vmrun is factory-agent run's runtime inside a VM workspace (workspace-run.md).
agent/worker
Package worker is factory-agent's worker loop (supervise.md §The worker loop): it registers with the dispatcher (its refresh token, else the one-time enrollment token), polls for leases (a long poll by default, or a brief poll and a sleep: Poll), runs each leased task through a runner.Runner while heartbeating, reports the Outcome (complete, abandon, throttle), and drains on SIGTERM.
Package worker is factory-agent's worker loop (supervise.md §The worker loop): it registers with the dispatcher (its refresh token, else the one-time enrollment token), polls for leases (a long poll by default, or a brief poll and a sleep: Poll), runs each leased task through a runner.Runner while heartbeating, reports the Outcome (complete, abandon, throttle), and drains on SIGTERM.
agent/workspace
Package workspace is the seam between factory-agent supervise and the VM a task runs in (P1 §1, design/workstreams/agent/LLD/supervise.md): a Driver creates, starts, fills, runs, empties and destroys one workspace VM per task.
Package workspace is the seam between factory-agent supervise and the VM a task runs in (P1 §1, design/workstreams/agent/LLD/supervise.md): a Driver creates, starts, fills, runs, empties and destroys one workspace VM per task.
agent/workspace/kata
Package kata is the workspace driver for Linux: each workspace is a Kata microVM made and run by the root helper (design/workstreams/agent/LLD/workspace-kata.md#the-driver-internalagentworkspacekata), which this driver runs as sudo -n kata-helper <verb>.
Package kata is the workspace driver for Linux: each workspace is a Kata microVM made and run by the root helper (design/workstreams/agent/LLD/workspace-kata.md#the-driver-internalagentworkspacekata), which this driver runs as sudo -n kata-helper <verb>.
agent/workspace/tart
Package tart is the workspace driver for macOS: it drives the tart CLI (P1 §1, design/workstreams/agent/LLD/supervise.md).
Package tart is the workspace driver for macOS: it drives the tart CLI (P1 §1, design/workstreams/agent/LLD/supervise.md).
agent/workspace/vmexec
Package vmexec is what the workspace drivers share (design/workstreams/agent/LLD/ workspace-kata.md#the-driver-internalagentworkspacekata): running commands in a workspace through the driver's exec command, and over it Put's and Get's tar streams, Exec with its pid-file cancel, and the network read.
Package vmexec is what the workspace drivers share (design/workstreams/agent/LLD/ workspace-kata.md#the-driver-internalagentworkspacekata): running commands in a workspace through the driver's exec command, and over it Put's and Get's tar streams, Exec with its pid-file cancel, and the network read.
apiclient
Package apiclient provides primitives to interact with the openapi HTTP API.
Package apiclient provides primitives to interact with the openapi HTTP API.
apis/v1alpha1
Package v1alpha1 holds the Go types for every factory kind: the config kinds that live in git under catalog/ (Provider, Group, Template, Rule, RuleSet, TaskSpec, Queue, Pool), the runtime kinds the dispatcher stores (Event, WorkItem, Task, Run, Agent, Effect, BudgetCounter, Approval), the agent's Result, the capability descriptors, the event vocabulary and the effect ops.
Package v1alpha1 holds the Go types for every factory kind: the config kinds that live in git under catalog/ (Provider, Group, Template, Rule, RuleSet, TaskSpec, Queue, Pool), the runtime kinds the dispatcher stores (Event, WorkItem, Task, Run, Agent, Effect, BudgetCounter, Approval), the agent's Result, the capability descriptors, the event vocabulary and the effect ops.
apis/v1alpha1/schemagen command
Command schemagen writes the JSON Schemas of the v1alpha1 config kinds and of Result: one <kind>.schema.json per kind, plus result.schema.json.
Command schemagen writes the JSON Schemas of the v1alpha1 config kinds and of Result: one <kind>.schema.json per kind, plus result.schema.json.
apiserver/gen
Package gen is the oapi-codegen Echo strict server for api/openapi.yaml: the StrictServerInterface the dispatcher's handlers implement (internal/server), its request/response types and RegisterHandlers.
Package gen is the oapi-codegen Echo strict server for api/openapi.yaml: the StrictServerInterface the dispatcher's handlers implement (internal/server), its request/response types and RegisterHandlers.
auth
Package auth authenticates the dispatcher's API callers (design/workstreams/dispatcher-runtime/ LLD/api-server.md §Auth):
Package auth authenticates the dispatcher's API callers (design/workstreams/dispatcher-runtime/ LLD/api-server.md §Auth):
catalog
Package catalog loads a factory catalog (a directory of YAML objects plus prompt and schema assets) into an immutable, validated snapshot, as specified by design/workstreams/dispatcher-core/LLD/catalog.md.
Package catalog loads a factory catalog (a directory of YAML objects plus prompt and schema assets) into an immutable, validated snapshot, as specified by design/workstreams/dispatcher-core/LLD/catalog.md.
catalog/gitsource
Package gitsource loads a catalog from a git ref: a shallow fetch into a temporary directory with the git CLI, then catalog.LoadDir on the catalog's directory in it, with the commit as the snapshot's SHA (design/workstreams/dispatcher-core/LLD/catalog.md §Loading).
Package gitsource loads a catalog from a git ref: a shallow fetch into a temporary directory with the git CLI, then catalog.LoadDir on the catalog's directory in it, with the commit as the snapshot's SHA (design/workstreams/dispatcher-core/LLD/catalog.md §Loading).
cel
Package cel is the CEL environment of the factory's rules and the runtime expressions of the catalog (design/workstreams/dispatcher-core/LLD/cel-and-expressions.md):
Package cel is the CEL environment of the factory's rules and the runtime expressions of the catalog (design/workstreams/dispatcher-core/LLD/cel-and-expressions.md):
clock
Package clock is the injectable time source for logic packages: they take a Clock instead of calling time.Now or time.NewTimer, and tests drive a Fake.
Package clock is the injectable time source for logic packages: they take a Clock instead of calling time.Now or time.NewTimer, and tests drive a Fake.
controllers
Package controllers is the dispatcher's controller runtime (keyed work queues, rate-limited retries, store informers) and its controllers, starting with catalog-sync.
Package controllers is the dispatcher's controller runtime (keyed work queues, rate-limited retries, store informers) and its controllers, starting with catalog-sync.
patterns
Package patterns compiles the patterns allowed in harness config (design/03-domain-model.md §Patterns in harness config) and resolves a constraint, a request and an agent's offer into one concrete harness config.
Package patterns compiles the patterns allowed in harness config (design/03-domain-model.md §Patterns in harness config) and resolves a constraint, a request and an agent's offer into one concrete harness config.
provider
Package provider is the contract between the dispatcher and a provider adapter (GitHub, and later Slack): ingress, observation, projection, effects and git credentials for agents (design/workstreams/foundation/LLD/contracts.md §Provider interface).
Package provider is the contract between the dispatcher and a provider adapter (GitHub, and later Slack): ingress, observation, projection, effects and git credentials for agents (design/workstreams/foundation/LLD/contracts.md §Provider interface).
provider/fake
Package fake is an in-memory provider for tests: it keeps objects in memory, records every Project and Apply for assertions, emits scripted deliveries into an IngressSink and normalises them into Events, resolves Groups from configured membership, mints fake git tokens and reports a settable health.
Package fake is an in-memory provider for tests: it keeps objects in memory, records every Project and Apply for assertions, emits scripted deliveries into an IngressSink and normalises them into Events, resolves Groups from configured membership, mints fake git tokens and reports a settable health.
provider/github
Package github is the provider adapter for GitHub and GHE (design/workstreams/provider-github/LLD/github-provider.md): App auth and scoped git credentials (GH-S1-T01), webhook ingress and normalisation (GH-S1-T02), observe and projection (GH-S1-T03) and effects (GH-S1-T04).
Package github is the provider adapter for GitHub and GHE (design/workstreams/provider-github/LLD/github-provider.md): App auth and scoped git credentials (GH-S1-T01), webhook ingress and normalisation (GH-S1-T02), observe and projection (GH-S1-T03) and effects (GH-S1-T04).
provider/github/githubtest
Package githubtest is an httptest GitHub for the GitHub adapter's tests.
Package githubtest is an httptest GitHub for the GitHub adapter's tests.
provider/tokens
Package tokens mints GitHub App installation tokens for the factory's App identities (design/workstreams/provider-github/LLD/github-provider.md §Auth and tokens).
Package tokens mints GitHub App installation tokens for the factory's App identities (design/workstreams/provider-github/LLD/github-provider.md §Auth and tokens).
rules
Package rules is the rule engine (design/workstreams/dispatcher-core/LLD/rules-engine.md): Engine.Evaluate turns one event and a work item snapshot into the ordered decisions the rule controller applies, with the record of why each rule did or didn't fire.
Package rules is the rule engine (design/workstreams/dispatcher-core/LLD/rules-engine.md): Engine.Evaluate turns one event and a work item snapshot into the ordered decisions the rule controller applies, with the record of why each rule did or didn't fire.
scheduler
Package scheduler is the registered-pool scheduler (design/workstreams/dispatcher-runtime/ LLD/scheduler-and-pools.md): agent registration and tokens, the long-poll lease matcher (queues, budgets, lending, harness resolution, anti-affinity, fairness), heartbeats, lease expiry with the queue's retry policy, and abandon.
Package scheduler is the registered-pool scheduler (design/workstreams/dispatcher-runtime/ LLD/scheduler-and-pools.md): agent registration and tokens, the long-poll lease matcher (queues, budgets, lending, harness resolution, anti-affinity, fairness), heartbeats, lease expiry with the queue's retry policy, and abandon.
server
Package server is the dispatcher's HTTP API (design/workstreams/dispatcher-runtime/LLD/ api-server.md): the generated Echo strict server (internal/apiserver/gen) implemented over the scheduler, the controllers, the store and the provider connections; the webhook routes delegated to each provider's Conn.Handler; SSE; and the localhost ops listener (healthz, readyz, metrics).
Package server is the dispatcher's HTTP API (design/workstreams/dispatcher-runtime/LLD/ api-server.md): the generated Echo strict server (internal/apiserver/gen) implemented over the scheduler, the controllers, the store and the provider connections; the webhook routes delegated to each provider's Conn.Handler; SSE; and the localhost ops listener (healthz, readyz, metrics).
store
Package store is the dispatcher's resource store: the runtime kinds (Event, WorkItem, Task, Run, Agent, Effect, BudgetCounter, Approval, and the internal Lease, Debounce, Session and Delivery records) with get, list, watch, compare-and-swap updates, advisory leased locks, retention and the transcript blobs.
Package store is the dispatcher's resource store: the runtime kinds (Event, WorkItem, Task, Run, Agent, Effect, BudgetCounter, Approval, and the internal Lease, Debounce, Session and Delivery records) with get, list, watch, compare-and-swap updates, advisory leased locks, retention and the transcript blobs.
store/filestore
Package filestore is the single-node durable store: the in-memory store (store/memory) is the engine, and every committed change is appended to an fsync'd JSON Lines journal before it is applied.
Package filestore is the single-node durable store: the in-memory store (store/memory) is the engine, and every committed change is appended to an fsync'd JSON Lines journal before it is applied.
store/journal
Package journal is the encoding the durable stores share: P2's journal line (one committed change) and snapshot (the whole store at a version), the kinds they can load and the transcript blob names.
Package journal is the encoding the durable stores share: P2's journal line (one committed change) and snapshot (the whole store at a version), the kinds they can load and the transcript blob names.
store/memory
Package memory is the in-memory store.Store: one map per kind behind a single RWMutex (PoC scale: thousands of objects), JSON deep copies on the way in and out, field indexes, watch fan-out with bounded buffers and a replay history, leased locks, retention and the transcript blobs.
Package memory is the in-memory store.Store: one map per kind behind a single RWMutex (PoC scale: thousands of objects), JSON deep copies on the way in and out, field indexes, watch fan-out with bounded buffers and a replay history, leased locks, retention and the transcript blobs.
store/objectstore
Package objectstore is the store several dispatchers share: the in-memory store (store/memory) is the engine in each of them, and the bucket holds the authoritative history, an append-only log of create-only objects, one per change, plus periodic snapshots.
Package objectstore is the store several dispatchers share: the in-memory store (store/memory) is the engine in each of them, and the bucket holds the authoritative history, an append-only log of create-only objects, one per change, plus periodic snapshots.
store/storeaudit
Package storeaudit keeps secrets out of the durable stores' bytes.
Package storeaudit keeps secrets out of the durable stores' bytes.
store/storetest
Package storetest is the conformance suite for store implementations: the in-memory store passes it today and a Postgres store must pass it later.
Package storetest is the conformance suite for store implementations: the in-memory store passes it today and a Postgres store must pass it later.
version
Package version holds build metadata, set at link time with -ldflags "-X github.com/ContainerSolutions/factory/internal/version.Version=v1.2.3".
Package version holds build metadata, set at link time with -ldflags "-X github.com/ContainerSolutions/factory/internal/version.Version=v1.2.3".
webui
Package webui serves the Factory UI embedded in the dispatcher binary.
Package webui serves the Factory UI embedded in the dispatcher binary.

Jump to

Keyboard shortcuts

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