@planu/cli 4.3.25 → 4.4.0

package/dist/types/index.d.ts

@@ -25,6 +25,8 @@ export * from './migration/index.js';
 export * from './migration-advanced.js';
 export * from './privacy.js';
 export * from './events.js';
+export * from './evidence-gates.js';
+export * from './evidence-index.js';
 export * from './analytics.js';
 export * from './sdd-flow.js';
 export * from './sdd-model-routing.js';
@@ -48,6 +50,7 @@ export * from './dynamic-migration.js';
 export * from './multi-agent.js';
 export * from './ai-native.js';
 export * from './actuals-tracking.js';
+export * from './actionable-spec-metrics.js';
 export * from './actuals.js';
 export * from './risk.js';
 export * from './context-budget.js';
@@ -62,6 +65,7 @@ export * from './webhook.js';
 export * from './ci.js';
 export * from './spec-templates.js';
 export * from './spec-generator.js';
+export * from './spec-grounding.js';
 export * from './registry.js';
 export * from './tool-groups.js';
 export * from './code-transforms.js';
@@ -104,6 +108,7 @@ export * from './legal.js';
 export * from './mcp-recommendation.js';
 export * from './approval.js';
 export * from './scan-project.js';
+export * from './sdd-constitution.js';
 export * from './import-spec.js';
 export * from './error-telemetry.js';
 export * from './audit-trail.js';

package/dist/types/index.js

@@ -26,6 +26,8 @@ export * from './migration/index.js';
 export * from './migration-advanced.js';
 export * from './privacy.js';
 export * from './events.js';
+export * from './evidence-gates.js';
+export * from './evidence-index.js';
 export * from './analytics.js';
 export * from './sdd-flow.js';
 export * from './sdd-model-routing.js';
@@ -49,6 +51,7 @@ export * from './dynamic-migration.js';
 export * from './multi-agent.js';
 export * from './ai-native.js';
 export * from './actuals-tracking.js';
+export * from './actionable-spec-metrics.js';
 export * from './actuals.js';
 export * from './risk.js';
 export * from './context-budget.js';
@@ -63,6 +66,7 @@ export * from './webhook.js';
 export * from './ci.js';
 export * from './spec-templates.js';
 export * from './spec-generator.js';
+export * from './spec-grounding.js';
 export * from './registry.js';
 export * from './tool-groups.js';
 export * from './code-transforms.js';
@@ -105,6 +109,7 @@ export * from './legal.js';
 export * from './mcp-recommendation.js';
 export * from './approval.js';
 export * from './scan-project.js';
+export * from './sdd-constitution.js';
 export * from './import-spec.js';
 export * from './error-telemetry.js';
 export * from './audit-trail.js';

package/dist/types/sdd-constitution.d.ts

@@ -0,0 +1,27 @@
+export type SddConstitutionRuleLevel = 'blocking' | 'advisory';
+export interface SddConstitutionRule {
+    id: string;
+    title: string;
+    level: SddConstitutionRuleLevel;
+    category: 'grounding' | 'quality' | 'evidence' | 'approval' | 'metrics';
+    description: string;
+    nextAction: string;
+}
+export interface SddConstitutionOverride {
+    ruleId: string;
+    level?: SddConstitutionRuleLevel;
+    enabled?: boolean;
+    rationale: string;
+}
+export interface EffectiveSddConstitutionRule extends SddConstitutionRule {
+    enabled: boolean;
+    overrideRationale?: string;
+}
+export interface SddConstitutionViolation {
+    ruleId: string;
+    level: SddConstitutionRuleLevel;
+    message: string;
+    evidence: string[];
+    nextAction: string;
+}
+//# sourceMappingURL=sdd-constitution.d.ts.map

package/dist/types/sdd-constitution.js

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

package/dist/types/spec-format.d.ts

@@ -1,6 +1,7 @@
 import type { Spec } from './spec/core.js';
 import type { Estimation } from './estimation.js';
 import type { SpecStatus } from './common/index.js';
