@planu/cli 5.3.38 → 5.3.40

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [5.3.40] - 2026-08-23
+
+### Bug Fixes
+- fix(spec-1590): feed full multi-line BDD criteria to scope-contradiction check
+
+### Chores
+- chore(planu): sync state after SPEC-1590 done
+- chore(spec-1273): mark done and reconcile Files with regenerated artifacts
+
+
+## [5.3.39] - 2026-08-23
+
+### Bug Fixes
+- fix(spec-1589): credit criteria whose acceptance-to-verification map test passes
+- fix(spec-1273): expose request_changes and estimate on canonical MCP surface
+
+### Chores
+- chore(planu): sync autopilot state for SPEC-1273/1589 done
+- chore(spec-1556): discard as resolved by SPEC-1507
+
+
 ## [5.3.38] - 2026-08-23
 
 ### Bug Fixes

package/README.md

@@ -21,7 +21,7 @@ Planu is a Spec Driven Development stack for AI coding agents: an MCP server and
 - **Local change detection** — observes project changes without requiring a hosted configuration service.
 - **Unified Spec Format** — Requirements and technical details in a single, context-efficient `spec.md`.
 - **Atomic Integrity** — Indestructible writes and **Freeze-on-done** immutability (P0).
-- **30 official MCP tools** for the public SDD surface, with advanced workflows kept in skills, CLI commands, and internal pipelines.
+- **32 official MCP tools** for the public SDD surface, with advanced workflows kept in skills, CLI commands, and internal pipelines.
 - **Multi-agent compatible** — Optimized for Claude Code, Cursor, Windsurf, and Gemini CLI.
 
 ---

package/dist/config/official-sdd-tools.d.ts

@@ -1,4 +1,4 @@
 /** Single editable authority for the official local SDD tool surface. */
-export declare const OFFICIAL_SDD_TOOL_NAMES: readonly ['planu_status', 'session_checkpoint', 'facilitate', 'init_project', 'clarify_requirements', 'create_spec', 'list_specs', 'challenge_spec', 'check_readiness', 'update_status', 'update_status_batch', 'package_handoff', 'validate', 'get_job', 'watch_job', 'cancel_job', 'restart_job', 'reconcile_spec', 'create_rule', 'create_skill', 'skill_search', 'configure_code_graph', 'code_graph_status', 'submit_feedback', 'triage_feedback', 'resolve_feedback', 'sync_feedback', 'feedback_status', 'bump_spec_version', 'migrate_legacy_spec'];
+export declare const OFFICIAL_SDD_TOOL_NAMES: readonly ['planu_status', 'session_checkpoint', 'facilitate', 'init_project', 'clarify_requirements', 'create_spec', 'list_specs', 'challenge_spec', 'check_readiness', 'update_status', 'update_status_batch', 'request_changes', 'estimate', 'package_handoff', 'validate', 'get_job', 'watch_job', 'cancel_job', 'restart_job', 'reconcile_spec', 'create_rule', 'create_skill', 'skill_search', 'configure_code_graph', 'code_graph_status', 'submit_feedback', 'triage_feedback', 'resolve_feedback', 'sync_feedback', 'feedback_status', 'bump_spec_version', 'migrate_legacy_spec'];
 export declare function readCanonicalToolNames(): string[];
 //# sourceMappingURL=official-sdd-tools.d.ts.map

package/dist/config/official-sdd-tools.js

