@planu/cli 5.3.34 → 5.3.36

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [5.3.36] - 2026-08-23
+
+### Bug Fixes
+- fix(spec-1566): admit bare build phase in release resume phasePattern
+
+
+## [5.3.35] - 2026-08-23
+
+### Bug Fixes
+- fix(spec-1488): scope marker-declared path extraction to the path-list run after each marker
+
+
 ## [5.3.34] - 2026-08-22
 
 ### Bug Fixes

package/dist/engine/spec-format/technical-md-populator.d.ts

@@ -1,4 +1,9 @@
 import type { LeanFileEntry } from '../../types/index.js';
+/**
+ * Extract the path list declared immediately after each FILES:/FILE:/TEST:/TESTS: marker.
+ * Returns null when no such marker is present (caller falls back to whole-text grounding).
+ */
+export declare function extractMarkerDeclaredPaths(description: string): Set<string> | null;
 /**
  * Attempt to extract file paths from spec body for auto-populating ## Technical.
  * Returns null when no structured file section is found (caller uses placeholder).

package/dist/engine/spec-format/technical-md-populator.js

@@ -107,6 +107,54 @@ async function isAdmissibleProseCandidate(candidate, projectPath) {
     }
     return hasLetterInitialExtension(candidate) && (await isExistingDirectory(dirname(full)));
 }
+const MARKER_KEYWORD_RE = /\b(FILES|FILE|TESTS|TEST)\s*:/gi;
+const PATH_SEPARATOR_RE = /^(?:[ \t,]+|\band\b)+/i;
+const PATH_TOKEN_RE = /^`?([^\s,`]+)`?/;
+const TRAILING_PUNCTUATION_RE = /[.,;:]+$/;
+function isPathShaped(token) {
+    return token.includes('/') && /\.[a-zA-Z0-9]+$/.test(token);
+}
+function consumePathRun(remainder) {
+    const paths = new Set();
+    let cursor = remainder;
+    for (;;) {
+        cursor = cursor.replace(PATH_SEPARATOR_RE, '');
+        const tokenMatch = PATH_TOKEN_RE.exec(cursor);
+        if (tokenMatch?.[1] === undefined) {
+            break;
+        }
+        const raw = tokenMatch[1];
+        const endsWithTerminator = /[.;:]+$/.test(raw);
+        const trimmed = raw.replace(TRAILING_PUNCTUATION_RE, '');
+        if (!isPathShaped(trimmed)) {
+            break;
+        }
+        paths.add(trimmed.toLowerCase());
+        if (endsWithTerminator) {
+            break;
+        }
+        cursor = cursor.slice(tokenMatch[0].length);
+    }
+    return paths;
+}
+/**
+ * Extract the path list declared immediately after each FILES:/FILE:/TEST:/TESTS: marker.
+ * Returns null when no such marker is present (caller falls back to whole-text grounding).
+ */
+export function extractMarkerDeclaredPaths(description) {
+    const markers = [...description.matchAll(MARKER_KEYWORD_RE)];
+    if (markers.length === 0) {
+        return null;
+    }
+    const paths = new Set();
+    for (const marker of markers) {
+        const start = marker.index + marker[0].length;
+        for (const path of consumePathRun(description.slice(start))) {
+            paths.add(path);
+        }
+    }
+    return paths;
+}
 /**
  * Attempt to extract file paths from spec body for auto-populating ## Technical.
  * Returns null when no structured file section is found (caller uses placeholder).

package/dist/engine/spec-quality/generic-output-gate.js

@@ -87,6 +87,10 @@ const PLACEHOLDER_REFERENCE_RULES = [
         pattern: /(^|\/)(example|sample|mock|dummy)[\w.-]*\.[a-z]+$/i,
         reason: 'example file names must not be persisted as technical ownership',
     },
+    {
+        pattern: /(^|\/)(foo|bar|baz)\d*(?:\.[a-z0-9]+)+$/i,
+        reason: 'example file names must not be persisted as technical ownership',
+    },
 ];
 export function checkGenericSpecOutput(content) {
     const criteria = frontmatterCriteria(content);

package/dist/tools/create-spec.js

@@ -14,7 +14,7 @@ import { validateConstitution } from './create-spec/constitution-validator.js';
 import { getAsyncAnalysisPath } from './create-spec/post-creation.js';
 import { extractCriteria, generateLeanSpecContent, } from '../engine/spec-format/lean-spec-generator.js';
 import { generateLeanTechnicalContent, } from '../engine/spec-format/lean-technical-generator.js';
-import { extractFilesFromSpecBody } from '../engine/spec-format/technical-md-populator.js';
+import { extractFilesFromSpecBody, extractMarkerDeclaredPaths, } from '../engine/spec-format/technical-md-populator.js';
 import { buildCanonicalUnifiedSpecContent, containsUnresolvedContractPlaceholder, validateUnifiedSpecCandidate, } from '../engine/spec-format/unified-spec-builder.js';
 import { buildImplementationContractSection } from '../engine/implementation-contract/index.js';
 import { resolveEnglishOnlySpecGate } from '../engine/spec-language/english-only.js';
@@ -116,8 +116,25 @@ export async function groundTechnicalFiles(input) {
     };
     const records = [];
     const advisoryFiles = [];
+    const markerPaths = extractMarkerDeclaredPaths(input.userInput);
     for (const section of ['create', 'modify', 'test']) {
         for (const file of input.files[section]) {
+            if (markerPaths !== null) {
+                if (markerPaths.has(file.path.toLowerCase())) {
+                    grounded[section].push(file);
+                    records.push({
+                        path: file.path,
+                        section,
+                        source: 'user_input',
+                        evidence: ['create_spec.description'],
+                        confidence: 'high',
+                    });
+                }
+                else {
+                    advisoryFiles.push(file);
+                }
+                continue;
+            }
             const pathInUserInput = pathSurvivesNegativeClauseCheck(userInput, file.path.toLowerCase());
             const exists = await pathExists(pathJoin(input.projectPath, file.path));
             const fromAutopilot = autopilotPaths.has(file.path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.3.34",
+  "version": "5.3.36",
   "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.34",
+  "version": "5.3.36",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",