Rolls up the charter preflight, built-in vocabulary, and CI stabilization
guardrails merged after rc25.
Breaking changes
-
shipped→built-invocabulary rename. Public CLI JSON surfaces that
previously emitted"shipped"as a doctrine layer label now emit"built-in".
This aligns user-facing terminology with the on-diskbuilt-in/directory
layout that already existed. Affected commands:spec-kitty charter status --jsonspec-kitty charter lint --jsonspec-kitty charter preflight --json(new in this release)spec-kitty agent profile list --jsonspec-kitty doctrine pack validate --json
External tooling that pattern-matched the string
"shipped"MUST be updated.
No deprecation period: the rename is mechanical and the architectural test
tests/architectural/test_no_shipped_layer_label.pyprevents regression.Related: ADR
architecture/3.x/adr/2026-05-24-3-shipped-to-built-in-cutover.md.
Changed
- Deprecated paths:
specify_cli.charter_lint,specify_cli.charter_freshness,
andspecify_cli.charter_preflightnow re-export from
specify_cli.charter_runtime.{lint,freshness,preflight}under a shared
charter-runtime umbrella (LD-5 / FR-014). The old paths emit no
DeprecationWarningyet; they will in the next minor release. External
importers should update to the new paths during this deprecation window
(spec C-008). Thecharter_runtime.facadeslot is reserved for a future
charter-facade consolidation.
Added
-
spec-kitty charter preflightcommand. Caller-facing preflight contract
for governance freshness (FR-006, FR-007, FR-008). Returns a structured JSON
report thatnext,implement, and the dashboard consume to decide whether
to proceed, prompt forcharter synthesize, or block. See
docs/reference/charter-commands.mdand ADR
architecture/3.x/adr/2026-05-24-1-charter-freshness-ux-contract.md. -
Pre-launch and launch-readiness operator docs for hosted SaaS
sync (#1095). Public docs remain local-first; hosted readiness
stays opt-in viaSPEC_KITTY_ENABLE_SAAS_SYNC=1. The new
docs/how-to/internal-hosted-readiness.mdcovers the dogfooding
workflow for internal / pre-launch operators, and the new
docs/explanation/launch-readiness-future.mdstages the launch-day
behavior shift behind an explicit "Status: pre-launch" banner.