@planu/cli 0.90.2 → 0.92.0

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":"AAAA,2FAA2F;AAO3F,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAA2B;IACtE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,OAAO,GACX,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,mBAAmB;YACvD,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,YAAY;YAClD,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,WAAW,CAAC;QAErD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,OAAO,EAAE,IAAI,CAAC,OAAO;4BACrB,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,OAAO;4BACP,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;4BAC7B,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;4BACjC,eAAe,EAAE,IAAI,CAAC,eAAe;4BACrC,cAAc,EAAE,IAAI,CAAC,cAAc;yBACpC,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEpC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,GAAG,IAAI,gBAAgB,OAAO,EAAE;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAA6B;IAE7B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAE7E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,MAAM;4BACN,QAAQ,EAAE,EAAE;4BACZ,aAAa,EAAE,CAAC;4BAChB,OAAO,EACL,wCAAwC,MAAM,KAAK;gCACnD,2CAA2C;yBAC9C,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,MAAM;wBACN,QAAQ,EAAE,SAAS;wBACnB,aAAa,EAAE,SAAS,CAAC,MAAM;wBAC/B,OAAO,EAAE,GAAG,SAAS,CAAC,MAAM,wCAAwC,MAAM,IAAI;qBAC/E,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC"}

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"}

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

@@ -0,0 +1,250 @@
+// tools/spec-split-handler.ts — Handlers for analyze_spec_size and split_spec (SPEC-289)
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { specStore } from '../storage/index.js';
+import { analyzeSpecSize, buildChildSpecs } from '../engine/spec-splitter.js';
+import { generateProgressContent } from '../engine/progress-writer.js';
+// ---------------------------------------------------------------------------
+// analyze_spec_size
+// ---------------------------------------------------------------------------
+export async function handleAnalyzeSpecSize(input) {
+    const { projectId, specId } = input;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec "${specId}" not found in project "${projectId}"` }],
+            isError: true,
+        };
+    }
+    // Read spec.md to extract real acceptance criteria
+    const specWithCriteria = await enrichSpecWithCriteria(spec);
+    const analysis = analyzeSpecSize(specWithCriteria);
+    const lines = [
+        `# Spec Size Analysis — ${specId}`,
+        '',
+        `**Spec**: ${spec.title}`,
+        `**Criteria count**: ${String(analysis.criteriaCount)}`,
+        `**Estimated hours**: ${String(analysis.estimatedHours)}h`,
+        '',
+    ];
+    if (analysis.shouldSplit) {
+        lines.push('## Split Recommended');
+        lines.push('');
+        lines.push('**Reasons:**');
+        for (const reason of analysis.reasons) {
+            lines.push(`- ${reason}`);
+        }
+        lines.push('');
+        if (analysis.ambiguousCriteria.length > 0) {
+            lines.push('## Ambiguous Criteria Detected');
+            lines.push('');
+            for (const ac of analysis.ambiguousCriteria) {
+                lines.push(`- ${ac}`);
+            }
+            lines.push('');
+        }
+        lines.push('## Suggested Splits');
+        lines.push('');
+        for (const [i, proposal] of analysis.suggestedSplits.entries()) {
+            lines.push(`### ${String(i + 1)}. ${proposal.title}`);
+            lines.push(proposal.description);
+            if (proposal.dependsOn.length > 0) {
+                lines.push(`**Depends on**: splits ${proposal.dependsOn.map((d) => String(d + 1)).join(', ')}`);
+            }
+            lines.push('');
+        }
+        lines.push('Run `split_spec` to execute the division.');
+    }
+    else {
+        lines.push('## No Split Needed');
+        lines.push('');
+        lines.push('This spec is appropriately sized and does not require splitting.');
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+        structuredContent: {
+            specId: analysis.specId,
+            specTitle: analysis.specTitle,
+            shouldSplit: analysis.shouldSplit,
+            reasons: analysis.reasons,
+            suggestedSplits: analysis.suggestedSplits,
+            criteriaCount: analysis.criteriaCount,
+            estimatedHours: analysis.estimatedHours,
+            ambiguousCriteria: analysis.ambiguousCriteria,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// split_spec
+// ---------------------------------------------------------------------------
+export async function handleSplitSpec(input) {
+    const { projectId, specId, proposedSplits } = input;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec "${specId}" not found in project "${projectId}"` }],
+            isError: true,
+        };
+    }
+    // Resolve proposals: use provided or auto-generate
+    let proposals;
+    if (proposedSplits && proposedSplits.length > 0) {
+        proposals = proposedSplits;
+    }
+    else {
+        const specWithCriteria = await enrichSpecWithCriteria(spec);
+        const analysis = analyzeSpecSize(specWithCriteria);
+        proposals = analysis.suggestedSplits;
+    }
+    if (proposals.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No split proposals available for spec "${specId}". Run analyze_spec_size first.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Load all existing specs to determine next available IDs
+    const allSpecs = await specStore.listSpecs(projectId);
+    const maxId = Math.max(0, ...allSpecs.map((s) => {
+        const match = /^SPEC-(\d+)$/.exec(s.id);
+        return match?.[1] ? parseInt(match[1], 10) : 0;
+    }));
+    const nextIdFn = (index) => {
+        const num = maxId + index + 1;
+        return `SPEC-${String(num).padStart(3, '0')}`;
+    };
+    // Build child specs
+    const childSpecs = buildChildSpecs(spec, proposals, nextIdFn);
+    const childIds = childSpecs.map((c) => c.id);
+    // Persist child specs and create their directories
+    for (const child of childSpecs) {
+        await mkdir(dirname(child.specPath), { recursive: true });
+        const content = buildChildSpecContent(child, spec);
+        await writeFile(child.specPath, content, 'utf-8');
+        await writeFile(child.technicalPath, buildChildTechnicalContent(child, spec), 'utf-8');
+        if (child.progressPath) {
+            await writeFile(child.progressPath, generateProgressContent(child), 'utf-8');
+        }
+        await specStore.createSpec(projectId, child);
+    }
+    // Mark original as superseded
+    await specStore.updateSpec(projectId, specId, {
+        status: 'superseded',
+        reviewNotes: [...(spec.reviewNotes ?? []), `Superseded by: ${childIds.join(', ')}`],
+    });
+    const lines = [
+        `# Split Complete — ${specId}`,
+        '',
+        `**Original spec** \`${specId}\` has been marked as \`superseded\`.`,
+        '',
+        `## Child Specs Created (${String(childSpecs.length)})`,
+        '',
+    ];
+    for (const child of childSpecs) {
+        lines.push(`- \`${child.id}\` — ${child.title}`);
+    }
+    lines.push('');
+    lines.push('Each child spec inherits tags and target from the original.');
+    lines.push('Implement child specs in dependency order.');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: {
+            originalSpecId: specId,
+            supersededBy: childIds,
+            childSpecIds: childIds,
+            childTitles: childSpecs.map((c) => c.title),
+            message: `Spec ${specId} split into ${String(childSpecs.length)} child specs`,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Read spec.md and extract acceptance criteria lines as reviewNotes proxy */
+async function enrichSpecWithCriteria(spec) {
+    /* v8 ignore start -- filesystem reads tested via integration */
+    try {
+        const content = await readFile(spec.specPath, 'utf-8');
+        const criteria = extractAcFromContent(content);
+        return {
+            ...spec,
+            reviewNotes: criteria.length > 0 ? criteria : (spec.reviewNotes ?? []),
+        };
+    }
+    catch {
+        return spec;
+    }
+    /* v8 ignore stop */
+}
+/** Extract acceptance criteria from spec.md content */
+function extractAcFromContent(content) {
+    const acSection = /##\s+Acceptance Criteria\s*\n([\s\S]*?)(?=\n##\s|$)/i.exec(content);
+    if (!acSection?.[1]) {
+        return [];
+    }
+    return acSection[1]
+        .split('\n')
+        .map((line) => line.replace(/^[-*]\s*\[[ x]\]\s*/i, '').trim())
+        .filter((line) => line.length > 10);
+}
+/** Generate minimal spec.md content for a child spec */
+function buildChildSpecContent(child, original) {
+    const now = new Date().toISOString().split('T')[0] ?? '';
+    return [
+        '---',
+        `id: ${child.id}`,
+        `title: "${child.title}"`,
+        `type: ${child.type}`,
+        `scope: ${child.scope}`,
+        `target: ${child.target}`,
+        `status: draft`,
+        `difficulty: ${String(child.difficulty)}`,
+        `risk: ${child.risk}`,
+        `tags: [${child.tags.map((t) => JSON.stringify(t)).join(', ')}]`,
+        `created: ${now}`,
+        '---',
+        '',
+        `# ${child.id}: ${child.title}`,
+        '',
+        '## Description',
+        '',
+        child.reviewNotes?.[0] ?? `Split from ${original.id}: ${original.title}`,
+        '',
+        '## Acceptance Criteria',
+        '',
+        '- [ ] Implementation matches spec requirements',
+        '- [ ] Tests written and passing',
+        '',
+        '## Out of Scope',
+        '',
+        `- Criteria addressed by sibling specs split from ${original.id}`,
+        '',
+    ].join('\n');
+}
+/** Generate minimal technical.md content for a child spec */
+function buildChildTechnicalContent(child, original) {
+    return [
+        `# ${child.id}: ${child.title} — Technical`,
+        '',
+        `## Parent Spec`,
+        '',
+        `Split from \`${original.id}\`: ${original.title}`,
+        '',
+        '## Estimation',
+        '',
+        `| Dev Hours | ${String(child.estimation.devHours)}h |`,
+        `|-----------|--------|`,
+        `| Review Hours | ${String(child.estimation.reviewHours)}h |`,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=spec-split-handler.js.map

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

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