V0.28.0
Name:v0.28.0Status:planning

v0.28.0 — Plan model hardening

Tighten the plan runes' data model along three axes: status vocabulary, spec/PR traceability, and the dependency graph — then sweep the existing content to match.

Not enough history yet — burndown needs at least one completed day of activity.

Progress 0/12 work items
  • Give work items honest terminal states (cancelled, superseded) and make the status vocabulary a true single source of truth (SPEC-117)
  • Close the spec lifecycle loop — implemented / shipped statuses, ADR rejected, first-class pr references, and traceability rollups (SPEC-049)
  • Make dependency cycle-detection meaningful via a directed model, clearing the 88 false-positive circular-dependency errors (SPEC-114)
  • Sweep the plan corpus: retire the pending unbuilt-rune backlog and correct stranded statuses, using the new vocabulary

Work Items

Draft 8
WORK-493 main
Add cancelled and superseded terminal work statuses
Give work items an honest way to be retired: cancelled (deliberately not doing it) and superseded (replaced by another item), plus a supersedes attribute. Both are terminal and non-achieving. Builds on the consolidated vocabulary from WORK-492.
high moderate
0/8 criteria
WORK-494 main
Document terminal work statuses and consolidated vocabulary
Update the canonical spec and agent-facing docs so the new work terminals and the pending status are described everywhere authors and agents look.
medium simple
0/5 criteria
WORK-495 main
Add spec implemented/shipped and ADR rejected statuses
Close the "is it built / is it available?" gap on specs, and give ADRs an honest "considered and declined" state. Rides on the consolidated vocabulary from WORK-492.
high moderate
0/7 criteria
WORK-497 main
plan status PR rollups and implemented-flip suggestion
Surface the traceability data structurally so missing PRs and ready-to-flip specs are visible without grepping prose.
medium moderate
0/5 criteria
WORK-498 main
refrakt plan migrate pr-attrs — git backfill of PR references
Backfill the pr attribute on legacy done work / fixed bug items from git merge-commit history, so plan status rollups are rich from day one rather than skeletal (only ~2 of 177 items carry a PR today).
medium complex
0/6 criteria
WORK-499 main
CLAUDE.md pr checklist bullet and spec-lifecycle docs
Make the PR-linkage instruction loud (a line inside an example block has a ~1% hit rate) and document the full lifecycle for humans.
medium simple
0/4 criteria
WORK-500 main
Retirement-candidate pass over pending unbuilt runes
Once cancelled / superseded exist, review the plan corpus for items that should be retired rather than left dangling. The main pool is the 13 pending work items, all sourced from SPEC-008 (unbuilt runes): stat, math, concept, exercise, glossary, objective, prerequisite, quiz, partner, job, album, artist, video. A reviewed, per-item judgment pass — not an automated flip.
low simple
0/5 criteria
WORK-501 main
General status-correctness audit of the plan corpus
Sweep the small set of non-terminal, non-ready work items for entries carrying the wrong status, independent of the new terminals. Human-judgment pass over a bounded list.
low simple
0/5 criteria
Ready 4
WORK-443 main
Directional dependency model + cycle-check fix + migration
Implement SPEC-114: give plan work/bug dependencies a direction so the validator's cycle detection stops firing on prose cross-references. Today checkCircularDeps builds its graph from every {% ref %} in an entity (e.refs) with no direction, producing 88 false-positive circular-dependency errors across ~35 mostly-done items.
medium moderate
0/8 criteria
WORK-491 main
Fix plan status/severity vocabulary drift in MCP and renderer config
The MCP server and renderer config hard-coded their own copies of the status/severity vocabulary and have drifted from the canonical enums.ts — a regression of the drift SPEC-037 / WORK-127 fixed once. This is the quick, standalone fix that ships value before the larger consolidation work.
high simple
0/5 criteria
WORK-492 main
Consolidate plan status vocabulary into a single source of truth
Make enums.ts the one place that defines status/severity/complexity/priority vocabularies, with derived lifecycle helpers, so consumers stop re-declaring the lists and drift becomes a build failure instead of a latent bug. This lands before the downstream status additions so they inherit the consolidated shape.
high complex
0/7 criteria
WORK-496 main
Add pr attribute to work and bug runes
Promote PR references from unstructured resolution prose to a first-class, validated, queryable attribute so traceability rollups become possible.
medium moderate
0/6 criteria