@planu/cli 3.9.13 → 4.0.0

package/dist/tools/update-status-actions.js

@@ -162,22 +162,18 @@ export async function runDoneActions(projectId, specId, gitBranch) {
             }
             return null;
         })(),
-        // SPEC-544: Auto-stage planu/ files, then warn only if non-planu changes remain
-        // SPEC-575: Auto-commit staged planu/ docs (idempotent, safe-fail)
+        // Warn if non-planu changes remain. Planu autocommit/staging is opt-in only.
         (async () => {
             try {
                 const { resolveProjectPath, git: gitCmd } = await import('./git/git-helpers.js');
                 const projectPath = await resolveProjectPath(projectId);
-                try {
+                if (process.env.PLANU_ENABLE_AUTOCOMMIT === 'true') {
                     await gitCmd(projectPath, ['add', 'planu/']);
                     const { planuAutoCommit } = await import('../engine/git/planu-autocommit.js');
                     void planuAutoCommit({ projectPath, specId, reason: 'mark-done' }).catch((err) => {
                         console.error('[update-status] planuAutoCommit failed:', err instanceof Error ? err.message : String(err));
                     });
                 }
-                catch {
-                    // git add failed (nothing to stage, or not a git repo) — continue to status check
-                }
                 const { stdout } = await gitCmd(projectPath, ['status', '--porcelain']);
                 const nonPlanuLines = stdout
                     .trim()

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.13",
+  "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",
@@ -32,12 +32,12 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "3.9.13",
-    "@planu/core-darwin-x64": "3.9.13",
-    "@planu/core-linux-arm64-gnu": "3.9.13",
-    "@planu/core-linux-arm64-musl": "3.9.13",
-    "@planu/core-linux-x64-gnu": "3.9.13",
-    "@planu/core-linux-x64-musl": "3.9.13"
+    "@planu/core-darwin-arm64": "3.9.14",
+    "@planu/core-darwin-x64": "3.9.14",
+    "@planu/core-linux-arm64-gnu": "3.9.14",
+    "@planu/core-linux-arm64-musl": "3.9.14",
+    "@planu/core-linux-x64-gnu": "3.9.14",
+    "@planu/core-linux-x64-musl": "3.9.14"
   },
   "engines": {
     "node": ">=24.0.0"