@planu/cli 5.3.58 → 5.3.59

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [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/dist/.planu-build.json

@@ -1 +1 @@
-{"schemaVersion":1,"commit":"27eba0edeec0ce821f730eebbbbd999f5a1725b6"}
+{"schemaVersion":1,"commit":"8ad23a1b29d2ffe8c44122aba263f9a6e9577d80"}

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