@planu/cli 1.11.0 → 1.13.0

package/dist/tools/register-autopilot.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAutopilotTools(server: McpServer): void;
+//# sourceMappingURL=register-autopilot.d.ts.map

package/dist/tools/register-autopilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-autopilot.d.ts","sourceRoot":"","sources":["../../src/tools/register-autopilot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgG9D"}

package/dist/tools/register-autopilot.js

@@ -0,0 +1,78 @@
+// tools/register-autopilot.ts — SPEC-413: Registers configure_autopilot MCP tool
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { loadAutopilotConfig, saveAutopilotConfig, getAutopilotStatus, } from '../engine/autopilot/action-executor.js';
+export function registerAutopilotTools(server) {
+    server.registerTool('configure_autopilot', {
+        description: 'Enable/disable individual autopilot triggers, set thresholds, or view current autopilot status. Autopilot auto-triggers tools like validate_criteria_quality, tdd_scaffold, and resolve_drift_violations at the right moments in the spec lifecycle.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            action: z
+                .enum(['enable', 'disable', 'status', 'set-threshold'])
+                .describe('Action to perform. Values: enable — activate a trigger rule, disable — deactivate a trigger rule, status — show all rules and their state, set-threshold — update numeric threshold for a conditional rule.'),
+            triggerId: z
+                .string()
+                .max(200)
+                .optional()
+                .describe('ID of the trigger rule to enable/disable/configure. Example: "post-create:validate_criteria_quality". Required for enable/disable/set-threshold.'),
+            threshold: z
+                .number()
+                .optional()
+                .describe('Threshold value for set-threshold action. For hour-based triggers: minimum estimated hours. For drift triggers: minimum drift score (0-1).'),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('configure_autopilot', async (args) => {
+        if (args.action === 'status') {
+            const status = await getAutopilotStatus(args.projectPath);
+            const lines = status.rules.map((r) => `${r.enabled ? '✅' : '⬜'} \`${r.id}\` — ${r.description}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `## Autopilot Status\n\n**${status.enabledRules}/${status.totalRules} rules enabled**\n\n${lines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        if (!args.triggerId) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: 'triggerId is required for enable/disable/set-threshold actions.',
+                    },
+                ],
+            };
+        }
+        const config = await loadAutopilotConfig(args.projectPath);
+        if (args.action === 'enable') {
+            config.rules[args.triggerId] = {
+                ...(config.rules[args.triggerId] ?? {}),
+                enabled: true,
+            };
+        }
+        else if (args.action === 'disable') {
+            config.rules[args.triggerId] = {
+                ...(config.rules[args.triggerId] ?? {}),
+                enabled: false,
+            };
+        }
+        else if (args.action === 'set-threshold' && args.threshold !== undefined) {
+            config.rules[args.triggerId] = {
+                ...(config.rules[args.triggerId] ?? { enabled: true }),
+                threshold: args.threshold,
+            };
+        }
+        await saveAutopilotConfig(args.projectPath, config);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ Autopilot rule \`${args.triggerId}\` updated (action: ${args.action}).`,
+                },
+            ],
+        };
+    }));
+}
+//# sourceMappingURL=register-autopilot.js.map

package/dist/tools/register-autopilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-autopilot.js","sourceRoot":"","sources":["../../src/tools/register-autopilot.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-checkpoints.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCheckpointTools(server: McpServer): void;
+//# sourceMappingURL=register-checkpoints.d.ts.map

package/dist/tools/register-checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-checkpoints.d.ts","sourceRoot":"","sources":["../../src/tools/register-checkpoints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsL/D"}

package/dist/tools/register-checkpoints.js

