@planu/cli 4.10.5 → 4.10.7

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/http-transport.js

@@ -6,6 +6,7 @@ import { PLANU_VERSION } from '../config/version.js';
 import { runWithSessionContext } from './session-context.js';
 import { checkHttpRateLimit } from './http-rate-limiter.js';
 import { loadOAuthConfig, extractBearerToken, validateToken } from './oauth-validator.js';
+import { compactToolsListMessage, isToolsListResponse, } from '../engine/compact/tool-list-compactor.js';
 const MAX_BODY_BYTES = 5 * 1024 * 1024; // 5MB
 const SHUTDOWN_GRACE_MS = 5_000;
 const sessions = new Map();
@@ -95,6 +96,7 @@ async function handlePost(req, res, sessionId, serverFactory) {
     const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: () => randomUUID(),
     });
+    installToolsListCompaction(transport);
     transport.onclose = () => {
         const sid = transport.sessionId;
         if (sid) {
@@ -177,6 +179,17 @@ async function handleMcpRequest(req, res, serverFactory, corsOrigin) {
     res.writeHead(405, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ error: 'Method not allowed' }));
 }
+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;
+}
 export async function createHttpTransport(serverFactory, config) {
     const httpServer = createServer((req, res) => {
         void (async () => {

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.7",
   "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.10.5",
-    "@planu/core-darwin-x64": "4.10.5",
-    "@planu/core-linux-arm64-gnu": "4.10.5",
-    "@planu/core-linux-arm64-musl": "4.10.5",
-    "@planu/core-linux-x64-gnu": "4.10.5",
-    "@planu/core-linux-x64-musl": "4.10.5",
-    "@planu/core-win32-arm64-msvc": "4.10.5",
-    "@planu/core-win32-x64-msvc": "4.10.5"
+    "@planu/core-darwin-arm64": "4.10.7",
+    "@planu/core-darwin-x64": "4.10.7",
+    "@planu/core-linux-arm64-gnu": "4.10.7",
+    "@planu/core-linux-arm64-musl": "4.10.7",
+    "@planu/core-linux-x64-gnu": "4.10.7",
+    "@planu/core-linux-x64-musl": "4.10.7",
+    "@planu/core-win32-arm64-msvc": "4.10.7",
+    "@planu/core-win32-x64-msvc": "4.10.7"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -164,7 +164,7 @@
     "tsc-alias": "^1.9.0",
     "type-coverage": "^2.29.7",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.62.1",
+    "typescript-eslint": "^8.63.0",
     "vite": "^8.1.3",
     "vitest": "^4.1.10",
     "vue": "^3.5.39"

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.10.5",
+  "version": "4.10.7",
   "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": "4.10.5",
+  "version": "4.10.7",
   "icon": "assets/plugin/icon.svg",
   "command": [
     "npx",