bstack — substrate completion v0.4.0 → v1.0.0 (epic)

[broomva]

Epic — bstack substrate completion arc

This epic tracks the 9-phase closure plan to take the bstack substrate from v0.3.1 to v1.0.0 stability. The canonical spec is specs/2026-05-18-substrate-completion.md (merged in broomva/bstack#31, commit 63d4896).

Phases

#	Version	Theme	Status
0	docs only	Architectural Contracts (this spec)	✅ Done (PR #31)
1	v0.4.0	Setpoint Measurement Pipeline	Pending
2	v0.5.0	Status Surface	Pending
3	v0.6.0	Schema Versioning + Migration	Pending
4	v0.7.0	Companion Skill Auto-install	Pending
5	v0.8.0	Doctor Extensions + Soft Gates	Pending
6	v0.9.0	Vendored Upgrade + Canary	Pending
7	v0.9.5	Crystallization Detection	Pending
8	v0.10.0	Federation (optional)	Pending
9	v1.0.0	Stability Pact	Pending

Architectural contracts being closed

Plant, Controller, Setpoint, Gate, Primitive, Hook, Companion Skill, Release.

Each phase closes specific gaps from §4 of the canonical spec. Every phase is one PR, with concrete deliverables + tests + SLO targets + risks per §6 of the spec.

Cadence

≈ 1 release per 1-2 weeks. L3 stability budget (λ₃ ≈ 0.006) demands deliberate pacing.

Already shipped (backfilled tickets below)

• v0.2.0 + v0.2.1 — retroactively tagged 2026-05-18
• v0.2.2 — release infrastructure + CLI dispatcher (PR #27)
• v0.2.3 — bstack repair merges hooks (PR #28)
• v0.3.0 — SessionStart auto-upgrade hook (PR #29) — broomva/life#1329
• v0.3.1 — auto-tag + GitHub Release on merge (PR #30)
• Phase 0 spec (PR #31)

References

• Canonical spec: https://github.com/broomva/bstack/blob/main/specs/2026-05-18-substrate-completion.md
• Agent-readable overview: https://github.com/broomva/bstack/blob/main/references/substrate-completion-overview.md
• Releases: https://github.com/broomva/bstack/releases

[linear]

BRO-1148