# Command Contracts
This document defines the normative operational contracts for the Decapod CLI.
## `decapod activate`
- **Intent:** Activate local control plane state and run startup migrations
## `decapod init`
- **Intent:** Bootstrap system and manage lifecycle
## `decapod setup`
- **Intent:** Configure repository (hooks, settings)
## `decapod session`
- **Intent:** Session token management (required for agent operation)
## `decapod docs`
- **Intent:** Access methodology documentation
## `decapod todo`
- **Intent:** Track tasks and work items
- **Preconditions:** Agent must have an active session.
- **State Transition:** Managed via `todo.db`.
## `decapod obligation`
- **Intent:** Governance-native obligation graph
## `decapod validate`
- **Intent:** Validate methodology compliance
- **Intent:** Verify methodology compliance.
- **Outcome:** Exit code 0 on success, 1 on failure.
## `decapod version`
- **Intent:** Show version information
## `decapod govern`
- **Intent:** Governance: policy, health, proofs, audits
## `decapod data`
- **Intent:** Data: archives, knowledge, context, schemas
## `decapod auto`
- **Intent:** Automation: scheduled and event-driven
## `decapod qa`
- **Intent:** Quality assurance: verification and checks
## `decapod decide`
- **Intent:** Architecture decision prompting
## `decapod workspace`
- **Intent:** Agent workspace management
- **Preconditions:** Task must be claimed.
- **State Transition:** Creates git worktrees/containers.
## `decapod rpc`
- **Intent:** Structured JSON-RPC interface for agents
## `decapod handshake`
- **Intent:** Deterministic agent handshake artifact (repo-native)
## `decapod release`
- **Intent:** Release lifecycle checks and guards
## `decapod capabilities`
- **Intent:** Show Decapod capabilities (for agent discovery)
## `decapod internalize`
- **Intent:** Internalized context artifacts: create, attach, and inspect context adapters
## `decapod preflight`
- **Intent:** Preflight check: before any operation, predict what will fail
## `decapod impact`
- **Intent:** Impact analysis: predict validation outcomes for changed files
## `decapod infer`
- **Intent:** Inference governance: shape context before model, validate after
## `decapod trace`
- **Intent:** Local trace management
## `decapod eval`
- **Intent:** Variance-aware evaluation artifacts and promotion gates
## `decapod flight-recorder`
- **Intent:** Governance Flight Recorder - render timeline from event logs
## `decapod state-commit`
- **Intent:** STATE_COMMIT: prove and verify cryptographic state commitments
## `decapod doctor`
- **Intent:** Preflight health checks for the workspace
## `decapod lcm`
- **Intent:** Lossless Context Management — immutable originals + deterministic summaries
## `decapod map`
- **Intent:** Deterministic map operators — structured parallel processing
## `decapod demo`
- **Intent:** Run demonstrations of Decapod features
# RPC Operations (Auto-generated)
### Operation: `AgentInit`
### Operation: `WorkspaceStatus`
### Operation: `WorkspaceEnsure`
### Operation: `WorkspacePublish`
### Operation: `ContextResolve`
### Operation: `ContextCapsuleQuery`
### Operation: `ContextBindings`
### Operation: `ConstitutionGet`
### Operation: `ConstitutionLinksQuery`
### Operation: `ConstitutionLinksNavigate`
### Operation: `ConstitutionMigrate`
### Operation: `AgentRegistryQuery`
### Operation: `SchemaGet`
### Operation: `StoreUpsert`
### Operation: `StoreQuery`
### Operation: `ValidateRun`
### Operation: `ScaffoldNextQuestion`
### Operation: `ScaffoldApplyAnswer`
### Operation: `ScaffoldGenerateArtifacts`
### Operation: `StandardsResolve`
### Operation: `MentorObligations`
### Operation: `AssuranceEvaluate`