ID:SPEC-119Status:accepted
Lifecycle-drift validation for the spec–work–milestone graph
Name:v0.30.0Status:complete
v0.30.0 — Plan lifecycle validation & render-stack removal
Two threads of plan-tooling hardening that finish work the previous milestones deliberately left open. First, teach plan validate to catch lifecycle drift — statuses that contradict the terminal evidence around them (SPEC-119), the symmetric counterpart to the one-directional lifecycle checks already in place. Second, remove the bespoke plan build / plan serve render stack (SPEC-120) that v0.16.0 deprecated but kept alive — with the SPEC-071 plan-site transition shipped, a plan site is now an ordinary refrakt site, so the parallel SSG can go.
Progress 4/4 work items
Relationships
Related 9
ID:SPEC-120Status:accepted
Retire the bespoke plan render stack
ID:SPEC-071Status:draft
Plan site scaffolding
ID:SPEC-049Status:accepted
Spec lifecycle and PR linkage
ID:WORK-273Status:pending
Deprecate plan build and serve commands
Priority:lowComplexity:simpleMilestone:v0.16.0
ID:WORK-513Status:ready
Lifecycle-drift validation — spec-status checks and shared suggestImplemented predicate
Priority:highComplexity:moderateMilestone:v0.30.0
ID:WORK-514Status:ready
Lifecycle-drift validation — work-dependency and milestone-completion checks
Priority:mediumComplexity:moderateMilestone:v0.30.0
ID:WORK-515Status:ready
One-time lifecycle-drift cleanup pass over plan/
Priority:mediumComplexity:simpleMilestone:v0.30.0
ID:WORK-516Status:ready
Remove bespoke plan build/serve render stack
Priority:mediumComplexity:moderateMilestone:v0.30.0
Work Items
Done 4
WORK-513 claude/v0-30-milestone-review-hg592h
Lifecycle-drift validation — spec-status checks and shared suggestImplemented predicate Add the spec-side lifecycle-drift checks from SPEC-119 to plan validate, so a spec whose status contradicts the terminal evidence around its linked work is flagged rather than only nudged by plan status. This is the foundation work item for the drift-validation feature: it also establishes the shared predicate that both plan status (the suggestImplemented hint) and plan validate (the new spec-status-lag warning) resolve through, so the two surfaces can never diverge.
10/10 criteria
WORK-514 claude/v0-30-milestone-review-hg592h
Lifecycle-drift validation — work-dependency and milestone-completion checks Add the remaining v1 drift checks from SPEC-119 that key on dependency and milestone-membership evidence rather than the spec↔work edge: a work item still blocked after all its blockers finished, and a milestone marked complete while it still has open members. Complements the spec-side checks in WORK-513, reusing the same helpers and reporting plumbing.
7/7 criteria
WORK-515 claude/v0-30-milestone-review-hg592h
One-time lifecycle-drift cleanup pass over plan/ Run the new drift checks against refrakt's own plan/ and clear the accumulated drift, so the checks land on a clean repo and can gate CI without a wall of pre-existing warnings. SPEC-119's motivating audit already found 38 draft specs whose linked work was 100% done plus 32 accepted specs never advanced to implemented/shipped, along with stale blocked items and milestones left active/complete out of step with their members. This is the "land alongside a one-time migration pass so the repo starts clean" step from the spec's recommendation.
6/6 criteria
WORK-516 claude/v0-30-milestone-review-hg592h
Remove bespoke plan build/serve render stack Realize SPEC-120: remove the plan build / plan serve commands and the private static-site generator behind them, now that a plan site is an ordinary refrakt site (entityRoutes + collection, scaffolded by create-refrakt --type plan). This is the deferred removal phase — WORK-273 shipped the deprecation in v0.16.0, and SPEC-071 § Deprecation of plan build / plan serve (step 3) anticipated but scoped it out. The authoring CLI, plan runes, and register/aggregate hooks are untouched.
9/9 criteria