@planu/cli 0.91.0 → 0.92.0

package/dist/tools/search-handler.js.map

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

package/dist/tools/slack-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult, ConfigureSlackInput, SlackNotifyInput, SlackStatusInput, SlackRemoveInput } from '../types/index.js';
+export declare function handleConfigureSlack(input: ConfigureSlackInput): Promise<ToolResult>;
+export declare function handleSlackNotify(input: SlackNotifyInput): Promise<ToolResult>;
+export declare function handleSlackStatus(input: SlackStatusInput): Promise<ToolResult>;
+export declare function handleRemoveSlack(input: SlackRemoveInput): Promise<ToolResult>;
+//# sourceMappingURL=slack-handler.d.ts.map

package/dist/tools/slack-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-handler.d.ts","sourceRoot":"","sources":["../../src/tools/slack-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAc3B,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B1F;AAMD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoDpF;AAMD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0CpF;AAMD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBpF"}

package/dist/tools/slack-handler.js

@@ -0,0 +1,162 @@
+import { getSlackConfig, saveSlackConfig, removeSlackConfig, getDeliveryLog, appendDelivery, } from '../storage/slack-store.js';
+import { buildManualPayload, dispatchToSlack } from '../engine/slack-dispatcher.js';
+// ---------------------------------------------------------------------------
+// configure_slack handler
+// ---------------------------------------------------------------------------
+export async function handleConfigureSlack(input) {
+    const now = new Date().toISOString();
+    const existing = await getSlackConfig(input.projectPath);
+    const config = {
+        webhookUrl: input.webhookUrl,
+        channel: input.channel,
+        projectPath: input.projectPath,
+        enabled: true,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    };
+    await saveSlackConfig(input.projectPath, config);
+    const lines = [
+        'Slack configured successfully.',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Webhook | ${maskUrl(input.webhookUrl)} |`,
+        `| Channel | ${input.channel ?? '(default)'} |`,
+        `| Enabled | Yes |`,
+        `| Updated | ${now} |`,
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// slack_notify handler
+// ---------------------------------------------------------------------------
+export async function handleSlackNotify(input) {
+    const config = await getSlackConfig(input.projectPath);
+    if (config?.enabled !== true) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: Slack is not configured for this project. Run configure_slack first.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const payload = buildManualPayload(input.message, input.specId);
+    const delivery = {
+        id: `dlv-${Date.now()}`,
+        sentAt: new Date().toISOString(),
+        status: 'sent',
+        specId: input.specId,
+        eventType: 'manual',
+    };
+    try {
+        await dispatchToSlack(config.webhookUrl, payload);
+    }
+    catch (err) {
+        delivery.status = 'failed';
+        delivery.error = err instanceof Error ? err.message : String(err);
+        await appendDelivery(input.projectPath, delivery);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error sending Slack notification: ${delivery.error}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    await appendDelivery(input.projectPath, delivery);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Slack notification sent successfully.${input.specId !== undefined ? ` [${input.specId}]` : ''}\n\n> ${input.message}`,
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// slack_status handler
+// ---------------------------------------------------------------------------
+export async function handleSlackStatus(input) {
+    const config = await getSlackConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Slack is not configured for this project. Run configure_slack to set up notifications.',
+                },
+            ],
+        };
+    }
+    const deliveries = await getDeliveryLog(input.projectPath);
+    const lines = [
+        '**Slack Configuration**',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Webhook | ${maskUrl(config.webhookUrl)} |`,
+        `| Channel | ${config.channel ?? '(default)'} |`,
+        `| Enabled | ${config.enabled ? 'Yes' : 'No'} |`,
+        `| Created | ${config.createdAt} |`,
+        `| Updated | ${config.updatedAt} |`,
+        '',
+        `**Delivery Log** (last ${deliveries.length})`,
+        '',
+    ];
+    if (deliveries.length === 0) {
+        lines.push('No deliveries yet.');
+    }
+    else {
+        for (const d of deliveries) {
+            const spec = d.specId !== undefined ? ` [${d.specId}]` : '';
+            const err = d.error !== undefined ? ` — ${d.error}` : '';
+            lines.push(`- ${d.sentAt.slice(0, 19)} | ${d.status}${spec}${err}`);
+        }
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// remove_slack handler
+// ---------------------------------------------------------------------------
+export async function handleRemoveSlack(input) {
+    const config = await getSlackConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Slack is not configured for this project — nothing to remove.',
+                },
+            ],
+        };
+    }
+    await removeSlackConfig(input.projectPath);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Slack configuration removed. Notifications are disabled.',
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function maskUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname;
+        const masked = path.length > 8 ? `${path.slice(0, 4)}...${path.slice(-4)}` : '***';
+        return `${parsed.protocol}//${parsed.host}${masked}`;
+    }
+    catch {
+        return '***';
+    }
+}
+//# sourceMappingURL=slack-handler.js.map

