@planu/cli 5.7.6 → 5.7.7

package/dist/tools/tool-registry/group-quality-compliance.js

@@ -3,8 +3,6 @@ import { z } from 'zod';
 import { safeGoverned, safeTracked } from '../safe-handler.js';
 import { projectIdSchema, withProject } from '../tool-registry-helpers.js';
 import { t } from '../../i18n/index.js';
-import { makeDeprecationStub } from './deprecated-stubs.js';
-import { registerFromEntries } from '../tool-entry.js';
 // ── Compliance (register-compliance-tools.ts) ─────────────────────────────────
 import { handleCheckComplianceUnified, handleCheckComplianceLegacyShim, handleComplianceScoreReportShim, handleComplianceGapAnalysisShim, handleVerifySpecComplianceShim, } from '../compliance-unified-handler.js';
 import { handleConfigureCompliance } from '../compliance-handler.js';
@@ -831,7 +829,7 @@ export function registerQualityComplianceGroupTools(s) {
         description: t('tools.check_readiness.description'),
         inputSchema: {
             ...projectIdSchema,
-            specId: SpecIdSchema.describe('Spec ID to evaluate'),
+            specId: SpecIdSchema.describe('Spec ID to evaluate. Must match pattern ^SPEC-\\d+$, max 50 characters.'),
             mode: z
                 .enum(['strict', 'lenient'])
                 .optional()
@@ -952,7 +950,7 @@ export function registerQualityComplianceGroupTools(s) {
         description: t('tools.package_handoff.description'),
         inputSchema: {
             ...projectIdSchema,
-            specId: SpecIdSchema.describe('Spec ID to generate handoff package for'),
+            specId: SpecIdSchema.describe('Spec ID to generate handoff package for. Must match pattern ^SPEC-\\d+$, max 50 characters.'),
         },
         outputSchema: PackageHandoffOutputSchema,
         annotations: {
@@ -1049,31 +1047,35 @@ export function registerQualityComplianceGroupTools(s) {
         description: 'Request changes on a spec. The spec is moved back to draft and prior approvals are cleared. ' +
             'A comment explaining the required changes is mandatory.',
         inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root. Max 4096 characters.'),
             specId: z
                 .string()
                 .min(1)
                 .max(500)
-                .describe('Spec ID to request changes on (e.g. SPEC-042).'),
+                .describe('Spec ID to request changes on (e.g. SPEC-042). Max 500 characters.'),
             reviewer: z
                 .string()
                 .trim()
                 .min(1)
                 .max(500)
-                .describe('Name, email, or username of the reviewer requesting changes.'),
+                .describe('Name, email, or username of the reviewer requesting changes. Max 500 characters.'),
             comment: z
                 .string()
                 .trim()
                 .min(1)
                 .max(10_000)
-                .describe('Required explanation of what needs to change before re-approval.'),
+                .describe('Required explanation of what needs to change before re-approval. Max 10000 characters.'),
             role: z
                 .string()
                 .trim()
                 .min(1)
                 .max(500)
                 .optional()
-                .describe('Role of the reviewer (e.g. "tech-lead", "qa").'),
+                .describe('Role of the reviewer (e.g. "tech-lead", "qa"). Max 500 characters.'),
         },
         annotations: { title: 'Request Changes', destructiveHint: true },
     }, safeGoverned('request_changes', (args) => handleRequestChanges(args)));
@@ -1196,10 +1198,5 @@ export function registerQualityComplianceGroupTools(s) {
                 .describe('Absolute path to the project root. Used to detect language and test framework.'),
         },
     }, safeTracked('run_mutation_hints', async (args) => handleRunMutationHints({ projectPath: args.projectPath })));
-    // ── SPEC-331: Multi-Agent Orchestration Plan (migrated to skill, SPEC-658) ────
-    // Tool stays registered for backward compat; callers receive a deprecation notice.
-    registerFromEntries(s, [
-        makeDeprecationStub('generate_orchestration_plan', '.claude/skills/parallel-safe.md', 'parallel-safe'),
-    ]);
 }
 //# sourceMappingURL=group-quality-compliance.js.map

package/dist/tools/tool-registry-helpers.js

