Help us shape the future of Go! Take the 2026 Go Developer Survey

cmd

package
v0.1.0 Latest Latest
Warning

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

 Go to latest Published: Oct 28, 2026 License: MIT Imports: 42 Imported by: 0

Documentation

Overview

Package cmd is the dispatcher for the agentic-dev-harness CLI. It registers all commands and routes incoming arguments to the matching command implementation.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Run 

func Run(
	ctx context.Context,
	args []string,
	getenv func(string) string,
	stdin io.Reader,
	stdout, stderr io.Writer,
) error

Run parses args and dispatches to the matching command. args must not include the executable name (pass os.Args[1:]).

Every flag can be set via a AGENTIC_DEV_HARNESS_-prefixed environment variable. The mapping rule is: prepend AGENTIC_DEV_HARNESS_, uppercase, replace dashes with underscores.

Flags supplied on the command line always take precedence over env vars.

Types

This section is empty.

Source Files

View all Source files

Directories

Path Synopsis
Package approve implements the "approve" CLI command: satisfy a pending human safety gate on an arc (SPEC §5.2).
 Package approve implements the "approve" CLI command: satisfy a pending human safety gate on an arc (SPEC §5.2).
Package arc implements the "arc" CLI command: create, list, and show work arcs.
 Package arc implements the "arc" CLI command: create, list, and show work arcs.
Package autonomy implements the "autonomy" CLI command: show or set the autonomy ladder level (SPEC §6).
 Package autonomy implements the "autonomy" CLI command: show or set the autonomy ladder level (SPEC §6).
Package closecmd implements the "close" CLI command: ship an arc that is waiting, approved, at the ops gate.
 Package closecmd implements the "close" CLI command: ship an arc that is waiting, approved, at the ops gate.
Package contextcmd implements the "context" CLI command: inspect the just-in-time context store (SPEC-ADDITIONS §10) — list units, show one unit's text and provenance, route a working set by labels, lint the store, or verify that routed units have not drifted from their canonical source.
 Package contextcmd implements the "context" CLI command: inspect the just-in-time context store (SPEC-ADDITIONS §10) — list units, show one unit's text and provenance, route a working set by labels, lint the store, or verify that routed units have not drifted from their canonical source.
Package device implements the "device" CLI command: on-device validation (SPEC §4).
 Package device implements the "device" CLI command: on-device validation (SPEC §4).
Package docscmd implements the "docs" CLI command: generate man pages for the whole command tree straight from the live ff.Command definitions, so the pages never drift from the flags.
 Package docscmd implements the "docs" CLI command: generate man pages for the whole command tree straight from the live ff.Command definitions, so the pages never drift from the flags.
Package doctorcmd implements the "doctor" CLI command: the harness-integrity self-check (SPEC-ADDITIONS §10.4).
 Package doctorcmd implements the "doctor" CLI command: the harness-integrity self-check (SPEC-ADDITIONS §10.4).
Package evalcmd implements the "eval" CLI command: the deterministic Evaluation stage (SPEC-ADDITIONS §19.2).
 Package evalcmd implements the "eval" CLI command: the deterministic Evaluation stage (SPEC-ADDITIONS §19.2).
Package failurescmd implements the "failures" CLI command (SPEC §2.5): show the failure registry (§4.1) and the §11 lesson candidates, grouped into governing classes so a recurring one is visible.
 Package failurescmd implements the "failures" CLI command (SPEC §2.5): show the failure registry (§4.1) and the §11 lesson candidates, grouped into governing classes so a recurring one is visible.
Package gatecmd implements the "gate" CLI command (SPEC §2.3): list the pending human gates across arcs — the arcs parked blocked, awaiting an approve/reject.
 Package gatecmd implements the "gate" CLI command (SPEC §2.3): list the pending human gates across arcs — the arcs parked blocked, awaiting an approve/reject.
