                                                                                
 Usage: apiforge [OPTIONS] COMMAND [ARGS]...                                    
                                                                                
 Analyze API evolution deterministically and offline.                           
                                                                                
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --version                          Show the API Forge version and exit.      │
│ --output                    <str>  Payload projection: json (default) or     │
│                                    compact (minified, null/empty pruned).    │
│ --install-completion               Install completion for the current shell. │
│ --show-completion                  Show completion for the current shell, to │
│                                    copy it or customize the installation.    │
│ --help                             Show this message and exit.               │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ portal          Open the API Forge local web portal (127.0.0.1, session      │
│                 token).                                                      │
│ doctor          Inspect runtime state, or the local installation when no     │
│                 task is supplied.                                            │
│ status          Show TaskSpec status, or project/workspace status when no    │
│                 task is supplied.                                            │
│ inspect         Inspect installed assets and bounded project/workspace       │
│                 discovery.                                                   │
│ ai              Observe an AI host (detect -> version -> auth ->             │
│                 integration) and open it.                                    │
│ init            Create only a minimal local project or workspace manifest.   │
│ review          Render the canonical Outcome Brief for a runtime run.        │
│ evolve          Execute a bounded, evidence-backed API evolution run.        │
│ resume          Resume only persisted, eligible work from the latest control │
│                 run.                                                         │
│ discover        Statically inventory FastAPI routes without executing code.  │
│ analyze         Run the full deterministic slice and persist a case.         │
│ judge           Judge contract/code divergence, or catalog checks over       │
│                 report facts.                                                │
│ next-step       Recommend the specialist agent for the dominant finding      │
│                 area.                                                        │
│ playbook        Render the declared executor decomposition for a             │
│                 coordinator.                                                 │
│ rules           Read the rule catalog — the knowledge base every finding     │
│                 cites.                                                       │
│ build           Generate code skeletons — evaluated in the sandbox, promoted │
│                 via worktree only.                                           │
│ collect         Collect AWS artifacts into offline dumps (the only family    │
│                 that touches AWS).                                           │
│ model           Build the canonical API-IR.                                  │
│ diff            Diff OpenAPI contracts.                                      │
│ policy          Evaluate actions against the policy catalog.                 │
│ sdd             Spec-driven development artifacts and gates.                 │
│ sandbox         Copy-based sandbox evaluation.                               │
│ evidence        Release evidence receipts.                                   │
│ economy         Measured cost per call — bytes recorded, tokens unresolved   │
│                 without a transcript.                                        │
│ context         Measured context accounting — the funnel, in bytes per       │
│                 stage.                                                       │
│ agentops        Host-neutral Caveman/RTK protocols, workflows and adapters.  │
│ devin           Generate and inspect offline-first payloads for Devin        │
│                 Desktop, CLI and Cloud.                                      │
│ evals           Declarative local eval matrix, goldens and holdout metadata. │
│ capabilities    Inspect the evidence-backed public capability matrix.        │
│ contract-intel  Unify contract impact analysis and build an offline API      │
│                 Digital Twin.                                                │
│ report          Release evidence bundle — sign binds hashes; verify names    │
│                 what diverged.                                               │
│ plan            Planning verbs — compose over facts other verbs already      │
│                 extracted.                                                   │
│ debate          Record specialist disagreement — positions cite fact_ids, a  │
│                 referee closes.                                              │
│ dispatch        Run deterministic playbook steps; pending steps name their   │
│                 missing inputs.                                              │
│ perf            Compose over measured runs — compare, never interpolate.     │
│ agents          Publish coordinator profiles to host-native mirrors.         │
│ run             Execute allowlisted scanner binaries, then read their        │
│                 reports.                                                     │
│ autonomy        Autonomy modes (observe->continuous) and runbooks on the     │
│                 policy engine.                                               │
│ contract        List and inspect the canonical versioned contracts.          │
│ task            Sealed, budgeted units of agentic work (TaskSpec).           │
│ runtime         Bounded agentic execution over sealed TaskSpecs; local and   │
│                 CI safe.                                                     │
│ governor        Agent Governor decisions: ceilings, gain, stop, recovery and │
│                 loop checks.                                                 │
│ control         Decision Control Plane lifecycle: shadow, assisted, active   │
│                 and fallback.                                                │
│ route           Model routing: candidates, scorecards and lifecycle          │
│                 promotion.                                                   │
│ brief           Outcome Briefs — DONE is refused while mandatory gaps exist. │
│ graph           Native provenance graph — canonical JSONL store,             │
│                 closed-vocabulary queries.                                   │
│ index           TokenSave: content-hash cache + local indexes over extractor │
│                 output.                                                      │
│ knowledge       Domain packs — source authority, runtime matrices, declared  │
│                 evals.                                                       │
│ observability   Offline-first OTel, Datadog and Dynatrace control plane.     │
│ grpc            Offline-first gRPC contract control plane.                   │
│ migration       Offline-first runtime migration analysis and verification.   │
│ lab             Opt-in experimental scenario catalog (§28).                  │
│ change-control  Govern API, Git and CI/CD changes with read-only evidence.   │
│ integration     Read-only external evidence adapters and freshness receipts. │
│ platform        Run allowlisted local runtime probes for platform verticals. │
│ tui             Execution-first terminal UX with a Rich/JSON fallback.       │
│ distribution    Inspect the installed package, paths and hostless            │
│                 capabilities.                                                │
│ workspace       Register independent repositories in a local virtual         │
│                 workspace.                                                   │
│ field           Pre-registered field validation: evidence-joined run records │
│                 and gap report.                                              │
│ cache           Advisory layered cache — reuse only fresh evidence,          │
│                 invalidate by dependency.                                    │
│ slice           Failures and signatures instead of whole logs; the full log  │
│                 stays behind ctx://.                                         │
│ mcp             MCP surface projections and their measured cost.             │
│ verify          Targeted verification plans (never executes).                │
│ forge           Forge Protocol: capabilities, task                           │
│                 submit/inspect/result/evidence, handoff, health.             │
│ memory          Governed append-only agent memory.                           │
│ blackboard      Structured append-only shared state.                         │
│ governance      Fail-closed agentic decision gates.                          │
│ experience      Canonical execution, governance and evidence projections.    │
│ install         Install API Forge assets into a project, workspace or the    │
│                 user home; manage the lifecycle (status, doctor, repair,     │
│                 update, uninstall).                                          │
╰──────────────────────────────────────────────────────────────────────────────╯