@@ -5,12 +5,16 @@ import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js
 // ── Shared schema fragments ──────────────────────────────────────────────────
 /** Standard dual projectId/projectPath optional Zod fields. Spread into inputSchema. */
 export const projectIdSchema = {
-    projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+    projectId: z
+        .string()
+        .max(500)
+        .optional()
+        .describe('Project ID hash. Prefer projectPath. Max 500 characters.'),
     projectPath: z
         .string()
         .max(4096)
         .optional()
-        .describe('Absolute path to project root. Derives projectId automatically.'),
+        .describe('Absolute path to project root. Derives projectId automatically. Max 4096 characters.'),
 };
 /**
  * Wraps a handler that requires a resolved projectId.

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

@@ -31,4 +31,18 @@ export type FrontmatterYamlOutcome = {
 } | {
     parsed: false;
 };
+export interface GroundingParseDiagnostic {
+    identifier: string;
+    field: string;
+    value: string;
+    allowed: string[];
+}
+export interface GroundingParseResult<T> {
+    records: T[];
+    diagnostics: GroundingParseDiagnostic[];
+}
+export interface GroundingEntryOutcome<T> {
+    record: T | null;
+    diagnostics: GroundingParseDiagnostic[];
+}
 //# sourceMappingURL=spec-grounding.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.7.6",
+  "version": "5.7.7",
   "description": "Planu — MCP Server for Spec Driven Development. Cross-platform (Linux/macOS/Windows, x64/arm64).",
   "type": "module",
   "main": "dist/index.js",

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": "5.7.6",
+  "version": "5.7.7",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",

package/dist/tools/tool-registry/deprecated-stubs.d.ts

@@ -1,19 +0,0 @@
-import type { McpToolEntry } from '../tool-entry.js';
-/** Template for the deprecation message. Interpolated at runtime. */
-export declare const DEPRECATION_MESSAGE_TEMPLATE = "This tool has been migrated to a skill. Use the {skill} skill instead: {path}";
-/**
- * The 5 MCP tool names that have been migrated to skills.
- * Used in smoke tests (Scenario 6) and anywhere a guard on migrated tools is needed.
- */
-export declare const DEPRECATED_TOOLS: readonly ['execute_sdd_flow', 'implement_plan', 'multi_teammate_review', 'run_healing_loop', 'generate_orchestration_plan'];
-export type DeprecatedToolName = (typeof DEPRECATED_TOOLS)[number];
-/**
- * Create a McpToolEntry-compatible deprecation stub.
- *
- * - Tool stays registered → callers never see "unknown tool".
- * - Description starts with `[Deprecated]` → LLMs stop calling it.
- * - Handler always returns success (no `isError`) regardless of input.
- * - One stderr warning per process per tool (deduped).
- */
-export declare function makeDeprecationStub(toolName: string, replacementSkillPath: string, replacementSkillName: string): McpToolEntry;
-//# sourceMappingURL=deprecated-stubs.d.ts.map

package/dist/tools/tool-registry/deprecated-stubs.js

@@ -1,65 +0,0 @@
-// tools/tool-registry/deprecated-stubs.ts — Shared factory for MCP deprecation stubs (SPEC-658).
-//
-// Tools migrated to skills stay registered so callers receive a helpful message
-// instead of "unknown tool". The stub handler never throws and always returns
-// HTTP 200 with a plain-text deprecation notice.
-import { z } from 'zod';
-import { compactResult } from '../output-formatter.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Template for the deprecation message. Interpolated at runtime. */
-export const DEPRECATION_MESSAGE_TEMPLATE = 'This tool has been migrated to a skill. Use the {skill} skill instead: {path}';
-/**
- * The 5 MCP tool names that have been migrated to skills.
- * Used in smoke tests (Scenario 6) and anywhere a guard on migrated tools is needed.
- */
-export const DEPRECATED_TOOLS = [
-    'execute_sdd_flow',
-    'implement_plan',
-    'multi_teammate_review',
-    'run_healing_loop',
-    'generate_orchestration_plan',
-];
-// ---------------------------------------------------------------------------
-// Per-process warning dedup (one stderr line per tool name per process)
-// ---------------------------------------------------------------------------
-const _warned = new Set();
-function warnOnce(toolName, skillPath) {
-    if (!_warned.has(toolName)) {
-        _warned.add(toolName);
-        process.stderr.write(`[planu] DEPRECATION: MCP tool "${toolName}" has been migrated to skill "${skillPath}". ` +
-            'Update callers to use the skill directly.\n');
-    }
-}
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a McpToolEntry-compatible deprecation stub.
- *
- * - Tool stays registered → callers never see "unknown tool".
- * - Description starts with `[Deprecated]` → LLMs stop calling it.
- * - Handler always returns success (no `isError`) regardless of input.
- * - One stderr warning per process per tool (deduped).
- */
-export function makeDeprecationStub(toolName, replacementSkillPath, replacementSkillName) {
-    const message = DEPRECATION_MESSAGE_TEMPLATE.replace('{skill}', replacementSkillName).replace('{path}', replacementSkillPath);
-    return {
-        name: toolName,
-        description: `[Deprecated] Migrated to ${replacementSkillName} skill. See ${replacementSkillPath}`,
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        schema: z.object({}).passthrough().shape,
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        handler: (_args) => {
-            warnOnce(toolName, replacementSkillPath);
-            return Promise.resolve(compactResult(message));
-        },
-        annotations: {
-            readOnlyHint: true,
-            title: `[Deprecated] ${toolName}`,
-        },
-        wrap: 'safe',
-    };
-}
-//# sourceMappingURL=deprecated-stubs.js.map