@planu/cli 5.3.1 → 5.3.2

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [5.3.2] - 2026-08-06
+
+### Bug Fixes
+- fix(tools): restore declared bump_spec_version runtime tool (SPEC-1254)
+- fix(handoff): address SPEC-1255 debate review findings
+- fix(handoff): allow test-only specs to produce unblocked handoffs (SPEC-1255)
+
+### Chores
+- chore(planu): redact local paths from SPEC-1392 reproducer
+- chore(planu): SPEC-1254 and SPEC-1255 done with debate-review evidence
+- chore(planu): session checkpoint for debate-protocol batch
+- chore(planu): approve SPEC-1254/1255/1271, file SPEC-1386..1391, add debate-review rule
+- chore(planu): approve SPEC-1206 and SPEC-1250 with reviewer evidence, SPEC-1240 rework feedback
+
+
 ## [5.3.1] - 2026-08-05
 
 ### Bug Fixes

package/README.md

@@ -21,7 +21,7 @@ Planu is a Spec Driven Development stack for AI coding agents: an MCP server and
 - **Local change detection** — observes project changes without requiring a hosted configuration service.
 - **Unified Spec Format** — Requirements and technical details in a single, context-efficient `spec.md`.
 - **Atomic Integrity** — Indestructible writes and **Freeze-on-done** immutability (P0).
-- **28 official MCP tools** for the public SDD surface, with advanced workflows kept in skills, CLI commands, and internal pipelines.
+- **29 official MCP tools** for the public SDD surface, with advanced workflows kept in skills, CLI commands, and internal pipelines.
 - **Multi-agent compatible** — Optimized for Claude Code, Cursor, Windsurf, and Gemini CLI.
 
 ---

package/dist/config/official-sdd-tools.d.ts

@@ -1,4 +1,4 @@
 /** Single editable authority for the official local SDD tool surface. */
-export declare const OFFICIAL_SDD_TOOL_NAMES: readonly ['planu_status', 'session_checkpoint', 'facilitate', 'init_project', 'clarify_requirements', 'create_spec', 'list_specs', 'challenge_spec', 'check_readiness', 'update_status', 'update_status_batch', 'package_handoff', 'validate', 'get_job', 'watch_job', 'cancel_job', 'restart_job', 'reconcile_spec', 'create_rule', 'create_skill', 'skill_search', 'configure_code_graph', 'code_graph_status', 'submit_feedback', 'triage_feedback', 'resolve_feedback', 'sync_feedback', 'feedback_status'];
+export declare const OFFICIAL_SDD_TOOL_NAMES: readonly ['planu_status', 'session_checkpoint', 'facilitate', 'init_project', 'clarify_requirements', 'create_spec', 'list_specs', 'challenge_spec', 'check_readiness', 'update_status', 'update_status_batch', 'package_handoff', 'validate', 'get_job', 'watch_job', 'cancel_job', 'restart_job', 'reconcile_spec', 'create_rule', 'create_skill', 'skill_search', 'configure_code_graph', 'code_graph_status', 'submit_feedback', 'triage_feedback', 'resolve_feedback', 'sync_feedback', 'feedback_status', 'bump_spec_version'];
 export declare function readCanonicalToolNames(): string[];
 //# sourceMappingURL=official-sdd-tools.d.ts.map

package/dist/config/official-sdd-tools.js

