From eb31103655f68d5752a4db3037b18bc47bf102c6 Mon Sep 17 00:00:00 2001 From: Rainier Potgieter Date: Tue, 26 May 2026 23:12:56 +0200 Subject: [PATCH] docs: replace stale ROADMAP with current STATUS, ignore contributor PDFs ROADMAP.md was dated 2026-04-10 and superseded by STATUS.md, which carries the current state, recent moves, and what is next. Remove the stale roadmap, add STATUS.md, and point the CLAUDE.md File Conventions entry at STATUS.md. Carry forward the CHANGELOG entry for the #64 verification.on_fail fix, and add docs/contributors/*.pdf to .gitignore so contributor PDFs (separate published work) stay out of the repo. Co-Authored-By: Claude Opus 4.7 (1M context) --- .gitignore | 1 + CHANGELOG.md | 3 +++ CLAUDE.md | 2 +- ROADMAP.md | 23 ----------------------- STATUS.md | 21 +++++++++++++++++++++ 5 files changed, 26 insertions(+), 24 deletions(-) delete mode 100644 ROADMAP.md create mode 100644 STATUS.md diff --git a/.gitignore b/.gitignore index f65c03f..5867270 100644 --- a/.gitignore +++ b/.gitignore @@ -16,6 +16,7 @@ docs/html/ docs/outreach/ docs/oss/ docs/*.pdf +docs/contributors/*.pdf docs/*.docx PROGRESS.md LOGIC-MD-STRATEGIC-PLAN.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 512c4cb..45542ae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,9 @@ ## [Unreleased] +### Fixed +- Core: preserve `verification.on_fail` through compilation (#64, PR #71). The recovery action (`retry`/`escalate`/`skip`/`abort`/`revise`) was silently dropped at the compile boundary. Now carried as a first-class `CompiledVerification` on a singular `CompiledStep.verification`; the gate-validator return shape got its own name `QualityGateResult`. Parametrised across all five `OnFailAction` values plus the null case. + ## [1.5.0] - 2026-05-15 ### Added diff --git a/CLAUDE.md b/CLAUDE.md index 474ddcb..2cddcbf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -37,6 +37,6 @@ npm run build # core -> cli -> mcp (sequential) ## File Conventions - `.planning/ROADMAP.md` is the GSD workflow tracker with phase history. Do not edit manually. -- Root `ROADMAP.md` is the user-facing forward roadmap. +- Root `STATUS.md` is the user-facing status snapshot (current state, recent moves, and what is next). - Root `CHANGELOG.md` is a rolling last-20-entries log. - `docs/SPEC.md` is the LOGIC.md format specification. diff --git a/ROADMAP.md b/ROADMAP.md deleted file mode 100644 index 667e19a..0000000 --- a/ROADMAP.md +++ /dev/null @@ -1,23 +0,0 @@ -# Roadmap - -> Last updated: 2026-04-10 - -## Now (Active) - -- [ ] Review and merge `feat/m4-m5-m6-merge` branch -- [ ] Tag and publish v1.4.0 to npm - -## Next - -- [ ] CLI test suite — add vitest tests for all 9 commands (infra ready, no tests yet) -- [ ] MCP server HTTP transport testing and documentation -- [ ] Runtime execution engine — execute compiled workflows with real LLM calls -- [ ] Plugin ecosystem — document how to build custom MCP tools and Claude Code commands - -## Later - -- [ ] Watch mode improvements — incremental validation, error overlay -- [ ] LOGIC.md Language Server Protocol (LSP) for IDE support -- [ ] Visual editor / playground for LOGIC.md authoring -- [ ] Package registry — discover and share LOGIC.md templates -- [ ] Multi-agent orchestration — compile LOGIC.md specs into multi-agent workflows diff --git a/STATUS.md b/STATUS.md new file mode 100644 index 0000000..3c3e2d0 --- /dev/null +++ b/STATUS.md @@ -0,0 +1,21 @@ +# Status + +> Updated: 2026-05-26 + +## Where we are +Post-v1.5.0, working a compile-boundary fidelity audit (Ant Newman's review series): the compiler accepts authored spec fields and silently drops them from compiled output, so a runtime cannot execute from the compiled artifact alone. #64 (verification.on_fail) is fixed and merged to main (PR #71). #65 (parallel execution: execution, parallel_steps, join, join_timeout) is fixed and in review (PR #74, not merged). Sibling findings #66, #72, #73 remain open in the same class. 472 core tests passing. + +## Recent +- 2026-05-26: #65 PR #74 opened. First-class `ExecutionPlan` on a singular `CompiledStep.executionPlan`; `join_timeout` carried as a duration string (matching RetryPolicy), not parsed to ms. Design doc at `docs/superpowers/specs/2026-05-26-execution-plan-design.md`. +- 2026-05-26: #64 merged (PR #71). `CompiledVerification` plus `QualityGateResult` plus a singular `CompiledStep.verification`. +- 2026-05-16: v1.5.0 shipped across all six channels (npm core/cli/mcp, VS Code 0.1.4, PyPI 0.1.1, GitHub release). +- 2026-04-09: v1.4.0 milestone, M4+M5+M6 merge from Modular9 (9-command CLI, 16 templates, MCP 7 tools, Claude Code plugin). + +## Next +- Merge #65 (PR #74) after review. +- Triage remaining audit siblings #66, #72, #73; apply the same pattern (first-class typed field on CompiledStep, mirror the source, null absent case, parametrised canary test). +- Wire the executor to consume `CompiledStep.verification` and `CompiledStep.executionPlan` instead of reaching into the un-compiled spec (closes the "compiled output is the execution plan" loop). +- Update the LangGraph adapter to honour `executionPlan` fan-out and fan-in. +- Runtime execution engine: execute compiled workflows with real LLM calls (dry-run executor landed in Phase 2; live execution still to build). +- MCP server HTTP transport: testing and documentation. +- Watch mode, LSP, visual editor/playground, template registry, multi-agent orchestration (longer horizon).