package/dist/tools/slack-handler.js.map

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

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

@@ -0,0 +1,6 @@
+import type { DiffSpecVersionsInput, SpecVersionHistoryInput, ToolResult } from '../types/index.js';
+/** Handler for the diff_spec_versions tool. */
+export declare function handleDiffSpecVersions(args: DiffSpecVersionsInput): Promise<ToolResult>;
+/** Handler for the spec_version_history tool. */
+export declare function handleSpecVersionHistory(args: SpecVersionHistoryInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-diff-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-diff-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-diff-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAQ3B,+CAA+C;AAC/C,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwD7F;AAED,iDAAiD;AACjD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAkDrB"}

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

@@ -0,0 +1,94 @@
+// tools/spec-diff-handler.ts — Handlers for diff_spec_versions and spec_history (SPEC-284)
+import { projectDataDir } from '../storage/index.js';
+import { computeSpecVersionDiff, formatDiffAsText, listSpecVersionHistory, } from '../engine/spec-differ.js';
+/** Handler for the diff_spec_versions tool. */
+export async function handleDiffSpecVersions(args) {
+    const dataDir = projectDataDir(args.projectId);
+    const format = args.format ?? 'text';
+    try {
+        const diff = await computeSpecVersionDiff({
+            dataDir,
+            specId: args.specId,
+            fromVersion: args.fromVersion,
+            toVersion: args.toVersion,
+        });
+        const summary = `${diff.criteriaChanges.added.length} criteria added, ` +
+            `${diff.criteriaChanges.removed.length} removed, ` +
+            `${diff.criteriaChanges.modified.length} modified`;
+        if (format === 'json') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            specId: diff.specId,
+                            fromTag: diff.fromTag,
+                            toTag: diff.toTag,
+                            summary,
+                            linesAdded: diff.added.length,
+                            linesRemoved: diff.removed.length,
+                            criteriaChanges: diff.criteriaChanges,
+                            sectionChanges: diff.sectionChanges,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        // text format (default)
+        const text = formatDiffAsText(diff);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${text}\n\nSummary: ${summary}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+}
+/** Handler for the spec_version_history tool. */
+export async function handleSpecVersionHistory(args) {
+    const { projectId, specId, limit } = args;
+    const dataDir = projectDataDir(projectId);
+    try {
+        const summaries = await listSpecVersionHistory(dataDir, specId, limit ?? 20);
+        if (summaries.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            specId,
+                            versions: [],
+                            totalVersions: 0,
+                            message: `No version snapshots found for spec "${specId}". ` +
+                                `Create snapshots with version_spec first.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        specId,
+                        versions: summaries,
+                        totalVersions: summaries.length,
+                        message: `${summaries.length} version snapshot(s) found for spec "${specId}".`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+    }
+}
+//# sourceMappingURL=spec-diff-handler.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { ToolResult } from '../types/index.js';
+import type { ExportInput } from '../types/spec-export.js';
+export declare function handleExportSpecsCsv(args: ExportInput): Promise<ToolResult>;
+export declare function handleExportSpecsMarkdown(args: ExportInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-export-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-export-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-export-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,yBAAyB,CAAC;AAgDzE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBjF;AAMD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBtF"}

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

@@ -0,0 +1,64 @@
+// tools/spec-export-handler.ts — Handlers for export_specs_csv and export_specs_markdown — SPEC-298
+import { writeFile } from 'node:fs/promises';
+import { listSpecs } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { filterSpecs, specsToCsv, specsToMarkdownTable, ALL_COLUMNS, } from '../engine/spec-exporter.js';
+import { formatSuccess, formatError, toolResult } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// Shared logic
+// ---------------------------------------------------------------------------
+async function buildExport(input, format) {
+    const projectId = hashProjectPath(input.projectPath);
+    const allSpecs = await listSpecs(projectId);
+    const filtered = filterSpecs(allSpecs, input);
+    const columns = input.columns && input.columns.length > 0 ? input.columns : ALL_COLUMNS;
+    const content = format === 'csv' ? specsToCsv(filtered, columns) : specsToMarkdownTable(filtered, columns);
+    let filePath;
+    if (input.outputPath) {
+        await writeFile(input.outputPath, content, 'utf8');
+        filePath = input.outputPath;
+    }
+    const result = {
+        rowCount: filtered.length,
+        columns,
+        format,
+        content,
+        filePath,
+    };
+    return { text: content, result };
+}
+// ---------------------------------------------------------------------------
+// CSV handler
+// ---------------------------------------------------------------------------
+export async function handleExportSpecsCsv(args) {
+    if (!args.projectPath || args.projectPath.trim().length === 0) {
+        return toolResult(formatError('projectPath is required', 'Provide the absolute path to your project root.'), undefined, true);
+    }
+    const { text, result } = await buildExport(args, 'csv');
+    const summary = [
+        `Exported ${String(result.rowCount)} specs to CSV`,
+        `Columns: ${result.columns.join(', ')}`,
+        result.filePath ? `Saved to: ${result.filePath}` : 'No file written (outputPath not provided)',
+        '',
+        text,
+    ].join('\n');
+    return toolResult(formatSuccess('Spec Export — CSV', summary), result);
+}
+// ---------------------------------------------------------------------------
+// Markdown handler
+// ---------------------------------------------------------------------------
+export async function handleExportSpecsMarkdown(args) {
+    if (!args.projectPath || args.projectPath.trim().length === 0) {
+        return toolResult(formatError('projectPath is required', 'Provide the absolute path to your project root.'), undefined, true);
+    }
+    const { text, result } = await buildExport(args, 'markdown');
+    const summary = [
+        `Exported ${String(result.rowCount)} specs to Markdown table`,
+        `Columns: ${result.columns.join(', ')}`,
+        result.filePath ? `Saved to: ${result.filePath}` : 'No file written (outputPath not provided)',
+        '',
+        text,
+    ].join('\n');
+    return toolResult(formatSuccess('Spec Export — Markdown', summary), result);
+}
+//# sourceMappingURL=spec-export-handler.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { ToolResult, LockInput, UnlockInput, ListLocksInput, CheckLockInput } from '../types/index.js';
+/** Acquire a lock on a spec. Fails if already locked by a different holder. */
+export declare function handleLockSpec(input: LockInput): Promise<ToolResult>;
+/** Release a lock on a spec. */
+export declare function handleUnlockSpec(input: UnlockInput): Promise<ToolResult>;
+/** List all active (non-expired) locks for a project. */
+export declare function handleListLocks(input: ListLocksInput): Promise<ToolResult>;
+/** Check whether a specific spec is currently locked. */
+export declare function handleCheckSpecLock(input: CheckLockInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-lock-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-lock-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-lock-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAkC3B,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAkD1E;AAED,gCAAgC;AAChC,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsC9E;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BhF;AAED,yDAAyD;AACzD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAmCpF"}

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

@@ -0,0 +1,163 @@
+// tools/spec-lock-handler.ts — Business logic for spec locking tools (SPEC-301)
+import { getLock, saveLock, deleteLock, listActiveLocks, isExpired, } from '../storage/spec-lock-store.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MIN_TTL_MINUTES = 1;
+const MAX_TTL_MINUTES = 480;
+const DEFAULT_TTL_MINUTES = 30;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clampTtl(ttlMinutes) {
+    const ttl = ttlMinutes ?? DEFAULT_TTL_MINUTES;
+    return Math.min(Math.max(ttl, MIN_TTL_MINUTES), MAX_TTL_MINUTES);
+}
+function buildExpiresAt(ttlMinutes) {
+    return new Date(Date.now() + ttlMinutes * 60 * 1000).toISOString();
+}
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+/** Acquire a lock on a spec. Fails if already locked by a different holder. */
+export async function handleLockSpec(input) {
+    const { projectPath, specId, lockHolder, reason } = input;
+    const ttlMinutes = clampTtl(input.ttlMinutes);
+    try {
+        const existing = await getLock(projectPath, specId);
+        if (existing !== null && !isExpired(existing) && existing.lockHolder !== lockHolder) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Spec ${specId} is already locked by "${existing.lockHolder}" ` +
+                            `(expires ${existing.expiresAt}). ` +
+                            `Use unlock_spec with force=true to override.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const now = new Date().toISOString();
+        const lock = {
+            specId,
+            lockHolder,
+            lockedAt: now,
+            expiresAt: buildExpiresAt(ttlMinutes),
+            ...(reason !== undefined ? { reason } : {}),
+        };
+        await saveLock(projectPath, specId, lock);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec ${specId} locked by "${lockHolder}" for ${String(ttlMinutes)} minutes ` +
+                        `(expires ${lock.expiresAt}).`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to lock spec: ${message}` }],
+            isError: true,
+        };
+    }
+}
+/** Release a lock on a spec. */
+export async function handleUnlockSpec(input) {
+    const { projectPath, specId, lockHolder, force = false } = input;
+    try {
+        const existing = await getLock(projectPath, specId);
+        if (existing === null || isExpired(existing)) {
+            return {
+                content: [{ type: 'text', text: `Spec ${specId} is not locked.` }],
+            };
+        }
+        if (existing.lockHolder !== lockHolder && !force) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Cannot unlock: spec ${specId} is held by "${existing.lockHolder}", ` +
+                            `not "${lockHolder}". Use force=true to override.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        await deleteLock(projectPath, specId);
+        return {
+            content: [{ type: 'text', text: `Spec ${specId} unlocked successfully.` }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to unlock spec: ${message}` }],
+            isError: true,
+        };
+    }
+}
+/** List all active (non-expired) locks for a project. */
+export async function handleListLocks(input) {
+    const { projectPath } = input;
+    try {
+        const locks = await listActiveLocks(projectPath);
+        if (locks.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No active locks found.' }],
+            };
+        }
+        const rows = locks
+            .map((l) => `- ${l.specId}: locked by "${l.lockHolder}" until ${l.expiresAt}` +
+            (l.reason !== undefined ? ` (${l.reason})` : ''))
+            .join('\n');
+        return {
+            content: [{ type: 'text', text: `Active locks (${String(locks.length)}):\n${rows}` }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to list locks: ${message}` }],
+            isError: true,
+        };
+    }
+}
+/** Check whether a specific spec is currently locked. */
+export async function handleCheckSpecLock(input) {
+    const { projectPath, specId } = input;
+    try {
+        const lock = await getLock(projectPath, specId);
+        let result;
+        if (lock === null || isExpired(lock)) {
+            result = { locked: false };
+        }
+        else {
+            result = {
+                locked: true,
+                lockHolder: lock.lockHolder,
+                expiresAt: lock.expiresAt,
+                ...(lock.reason !== undefined ? { reason: lock.reason } : {}),
+            };
+        }
+        const text = result.locked
+            ? `Spec ${specId} is locked by "${result.lockHolder}" until ${result.expiresAt ?? ''}.` +
+                (result.reason !== undefined ? ` Reason: ${result.reason}` : '')
+            : `Spec ${specId} is not locked.`;
+        return {
+            content: [{ type: 'text', text }],
+            structuredContent: result,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to check lock: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=spec-lock-handler.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ToolResult, AnalyzeSpecSizeInput, SplitSpecInput } from '../types/index.js';
+export declare function handleAnalyzeSpecSize(input: AnalyzeSpecSizeInput): Promise<ToolResult>;
+export declare function handleSplitSpec(input: SplitSpecInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-split-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-split-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-split-handler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,cAAc,EAGf,MAAM,mBAAmB,CAAC;AAM3B,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgF5F;AAMD,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAiGhF"}