@planu/cli 4.4.1 → 4.4.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.4.2] - 2026-06-05
+
+### Bug Fixes
+- fix: keep spec folders spec.md-only and store evidence externally
+
+
 ## [4.4.1] - 2026-06-04
 
 ### Bug Fixes
@@ -4029,4 +4035,4 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning:
 - Mermaid diagram generation (architecture, sequence, state machine, ER, data flow)
 - Multi-language i18n (EN/ES/PT) for generated specs
 - Clean Architecture (hexagonal) — engine, tools, storage, types layers
-- 10,857 tests with ≥95% coverage
+- 10,857 tests with ≥95% coverage

package/dist/engine/evidence-gates/artifact-reader.js

@@ -1,5 +1,5 @@
 import { readFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join } from 'node:path';
+import { join } from 'node:path';
 import { z } from 'zod';
 import { projectDataDir } from '../../storage/base-store.js';
 const DiscoverySchema = z.object({
@@ -49,20 +49,6 @@ const ContractValidationSchema = z.object({
     reportPath: z.string().optional(),
     summary: z.string().optional(),
 });
-function resolveSpecPath(spec, projectPath) {
-    const specPath = spec.specPath;
-    if (!specPath?.trim()) {
-        return null;
-    }
-    if (isAbsolute(specPath) || !projectPath) {
-        return specPath;
-    }
-    return join(projectPath, specPath);
-}
-function specEvidencePath(spec, filename, projectPath) {
-    const specPath = resolveSpecPath(spec, projectPath);
-    return specPath ? join(dirname(specPath), 'evidence', filename) : null;
-}
 function handoffEvidencePath(projectId, specId, filename) {
     return join(projectDataDir(projectId), 'handoffs', specId, filename);
 }
@@ -108,28 +94,19 @@ export async function readEvidenceArtifacts(args) {
         label: 'Discovery evidence',
         invalidArtifacts,
         schema: DiscoverySchema,
-        paths: [
-            specEvidencePath(args.spec, 'discovery.json', args.projectPath),
-            handoffEvidencePath(args.projectId, args.specId, 'discovery.json'),
-        ],
+        paths: [handoffEvidencePath(args.projectId, args.specId, 'discovery.json')],
     });
     const taskPlan = await readOptional({
         label: 'Task plan evidence',
         invalidArtifacts,
         schema: TaskPlanSchema,
-        paths: [
-            specEvidencePath(args.spec, 'task-plan.json', args.projectPath),
-            handoffEvidencePath(args.projectId, args.specId, 'task-plan.json'),
-        ],
+        paths: [handoffEvidencePath(args.projectId, args.specId, 'task-plan.json')],
     });
     const traceabilityMatrix = await readOptional({
         label: 'Traceability matrix evidence',
         invalidArtifacts,
         schema: TraceabilityMatrixSchema,
-        paths: [
-            specEvidencePath(args.spec, 'traceability-matrix.json', args.projectPath),
-            handoffEvidencePath(args.projectId, args.specId, 'traceability-matrix.json'),
-        ],
+        paths: [handoffEvidencePath(args.projectId, args.specId, 'traceability-matrix.json')],
     });
     const contractValidations = [];
     for (const filename of [
@@ -143,10 +120,7 @@ export async function readEvidenceArtifacts(args) {
             label: filename,
             invalidArtifacts,
             schema: ContractValidationSchema,
-            paths: [
-                specEvidencePath(args.spec, filename, args.projectPath),
-                handoffEvidencePath(args.projectId, args.specId, filename),
-            ],
+            paths: [handoffEvidencePath(args.projectId, args.specId, filename)],
         });
         if (evidence) {
             contractValidations.push(evidence);

package/dist/engine/spec-migrator/planu-canonical-policy.js

@@ -4,7 +4,7 @@ export const PLANU_CANONICAL_POLICY = {
     canonicalRootFiles: ['conventions.json', 'context.md', 'session-context.md', 'session.json'],
     canonicalRootDirs: ['releases', 'specs'],
     canonicalSpecFiles: ['spec.md'],
-    canonicalSpecDirs: ['evidence'],
+    canonicalSpecDirs: [],
     forbiddenHostAssetRootDirs: ['agents', 'skills', 'rules', 'hooks'],
     generatedRuntimePatterns: [
         'planu/index.html',
@@ -71,8 +71,8 @@ export function canonicalContractText() {
         '  specs/',
         '    SPEC-XXX-slug/',
         '      spec.md',
-        '      evidence/',
-        '        *.json',
+        '',
+        'Evidence artifacts are Planu runtime data and are stored outside planu/specs/.',
         '',
         'Host adapters are written outside planu/:',
         '  Claude Code: .claude/agents, .claude/skills, .claude/rules',

package/dist/engine/universal-rules/rules/planu-workflow.js

@@ -28,7 +28,7 @@ For non-trivial specs, Planu blocks lifecycle transitions unless evidence is pre
 | done | Traceability matrix covering every acceptance criterion |
 | done for API/UI/event/MCP work | Passing contract validation evidence |
 
-Evidence can live under \`planu/specs/<spec>/evidence/\` or the external Planu handoff store. Trivial specs may use lightweight evidence, but \`done\` still needs at least one traceability row.
+Evidence lives in the external Planu handoff store, not under \`planu/specs/<spec>/\`. Spec folders remain \`spec.md\`-only. Trivial specs may use lightweight evidence, but \`done\` still needs at least one traceability row.
 
 ## When to use \`facilitate\`
 

package/dist/tools/update-status/evidence-gate.js

@@ -80,7 +80,7 @@ function evidenceGateError(args) {
                     transition: args.transition,
                     issues: args.issues,
                     requiredContractKinds: args.requiredContractKinds,
-                    fixHint: 'Add the missing evidence artifact under planu/specs/<spec>/evidence/ or external Planu project data handoffs/<specId>/, then retry the transition.',
+                    fixHint: 'Add the missing evidence artifact to the external Planu project data handoff store, then retry the transition. Do not create JSON files under planu/specs/<spec>/.',
                 }, null, 2),
             },
         ],
@@ -95,7 +95,7 @@ function evidenceGateError(args) {
                 issues: args.issues,
                 requiredContractKinds: args.requiredContractKinds,
             },
-            fixHint: 'Add discovery.json, task-plan.json, traceability-matrix.json, and contract-validation-*.json as required for this transition.',
+            fixHint: 'Add discovery.json, task-plan.json, traceability-matrix.json, and contract-validation-*.json to the external Planu handoff store as required for this transition. Spec folders remain spec.md-only.',
         },
     };
 }

package/package.json

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

package/planu-native.json

@@ -1,26 +1,20 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.4.1",
+  "version": "4.4.2",
   "packageName": "@planu/cli",
   "modes": {
     "lightweight": {
       "requiresMcp": false,
       "requiresDaemon": false,
-      "hosts": [
-        "codex",
-        "claude-code"
-      ],
+      "hosts": ["codex", "claude-code"],
       "commands": [
         {
           "id": "planu.status",
           "title": "Project status",
           "description": "Show the compact Planu project snapshot without loading the MCP tool graph.",
           "invocation": "planu status",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "handlePlanStatus"
@@ -30,10 +24,7 @@
           "title": "Create spec",
           "description": "Create a new spec through the CLI-backed SDD contract.",
           "invocation": "planu spec create \"<title>\"",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "handleCreateSpec"
@@ -43,10 +34,7 @@
           "title": "List specs",
           "description": "List specs in the current project with optional status/type filters.",
           "invocation": "planu spec list",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "handleListSpecs"
@@ -56,10 +44,7 @@
           "title": "Validate spec",
           "description": "Validate a spec against the current codebase from the native CLI surface.",
           "invocation": "planu spec validate SPEC-001",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "handleValidate"
@@ -69,10 +54,7 @@
           "title": "Audit technical debt",
           "description": "Run the read-only project audit path for lightweight debt checks.",
           "invocation": "planu audit debt",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "handleAudit"
@@ -82,10 +64,7 @@
           "title": "Check release readiness",
           "description": "Check local branch cleanliness and main/develop/release sync readiness.",
           "invocation": "planu release check",
-          "hosts": [
-            "codex",
-            "claude-code"
-          ],
+          "hosts": ["codex", "claude-code"],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "releaseCommand"

package/planu-plugin.json

@@ -2,12 +2,9 @@
   "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.4.1",
+  "version": "4.4.2",
   "icon": "assets/plugin/icon.svg",
-  "command": [
-    "npx",
-    "@planu/cli@latest"
-  ],
+  "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",
   "capabilities": {
     "tools": [
@@ -26,42 +23,17 @@
       "create_skill",
       "skill_search"
     ],
-    "resources": [
-      "planu://specs/list",
-      "planu://specs/{id}",
-      "planu://project/status",
-      "planu://roadmap"
-    ],
-    "prompts": [
-      "create-spec-from-idea",
-      "review-spec-readiness",
-      "generate-implementation-plan"
-    ],
-    "subagents": [
-      "sdd-orchestrator",
-      "spec-challenger",
-      "test-generator"
-    ]
+    "resources": ["planu://specs/list", "planu://specs/{id}", "planu://project/status", "planu://roadmap"],
+    "prompts": ["create-spec-from-idea", "review-spec-readiness", "generate-implementation-plan"],
+    "subagents": ["sdd-orchestrator", "spec-challenger", "test-generator"]
   },
   "compatibility": {
     "minimumHostVersion": "1.0.0",
-    "requiredFeatures": [
-      "mcp-tools",
-      "file-editing"
-    ]
+    "requiredFeatures": ["mcp-tools", "file-editing"]
   },
   "repository": "https://github.com/planu-dev/planu",
   "author": "Planu",
   "license": "MIT",
   "homepage": "https://planu.dev",
-  "keywords": [
-    "sdd",
-    "spec-driven-development",
-    "mcp",
-    "specs",
-    "planning",
-    "ai",
-    "bdd",
-    "tdd"
-  ]
+  "keywords": ["sdd", "spec-driven-development", "mcp", "specs", "planning", "ai", "bdd", "tdd"]
 }