@@ -28,6 +28,7 @@ export const OFFICIAL_SDD_TOOL_NAMES = [
     'resolve_feedback',
     'sync_feedback',
     'feedback_status',
+    'bump_spec_version',
 ];
 export function readCanonicalToolNames() {
     return [...OFFICIAL_SDD_TOOL_NAMES];

package/dist/config/registries/hosts/codex.json

@@ -30,7 +30,8 @@
     "triage_feedback",
     "resolve_feedback",
     "sync_feedback",
-    "feedback_status"
+    "feedback_status",
+    "bump_spec_version"
   ],
   "unsupportedTools": ["challenge_spec", "red_team"],
   "restrictedTools": {

package/dist/engine/handoff-packager.d.ts

@@ -16,6 +16,9 @@ export declare function extractCanonicalFileOwnership(content: string): {
     toModify: string[];
     toCreate: string[];
     toTest: string[];
+    /** Test paths as declared, before conflict filtering — used to exclude conflicted
+     *  paths from other categories even though they no longer appear in `toTest`. */
+    toTestDeclared: string[];
     blockers: string[];
 };
 export declare function packageHandoff(spec: Spec, knowledge: ProjectKnowledge): Promise<HandoffPackage>;

package/dist/engine/handoff-packager.js

@@ -174,7 +174,14 @@ export function normalizeChangedFilePath(value) {
 export function extractCanonicalFileOwnership(content) {
     const filesSection = sectionContentAtLevel(content, 'Files', 2);
     if (filesSection === null) {
-        return { present: false, toModify: [], toCreate: [], toTest: [], blockers: [] };
+        return {
+            present: false,
+            toModify: [],
+            toCreate: [],
+            toTest: [],
+            toTestDeclared: [],
+            blockers: [],
+        };
     }
     const blockers = [];
     const addBlocker = (blocker) => {
@@ -215,6 +222,7 @@ export function extractCanonicalFileOwnership(content) {
         toCreate: toCreate.filter((path) => !conflicts.includes(path)),
         toModify: toModify.filter((path) => !conflicts.includes(path)),
         toTest: toTest.filter((path) => !conflicts.includes(path)),
+        toTestDeclared: toTest,
         blockers,
     };
 }
@@ -541,7 +549,7 @@ export async function packageHandoff(spec, knowledge) {
     const canonicalFiles = extractCanonicalFileOwnership(rawSpecContent);
     const canonicalOwnership = extractStrictCanonicalOwnership(ownershipContent);
     const workPlanOwnership = extractFileLevelWorkPlanOwnership(ownershipContent);
-    const testOwnedPaths = new Set(canonicalFiles.toTest);
+    const testOwnedPaths = new Set(canonicalFiles.toTestDeclared);
     const explicitOwnership = canonicalOwnership.present
         ? {
             ...canonicalOwnership,
@@ -574,7 +582,9 @@ export async function packageHandoff(spec, knowledge) {
     }
     const blockers = [
         ...(criteria.length === 0 ? ['Missing BDD acceptance criteria'] : []),
-        ...(toModify.length + toCreate.length === 0 ? ['Missing file ownership / target files'] : []),
+        ...(toModify.length + toCreate.length + canonicalFiles.toTest.length === 0
+            ? ['Missing file ownership / target files']
+            : []),
         ...(operational.testPlan.length === 0 ? ['Missing test plan'] : []),
         ...(operational.risks.length === 0 ? ['Missing risk analysis'] : []),
         ...(operational.ownership.length === 0 ? ['Missing ownership'] : []),
@@ -594,6 +604,7 @@ export async function packageHandoff(spec, knowledge) {
         criteria,
         filesToModify: toModify,
         filesToCreate: toCreate,
+        filesToTest: canonicalFiles.toTest,
         ownership: operational.ownership,
         testPlan: operational.testPlan,
         risks: operational.risks,
@@ -626,6 +637,10 @@ function renderPersistedHandoff(pkg) {
         '## Files To Create',
         ...pkg.filesToCreate.map((filePath) => `- ${filePath}`),
         '',
+        '## Test Files',
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+        ...(pkg.filesToTest ?? []).map((filePath) => `- ${filePath}`),
+        '',
         '## Ownership',
         ...pkg.ownership.map((item) => `- ${item}`),
         '',

package/dist/engine/planu-core.darwin-arm64.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-aarch64-apple-darwin",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-aarch64-apple-darwin",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -17,15 +17,15 @@
   "platform": "darwin",
   "arch": "arm64",
   "libc": null,
-  "artifactSha256": "9496b35ee4f02409d2ba5d5a32b07069f188bbe39b88ab0cc3a350fe476dce2a",
+  "artifactSha256": "d871c6912f7857fedb31608d895a4e80fbf550c18875d307cf068fa966412cb7",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.darwin-arm64.node.sbom.json",
-    "sha256": "1e8ba252b6c59727c3572a4cc086f55900f1dfbe2f8b52ab01efbb566825bf27"
+    "sha256": "93613e9e650a12618265c467fd3007c96ad6c261dcf373ff321d70210c1fdf90"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -34,6 +34,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "shwkLDoc3YH1TfCx9BXJ3sWZFkQnmUw5PF5ix0NUQIJ9zy79t1+97tCj+XxYMHr5/aEdAleDSI14AHARpTb+AQ=="
+    "value": "5A14AujfQn9F0F6V4dCbHhSlzyWfH43wAF+8tSzLXg0t7+yELQKNNH8XqNGSqL9qGHPVxSYeTu1nh/3qQECxBQ=="
   }
 }

package/dist/engine/planu-core.darwin-arm64.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9496b35ee4f02409d2ba5d5a32b07069f188bbe39b88ab0cc3a350fe476dce2a"
+          "content": "d871c6912f7857fedb31608d895a4e80fbf550c18875d307cf068fa966412cb7"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.darwin-x64.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-x86_64-apple-darwin",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-x86_64-apple-darwin",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -17,15 +17,15 @@
   "platform": "darwin",
   "arch": "x64",
   "libc": null,
-  "artifactSha256": "8835b07d4b8a9d96c2c38d5ba7a0ee31f556a68bab2c49f3c397d813a0b467e9",
+  "artifactSha256": "2e160dbfb5616b778ea6bc1b85b6663ae9618c664824498e0089a3b82353923e",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.darwin-x64.node.sbom.json",
-    "sha256": "cd3fde2fa5c346e6f6b4ee377eec73e63ac20ae85d6793769c33f49ce884e181"
+    "sha256": "b4aa09e9d3bc3d5f4d0d80953f4d32389aa40fafabcac6895ebd296c4a2f6873"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -34,6 +34,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "BQIqLTSOP1v1gEBU6wBRH9d2G+81wpqFTtpxI1ObAfMEv22/HmXMhDieRK7ijSdhaJ0OwRE3qprfFqbYJ30pAg=="
+    "value": "xN3AVrLnDNmagcrLzUS+voWOuOHZhY4+i+nfep/66x39IdztoQEqh/jF1H/P5qxnIwGFuSztuCS3cG0pAsRqCw=="
   }
 }

package/dist/engine/planu-core.darwin-x64.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "8835b07d4b8a9d96c2c38d5ba7a0ee31f556a68bab2c49f3c397d813a0b467e9"
+          "content": "2e160dbfb5616b778ea6bc1b85b6663ae9618c664824498e0089a3b82353923e"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.linux-arm64-gnu.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-aarch64-unknown-linux-gnu",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-aarch64-unknown-linux-gnu",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "linux",
   "arch": "arm64",
   "libc": "glibc",
-  "artifactSha256": "aa7ba305602ab0cc30ed8859ae7b8aea49fc319161d583a84a39c43fc3080b2d",
+  "artifactSha256": "c688e223eaed377810f13b4fb59b95269c6ac386e9e22122012322aa20b4119f",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.linux-arm64-gnu.node.sbom.json",
-    "sha256": "70863618fef07e482c7e5b70b7ec0f2eb86aeabb3639b458364d99be726d02b3"
+    "sha256": "05e6cde28bdf46282c2024bec9491908e67cf0875a1043a879533fe26e2acf6c"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "kwHa3R8NyX8dZ2Bb2+5+fMVTipEy8C0oHJ0P0LadjVhd5KJaXqfLPIu6a+rUkq9v/j1AUievoDE/BhgN8ukzBA=="
+    "value": "evvZQIYp2VmYUaaLu8nK5yLjTSms9hMRYoF4zM3qsCHwLLKRThOR+KrFgZ9ySZk6WRWx9CE8F/c+pKFRi/7nBg=="
   }
 }

package/dist/engine/planu-core.linux-arm64-gnu.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "aa7ba305602ab0cc30ed8859ae7b8aea49fc319161d583a84a39c43fc3080b2d"
+          "content": "c688e223eaed377810f13b4fb59b95269c6ac386e9e22122012322aa20b4119f"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.linux-arm64-musl.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-aarch64-unknown-linux-musl",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-aarch64-unknown-linux-musl",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "linux",
   "arch": "arm64",
   "libc": "musl",
-  "artifactSha256": "d767b6ef1ec48f8bd745e02d39a53ef0efa052a15c3370ba65d3365e817cf454",
+  "artifactSha256": "ffe6b8382aded44408171166a385d31d25fa6a95919c14ec73ca5197351da8ac",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.linux-arm64-musl.node.sbom.json",
-    "sha256": "cf84110894384279fa1712a7b582767dd1dbebc72c1f4d3b53937d45109edc19"
+    "sha256": "6612f0831ad90d8d69aa88bbc53658d5dc55d5ff3e337e4253cb8943c7471aa5"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "0jHhH3Ng3cOPbyiCfBZqdMVbp7i3tP7JnViKwaJqEF65k1M4NTootCYDahfaxcOPQbdyywqgoGBn9D/c8x6dAA=="
+    "value": "3AhxDy080JazcjbYv9SH3w6tpj4iKKLlhI95pAy1/VQ8c9iDEDLmTfFaQv4R1FXjEAUSqZ/hYZEAQ0A3XpQPCA=="
   }
 }

