@planu/cli 5.7.1 → 5.7.3

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [5.7.3] - 2026-08-31
+
+### Bug Fixes
+- fix(release): validate ledger shape before abort version derivation
+- fix(release): fail-closed recovery ledger writer and tolerant abort for corrupted releaseVersion
+- fix(build): report real git failure in provenance stamp and retry transient errors
+
+
+## [5.7.2] - 2026-08-31
+
+### Bug Fixes
+- fix(housekeeping): carry gitignore rule when runtime migration relocates private files
+
+
 ## [5.7.1] - 2026-08-31
 
 ### Bug Fixes

package/dist/.planu-build.json

@@ -1 +1 @@
-{"schemaVersion":1,"commit":"04661e53067d139151a01671e92fec0f4f2ddfc1"}
+{"schemaVersion":1,"commit":"c4bce4cb95bcc9bf608918ec18bf3dd47c6b3f91"}

package/dist/engine/housekeeping/gitignore-carry.d.ts

@@ -0,0 +1,4 @@
+import type { GitignoreCarryResult } from '../../types/housekeeping.js';
+export declare function detectTrackedRelocation(projectPath: string, newRelPath: string): Promise<string | null>;
+export declare function carryGitignoreRule(projectPath: string, oldRelPath: string, newRelPath: string): Promise<GitignoreCarryResult>;
+//# sourceMappingURL=gitignore-carry.d.ts.map

package/dist/engine/housekeeping/gitignore-carry.js

@@ -0,0 +1,48 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { existsSync } from 'node:fs';
+import { readFile, appendFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const execFileAsync = promisify(execFile);
+async function isGitIgnored(projectPath, relPath) {
+    try {
+        await execFileAsync('git', ['check-ignore', '-q', relPath], { cwd: projectPath });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectTrackedRelocation(projectPath, newRelPath) {
+    try {
+        await execFileAsync('git', ['ls-files', '--error-unmatch', newRelPath], { cwd: projectPath });
+        return `[Planu] ${newRelPath} is git-tracked but contains private runtime state; run: git rm --cached ${newRelPath}`;
+    }
+    catch {
+        return null;
+    }
+}
+async function appendGitignoreRule(projectPath, relPath) {
+    const gitignorePath = join(projectPath, '.gitignore');
+    const existingContent = existsSync(gitignorePath) ? await readFile(gitignorePath, 'utf-8') : '';
+    const alreadyPresent = existingContent.split('\n').some((line) => line.trim() === relPath);
+    if (alreadyPresent) {
+        return false;
+    }
+    const prefix = existingContent.length > 0 && !existingContent.endsWith('\n') ? '\n' : '';
+    await appendFile(gitignorePath, `${prefix}${relPath}\n`, 'utf-8');
+    return true;
+}
+export async function carryGitignoreRule(projectPath, oldRelPath, newRelPath) {
+    const [oldIgnored, newIgnored] = await Promise.all([
+        isGitIgnored(projectPath, oldRelPath),
+        isGitIgnored(projectPath, newRelPath),
+    ]);
+    let ruleAppended = false;
+    if (oldIgnored && !newIgnored) {
+        ruleAppended = await appendGitignoreRule(projectPath, newRelPath);
+    }
+    const trackedWarning = await detectTrackedRelocation(projectPath, newRelPath);
+    return { ruleAppended, trackedWarning };
+}
+//# sourceMappingURL=gitignore-carry.js.map

package/dist/engine/housekeeping/history-log.js

@@ -4,9 +4,10 @@
 import { existsSync } from 'node:fs';
 import { createHash, randomUUID } from 'node:crypto';
 import { appendFile, readFile, mkdir, rm, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
+import { dirname, join, relative, sep } from 'node:path';
 // eslint-disable-next-line no-restricted-imports -- grandfathered layer violation, remediation SPEC-1699
 import { projectRuntimeDir } from '../../storage/storage-layout.js';
+import { carryGitignoreRule } from './gitignore-carry.js';
 // ---------------------------------------------------------------------------
 // Path helpers
 // ---------------------------------------------------------------------------
@@ -35,10 +36,22 @@ function entryId(line) {
 function jsonlLines(content) {
     return content.split('\n').filter((line) => line.trim().length > 0);
 }
+function toPosixRelative(projectPath, absPath) {
+    return relative(projectPath, absPath).split(sep).join('/');
+}
+async function carryGitignoreAndWarn(projectPath, legacyPath, newPath) {
+    const result = await carryGitignoreRule(projectPath, toPosixRelative(projectPath, legacyPath), toPosixRelative(projectPath, newPath));
+    if (result.trackedWarning !== null) {
+        console.warn(result.trackedWarning);
+    }
+}
 export async function migrateLegacyHousekeepingHistory(projectPath) {
     const legacyPath = legacyHousekeepingHistoryPath(projectPath);
     const newPath = housekeepingHistoryPath(projectPath);
     if (!existsSync(legacyPath)) {
+        if (existsSync(newPath)) {
+            await carryGitignoreAndWarn(projectPath, legacyPath, newPath);
+        }
         return null;
     }
     const legacyContent = await readFile(legacyPath, 'utf-8');
@@ -50,6 +63,7 @@ export async function migrateLegacyHousekeepingHistory(projectPath) {
             throw new Error('[Planu] housekeeping history migration verification failed');
         }
         await rm(legacyPath, { force: true });
+        await carryGitignoreAndWarn(projectPath, legacyPath, newPath);
         return legacyPath;
     }
     const destinationContent = await readFile(newPath, 'utf-8');
@@ -62,6 +76,7 @@ export async function migrateLegacyHousekeepingHistory(projectPath) {
         await appendFile(newPath, missingLines.map((line) => `${line}\n`).join(''), 'utf-8');
     }
     await rm(legacyPath, { force: true });
+    await carryGitignoreAndWarn(projectPath, legacyPath, newPath);
     return legacyPath;
 }
 // ---------------------------------------------------------------------------

package/dist/types/housekeeping.d.ts

@@ -184,4 +184,8 @@ export interface LegacyPlanuSweepResult {
     failures: LegacyPlanuDemolitionFailure[];
     freedBytes: number;
 }
+export interface GitignoreCarryResult {
+    ruleAppended: boolean;
+    trackedWarning: string | null;
+}
 //# sourceMappingURL=housekeeping.d.ts.map

package/package.json

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