@planu/cli 4.10.0 → 4.10.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.10.1] - 2026-07-01
+
+### Bug Fixes
+- fix: prevent generated spec artifacts and refresh graph status
+
+
 ## [4.10.0] - 2026-07-01
 
 ### Features

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

@@ -145,11 +145,26 @@ export async function getProjectGraphFreshnessHint(args) {
     if (!policy.enabled) {
         return undefined;
     }
-    const freshness = await getProjectGraphFreshness({
+    let freshness = await getProjectGraphFreshness({
         projectId,
         projectPath: args.projectPath,
         policy,
     });
+    if (!freshness.exists ||
+        freshness.reason === 'source_changed' ||
+        freshness.reason === 'corrupt') {
+        try {
+            await buildProjectKnowledgeGraph({ projectId, projectPath: args.projectPath, policy });
+            freshness = await getProjectGraphFreshness({
+                projectId,
+                projectPath: args.projectPath,
+                policy,
+            });
+        }
+        catch {
+            // status must stay non-blocking; fall back to the stale hint below.
+        }
+    }
     if (!freshness.stale) {
         return undefined;
     }

package/dist/engine/tdd-enforcer/stub-artifact-path.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveTddStubArtifactPath(specId: string, projectPath: string): string;
+//# sourceMappingURL=stub-artifact-path.d.ts.map

package/dist/engine/tdd-enforcer/stub-artifact-path.js

@@ -0,0 +1,7 @@
+import { join } from 'node:path';
+import { hashProjectPath, projectDataDir } from '../../storage/base-store.js';
+export function resolveTddStubArtifactPath(specId, projectPath) {
+    const projectId = hashProjectPath(projectPath);
+    return join(projectDataDir(projectId), 'handoffs', specId, 'test-stubs.ts');
+}
+//# sourceMappingURL=stub-artifact-path.js.map

package/dist/engine/tdd-enforcer/stub-generator.js

@@ -1,6 +1,7 @@
 // SPEC-452 — Generates TDD test stubs from spec acceptance criteria
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
+import { dirname, join } from 'node:path';
+import { resolveTddStubArtifactPath } from './stub-artifact-path.js';
 const SECTION_RE = /^###\s+(.+)$/;
 function sanitizeTestName(text) {
     return text.replace(/[`'"]/g, '').trim();
@@ -73,7 +74,7 @@ export async function generateTestStubs(specId, projectPath) {
         return { specId, stubs: [], fileContent: '', outputPath: '' };
     }
     const fileContent = buildStubFileContent(specId, stubs);
-    const outputPath = join(dirname(specFile), 'test-stubs.ts');
+    const outputPath = resolveTddStubArtifactPath(specId, projectPath);
     await mkdir(dirname(outputPath), { recursive: true });
     await writeFile(outputPath, fileContent, 'utf-8');
     return { specId, stubs, fileContent, outputPath };

package/dist/engine/tdd-enforcer/tdd-gate.js

@@ -1,18 +1,24 @@
 // SPEC-452 — TDD gates for status transitions
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { resolveTddStubArtifactPath } from './stub-artifact-path.js';
 const TDD_STUB_MARKER = "expect.fail('TDD stub";
+async function readExternalStubContent(specId, projectPath) {
+    try {
+        return await readFile(resolveTddStubArtifactPath(specId, projectPath), 'utf-8');
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return null;
+        }
+        throw err;
+    }
+}
 export async function checkTddReadiness(specId, projectPath) {
-    const specDir = join(projectPath, 'planu', 'specs');
     const { glob } = await import('glob');
-    // Check for test-stubs.ts in spec dir
-    const stubMatches = await glob(`${specDir}/${specId}-*/test-stubs.ts`);
-    const hasStubs = stubMatches.length > 0;
-    let stubCount = 0;
-    if (hasStubs && stubMatches[0]) {
-        const content = await readFile(stubMatches[0], 'utf-8');
-        stubCount = (content.match(/it\(/g) ?? []).length;
-    }
+    const stubContent = await readExternalStubContent(specId, projectPath);
+    const hasStubs = stubContent !== null;
+    const stubCount = stubContent === null ? 0 : (stubContent.match(/it\(/g) ?? []).length;
     // Check for test files referencing this spec
     const testsDir = join(projectPath, 'tests');
     const testFiles = await glob(`${testsDir}/**/*.test.ts`);
@@ -37,13 +43,10 @@ export async function checkTddReadiness(specId, projectPath) {
     return { hasStubs, stubCount, hasTestFiles, recommendation };
 }
 export async function checkTddCompletion(specId, projectPath) {
-    const specDir = join(projectPath, 'planu', 'specs');
-    const { glob } = await import('glob');
-    const stubMatches = await glob(`${specDir}/${specId}-*/test-stubs.ts`);
-    if (stubMatches.length === 0 || !stubMatches[0]) {
+    const content = await readExternalStubContent(specId, projectPath);
+    if (content === null) {
         return { unresolvedStubs: 0, totalStubs: 0, resolvedPercentage: 100, pendingCriteria: [] };
     }
-    const content = await readFile(stubMatches[0], 'utf-8');
     const allStubs = content.match(/it\(/g) ?? [];
     const unresolvedMatches = content.match(new RegExp(TDD_STUB_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g')) ?? [];
     const totalStubs = allStubs.length;

package/dist/tools/generate-execution-plan.js

@@ -3,7 +3,7 @@
 // Phase logic lives in src/engine/execution-plan/phases.ts
 // Mobile distribution lives in src/engine/execution-plan/mobile-distribution.ts
 // Utilities live in src/engine/execution-plan/plan-utils.ts
-import { writeFile } from 'node:fs/promises';
+import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { specStore, knowledgeStore, patternStore } from '../storage/index.js';
 import { t, ti } from '../i18n/index.js';
@@ -12,6 +12,7 @@ import { generateSetupPhase, generateDataLayerPhase, generateBusinessLogicPhase,
 import { generateMobileDistributionPhase, isMobileDistributionSpec, } from '../engine/execution-plan/mobile-distribution.js';
 import { isDesktopReleaseSpec, generateDesktopDistributionPhase, } from '../engine/execution-plan/desktop-distribution.js';
 import { determineCriticalPath, findParallelizable, readSpecContent, } from '../engine/execution-plan/plan-utils.js';
+import { projectDataDir } from '../storage/base-store.js';
 export async function handleGenerateExecutionPlan(args) {
     const { specId, projectId } = args;
     const spec = await specStore.getSpec(projectId, specId);
@@ -38,9 +39,9 @@ export async function handleGenerateExecutionPlan(args) {
     const plan = { phases, totalSteps, criticalPath, parallelizable };
     let planPath;
     try {
-        const planDir = dirname(spec.specPath);
-        planPath = join(planDir, 'PLAN.md');
+        planPath = join(projectDataDir(projectId), 'handoffs', specId, 'execution-plan.md');
         const planContent = generatePlanMarkdown(plan, spec);
+        await mkdir(dirname(planPath), { recursive: true });
         await writeFile(planPath, planContent, 'utf-8');
         await specStore.updateSpec(projectId, specId, { planPath });
         /* v8 ignore next 3 -- defensive: filesystem write failure during plan generation */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.10.0",
+  "version": "4.10.1",
   "description": "Planu — MCP Server for Spec Driven Development with native Rust acceleration for hot paths. Cross-platform (Linux/macOS/Windows, x64/arm64, glibc/musl).",
   "type": "module",
   "main": "dist/index.js",
@@ -34,14 +34,14 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "4.10.0",
-    "@planu/core-darwin-x64": "4.10.0",
-    "@planu/core-linux-arm64-gnu": "4.10.0",
-    "@planu/core-linux-arm64-musl": "4.10.0",
-    "@planu/core-linux-x64-gnu": "4.10.0",
-    "@planu/core-linux-x64-musl": "4.10.0",
-    "@planu/core-win32-arm64-msvc": "4.10.0",
-    "@planu/core-win32-x64-msvc": "4.10.0"
+    "@planu/core-darwin-arm64": "4.10.1",
+    "@planu/core-darwin-x64": "4.10.1",
+    "@planu/core-linux-arm64-gnu": "4.10.1",
+    "@planu/core-linux-arm64-musl": "4.10.1",
+    "@planu/core-linux-x64-gnu": "4.10.1",
+    "@planu/core-linux-x64-musl": "4.10.1",
+    "@planu/core-win32-arm64-msvc": "4.10.1",
+    "@planu/core-win32-x64-msvc": "4.10.1"
   },
   "engines": {
     "node": ">=24.0.0"

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.10.0",
+  "version": "4.10.1",
   "packageName": "@planu/cli",
   "modes": {
     "lightweight": {

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": "4.10.0",
+  "version": "4.10.1",
   "icon": "assets/plugin/icon.svg",
   "command": [
     "npx",