diff --git a/plugins/ultraplan-local/.claude-plugin/plugin.json b/plugins/ultraplan-local/.claude-plugin/plugin.json index 4f8e2fd..4e1a4ad 100644 --- a/plugins/ultraplan-local/.claude-plugin/plugin.json +++ b/plugins/ultraplan-local/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ultraplan-local", - "description": "Four-command context-engineering pipeline (brief → research → plan → execute) with project folders, specialized agent swarms, external research triangulation, adversarial review, session decomposition, and headless execution. CC-feature matching extracted to the separate ultra-cc-architect plugin in v3.0.0.", - "version": "3.1.0", + "description": "Five-command context-engineering pipeline (brief → research → plan → execute → review) with project folders, specialized agent swarms, external research triangulation, adversarial review, post-hoc independent review with Handover 6 feedback loop, session decomposition, and headless execution. CC-feature matching extracted to the separate ultra-cc-architect plugin in v3.0.0.", + "version": "3.2.0", "author": { "name": "Kjell Tore Guttormsen" }, diff --git a/plugins/ultraplan-local/CHANGELOG.md b/plugins/ultraplan-local/CHANGELOG.md index 2cd26ff..705424b 100644 --- a/plugins/ultraplan-local/CHANGELOG.md +++ b/plugins/ultraplan-local/CHANGELOG.md @@ -4,6 +4,43 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). +## [3.2.0] - 2026-05-01 + +Adds `/ultrareview-local` as the fifth and final command in the ultra-suite — +independent post-hoc review of delivered code against the brief — and the +contracted **Handover 6 (review → plan)** feedback loop. Non-breaking: existing +brief/research/plan/execute pipelines are untouched. + +### Added + +- `/ultrareview-local` command — fifth and final command in ultra-suite (independent post-hoc review of delivered code against brief) +- `lib/validators/review-validator.mjs` — schema validator for new `type: ultrareview` artifact +- `lib/review/rule-catalogue.mjs` — 12 canonical rule keys (version-pinned) +- `lib/parsers/finding-id.mjs` — stable SHA1 finding-ID computation +- `lib/parsers/jaccard.mjs` — Jaccard similarity for determinism testing +- 4 new agents: review-orchestrator (opus inline ref), brief-conformance-reviewer, code-correctness-reviewer, review-coordinator (Judge Agent pattern) +- Handover 6 (review → plan) — contracted feedback loop documented in HANDOVER-CONTRACTS.md +- ~43 new tests (109 → ~152 baseline; rule-catalogue + finding-id + jaccard + review-validator + brief-validator extension + arg-parser extension + project-discovery extension + 4 doc-consistency pins + 3 review-determinism integration + 3 source-findings SC3(b) integration) + +### Changed + +- `brief-validator.mjs` accepts `type: ultrareview` in addition to `ultrabrief` (Handover 6 enabler) +- `/ultraplan-local` consumes `type: ultrareview` brief — extracts findings as plan goals + populates `source_findings` array in plan frontmatter +- `lib/parsers/project-discovery.mjs` discovers `review.md` and supports `'review'` phase +- `lib/parsers/arg-parser.mjs` adds `ultrareview` command to FLAG_SCHEMA +- `hooks/scripts/session-title.mjs` adds `/ultrareview-local` to COMMANDS map +- Severity vocabulary aligned with llm-security: `Critical | High | Medium | Low | Info` (rule-catalogue retains the 4-tier brief vocabulary; 5-tier migration is a v1.1 candidate) + +### Tests + +- 109 baseline → ~152 green (+43 new) + +### Open Questions for v1.1 + +- Migrate 4-tier severity (BLOCKER/MAJOR/MINOR/SUGGESTION) → llm-security 5-tier (Critical/High/Medium/Low/Info) — research/02 advised but deferred to keep brief contract intact. +- Real-LLM determinism measurement (current SC4 test uses synthetic fixtures). +- SC2 end-to-end false-positive integration test (currently agent-prompt-level only). + ## [3.1.0] - 2026-05-01 Quality program: pure quality lift, no scope creep. Built around the diff --git a/plugins/ultraplan-local/README.md b/plugins/ultraplan-local/README.md index 01d1085..ad338c1 100644 --- a/plugins/ultraplan-local/README.md +++ b/plugins/ultraplan-local/README.md @@ -1,6 +1,6 @@ # ultraplan-local — Brief, Research, Plan, Execute, Review -![Version](https://img.shields.io/badge/version-3.1.0-blue) +![Version](https://img.shields.io/badge/version-3.2.0-blue) ![License](https://img.shields.io/badge/license-MIT-green) ![Platform](https://img.shields.io/badge/platform-Claude%20Code-purple) diff --git a/plugins/ultraplan-local/package.json b/plugins/ultraplan-local/package.json index 42bdaa3..e20fc2e 100644 --- a/plugins/ultraplan-local/package.json +++ b/plugins/ultraplan-local/package.json @@ -1,7 +1,7 @@ { "name": "ultraplan-local", - "version": "3.1.0", - "description": "Four-command context-engineering pipeline (brief → research → plan → execute) for Claude Code.", + "version": "3.2.0", + "description": "Five-command context-engineering pipeline (brief → research → plan → execute → review) for Claude Code.", "type": "module", "engines": { "node": ">=18"