@planu/cli 4.4.3 → 4.6.0

package/dist/types/clarification.d.ts

@@ -13,6 +13,14 @@ export interface DescriptionSignals {
     hasUi: boolean;
     namedProvider: string | null;
     hasScope: boolean;
+    action: string | null;
+    domainObject: string | null;
+    actors: string[];
+    integrations: string[];
+    dataObjects: string[];
+    hasPermissionRisk: boolean;
+    hasDestructiveAction: boolean;
+    riskTerms: string[];
 }
 /** Which host mechanism the LLM should use to relay interactive questions. */
 export type HostHint = 'claude-code' | 'cursor' | 'codex' | 'gemini' | 'universal';

package/dist/types/elicitation.d.ts

@@ -1,4 +1,5 @@
 import type { InteractiveQuestion } from './clarification.js';
+import type { InteractiveOption } from './interactive-question.js';
 /** Primitive field types supported by the MCP elicitation protocol. */
 export type ElicitationFieldType = 'text' | 'number' | 'boolean' | 'enum' | 'multi-select';
 /** Shared base for all elicitation field definitions. */
@@ -174,6 +175,26 @@ export type ElicitOrFallbackOutcome = {
  * - 'technical': inferred from codebase signals; elicitation is skipped
  */
 export type DecisionType = 'policy' | 'business' | 'technical';
+export type DecisionGapKind = 'behavior' | 'permission' | 'provider' | 'billing-model' | 'data' | 'failure' | 'scope';
+export interface DecisionGap {
+    id: string;
+    kind: DecisionGapKind;
+    header: string;
+    question: string;
+    evidence: string[];
+    impact: string;
+    options: InteractiveOption[];
+    multiSelect: boolean;
+    blocking: boolean;
+}
+export interface QuestionGroundingContext {
+    gap: DecisionGap;
+    requestText: string;
+}
+export interface QuestionGroundingResult {
+    passed: boolean;
+    reason?: string;
+}
 /**
  * Outcome when the decision was already cached in conventions.json.
  * The caller can return this value immediately without prompting the user.

package/dist/types/index.d.ts

@@ -79,6 +79,7 @@ export * from './runtime-security.js';
 export * from './workers.js';
 export * from './orchestration-runtime.js';
 export * from './token-optimization.js';
+export * from './token-waste-autopilot.js';
 export * from './llm-providers.js';
 export * from './plugins.js';
 export * from './github.js';

package/dist/types/index.js

@@ -80,6 +80,7 @@ export * from './runtime-security.js';
 export * from './workers.js';
 export * from './orchestration-runtime.js';
 export * from './token-optimization.js';
+export * from './token-waste-autopilot.js';
 export * from './llm-providers.js';
 export * from './plugins.js';
 export * from './github.js';

package/dist/types/token-waste-autopilot.d.ts

@@ -0,0 +1,142 @@
+export type TokenWasteDecisionKind = 'include' | 'summarize' | 'exclude' | 'recommend' | 'avoid' | 'warn' | 'override';
+export type TokenWasteConfidence = 'high' | 'medium' | 'low';
+export type TokenWasteAction = string;
+export interface TokenWastePolicyLoadOptions {
+    defaultPolicyPath?: string;
+}
+export interface TokenWasteEvidence {
+    source: 'policy' | 'project-config' | 'runtime' | 'spec' | 'tool-registry' | 'host-capability';
+    key: string;
+    value?: string | number | boolean;
+}
+export interface TokenWasteDecision {
+    decision: TokenWasteDecisionKind;
+    target: string;
+    reason: string;
+    evidence: TokenWasteEvidence[];
+    confidence: TokenWasteConfidence;
+}
+export interface TokenWasteOutputStrategy {
+    maxLines: number;
+    keepFailures?: boolean;
+    uniqueOnly?: boolean;
+    summarizeKeys?: boolean;
+}
+export interface TokenWastePolicy {
+    version: 1;
+    enabled: boolean;
+    context: {
+        generatedPatterns: string[];
+        stalePatterns: string[];
+        summarizePatterns: string[];
+        staleSessionMinutes: number;
+        safetyOverrideActions: string[];
+    };
+    outputs: {
+        strategies: Record<string, TokenWasteOutputStrategy>;
+    };
+    tools: {
+        groups: Record<string, string[]>;
+        maxRecommended: number;
+    };
+    loops: {
+        thresholds: Record<string, number>;
+        safetyOverrideActions: string[];
+    };
+    modelEffort: {
+        lowRisk: string;
+        default: string;
+        highRisk: string;
+        maxRisk: string;
+    };
+    redaction: {
+        maxSnippetChars: number;
+        redactPatterns: string[];
+    };
+}
+export interface LoadedTokenWastePolicy {
+    policy: TokenWastePolicy;
+    evidence: TokenWasteEvidence[];
+}
+export interface ContextCandidate {
+    path: string;
+    reason?: string;
+}
+export interface ContextPreflightInput {
+    action: TokenWasteAction;
+    policy: TokenWastePolicy;
+    candidates: ContextCandidate[];
+    spec?: {
+        id?: string;
+        status?: string;
+        risk?: string;
+        target?: string;
+    };
+}
+export interface ContextPreflightResult {
+    include: TokenWasteDecision[];
+    summarize: TokenWasteDecision[];
+    exclude: TokenWasteDecision[];
+}
+export interface VerboseOutputInput {
+    kind: string;
+    text: string;
+    policy: TokenWastePolicy;
+    fullOutputRef?: string;
+}
+export interface VerboseOutputResult {
+    text: string;
+    originalLines: number;
+    returnedLines: number;
+    fullOutputRef?: string;
+    decisions: TokenWasteDecision[];
+}
+export interface ToolRelevanceInput {
+    action: TokenWasteAction;
+    intentSignals: string[];
+    tools: {
+        name: string;
+        description?: string;
+    }[];
+    policy: TokenWastePolicy;
+    hostUnsupportedTools?: string[];
+}
+export interface ToolRelevanceResult {
+    recommended: TokenWasteDecision[];
+    avoided: TokenWasteDecision[];
+}
+export interface TokenWasteRuntimeEvent {
+    type: string;
+    key: string;
+    timestamp?: string;
+    changedSincePrevious?: boolean;
+}
+export interface TokenWasteLoopResult {
+    warnings: TokenWasteDecision[];
+}
+export interface TokenWasteModelAdvice {
+    effort: string;
+    reason: string;
+    evidence: TokenWasteEvidence[];
+}
+export interface TokenWasteAutopilotInput {
+    action: TokenWasteAction;
+    policy: TokenWastePolicy;
+    context?: ContextPreflightResult;
+    output?: VerboseOutputResult;
+    tools?: ToolRelevanceResult;
+    loops?: TokenWasteLoopResult;
+    spec?: {
+        id?: string;
+        risk?: string;
+        scope?: string;
+    };
+}
+export interface TokenWasteReport {
+    actionsTaken: TokenWasteDecision[];
+    recommendations: TokenWasteDecision[];
+    risks: TokenWasteDecision[];
+    evidence: TokenWasteEvidence[];
+    modelEffort: TokenWasteModelAdvice;
+}
+//# sourceMappingURL=token-waste-autopilot.d.ts.map

package/dist/types/token-waste-autopilot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-waste-autopilot.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.4.3",
+  "version": "4.6.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.4.3",
-    "@planu/core-darwin-x64": "4.4.3",
-    "@planu/core-linux-arm64-gnu": "4.4.3",
-    "@planu/core-linux-arm64-musl": "4.4.3",
-    "@planu/core-linux-x64-gnu": "4.4.3",
-    "@planu/core-linux-x64-musl": "4.4.3",
-    "@planu/core-win32-arm64-msvc": "4.4.3",
-    "@planu/core-win32-x64-msvc": "4.4.3"
+    "@planu/core-darwin-arm64": "4.6.0",
+    "@planu/core-darwin-x64": "4.6.0",
+    "@planu/core-linux-arm64-gnu": "4.6.0",
+    "@planu/core-linux-arm64-musl": "4.6.0",
+    "@planu/core-linux-x64-gnu": "4.6.0",
+    "@planu/core-linux-x64-musl": "4.6.0",
+    "@planu/core-win32-arm64-msvc": "4.6.0",
+    "@planu/core-win32-x64-msvc": "4.6.0"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -170,7 +170,7 @@
     "@commitlint/cli": "^21.0.2",
     "@commitlint/config-conventional": "^21.0.2",
     "@eslint/js": "^10.0.1",
-    "@napi-rs/cli": "^3.7.0",
+    "@napi-rs/cli": "^3.7.1",
     "@secretlint/secretlint-rule-no-homedir": "^13.0.2",
     "@secretlint/secretlint-rule-preset-recommend": "^13.0.2",
     "@semantic-release/changelog": "^6.0.3",
@@ -182,7 +182,7 @@
     "@stryker-mutator/core": "^9.6.1",
     "@stryker-mutator/vitest-runner": "^9.6.1",
     "@supabase/supabase-js": "^2.108.1",
-    "@types/node": "^25.9.2",
+    "@types/node": "^25.9.3",
     "@vitejs/plugin-vue": "^6.0.7",
     "@vitest/coverage-v8": "^4.1.8",
     "@vue/test-utils": "^2.4.11",
@@ -198,13 +198,13 @@
     "madge": "^8.0.0",
     "prettier": "^3.8.4",
     "secretlint": "^13.0.2",
-    "semantic-release": "^25.0.3",
+    "semantic-release": "^25.0.5",
     "tsc-alias": "^1.8.17",
     "type-coverage": "^2.29.7",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.61.0",
     "vite": "^8.0.16",
     "vitest": "^4.1.8",
-    "vue": "^3.5.35"
+    "vue": "^3.5.38"
   }
 }

package/planu-native.json

@@ -1,20 +1,26 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.4.3",
+  "version": "4.6.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.4.3",
+  "version": "4.6.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"
+  ]
 }