@planu/cli 5.3.58 → 5.3.60

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## [5.3.60] - 2026-08-26
+
+### Bug Fixes
+- fix(SPEC-1634): normalize scenario test-link descriptions across colon spacing
+- fix(SPEC-1634): accept path-shaped colon forms in scenario tests entries
+- fix(SPEC-1633): point the documented human validation gate at validate:full
+
+### Refactoring
+- refactor(SPEC-1633): dedupe validate against check:strict in the release plan
+
+### Chores
+- chore(planu): close SPEC-1633 and SPEC-1634
+- chore(SPEC-1633,SPEC-1634): normalize file ownership and risk sections for the handoff gate
+- chore(SPEC-1633,SPEC-1634): approve both specs with challenge resolution
+
+
+## [5.3.59] - 2026-08-26
+
+### Bug Fixes
+- fix(SPEC-1631): report graph coverage as unavailable instead of zero gaps
+
+### Chores
+- chore(planu): close SPEC-1631
+- chore(planu): record SPEC-1631 implementing transition
+
+
 ## [5.3.58] - 2026-08-26
 
 ### Bug Fixes

package/README.md

@@ -114,9 +114,9 @@ planu/                     # Portable, version-controlled project contract
 
 ```bash
 pnpm install       # Install dependencies
-pnpm build         # Compile TS + Build Rust bridge
+pnpm build         # Compile TypeScript
 pnpm dev           # Watch mode
-pnpm validate      # Canonical local validation contract
+pnpm validate:full # Build plus every static gate plus the full suite
 pnpm check:strict  # Extended local quality gates
 pnpm test          # Run the full test suite
 pnpm release:local # Local-first release flow when shipping

package/dist/.planu-build.json

@@ -1 +1 @@
-{"schemaVersion":1,"commit":"27eba0edeec0ce821f730eebbbbd999f5a1725b6"}
+{"schemaVersion":1,"commit":"178163df95059021ac364f72b65da84d4a145c66"}

package/dist/engine/validator/spec-compliance-runner.d.ts

@@ -5,6 +5,7 @@ export interface ScenarioTestLink {
     line?: number;
     runner?: string;
     config?: string;
+    description?: string;
 }
 export interface ScenarioStep {
     keyword: string;

package/dist/engine/validator/spec-compliance-runner.js

@@ -17,6 +17,35 @@ export class ComplianceCommandTerminalError extends Error {
         this.name = 'ComplianceCommandTerminalError';
     }
 }
+const WINDOWS_DRIVE_PATH = /^[A-Za-z]:[\\/]/;
+const PATH_SHAPED = /[/\\]/;
+const FILE_EXTENSION = /\.[A-Za-z0-9]+$/;
+function isPathShapedSegment(segment) {
+    return segment.length > 0 && (PATH_SHAPED.test(segment) || FILE_EXTENSION.test(segment));
+}
+function parseTestLinkString(raw) {
+    if (WINDOWS_DRIVE_PATH.test(raw)) {
+        return { path: raw };
+    }
+    const colonIndex = raw.indexOf(':');
+    if (colonIndex === -1) {
+        return { path: raw };
+    }
+    const path = raw.slice(0, colonIndex);
+    if (!isPathShapedSegment(path)) {
+        return null;
+    }
+    const remainder = raw.slice(colonIndex + 1);
+    const remainderColonIndex = remainder.indexOf(':');
+    const linePart = remainderColonIndex === -1 ? remainder : remainder.slice(0, remainderColonIndex);
+    if (/^\d+$/.test(linePart)) {
+        const description = remainderColonIndex === -1 ? undefined : remainder.slice(remainderColonIndex + 1).trim();
+        const line = Number.parseInt(linePart, 10);
+        return description ? { path, line, description } : { path, line };
+    }
+    const description = remainder.trim();
+    return description ? { path, description } : { path };
+}
 // eslint-disable-next-line complexity, max-lines-per-function -- parses the supported scenario YAML subset without executing it
 export function parseFrontmatterScenarios(raw) {
     const match = /^---\n([\s\S]*?)\n---\n/.exec(raw);
@@ -105,9 +134,10 @@ export function parseFrontmatterScenarios(raw) {
             continue;
         }
         const stringMatch = /^\s+-\s+["']?([^'":\s][^'"]*?)["']?\s*$/.exec(trimmed);
-        if (stringMatch?.[1] && !stringMatch[1].includes(':')) {
+        const testLink = stringMatch?.[1] ? parseTestLinkString(stringMatch[1]) : null;
+        if (testLink) {
             currentScenario.tests ??= [];
-            currentScenario.tests.push({ path: stringMatch[1] });
+            currentScenario.tests.push(testLink);
             continue;
         }
         const metadataMatch = /^\s+(line|runner|config):\s*["']?(.+?)["']?\s*$/.exec(trimmed);

package/dist/tools/schemas/validate-output-schema.d.ts

@@ -19,6 +19,10 @@ export declare const ValidateCompletionOutputSchema: {
             failing: "failing";
             passing: "passing";
         }>;
+        graphAvailability: z.ZodEnum<{
+            available: "available";
+            unavailable: "unavailable";
+        }>;
     }, z.core.$strip>;
     counts: z.ZodObject<{
         matches: z.ZodNumber;
@@ -198,6 +202,10 @@ export declare const ValidateCompletionOutputSchema: {
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     graphCoverage: z.ZodObject<{
+        availability: z.ZodEnum<{
+            available: "available";
+            unavailable: "unavailable";
+        }>;
         gapsCount: z.ZodNumber;
         gapsTop5: z.ZodArray<z.ZodString>;
         freshness: z.ZodOptional<z.ZodObject<{

package/dist/tools/schemas/validate-output-schema.js

@@ -40,6 +40,7 @@ export const ValidateCompletionOutputSchema = {
         failed: z.number(),
         total: z.number(),
         status: z.enum(['passing', 'failing']),
+        graphAvailability: z.enum(['available', 'unavailable']),
     }),
     counts: z.object({
         matches: z.number(),
@@ -162,6 +163,7 @@ export const ValidateCompletionOutputSchema = {
     })
         .optional(),
     graphCoverage: z.object({
+        availability: z.enum(['available', 'unavailable']),
         gapsCount: z.number(),
         gapsTop5: z.array(z.string()),
         freshness: z

package/dist/tools/validate-graph-coverage.js

@@ -1,9 +1,7 @@
 // tools/validate-graph-coverage.ts — Graph coverage helpers for validate.
+import { reportClassifiedDegradation } from '../errors/classified-degradation.js';
 import { queryProjectGraphSlice } from '../engine/project-graph/index.js';
 function graphCoverageGaps(slice) {
-    if (slice === null) {
-        return [];
-    }
     const criteria = slice.nodes.filter((node) => node.type === 'criterion');
     return criteria
         .filter((criterion) => {
@@ -14,15 +12,29 @@ function graphCoverageGaps(slice) {
         .slice(0, 10);
 }
 export async function buildGraphCoverageReport(args) {
-    const graphSlice = await queryProjectGraphSlice(args).catch(() => null);
+    let graphSlice;
+    try {
+        graphSlice = await queryProjectGraphSlice(args);
+    }
+    catch (error) {
+        reportClassifiedDegradation('GRAPH_COVERAGE_UNAVAILABLE', error);
+        graphSlice = null;
+    }
+    if (graphSlice === null) {
+        return { availability: 'unavailable', gaps: [], compactNodes: 0, compactEdges: 0 };
+    }
     return {
-        freshness: graphSlice?.freshness,
+        availability: 'available',
+        freshness: graphSlice.freshness,
         gaps: graphCoverageGaps(graphSlice),
-        compactNodes: graphSlice?.nodes.length ?? 0,
-        compactEdges: graphSlice?.edges.length ?? 0,
+        compactNodes: graphSlice.nodes.length,
+        compactEdges: graphSlice.edges.length,
     };
 }
 export function formatGraphCoverageText(report) {
+    if (report.availability === 'unavailable') {
+        return '\nGRAPH     unavailable (project graph unreadable)';
+    }
     return report.gaps.length > 0
         ? `\nGRAPH     ${String(report.gaps.length)} graph-backed coverage gap(s)`
         : '';

package/dist/tools/validate.js

@@ -583,7 +583,7 @@ export async function executeValidate(args, server, onProgress) {
     });
     const graphText = formatGraphCoverageText(graphCoverage);
     // SPEC-512: Compact structuredContent — essential fields only at top level
-    const compactSummary = buildCompactSummary(specId, effectiveResult.score === null ? null : effectiveScore, passedCount, failedCount + (qualityGateSummary.passed ? 0 : 1), totalCriteria);
+    const compactSummary = buildCompactSummary(specId, effectiveResult.score === null ? null : effectiveScore, passedCount, failedCount + (qualityGateSummary.passed ? 0 : 1), totalCriteria, graphCoverage.availability);
     const structuredBase = buildValidateStructuredContent({
         specId,
         title: spec.title,
@@ -718,7 +718,7 @@ function buildEffectiveValidationResult(result, specCompliance) {
         indeterminate: executableCoverage.indeterminate,
     };
 }
-function buildCompactSummary(specId, score, passedCount, failedCount, totalCriteria) {
+function buildCompactSummary(specId, score, passedCount, failedCount, totalCriteria, graphAvailability) {
     return {
         specId,
         score,
@@ -726,6 +726,7 @@ function buildCompactSummary(specId, score, passedCount, failedCount, totalCrite
         failed: failedCount,
         total: totalCriteria,
         status: failedCount === 0 ? 'passing' : 'failing',
+        graphAvailability,
     };
 }
 function buildValidateStructuredContent(args) {
@@ -859,10 +860,10 @@ function buildValidateStructuredContent(args) {
             }
             : undefined,
         graphCoverage: {
+            availability: args.graphCoverage.availability,
             gapsCount: args.graphCoverage.gaps.length,
             gapsTop5: args.graphCoverage.gaps.slice(0, 5),
             freshness: args.graphCoverage.freshness,
-            summary: args.graphCoverage.summary,
         },
         suggestionsTop5: args.suggestions.slice(0, 5),
     });

package/dist/types/project-knowledge-graph.d.ts

@@ -198,6 +198,7 @@ export interface ProjectGraphQueryInput {
     maxEdges?: number;
 }
 export interface GraphCoverageReport {
+    availability: 'available' | 'unavailable';
     freshness?: ProjectGraphFreshness;
     gaps: string[];
     compactNodes: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.3.58",
+  "version": "5.3.60",
   "description": "Planu — MCP Server for Spec Driven Development. Cross-platform (Linux/macOS/Windows, x64/arm64).",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "generate:host-tool-registry": "node scripts/generate-host-tool-registry.mjs",
     "release:local": "bash scripts/release-local.sh",
     "release:publish": "bash scripts/release-local.sh --publish",
-    "build": "pnpm clean && pnpm build:ts",
+    "build": "pnpm build:ts",
     "build:ts": "pnpm clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node scripts/copy-runtime-assets.mjs",
     "build:obfuscated": "pnpm build && node scripts/obfuscate.mjs",
     "dev": "tsc --watch",
@@ -86,7 +86,8 @@
     "prepublishOnly": "bash scripts/prepublish-guard.sh",
     "prepack": "pnpm build:ts && pnpm package:size",
     "test:debug": "vitest run --inspect-brk --single-thread",
-    "validate": "pnpm build && pnpm typecheck && pnpm verify:typescript-migration && pnpm lint:gate && pnpm format:check && pnpm test:release-gate",
+    "validate": "pnpm build && pnpm verify:typescript-migration",
+    "validate:full": "pnpm build && pnpm typecheck && pnpm verify:typescript-migration && pnpm lint:gate && pnpm format:check && pnpm test:coverage",
     "docker:build": "docker build -t planu .",
     "docker:run": "docker compose up",
     "publish:blog": "node scripts/publish-blog.mjs",

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.58",
+  "version": "5.3.60",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",