@@ -0,0 +1,134 @@
+// tools/register-checkpoints.ts — Registers approval checkpoint tools (SPEC-411)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureCheckpointPolicy } from './checkpoint/configure-policy-handler.js';
+import { handleRequireCheckpoint } from './checkpoint/require-checkpoint-handler.js';
+import { handleApproveCheckpoint } from './checkpoint/approve-checkpoint-handler.js';
+import { handleRejectCheckpoint } from './checkpoint/reject-checkpoint-handler.js';
+import { handleListPendingCheckpoints } from './checkpoint/list-checkpoints-handler.js';
+export function registerCheckpointTools(server) {
+    // -------------------------------------------------------------------------
+    // configure_checkpoint_policy — set up approval gates for transitions
+    // -------------------------------------------------------------------------
+    server.registerTool('configure_checkpoint_policy', {
+        description: 'Configure approval checkpoints that block spec status transitions until a designated role approves. ' +
+            'Apply a built-in preset (strict/balanced/relaxed) or define custom per-transition policies. ' +
+            'This implements the Judge gate in Planner→Worker→Judge governance.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            preset: z
+                .enum(['strict', 'balanced', 'relaxed'])
+                .optional()
+                .describe('Policy preset: strict=all transitions need approval (draft->review, review->approved, approved->implementing, implementing->done), ' +
+                'balanced=key transitions only (review->approved, implementing->done), ' +
+                'relaxed=only completion needs approval (implementing->done).'),
+            policies: z
+                .array(z.object({
+                transition: z
+                    .string()
+                    .min(1)
+                    .describe('Transition to gate, e.g. "review->approved". ' +
+                    'Valid statuses: draft, review, approved, implementing, done, discarded.'),
+                requiredRole: z
+                    .string()
+                    .min(1)
+                    .describe('Role that must approve: developer, tech_lead, qa, product_owner, admin.'),
+                description: z
+                    .string()
+                    .min(1)
+                    .describe('Human-readable explanation of why this checkpoint exists.'),
+                autoApproveAfterHours: z
+                    .number()
+                    .positive()
+                    .optional()
+                    .describe('Hours before the checkpoint auto-approves if no action is taken.'),
+            }))
+                .optional()
+                .describe('Custom policies (used when preset is not set). ' +
+                'Replaces all existing policies for the project.'),
+        },
+        annotations: { title: 'Configure Checkpoint Policy', destructiveHint: false },
+    }, safeTracked('configure_checkpoint_policy', (args) => handleConfigureCheckpointPolicy(args)));
+    // -------------------------------------------------------------------------
+    // require_checkpoint — manually create a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('require_checkpoint', {
+        description: 'Create a pending checkpoint that blocks a specific spec status transition. ' +
+            'Returns the checkpoint ID and instructions on who needs to approve it. ' +
+            'The checkpoint must be approved via approve_checkpoint before the transition can proceed.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).max(500).describe('Spec ID to block, e.g. SPEC-042.'),
+            transition: z
+                .string()
+                .min(1)
+                .describe('Status transition to block, e.g. "review->approved". ' +
+                'Must match a configured policy.'),
+            requestedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of who is requesting the checkpoint (defaults to "system").'),
+        },
+        annotations: { title: 'Require Checkpoint', destructiveHint: false },
+    }, safeTracked('require_checkpoint', (args) => handleRequireCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // approve_checkpoint — approve a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('approve_checkpoint', {
+        description: 'Approve a pending checkpoint, unblocking the associated spec status transition. ' +
+            'Returns confirmation and next steps for the spec.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            checkpointId: z
+                .string()
+                .min(1)
+                .describe('ID of the checkpoint to approve (returned by require_checkpoint).'),
+            approvedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of the approver (defaults to "anonymous").'),
+        },
+        annotations: { title: 'Approve Checkpoint', destructiveHint: false },
+    }, safeTracked('approve_checkpoint', (args) => handleApproveCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // reject_checkpoint — reject a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('reject_checkpoint', {
+        description: 'Reject a pending checkpoint, blocking the associated spec status transition. ' +
+            'A rejection reason is required. The spec stays in its current status.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            checkpointId: z
+                .string()
+                .min(1)
+                .describe('ID of the checkpoint to reject (returned by require_checkpoint).'),
+            rejectedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of the reviewer rejecting (defaults to "anonymous").'),
+            reason: z
+                .string()
+                .min(1)
+                .describe('Mandatory explanation of why the checkpoint was rejected.'),
+        },
+        annotations: { title: 'Reject Checkpoint', destructiveHint: false },
+    }, safeTracked('reject_checkpoint', (args) => handleRejectCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // list_pending_checkpoints — list checkpoints awaiting approval
+    // -------------------------------------------------------------------------
+    server.registerTool('list_pending_checkpoints', {
+        description: 'List all pending approval checkpoints for a project. ' +
+            'Optionally filter by required role to see only checkpoints relevant to you. ' +
+            'Returns spec ID, transition being blocked, required role, and requester.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            role: z
+                .string()
+                .optional()
+                .describe('Filter by required role: developer, tech_lead, qa, product_owner, admin. ' +
+                'Omit to list all pending checkpoints.'),
+        },
+        annotations: { title: 'List Pending Checkpoints', readOnlyHint: true },
+    }, safeTracked('list_pending_checkpoints', (args) => handleListPendingCheckpoints(args)));
+}
+//# sourceMappingURL=register-checkpoints.js.map

