@planu/cli 0.90.2 → 0.92.0

package/dist/tools/orchestrate/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/tools/orchestrate/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAuB,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,qBAAqB,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,OAAO,QAAQ,CAAqB,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAyB;IAC1E,MAAM,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7D,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,uBAAuB,EAAE,CAAC;gBAC7E,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,IAAI,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/tools/orchestrate/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAuB,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,qBAAqB,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,OAAO,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAyB;IAC1E,MAAM,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7D,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,uBAAuB,EAAE,CAAC;gBAC7E,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,IAAI,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/outbound-webhook-handler.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult, ConfigureWebhookInput, OutboundWebhookStatusInput, RemoveWebhookInput, OutboundWebhookPayload, OutboundWebhookEventType } from '../types/index.js';
+import { buildSpecLifecyclePayload } from '../engine/outbound-webhook-dispatcher.js';
+/**
+ * Dispatch a webhook event fire-and-forget.
+ * Called from side-effects.ts after status transitions.
+ */
+export declare function dispatchWebhookEvent(projectPath: string, payload: OutboundWebhookPayload): void;
+export { buildSpecLifecyclePayload };
+export type { OutboundWebhookEventType };
+export declare function handleConfigureWebhook(args: ConfigureWebhookInput): Promise<ToolResult>;
+export declare function handleOutboundWebhookStatus(args: OutboundWebhookStatusInput): Promise<ToolResult>;
+export declare function handleRemoveWebhook(args: RemoveWebhookInput): Promise<ToolResult>;
+//# sourceMappingURL=outbound-webhook-handler.d.ts.map

package/dist/tools/outbound-webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-webhook-handler.d.ts","sourceRoot":"","sources":["../../src/tools/outbound-webhook-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAEL,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAMlD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAI/F;AAOD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AACrC,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAMzC,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8C7F;AAMD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAyFrB;AAMD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBvF"}

package/dist/tools/outbound-webhook-handler.js

