@planu/cli 4.3.19 → 4.3.20

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.3.20] - 2026-05-27
+
+### Bug Fixes
+- fix(SPEC-1073): make lifecycle state writes idempotent
+
+
 ## [4.3.19] - 2026-05-27
 
 ### Bug Fixes

package/dist/engine/cascade-hooks/core/append-releases.js

@@ -7,7 +7,7 @@ import { specStore } from '../../../storage/index.js';
 const CORE_ACTION_BUDGET_MS = 2000;
 async function actuallyAppendReleasesPending(ctx, opts) {
     const { projectPath, projectId, specId } = ctx;
-    if (!projectPath) {
+    if (!projectPath || ctx.newStatus !== 'done') {
         return;
     }
     if (opts.signal.aborted) {
@@ -34,6 +34,7 @@ async function actuallyAppendReleasesPending(ctx, opts) {
                 /* file doesn't exist yet — start fresh */
             }
             const completedAt = new Date().toISOString().substring(0, 10);
+            pendingList = pendingList.filter((entry) => entry.specId !== specId);
             pendingList.push({ specId, title: spec?.title ?? specId, completedAt });
             await writeFile(pendingPath, JSON.stringify(pendingList, null, 2), 'utf-8');
             // Auto-commit planu/ changes so pending.json is never left unstaged

package/dist/engine/cascade-hooks/runner.js

@@ -6,9 +6,10 @@ import { appendReleasesPending } from './core/append-releases.js';
 const FAST_HOOK_BUDGET_MS = 2000;
 export async function runCascade(ctx, opts) {
     // Core actions: awaited in parallel, each with its own 2-second budget
+    const releasePendingPromise = ctx.newStatus === 'done' ? appendReleasesPending(ctx) : Promise.resolve({ ok: true });
     const [sessionResult, releasesResult] = await Promise.all([
         writeSessionJson(ctx),
-        appendReleasesPending(ctx),
+        releasePendingPromise,
     ]);
     const dispatched = [];
     const skipped = [];

package/dist/engine/session-state/writer.js

@@ -135,6 +135,10 @@ export async function updateEpicProgressInSession(projectPath, specs) {
         catch {
             /* start fresh */
         }
+        const terminalSpecIds = new Set(specs
+            .filter((spec) => spec.status === 'done' || spec.status === 'discarded')
+            .map((spec) => spec.id));
+        index.activeSpecs = index.activeSpecs.filter((specId) => !terminalSpecIds.has(specId));
         index.epicProgress = epicProgress;
         index.updatedAt = new Date().toISOString();
         await writeFile(filePath, JSON.stringify(index, null, 2), 'utf-8');

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

@@ -289,42 +289,6 @@ export async function runDoneActions(projectId, specId, gitBranch) {
                         clearPending(specId, 'generateSessionContext');
                     }
                 })(),
-                // SPEC-649: Append spec to releases/pending.json — changelog written only at release time
-                // SPEC-660: Dedup — pending.json append runs once per spec within 5s window
-                (async () => {
-                    if (hasPending(specId, 'appendPending')) {
-                        return;
-                    }
-                    markPending(specId, 'appendPending');
-                    try {
-                        const { join } = await import('node:path');
-                        const { readFile, writeFile, mkdir } = await import('node:fs/promises');
-                        const releasesDir = join(projectPath, 'planu', 'releases');
-                        const pendingPath = join(releasesDir, 'pending.json');
-                        await mkdir(releasesDir, { recursive: true });
-                        const spec = await specStore.getSpec(projectId, specId);
-                        let pendingList = [];
-                        try {
-                            const raw = await readFile(pendingPath, 'utf-8');
-                            const parsed = JSON.parse(raw);
-                            if (Array.isArray(parsed)) {
-                                pendingList = parsed;
-                            }
-                        }
-                        catch {
-                            /* file doesn't exist yet — start fresh */
-                        }
-                        const completedAt = new Date().toISOString().substring(0, 10);
-                        pendingList.push({ specId, title: spec?.title ?? specId, completedAt });
-                        await writeFile(pendingPath, JSON.stringify(pendingList, null, 2), 'utf-8');
-                    }
-                    catch {
-                        /* best-effort */
-                    }
-                    finally {
-                        clearPending(specId, 'appendPending');
-                    }
-                })(),
                 // SPEC-629: Delete ephemeral prompt.md — file served its purpose once implementing starts
                 (async () => {
                     /* v8 ignore start */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.3.19",
+  "version": "4.3.20",
   "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.3.19",
-    "@planu/core-darwin-x64": "4.3.19",
-    "@planu/core-linux-arm64-gnu": "4.3.19",
-    "@planu/core-linux-arm64-musl": "4.3.19",
-    "@planu/core-linux-x64-gnu": "4.3.19",
-    "@planu/core-linux-x64-musl": "4.3.19",
-    "@planu/core-win32-arm64-msvc": "4.3.19",
-    "@planu/core-win32-x64-msvc": "4.3.19"
+    "@planu/core-darwin-arm64": "4.3.20",
+    "@planu/core-darwin-x64": "4.3.20",
+    "@planu/core-linux-arm64-gnu": "4.3.20",
+    "@planu/core-linux-arm64-musl": "4.3.20",
+    "@planu/core-linux-x64-gnu": "4.3.20",
+    "@planu/core-linux-x64-musl": "4.3.20",
+    "@planu/core-win32-arm64-msvc": "4.3.20",
+    "@planu/core-win32-x64-msvc": "4.3.20"
   },
   "engines": {
     "node": ">=24.0.0"

package/planu-native.json

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