package/dist/engine/planu-core.linux-arm64-musl.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d767b6ef1ec48f8bd745e02d39a53ef0efa052a15c3370ba65d3365e817cf454"
+          "content": "ffe6b8382aded44408171166a385d31d25fa6a95919c14ec73ca5197351da8ac"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.linux-x64-gnu.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-x86_64-unknown-linux-gnu",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-x86_64-unknown-linux-gnu",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "linux",
   "arch": "x64",
   "libc": "glibc",
-  "artifactSha256": "121e0cde6094d4812a1003f5e8d271c73180f87253d242c0ef2a3ce020114fb2",
+  "artifactSha256": "c1aeb15763bf3ee0b2d37ac694340fe65cfc106f95f6813c2e188c099c826013",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.linux-x64-gnu.node.sbom.json",
-    "sha256": "2fe67e0205c5a0893ab618f92cbe53b862b286018e30ebd93a4bb35570d9e53f"
+    "sha256": "cd651b3c7af8a03fb3725d6342ee679dfef8272b65bc28e9f523dbfb88fa0ed8"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "PANQkfk6g7pqHmExCM2voq4U2WCuJX1cbaWm8K4T/QCPNzWE4TmGoG5vQN4k80VCIyjTFz5IA5Ope+XmNhnZCA=="
+    "value": "T9ypzN3DZ+ks4rQIjeuMKqxHHxGc7Qm/ep9zyVEsU6BvzVjOaiZijDkJXsiaNS8AqfrZkmnr6I/HtWNCqiqjCw=="
   }
 }

