@planu/cli 1.1.2 → 1.3.0

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

@@ -0,0 +1,165 @@
+// tools/spec-lint-handler.ts — Handler for Custom Spec Lint Rules Engine (SPEC-364)
+import { loadLintRules, saveLintRule, deleteLintRule } from '../storage/spec-lint-rules-store.js';
+import { generateRuleId, runLint, lintSpec } from '../engine/spec-lint-engine.js';
+import { listSpecs, getSpec } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+export async function handleDefineLintRule(input) {
+    const { projectPath, name, description, when, then, severity, appliesTo } = input;
+    try {
+        const id = generateRuleId(name);
+        const rule = {
+            id,
+            name,
+            description,
+            then,
+            severity,
+            appliesTo,
+            createdAt: new Date().toISOString(),
+            ...(when !== undefined ? { when } : {}),
+        };
+        await saveLintRule(projectPath, rule);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Lint rule "${name}" created (id: ${id}).`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to define lint rule: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleListLintRules(input) {
+    const { projectPath } = input;
+    try {
+        const rules = await loadLintRules(projectPath);
+        if (rules.length === 0) {
+            return {
+                content: [
+                    { type: 'text', text: 'No lint rules defined. Use define_spec_lint_rule to add rules.' },
+                ],
+            };
+        }
+        const lines = rules.map((r) => `- [${r.id}] "${r.name}" (${r.severity}): ${r.description}` +
+            ` | applies to: ${r.appliesTo.all === true ? 'all' : `tags [${(r.appliesTo.tags ?? []).join(', ')}]`}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Lint rules (${String(rules.length)}):\n${lines.join('\n')}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to list lint rules: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleRunSpecLint(input) {
+    const { projectPath, specId } = input;
+    try {
+        const projectId = hashProjectPath(projectPath);
+        const rules = await loadLintRules(projectPath);
+        if (rules.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No lint rules defined. Use define_spec_lint_rule to add rules first.',
+                    },
+                ],
+            };
+        }
+        if (specId !== undefined) {
+            const spec = await getSpec(projectId, specId);
+            if (spec === null) {
+                return {
+                    content: [{ type: 'text', text: `Spec "${specId}" not found.` }],
+                    isError: true,
+                };
+            }
+            const violations = lintSpec(spec, rules);
+            if (violations.length === 0) {
+                return {
+                    content: [{ type: 'text', text: `Spec "${specId}" passed all lint rules.` }],
+                };
+            }
+            const lines = violations.map((v) => `[${v.severity.toUpperCase()}] ${v.message} (rule: ${v.ruleName}, field: ${v.field})`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Lint violations for ${specId} (${String(violations.length)}):\n${lines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        // Run on all specs
+        const specs = await listSpecs(projectId);
+        const result = runLint(specs, rules);
+        result.projectPath = projectPath;
+        if (result.violations.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `All ${String(specs.length)} specs passed lint checks. ` +
+                            `Rules applied: ${String(result.rulesApplied)}.`,
+                    },
+                ],
+            };
+        }
+        const lines = result.violations.map((v) => `[${v.severity.toUpperCase()}] ${v.specId} — ${v.message} (rule: ${v.ruleName})`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Lint results: ${String(result.errorCount)} errors, ${String(result.warningCount)} warnings ` +
+                        `across ${String(result.failedSpecs)} spec(s). ` +
+                        `Passed: ${String(result.passedSpecs)}/${String(specs.length)}.\n\n` +
+                        lines.join('\n'),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to run spec lint: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleDeleteLintRule(input) {
+    const { projectPath, ruleId } = input;
+    try {
+        const deleted = await deleteLintRule(projectPath, ruleId);
+        if (!deleted) {
+            return {
+                content: [{ type: 'text', text: `Lint rule "${ruleId}" not found.` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: `Lint rule "${ruleId}" deleted successfully.` }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to delete lint rule: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=spec-lint-handler.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { ToolResult, SimulateParallelInput, CriticalPathInput, ParallelEfficiencyInput, OptimizeSchedulingInput } from '../types/index.js';
+export declare function handleSimulateParallelExecution(args: SimulateParallelInput): Promise<ToolResult>;
+export declare function handleCriticalPathAnalyzer(args: CriticalPathInput): Promise<ToolResult>;
+export declare function handleParallelEfficiencyScore(args: ParallelEfficiencyInput): Promise<ToolResult>;
+export declare function handleOptimizeSpecScheduling(args: OptimizeSchedulingInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-scheduler-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scheduler-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-scheduler-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AA+B3B,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA4BrB;AAMD,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB7F;AAMD,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAMD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

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

@@ -0,0 +1,108 @@
+import { listSpecs } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { simulateParallelExecution, analyzeCriticalPath, computeParallelEfficiency, optimizeSpecScheduling, } from '../engine/spec-scheduler.js';
+import { formatSuccess, formatError, toolResult } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function getSpecs(projectPath, specIds) {
+    const projectId = hashProjectPath(projectPath);
+    const all = await listSpecs(projectId);
+    if (!specIds || specIds.length === 0) {
+        return all;
+    }
+    return all.filter((s) => specIds.includes(s.id));
+}
+// ---------------------------------------------------------------------------
+// simulate_parallel_execution
+// ---------------------------------------------------------------------------
+export async function handleSimulateParallelExecution(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    if (!Array.isArray(args.specIds) || args.specIds.length === 0) {
+        return toolResult(formatError('specIds must be a non-empty array'), undefined, true);
+    }
+    const specs = await getSpecs(args.projectPath, args.specIds);
+    if (specs.length === 0) {
+        return toolResult(formatError('No matching specs found'), undefined, true);
+    }
+    const numAgents = Math.max(1, Math.min(args.numAgents, 20));
+    const timeline = simulateParallelExecution(specs, numAgents);
+    const lines = [
+        `Specs: ${String(specs.length)} | Agents: ${String(numAgents)}`,
+        `Total hours: ${timeline.totalHours.toFixed(1)}h`,
+        `Critical path: ${timeline.criticalPath.join(' → ') || 'none'}`,
+        '',
+        timeline.ganttChart,
+    ];
+    return toolResult(formatSuccess('Parallel Execution Simulation', lines.join('\n')), timeline);
+}
+// ---------------------------------------------------------------------------
+// critical_path_analyzer
+// ---------------------------------------------------------------------------
+export async function handleCriticalPathAnalyzer(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    const specs = await getSpecs(args.projectPath, args.specIds);
+    if (specs.length === 0) {
+        return toolResult(formatError('No specs found'), undefined, true);
+    }
+    const result = analyzeCriticalPath(specs);
+    const lines = [
+        `Total specs analyzed: ${String(specs.length)}`,
+        `Total estimated hours: ${result.totalHours.toFixed(1)}h`,
+        `Critical path length: ${String(result.longestChainLength)} specs`,
+        `Critical path: ${result.criticalPath.join(' → ') || 'empty'}`,
+    ];
+    return toolResult(formatSuccess('Critical Path Analysis', lines.join('\n')), result);
+}
+// ---------------------------------------------------------------------------
+// parallel_efficiency_score
+// ---------------------------------------------------------------------------
+export async function handleParallelEfficiencyScore(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    if (!Array.isArray(args.specIds) || args.specIds.length === 0) {
+        return toolResult(formatError('specIds must be a non-empty array'), undefined, true);
+    }
+    const specs = await getSpecs(args.projectPath, args.specIds);
+    if (specs.length === 0) {
+        return toolResult(formatError('No matching specs found'), undefined, true);
+    }
+    const numAgents = Math.max(1, Math.min(args.numAgents, 20));
+    const result = computeParallelEfficiency(specs, numAgents);
+    const lines = [
+        `Efficiency score: ${(result.score * 100).toFixed(1)}%`,
+        `Total spec hours: ${result.totalSpecHours.toFixed(1)}h`,
+        `Total agent-hours: ${result.totalAgentHours.toFixed(1)}h`,
+        `Interpretation: ${result.interpretation}`,
+    ];
+    return toolResult(formatSuccess('Parallel Efficiency Score', lines.join('\n')), result);
+}
+// ---------------------------------------------------------------------------
+// optimize_spec_scheduling
+// ---------------------------------------------------------------------------
+export async function handleOptimizeSpecScheduling(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    const specs = await getSpecs(args.projectPath, args.specIds);
+    if (specs.length === 0) {
+        return toolResult(formatError('No specs found'), undefined, true);
+    }
+    const numAgents = Math.max(1, Math.min(args.numAgents ?? 2, 20));
+    const result = optimizeSpecScheduling(specs, numAgents);
+    const lines = [
+        `Optimized order (${String(result.order.length)} specs):`,
+        ...result.order.slice(0, 10).map((id, i) => `  ${String(i + 1)}. ${id}`),
+        result.order.length > 10 ? `  ... and ${String(result.order.length - 10)} more` : '',
+        '',
+        `Expected idle hours: ${result.expectedIdleHours.toFixed(1)}h`,
+        `Suggestion: ${result.suggestion}`,
+    ].filter((l) => l !== '');
+    return toolResult(formatSuccess('Optimized Scheduling', lines.join('\n')), result);
+}
+//# sourceMappingURL=spec-scheduler-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scheduler-handler.js","sourceRoot":"","sources":["../../src/tools/spec-scheduler-handler.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE/E,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,KAAK,UAAU,QAAQ,CACrB,WAAmB,EACnB,OAAkB;IAElB,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,IAA2B;IAE3B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,UAAU,CAAC,WAAW,CAAC,mCAAmC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG;QACZ,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,EAAE;QAC/D,gBAAgB,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACjD,kBAAkB,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE;QAC/D,EAAE;QACF,QAAQ,CAAC,UAAU;KACpB,CAAC;IAEF,OAAO,UAAU,CACf,aAAa,CAAC,+BAA+B,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAChE,QAA8C,CAC/C,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAuB;IACtE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG;QACZ,yBAAyB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QAC/C,0BAA0B,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACzD,yBAAyB,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ;QAClE,kBAAkB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE;KAC/D,CAAC;IAEF,OAAO,UAAU,CACf,aAAa,CAAC,wBAAwB,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EACzD,MAA4C,CAC7C,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,UAAU,CAAC,WAAW,CAAC,mCAAmC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAG;QACZ,qBAAqB,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACvD,qBAAqB,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACxD,sBAAsB,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAC1D,mBAAmB,MAAM,CAAC,cAAc,EAAE;KAC3C,CAAC;IAEF,OAAO,UAAU,CACf,aAAa,CAAC,2BAA2B,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAC5D,MAA4C,CAC7C,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAExD,MAAM,KAAK,GAAG;QACZ,oBAAoB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU;QACzD,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACpF,EAAE;QACF,wBAAwB,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAC9D,eAAe,MAAM,CAAC,UAAU,EAAE;KACnC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAE1B,OAAO,UAAU,CACf,aAAa,CAAC,sBAAsB,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EACvD,MAA4C,CAC7C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { ToolResult } from '../types/index.js';
+export interface SyncSpecFromCodeInput {
+    projectPath: string;
+    filePaths: string[];
+}
+export declare function handleSyncSpecFromCode(input: SyncSpecFromCodeInput): Promise<ToolResult>;
+export interface MarkAsSpecSourceInput {
+    projectPath: string;
+    specId: string;
+    filePath: string;
+    lineNumber?: number;
+}
+export declare function handleMarkAsSpecSource(input: MarkAsSpecSourceInput): Promise<ToolResult>;
+export interface ListSpecBindingsInput {
+    projectPath: string;
+    specId?: string;
+    action?: 'list' | 'unmark';
+    bindingId?: string;
+}
+export declare function handleListSpecBindings(input: ListSpecBindingsInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-source-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-source-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-source-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAmBpD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6B9F;AAMD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyB9F;AAMD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC9F"}

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

@@ -0,0 +1,75 @@
+import { computeSyncFromCode, buildSourceBinding, buildMarkerComment, detectLanguage, } from '../engine/spec-source-sync.js';
+import { getAllBindings, saveAllBindings, upsertBinding, removeBinding, getBindingsForSpec, } from '../storage/spec-bindings-store.js';
+export async function handleSyncSpecFromCode(input) {
+    const existing = await getAllBindings(input.projectPath);
+    const { result, newBindings } = await computeSyncFromCode(input.projectPath, input.filePaths, existing);
+    await saveAllBindings(input.projectPath, newBindings);
+    const lines = [
+        '**Sync Complete**',
+        '',
+        `| Metric | Value |`,
+        `|--------|-------|`,
+        `| Scanned Files | ${result.scannedFiles} |`,
+        `| Bindings Found | ${result.bindingsFound} |`,
+        `| Created | ${result.bindingsCreated} |`,
+        `| Updated | ${result.bindingsUpdated} |`,
+        `| Synced At | ${result.syncedAt} |`,
+    ];
+    if (result.errors.length > 0) {
+        lines.push('', '**Errors**');
+        for (const e of result.errors) {
+            lines.push(`- ${e}`);
+        }
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+export async function handleMarkAsSpecSource(input) {
+    const binding = buildSourceBinding(input.specId, input.filePath, input.lineNumber);
+    await upsertBinding(input.projectPath, binding);
+    const lang = detectLanguage(input.filePath);
+    const marker = buildMarkerComment(input.specId, lang);
+    const lines = [
+        `Binding created: **${input.specId}** → \`${input.filePath}\``,
+        '',
+        `Add this marker to your file:`,
+        '```',
+        marker,
+        '```',
+        '',
+        `Binding ID: ${binding.id}`,
+        `Language: ${binding.language}`,
+        `Status: ${binding.status}`,
+    ];
+    if (input.lineNumber !== undefined) {
+        lines.push(`Line: ${input.lineNumber}`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+export async function handleListSpecBindings(input) {
+    if (input.action === 'unmark' && input.bindingId !== undefined) {
+        await removeBinding(input.projectPath, input.bindingId);
+        return {
+            content: [{ type: 'text', text: `Binding ${input.bindingId} removed.` }],
+        };
+    }
+    const bindings = input.specId !== undefined
+        ? await getBindingsForSpec(input.projectPath, input.specId)
+        : await getAllBindings(input.projectPath);
+    if (bindings.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No spec bindings found.' }],
+        };
+    }
+    const active = bindings.filter((b) => b.status === 'active').length;
+    const stale = bindings.filter((b) => b.status === 'stale').length;
+    const lines = [
+        `**Spec Bindings** (${bindings.length} total | ${active} active | ${stale} stale)`,
+        '',
+    ];
+    for (const b of bindings) {
+        const lineSuffix = b.lineNumber !== undefined ? `:${b.lineNumber}` : '';
+        lines.push(`- \`${b.specId}\` → \`${b.filePath}${lineSuffix}\` [${b.status}]`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=spec-source-handler.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { ToolResult, VisualSpecDiffInput, ThreeWayMergeInput, SmartMergeConflictResolverInput, MergePreviewInput, ApplyMergeInput } from '../types/index.js';
+export declare function handleVisualSpecDiff(args: VisualSpecDiffInput): Promise<ToolResult>;
+export declare function handleThreeWayMerge(args: ThreeWayMergeInput): Promise<ToolResult>;
+export declare function handleSmartMergeConflictResolver(args: SmartMergeConflictResolverInput): Promise<ToolResult>;
+export declare function handleMergePreview(args: MergePreviewInput): Promise<ToolResult>;
+export declare function handleApplyMerge(args: ApplyMergeInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-visual-diff-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-visual-diff-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-visual-diff-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,+BAA+B,EAC/B,iBAAiB,EACjB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAY3B,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBzF;AAGD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BvF;AAGD,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBrF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CjF"}

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

@@ -0,0 +1,130 @@
+// tools/spec-visual-diff-handler.ts — SPEC-362: Visual Spec Diff & 3-way Merge
+import * as fs from 'node:fs/promises';
+import { hashProjectPath } from '../storage/base-store.js';
+import { specStore } from '../storage/index.js';
+import { computeVisualDiff, formatDiffText, threeWayMerge, smartMergeConflictResolver, buildMergePreview, } from '../engine/spec-diff-engine.js';
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleVisualSpecDiff(args) {
+    const labelA = args.labelA ?? 'A';
+    const labelB = args.labelB ?? 'B';
+    const format = args.outputFormat ?? 'html';
+    const result = computeVisualDiff(args.textA, args.textB, labelA, labelB);
+    const summary = `Diff summary: +${String(result.added)} lines, -${String(result.removed)} lines, ` +
+        `${String(result.unchanged)} unchanged (${String(result.linesA)} → ${String(result.linesB)} lines)`;
+    if (format === 'html') {
+        return {
+            content: [
+                { type: 'text', text: summary },
+                { type: 'text', text: result.htmlOutput },
+            ],
+        };
+    }
+    // text format
+    const text = formatDiffText(result.diffLines, labelA, labelB);
+    return { content: [{ type: 'text', text: `${summary}\n\n${text}` }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleThreeWayMerge(args) {
+    const labelA = args.labelA ?? 'A';
+    const labelB = args.labelB ?? 'B';
+    const result = threeWayMerge(args.base, args.textA, args.textB, labelA, labelB);
+    const status = result.hasConflicts
+        ? `Merge completed with ${String(result.conflictCount)} conflict(s). Resolve manually or use \`smart_merge_conflict_resolver\`.`
+        : 'Merge completed successfully with no conflicts.';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    hasConflicts: result.hasConflicts,
+                    conflictCount: result.conflictCount,
+                    mergedText: result.mergedText,
+                    status,
+                }, null, 2),
+            },
+        ],
+    };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleSmartMergeConflictResolver(args) {
+    const result = smartMergeConflictResolver(args.mergedText);
+    const status = result.remainingConflicts === 0
+        ? `All ${String(result.resolvedCount)} conflict(s) resolved automatically.`
+        : `Resolved ${String(result.resolvedCount)} conflict(s). ${String(result.remainingConflicts)} conflict(s) require manual resolution.`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    resolvedCount: result.resolvedCount,
+                    remainingConflicts: result.remainingConflicts,
+                    mergedText: result.mergedText,
+                    status,
+                }, null, 2),
+            },
+        ],
+    };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleMergePreview(args) {
+    const result = buildMergePreview(args.base, args.textA, args.textB);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    canAutoMerge: result.canAutoMerge,
+                    conflictCount: result.mergeResult.conflictCount,
+                    mergedText: result.mergeResult.mergedText,
+                    status: result.canAutoMerge
+                        ? 'This merge can be applied automatically.'
+                        : `${String(result.mergeResult.conflictCount)} conflict(s) need resolution before applying.`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+export async function handleApplyMerge(args) {
+    // Check for unresolved conflict markers
+    if (args.mergedText.includes('<<<<<<<')) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Cannot apply merge: unresolved conflict markers found. Resolve all conflicts first.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const projectId = hashProjectPath(args.projectPath);
+    const spec = await specStore.getSpec(projectId, args.specId);
+    if (spec === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec ${args.specId} not found in project at ${args.projectPath}.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const specPath = spec.specPath;
+        await fs.writeFile(specPath, args.mergedText, 'utf-8');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Merged content applied to spec ${args.specId} at ${specPath}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: 'text', text: `Error applying merge: ${msg}` }], isError: true };
+    }
+}
+//# sourceMappingURL=spec-visual-diff-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-visual-diff-handler.js","sourceRoot":"","sources":["../../src/tools/spec-visual-diff-handler.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASvC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAEvC,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAyB;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAE3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzE,MAAM,OAAO,GACX,kBAAkB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU;QAClF,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;IAEtG,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;gBAC/B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE;aAC1C;SACF,CAAC;IACJ,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,OAAO,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAwB;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhF,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY;QAChC,CAAC,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,0EAA0E;QAChI,CAAC,CAAC,iDAAiD,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,MAAM;iBACP,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,IAAqC;IAErC,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GACV,MAAM,CAAC,kBAAkB,KAAK,CAAC;QAC7B,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,sCAAsC;QAC3E,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,yCAAyC,CAAC;IAE1I,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,MAAM;iBACP,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAuB;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,aAAa;oBAC/C,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU;oBACzC,MAAM,EAAE,MAAM,CAAC,YAAY;wBACzB,CAAC,CAAC,0CAA0C;wBAC5C,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,+CAA+C;iBAC/F,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAqB;IAC1D,wCAAwC;IACxC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qFAAqF;iBAC5F;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE7D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,IAAI,CAAC,MAAM,4BAA4B,IAAI,CAAC,WAAW,GAAG;iBACzE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,IAAI,CAAC,MAAM,OAAO,QAAQ,EAAE;iBACrE;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9F,CAAC;AACH,CAAC"}

