@planu/cli 4.10.10 → 4.10.11

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.10.11] - 2026-07-08
+
+### Bug Fixes
+- fix(validate): honor executable spec compliance score
+
+
 ## [4.10.10] - 2026-07-08
 
 ### Bug Fixes

package/dist/engine/validator/validation-report-writer.js

@@ -2,8 +2,9 @@ import { appendArtifact, readArtifact } from '../handoff-artifacts/io.js';
 import { runSpecCompliance, } from './spec-compliance-runner.js';
 export async function writeImplementationReviewReport(input) {
     const specCompliance = await runSpecCompliance(input.spec, input.projectPath);
+    const reportScore = resolveExecutableValidationScore(input.score, specCompliance);
     const gates = buildGates({
-        score: input.score,
+        score: reportScore,
         lintPassed: input.lintPassed,
         conventionRegression: input.conventionRegression ?? false,
         specCompliance,
@@ -25,7 +26,7 @@ export async function writeImplementationReviewReport(input) {
         reviewer,
         specCompliance: reportCompliance,
         minimalityReport: input.minimalityReport,
-        score: input.score ?? undefined,
+        score: reportScore ?? undefined,
         completedAt: new Date().toISOString(),
     };
     try {
@@ -56,6 +57,9 @@ export async function writeImplementationReviewReport(input) {
         };
     }
 }
+function resolveExecutableValidationScore(score, specCompliance) {
+    return specCompliance.perScenario.length > 0 ? specCompliance.dimensionScore : score;
+}
 async function preserveUnobservedGates(input, nextGates) {
     const currentGateNames = new Set(nextGates.map((gate) => gate.name));
     const explicitlyObserved = new Set([

package/dist/tools/validate-lint.js

@@ -6,7 +6,7 @@ import { dirname, join } from 'node:path';
 import { formatLintFailureDiagnostics, resolveProjectCommandPlan, runProjectCommandPlan, } from './validate-runtime.js';
 /** Allowlist: alphanumerics, spaces, and safe shell chars. Rejects ; | $ ` & < > */
 const SAFE_COMMAND_RE = /^[\w\s./:@~=-]+$/;
-const DEFAULT_LINT_CHECK_TIMEOUT_MS = 10_000;
+const DEFAULT_LINT_CHECK_TIMEOUT_MS = 60_000;
 const LINT_CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 function isSafeCommand(cmd) {
     return SAFE_COMMAND_RE.test(cmd);

package/dist/tools/validate.js

@@ -99,23 +99,24 @@ export async function handleValidate(args, server) {
         conventionRegression: regressionDetected,
         minimalityReport: minimalityReport ?? undefined,
     });
+    const effectiveResult = buildEffectiveValidationResult(result, validationReport.specCompliance);
     const qualityGateSummary = buildQualityGateSummary({
         conventionViolations,
         regressionDetected,
         lintPassed: lintCheck.passed,
         assurancePassed: assuranceGates.newCode.passed,
         minimalityBlocked: minimalityReport?.blocked === true,
-        score: result.score,
+        score: effectiveResult.score,
     });
     const output = {
         specId,
         title: spec.title,
-        score: result.score,
-        fieldsImplemented: result.fieldsImplemented,
-        fieldsTotal: result.fieldsTotal,
-        matches: result.matches,
-        missing: result.missing,
-        extra: result.extra,
+        score: effectiveResult.score,
+        fieldsImplemented: effectiveResult.fieldsImplemented,
+        fieldsTotal: effectiveResult.fieldsTotal,
+        matches: effectiveResult.matches,
+        missing: effectiveResult.missing,
+        extra: effectiveResult.extra,
         qualityIssues: result.qualityIssues.map((issue) => ({
             file: issue.file,
             line: issue.line,
@@ -202,7 +203,7 @@ export async function handleValidate(args, server) {
     }
     // Auto-suggest corrective actions based on validation results
     // score is null when no criteria can be extracted — treat as 0 for comparisons.
-    const scoreValue = result.score ?? 0;
+    const scoreValue = effectiveResult.score ?? 0;
     const suggestions = [];
     if (scoreValue < 50) {
         suggestions.push('Critical: Many acceptance criteria not implemented. Review spec requirements.');
@@ -216,8 +217,8 @@ export async function handleValidate(args, server) {
     if (!dod.isDone && spec.status === 'implementing') {
         suggestions.push('Implementation incomplete. Review DoD checklist before marking as done.');
     }
-    if (result.missing.length > 0) {
-        suggestions.push(`${result.missing.length} criteria still missing. Run detect_drift to identify gaps.`);
+    if (effectiveResult.missing.length > 0) {
+        suggestions.push(`${effectiveResult.missing.length} criteria still missing. Run detect_drift to identify gaps.`);
     }
     if (graphCoverage.gaps.length > 0) {
         suggestions.push(`${graphCoverage.gaps.length} graph-backed coverage gap(s) found without broad repository scan.`);
@@ -243,8 +244,8 @@ export async function handleValidate(args, server) {
         specId,
         input: { specType: spec.type, scope: spec.scope },
         outcome: {
-            score: result.score,
-            missingCount: result.missing.length,
+            score: effectiveResult.score,
+            missingCount: effectiveResult.missing.length,
             qualityIssueCount: result.qualityIssues.length,
             dorPassed: dor.isReady,
             dodPassed: dod.isDone,
@@ -261,7 +262,7 @@ export async function handleValidate(args, server) {
             type: 'validate',
             specId,
             input: { trigger: 'auto-quality-learn', rules: topIssueRules },
-            outcome: { score: result.score, antipatterns: topIssueRules },
+            outcome: { score: effectiveResult.score, antipatterns: topIssueRules },
             delta: { qualityGap: 100 - scoreValue },
             timestamp: new Date().toISOString(),
         }).catch((err) => {
@@ -277,10 +278,10 @@ export async function handleValidate(args, server) {
         ? '\n\n📁 HTML reports updated — commit to save: `git add planu/specs/ planu/conventions.json && git commit -m "chore(planu): update reports"`'
         : '';
     // SPEC-512: Compact output — only surface failures, cap to 200 tokens
-    const totalCriteria = result.fieldsTotal;
-    const passedCount = result.fieldsImplemented;
+    const totalCriteria = effectiveResult.fieldsTotal;
+    const passedCount = effectiveResult.fieldsImplemented;
     const failedCount = totalCriteria - passedCount;
-    const indeterminate = result.indeterminate ?? [];
+    const indeterminate = effectiveResult.indeterminate ?? [];
     const effectiveScore = qualityGateSummary.effectiveScore ?? scoreValue;
     const compactText = buildCompactValidateText({
         score: effectiveScore,
@@ -288,20 +289,20 @@ export async function handleValidate(args, server) {
         failedCount,
         totalCriteria,
         qualityFailures: qualityGateSummary.failures,
-        missing: result.missing,
+        missing: effectiveResult.missing,
         indeterminate,
         commitReminder,
         planuReminder,
     });
     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 compactSummary = buildCompactSummary(specId, effectiveResult.score === null ? null : effectiveScore, passedCount, failedCount + (qualityGateSummary.passed ? 0 : 1), totalCriteria);
     const structuredBase = buildValidateStructuredContent({
         specId,
         title: spec.title,
-        score: result.score === null ? null : effectiveScore,
+        score: effectiveResult.score === null ? null : effectiveScore,
         compactSummary,
-        result,
+        result: effectiveResult,
         indeterminate,
         dor,
         dod,
@@ -384,7 +385,6 @@ function buildQualityGateSummary(input) {
     const blockingConventionViolations = input.conventionViolations.filter((violation) => violation.severity === 'critical');
     const failures = [
         ...(input.regressionDetected ? ['convention-regression'] : []),
-        ...(blockingConventionViolations.length > 0 ? ['blocking-convention-violations'] : []),
         ...(!input.lintPassed ? ['lint'] : []),
         ...(!input.assurancePassed ? ['assurance'] : []),
         ...(input.minimalityBlocked ? ['minimality'] : []),
@@ -400,6 +400,40 @@ function buildQualityGateSummary(input) {
         minimalityPassed: !input.minimalityBlocked,
     };
 }
+function buildExecutableCoverage(specCompliance) {
+    if (specCompliance.scenarios.length === 0) {
+        return null;
+    }
+    const matches = specCompliance.scenarios
+        .filter((scenario) => scenario.verdict === 'pass')
+        .map((scenario) => scenario.title);
+    const missing = specCompliance.scenarios
+        .filter((scenario) => scenario.verdict !== 'pass')
+        .map((scenario) => scenario.title);
+    return {
+        score: specCompliance.score,
+        fieldsImplemented: matches.length,
+        fieldsTotal: specCompliance.scenarios.length,
+        matches,
+        missing,
+        indeterminate: [],
+    };
+}
+function buildEffectiveValidationResult(result, specCompliance) {
+    const executableCoverage = buildExecutableCoverage(specCompliance);
+    if (executableCoverage === null) {
+        return result;
+    }
+    return {
+        ...result,
+        score: executableCoverage.score,
+        fieldsImplemented: executableCoverage.fieldsImplemented,
+        fieldsTotal: executableCoverage.fieldsTotal,
+        matches: executableCoverage.matches,
+        missing: executableCoverage.missing,
+        indeterminate: executableCoverage.indeterminate,
+    };
+}
 function buildCompactSummary(specId, score, passedCount, failedCount, totalCriteria) {
     return {
         specId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.10.10",
+  "version": "4.10.11",
   "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.10",
-    "@planu/core-darwin-x64": "4.10.10",
-    "@planu/core-linux-arm64-gnu": "4.10.10",
-    "@planu/core-linux-arm64-musl": "4.10.10",
-    "@planu/core-linux-x64-gnu": "4.10.10",
-    "@planu/core-linux-x64-musl": "4.10.10",
-    "@planu/core-win32-arm64-msvc": "4.10.10",
-    "@planu/core-win32-x64-msvc": "4.10.10"
+    "@planu/core-darwin-arm64": "4.10.11",
+    "@planu/core-darwin-x64": "4.10.11",
+    "@planu/core-linux-arm64-gnu": "4.10.11",
+    "@planu/core-linux-arm64-musl": "4.10.11",
+    "@planu/core-linux-x64-gnu": "4.10.11",
+    "@planu/core-linux-x64-musl": "4.10.11",
+    "@planu/core-win32-arm64-msvc": "4.10.11",
+    "@planu/core-win32-x64-msvc": "4.10.11"
   },
   "engines": {
     "node": ">=24.0.0"

package/planu-native.json

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