package/dist/engine/planu-core.linux-x64-gnu.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "121e0cde6094d4812a1003f5e8d271c73180f87253d242c0ef2a3ce020114fb2"
+          "content": "c1aeb15763bf3ee0b2d37ac694340fe65cfc106f95f6813c2e188c099c826013"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.linux-x64-musl.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-x86_64-unknown-linux-musl",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-x86_64-unknown-linux-musl",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "linux",
   "arch": "x64",
   "libc": "musl",
-  "artifactSha256": "8bca20fd7b4458f07f9993babe7ae9417bbce0f8dadac3cd6e723bfe5162e405",
+  "artifactSha256": "d44f03ecaed34427ca6ed682ce695f432d25eac3366fc5e779cfa78fe39d504b",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.linux-x64-musl.node.sbom.json",
-    "sha256": "d6638d7152102d2ba32851fd2df269e4e2a2a2ddc5fc788f4602c0dd22c0ae42"
+    "sha256": "86d8219cdb5f5205d458cfa205ef619f68997f7a414f04a3a30f53704650b488"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "vZ9UA5RzHSuz+/P18RorLLyH92erubxrJwq4nW766XwepyzlM0m8ol3QYfyrvYvHy4oP9ptee40YvsmexCQcBg=="
+    "value": "O6Ay8rgviCK8bLJJbkQAsX9msRJoCxB2jkgpY6+v+7oyVohsZ3hKly1kFnQ35WRbibF4l2TBchxZI7IlKbAgCg=="
   }
 }

