@planu/cli 4.10.5 → 4.10.6

package/dist/tools/validate.js

@@ -22,13 +22,13 @@ import { checkPlanuUncommittedChanges, runAssuranceGates } from './validate-assu
 // Re-export for external use (SPEC-018)
 export { validateContractCompliance };
 // SPEC-595: server? param enables elicitation on failures
+// eslint-disable-next-line max-lines-per-function -- validate orchestrates many existing gates in one handler.
 export async function handleValidate(args, server) {
     const { specId } = args;
     const projectId = resolveProjectId(args);
     if (!projectId) {
         return missingProjectIdError;
     }
-    // 1. Load spec
     const spec = await specStore.getSpec(projectId, specId);
     if (!spec) {
         return {
@@ -42,7 +42,6 @@ export async function handleValidate(args, server) {
             },
         };
     }
-    // 2. Load project knowledge for project path
     const knowledge = await knowledgeStore.getKnowledge(projectId);
     if (!knowledge) {
         return {
@@ -66,18 +65,13 @@ export async function handleValidate(args, server) {
     if (strictLayoutError !== null) {
         return strictLayoutError;
     }
-    // 3. Run validation engine
     const result = await validateSpec(spec, projectPath);
     const graphCoverage = await buildGraphCoverageReport({ projectId, projectPath, specId });
-    // 4. Generate DoR and DoD checklists
     const dor = generateDoR(spec);
     const dod = await generateDoD(spec, result, undefined, projectPath);
-    // 5. Compute implementation quality score from validated files (SPEC-010 S47)
     const implementationQualityScore = calcQualityScore(result.qualityIssues);
     const auditedFiles = [...new Set(result.qualityIssues.map((i) => i.file))];
-    // 6. SPEC-190: Convention compliance check
     const { conventionViolations, regressionDetected } = await scanProjectConventions(projectId, projectPath);
-    // 7. Lint check (best-effort — non-blocking)
     const lintCheck = runLintCheck(projectPath, knowledge.lintCommand ?? null);
     const assuranceGates = runAssuranceGates(projectPath);
     const minimalityReport = await buildMinimalityReport({
@@ -108,7 +102,6 @@ export async function handleValidate(args, server) {
         minimalityBlocked: minimalityReport?.blocked === true,
         score: result.score,
     });
-    // 8. Build output
     const output = {
         specId,
         title: spec.title,
@@ -239,13 +232,6 @@ export async function handleValidate(args, server) {
     if (minimalityReport?.blocked) {
         suggestions.push(`${minimalityReport.findings.filter((finding) => finding.blocksDone).length} blocking minimality finding(s) detected. Remove avoidable complexity or record accepted debt before marking done.`);
     }
-    const outputWithSuggestions = compactObj({
-        ...output,
-        suggestions: suggestions.length > 0 ? suggestions : undefined,
-    });
-    // `lintCheck.output` is part of the MCP output contract. Keep it even when
-    // empty because compactObj removes empty strings recursively.
-    outputWithSuggestions.lintCheck = lintCheck;
     // SPEC-012: Dispatch feedback event for auto-improvement loop (best-effort)
     void dispatchFeedbackEvent(projectId, {
         type: 'validate',
@@ -305,7 +291,26 @@ export async function handleValidate(args, server) {
     const graphText = formatGraphCoverageText(graphCoverage);
     // SPEC-512: Compact structuredContent — essential fields only at top level
     const compactSummary = buildCompactSummary(specId, result.score === null ? null : effectiveScore, passedCount, failedCount + (qualityGateSummary.passed ? 0 : 1), totalCriteria);
-    const structuredBase = { ...outputWithSuggestions, summary: compactSummary, indeterminate };
+    const structuredBase = buildValidateStructuredContent({
+        specId,
+        title: spec.title,
+        score: result.score === null ? null : effectiveScore,
+        compactSummary,
+        result,
+        indeterminate,
+        dor,
+        dod,
+        qualityIssues: output.qualityIssues,
+        implementationQualityScore: output.implementationQualityScore,
+        conventionCompliance: output.conventionCompliance,
+        lintCheck,
+        assuranceGates,
+        qualityGateSummary,
+        validationReport,
+        minimalityReport,
+        graphCoverage,
+        suggestions,
+    });
     // SPEC-595: Elicit next action when validation fails and a server is available
     if (server !== undefined && failedCount > 0) {
         const { field, property } = buildEnumSchema('action', ['re-implement', 'ignore', 'mark-manual'], ['Fix failing criteria (Recommended)', 'Ignore failures', 'Mark as manually reviewed'], 'Next action', 're-implement');
@@ -400,6 +405,122 @@ function buildCompactSummary(specId, score, passedCount, failedCount, totalCrite
         status: failedCount === 0 ? 'passing' : 'failing',
     };
 }
+function buildValidateStructuredContent(args) {
+    const failedDorItems = args.dor.items.filter((item) => item.status === 'failed').slice(0, 5);
+    const failedDodItems = args.dod.items
+        .filter((item) => item.required === true && item.status !== 'passed')
+        .slice(0, 5);
+    const failedGates = args.validationReport.gates.filter((gate) => !gate.passed);
+    const minimalityBlockingFindings = args.minimalityReport?.findings.filter((finding) => finding.blocksDone) ?? [];
+    const blockers = [
+        ...args.result.missing.map((missing) => `missing: ${missing}`),
+        ...args.indeterminate.map((item) => `indeterminate: ${item}`),
+        ...args.qualityGateSummary.failures.map((failure) => `gate: ${failure}`),
+        ...args.qualityIssues.map((issue) => `${issue.rule}: ${issue.message}`),
+    ];
+    const risks = [
+        ...args.conventionCompliance.violations.map((violation) => violation.message),
+        ...minimalityBlockingFindings.map((finding) => `${finding.ruleId}: ${finding.target}`),
+        ...args.suggestions,
+    ];
+    const structured = compactObj({
+        specId: args.specId,
+        title: args.title,
+        ready: args.compactSummary.status === 'passing' && args.qualityGateSummary.passed,
+        status: args.compactSummary.status,
+        score: args.score,
+        summary: args.compactSummary,
+        counts: {
+            matches: args.result.matches.length,
+            missing: args.result.missing.length,
+            extra: args.result.extra.length,
+            indeterminate: args.indeterminate.length,
+            qualityIssues: args.qualityIssues.length,
+            conventionViolations: args.conventionCompliance.totalViolations,
+            graphGaps: args.graphCoverage.gaps.length,
+            failedGates: failedGates.length,
+        },
+        missingTop5: args.result.missing.slice(0, 5),
+        extraTop5: args.result.extra.slice(0, 5),
+        indeterminateTop5: args.indeterminate.slice(0, 5),
+        qualityIssuesTop5: args.qualityIssues.slice(0, 5),
+        qualityGateSummary: args.qualityGateSummary,
+        blockersCount: blockers.length,
+        blockersTop3: blockers.slice(0, 3),
+        risksTop5: risks.slice(0, 5),
+        autofixable: args.suggestions.length > 0 || args.qualityIssues.length > 0,
+        nextAction: args.suggestions[0] ??
+            (args.compactSummary.status === 'passing'
+                ? 'Proceed to update_status(done) after required release checks pass.'
+                : 'Fix the top blockers and rerun validate.'),
+        artifactRefs: {
+            validationReport: args.validationReport.path,
+            validationReportSha: args.validationReport.sha,
+        },
+        validationReport: {
+            written: args.validationReport.written,
+            path: args.validationReport.path,
+            sha: args.validationReport.sha,
+            passed: args.validationReport.passed,
+            reviewer: args.validationReport.reviewer,
+            gatesCount: args.validationReport.gates.length,
+            failedGatesTop5: failedGates.slice(0, 5),
+        },
+        implementationQualityScore: args.implementationQualityScore,
+        definitionOfReady: {
+            isReady: args.dor.isReady,
+            passed: args.dor.passedCount,
+            required: args.dor.requiredCount,
+            items: failedDorItems,
+            failedItemsTop5: failedDorItems,
+        },
+        definitionOfDone: {
+            isDone: args.dod.isDone,
+            passed: args.dod.passedCount,
+            required: args.dod.requiredCount,
+            failedItems: failedDodItems,
+            failedItemsTop5: failedDodItems,
+        },
+        conventionCompliance: {
+            totalViolations: args.conventionCompliance.totalViolations,
+            regressionDetected: args.conventionCompliance.regressionDetected,
+            violationsTop5: args.conventionCompliance.violations.slice(0, 5),
+        },
+        lintCheck: {
+            passed: args.lintCheck.passed,
+            issueCount: args.lintCheck.issueCount,
+            command: args.lintCheck.command,
+            output: args.lintCheck.output ?? '',
+            outputPreview: typeof args.lintCheck.output === 'string' ? args.lintCheck.output.slice(0, 500) : undefined,
+        },
+        assuranceGates: {
+            newCode: {
+                passed: args.assuranceGates.newCode.passed,
+                findingsCount: args.assuranceGates.newCode.findings.length,
+                findingsTop5: args.assuranceGates.newCode.findings.slice(0, 5),
+            },
+        },
+        minimalityReport: args.minimalityReport !== null
+            ? {
+                enabled: args.minimalityReport.enabled,
+                blocked: args.minimalityReport.blocked,
+                findingCount: args.minimalityReport.findings.length,
+                blockingFindingCount: minimalityBlockingFindings.length,
+                blockingFindingsTop5: minimalityBlockingFindings.slice(0, 5),
+            }
+            : undefined,
+        graphCoverage: {
+            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),
+    });
+    const lintCheck = structured.lintCheck;
+    lintCheck.output = args.lintCheck.output ?? '';
+    return structured;
+}
 function buildCompactValidateText(args) {
     const { score, passedCount, failedCount, totalCriteria, qualityFailures, missing, indeterminate, commitReminder, planuReminder, } = args;
     if (failedCount === 0 && qualityFailures.length === 0) {

package/dist/transports/transport-factory.js

@@ -1,6 +1,7 @@
 // transport-factory.ts — Parses CLI flags and selects the appropriate MCP transport.
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createHttpTransport } from './http-transport.js';
+import { compactToolsListMessage, isToolsListResponse, } from '../engine/compact/tool-list-compactor.js';
 const VALID_TRANSPORTS = ['stdio', 'http'];
 const DEFAULT_PORT = 3100;
 const DEFAULT_HOST = '127.0.0.1';
@@ -40,6 +41,7 @@ export async function selectTransport(server, args, serverFactory) {
     const config = parseTransportConfig(args);
     if (config.transport === 'stdio') {
         const transport = new StdioServerTransport();
+        installToolsListCompaction(transport);
         await server.connect(transport);
         installStdioShutdownHandlers(server);
         return;
@@ -48,6 +50,17 @@ export async function selectTransport(server, args, serverFactory) {
     const factory = serverFactory ?? (() => server);
     await createHttpTransport(factory, config);
 }
+function installToolsListCompaction(transport) {
+    const originalSend = transport.send.bind(transport);
+    const compactingSend = (message) => {
+        const outgoing = isToolsListResponse(message)
+            ? compactToolsListMessage(message)
+            : message;
+        return originalSend(outgoing);
+    };
+    const wrappedTransport = transport;
+    wrappedTransport.send = compactingSend;
+}
 function installStdioShutdownHandlers(server) {
     let shuttingDown = false;
     const shutdown = (reason) => {

package/dist/types/qa-gate.d.ts

@@ -4,6 +4,9 @@ export interface QaCheckResult {
     passed: boolean;
     output: string;
     durationMs: number;
+    command?: string;
+    timedOut?: boolean;
+    errorMessage?: string;
 }
 export interface QaGateResult {
     specId: string;

package/dist/types/tool-classification.d.ts

@@ -0,0 +1,8 @@
+export type ToolExecutionClass = 'local' | 'hybrid' | 'llm-required';
+export interface ToolClassification {
+    toolName: string;
+    executionClass: ToolExecutionClass;
+    tokenPolicy: 'no-llm' | 'summarize-first' | 'llm-product';
+    reason: string;
+}
+//# sourceMappingURL=tool-classification.d.ts.map

package/dist/types/tool-classification.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-classification.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.10.5",
+  "version": "4.10.6",
   "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",

package/planu-native.json

@@ -1,26 +1,20 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.10.5",
+  "version": "4.10.6",
   "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-first release readiness, branch cleanliness, and optional gitflow drift.",
           "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.10.5",
+  "version": "4.10.6",
   "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"]
 }