Package harnesscmd implements the "harness" CLI command, the self-optimization surface (SPEC-ADDITIONS §18.2, §11) with real nested subcommands: `eval` scores a guiding artifact (rubric floor + judge-only dimensions, optionally beside a decoded skillsaw score), `gate` runs the comparative validation ratchet on candidate/current/best scores, `hash` reports an artifact's content identity (sha256[:16]), and `calibrate` checks the judge against labeled fixtures.
 Package harnesscmd implements the "harness" CLI command, the self-optimization surface (SPEC-ADDITIONS §18.2, §11) with real nested subcommands: `eval` scores a guiding artifact (rubric floor + judge-only dimensions, optionally beside a decoded skillsaw score), `gate` runs the comparative validation ratchet on candidate/current/best scores, `hash` reports an artifact's content identity (sha256[:16]), and `calibrate` checks the judge against labeled fixtures.
Package initcmd implements the "init" CLI command: scaffold the .adh workspace so later commands have somewhere to store arcs, a starter config to tailor, and a context store so the cold critic can be grounded out of the box (SPEC §2.1, §3.1, §19.1).
 Package initcmd implements the "init" CLI command: scaffold the .adh workspace so later commands have somewhere to store arcs, a starter config to tailor, and a context store so the cold critic can be grounded out of the box (SPEC §2.1, §3.1, §19.1).
Package judgecmd implements the "judge" CLI command: score an output against a JSON array of deterministic rule checks (SPEC-ADDITIONS §11).
 Package judgecmd implements the "judge" CLI command: score an output against a JSON array of deterministic rule checks (SPEC-ADDITIONS §11).
Package kpicmd implements the "kpi" CLI command: measure each context unit's and declared tool's KPIs against how they actually behaved — the failure-record log for units, the tool-run log for tools — and report the degradation proposals a breach earned (SPEC-ADDITIONS §16/§18).
 Package kpicmd implements the "kpi" CLI command: measure each context unit's and declared tool's KPIs against how they actually behaved — the failure-record log for units, the tool-run log for tools — and report the degradation proposals a breach earned (SPEC-ADDITIONS §16/§18).
Package lessoncmd implements the "lesson" CLI command: distill the failure registry into candidate lessons and promote one to a durable owner (SPEC-ADDITIONS §11).
 Package lessoncmd implements the "lesson" CLI command: distill the failure registry into candidate lessons and promote one to a durable owner (SPEC-ADDITIONS §11).
Package loopcmd implements the "loop" CLI command: list, run, tick, and retire maintenance loops (SPEC-ADDITIONS §15).
 Package loopcmd implements the "loop" CLI command: list, run, tick, and retire maintenance loops (SPEC-ADDITIONS §15).
Package metricscmd implements the "metrics" CLI command: report effectiveness accounting — attention per accepted arc and compute (SPEC-ADDITIONS §16).
 Package metricscmd implements the "metrics" CLI command: report effectiveness accounting — attention per accepted arc and compute (SPEC-ADDITIONS §16).
Package nfrcmd implements the "nfr" CLI command: inspect the nonfunctional- requirement specs (SPEC-ADDITIONS §10.5) — list them, show one, or lint them for Planguage well-formedness (taxonomy, thresholds ordered, a meter and scale).
 Package nfrcmd implements the "nfr" CLI command: inspect the nonfunctional- requirement specs (SPEC-ADDITIONS §10.5) — list them, show one, or lint them for Planguage well-formedness (taxonomy, thresholds ordered, a meter and scale).
Package oracle implements the "oracle" CLI command: the differential oracle (diff), the invariant checks (invariants), and the planted-defect self-test (selftest) of the eval layer (SPEC §4, SPEC-ADDITIONS §18).
 Package oracle implements the "oracle" CLI command: the differential oracle (diff), the invariant checks (invariants), and the planted-defect self-test (selftest) of the eval layer (SPEC §4, SPEC-ADDITIONS §18).