@@ -0,0 +1,161 @@
+import { addWebhook, listWebhooks, getWebhook, deactivateWebhook, getDeliveries, getActiveWebhooksForEvent, appendDelivery, } from '../storage/outbound-webhook-store.js';
+import { dispatchToWebhooks, buildSpecLifecyclePayload, } from '../engine/outbound-webhook-dispatcher.js';
+// ---------------------------------------------------------------------------
+// Public fire-and-forget dispatch (orchestrates storage + engine)
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch a webhook event fire-and-forget.
+ * Called from side-effects.ts after status transitions.
+ */
+export function dispatchWebhookEvent(projectPath, payload) {
+    void runDispatch(projectPath, payload).catch(() => {
+        /* best-effort — never throw */
+    });
+}
+async function runDispatch(projectPath, payload) {
+    const webhooks = await getActiveWebhooksForEvent(projectPath, payload.event);
+    await dispatchToWebhooks(webhooks, payload, (delivery) => appendDelivery(projectPath, delivery));
+}
+export { buildSpecLifecyclePayload };
+// ---------------------------------------------------------------------------
+// configure_webhook
+// ---------------------------------------------------------------------------
+export async function handleConfigureWebhook(args) {
+    const { projectPath, url, secret, events = [], label } = args;
+    if (!url.startsWith('http://') && !url.startsWith('https://')) {
+        return {
+            content: [{ type: 'text', text: 'Error: url must start with http:// or https://' }],
+            isError: true,
+        };
+    }
+    if (!secret || secret.length < 8) {
+        return {
+            content: [{ type: 'text', text: 'Error: secret must be at least 8 characters.' }],
+            isError: true,
+        };
+    }
+    const config = await addWebhook(projectPath, { url, secret, events, label });
+    const eventList = events.length > 0 ? events.join(', ') : 'all events';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Webhook configured successfully.`,
+                    `ID: ${config.id}`,
+                    `URL: ${config.url}`,
+                    `Events: ${eventList}`,
+                    `Label: ${config.label ?? '(none)'}`,
+                    `Created: ${config.createdAt}`,
+                    ``,
+                    `Payloads will include header: X-Planu-Signature: sha256=<hmac>`,
+                    `Use the same secret to verify the signature on your endpoint.`,
+                ].join('\n'),
+            },
+        ],
+        structuredContent: {
+            webhookId: config.id,
+            url: config.url,
+            events: config.events,
+            active: config.active,
+            createdAt: config.createdAt,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// outbound_webhook_status
+// ---------------------------------------------------------------------------
+export async function handleOutboundWebhookStatus(args) {
+    const { projectPath, webhookId } = args;
+    if (webhookId !== undefined) {
+        const config = await getWebhook(projectPath, webhookId);
+        if (!config) {
+            return {
+                content: [{ type: 'text', text: `Webhook ${webhookId} not found.` }],
+                isError: true,
+            };
+        }
+        const deliveries = await getDeliveries(projectPath, webhookId);
+        const lastDelivery = deliveries.at(-1);
+        const successCount = deliveries.filter((d) => d.success).length;
+        const health = deliveries.length === 0
+            ? 'no deliveries yet'
+            : successCount === deliveries.length
+                ? 'healthy'
+                : `failing (${String(successCount)}/${String(deliveries.length)} OK)`;
+        const lines = [
+            `Webhook: ${config.id}`,
+            `URL: ${config.url}`,
+            `Label: ${config.label ?? '(none)'}`,
+            `Status: ${config.active ? 'active' : 'inactive'}`,
+            `Events: ${config.events.length > 0 ? config.events.join(', ') : 'all'}`,
+            `Health: ${health}`,
+            `Total deliveries: ${String(deliveries.length)}`,
+        ];
+        if (lastDelivery !== undefined) {
+            lines.push(``, `Last delivery:`, `  At: ${lastDelivery.deliveredAt}`, `  Event: ${lastDelivery.event}`, `  HTTP ${String(lastDelivery.statusCode)} — ${lastDelivery.latencyMs}ms`, `  ${lastDelivery.success ? 'OK' : `FAILED: ${lastDelivery.error ?? 'unknown'}`}`);
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+            structuredContent: { config, lastDelivery: lastDelivery ?? null, health },
+        };
+    }
+    // List all webhooks
+    const configs = await listWebhooks(projectPath);
+    if (configs.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        'No outbound webhooks configured.',
+                        '',
+                        'Use configure_webhook to register an endpoint.',
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    const lines = [`Outbound webhooks (${String(configs.length)} total):`];
+    for (const c of configs) {
+        const deliveries = await getDeliveries(projectPath, c.id);
+        const successCount = deliveries.filter((d) => d.success).length;
+        const health = deliveries.length === 0
+            ? 'no deliveries'
+            : successCount === deliveries.length
+                ? 'healthy'
+                : 'failing';
+        lines.push(``, `  [${c.active ? 'active' : 'inactive'}] ${c.id} — ${c.url}`, `  Events: ${c.events.length > 0 ? c.events.join(', ') : 'all'}`, `  Health: ${health} (${String(successCount)}/${String(deliveries.length)} OK)`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: { total: configs.length, webhooks: configs },
+    };
+}
+// ---------------------------------------------------------------------------
+// remove_webhook
+// ---------------------------------------------------------------------------
+export async function handleRemoveWebhook(args) {
+    const { projectPath, webhookId } = args;
+    const updated = await deactivateWebhook(projectPath, webhookId);
+    if (updated === null) {
+        return {
+            content: [{ type: 'text', text: `Webhook ${webhookId} not found.` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Webhook ${webhookId} deactivated.`,
+                    `URL: ${updated.url}`,
+                    `It will no longer receive events.`,
+                ].join('\n'),
+            },
+        ],
+        structuredContent: { webhookId, deactivated: true },
+    };
+}
+//# sourceMappingURL=outbound-webhook-handler.js.map

package/dist/tools/outbound-webhook-handler.js.map

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

