Directories
¶
| Path | Synopsis |
|---|---|
|
Package await is CSF's wait primitive: one typed operation that waits for a condition from a closed set, up to a required deadline, and reports what it saw.
|
Package await is CSF's wait primitive: one typed operation that waits for a condition from a closed set, up to a required deadline, and reports what it saw. |
|
Package bootstrap runs the bootstrap loop: the fixed-point pass that runs inside one batch job and turns any repository into an archive an earlier csf binary runs.
|
Package bootstrap runs the bootstrap loop: the fixed-point pass that runs inside one batch job and turns any repository into an archive an earlier csf binary runs. |
|
Package cloud is CSF's record of the paid jobs it runs on other people's machines, and its hand on them: every job it launches, what each has spent against its cap, a stop the operator presses that is checked against the provider's own job list, and a watcher that cancels a job at its cap and every job at the day's cap even when the provider's own timeout was set wrong.
|
Package cloud is CSF's record of the paid jobs it runs on other people's machines, and its hand on them: every job it launches, what each has spent against its cap, a stop the operator presses that is checked against the provider's own job list, and a watcher that cancels a job at its cap and every job at the day's cap even when the provider's own timeout was set wrong. |
|
Package copilotadapter is the HTTP adapter that fronts a Copilot CLI session with the contract in openapi.yaml.
|
Package copilotadapter is the HTTP adapter that fronts a Copilot CLI session with the contract in openapi.yaml. |
|
adaptertest
Package adaptertest is a generated GoMock package.
|
Package adaptertest is a generated GoMock package. |
|
copilotbridge
Package copilotbridge is the concrete ICopilotBridge over the Copilot Go SDK.
|
Package copilotbridge is the concrete ICopilotBridge over the Copilot Go SDK. |
|
gen/api
Package api provides primitives to interact with the openapi HTTP API.
|
Package api provides primitives to interact with the openapi HTTP API. |
|
kanban
Package kanban mounts shared task planning into an existing HTTP server.
|
Package kanban mounts shared task planning into an existing HTTP server. |
|
kanban/card
Package card is the generated KanbanCard widget.
|
Package card is the generated KanbanCard widget. |
|
store
Package store carries the adapter's schema.
|
Package store carries the adapter's schema. |
|
terminaladapter
Package terminaladapter owns interactive PTYs for the Copilot workbench.
|
Package terminaladapter owns interactive PTYs for the Copilot workbench. |
|
workbench
Package workbench composes the existing Copilot service for caller-owned hosts.
|
Package workbench composes the existing Copilot service for caller-owned hosts. |
|
worktreeadapter
Package worktreeadapter implements configured git repository and worktree operations for the Copilot adapter.
|
Package worktreeadapter implements configured git repository and worktree operations for the Copilot adapter. |
|
Package cron is the cron service: the durable in-process scheduler that mounts into a host runtime, fires each declared trigger on its schedule and records every occurrence through csfpg.
|
Package cron is the cron service: the durable in-process scheduler that mounts into a host runtime, fires each declared trigger on its schedule and records every occurrence through csfpg. |
|
crontest
Package crontest opens the cron store on pgmem, CSF's in-process substitute for PostgreSQL, with CSF's real schema applied: the store a spec grants when it needs cron state without a database.
|
Package crontest opens the cron store on pgmem, CSF's in-process substitute for PostgreSQL, with CSF's real schema applied: the store a spec grants when it needs cron state without a database. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
Package database is CSF's own database: the PostgreSQL container a host provisions and owns when it is given no other, so CSF's state lives with CSF and never in another project's database.
|
Package database is CSF's own database: the PostgreSQL container a host provisions and owns when it is given no other, so CSF's state lives with CSF and never in another project's database. |
|
Package deploy contains the small, durable domain model shared by Deploy controllers and user-facing applications.
|
Package deploy contains the small, durable domain model shared by Deploy controllers and user-facing applications. |
|
component
Package component defines the public bring-up contract for services an embedding repository composes alongside deploy.
|
Package component defines the public bring-up contract for services an embedding repository composes alongside deploy. |
|
config
Package config resolves deploy's environment into its canonical Liquid Proto contract.
|
Package config resolves deploy's environment into its canonical Liquid Proto contract. |
|
control
Package control is deploy's control-plane composition root beneath main.
|
Package control is deploy's control-plane composition root beneath main. |
|
fleet
Package fleet is deploy's read-only view of Warden's cluster membership.
|
Package fleet is deploy's read-only view of Warden's cluster membership. |
|
internal/storedb
Package storedb is the sqlc-generated query layer over the deploy control schema.
|
Package storedb is the sqlc-generated query layer over the deploy control schema. |
|
operator
Package operator owns deploy's agent turn: policy, approvals, and run state.
|
Package operator owns deploy's agent turn: policy, approvals, and run state. |
|
reconcile
Package reconcile turns approved desired state into fenced node-agent calls.
|
Package reconcile turns approved desired state into fenced node-agent calls. |
|
store
Package store is Deploy's durable control-plane state.
|
Package store is Deploy's durable control-plane state. |
|
Package dispatch is the intent-ranked work queue of one harness process: a slice graph, its frontier, and the list scheduling that dispatches the frontier onto agent sessions.
|
Package dispatch is the intent-ranked work queue of one harness process: a slice graph, its frontier, and the list scheduling that dispatches the frontier onto agent sessions. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
Package dreamer is the mining loop's dreaming: the service that keeps the slice dispatcher's ready frontier as long as its admission can use, with the work most likely to bend the struggle rate down.
|
Package dreamer is the mining loop's dreaming: the service that keeps the slice dispatcher's ready frontier as long as its admission can use, with the work most likely to bend the struggle rate down. |
|
Package email provides a composable, host-configured email capability.
|
Package email provides a composable, host-configured email capability. |
|
Package harness defines the public behavior boundary between deploy and a compiled-in agent runtime implementation.
|
Package harness defines the public behavior boundary between deploy and a compiled-in agent runtime implementation. |
|
chat
Package chat is the Workbench chat for harness sessions: a gotth-live page that shows one session's transcript as its event log grows and sends the operator's messages into the open session through the harness service, in process.
|
Package chat is the Workbench chat for harness sessions: a gotth-live page that shows one session's transcript as its event log grows and sends the operator's messages into the open session through the harness service, in process. |
|
costs
Package costs is the cost model of the harness's session operations.
|
Package costs is the cost model of the harness's session operations. |
|
endpoint
Package endpoint is the endpoint registry: the typed record, in the harness state directory, of every operator-facing endpoint csf serve has served (the Workbench, the API and MCP), each with its owner, its users and every address it has been served at, and of every address the operator retired, with the address it moved to, the day and the operator's acknowledgement.
|
Package endpoint is the endpoint registry: the typed record, in the harness state directory, of every operator-facing endpoint csf serve has served (the Workbench, the API and MCP), each with its owner, its users and every address it has been served at, and of every address the operator retired, with the address it moved to, the day and the operator's acknowledgement. |
|
longturns
Package longturns detects and manages long-running turns that may indicate stuck execution.
|
Package longturns detects and manages long-running turns that may indicate stuck execution. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
opencode
Package opencode implements the built-in OpenCode agent runtime behind the public deploy harness seam.
|
Package opencode implements the built-in OpenCode agent runtime behind the public deploy harness seam. |
|
progress
Package progress projects each harness session into one session_progress row — the assignment, agent, phase, turn, queue depth, tool calls, commits ahead, changed files, model, last activity and last note — and folds the session's event log into the readable lines a tail follows.
|
Package progress projects each harness session into one session_progress row — the assignment, agent, phase, turn, queue depth, tool calls, commits ahead, changed files, model, last activity and last note — and folds the session's event log into the readable lines a tail follows. |
|
provider
Package provider is the inference provider every session this host launches reaches its model through.
|
Package provider is the inference provider every session this host launches reaches its model through. |
|
relayhook
Package relayhook provides the UserPromptSubmit hook that forwards prompts to an orchestrator session and blocks the proxy session from taking turns.
|
Package relayhook provides the UserPromptSubmit hook that forwards prompts to an orchestrator session and blocks the proxy session from taking turns. |
|
routing
Package routing maps virtual sessions onto real sessions.
|
Package routing maps virtual sessions onto real sessions. |
|
session
Package session is the agent harness's session runner: it runs an agent's session for an assignment on a turn executor, in a git worktree of its own, with the session gates installed and every event logged under the run's trace.
|
Package session is the agent harness's session runner: it runs an agent's session for an assignment on a turn executor, in a git worktree of its own, with the session gates installed and every event logged under the run's trace. |
|
session/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
sessiongate
Package sessiongate holds the session gates the agent harness installs into every session it runs: structural checks Claude Code calls as hooks around a tool call and at the end of a turn.
|
Package sessiongate holds the session gates the agent harness installs into every session it runs: structural checks Claude Code calls as hooks around a tool call and at the end of a turn. |
|
upgrade
Package upgrade replaces the csf binary with a released one and restarts the harness on it, keeping the binary it replaced for a rollback.
|
Package upgrade replaces the csf binary with a released one and restarts the harness on it, keeping the binary it replaced for a rollback. |
|
Package housekeeping is the housekeeping service: the default cron triggers that keep a harness host's disk and state healthy.
|
Package housekeeping is the housekeeping service: the default cron triggers that keep a harness host's disk and state healthy. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
Package intake turns GitHub activity into the typed candace.intake.v1.Event and takes each to whoever acts on it.
|
Package intake turns GitHub activity into the typed candace.intake.v1.Event and takes each to whoever acts on it. |
|
Package jobs is the harness job ledger: the durable record of requests admitted to external executors, kept in the tables csf_jobs, csf_job_budgets, csf_job_metric_definitions, csf_job_measurements and csf_job_trace_deliveries.
|
Package jobs is the harness job ledger: the durable record of requests admitted to external executors, kept in the tables csf_jobs, csf_job_budgets, csf_job_metric_definitions, csf_job_measurements and csf_job_trace_deliveries. |
|
jobsmock
Package jobsmock is a generated GoMock package.
|
Package jobsmock is a generated GoMock package. |
|
Package knowledge keeps CSF's search index fed and measured: the repository at the head of main, the harness state (its JSON key names, never their values), each run's conversation (user and assistant text, never tool output) and the repository's tickets and pull requests, ingested through the knowledge service's own IngestDocument so the store stays the evidence and the index its projection.
|
Package knowledge keeps CSF's search index fed and measured: the repository at the head of main, the harness state (its JSON key names, never their values), each run's conversation (user and assistant text, never tool output) and the repository's tickets and pull requests, ingested through the knowledge service's own IngestDocument so the store stays the evidence and the index its projection. |
|
client
Package client is deploy's transport to one node agent.
|
Package client is deploy's transport to one node agent. |
|
Package opsview is the ops view: a gotth-live page that shows every harness session on this machine as a live card, read from the run directories under the harness state directory.
|
Package opsview is the ops view: a gotth-live page that shows every harness session on this machine as a live card, read from the run directories under the harness state directory. |
|
Package ouroboros is the mining loop: the service that runs every accepted miner over the harness corpus all the time, decides for free whether a mining ticket can be fixed, launches one fixer session per ticket through the harness under a daily budget, merges ready pull requests through the merge path, and measures the compounding number the loop exists for.
|
Package ouroboros is the mining loop: the service that runs every accepted miner over the harness corpus all the time, decides for free whether a mining ticket can be fixed, launches one fixer session per ticket through the harness under a daily budget, merges ready pull requests through the merge path, and measures the compounding number the loop exists for. |
|
codes
Package codes holds CSF's failure codes and codes complaints with them.
|
Package codes holds CSF's failure codes and codes complaints with them. |
|
evaluate
Package evaluate scores csf builds on a held-out, rotated suite of past tickets before they go live (EVAL-SUITE, #416).
|
Package evaluate scores csf builds on a held-out, rotated suite of past tickets before they go live (EVAL-SUITE, #416). |
|
labeler
Package labeler is the ouroboros labeler (csf_staging#318): for a mining ticket that names no real instance, it finds candidate spans in the corpus the ticket's miner would read, asks a local model to label them, and keeps only the labels that reproduce.
|
Package labeler is the ouroboros labeler (csf_staging#318): for a mining ticket that names no real instance, it finds candidate spans in the corpus the ticket's miner would read, asks a local model to label them, and keeps only the labels that reproduce. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
Package relay delivers messages between agents.
|
Package relay delivers messages between agents. |
|
relaytest
Package relaytest holds the conformance specs every relay.IRegistry implementation must pass, and the messaging specs every relay.Relay[Body] must pass over such a registry.
|
Package relaytest holds the conformance specs every relay.IRegistry implementation must pass, and the messaging specs every relay.Relay[Body] must pass over such a registry. |
|
Package views is CSF's measurements and the Prometheus and Grafana that show them: CSF owns both and uses no other project's.
|
Package views is CSF's measurements and the Prometheus and Grafana that show them: CSF owns both and uses no other project's. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
Package warden defines the shared contracts for the candacenet warden service: core types, the wire protocol, and the interfaces that the election, watchdog, notification, dashboard, and configuration packages implement or consume.
|
Package warden defines the shared contracts for the candacenet warden service: core types, the wire protocol, and the interfaces that the election, watchdog, notification, dashboard, and configuration packages implement or consume. |
|
config
Package config loads warden node configuration from built-in defaults, an optional YAML file, and environment overrides, in that precedence order (env beats file beats defaults).
|
Package config loads warden node configuration from built-in defaults, an optional YAML file, and environment overrides, in that precedence order (env beats file beats defaults). |
|
dashboard
Package dashboard renders the operator-facing observability surface of a warden node: a server-side-rendered, HTMX-refreshed dashboard, an HTMX partial for live cluster refresh, and a JSON status API.
|
Package dashboard renders the operator-facing observability surface of a warden node: a server-side-rendered, HTMX-refreshed dashboard, an HTMX partial for live cluster refresh, and a JSON status API. |
|
discovery
Package discovery implements warden.IPeerDiscoverer: the sources that report which nodes are candidate members of the cluster.
|
Package discovery implements warden.IPeerDiscoverer: the sources that report which nodes are candidate members of the cluster. |
|
election
Package election implements Raft-style leader election (terms and votes, no log replication) over a static peer set, plus the peer-liveness tracking that feeds the cluster ClusterView.
|
Package election implements Raft-style leader election (terms and votes, no log replication) over a static peer set, plus the peer-liveness tracking that feeds the cluster ClusterView. |
|
grpcmux
Package grpcmux multiplexes the warden gRPC plane and the existing HTTP surface onto a SINGLE bound port using soheilhy/cmux.
|
Package grpcmux multiplexes the warden gRPC plane and the existing HTTP surface onto a SINGLE bound port using soheilhy/cmux. |
|
grpcserver
Package grpcserver implements the candacenet.warden.v1 WardenService: the three unary cluster RPCs (Vote/Heartbeat/Identify) delegating to the existing warden.IRPCHandler through the wireconv boundary, and the server-streaming WatchCluster that pushes full ClusterView snapshots from a warden.IViewSource.
|
Package grpcserver implements the candacenet.warden.v1 WardenService: the three unary cluster RPCs (Vote/Heartbeat/Identify) delegating to the existing warden.IRPCHandler through the wireconv boundary, and the server-streaming WatchCluster that pushes full ClusterView snapshots from a warden.IViewSource. |
|
grpctransport
Package grpctransport is the gRPC client side of the warden cluster wire protocol: it implements warden.ITransport (RequestVote/SendHeartbeat/Identify) over the candacenet.warden.v1 WardenService, replacing the retired HTTP/JSON HTTPTransport.
|
Package grpctransport is the gRPC client side of the warden cluster wire protocol: it implements warden.ITransport (RequestVote/SendHeartbeat/Identify) over the candacenet.warden.v1 WardenService, replacing the retired HTTP/JSON HTTPTransport. |
|
httpserver
Package httpserver builds the single gin.Engine every warden node serves its HTTP surface from (dashboard + /api/status + /metrics).
|
Package httpserver builds the single gin.Engine every warden node serves its HTTP surface from (dashboard + /api/status + /metrics). |
|
internal/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
internal/transportidentity
Package transportidentity carries transport-observed peer identity between Warden's gRPC adapter and election state machine.
|
Package transportidentity carries transport-observed peer identity between Warden's gRPC adapter and election state machine. |
|
metrics
Package metrics exposes a warden node's cluster state as Prometheus metrics.
|
Package metrics exposes a warden node's cluster state as Prometheus metrics. |
|
notify
Package notify implements the warden.INotifier delivery backends used by the watchdog:
|
Package notify implements the warden.INotifier delivery backends used by the watchdog: |
|
proto/warden/v1
Package wardenv1 holds the generated Go bindings for the candacenet warden wire contracts (candacenet.warden.v1).
|
Package wardenv1 holds the generated Go bindings for the candacenet warden wire contracts (candacenet.warden.v1). |
|
store
Package store provides persistence for warden.PersistentState (the Raft current term and vote).
|
Package store provides persistence for warden.PersistentState (the Raft current term and vote). |
|
testclock
Package testclock provides a deterministic, manually-advanced implementation of warden.IClock for tests.
|
Package testclock provides a deterministic, manually-advanced implementation of warden.IClock for tests. |
|
watchdog
Package watchdog turns cluster views into operator alerts.
|
Package watchdog turns cluster views into operator alerts. |
|
wireconv
Package wireconv provides total, composable conversions between the frozen warden domain types (services/warden) and the generated candacenet.warden.v1 protobuf messages (services/warden/proto/warden/v1).
|
Package wireconv provides total, composable conversions between the frozen warden domain types (services/warden) and the generated candacenet.warden.v1 protobuf messages (services/warden/proto/warden/v1). |
|
Package workcontinuity validates and records task checkpoints so work can resume across agents and sessions.
|
Package workcontinuity validates and records task checkpoints so work can resume across agents and sessions. |
Click to show internal directories.
Click to hide internal directories.