Skip to content

CRAFT v1.4.0 — Blocked-Slice Lifecycle, Checkable Phase Graph & Docs Site

Latest

Choose a tag to compare

@ChriRas ChriRas released this 12 Jul 22:21

Epic-002 (Blocked-Slice Lifecycle), the checkable phase-transition graph, read-only context sources, and the public documentation site.

Added

  • Blocked-slice lifecycle (epic-002, slices 023–026) — /craft:block records a first-class blocked state with a blocker taxonomy, a Blocked-status resume token and a structured ## Blocker section; /craft:unblock clears it via the resume / re-plan / abort fork; /craft:commit auto-resurfaces prerequisite-work dependents when their prerequisite lands; /craft:prime and /craft:status surface blocked slices with blocker + orphan detection; the slice-builder agent classifies out-of-scope blockers autonomously and pauses with a .craft/handoff.md instead of growing the slice.
  • Protected-main sequential-epic landing (slice-021) — sequential epics land each slice through the PR + GitHub-approval workflow ("approve ≠ merge").
  • Grouped /craft:status overview (slice-022) — phase names, progress bars, handoff markers, stale partition.
  • Profile-configurable Co-Authored-By trailer (slice-027).
  • Ensure-primed gate (slice-028) — context-dependent commands auto-run /craft:prime when the session marker is missing.
  • Read-only context sources (F1, slice-029) — declared "connected projects" and the in-repo research/ folder are readable but write-blocked via a PreToolUse guard; ships a self-contained test harness.
  • Phase-transition graph + marker contract (slice-031) — the status graph is declared once in skills/workflow/SKILL.md; status writes/reads/delegations carry machine-readable craft:writes / craft:reads / craft:delegates markers; scripts/test-workflow-status-graph.sh asserts graph closure under both Phase-7 configurations, marker↔table agreement in both directions, and /craft:continue routing.
  • Documentation sitedocs/ ships a self-contained bilingual (EN/DE) GitHub-Pages page in terminal aesthetic with automatic light/dark and SVG diagrams of the 9-phase loop, the status graph with every branch-off, and the three execution modes — plus a regeneration skill and the scripts/test-docs-site.sh staleness harness.

Fixed

  • Phase 8 unreachable when Phase 7 is dropped (B1, slice-031) — /craft:recap now writes Status: reviewing directly under the phase7-dropped configuration; previously such slices stalled at Status: review and Commit was never gated.
  • Read-only guard path normalization (slice-030) — traversal bypass (commands/../research/x) and false-deny (research/../commands/x) closed; guard↔helper normalizer agreement asserted against the real function.

Changed

  • rules.md / intent.md promote the slice-031 lessons: "prose is not checkable — markers are" and "a rule is never described twice."

Full changelog: https://github.com/ChriRas/craft/blob/main/CHANGELOG.md