@planu/cli 5.5.3 → 5.6.0

package/dist/types/housekeeping.d.ts

@@ -146,4 +146,8 @@ export interface HousekeepingHistoryEntry {
     prevSha: string;
     sha256: string;
 }
+export interface RuntimeResidueSweepResult {
+    /** Absolute paths of every legacy runtime artifact removed from planu/. */
+    removed: string[];
+}
 //# sourceMappingURL=housekeeping.d.ts.map

package/dist/types/index.d.ts

@@ -293,5 +293,6 @@ export * from './host-tool-filter.js';
 export * from './reconcile.js';
 export * from './release-pipeline.js';
 export * from './network-policy.js';
+export * from './retention.js';
 export type { VerifiedImplementationReviewResult, VerifiedImplementationReviewOk, VerifiedImplementationReviewErr, ImplementationReviewRejectionReason, } from './handoff-artifacts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -304,4 +304,5 @@ export * from './reconcile.js';
 // SPEC-1012: Release spec closer types
 export * from './release-pipeline.js';
 export * from './network-policy.js';
+export * from './retention.js';
 //# sourceMappingURL=index.js.map

package/dist/types/retention.d.ts

@@ -0,0 +1,12 @@
+export interface RetentionResult {
+    readonly freedBytes: number;
+    readonly removedPaths: readonly string[];
+}
+export type RetentionKind = 'transition-log' | 'graph-cache' | 'spec-store-backup' | 'idempotency' | 'snapshot' | 'spec-artifacts';
+export interface EnforceRetentionInput {
+    readonly kind: RetentionKind;
+    readonly path: string;
+    readonly protectedPaths?: readonly string[];
+    readonly specId?: string;
+}
+//# sourceMappingURL=retention.d.ts.map

package/dist/types/retention.js

@@ -0,0 +1,3 @@
+// types/retention.ts — SPEC-1697: retention budgets for runtime storage artifacts
+export {};
+//# sourceMappingURL=retention.js.map

package/dist/types/spec/core.d.ts

@@ -139,6 +139,13 @@ export interface Spec {
      * Contains failure scenarios, addressed count, and overall risk.
      */
     challengeReport?: ChallengeReport;
+    /**
+     * SPEC-1699: sha256 digest of the spec.md content this record's title was
+     * last synced from. Absent or mismatched against the current spec.md means
+     * the record is stale and is refreshed on the next read that supplies a
+     * canonicalRoot (see spec-store.ts refreshSpecFromDisk).
+     */
+    contentDigest?: string;
 }
 /** SPEC-964: Result of running challenge_spec on a spec. */
 export interface ChallengeReport {

package/dist/types/spec/index-cache.d.ts

@@ -0,0 +1,25 @@
+/** One spec's fields as parsed from its canonical spec.md, plus a content digest. */
+export interface SpecIndexRecord {
+    readonly id: string;
+    readonly title: string;
+    readonly status: string;
+    readonly type: string;
+    readonly target: string;
+    readonly scope: string;
+    readonly difficulty: number | null;
+    readonly risk: string;
+    readonly createdAt: string | null;
+    readonly updatedAt: string;
+    readonly specPath: string;
+    readonly digest: string;
+    /** GIVEN/WHEN/THEN acceptance-criteria lines parsed from the spec.md body. */
+    readonly scenarios: readonly string[];
+    /** `TEST:` marker contents parsed from the spec.md body. */
+    readonly tests: readonly string[];
+}
+/** Regenerable cache persisted at planu/.runtime/index.json. spec.md is authoritative. */
+export interface SpecIndex {
+    readonly generatedAt: string;
+    readonly specs: Readonly<Record<string, SpecIndexRecord>>;
+}
+//# sourceMappingURL=index-cache.d.ts.map

package/dist/types/spec/index-cache.js

@@ -0,0 +1,3 @@
+// Planu — Regenerable spec.md read-index types (SPEC-1699)
+export {};
+//# sourceMappingURL=index-cache.js.map

package/dist/types/spec/index.d.ts

@@ -6,4 +6,5 @@ export * from './agent.js';
 export * from './repair.js';
 export * from './health-score.js';
 export * from './versioning.js';
+export * from './index-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/spec/index.js

@@ -8,4 +8,5 @@ export * from './agent.js';
 export * from './repair.js';
 export * from './health-score.js';
 export * from './versioning.js';
+export * from './index-cache.js';
 //# sourceMappingURL=index.js.map

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

@@ -72,6 +72,7 @@ export interface PlanuCanonicalPathPolicy {
     readonly canonicalSpecFiles: readonly string[];
     readonly canonicalSpecDirs: readonly string[];
     readonly forbiddenHostAssetRootDirs: readonly string[];
+    readonly runtimeHomeDir: string;
     readonly generatedRuntimePatterns: readonly string[];
     readonly legacyMergeBeforeDeleteFiles: readonly string[];
 }

package/package.json

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

package/scripts/lib/pending-release-file.mjs

@@ -116,15 +116,31 @@ export function isCommitReachable(repoRoot, commit, ontoCommit) {
   throw new Error(`git merge-base --is-ancestor exited with status ${String(result.status)}`);
 }
 
-export async function writePendingReleaseLedger(pendingPath, entries) {
-  const temporaryPath = `${pendingPath}.${process.pid}.${Date.now()}.tmp`;
+async function readJsonObject(path) {
   try {
-    await writeFile(temporaryPath, `${JSON.stringify(entries, null, 2)}\n`, {
+    const parsed = JSON.parse(await readFile(path, 'utf8'));
+    return parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+  } catch (error) {
+    if (error?.code === 'ENOENT') return {};
+    throw error;
+  }
+}
+
+/**
+ * SPEC-1699: writes `entries` into the `releases` field of the committed
+ * planu/project.json, preserving every other field already on disk.
+ */
+export async function writePendingReleaseLedger(projectJsonPath, entries) {
+  const project = await readJsonObject(projectJsonPath);
+  const nextProject = { ...project, releases: entries };
+  const temporaryPath = `${projectJsonPath}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    await writeFile(temporaryPath, `${JSON.stringify(nextProject, null, 2)}\n`, {
       encoding: 'utf8',
       flag: 'wx',
       mode: 0o644,
     });
-    await rename(temporaryPath, pendingPath);
+    await rename(temporaryPath, projectJsonPath);
   } catch (error) {
     await rm(temporaryPath, { force: true });
     throw error;