package/dist/engine/planu-core.linux-x64-musl.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "8bca20fd7b4458f07f9993babe7ae9417bbce0f8dadac3cd6e723bfe5162e405"
+          "content": "d44f03ecaed34427ca6ed682ce695f432d25eac3366fc5e779cfa78fe39d504b"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.win32-arm64-msvc.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-aarch64-pc-windows-msvc",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-aarch64-pc-windows-msvc",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "win32",
   "arch": "arm64",
   "libc": null,
-  "artifactSha256": "dbc7bc2092e9280e9cbd9c18d472acc57b171fb51b34ac403d36858e460a5558",
+  "artifactSha256": "9a10e393e1b0aad7856de5973ea8efb018513bcb4e2c47ddb013be9bda7e3bda",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.win32-arm64-msvc.node.sbom.json",
-    "sha256": "ac0dfa26e7466da91c35ffff0b44eddfe0e871fb4ba4e2527d74b7e6e4ad2166"
+    "sha256": "38f38493f6013f50daff7808dcbbab81133b141bce61cba430e7a07fe9a89fc2"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "dXDAyNUV0maapcjOspyRQByaq39viQeMYq7iypA8UC9cUqcvOa33hojUp056RIkG+9dtu4wTFGO1GzF2oPDNCQ=="
+    "value": "ktHCgTSn2Br8NhGf6Pjz5fCP38a9sGluOqs617pwRXymMiUBu2GNjvyp7mLqk2gY/L8KAbzvF6FHoqEVDzb9AA=="
   }
 }

package/dist/engine/planu-core.win32-arm64-msvc.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "dbc7bc2092e9280e9cbd9c18d472acc57b171fb51b34ac403d36858e460a5558"
+          "content": "9a10e393e1b0aad7856de5973ea8efb018513bcb4e2c47ddb013be9bda7e3bda"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/engine/planu-core.win32-x64-msvc.node.manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
-  "cliVersion": "5.3.1",
-  "engineVersion": "5.3.1",
-  "buildId": "1-5.3.1-x86_64-pc-windows-msvc",
+  "cliVersion": "5.3.2",
+  "engineVersion": "5.3.2",
+  "buildId": "1-5.3.2-x86_64-pc-windows-msvc",
   "protocolAbi": 1,
   "capabilityAbi": 2,
   "nodeApiAbi": 4,
@@ -16,15 +16,15 @@
   "platform": "win32",
   "arch": "x64",
   "libc": null,
-  "artifactSha256": "5d65e9be51ed1f1a391064fbf8892d3ac570c774854b36487d430ee7e7b0b5c8",
+  "artifactSha256": "4a41383ea29c9dd64a668143e206b4af1859ba6f35b79fdeb7ea8f812113811c",
   "sbom": {
     "format": "CycloneDX-1.5",
     "path": "planu-core.win32-x64-msvc.node.sbom.json",
-    "sha256": "6563cbe0310464b49325b14f1e7e17a94e476496dd9bd1f522dafabac5da5d18"
+    "sha256": "f96dbf4fd6d9cab1aa9b90057325829de42e018dfa2bf4220c78c9bbfab0f9c5"
   },
   "provenance": {
     "builder": "scripts/build-rust-local.sh",
-    "sourceCommit": "cff22e20c8f95a4081485b852254fa5fbe1532ef",
+    "sourceCommit": "30226657c1e66411b6ff233c2ea82e47573d533a",
     "sourceTreeDirty": false,
     "sourceDateEpoch": 1,
     "rustToolchain": "rustc 1.95.0 (59807616e 2026-04-14)",
@@ -33,6 +33,6 @@
   "signature": {
     "algorithm": "Ed25519",
     "keyId": "e2ee765cb5ad9fbdc433ece332bce26d746d5e350b3acde0721a4c8c6337ff7b",
-    "value": "z2Hd9RD31bHF9HmmWsymR4XVqxLPiNSrdCvtWBUXEEBlKdk8rEde8ZPd3BEJCeEsdX0akECDyN7LenOYuFirAQ=="
+    "value": "vZ49hewESnK5idVecQPyBFUD+GPcbfa0ihzAKkxuqBSsyVEWNFGaGU4c/rzvXD6D3SKnApFEM3vZ9D2uCfSjDA=="
   }
 }