package/dist/tools/register-checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-checkpoints.js","sourceRoot":"","sources":["../../src/tools/register-checkpoints.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-competitive.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCompetitiveTools(server: McpServer): void;
+//# sourceMappingURL=register-competitive.d.ts.map

package/dist/tools/register-competitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-competitive.d.ts","sourceRoot":"","sources":["../../src/tools/register-competitive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgHhE"}

package/dist/tools/register-competitive.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { listCompetitorsHandler, competitiveGapAnalysisHandler, updateCatalogHandler, } from './competitive-handlers.js';
+import { safeTracked, safeLicensed } from './safe-handler.js';
+export function registerCompetitiveTools(server) {
+    // -------------------------------------------------------------------------
+    // list_competitors — FREE
+    // -------------------------------------------------------------------------
+    server.registerTool('list_competitors', {
+        description: 'List all competitors in the competitive catalog. Shows each competitor with their ' +
+            'tracked capabilities and last update date. Free tool — no license required.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(1000).describe('Absolute path to the project root.'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeTracked('list_competitors', async (args) => listCompetitorsHandler(args)));
+    // -------------------------------------------------------------------------
+    // competitive_gap_analysis — PRO
+    // -------------------------------------------------------------------------
+    server.registerTool('competitive_gap_analysis', {
+        description: 'Analyze a spec or feature description against the competitive catalog to determine ' +
+            'Planu positioning (differentiator / parity / lagging), coverage by competitor, ' +
+            'unique capabilities, opportunity gaps, and differentiation suggestions. Requires Pro license.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(1000).describe('Absolute path to the project root.'),
+            specId: z
+                .string()
+                .max(100)
+                .optional()
+                .describe('Spec ID to analyze (e.g. "SPEC-042"). The tool reads the spec title and description ' +
+                'to extract feature keywords. Either specId or featureDescription is required.'),
+            featureDescription: z
+                .string()
+                .max(5000)
+                .optional()
+                .describe('Free-text description of the feature to analyze vs competitors. ' +
+                'Either specId or featureDescription is required.'),
+            competitors: z
+                .array(z.string().max(100))
+                .max(20)
+                .optional()
+                .describe('Subset of competitor IDs to compare against (e.g. ["kiro", "linear"]). ' +
+                'Valid values: kiro, tessl, github-spec-kit, linear, jira, notion, shortcut. ' +
+                'Omit to compare against all competitors.'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('competitive_gap_analysis', async (args) => competitiveGapAnalysisHandler(args)));
+    // -------------------------------------------------------------------------
+    // update_competitive_catalog — PRO
+    // -------------------------------------------------------------------------
+    server.registerTool('update_competitive_catalog', {
+        description: 'Add or update a competitor in the competitive catalog. Writes to a project-local ' +
+            'competitive-catalog.json in the planu/ directory, which overrides the bundled catalog. ' +
+            'Requires Pro license.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(1000).describe('Absolute path to the project root.'),
+            competitor: z.object({
+                id: z
+                    .string()
+                    .min(1)
+                    .max(100)
+                    .describe('Unique identifier for the competitor (e.g. "kiro", "my-tool").'),
+                name: z
+                    .string()
+                    .min(1)
+                    .max(200)
+                    .describe('Display name of the competitor (e.g. "Kiro (AWS)").'),
+                url: z.string().max(500).optional().describe('Homepage URL of the competitor.'),
+                capabilities: z
+                    .array(z.string().max(200))
+                    .max(50)
+                    .optional()
+                    .describe('List of capability identifiers the competitor supports.'),
+                strengths: z
+                    .array(z.string().max(300))
+                    .max(20)
+                    .optional()
+                    .describe('Known strengths of this competitor.'),
+                weaknesses: z
+                    .array(z.string().max(300))
+                    .max(20)
+                    .optional()
+                    .describe('Known weaknesses of this competitor.'),
+            }),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('update_competitive_catalog', async (args) => updateCatalogHandler(args)));
+}
+//# sourceMappingURL=register-competitive.js.map

package/dist/tools/register-competitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-competitive.js","sourceRoot":"","sources":["../../src/tools/register-competitive.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-context-profile.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerContextProfileTools(server: McpServer): void;
+//# sourceMappingURL=register-context-profile.d.ts.map

package/dist/tools/register-context-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-profile.d.ts","sourceRoot":"","sources":["../../src/tools/register-context-profile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiHnE"}

package/dist/tools/register-context-profile.js

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { setActiveProfile, getActiveProfile } from '../storage/context-profile-store.js';
+import { getProfile, getAllProfiles } from '../engine/context-profile/profile-catalog.js';
+const AVAILABLE_PHASES = ['brainstorm', 'plan', 'implement', 'review', 'release'];
+const projectPathField = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root directory.');
+const phaseField = z
+    .enum(['brainstorm', 'plan', 'implement', 'review', 'release'])
+    .describe('Work phase to activate: ' +
+    'brainstorm=explore ideas, ' +
+    'plan=design specs, ' +
+    'implement=build features, ' +
+    'review=validate quality, ' +
+    'release=publish');
+export function registerContextProfileTools(server) {
+    // -------------------------------------------------------------------------
+    // set_context_profile
+    // -------------------------------------------------------------------------
+    server.registerTool('set_context_profile', {
+        description: 'Activate a work-phase context profile that guides the LLM to use only the ' +
+            'relevant tools for the current phase (brainstorm/plan/implement/review/release). ' +
+            'Reduces token waste by surfacing only the ~10 most relevant tools per phase.',
+        inputSchema: {
+            projectPath: projectPathField,
+            phase: phaseField,
+        },
+        annotations: { readOnlyHint: false },
+    }, safeTracked('set_context_profile', async (args) => {
+        const { projectPath, phase } = args;
+        await setActiveProfile(projectPath, phase);
+        const profile = getProfile(phase);
+        const focusList = profile.focusTools.map((t) => `  • ${t}`).join('\n');
+        const tipsList = profile.tips.map((t) => `  - ${t}`).join('\n');
+        const text = `You are now in **${profile.name}**.\n\n` +
+            `${profile.description}\n\n` +
+            `**Focus tools (~${profile.estimatedTokensSaved}% token savings):**\n${focusList}\n\n` +
+            `**Tips:**\n${tipsList}`;
+        return { content: [{ type: 'text', text }] };
+    }));
+    // -------------------------------------------------------------------------
+    // get_context_profile
+    // -------------------------------------------------------------------------
+    server.registerTool('get_context_profile', {
+        description: 'Get the currently active context profile for a project, ' +
+            'including focus tools and phase-specific tips. ' +
+            'Returns a prompt when no profile is active.',
+        inputSchema: {
+            projectPath: projectPathField,
+        },
+        annotations: { readOnlyHint: true },
+    }, safeTracked('get_context_profile', async (args) => {
+        const { projectPath } = args;
+        const active = await getActiveProfile(projectPath);
+        if (!active) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No active context profile. Use set_context_profile to activate one.\n\n' +
+                            `Available phases: ${AVAILABLE_PHASES.join(', ')}`,
+                    },
+                ],
+            };
+        }
+        const profile = getProfile(active.phase);
+        const focusList = profile.focusTools.map((t) => `  • ${t}`).join('\n');
+        const avoidList = profile.avoidTools.map((t) => `  • ${t}`).join('\n');
+        const tipsList = profile.tips.map((t) => `  - ${t}`).join('\n');
+        const text = `**Active profile: ${profile.name}**\n` +
+            `Activated: ${active.activatedAt}\n\n` +
+            `${profile.description}\n\n` +
+            `**Focus tools:**\n${focusList}\n\n` +
+            `**Avoid tools:**\n${avoidList}\n\n` +
+            `**Tips:**\n${tipsList}\n\n` +
+            `Estimated token savings: ~${profile.estimatedTokensSaved}%`;
+        return { content: [{ type: 'text', text }] };
+    }));
+    // -------------------------------------------------------------------------
+    // list_context_profiles
+    // -------------------------------------------------------------------------
+    server.registerTool('list_context_profiles', {
+        description: 'List all 5 available context profiles (brainstorm/plan/implement/review/release) ' +
+            'with their focus tools and estimated token savings. ' +
+            'Use this to discover which profile is best for the current work.',
+        inputSchema: {
+            projectPath: projectPathField,
+        },
+        annotations: { readOnlyHint: true },
+    }, safeTracked('list_context_profiles', async (args) => {
+        const { projectPath } = args;
+        const active = await getActiveProfile(projectPath);
+        const profiles = getAllProfiles();
+        const lines = ['**Available context profiles:**\n'];
+        for (const p of profiles) {
+            const isActive = active?.phase === p.phase ? ' (ACTIVE)' : '';
+            lines.push(`### ${p.name}${isActive}`, `Phase: \`${p.phase}\``, p.description, `Focus: ${p.focusTools.slice(0, 5).join(', ')}${p.focusTools.length > 5 ? ` +${String(p.focusTools.length - 5)} more` : ''}`, `Token savings: ~${String(p.estimatedTokensSaved)}%`, '');
+        }
+        lines.push(`Use set_context_profile with phase=<phase> to activate one.`);
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+}
+//# sourceMappingURL=register-context-profile.js.map

package/dist/tools/register-context-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-profile.js","sourceRoot":"","sources":["../../src/tools/register-context-profile.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-ears.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEarsTools(server: McpServer): void;
+//# sourceMappingURL=register-ears.d.ts.map

package/dist/tools/register-ears.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-ears.d.ts","sourceRoot":"","sources":["../../src/tools/register-ears.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkLzD"}

package/dist/tools/register-ears.js

@@ -0,0 +1,148 @@
+// tools/register-ears.ts — EARS criteria quality tools (SPEC-410)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { lintSpec, lintAllSpecs } from '../engine/ears/spec-linter.js';
+import { scoreCriterion } from '../engine/ears/criterion-scorer.js';
+import { generateRewrites } from '../engine/ears/rewriter.js';
+import { detectEarsPattern } from '../engine/ears/pattern-matcher.js';
+export function registerEarsTools(server) {
+    // -------------------------------------------------------------------------
+    // validate_criteria_quality — score AC quality for a spec or raw criteria
+    // -------------------------------------------------------------------------
+    server.registerTool('validate_criteria_quality', {
+        description: 'Score acceptance criteria quality using EARS (Easy Approach to Requirements Syntax). ' +
+            'Detects vague language, scores testability and specificity (0-10 each), ' +
+            'identifies the EARS pattern, and suggests rewrites for low-scoring criteria. ' +
+            'Provide either specId (reads from spec file) or criteria (raw text array). ' +
+            'Returns per-criterion scores, overall grade (A-F), and rewrite suggestions.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/ directory lives.'),
+            specId: z
+                .string()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe('Spec ID to validate (e.g. SPEC-042). Reads criteria from the spec file.'),
+            criteria: z
+                .array(z.string().min(1).max(2000))
+                .optional()
+                .describe('Raw acceptance criteria text array to score. Used when specId is not provided.'),
+        },
+        annotations: { title: 'Validate Criteria Quality', readOnlyHint: true },
+    }, safeTracked('validate_criteria_quality', async (args) => {
+        const { projectPath, specId, criteria } = args;
+        if (specId !== undefined) {
+            const report = await lintSpec(specId, projectPath);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
+            };
+        }
+        if (criteria !== undefined && criteria.length > 0) {
+            const scored = criteria.map(scoreCriterion);
+            const overallScore = scored.length > 0
+                ? Math.round((scored.reduce((sum, c) => sum + c.overallScore, 0) / scored.length) * 10) / 10
+                : 0;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ criteria: scored, overallScore }, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Provide either specId or criteria array.',
+                },
+            ],
+            isError: true,
+        };
+    }));
+    // -------------------------------------------------------------------------
+    // rewrite_criteria_ears — score a single criterion and get EARS rewrites
+    // -------------------------------------------------------------------------
+    server.registerTool('rewrite_criteria_ears', {
+        description: 'Score a single acceptance criterion and generate 2 EARS-format rewrite suggestions. ' +
+            'Returns current testability and specificity scores, detected vagueness flags, ' +
+            'EARS pattern classification, and concrete rewrite alternatives. ' +
+            'No LLM call — rewrites are template-driven for consistency and speed.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            criterion: z
+                .string()
+                .min(1)
+                .max(2000)
+                .describe('The acceptance criterion text to score and rewrite.'),
+        },
+        annotations: { title: 'Rewrite Criteria as EARS', readOnlyHint: true },
+    }, safeTracked('rewrite_criteria_ears', (args) => {
+        const { criterion } = args;
+        const scored = scoreCriterion(criterion);
+        const pattern = detectEarsPattern(criterion);
+        const rewrites = generateRewrites(criterion, pattern);
+        return Promise.resolve({
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ ...scored, rewrites }, null, 2),
+                },
+            ],
+        });
+    }));
+    // -------------------------------------------------------------------------
+    // ears_lint — lint all specs in the project and report worst criteria
+    // -------------------------------------------------------------------------
+    server.registerTool('ears_lint', {
+        description: 'Lint all specs in the project for EARS compliance and criteria quality. ' +
+            'Returns project-wide average score, letter grade, and top 10 worst criteria ranked by score. ' +
+            'Use minScore to filter and only report criteria below a threshold. ' +
+            'Helpful for identifying which specs need the most improvement.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/specs/ directory lives.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(10)
+                .optional()
+                .describe('Optional score threshold (0-10). Only report criteria with overallScore below this value. ' +
+                'Defaults to 10 (report all criteria regardless of score).'),
+        },
+        annotations: { title: 'EARS Lint All Specs', readOnlyHint: true },
+    }, safeTracked('ears_lint', async (args) => {
+        const { projectPath, minScore } = args;
+        const report = await lintAllSpecs(projectPath);
+        const threshold = minScore ?? 10;
+        const filteredWorst = report.topWorstCriteria.filter((c) => c.score < threshold);
+        const summary = {
+            projectPath: report.projectPath,
+            totalSpecs: report.totalSpecs,
+            averageScore: report.averageScore,
+            grade: report.averageScore >= 9
+                ? 'A'
+                : report.averageScore >= 7
+                    ? 'B'
+                    : report.averageScore >= 5
+                        ? 'C'
+                        : report.averageScore >= 3
+                            ? 'D'
+                            : 'F',
+            topWorstCriteria: filteredWorst,
+            generatedAt: report.generatedAt,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+        };
+    }));
+}
+//# sourceMappingURL=register-ears.js.map