+import type { CriterionGroundingRecord, TechnicalReferenceGroundingRecord } from './spec-grounding.js';
 /** A criterion in the lean spec frontmatter. */
 export interface LeanCriterion {
     text: string;
@@ -29,6 +30,12 @@ export interface LeanSpecInput {
     estimation: Estimation;
     /** SPEC-461 Phase 3: Extra criteria from autopilot pattern detection. */
     extraCriteria?: string[];
+    /** SPEC-1074: Explicit criteria after grounding filters are applied. */
+    criteriaOverride?: LeanCriterion[];
+    /** SPEC-1074: Criterion-level grounding records for new specs. */
+    groundingCriteria?: CriterionGroundingRecord[];
+    /** SPEC-1074: Technical reference grounding records for new specs. */
+    groundingTechnicalReferences?: TechnicalReferenceGroundingRecord[];
     /** SPEC-481: Acceptance criteria format. Defaults to 'checkbox'. */
     acFormat?: 'checkbox' | 'bdd';
 }

package/dist/types/spec-grounding.d.ts

@@ -0,0 +1,22 @@
+export type GroundingSource = 'user_input' | 'project_evidence' | 'documented_assumption' | 'ungrounded_advisory';
+export type GroundingConfidence = 'low' | 'medium' | 'high';
+export interface CriterionGroundingRecord {
+    text: string;
+    source: GroundingSource;
+    evidence: string[];
+    confidence: GroundingConfidence;
+}
+export interface TechnicalReferenceGroundingRecord {
+    path: string;
+    section: 'create' | 'modify' | 'test';
+    source: GroundingSource;
+    evidence: string[];
+    confidence: GroundingConfidence;
+}
+export interface GroundingGateResult {
+    passed: boolean;
+    required: boolean;
+    issues: string[];
+    records: CriterionGroundingRecord[];
+}
+//# sourceMappingURL=spec-grounding.d.ts.map

package/dist/types/spec-grounding.js

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

package/dist/types/spec-quality.d.ts

@@ -35,6 +35,16 @@ export interface SpecQualityReport {
         risk: QualityDimensionDetail;
     };
 }
+export type GenericSpecOutputIssueKind = 'generic-criterion' | 'unsupported-verification' | 'placeholder-reference' | 'generic-technical-reference';
+export interface GenericSpecOutputIssue {
+    kind: GenericSpecOutputIssueKind;
+    phrase: string;
+    reason: string;
+}
+export interface GenericSpecOutputGateResult {
+    passed: boolean;
+    issues: GenericSpecOutputIssue[];
+}
 /** A single over-engineering signal detected in a spec. SPEC-485 */
 export interface ComplexitySignal {
     type: string;

package/package.json

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

package/planu-native.json

@@ -1,20 +1,26 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.3.25",
+  "version": "4.4.0",
   "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"
@@ -24,7 +30,10 @@
           "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"
@@ -34,7 +43,10 @@
           "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"
@@ -44,7 +56,10 @@
           "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"
@@ -54,7 +69,10 @@
           "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"
@@ -64,7 +82,10 @@
           "title": "Check release readiness",
           "description": "Check local branch cleanliness and main/develop/release sync readiness.",
           "invocation": "planu release check",
-          "hosts": ["codex", "claude-code"],
+          "hosts": [
+            "codex",
+            "claude-code"
+          ],
           "requiresMcp": false,
           "requiresDaemon": false,
           "mapsTo": "releaseCommand"

package/planu-plugin.json

@@ -2,9 +2,12 @@
   "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.3.25",
+  "version": "4.4.0",
   "icon": "assets/plugin/icon.svg",
-  "command": ["npx", "@planu/cli@latest"],
+  "command": [
+    "npx",
+    "@planu/cli@latest"
+  ],
   "packageName": "@planu/cli",
   "capabilities": {
     "tools": [
@@ -23,17 +26,42 @@
       "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"
+  ]
 }