@planu/cli 3.9.14 → 4.0.0

package/dist/tools/validate.js

@@ -68,6 +68,33 @@ export async function handleValidate(args, server) {
         };
     }
     const projectPath = knowledge.projectPath;
+    // SPEC-1017: fail closed when planu/ contains non-canonical artifacts.
+    try {
+        const { runStrictPlanuCleanup, validateStrictPlanuLayout } = await import('../engine/spec-migrator/index.js');
+        await runStrictPlanuCleanup(projectPath);
+        const layout = await validateStrictPlanuLayout(projectPath);
+        if (!layout.ok) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Strict Planu layout validation failed for ${specId}.\n\n` +
+                            `Non-canonical paths:\n${layout.offenders.map((p) => `- ${p}`).join('\n')}\n\n` +
+                            `Canonical contract:\n${layout.contract}`,
+                    },
+                ],
+                isError: true,
+                structuredContent: {
+                    error: 'strict_planu_layout_violation',
+                    offenders: layout.offenders,
+                    contract: layout.contract,
+                },
+            };
+        }
+    }
+    catch {
+        /* best-effort — implementation validation still runs if layout check is unavailable */
+    }
     // 3. Run validation engine
     const result = await validateSpec(spec, projectPath);
     // 4. Generate DoR and DoD checklists

package/dist/tools/workspace-dashboard-handler.js

@@ -10,6 +10,7 @@ import { readRecentAutopilotAlerts } from '../storage/autopilot-log-store.js';
 import { verifyStateFiles } from '../engine/cascade-hooks/state-drift-detector.js';
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { getAsyncAnalysisPath } from './create-spec/post-creation.js';
 export async function handleWorkspaceOverview(args) {
     const result = await buildWorkspaceOverview(args.healthThreshold);
     if (result.projectCount === 0) {
@@ -126,10 +127,10 @@ export async function handleWorkspaceSearch(args) {
     }
     return { content: [{ type: 'text', text: lines.join('\n') }] };
 }
-/** SPEC-781: Check if a spec has a pending async analysis (no .analysis.json yet). */
-async function hasPendingAnalysis(projectPath, specDir) {
+/** SPEC-781: Check if a spec has pending async analysis in external project data. */
+async function hasPendingAnalysis(projectPath, specId) {
     try {
-        await readFile(join(projectPath, specDir, '.analysis.json'), 'utf-8');
+        await readFile(getAsyncAnalysisPath(projectPath, specId), 'utf-8');
         return false;
     }
     catch {
@@ -144,7 +145,6 @@ async function collectPendingAnalysisAlerts(projectPath) {
         const results = [];
         const PENDING_RE = /^pendingAnalysis:\s*true/m;
         const ID_RE = /^id:\s*(SPEC-\d+)/m;
-        const SPEC_DIR_RE = /planu\/specs\/([^/]+)\/spec\.md$/;
         for (const specFile of specFiles) {
             const content = await readFile(specFile, 'utf-8').catch(() => '');
             if (!PENDING_RE.test(content)) {
@@ -155,11 +155,8 @@ async function collectPendingAnalysisAlerts(projectPath) {
             if (specId === undefined) {
                 continue;
             }
-            const dirMatch = SPEC_DIR_RE.exec(specFile);
-            const dirName = dirMatch?.[1];
-            const specDir = dirName !== undefined ? join('planu/specs', dirName) : null;
-            if (specDir !== null && !(await hasPendingAnalysis(projectPath, specDir))) {
-                continue; // .analysis.json exists — analysis done
+            if (!(await hasPendingAnalysis(projectPath, specId))) {
+                continue;
             }
             results.push({ specId, message: `Spec ${specId} analysis still running` });
         }

package/dist/types/git.d.ts

@@ -310,7 +310,7 @@ export interface ListSpecPrsInput {
     projectPath: string;
     specId?: string;
 }
-export type PlanuAutocommitSkipReason = 'no-staged-changes' | 'mid-merge' | 'detached-head';
+export type PlanuAutocommitSkipReason = 'disabled' | 'no-staged-changes' | 'mid-merge' | 'detached-head';
 export type PlanuAutocommitReason = 'mark-done' | 'sync-release' | 'status-update' | 'session-checkpoint';
 export interface PlanuAutocommitResult {
     committed: boolean;

package/dist/types/spec-format.d.ts

@@ -1,5 +1,6 @@
 import type { Spec } from './spec/core.js';
 import type { Estimation } from './estimation.js';
+import type { SpecStatus } from './common/index.js';
 /** A criterion in the lean spec frontmatter. */
 export interface LeanCriterion {
     text: string;
@@ -42,6 +43,31 @@ export interface CleanupResult {
     deletedSpecFiles: string[];
     totalDeleted: number;
 }
+export interface PlanuCanonicalPathPolicy {
+    readonly canonicalRootFiles: readonly string[];
+    readonly canonicalRootDirs: readonly string[];
+    readonly canonicalSpecFiles: readonly string[];
+    readonly generatedRuntimePatterns: readonly string[];
+    readonly legacyMergeBeforeDeleteFiles: readonly string[];
+}
+export interface StrictPlanuCleanupResult {
+    deleted: string[];
+    merged: string[];
+    gitignoreUpdated: boolean;
+}
+export interface StrictPlanuValidationResult {
+    ok: boolean;
+    offenders: string[];
+    contract: string;
+}
+export interface UpdateStatusBatchInput {
+    specIds: string[];
+    status: SpecStatus;
+    projectId?: string;
+    projectPath?: string;
+    dryRun?: boolean;
+    reviewNotes?: string;
+}
 /** Report of detected migration drift (SPEC-715). Read-only — no FS mutations. */
 export interface MigrationDriftReport {
     /** Count of specs that still have a stray technical.md (need unified migration). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "3.9.14",
+  "version": "4.0.0",
   "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",