@planu/cli 1.1.1 → 1.2.0

package/dist/tools/context-manager-handler.js

@@ -0,0 +1,180 @@
+// tools/context-manager-handler.ts — SPEC-370: Context Window Management
+import { estimateTokenBreakdown, suggestArchivableSpecs, archiveSpecToPath, restoreArchivedSpecFromPath, listArchivedSpecIds, } from '../engine/context-manager.js';
+import { loadContextConfig, saveContextConfig } from '../storage/context-config-store.js';
+import { specStore } from '../storage/index.js';
+import { getDecisions } from '../storage/decision-store.js';
+import { getLessons } from '../storage/lessons-store.js';
+import { hashProjectPath, projectDataDir } from '../storage/base-store.js';
+const ARCHIVE_SUBDIR = 'archived-context';
+function archiveDir(projectId) {
+    return `${projectDataDir(projectId)}/${ARCHIVE_SUBDIR}`;
+}
+function archiveFilePath(projectId, specId) {
+    return `${archiveDir(projectId)}/${specId}.json`;
+}
+export async function handleContextWindowStatus(input) {
+    const projectId = hashProjectPath(input.projectPath);
+    const [specs, decisions, lessons, config] = await Promise.all([
+        specStore.listSpecs(projectId),
+        getDecisions(projectId).catch(() => []),
+        getLessons(input.projectPath, {}).catch(() => []),
+        loadContextConfig(input.projectPath),
+    ]);
+    const breakdown = estimateTokenBreakdown(specs.length, decisions.length, lessons.length);
+    const pct = Math.round((breakdown.total / config.maxTokens) * 100);
+    const warn = breakdown.total >= config.warnAt;
+    const lines = [
+        `Context window estimate for project:`,
+        ``,
+        `  Specs:     ${breakdown.specs.toLocaleString()} tokens (${breakdown.specCount} specs × ~1,500)`,
+        `  Decisions: ${breakdown.decisions.toLocaleString()} tokens (${breakdown.decisionCount} decisions × ~200)`,
+        `  Lessons:   ${breakdown.lessons.toLocaleString()} tokens (${breakdown.lessonCount} lessons × ~150)`,
+        `  ─────────────────────────────────────`,
+        `  Total:     ${breakdown.total.toLocaleString()} / ${config.maxTokens.toLocaleString()} tokens (${pct}%)`,
+        ``,
+        warn
+            ? `WARNING: Usage is above warn threshold (${config.warnAt.toLocaleString()}). Consider running optimize_context.`
+            : `Status: OK — within budget.`,
+        `Strategy: ${config.strategy}, archive after ${config.archiveAfterDays} days`,
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+export async function handleOptimizeContext(input) {
+    const projectId = hashProjectPath(input.projectPath);
+    const [config, specs] = await Promise.all([
+        loadContextConfig(input.projectPath),
+        specStore.listSpecs(projectId),
+    ]);
+    const suggestion = suggestArchivableSpecs(specs, config.archiveAfterDays);
+    if (input.action === 'apply' && suggestion.specs.length > 0) {
+        const archived = [];
+        for (const s of suggestion.specs) {
+            const spec = specs.find((sp) => sp.id === s.specId);
+            if (!spec) {
+                continue;
+            }
+            const archPath = archiveFilePath(projectId, s.specId);
+            await archiveSpecToPath(archPath, spec);
+            archived.push(s.specId);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Archived ${archived.length} spec(s): ${archived.join(', ')}`,
+                        `Saved ~${suggestion.potentialSavings.toLocaleString()} tokens.`,
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    const specLines = suggestion.specs.map((s) => `  • ${s.specId} — ${s.title} (done ${s.daysSinceDone}d ago, ~${s.estimatedTokens} tokens)`);
+    const lines = [
+        suggestion.recommendation,
+        ...(specLines.length > 0 ? [``, `Candidates:`, ...specLines] : []),
+        ``,
+        `Run with action="apply" to archive these specs.`,
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+export async function handleContextBudgetConfig(input) {
+    const current = await loadContextConfig(input.projectPath);
+    const updated = {
+        maxTokens: input.maxTokens ?? current.maxTokens,
+        strategy: input.strategy ?? current.strategy,
+        warnAt: input.warnAt ?? current.warnAt,
+        archiveAfterDays: input.archiveAfterDays ?? current.archiveAfterDays,
+    };
+    await saveContextConfig(input.projectPath, updated);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Context budget configured:`,
+                    `  maxTokens: ${updated.maxTokens.toLocaleString()}`,
+                    `  strategy: ${updated.strategy}`,
+                    `  warnAt: ${updated.warnAt.toLocaleString()}`,
+                    `  archiveAfterDays: ${updated.archiveAfterDays}`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+export async function handleArchiveSpecContext(input) {
+    const projectId = hashProjectPath(input.projectPath);
+    const spec = await specStore.getSpec(projectId, input.specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec "${input.specId}" not found.` }],
+            isError: true,
+        };
+    }
+    const archPath = archiveFilePath(projectId, input.specId);
+    await archiveSpecToPath(archPath, spec);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Spec "${input.specId}" archived to archived-context/${input.specId}.json`,
+            },
+        ],
+    };
+}
+export function handleCompressSpecHistory(input) {
+    const keepVersions = input.keepVersions ?? 3;
+    // The version history feature (SPEC-spec-version-history) stores versions separately.
+    // We describe what would happen without modifying active data.
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Compress history for spec "${input.specId}":`,
+                    `  Keep last ${keepVersions} version(s)`,
+                    `  Older versions would be removed from spec version history`,
+                    ``,
+                    `NOTE: Version history compression requires spec_version_history data.`,
+                    `If no history exists for this spec, this is a no-op.`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+export async function handleRestoreArchivedContext(input) {
+    const projectId = hashProjectPath(input.projectPath);
+    const archived = await listArchivedSpecIds(archiveDir(projectId));
+    if (!archived.includes(input.specId)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec "${input.specId}" is not in archived-context/. Available: ${archived.join(', ') || 'none'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const archPath = archiveFilePath(projectId, input.specId);
+    const ok = await restoreArchivedSpecFromPath(archPath);
+    if (!ok) {
+        return {
+            content: [{ type: 'text', text: `Failed to restore "${input.specId}".` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Spec "${input.specId}" restored from archived-context/.`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=context-manager-handler.js.map

package/dist/tools/context-manager-handler.js.map

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

package/dist/tools/cost-budget-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult, ConfigureCostBudgetInput, CostAlertRulesInput, CostForecastInput, CostBudgetStatusInput, BudgetHistoryInput } from '../types/index.js';
+export declare function handleConfigureCostBudget(input: ConfigureCostBudgetInput): Promise<ToolResult>;
+export declare function handleCostAlertRules(input: CostAlertRulesInput): Promise<ToolResult>;
+export declare function handleCostForecast(input: CostForecastInput): Promise<ToolResult>;
+export declare function handleCostBudgetStatus(input: CostBudgetStatusInput): Promise<ToolResult>;
+export declare function handleBudgetHistory(input: BudgetHistoryInput): Promise<ToolResult>;
+//# sourceMappingURL=cost-budget-handler.d.ts.map

package/dist/tools/cost-budget-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget-handler.d.ts","sourceRoot":"","sources":["../../src/tools/cost-budget-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AA0B3B,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0E1F;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4DtF;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4C9F;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyCxF"}

package/dist/tools/cost-budget-handler.js

@@ -0,0 +1,242 @@
+// tools/cost-budget-handler.ts — Handler for Cost Budget & Alerts (SPEC-367)
+import { join } from 'node:path';
+import { loadCostBudgetData, saveCostBudgetData, saveAlertRule, deleteAlertRule, } from '../storage/cost-budget-store.js';
+import { generateAlertRuleId, computeForecast, computeBudgetStatus, buildHistoryFromEntries, } from '../engine/cost-budget-manager.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { getEntries } from '../storage/token-ledger-store.js';
+const DEFAULT_DATA_DIR = join(process.cwd(), 'data');
+const DEFAULT_DAYS = 30;
+async function getLedgerEntries(projectPath) {
+    const projectHash = hashProjectPath(projectPath);
+    return getEntries(projectHash, DEFAULT_DATA_DIR, { period: 'all_time' });
+}
+export async function handleConfigureCostBudget(input) {
+    const { projectPath, period, maxUSD, maxTokens, alertThresholds = [50, 80, 100], currency = 'USD', } = input;
+    try {
+        const data = await loadCostBudgetData(projectPath);
+        data.budget = {
+            period,
+            maxUSD,
+            alertThresholds,
+            currency,
+            ...(maxTokens !== undefined ? { maxTokens } : {}),
+        };
+        data.updatedAt = new Date().toISOString();
+        await saveCostBudgetData(projectPath, data);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Cost budget configured: ${currency} ${String(maxUSD)} per ${period}. ` +
+                        `Alert thresholds: ${alertThresholds.map((t) => `${String(t)}%`).join(', ')}.` +
+                        (maxTokens !== undefined ? ` Max tokens: ${String(maxTokens)}.` : ''),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to configure cost budget: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleCostAlertRules(input) {
+    const { projectPath, action, rule, ruleId } = input;
+    try {
+        if (action === 'list') {
+            const data = await loadCostBudgetData(projectPath);
+            if (data.alertRules.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No alert rules configured.' }],
+                };
+            }
+            const lines = data.alertRules.map((r) => `- [${r.id}] ${r.trigger} @ ${String(r.threshold)} → channels: ${r.channels.join(', ')} (cooldown: ${String(r.cooldownMinutes)}min)`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Alert rules (${String(data.alertRules.length)}):\n${lines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        if (action === 'add') {
+            if (rule === undefined) {
+                return {
+                    content: [{ type: 'text', text: 'Must provide rule object when action=add.' }],
+                    isError: true,
+                };
+            }
+            const newRule = {
+                id: generateAlertRuleId(rule.trigger, rule.threshold),
+                trigger: rule.trigger,
+                threshold: rule.threshold,
+                channels: rule.channels,
+                cooldownMinutes: rule.cooldownMinutes ?? 60,
+            };
+            await saveAlertRule(projectPath, newRule);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Alert rule created (id: ${newRule.id}): ${rule.trigger} @ ${String(rule.threshold)}.`,
+                    },
+                ],
+            };
+        }
+        // action === 'remove'
+        if (ruleId === undefined) {
+            return {
+                content: [{ type: 'text', text: 'Must provide ruleId when action=remove.' }],
+                isError: true,
+            };
+        }
+        const deleted = await deleteAlertRule(projectPath, ruleId);
+        if (!deleted) {
+            return {
+                content: [{ type: 'text', text: `Alert rule "${ruleId}" not found.` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: `Alert rule "${ruleId}" removed.` }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to manage alert rules: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleCostForecast(input) {
+    const { projectPath } = input;
+    try {
+        const data = await loadCostBudgetData(projectPath);
+        if (data.budget === undefined) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No budget configured. Use configure_cost_budget first.',
+                    },
+                ],
+            };
+        }
+        const entries = await getLedgerEntries(projectPath);
+        const history = buildHistoryFromEntries(entries, DEFAULT_DAYS);
+        const forecast = computeForecast(history, data.budget.period, data.budget.currency);
+        if (forecast.insufficientData) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Insufficient data for forecast (need at least 3 days, have ${String(forecast.dataPoints)}). ` +
+                            `Current spend: ${data.budget.currency} ${forecast.currentPeriodSpendUSD.toFixed(4)}.`,
+                    },
+                ],
+            };
+        }
+        const projected = forecast.projectedPeriodSpendUSD?.toFixed(4) ?? '?';
+        const percentOfBudget = forecast.projectedPeriodSpendUSD !== null
+            ? ((forecast.projectedPeriodSpendUSD / data.budget.maxUSD) * 100).toFixed(1)
+            : '?';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Cost forecast (${data.budget.period}):\n` +
+                        `- Current spend: ${data.budget.currency} ${forecast.currentPeriodSpendUSD.toFixed(4)}\n` +
+                        `- Projected total: ${data.budget.currency} ${projected} (${percentOfBudget}% of budget)\n` +
+                        `- Days remaining: ${String(forecast.daysRemaining)}\n` +
+                        `- Data points: ${String(forecast.dataPoints)} days`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to compute cost forecast: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleCostBudgetStatus(input) {
+    const { projectPath } = input;
+    try {
+        const data = await loadCostBudgetData(projectPath);
+        const entries = await getLedgerEntries(projectPath);
+        // Compute current period spend
+        const currentSpend = entries.reduce((acc, e) => acc + e.costUsd, 0);
+        const status = computeBudgetStatus(data, currentSpend);
+        const currencyLabel = status.budget?.currency ?? 'USD';
+        const lines = [
+            `Budget status: ${status.status.toUpperCase()}`,
+            `Current spend: ${currencyLabel} ${status.currentSpendUSD.toFixed(4)}`,
+        ];
+        if (status.budget !== null) {
+            lines.push(`Budget: ${currencyLabel} ${String(status.budget.maxUSD)} per ${status.budget.period}`);
+            if (status.percentUsed !== null) {
+                lines.push(`Used: ${status.percentUsed.toFixed(1)}%`);
+            }
+        }
+        else {
+            lines.push('No budget configured.');
+        }
+        if (status.triggeredAlerts.length > 0) {
+            lines.push('\nPending alerts:');
+            status.triggeredAlerts.forEach((a) => lines.push(`  - ${a}`));
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to get budget status: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleBudgetHistory(input) {
+    const { projectPath, days = DEFAULT_DAYS } = input;
+    try {
+        const entries = await getLedgerEntries(projectPath);
+        const history = buildHistoryFromEntries(entries, days);
+        if (history.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No spending history for the last ${String(days)} days.`,
+                    },
+                ],
+            };
+        }
+        const lines = history.map((h) => `- ${h.date}: $${h.spendUSD.toFixed(4)} (${String(h.tokens)} tokens)`);
+        const totalSpend = history.reduce((acc, h) => acc + h.spendUSD, 0);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Budget history (last ${String(days)} days, ${String(history.length)} data points):\n` +
+                        lines.join('\n') +
+                        `\n\nTotal: $${totalSpend.toFixed(4)}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Failed to get budget history: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=cost-budget-handler.js.map

package/dist/tools/cost-budget-handler.js.map

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

package/dist/tools/dependency-impact-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult, RegisterApiSurfaceInput, AnalyzeBreakingChangesInput, CheckApiCompatibilityInput } from '../types/index.js';
+export declare function handleRegisterApiSurface(args: RegisterApiSurfaceInput): Promise<ToolResult>;
+export declare function handleAnalyzeBreakingChanges(args: AnalyzeBreakingChangesInput): Promise<ToolResult>;
+export declare function handleDependencyImpactReport(args: AnalyzeBreakingChangesInput): Promise<ToolResult>;
+export declare function handleCheckApiCompatibility(args: CheckApiCompatibilityInput): Promise<ToolResult>;
+//# sourceMappingURL=dependency-impact-handler.d.ts.map

package/dist/tools/dependency-impact-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-impact-handler.d.ts","sourceRoot":"","sources":["../../src/tools/dependency-impact-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAiB3B,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BjG;AAMD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,UAAU,CAAC,CAiCrB;AAMD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAMD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/tools/dependency-impact-handler.js

@@ -0,0 +1,100 @@
+import { saveApiSurface, loadApiSurfaces, loadApiSurfaceForSpec, } from '../storage/api-surfaces-store.js';
+import { analyzeBreakingChanges, generateImpactReport, checkApiCompatibility, } from '../engine/dependency-impact-analyzer.js';
+import { formatSuccess, formatError, toolResult } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// register_api_surface
+// ---------------------------------------------------------------------------
+export async function handleRegisterApiSurface(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    if (!args.specId.trim()) {
+        return toolResult(formatError('specId is required'), undefined, true);
+    }
+    if (!Array.isArray(args.surfaces) || args.surfaces.length === 0) {
+        return toolResult(formatError('surfaces array must have at least one entry'), undefined, true);
+    }
+    const surface = {
+        specId: args.specId,
+        surfaces: args.surfaces,
+        registeredAt: new Date().toISOString(),
+    };
+    await saveApiSurface(args.projectPath, surface);
+    const body = [
+        `Spec: ${args.specId}`,
+        `Registered surfaces: ${String(args.surfaces.length)}`,
+        ...args.surfaces.map((s) => `  - [${s.type}] ${s.definition.slice(0, 60)}`),
+    ].join('\n');
+    return toolResult(formatSuccess('API Surface Registered', body), surface);
+}
+// ---------------------------------------------------------------------------
+// analyze_breaking_changes
+// ---------------------------------------------------------------------------
+export async function handleAnalyzeBreakingChanges(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    if (!args.specId.trim()) {
+        return toolResult(formatError('specId is required'), undefined, true);
+    }
+    if (!args.changeDescription.trim()) {
+        return toolResult(formatError('changeDescription is required'), undefined, true);
+    }
+    const allSurfaces = await loadApiSurfaces(args.projectPath);
+    const result = analyzeBreakingChanges(args.specId, args.changeDescription, allSurfaces);
+    const lines = [
+        `Source spec: ${result.sourceSpecId}`,
+        `Overall impact: ${result.overallImpact.toUpperCase()}`,
+        `Affected specs: ${String(result.affectedSpecs.length)}`,
+        '',
+    ];
+    for (const a of result.affectedSpecs) {
+        lines.push(`  [${a.impactLevel.toUpperCase()}] ${a.specId}: ${a.reason}`);
+    }
+    if (result.affectedSpecs.length === 0) {
+        lines.push('  No affected specs found.');
+    }
+    return toolResult(formatSuccess('Breaking Changes Analysis', lines.join('\n')), result);
+}
+// ---------------------------------------------------------------------------
+// dependency_impact_report
+// ---------------------------------------------------------------------------
+export async function handleDependencyImpactReport(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    const allSurfaces = await loadApiSurfaces(args.projectPath);
+    const result = analyzeBreakingChanges(args.specId, args.changeDescription, allSurfaces);
+    const html = generateImpactReport(result);
+    return toolResult(formatSuccess('Dependency Impact Report', `HTML report generated for spec ${args.specId}. ${String(result.affectedSpecs.length)} affected specs.\n\n${html.slice(0, 200)}...`), { html, result });
+}
+// ---------------------------------------------------------------------------
+// check_api_compatibility
+// ---------------------------------------------------------------------------
+export async function handleCheckApiCompatibility(args) {
+    if (!args.projectPath.trim()) {
+        return toolResult(formatError('projectPath is required'), undefined, true);
+    }
+    if (!args.specId.trim()) {
+        return toolResult(formatError('specId is required'), undefined, true);
+    }
+    const allSurfaces = await loadApiSurfaces(args.projectPath);
+    const own = await loadApiSurfaceForSpec(args.projectPath, args.specId);
+    const compat = checkApiCompatibility(args.specId, allSurfaces);
+    const lines = [
+        `Spec: ${args.specId}`,
+        `Registered surfaces: ${String(compat.surfaceCount)}`,
+        `Dependent specs: ${String(compat.dependents.length)}`,
+    ];
+    if (!own) {
+        lines.push('  Warning: no API surfaces registered for this spec yet.');
+    }
+    if (compat.dependents.length > 0) {
+        lines.push('', 'Dependents:');
+        for (const d of compat.dependents) {
+            lines.push(`  - ${d}`);
+        }
+    }
+    return toolResult(formatSuccess('API Compatibility Check', lines.join('\n')), compat);
+}
+//# sourceMappingURL=dependency-impact-handler.js.map

package/dist/tools/dependency-impact-handler.js.map

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

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

@@ -0,0 +1,22 @@
+import type { ToolResult } from '../types/index.js';
+export interface GenerateSpecFromDiffHandlerInput {
+    projectPath: string;
+    diff: string;
+    outputMode?: 'draft' | 'create';
+    title?: string;
+}
+export interface GenerateSpecFromPrHandlerInput {
+    projectPath: string;
+    prNumber: number;
+    repoPath?: string;
+    outputMode?: 'draft' | 'create';
+}
+export interface GenerateSpecFromCommitRangeHandlerInput {
+    projectPath: string;
+    commitRange: string;
+    outputMode?: 'draft' | 'create';
+}
+export declare function handleGenerateSpecFromDiff(input: GenerateSpecFromDiffHandlerInput): Promise<ToolResult>;
+export declare function handleGenerateSpecFromPr(input: GenerateSpecFromPrHandlerInput): Promise<ToolResult>;
+export declare function handleGenerateSpecFromCommitRange(input: GenerateSpecFromCommitRangeHandlerInput): Promise<ToolResult>;
+//# sourceMappingURL=diff-spec-generator-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff-spec-generator-handler.d.ts","sourceRoot":"","sources":["../../src/tools/diff-spec-generator-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,mBAAmB,CAAC;AAYxE,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC;AAED,MAAM,WAAW,uCAAuC;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC;AAsCD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,UAAU,CAAC,CAoBrB"}