@planu/cli 4.10.0 → 4.10.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [4.10.2] - 2026-07-02
+
+### Bug Fixes
+- fix(SPEC-1105): preserve legacy spec ids during init migration
+
+
+## [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/spec-migrator/lean-migration.js

@@ -2,7 +2,7 @@
 // Detects old-format specs, extracts useful info, generates lean files, deletes obsolete files.
 import { readFile, readdir, stat } from 'node:fs/promises';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
 import { safeUnlink } from './git-aware-fs.js';
 import { parseFrontmatterLocal } from './frontmatter-parser.js';
 import { generateLeanSpecContent } from '../spec-format/lean-spec-generator.js';
@@ -324,6 +324,27 @@ function buildSpecFromMetadata(metadata, id, title, specStatus, estimation, spec
         impactAnalysis: null,
     };
 }
+function normalizeSpecId(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return /^SPEC-\d+$/.test(trimmed) ? trimmed : null;
+}
+function inferSpecIdFromDirectory(specDir) {
+    const match = /^(SPEC-\d+)(?:$|[-_])/.exec(basename(specDir));
+    return match?.[1] ?? null;
+}
+function inferSpecIdFromHeading(content) {
+    const match = /^#\s+(SPEC-\d+)(?:\b|[:\s—–-])/m.exec(content);
+    return match?.[1] ?? null;
+}
+function resolveSpecId(metadata, specDir, specContent) {
+    return (normalizeSpecId(metadata.id) ??
+        normalizeSpecId(metadata.spec_id) ??
+        inferSpecIdFromDirectory(specDir) ??
+        inferSpecIdFromHeading(specContent));
+}
 /** Write a verified backup of a file before overwriting. Returns backup path. Throws on failure. */
 async function writeVerifiedBackup(filePath) {
     const content = await readFile(filePath, 'utf-8');
@@ -354,7 +375,10 @@ export async function migrateSpecToLean(specDir, projectPath) {
         }
         // Parse frontmatter
         const { metadata } = parseFrontmatterLocal(specContent);
-        const id = typeof metadata.id === 'string' ? metadata.id : 'SPEC-000';
+        const id = resolveSpecId(metadata, specDir, specContent);
+        if (!id) {
+            return 'missing valid spec id';
+        }
         const title = typeof metadata.title === 'string' ? metadata.title : 'Untitled';
         const status = typeof metadata.status === 'string' ? metadata.status : 'draft';
         // Read old technical.md first (needed for estimation extraction)

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.2",
   "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.2",
+    "@planu/core-darwin-x64": "4.10.2",
+    "@planu/core-linux-arm64-gnu": "4.10.2",
+    "@planu/core-linux-arm64-musl": "4.10.2",
+    "@planu/core-linux-x64-gnu": "4.10.2",
+    "@planu/core-linux-x64-musl": "4.10.2",
+    "@planu/core-win32-arm64-msvc": "4.10.2",
+    "@planu/core-win32-x64-msvc": "4.10.2"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -129,7 +129,7 @@
   ],
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.109.0",
+    "@anthropic-ai/sdk": "^0.110.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "glob": "^13.0.6",
     "yaml": "^2.9.0",
@@ -177,7 +177,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "@stryker-mutator/core": "^9.6.1",
@@ -194,7 +194,7 @@
     "happy-dom": "^20.10.6",
     "husky": "^9.1.7",
     "javascript-obfuscator": "^5.4.3",
-    "knip": "^6.23.0",
+    "knip": "^6.24.0",
     "lint-staged": "^17.0.8",
     "madge": "^8.0.0",
     "prettier": "^3.9.4",
@@ -204,7 +204,7 @@
     "type-coverage": "^2.29.7",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
-    "vite": "^8.1.2",
+    "vite": "^8.1.3",
     "vitest": "^4.1.9",
     "vue": "^3.5.39"
   }

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.10.0",
+  "version": "4.10.2",
   "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.2",
   "icon": "assets/plugin/icon.svg",
   "command": [
     "npx",