package/dist/engine/planu-core.win32-x64-msvc.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.3.1",
+      "bom-ref": "pkg:cargo/planu-core@5.3.2",
       "type": "library",
       "name": "planu-core",
-      "version": "5.3.1",
+      "version": "5.3.2",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "5d65e9be51ed1f1a391064fbf8892d3ac570c774854b36487d430ee7e7b0b5c8"
+          "content": "4a41383ea29c9dd64a668143e206b4af1859ba6f35b79fdeb7ea8f812113811c"
         }
       ]
     }
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.3.1",
+      "ref": "pkg:cargo/planu-core@5.3.2",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",

package/dist/tools/package-handoff.d.ts

@@ -1,3 +1,4 @@
-import type { ToolResult, PackageHandoffInput } from '../types/index.js';
+import type { ToolResult, PackageHandoffInput, HandoffPackage } from '../types/index.js';
+export declare function formatHandoff(pkg: HandoffPackage): string;
 export declare function handlePackageHandoff(args: PackageHandoffInput): Promise<ToolResult>;
 //# sourceMappingURL=package-handoff.d.ts.map

package/dist/tools/package-handoff.js

@@ -8,7 +8,7 @@ import { appendTransitionEvent } from '../storage/transition-log.js';
 import { formatProjectGraphContext, queryProjectGraphSlice, } from '../engine/project-graph/index.js';
 import { analyzeMinimalImplementation, loadMinimalImplementationPolicy, } from '../engine/minimality/index.js';
 // ── Formatting helpers ───────────────────────────────────────────────────────