@@ -11,6 +11,8 @@ export const OFFICIAL_SDD_TOOL_NAMES = [
     'check_readiness',
     'update_status',
     'update_status_batch',
+    'request_changes',
+    'estimate',
     'package_handoff',
     'validate',
     'get_job',

package/dist/config/registries/hosts/codex.json

@@ -14,6 +14,8 @@
     "check_readiness",
     "update_status",
     "update_status_batch",
+    "request_changes",
+    "estimate",
     "package_handoff",
     "validate",
     "get_job",

package/dist/config/tool-groups.json

@@ -28,6 +28,7 @@
       "description": "Create, validate, estimate, and manage specs through their full lifecycle.",
       "tools": [
         "estimate",
+        "request_changes",
         "challenge_spec",
         "check_readiness",
         "clarify_requirements",

package/dist/engine/spec-format/acceptance-criteria.d.ts

@@ -1,4 +1,5 @@
 import type { NormalizedAcceptanceCriterion } from '../../types/spec-format.js';
+export declare function extractSectionCriteria(section: string): string[];
 export declare function extractNormalizedAcceptanceCriteria(raw: string, options?: {
     allowLegacyBodyFallback?: boolean;
 }): NormalizedAcceptanceCriterion[];

package/dist/engine/spec-format/acceptance-criteria.js

@@ -80,7 +80,7 @@ function extractOneCriterion(body) {
     const listItem = extractListItems(body).find((item) => !TECHNICAL_MARKER.test(item));
     return listItem ?? null;
 }
-function extractSectionCriteria(section) {
+export function extractSectionCriteria(section) {
     const explicitBodies = extractExplicitCriterionBodies(section);
     if (explicitBodies.length > 0) {
         return explicitBodies

package/dist/engine/validator/test-evidence-grounding.d.ts

@@ -6,6 +6,14 @@ import type { CodeState, CriterionEvidenceResult } from '../../types/index.js';
  * spec-compliance-runner.ts instead of re-implementing YAML parsing here.
  */
 export declare function extractDeclaredTestPaths(specContent: string): Map<string, string[]>;
+/**
+ * Parse the `### Acceptance-To-Verification Map` section and return, per
+ * explicit `ACn` ordinal, the `*.test.*` file paths named on that row.
+ * Rows without a leading `ACn:` ordinal (umbrella/shared rows) are ignored,
+ * so a row such as "All criteria are verified by ..." cannot inflate an
+ * unrelated criterion.
+ */
+export declare function extractAcceptanceMapTestPaths(specContent: string): Map<string, string[]>;
 /**
  * SPEC-1367 review finding 2: the probe cache is created per validate
  * invocation (see validateSpec) and threaded through explicitly — never

package/dist/engine/validator/test-evidence-grounding.js

@@ -15,6 +15,7 @@ import { parseFrontmatterScenarios } from './spec-compliance-runner.js';
 import { normalizeCriterionText } from '../criterion-identity.js';
 import { resolveContainedProjectFile } from '../safety/contained-project-file.js';
 import { technologyValue } from '../technology-registry.js';
+import { extractSection } from '../spec-format/markdown-sections.js';
 /**
  * Parse the spec.md frontmatter `scenarios` block and return, per criterion
  * (matched by normalized scenario title), the declared TEST file paths.
@@ -33,6 +34,39 @@ export function extractDeclaredTestPaths(specContent) {
     }
     return map;
 }
+const AC_ROW_PREFIX = /^ac(\d+)\s*:/i;
+const TEST_FILE_TOKEN = /[\w./-]+\.test\.\w+/g;
+/**
+ * Parse the `### Acceptance-To-Verification Map` section and return, per
+ * explicit `ACn` ordinal, the `*.test.*` file paths named on that row.
+ * Rows without a leading `ACn:` ordinal (umbrella/shared rows) are ignored,
+ * so a row such as "All criteria are verified by ..." cannot inflate an
+ * unrelated criterion.
+ */
+export function extractAcceptanceMapTestPaths(specContent) {
+    const map = new Map();
+    const section = extractSection(specContent, 'acceptance-to-verification map');
+    if (!section) {
+        return map;
+    }
+    for (const rawLine of section.split('\n')) {
+        const line = rawLine
+            .replace(/^\s*[-*+]\s+/, '')
+            .replace(/^\s*\d+[.)]\s+/, '')
+            .trim();
+        const rowMatch = AC_ROW_PREFIX.exec(line);
+        if (!rowMatch?.[1]) {
+            continue;
+        }
+        const tokens = [...line.matchAll(TEST_FILE_TOKEN)].map((match) => match[0]);
+        if (tokens.length === 0) {
+            continue;
+        }
+        const key = `AC${Number.parseInt(rowMatch[1], 10)}`;
+        map.set(key, [...(map.get(key) ?? []), ...tokens]);
+    }
+    return map;
+}
 const DEFAULT_PROBE_TIMEOUT_MS = 60_000;
 /**
  * SPEC-1367 review finding 2: the probe cache is created per validate

package/dist/engine/validator.js

@@ -4,7 +4,7 @@
 import { readFile } from 'node:fs/promises';
 import { extractCriteria, extractVerifyBlocks } from './validator/extractors.js';
 import { scanCodeForSpec, checkCriterionEvidence, classifyDriftSeverity, quickQualityCheck, } from './validator/analyzer.js';
-import { extractDeclaredTestPaths, createProbeCache } from './validator/test-evidence-grounding.js';
+import { extractDeclaredTestPaths, extractAcceptanceMapTestPaths, filterValidatedTestPaths, groundAgainstDeclaredTests, createProbeCache, } from './validator/test-evidence-grounding.js';
 import { resolveApplicableDimensions } from './validator/scope-resolver.js';
 import { buildHolisticReportFromFlatScore } from './validator/holistic-report.js';
 import { readEvidenceArtifacts, traceabilityRowHasCurrentCommandEvidence, traceabilityRowHasCurrentTestEvidence, } from './evidence-gates/artifact-reader.js';
@@ -98,10 +98,12 @@ export async function validateSpec(spec, projectPath) {
     // (forgiving — empty maps if the file is unreadable).
     let verifyBlockMap = new Map();
     let declaredTestsMap = new Map();
+    let acMapTestPaths = new Map();
     try {
         const specContent = await readFile(spec.specPath, 'utf-8');
         verifyBlockMap = extractVerifyBlocks(specContent);
         declaredTestsMap = extractDeclaredTestPaths(specContent);
+        acMapTestPaths = extractAcceptanceMapTestPaths(specContent);
     }
     catch {
         // spec file not available — proceed without verify blocks or declared tests
@@ -129,8 +131,22 @@ export async function validateSpec(spec, projectPath) {
         const evidence = await checkCriterionEvidence(criterion, projectPath, codeState, verifyBlock, undefined, declaredTestPaths, probeCache);
         if (evidence.status === 'proven') {
             matches.push(criterion);
+            continue;
+        }
+        if (hasExplicitCriterionId(criterion)) {
+            const mapPaths = acMapTestPaths.get(criterionIdentity.id);
+            if (mapPaths && mapPaths.length > 0) {
+                const safeMapPaths = await filterValidatedTestPaths(projectPath, mapPaths);
+                if (safeMapPaths.length > 0) {
+                    const mapGrounded = groundAgainstDeclaredTests(projectPath, safeMapPaths, probeCache);
+                    if (mapGrounded?.status === 'proven') {
+                        matches.push(criterion);
+                        continue;
+                    }
+                }
+            }
         }
-        else if (evidence.status === 'indeterminate') {
+        if (evidence.status === 'indeterminate') {
             indeterminate.push(criterion);
         }
         else {

package/dist/tools/challenge-spec.js

@@ -21,6 +21,7 @@ import { detectChallengeCapabilities, } from './challenge-spec/scenarios-utils.j
 import { collectCapabilityScenarios } from './challenge-spec/scenario-collector.js';
 import { buildChallengeReport, parseChallengeResolutionEvidence, } from './challenge-spec/challenge-report.js';
 import { extractListItems, findMarkdownSectionRange, } from '../engine/spec-format/markdown-sections.js';
+import { extractSectionCriteria } from '../engine/spec-format/acceptance-criteria.js';
 const ALL_FOCUS_AREAS = [
     'failures',
     'concurrency',
@@ -219,7 +220,7 @@ export async function handleChallengeSpec(args, server) {
         const criteriaRange = findMarkdownSectionRange(specContent, 'Acceptance Criteria');
         const criteriaTexts = criteriaRange === null
             ? []
-            : extractListItems(specContent.slice(criteriaRange.contentStart, criteriaRange.end));
+            : extractSectionCriteria(specContent.slice(criteriaRange.contentStart, criteriaRange.end));
         const contradictionResult = checkScopeContradictions(resolvedOutOfScope, criteriaTexts);
         for (const c of contradictionResult.contradictions) {
             failureScenarios.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.3.38",
+  "version": "5.3.40",
   "description": "Planu — MCP Server for Spec Driven Development. Cross-platform (Linux/macOS/Windows, x64/arm64).",
   "type": "module",
   "main": "dist/index.js",

package/planu-plugin.json

@@ -2,7 +2,7 @@
   "name": "dev.planu.cli",
   "displayName": "Planu — Spec Driven Development",
   "description": "Manage software specs, estimations, and autonomous SDD workflows. Language-agnostic MCP server for Claude Code.",
-  "version": "5.3.38",
+  "version": "5.3.40",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",
@@ -19,6 +19,8 @@
       "check_readiness",
       "update_status",
       "update_status_batch",
+      "request_changes",
+      "estimate",
       "package_handoff",
       "validate",
       "get_job",