statecraft template upgrade: chassis upgrades as a governed verb

006-template-upgrade-verb

The upgrade half of the 2026-07-14 packaging decision: templates stay small because the chassis ships as versioned npm packages (enrahitu spec 018), and upgrading a stamped app is a verb, not a migration project. `statecraft template upgrade`, run in a stamped app checkout, reads template.toml, bumps the chassis package pins, applies template-shipped codemods, runs the contract verify verb, and commits on a branch. The CLI orchestrates; all structure knowledge stays in the template and its packages. This verb is the boundary that keeps the CLI from ever becoming a build daemon.

Depends on

• 002-crate-scaffold

Establishes

• ? (symbol)

Sections

• 006: template upgrade verb
• 1. Cross-repo dependencies (read first)
• 2. Behavior
• 3. Acceptance
• 4. Out of scope
• 5. Status (2026-07-15)

Source

specs/006-template-upgrade-verb/spec.md @ ac2fa199be29as of 2026-07-17 · shard 5c1f7935e130