Package proof implements the "proof" CLI command with real nested subcommands: `create` hashes an arc's artifacts into a manifest and records it on the arc, and `verify` checks a manifest under NO-PROOF-NO-CLOSE (SPEC §5.4).
 Package proof implements the "proof" CLI command with real nested subcommands: `create` hashes an arc's artifacts into a manifest and records it on the arc, and `verify` checks a manifest under NO-PROOF-NO-CLOSE (SPEC §5.4).
Package reject implements the "reject" CLI command: the negative half of the human gate (SPEC §5.2, §2.3).
 Package reject implements the "reject" CLI command: the negative half of the human gate (SPEC §5.2, §2.3).
Package root defines the root configuration for the CLI.
 Package root defines the root configuration for the CLI.
Package run implements the "run" CLI command: relay an arc through stages until it reaches a human gate or closes (SPEC §2.1), honoring the autonomy level and rework budget resolved from config.
 Package run implements the "run" CLI command: relay an arc through stages until it reaches a human gate or closes (SPEC §2.1), honoring the autonomy level and rework budget resolved from config.
Package selfeval implements the "selfeval" CLI command (SPEC §2.5): a periodic self-evaluation that reports effectiveness health (§16) and the failure taxonomy (§4.1, §11).
 Package selfeval implements the "selfeval" CLI command (SPEC §2.5): a periodic self-evaluation that reports effectiveness health (§16) and the failure taxonomy (§4.1, §11).
Package sessionscmd implements the "sessions" CLI command: mine foreign agent-session stores for corrections that never became arcs, and report what was found.
 Package sessionscmd implements the "sessions" CLI command: mine foreign agent-session stores for corrections that never became arcs, and report what was found.
Package sleep implements the "sleep" CLI command: the offline consolidation cycle (SPEC-ADDITIONS §18.4).
 Package sleep implements the "sleep" CLI command: the offline consolidation cycle (SPEC-ADDITIONS §18.4).
Package stagecmd implements the per-stage direct commands (SPEC §2.2): strategy, execute, and critic each run one stage on an arc already at that stage, through the mock model, for debugging or manual re-runs — normal operation uses `adh run`/`adh step`.
 Package stagecmd implements the per-stage direct commands (SPEC §2.2): strategy, execute, and critic each run one stage on an arc already at that stage, through the mock model, for debugging or manual re-runs — normal operation uses `adh run`/`adh step`.
Package status implements the "status" CLI command: a summary of the harness state — open arcs, arcs blocked at a gate, and the current autonomy level.
 Package status implements the "status" CLI command: a summary of the harness state — open arcs, arcs blocked at a gate, and the current autonomy level.
Package step implements the "step" CLI command: run exactly one stage transition on an arc through the model seam, then stop (SPEC §2.1).
 Package step implements the "step" CLI command: run exactly one stage transition on an arc through the model seam, then stop (SPEC §2.1).
Package toolcmd implements the "tool" CLI command: inspect and invoke the tool registry (SPEC-ADDITIONS §13) — list declared tools, run doctor to validate them, or run one so the worker can invoke an external capability in-loop and interpret its output.
 Package toolcmd implements the "tool" CLI command: inspect and invoke the tool registry (SPEC-ADDITIONS §13) — list declared tools, run doctor to validate them, or run one so the worker can invoke an external capability in-loop and interpret its output.
Package vcscmd implements the "vcs" CLI command: inspect and mutate the git working tree through the internal/vcs seam (go-git).
 Package vcscmd implements the "vcs" CLI command: inspect and mutate the git working tree through the internal/vcs seam (go-git).
Package version implements the "version" CLI command.
 Package version implements the "version" CLI command.
Package workercmd implements the "worker" CLI command: show the adoption epoch or requalify it after a worker change (SPEC §14).
 Package workercmd implements the "worker" CLI command: show the adoption epoch or requalify it after a worker change (SPEC §14).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.