-function formatHandoff(pkg) {
+export function formatHandoff(pkg) {
     const lines = [];
     lines.push(`# Implementation Handoff Package — ${pkg.specId}`);
     lines.push('');
@@ -59,6 +59,19 @@ function formatHandoff(pkg) {
         lines.push('_(None identified)_');
     }
     lines.push('');
+    lines.push('## Test Files');
+    lines.push('');
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+    const filesToTest = pkg.filesToTest ?? [];
+    if (filesToTest.length > 0) {
+        for (const f of filesToTest) {
+            lines.push(`- ${f}`);
+        }
+    }
+    else {
+        lines.push('_(None identified)_');
+    }
+    lines.push('');
     lines.push('## Ownership');
     lines.push('');
     if (pkg.ownership.length > 0) {
@@ -152,7 +165,9 @@ function buildHandoffSummaryText(args) {
     if (args.pkg.contextHash) {
         lines.push(`Context Hash: ${args.pkg.contextHash}`);
     }
-    lines.push(`Counts: ${String(args.pkg.criteria.length)} criteria, ${String(args.pkg.filesToModify.length)} files to modify, ${String(args.pkg.filesToCreate.length)} files to create, ${String(args.pkg.testPlan.length)} tests, ${String(args.pkg.risks.length)} risks.`);
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+    const filesToTestCount = (args.pkg.filesToTest ?? []).length;
+    lines.push(`Counts: ${String(args.pkg.criteria.length)} criteria, ${String(args.pkg.filesToModify.length)} files to modify, ${String(args.pkg.filesToCreate.length)} files to create, ${String(filesToTestCount)} files to test, ${String(args.pkg.testPlan.length)} tests, ${String(args.pkg.risks.length)} risks.`);
     if (args.topBlockers.length > 0) {
         lines.push(`Top blockers: ${args.topBlockers.join('; ')}`);
     }
@@ -238,7 +253,8 @@ async function buildHandoffTokenWasteReport(pkg, knowledge, spec) {
         const context = analyzeContextPreflight({
             action: 'package_handoff',
             policy,
-            candidates: [...pkg.filesToModify, ...pkg.filesToCreate].map((path) => ({
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+            candidates: [...pkg.filesToModify, ...pkg.filesToCreate, ...(pkg.filesToTest ?? [])].map((path) => ({
                 path,
                 reason: 'Referenced by handoff package.',
             })),
@@ -297,7 +313,8 @@ async function buildMinimalImplementationReport(pkg, knowledge, spec, handoffTex
             specId: spec.id,
             specRisk: spec.risk,
             handoffText,
-            files: [...pkg.filesToModify, ...pkg.filesToCreate].map((path) => ({ path, content: path })),
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+            files: [...pkg.filesToModify, ...pkg.filesToCreate, ...(pkg.filesToTest ?? [])].map((path) => ({ path, content: path })),
             evidence,
         });
     }
@@ -421,6 +438,8 @@ export async function handlePackageHandoff(args) {
                 criteria: pkgWithScore.criteria.length,
                 filesToModify: pkgWithScore.filesToModify.length,
                 filesToCreate: pkgWithScore.filesToCreate.length,
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- compat guard: callers may construct a HandoffPackage object predating this field
+                filesToTest: (pkgWithScore.filesToTest ?? []).length,
                 ownership: pkgWithScore.ownership.length,
                 testPlan: pkgWithScore.testPlan.length,
                 risks: pkgWithScore.risks.length,

package/dist/tools/register-sdd-tools.js

@@ -11,6 +11,7 @@ import { safe } from './safe-handler.js';
 import { handleCreateRule } from './create-rule.js';
 import { handleCreateSkill } from './create-skill.js';
 import { handleReconcileUniversalRules } from './reconcile-universal-rules.js';
+import { registerBumpSpecVersionTool } from './bump-spec-version.js';
 import { registerPrompts } from '../prompts/index.js';
 import { OFFICIAL_SDD_TOOL_NAMES } from './tool-registry/inventory.js';
 export { OFFICIAL_SDD_TOOL_NAMES } from './tool-registry/inventory.js';
@@ -110,6 +111,7 @@ export function registerSddTools(server) {
     registerOnly(server, OFFICIAL_SDD_TOOL_SET, registerQualityComplianceGroupTools);
     registerOnly(server, OFFICIAL_SDD_TOOL_SET, registerInfraGroupTools);
     registerOnly(server, OFFICIAL_SDD_TOOL_SET, registerUniversalRulesTools);
+    registerOnly(server, OFFICIAL_SDD_TOOL_SET, registerBumpSpecVersionTool);
     registerPrompts(server);
 }
 //# sourceMappingURL=register-sdd-tools.js.map

package/dist/types/readiness.d.ts

@@ -32,6 +32,7 @@ export interface HandoffPackage {
     criteria: string[];
     filesToModify: string[];
     filesToCreate: string[];
+    filesToTest: string[];
     ownership: string[];
     testPlan: string[];
     risks: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.3.1",
+  "version": "5.3.2",
   "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",
@@ -35,14 +35,14 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "5.3.1",
-    "@planu/core-darwin-x64": "5.3.1",
-    "@planu/core-linux-arm64-gnu": "5.3.1",
-    "@planu/core-linux-arm64-musl": "5.3.1",
-    "@planu/core-linux-x64-gnu": "5.3.1",
-    "@planu/core-linux-x64-musl": "5.3.1",
-    "@planu/core-win32-arm64-msvc": "5.3.1",
-    "@planu/core-win32-x64-msvc": "5.3.1"
+    "@planu/core-darwin-arm64": "5.3.2",
+    "@planu/core-darwin-x64": "5.3.2",
+    "@planu/core-linux-arm64-gnu": "5.3.2",
+    "@planu/core-linux-arm64-musl": "5.3.2",
+    "@planu/core-linux-x64-gnu": "5.3.2",
+    "@planu/core-linux-x64-musl": "5.3.2",
+    "@planu/core-win32-arm64-msvc": "5.3.2",
+    "@planu/core-win32-x64-msvc": "5.3.2"
   },
   "engines": {
     "node": ">=24.0.0"

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "5.3.1",
+  "version": "5.3.2",
   "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": "5.3.1",
+  "version": "5.3.2",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",
@@ -35,7 +35,8 @@
       "triage_feedback",
       "resolve_feedback",
       "sync_feedback",
-      "feedback_status"
+      "feedback_status",
+      "bump_spec_version"
     ],
     "resources": ["planu://specs/list", "planu://specs/{id}", "planu://project/status", "planu://roadmap"],
     "prompts": ["create-spec-from-idea", "review-spec-readiness", "generate-implementation-plan"],