package/dist/tools/sweep-integration-handler.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult, CreateSweepIssueInput, SweepStatusInput } from '../types/index.js';
+export declare function handleCreateSweepIssue(input: CreateSweepIssueInput): Promise<ToolResult>;
+export declare function handleSweepStatus(input: SweepStatusInput): ToolResult;
+//# sourceMappingURL=sweep-integration-handler.d.ts.map

package/dist/tools/sweep-integration-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-integration-handler.d.ts","sourceRoot":"","sources":["../../src/tools/sweep-integration-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO7F,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkD9F;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAoCrE"}

package/dist/tools/sweep-integration-handler.js

@@ -0,0 +1,60 @@
+import { createSweepIssue, checkSweepStatus } from '../engine/sweep-issue-generator.js';
+// ---------------------------------------------------------------------------
+// create_sweep_issue
+// ---------------------------------------------------------------------------
+export async function handleCreateSweepIssue(input) {
+    const dryRun = input.dryRun ?? false;
+    let result;
+    try {
+        result = await createSweepIssue(input.specId, input.projectPath, input.githubRepo, dryRun);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `Failed to create Sweep issue: ${msg}` }],
+            isError: true,
+        };
+    }
+    const lines = [];
+    if (dryRun) {
+        lines.push(`## Sweep Issue Preview (dry-run)`, ``, `**Title**: ${result.issueTitle}`, `**Repo**: ${input.githubRepo}`, ``, `### Issue Body`, ``, result.body, ``, `---`, `Run with \`dryRun: false\` to create the issue on GitHub.`);
+    }
+    else {
+        lines.push(`## Sweep Issue Created`, ``, `**Issue URL**: ${result.issueUrl ?? 'unknown'}`, `**Title**: ${result.issueTitle}`, `**Repo**: ${input.githubRepo}`, ``, `Sweep AI will automatically create a PR addressing the acceptance criteria.`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: {
+            issueUrl: result.issueUrl ?? null,
+            body: result.body,
+            dryRun: result.dryRun,
+            issueTitle: result.issueTitle,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// sweep_status
+// ---------------------------------------------------------------------------
+export function handleSweepStatus(input) {
+    const result = checkSweepStatus(input.githubRepo);
+    const lines = ['## Sweep AI Status', ''];
+    lines.push(`| Check | Status |`, `|-------|--------|`, `| gh CLI installed | ${result.ghInstalled ? 'yes' : 'no'} |`, `| sweep label exists | ${result.sweepLabelExists ? 'yes' : 'no'} |`, `| GitHub repo | ${result.githubRepo ?? 'not provided'} |`);
+    if (!result.ghInstalled) {
+        lines.push(``, `gh CLI is not installed. Install it from https://cli.github.com`);
+    }
+    else if (!result.sweepLabelExists && result.githubRepo) {
+        lines.push(``, `The 'sweep' label does not exist on ${result.githubRepo}.`, `Create it with:`, `\`\`\`bash`, `gh label create sweep --repo "${result.githubRepo}" --color 5319e7 --description "Sweep AI task"`, `\`\`\``);
+    }
+    else if (result.sweepLabelExists) {
+        lines.push(``, `Ready to create Sweep issues. Run \`create_sweep_issue\` to proceed.`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: {
+            ghInstalled: result.ghInstalled,
+            sweepLabelExists: result.sweepLabelExists,
+            githubRepo: result.githubRepo ?? null,
+        },
+    };
+}
+//# sourceMappingURL=sweep-integration-handler.js.map