Governance verbs v1: tenants, stamps, fleet

004-governance-verbs

The CLI face becomes useful: the stub commands from spec 002 gain real implementations over the API client, mirroring the control plane's tenants (statecraft spec 004), factory (spec 005), and fleet (spec 006) services. Every verb has a stable JSON output shape, because spec 005 exposes these same verbs as MCP tools and the JSON is the shared contract between both faces.

Depends on

• 003-auth-api-client

Establishes

• ? (symbol)

Sections

• 004: Governance verbs
• 1. Cross-repo dependency
• 2. Verb surface (all support --output json)
• 3. Acceptance
• 4. Out of scope
• 5. Endpoint map and JSON envelope (2026-07-15 amendment)
• 5.1 Endpoint map (all paths under the plane's `/api/v1`)
• 5.2 JSON envelope (`--output json`)
• 5.3 Response-shape expectations (human rendering only)
• 5.4 Watch semantics (`stamp status --watch`)
• 6. Status (2026-07-15)

Source

specs/004-governance-verbs/spec.md @ ac2fa199be29as of 2026-07-17 · shard c8282f2410f0