@planu/cli 1.1.1 → 1.2.0

package/dist/tools/register-validation-loop-tools.js

@@ -0,0 +1,77 @@
+// tools/register-validation-loop-tools.ts — SPEC-369: Register Test Automation Loop tools
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleSpecHealthCheck, handleHealthCheckAll, handleRunValidationLoop, } from './validation-loop-handler.js';
+export function registerValidationLoopTools(server) {
+    server.registerTool('spec_health_check', {
+        description: 'Compute a 0-100 health score for a spec by checking: completeness (title + description + criteria), ' +
+            'test file existence, last validation result, spec status (done = coverage ok), and drift status. ' +
+            'Each dimension is worth 20 points.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            specId: z.string().min(1).max(200).describe('Spec ID to check (e.g. SPEC-001)'),
+        },
+        annotations: {
+            title: 'Spec Health Check',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('spec_health_check', async (args) => handleSpecHealthCheck(args)));
+    server.registerTool('health_check_all', {
+        description: 'Run spec_health_check on all specs in the project and return them sorted from worst to best score. ' +
+            'Use this to identify which specs need the most attention.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+        },
+        annotations: {
+            title: 'Health Check All Specs',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('health_check_all', async (args) => handleHealthCheckAll(args)));
+    server.registerTool('run_validation_loop', {
+        description: 'Generate a structured validation execution plan for a set of specs. ' +
+            'Shows the steps to validate each spec (validate → test → fix → re-validate) ' +
+            'with the specified number of iterations. ' +
+            'NOTE: Planu cannot run shell commands — this returns the plan for you to execute.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            specIds: z
+                .array(z.string().min(1).max(200))
+                .min(1)
+                .max(50)
+                .describe('List of spec IDs to validate (e.g. ["SPEC-001", "SPEC-002"])'),
+            maxIterations: z
+                .number()
+                .int()
+                .min(1)
+                .max(10)
+                .optional()
+                .describe('Maximum number of fix-and-retry iterations (default: 3)'),
+            testCommand: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Shell command to run tests (default: "pnpm test")'),
+            autoFix: z
+                .boolean()
+                .optional()
+                .describe('Whether to include auto-fix steps in the plan (default: false)'),
+        },
+        annotations: {
+            title: 'Run Validation Loop (Plan)',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('run_validation_loop', (args) => Promise.resolve(handleRunValidationLoop(args))));
+}
+//# sourceMappingURL=register-validation-loop-tools.js.map

package/dist/tools/register-validation-loop-tools.js.map

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

package/dist/tools/register-workspace-dashboard-tools.d.ts

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

package/dist/tools/register-workspace-dashboard-tools.d.ts.map

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

package/dist/tools/register-workspace-dashboard-tools.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleWorkspaceOverview, handleWorkspaceHealth, handleBulkProjectOperations, handleWorkspaceReport, handleWorkspaceSearch, handleWorkspaceAlerts, } from './workspace-dashboard-handler.js';
+export function registerWorkspaceDashboardTools(server) {
+    // workspace_overview
+    server.registerTool('workspace_overview', {
+        description: 'Get an overview of all registered projects in the workspace. Shows spec counts, progress, and health scores per project.',
+        inputSchema: {
+            healthThreshold: z
+                .number()
+                .int()
+                .min(0)
+                .max(100)
+                .optional()
+                .default(50)
+                .describe('Health score threshold % for highlighting (default: 50)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('workspace_overview', async (args) => handleWorkspaceOverview(args)));
+    // workspace_health
+    server.registerTool('workspace_health', {
+        description: 'Get aggregated health metrics across all registered workspace projects. Returns totals for specs, done, in-progress, blocked, and average health score.',
+        inputSchema: {
+            healthThreshold: z
+                .number()
+                .int()
+                .min(0)
+                .max(100)
+                .optional()
+                .default(50)
+                .describe('Health threshold % to classify projects (default: 50)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('workspace_health', async (args) => handleWorkspaceHealth(args)));
+    // bulk_project_operations
+    server.registerTool('bulk_project_operations', {
+        description: 'Run a bulk operation across multiple workspace projects. Supports validate-all (scan specs) and generate-reports. Use dryRun to preview affected projects.',
+        inputSchema: {
+            operation: z
+                .enum(['validate-all', 'generate-reports'])
+                .describe('Operation to run: validate-all or generate-reports'),
+            projectPaths: z
+                .array(z.string().min(1).max(4096))
+                .optional()
+                .describe('Specific project paths to target (omit for all registered projects)'),
+            dryRun: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Preview affected projects without running (default: false)'),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('bulk_project_operations', async (args) => handleBulkProjectOperations(args)));
+    // workspace_report
+    server.registerTool('workspace_report', {
+        description: 'Generate an HTML workspace report summarizing all projects, spec counts, health scores, and progress. Suitable for stakeholder sharing.',
+        inputSchema: {
+            includeCharts: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Include visual charts (default: false)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('workspace_report', async (args) => handleWorkspaceReport(args)));
+    // workspace_search
+    server.registerTool('workspace_search', {
+        description: 'Search for specs by keyword across all registered workspace projects. Searches spec IDs and titles.',
+        inputSchema: {
+            query: z.string().min(1).max(200).describe('Search keyword'),
+            maxResults: z
+                .number()
+                .int()
+                .min(1)
+                .max(200)
+                .optional()
+                .default(50)
+                .describe('Max results (default: 50)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('workspace_search', async (args) => handleWorkspaceSearch(args)));
+    // workspace_alerts
+    server.registerTool('workspace_alerts', {
+        description: 'List stale specs across all workspace projects. Highlights specs in blocked or in-progress status that have not been updated for the configured number of days.',
+        inputSchema: {
+            staleDaysThreshold: z
+                .number()
+                .int()
+                .min(1)
+                .max(365)
+                .optional()
+                .default(14)
+                .describe('Days without update to consider a spec stale (default: 14)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('workspace_alerts', async (args) => handleWorkspaceAlerts(args)));
+}
+//# sourceMappingURL=register-workspace-dashboard-tools.js.map

package/dist/tools/register-workspace-dashboard-tools.js.map

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

package/dist/tools/schema-generator-handler.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult, GenerateValidationSchemaInput, GenerateApiClientInput } from '../types/index.js';
+export declare function handleGenerateValidationSchema(input: GenerateValidationSchemaInput): Promise<ToolResult>;
+export declare function handleGenerateApiClient(input: GenerateApiClientInput): Promise<ToolResult>;
+//# sourceMappingURL=schema-generator-handler.d.ts.map

package/dist/tools/schema-generator-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator-handler.d.ts","sourceRoot":"","sources":["../../src/tools/schema-generator-handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AA6B3B,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,UAAU,CAAC,CA8DrB;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqDhG"}

package/dist/tools/schema-generator-handler.js

@@ -0,0 +1,129 @@
+// tools/schema-generator-handler.ts — Handler for Validation Schema Generator (SPEC-365)
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { getSpec } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { generateSchemas, generateApiClient } from '../engine/schema-generator.js';
+async function readSpecText(spec) {
+    const parts = [];
+    if (spec.description !== undefined) {
+        parts.push(spec.description);
+    }
+    if (spec.specPath !== undefined) {
+        try {
+            const content = await readFile(spec.specPath, 'utf-8');
+            parts.push(content);
+        }
+        catch {
+            // spec file not readable — continue with description only
+        }
+    }
+    return parts.join('\n\n');
+}
+async function writeOutputFile(outputPath, content) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, content, 'utf-8');
+}
+export async function handleGenerateValidationSchema(input) {
+    const { projectPath, specId, library, outputFormat, outputPath } = input;
+    try {
+        const projectId = hashProjectPath(projectPath);
+        const spec = await getSpec(projectId, specId);
+        if (spec === null) {
+            return {
+                content: [{ type: 'text', text: `Spec "${specId}" not found.` }],
+                isError: true,
+            };
+        }
+        const specText = await readSpecText(spec);
+        const result = generateSchemas(specId, specText, library, outputFormat, outputPath);
+        if (result.entitiesDetected === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No entities detected in spec "${specId}". ` +
+                            'Ensure the spec describes entities using keywords like "model", "schema", "interface", or "type".',
+                    },
+                ],
+            };
+        }
+        // Write files if outputPath is provided
+        if (outputPath !== undefined) {
+            for (const schema of result.schemas) {
+                const ext = outputFormat === 'typescript' ? '.ts' : '.js';
+                const libSuffix = library === 'all' ? `.${schema.library}` : '';
+                const filePath = outputPath.replace(/\.(ts|js)$/, '') + libSuffix + ext;
+                await writeOutputFile(filePath, schema.code);
+            }
+        }
+        const codeSection = result.schemas
+            .map((s) => `### ${s.library}\n\`\`\`${outputFormat}\n${s.code}\`\`\``)
+            .join('\n\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Generated ${library} schema(s) for "${specId}". ` +
+                        `Entities detected: ${String(result.entitiesDetected)}.\n\n${codeSection}` +
+                        (outputPath !== undefined ? `\n\nWritten to: ${outputPath}` : ''),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to generate validation schema: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleGenerateApiClient(input) {
+    const { projectPath, specId, framework, outputPath } = input;
+    try {
+        const projectId = hashProjectPath(projectPath);
+        const spec = await getSpec(projectId, specId);
+        if (spec === null) {
+            return {
+                content: [{ type: 'text', text: `Spec "${specId}" not found.` }],
+                isError: true,
+            };
+        }
+        const specText = await readSpecText(spec);
+        const result = generateApiClient(specId, specText, framework, outputPath);
+        if (result.routesDetected === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No API routes detected in spec "${specId}". ` +
+                            'Ensure the spec describes routes using patterns like "GET /api/...", "POST /api/...".',
+                    },
+                ],
+            };
+        }
+        if (outputPath !== undefined) {
+            await writeOutputFile(outputPath, result.code);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Generated ${framework} client for "${specId}". ` +
+                        `Routes detected: ${String(result.routesDetected)}.\n\n` +
+                        `\`\`\`typescript\n${result.code}\`\`\`` +
+                        (outputPath !== undefined ? `\n\nWritten to: ${outputPath}` : ''),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to generate API client: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=schema-generator-handler.js.map

package/dist/tools/schema-generator-handler.js.map

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

package/dist/tools/spec-cookbook-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult, CookbookListInput, CookbookGetInput, CookbookApplyInput, CookbookContributeInput, CookbookSearchInput } from '../types/index.js';
+export declare function handleCookbookList(args: CookbookListInput): Promise<ToolResult>;
+export declare function handleCookbookGet(args: CookbookGetInput): Promise<ToolResult>;
+export declare function handleCookbookApply(args: CookbookApplyInput): Promise<ToolResult>;
+export declare function handleCookbookContribute(args: CookbookContributeInput): Promise<ToolResult>;
+export declare function handleCookbookSearch(args: CookbookSearchInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-cookbook-handler.d.ts.map

package/dist/tools/spec-cookbook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-cookbook-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-cookbook-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAY3B,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAIrF;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBnF;AAGD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BvF;AAGD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBjG;AAGD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAMzF"}

package/dist/tools/spec-cookbook-handler.js

@@ -0,0 +1,83 @@
+// tools/spec-cookbook-handler.ts — SPEC-361: Spec Cookbook handlers
+import { listEntries, getEntry, searchEntries, applyEntry, contributeEntry, formatEntryMarkdown, formatEntriesListMarkdown, } from '../engine/spec-cookbook.js';
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleCookbookList(args) {
+    const entries = listEntries(args.domain, args.featureType, args.limit ?? 50);
+    const markdown = formatEntriesListMarkdown(entries);
+    return { content: [{ type: 'text', text: markdown }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleCookbookGet(args) {
+    const entry = getEntry(args.id);
+    if (entry === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No cookbook entry found with ID \`${args.id}\`. Use \`cookbook_list\` to see available entries.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const markdown = formatEntryMarkdown(entry);
+    return { content: [{ type: 'text', text: markdown }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleCookbookApply(args) {
+    const entry = getEntry(args.id);
+    if (entry === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No cookbook entry found with ID \`${args.id}\`. Use \`cookbook_list\` to see available entries.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = applyEntry(entry, args.projectName);
+    const output = [
+        `# Spec Template: ${result.title}`,
+        ``,
+        `Copy the spec content below and pass it to \`create_spec\` as the description, or save it as a spec file.`,
+        `Replace all \`[PLACEHOLDER]\` markers with your project-specific content.`,
+        ``,
+        `---`,
+        ``,
+        result.specContent,
+    ].join('\n');
+    return { content: [{ type: 'text', text: output }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleCookbookContribute(args) {
+    const newEntry = contributeEntry({
+        domain: args.domain,
+        featureType: args.featureType,
+        title: args.title,
+        description: args.description,
+        acceptanceCriteria: args.acceptanceCriteria,
+        tags: args.tags,
+    });
+    const output = [
+        `# Contribution Added`,
+        ``,
+        `Your entry has been added to the in-memory cookbook.`,
+        ``,
+        `**ID:** \`${newEntry.id}\``,
+        `**Title:** ${newEntry.title}`,
+        `**Domain:** ${newEntry.domain}`,
+        ``,
+        `Note: This entry is available for the current session. To permanently add it, submit a PR to the Planu repository.`,
+    ].join('\n');
+    return { content: [{ type: 'text', text: output }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleCookbookSearch(args) {
+    const entries = searchEntries(args.query, args.limit ?? 20);
+    const markdown = formatEntriesListMarkdown(entries);
+    const header = `# Search Results for "${args.query}"\n\n`;
+    return { content: [{ type: 'text', text: header + markdown }] };
+}
+//# sourceMappingURL=spec-cookbook-handler.js.map

package/dist/tools/spec-cookbook-handler.js.map

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

package/dist/tools/spec-hooks-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult, ConfigureSpecHooksInput, ListSpecHooksInput, TestSpecHookInput, DisableSpecHookInput, EnableSpecHookInput } from '../types/index.js';
+export declare function handleConfigureSpecHooks(input: ConfigureSpecHooksInput): Promise<ToolResult>;
+export declare function handleListSpecHooks(input: ListSpecHooksInput): Promise<ToolResult>;
+export declare function handleTestSpecHook(input: TestSpecHookInput): Promise<ToolResult>;
+export declare function handleDisableSpecHook(input: DisableSpecHookInput): Promise<ToolResult>;
+export declare function handleEnableSpecHook(input: EnableSpecHookInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-hooks-handler.d.ts.map

package/dist/tools/spec-hooks-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-hooks-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-hooks-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAS3B,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA4BrB;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BxF;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCtF;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW5F;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW1F"}

package/dist/tools/spec-hooks-handler.js

@@ -0,0 +1,112 @@
+// tools/spec-hooks-handler.ts — SPEC-368: Agent Hooks Automáticos
+import { dispatchSpecHooks, describeHookActions } from '../engine/spec-hooks-engine.js';
+import { addSpecHook, loadSpecHooks, getSpecHook, updateSpecHookEnabled, } from '../storage/spec-hooks-store.js';
+export async function handleConfigureSpecHooks(input) {
+    const { projectPath, hookName, event, action, filter, enabled = true } = input;
+    await addSpecHook(projectPath, {
+        name: hookName,
+        event,
+        action,
+        filter,
+        enabled,
+        runCount: 0,
+        failCount: 0,
+        createdAt: new Date().toISOString(),
+    });
+    const filterDesc = filter ? ` (filter: ${JSON.stringify(filter)})` : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Hook configured: "${hookName}"`,
+                    `  Event: ${event}`,
+                    `  Action: ${action}${filterDesc}`,
+                    `  Status: ${enabled ? 'enabled' : 'disabled'}`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+export async function handleListSpecHooks(input) {
+    const config = await loadSpecHooks(input.projectPath);
+    if (config.hooks.length === 0) {
+        return {
+            content: [
+                { type: 'text', text: 'No spec hooks configured. Use configure_spec_hooks to add one.' },
+            ],
+        };
+    }
+    const lines = config.hooks.map((h) => {
+        const status = h.enabled ? 'enabled' : 'disabled';
+        const stats = `runs: ${h.runCount}, fails: ${h.failCount}`;
+        const last = h.lastRunAt ? ` last: ${h.lastRunAt}` : '';
+        return `• ${h.name} [${status}] — ${h.event} → ${h.action} (${stats}${last})`;
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Spec hooks (${config.hooks.length}):\n${lines.join('\n')}`,
+            },
+        ],
+    };
+}
+export async function handleTestSpecHook(input) {
+    const { projectPath, hookName, specId } = input;
+    const hook = await getSpecHook(projectPath, hookName);
+    if (!hook) {
+        return {
+            content: [{ type: 'text', text: `Hook "${hookName}" not found.` }],
+            isError: true,
+        };
+    }
+    const config = await loadSpecHooks(projectPath);
+    const result = dispatchSpecHooks({
+        event: hook.event,
+        specId,
+        projectPath,
+    }, config);
+    const actionDesc = describeHookActions(hook, specId);
+    const lines = [
+        `Test simulation for hook "${hookName}" on spec ${specId}:`,
+        ``,
+        `Event: ${hook.event}`,
+        `Action: ${hook.action}`,
+        `Would trigger: ${result.triggered.includes(hookName) ? 'YES' : 'NO (disabled or filter mismatch)'}`,
+        ``,
+        `If triggered, would execute:`,
+        `  ${actionDesc}`,
+        ``,
+        `Dispatch summary:`,
+        result.description,
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+export async function handleDisableSpecHook(input) {
+    const updated = await updateSpecHookEnabled(input.projectPath, input.hookName, false);
+    if (!updated) {
+        return {
+            content: [{ type: 'text', text: `Hook "${input.hookName}" not found.` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `Hook "${input.hookName}" disabled.` }],
+    };
+}
+export async function handleEnableSpecHook(input) {
+    const updated = await updateSpecHookEnabled(input.projectPath, input.hookName, true);
+    if (!updated) {
+        return {
+            content: [{ type: 'text', text: `Hook "${input.hookName}" not found.` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `Hook "${input.hookName}" enabled.` }],
+    };
+}
+//# sourceMappingURL=spec-hooks-handler.js.map

package/dist/tools/spec-hooks-handler.js.map

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

package/dist/tools/spec-lint-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult, DefineLintRuleInput, ListLintRulesInput, RunSpecLintInput, DeleteLintRuleInput } from '../types/index.js';
+export declare function handleDefineLintRule(input: DefineLintRuleInput): Promise<ToolResult>;
+export declare function handleListLintRules(input: ListLintRulesInput): Promise<ToolResult>;
+export declare function handleRunSpecLint(input: RunSpecLintInput): Promise<ToolResult>;
+export declare function handleDeleteLintRule(input: DeleteLintRuleInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-lint-handler.d.ts.map

package/dist/tools/spec-lint-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-lint-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-lint-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAM3B,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC1F;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmCxF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyFpF;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB1F"}