internal/

directory
v0.5.0 Latest Latest
Warning

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

Go to latest
Published: Jul 22, 2026 License: Apache-2.0

Directories

Path Synopsis
adapters
builtin/adapterkit
Package adapterkit holds the schema-info and query-compilation boilerplate every built-in graph-backend adapter shares, so each adapter (compliance- register, sdd-register, …) translates its registry.Schema and compiles its DSL queries through ONE source instead of copy-pasting the loop bodies.
Package adapterkit holds the schema-info and query-compilation boilerplate every built-in graph-backend adapter shares, so each adapter (compliance- register, sdd-register, …) translates its registry.Schema and compiles its DSL queries through ONE source instead of copy-pasting the loop bodies.
builtin/compliance-register
Package complianceregister implements the built-in compliance-register graph-backend adapter (graph-backend-adapter-contract §13.2).
Package complianceregister implements the built-in compliance-register graph-backend adapter (graph-backend-adapter-contract §13.2).
builtin/compliance-register/views
Package views declares the compliance-register adapter's cross-adapter materialized views (graph-backend-adapter-contract §8.3).
Package views declares the compliance-register adapter's cross-adapter materialized views (graph-backend-adapter-contract §8.3).
builtin/crg
Package crg implements the built-in kg-native Code Review Graph adapter (graph-backend-adapter-contract §11).
Package crg implements the built-in kg-native Code Review Graph adapter (graph-backend-adapter-contract §11).
builtin/crg-bridge
Package crgbridge implements the migration-only crg-bridge adapter (graph-backend-adapter-contract §11.2).
Package crgbridge implements the migration-only crg-bridge adapter (graph-backend-adapter-contract §11.2).
builtin/none
Package none implements the built-in `none` graph-backend adapter (graph-backend-adapter-contract §13.1).
Package none implements the built-in `none` graph-backend adapter (graph-backend-adapter-contract §13.1).
builtin/sdd-register
Package sddregister implements the SDD-entity dogfood graph-backend adapter.
Package sddregister implements the SDD-entity dogfood graph-backend adapter.
sdk
Package sdk is the `da-adapter-sdk` Go surface that bootstrap skills use exclusively to write into scoped KG storage (graph-backend-adapter-contract §8.4).
Package sdk is the `da-adapter-sdk` Go surface that bootstrap skills use exclusively to write into scoped KG storage (graph-backend-adapter-contract §8.4).
Package agentslock is the single shared writer for .agentsrc.lock — the resolved-state companion to .agentsrc.json (config-distribution-model §7).
Package agentslock is the single shared writer for .agentsrc.lock — the resolved-state companion to .agentsrc.json (config-distribution-model §7).
Package credstore implements the shared encrypted credential store and the CI-aware loader described in external-agent-sources design §4.1.
Package credstore implements the shared encrypted credential store and the CI-aware loader described in external-agent-sources design §4.1.
dashboard
events
Package events implements the R2 dashboard's SSE broker (plan task t04-sse-broker): an in-process fan-out from event sources to per-client bounded buffers.
Package events implements the R2 dashboard's SSE broker (plan task t04-sse-broker): an in-process fan-out from event sources to per-client bounded buffers.
handlers
Package handlers implements the R2 observability dashboard's REST API (plan task t03-handlers-rest) per the pinned contract in .agents/workflow/plans/r2-observability-dashboard/design/API.md.
Package handlers implements the R2 observability dashboard's REST API (plan task t03-handlers-rest) per the pinned contract in .agents/workflow/plans/r2-observability-dashboard/design/API.md.
server
r3mount.go mounts the R2 observability dashboard INSIDE the R3 background-worker service (task t13-r3-mount-integration): it composes the dashboard's store → broker → handlers collaborators, stitches the REST/SSE handler mount onto R3's HTTP/SSE edge via RegisterMount (spec D5 — the browser-facing arm of the r3 §2A surface→transport map, NEVER the UDS control plane), and bridges R3's EventBus into the broker so R3's in-process publish is the dashboard's PRIMARY event source.
r3mount.go mounts the R2 observability dashboard INSIDE the R3 background-worker service (task t13-r3-mount-integration): it composes the dashboard's store → broker → handlers collaborators, stitches the REST/SSE handler mount onto R3's HTTP/SSE edge via RegisterMount (spec D5 — the browser-facing arm of the r3 §2A surface→transport map, NEVER the UDS control plane), and bridges R3's EventBus into the broker so R3's in-process publish is the dashboard's PRIMARY event source.
store
Package store is the R2 observability dashboard's read-through data layer.
Package store is the R2 observability dashboard's read-through data layer.
watch
Package watch is the t06 iter-log filesystem watcher → SSE-broker bridge (plan task t06-recompute-on-miss-and-fswatch): the v1 standalone push path that exists BEFORE R3's publish primitive lands.
Package watch is the t06 iter-log filesystem watcher → SSE-broker bridge (plan task t06-recompute-on-miss-and-fswatch): the v1 standalone push path that exists BEFORE R3's publish primitive lands.
Package docsaccess is the client half of CF Access integration for the internal docs surface.
Package docsaccess is the client half of CF Access integration for the internal docs surface.
Package eval is the foundation of the R4 code-task generation and evaluation harness.
Package eval is the foundation of the R4 code-task generation and evaluation harness.
gen/gencore
Package gencore is the shared engine of the R4 eval task generator.
Package gencore is the shared engine of the R4 eval task generator.
gen/golang
Package gogen is the Go-language adapter of the shared R4 task generator.
Package gogen is the Go-language adapter of the shared R4 task generator.
gen/python
Package pygen is the Python-language adapter of the shared R4 task generator.
Package pygen is the Python-language adapter of the shared R4 task generator.
gen/typescript
Package tsgen is the TypeScript-language adapter of the shared R4 task generator.
Package tsgen is the TypeScript-language adapter of the shared R4 task generator.
harness
Package harness is the R4 eval driver: a single Harness.Run entry point that sequences the five eval stages and returns an EvalRun aggregating every stage's output.
Package harness is the R4 eval driver: a single Harness.Run entry point that sequences the five eval stages and returns an EvalRun aggregating every stage's output.
kgquery
Package kgquery is the R4 harness's read-only adapter over the code knowledge graph.
Package kgquery is the R4 harness's read-only adapter over the code knowledge graph.
runner
Package runner abstracts over invoking a CLI agent against a sandbox working directory.
Package runner abstracts over invoking a CLI agent against a sandbox working directory.
sandbox
Package sandbox provisions isolated working directories for R4 eval runs.
Package sandbox provisions isolated working directories for R4 eval runs.
scoringbridge
Package scoringbridge translates a completed eval run into the R1 scoring pipeline: it emits an R1-shaped iteration record and scores it with the production rubric, persisting both under the run's eval-namespaced iteration-log directory.
Package scoringbridge translates a completed eval run into the R1 scoring pipeline: it emits an R1-shaped iteration record and scores it with the production rubric, persisting both under the run's eval-namespaced iteration-log directory.
store
Package store persists the store-owned sidecar files of a completed eval run into the canonical run directory <root>/.agents/eval/runs/<run-id>/.
Package store persists the store-owned sidecar files of a completed eval run into the canonical run directory <root>/.agents/eval/runs/<run-id>/.
verifier
Package verifier defines the language-agnostic verifier contract for the R4 eval harness and houses the shared run engine every per-language verifier reuses.
Package verifier defines the language-agnostic verifier contract for the R4 eval harness and houses the shared run engine every per-language verifier reuses.
verifier/golang
Package goverifier is the Go-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
Package goverifier is the Go-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
verifier/python
Package pyverifier is the Python-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
Package pyverifier is the Python-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
verifier/typescript
Package tsverifier is the TypeScript-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
Package tsverifier is the TypeScript-language adapter for the R4 eval verifier (R4 spec task t-verifier-iface).
Package events implements a unified event-contract core: a typed Envelope, a runtime Kind registry, table-driven dispatch, a generic config-driven producer engine, and a dependency-free JSONPath subset.
Package events implements a unified event-contract core: a typed Envelope, a runtime Kind registry, table-driven dispatch, a generic config-driven producer engine, and a dependency-free JSONPath subset.
Package fsops provides filesystem operations with OS-appropriate implementations.
Package fsops provides filesystem operations with OS-appropriate implementations.
Package gitremote is the canonical home for parsing and canonicalizing git remote URLs in dot-agents.
Package gitremote is the canonical home for parsing and canonicalizing git remote URLs in dot-agents.
Package gitwt is the typed git/worktree seam for the dot-agents managed worktree platform.
Package gitwt is the typed git/worktree seam for the dot-agents managed worktree platform.
Package globalflagcov computes which persistent global CLI flags (commands.Flags) are referenced transitively from each cobra command's RunE handler.
Package globalflagcov computes which persistent global CLI flags (commands.Flags) are referenced transitively from each cobra command's RunE handler.
Package graphstore — CRG bridge.
Package graphstore — CRG bridge.
internal/storetest
Package storetest provides shared backend-agnostic test bodies for graphstore.Store implementations.
Package storetest provides shared backend-agnostic test bodies for graphstore.Store implementations.
Package journal is the append-only, crash-survivable event log that backs the session-handoff feature — the "episodic" typed view of agent state (events/history/decisions).
Package journal is the append-only, crash-survivable event log that backs the session-handoff feature — the "episodic" typed view of agent state (events/history/decisions).
kg
dsl
Package dsl implements the v1 named-query DSL of the graph-backend adapter contract (graph-backend-adapter-contract §5).
Package dsl implements the v1 named-query DSL of the graph-backend adapter contract (graph-backend-adapter-contract §5).
dsl/cross-namespace
Package crossnamespace executes a cross-adapter materialized view: a single v1 DSL query (internal/kg/dsl) that joins a consumer adapter's namespace with one or more reads_from dependency namespaces (graph-backend-adapter-contract §8.3).
Package crossnamespace executes a cross-adapter materialized view: a single v1 DSL query (internal/kg/dsl) that joins a consumer adapter's namespace with one or more reads_from dependency namespaces (graph-backend-adapter-contract §8.3).
lockfile
Package lockfile implements the adapter lockfile state (graph-backend-adapter-contract §10.1).
Package lockfile implements the adapter lockfile state (graph-backend-adapter-contract §10.1).
registry
Package registry defines the graph-backend adapter contract and a register/resolve surface keyed by adapter name.
Package registry defines the graph-backend adapter contract and a register/resolve surface keyed by adapter name.
Package linktest provides cross-platform managed-link fixtures for tests.
Package linktest provides cross-platform managed-link fixtures for tests.
Package projectsync provides shared helpers for creating project directory structures, restoring resource files, writing refresh markers, and managing gitignore entries.
Package projectsync provides shared helpers for creating project directory structures, restoring resource files, writing refresh markers, and managing gitignore entries.
review
audit
Package audit implements the R5 append-only, hash-chained audit log (design D5.4).
Package audit implements the R5 append-only, hash-chained audit log (design D5.4).
auth
Package auth implements the R5 RBAC identity layer: a pluggable Authenticator interface, an admin-managed users file, bearer-token issuance and verification, and the role/permission model the review service enforces.
Package auth implements the R5 RBAC identity layer: a pluggable Authenticator interface, an admin-managed users file, bearer-token issuance and verification, and the role/permission model the review service enforces.
http
Package http is the R5 review collection endpoint: the HTTP arm of the §2A surface→transport map.
Package http is the R5 review collection endpoint: the HTTP arm of the §2A surface→transport map.
labels
Package labels defines the human-review label data model and its YAML sidecar persistence.
Package labels defines the human-review label data model and its YAML sidecar persistence.
scaffold
Package scoring defines and applies the dot-agents outcome-scoring rubric: an explainable quality score per agent-run iteration and session, computed from already-captured telemetry.
Package scoring defines and applies the dot-agents outcome-scoring rubric: an explainable quality score per agent-run iteration and session, computed from already-captured telemetry.
Package service composes the `da service` runtime out of the pieces the sibling packages ship (spec §2A shape, OQ5 option B): the event bus behind the D4.1 EventBus interface seam, the in-process scheduler hosting the two v1 background tasks (iter-log ingester + rubric-bump rescorer), and BOTH transport listeners — the Unix-domain-socket control plane (`da service status`/`stop`, peer-credential gated per OQ4/§2A) and the HTTP/SSE edge (loopback-only by default per OQ3).
Package service composes the `da service` runtime out of the pieces the sibling packages ship (spec §2A shape, OQ5 option B): the event bus behind the D4.1 EventBus interface seam, the in-process scheduler hosting the two v1 background tasks (iter-log ingester + rubric-bump rescorer), and BOTH transport listeners — the Unix-domain-socket control plane (`da service status`/`stop`, peer-credential gated per OQ4/§2A) and the HTTP/SSE edge (loopback-only by default per OQ3).
events
Package events provides an in-process publish/subscribe bus that lets background tasks notify subscribers about state changes without coupling to them.
Package events provides an in-process publish/subscribe bus that lets background tasks notify subscribers about state changes without coupling to them.
events/eventbustest
Package eventbustest ships the backend-conformance suite for the events.EventBus transport seam (spec D4.6).
Package eventbustest ships the backend-conformance suite for the events.EventBus transport seam (spec D4.6).
http
Package http is the transport layer of the `da service` runtime (spec §2A, OQ5 option B).
Package http is the transport layer of the `da service` runtime (spec §2A, OQ5 option B).
scheduler
Package scheduler is the in-process job scheduler that hosts the background tasks of the `da service` runtime.
Package scheduler is the in-process job scheduler that hosts the background tasks of the `da service` runtime.
state
Package state persists the per-task watermark sidecars that give the `da service` background tasks restart safety (R3 design decision D3).
Package state persists the per-task watermark sidecars that give the `da service` background tasks restart safety (R3 design decision D3).
tasks
Package tasks contains the concrete background tasks hosted by the `da service` scheduler (R3 design D2).
Package tasks contains the concrete background tasks hosted by the `da service` scheduler (R3 design D2).
Package testutil provides shared test scaffolding helpers used by *_test.go files across the dot-agents tree.
Package testutil provides shared test scaffolding helpers used by *_test.go files across the dot-agents tree.

Jump to

Keyboard shortcuts

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