package/dist/tools/performance-analysis-handler.d.ts

@@ -0,0 +1,3 @@
+import type { ToolResult, PerformanceAnalysisInput } from '../types/index.js';
+export declare function handleAnalyzePerformanceImpact(input: PerformanceAnalysisInput): Promise<ToolResult>;
+//# sourceMappingURL=performance-analysis-handler.d.ts.map

package/dist/tools/performance-analysis-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-analysis-handler.d.ts","sourceRoot":"","sources":["../../src/tools/performance-analysis-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EAEzB,MAAM,mBAAmB,CAAC;AA6E3B,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAkCrB"}

package/dist/tools/performance-analysis-handler.js

@@ -0,0 +1,95 @@
+// tools/performance-analysis-handler.ts — Handler for analyze_performance_impact (SPEC-300)
+import { readFile } from 'node:fs/promises';
+import { hashProjectPath } from '../storage/base-store.js';
+import { specStore } from '../storage/index.js';
+import { analyzeSpecPerformance } from '../engine/performance-analyzer.js';
+// ---------------------------------------------------------------------------
+// Severity emoji map
+// ---------------------------------------------------------------------------
+const SEVERITY_EMOJI = {
+    high: '🔴',
+    medium: '🟡',
+    low: '🟢',
+};
+const OVERALL_EMOJI = {
+    high: '🔴',
+    medium: '🟡',
+    low: '🟢',
+    none: '✅',
+};
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+function formatReport(result) {
+    const lines = [];
+    const overallEmoji = OVERALL_EMOJI[result.overallRisk] ?? '✅';
+    lines.push(`# Performance Impact Analysis — ${result.specId}`);
+    lines.push('');
+    lines.push(`**Overall Risk**: ${overallEmoji} ${result.overallRisk.toUpperCase()}`);
+    lines.push(`**Risks detected**: ${result.riskCount}`);
+    lines.push('');
+    if (result.riskCount === 0) {
+        lines.push('No performance risks detected. The spec looks good from a performance perspective.');
+        return lines.join('\n');
+    }
+    lines.push('## Detected Risks');
+    lines.push('');
+    for (const [category, risks] of Object.entries(result.risksByCategory)) {
+        if (risks.length === 0) {
+            continue;
+        }
+        for (const risk of risks) {
+            const emoji = SEVERITY_EMOJI[risk.severity] ?? '';
+            lines.push(`### ${emoji} ${category} (${risk.severity})`);
+            lines.push('');
+            lines.push(`**Issue**: ${risk.description}`);
+            lines.push('');
+            lines.push(`**Fix**: ${risk.recommendation}`);
+            lines.push('');
+        }
+    }
+    if (result.recommendations.length > 0) {
+        lines.push('## Recommendations Summary');
+        lines.push('');
+        for (const rec of result.recommendations) {
+            lines.push(`- ${rec}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleAnalyzePerformanceImpact(input) {
+    const { specId, projectPath } = input;
+    const projectId = hashProjectPath(projectPath);
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec '${specId}' not found in project at '${projectPath}'. Run init_project first.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Read spec.md content if available
+    let specContent = '';
+    if (spec.specPath) {
+        try {
+            specContent = await readFile(spec.specPath, 'utf-8');
+        }
+        catch {
+            // File not readable — fall back to title only
+        }
+    }
+    const result = analyzeSpecPerformance(spec, specContent);
+    return {
+        content: [{ type: 'text', text: formatReport(result) }],
+        structuredContent: result,
+    };
+}
+//# sourceMappingURL=performance-analysis-handler.js.map

package/dist/tools/performance-analysis-handler.js.map

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

package/dist/tools/recommend-model-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend-model-handler.d.ts","sourceRoot":"","sources":["../../src/tools/recommend-model-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAY3B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,UAAU,CAuE1E"}
+{"version":3,"file":"recommend-model-handler.d.ts","sourceRoot":"","sources":["../../src/tools/recommend-model-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAY3B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,UAAU,CAsF1E"}

package/dist/tools/recommend-model-handler.js

@@ -40,6 +40,10 @@ export function handleRecommendModel(args) {
         reasoning,
         costEstimate,
         alternatives,
+        ultrathinkSuggested: rulesResult.ultrathinkSuggested,
+        ultrathinkReason: rulesResult.ultrathinkReason,
+        effortLevelCommand: rulesResult.effortLevelCommand,
+        thinkingToggle: rulesResult.thinkingToggle,
     };
     // 5. Format output
     const lines = [
@@ -57,6 +61,9 @@ export function handleRecommendModel(args) {
             lines.push(`- **${alt.model}** (${(alt.confidence * 100).toFixed(0)}% confidence) — $${alt.costEstimate.estimatedUSD.toFixed(4)}`);
         }
     }
+    if (recommendation.ultrathinkSuggested) {
+        lines.push('', '### Extended Thinking Recommended', `> ${recommendation.ultrathinkReason ?? ''}`, '', `**Effort level:** ${recommendation.effortLevelCommand ?? ''}`, `**Toggle thinking:** ${recommendation.thinkingToggle ?? ''}`);
+    }
     lines.push('', '### Complexity Signals', `- Criteria: ${String(signals.criteriaCount)}`, `- Files: ${String(signals.fileCount)}`, `- Cross-layer: ${String(signals.crossLayerCount)}`, `- Task type: ${signals.taskType}`, `- Overall score: ${signals.overallScore.toFixed(2)}`);
     return {
         content: [{ type: 'text', text: lines.join('\n') }],

package/dist/tools/recommend-model-handler.js.map

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

package/dist/tools/register-api-spec-generator.d.ts

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

package/dist/tools/register-api-spec-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-api-spec-generator.d.ts","sourceRoot":"","sources":["../../src/tools/register-api-spec-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwDpE"}

package/dist/tools/register-api-spec-generator.js

@@ -0,0 +1,49 @@
+// tools/register-api-spec-generator.ts — Register generate_spec_from_api tool (SPEC-286)
+import { z } from 'zod';
+import { handleGenerateSpecFromApi } from './api-spec-generator-handler.js';
+import { safeTracked } from './safe-handler.js';
+export function registerApiSpecGeneratorTool(server) {
+    server.registerTool('generate_spec_from_api', {
+        description: 'Generate Planu specs from an existing API contract. ' +
+            'Accepts OpenAPI 3.x / Swagger 2.0 JSON or GraphQL SDL and creates structured specs with ' +
+            'acceptance criteria derived from required fields, response codes, and field formats. ' +
+            'Useful for reverse-engineering specs from documented APIs.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root'),
+            content: z
+                .string()
+                .min(2)
+                .max(200000)
+                .optional()
+                .describe('Raw content of the API contract. For OpenAPI: JSON string. For GraphQL: SDL string.'),
+            filePath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the API contract file (.json for OpenAPI, .graphql/.gql/.sdl for GraphQL). ' +
+                'Provide either content or filePath.'),
+            mode: z
+                .enum(['by-endpoint', 'by-resource', 'by-operation'])
+                .describe('How to group API operations into specs. ' +
+                'by-endpoint: one spec per REST endpoint (POST /users → spec "Create User"). ' +
+                'by-resource: one spec per resource grouping all CRUD ops (User → spec with all operations). ' +
+                'by-operation: one spec per GraphQL query/mutation/subscription.'),
+            extraTags: z
+                .array(z.string().max(50))
+                .max(10)
+                .optional()
+                .describe("Additional tags to attach to all generated specs, e.g. ['payments', 'v2']"),
+        },
+        annotations: {
+            title: 'Generate Specs from API Contract',
+            readOnlyHint: false,
+            destructiveHint: false,
+        },
+    }, safeTracked('generate_spec_from_api', async (args) => handleGenerateSpecFromApi(args)));
+}
+//# sourceMappingURL=register-api-spec-generator.js.map

package/dist/tools/register-api-spec-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-api-spec-generator.js","sourceRoot":"","sources":["../../src/tools/register-api-spec-generator.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAGzF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,sDAAsD;YACtD,0FAA0F;YAC1F,uFAAuF;YACvF,4DAA4D;QAC9D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,mCAAmC,CAAC;YAChD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,MAAM,CAAC;iBACX,QAAQ,EAAE;iBACV,QAAQ,CACP,qFAAqF,CACtF;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,8FAA8F;gBAC5F,qCAAqC,CACxC;YACH,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;iBACpD,QAAQ,CACP,0CAA0C;gBACxC,8EAA8E;gBAC9E,8FAA8F;gBAC9F,iEAAiE,CACpE;YACH,SAAS,EAAE,CAAC;iBACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;iBACzB,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;SACzF;QACD,WAAW,EAAE;YACX,KAAK,EAAE,kCAAkC;YACzC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;SACvB;KACF,EACD,WAAW,CAAC,wBAAwB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACnD,yBAAyB,CAAC,IAAgC,CAAC,CAC5D,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/tools/register-approval-tools.js

@@ -0,0 +1,87 @@
+// tools/register-approval-tools.ts — Registers approval workflow tools (SPEC-283)
+import { z } from 'zod';
+import { safeTracked, safeLicensed } from './safe-handler.js';
+import { handleConfigureApprovalPolicy, handleApproveSpec, handleRequestChanges, handleApprovalStatus, } from './approval-handler.js';
+export function registerApprovalTools(server) {
+    // -------------------------------------------------------------------------
+    // configure_approval_policy — pro tool
+    // -------------------------------------------------------------------------
+    server.registerTool('configure_approval_policy', {
+        description: 'Define the approval policy for a project: how many approvals are required, ' +
+            'the review SLA in hours, optional escalation contact, and required reviewer roles.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            requiredApprovals: z
+                .number()
+                .int()
+                .min(1)
+                .describe('Minimum number of approvals needed before a spec can be marked approved.'),
+            reviewSLAHours: z
+                .number()
+                .min(0)
+                .describe('Maximum hours a spec may remain in review before SLA breach is flagged.'),
+            escalateTo: z
+                .string()
+                .optional()
+                .describe('Email or username to escalate to when SLA is breached (e.g. "team-lead@example.com").'),
+            requireRoles: z
+                .array(z.string())
+                .optional()
+                .describe('Roles allowed to approve specs. If empty or omitted, any reviewer can approve.'),
+        },
+        annotations: { title: 'Configure Approval Policy', destructiveHint: false },
+    }, safeLicensed('configure_approval_policy', (args) => handleConfigureApprovalPolicy(args)));
+    // -------------------------------------------------------------------------
+    // approve_spec — pro tool
+    // -------------------------------------------------------------------------
+    server.registerTool('approve_spec', {
+        description: 'Record that a reviewer has approved a spec. ' +
+            'When the required number of approvals is reached, the approval gate opens.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to approve (e.g. SPEC-042).'),
+            reviewer: z
+                .string()
+                .describe('Name, email, or username of the reviewer approving the spec.'),
+            role: z
+                .string()
+                .optional()
+                .describe('Role of the reviewer (e.g. "tech-lead", "architect").'),
+            comment: z.string().optional().describe('Optional approval comment or notes.'),
+        },
+        annotations: { title: 'Approve Spec', destructiveHint: true },
+    }, safeLicensed('approve_spec', (args) => handleApproveSpec(args)));
+    // -------------------------------------------------------------------------
+    // request_changes — pro tool
+    // -------------------------------------------------------------------------
+    server.registerTool('request_changes', {
+        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().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to request changes on (e.g. SPEC-042).'),
+            reviewer: z
+                .string()
+                .describe('Name, email, or username of the reviewer requesting changes.'),
+            comment: z
+                .string()
+                .min(1)
+                .describe('Required explanation of what needs to change before re-approval.'),
+            role: z.string().optional().describe('Role of the reviewer (e.g. "tech-lead", "qa").'),
+        },
+        annotations: { title: 'Request Changes', destructiveHint: true },
+    }, safeLicensed('request_changes', (args) => handleRequestChanges(args)));
+    // -------------------------------------------------------------------------
+    // approval_status — free tool (read-only)
+    // -------------------------------------------------------------------------
+    server.registerTool('approval_status', {
+        description: 'Show the current approval status for a spec: who approved, how many are needed, ' +
+            'time in review, and SLA breach warning if applicable.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to check (e.g. SPEC-042).'),
+        },
+        annotations: { title: 'Approval Status', readOnlyHint: true },
+    }, safeTracked('approval_status', (args) => handleApprovalStatus(args)));
+}
+//# sourceMappingURL=register-approval-tools.js.map

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

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

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

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

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

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

package/dist/tools/register-comments-tools.js

@@ -0,0 +1,79 @@
+// tools/register-comments-tools.ts — Registers Spec Comments tools on the MCP server (SPEC-282)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleAddComment, handleListComments, handleResolveComment, handleReplyComment, } from './comments-handler.js';
+export function registerCommentsTools(server) {
+    server.registerTool('add_comment', {
+        description: 'Add an inline comment to a spec. Comments can be anchored to a specific acceptance criterion (acIndex) and marked as blocking to prevent readiness approval.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            specId: z
+                .string()
+                .describe('SPEC-XXX identifier of the spec to comment on (e.g. SPEC-042).'),
+            author: z.string().min(1).describe('Free-form author name or handle (e.g. "alice").'),
+            text: z.string().min(1).describe('Comment body text.'),
+            acIndex: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Optional 0-based index of the acceptance criterion this comment is anchored to.'),
+            blocking: z
+                .boolean()
+                .optional()
+                .describe('When true, check_readiness will fail while this comment is unresolved. Defaults to false.'),
+        },
+        annotations: { title: 'Add Comment', destructiveHint: false },
+    }, safeTracked('add_comment', async (args) => handleAddComment(args)));
+    server.registerTool('list_comments', {
+        description: 'List comments for a spec. Optionally filter by resolved status to see open discussions or archived resolutions.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            specId: z
+                .string()
+                .describe('SPEC-XXX identifier of the spec whose comments to list (e.g. SPEC-042).'),
+            resolved: z
+                .boolean()
+                .optional()
+                .describe('Filter by resolved status. true = show only resolved comments, false = show only open comments. Omit to show all comments.'),
+        },
+        annotations: { title: 'List Comments', readOnlyHint: true },
+    }, safeTracked('list_comments', (args) => Promise.resolve(handleListComments(args))));
+    server.registerTool('resolve_comment', {
+        description: 'Mark a comment as resolved. The comment is archived (not deleted) so the discussion history is preserved.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            specId: z
+                .string()
+                .describe('SPEC-XXX identifier of the spec the comment belongs to (e.g. SPEC-042).'),
+            commentId: z
+                .string()
+                .describe('Comment ID to resolve (e.g. CMT-003).'),
+        },
+        annotations: { title: 'Resolve Comment', destructiveHint: false },
+    }, safeTracked('resolve_comment', async (args) => handleResolveComment(args)));
+    server.registerTool('reply_comment', {
+        description: 'Reply to an existing comment, creating a threaded discussion. The reply is linked to the parent comment via parentId.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            specId: z
+                .string()
+                .describe('SPEC-XXX identifier of the spec the thread belongs to (e.g. SPEC-042).'),
+            parentId: z
+                .string()
+                .describe('ID of the parent comment to reply to (e.g. CMT-001).'),
+            author: z.string().min(1).describe('Free-form author name or handle (e.g. "bob").'),
+            text: z.string().min(1).describe('Reply body text.'),
+        },
+        annotations: { title: 'Reply to Comment', destructiveHint: false },
+    }, safeTracked('reply_comment', async (args) => handleReplyComment(args)));
+}
+//# sourceMappingURL=register-comments-tools.js.map

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

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

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

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