@planu/cli 5.4.0 → 5.4.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [5.4.1] - 2026-08-29
+
+### Bug Fixes
+- fix(SPEC-1675): strip FILES/FUNCTIONS/TEST metadata markers from contradiction analysis
+- fix(SPEC-1676): rebuild expired project knowledge graph and re-stamp cached reuse
+
+
 ## [5.4.0] - 2026-08-29
 
 ### Features

package/dist/.planu-build.json

@@ -1 +1 @@
-{"schemaVersion":1,"commit":"1224d53c6195e75033a881982ac489bc4f2619f3"}
+{"schemaVersion":1,"commit":"c920f236390f64d91a02ca3e0566e59210f00a49"}

package/dist/engine/project-graph/builder.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { collectProjectGraphSources, diffSourceHashes, hashText, hydrateProjectGraphSource, loadProjectGraphPolicy, projectGraphCachePath, projectGraphExtractorVersion, projectGraphPath, readProjectGraphArtifact, readProjectGraphCache, withProjectGraphBuildLock, writeProjectGraphArtifacts, } from './cache.js';
+import { collectProjectGraphSources, diffSourceHashes, hashText, hydrateProjectGraphSource, loadProjectGraphPolicy, projectGraphCachePath, projectGraphExtractorVersion, projectGraphPath, readProjectGraphArtifact, readProjectGraphCache, withProjectGraphBuildLock, writeProjectGraph, writeProjectGraphArtifacts, } from './cache.js';
 import { extractGitGraph, extractReleaseGraph } from './extractors/git-extractor.js';
 import { extractHandoffGraph } from './extractors/handoff-extractor.js';
 import { extractDecisionStoreGraph } from './extractors/decision-store-extractor.js';
@@ -210,13 +210,16 @@ async function buildProjectKnowledgeGraphUnlocked(args) {
         Array.isArray(existingGraph.nodes) &&
         Array.isArray(existingGraph.edges);
     if (hasConsistentExistingGraph && diff.changed.length === 0 && diff.removed.length === 0) {
+        const refreshedGeneratedAt = new Date().toISOString();
         const graphWithCurrentOversizedSources = {
             ...existingGraph,
+            generatedAt: refreshedGeneratedAt,
             oversizedSources,
         };
+        await writeProjectGraph(args.projectId, args.policy, graphWithCurrentOversizedSources);
         publishFreshProjectGraphProjection({
             projectId: args.projectId,
-            generatedAt: existingGraph.generatedAt,
+            generatedAt: refreshedGeneratedAt,
             generation: existingGraph.generation,
         });
         return {

package/dist/engine/project-graph/query.js

@@ -55,7 +55,8 @@ async function ensureFreshProjectGraph(args) {
     const freshness = await getProjectGraphFreshness(args);
     if (!freshness.exists ||
         freshness.reason === 'source_changed' ||
-        freshness.reason === 'corrupt') {
+        freshness.reason === 'corrupt' ||
+        freshness.reason === 'expired') {
         await buildProjectKnowledgeGraph(args);
         return getProjectGraphFreshness(args);
     }

package/dist/engine/scope-boundaries/contradiction-checker.js

@@ -203,14 +203,35 @@ function assertsActionNearScope(clause, outOfScopeItem) {
     }
     return false;
 }
+const METADATA_MARKER_KEYWORD = /\b(?:FILES?|FUNCTIONS?|TESTS?)\s*:/gi;
+const SENTENCE_BOUNDARY_AFTER_MARKER = /\.\s+(?=[A-Z])/;
+function stripMetadataMarkers(text) {
+    const markers = [...text.matchAll(METADATA_MARKER_KEYWORD)];
+    if (markers.length === 0) {
+        return text;
+    }
+    let result = '';
+    let cursor = 0;
+    for (let i = 0; i < markers.length; i++) {
+        const start = markers[i]?.index ?? 0;
+        result += text.slice(cursor, start);
+        const nextMarkerStart = markers[i + 1]?.index ?? text.length;
+        const searchRegion = text.slice(start, nextMarkerStart);
+        const boundaryMatch = SENTENCE_BOUNDARY_AFTER_MARKER.exec(searchRegion);
+        cursor = boundaryMatch ? start + boundaryMatch.index + 1 : nextMarkerStart;
+    }
+    result += text.slice(cursor);
+    return result.replace(/\s+/g, ' ').trim();
+}
 /**
  * Determine whether a criterion text contradicts an out-of-scope item.
  * Uses substring match first, then keyword overlap as fuzzy fallback.
  */
 function contradicts(criterionText, outOfScopeItem) {
-    const normCriterion = normalize(criterionText);
+    const strippedCriterionText = stripMetadataMarkers(criterionText);
+    const normCriterion = normalize(strippedCriterionText);
     const normScope = normalize(outOfScopeItem);
-    const clauses = splitClauses(criterionText);
+    const clauses = splitClauses(strippedCriterionText);
     const relevantClauses = clauses.filter((clause) => clauseMentionsScope(clause, outOfScopeItem));
     const hasConditionalException = /\b(?:unless|except)\b/i.test(criterionText);
     if (!hasConditionalException &&

package/package.json

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