@planu/cli 1.1.2 → 1.3.0

package/dist/tools/register-code-impact-tools.js

@@ -0,0 +1,58 @@
+// tools/register-code-impact-tools.ts — Registers Code Change → Spec Impact Analyzer tools (SPEC-366)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleAnalyzeCodeImpact, handleCodeChangeCompliance, handleSuggestSpecUpdate, handleGitDiffToSpecImpact, } from './code-impact-handler.js';
+export function registerCodeImpactTools(server) {
+    server.registerTool('analyze_code_impact', {
+        description: 'Analyze which specs are impacted by a code change. ' +
+            'Provide filePath, diffText, or both. ' +
+            'Returns related specs with relation type: direct-binding, filename-match, or semantic-match.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z
+                .string()
+                .optional()
+                .describe('Path to the changed file (relative or absolute).'),
+            diffText: z
+                .string()
+                .optional()
+                .describe('Raw diff text (e.g. output of git diff). Used for semantic matching.'),
+        },
+        annotations: { title: 'Analyze Code Impact', readOnlyHint: true },
+    }, safeTracked('analyze_code_impact', (args) => handleAnalyzeCodeImpact(args)));
+    server.registerTool('code_change_compliance', {
+        description: 'Check whether a code change is justified by an approved spec. ' +
+            'Returns a compliance score (0-100%), justifying specs, and unjustified changes. ' +
+            'A change is justified if there is at least one related spec in approved/implementing/in-progress/done status.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z
+                .string()
+                .optional()
+                .describe('Path to the changed file to check compliance for.'),
+            commitHash: z
+                .string()
+                .optional()
+                .describe('Git commit hash to analyze (uses git show internally).'),
+        },
+        annotations: { title: 'Code Change Compliance', readOnlyHint: true },
+    }, safeTracked('code_change_compliance', (args) => handleCodeChangeCompliance(args)));
+    server.registerTool('suggest_spec_update', {
+        description: 'Suggest which specs to update (or create) based on a changed file. ' +
+            'Returns a list of suggestions with type (update/create), spec ID, and reason.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z.string().min(1).max(4096).describe('Path to the changed file.'),
+        },
+        annotations: { title: 'Suggest Spec Update', readOnlyHint: true },
+    }, safeTracked('suggest_spec_update', (args) => handleSuggestSpecUpdate(args)));
+    server.registerTool('git_diff_to_spec_impact', {
+        description: 'Run git diff HEAD on the project and analyze which specs are impacted. ' +
+            'Convenience alias that combines git diff + analyze_code_impact.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'Git Diff to Spec Impact', readOnlyHint: true },
+    }, safeTracked('git_diff_to_spec_impact', (args) => handleGitDiffToSpecImpact(args)));
+}
+//# sourceMappingURL=register-code-impact-tools.js.map

package/dist/tools/register-code-impact-tools.js.map

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

package/dist/tools/register-compliance-audit-tools.d.ts

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

package/dist/tools/register-compliance-audit-tools.d.ts.map

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

package/dist/tools/register-compliance-audit-tools.js

@@ -0,0 +1,106 @@
+// tools/register-compliance-audit-tools.ts — SPEC-371: Register Compliance & Audit tools
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleGenerateComplianceReport, handleAuditLogExport, handleDataRetentionPolicy, handleComplianceGapAnalysis, } from './compliance-audit-handler.js';
+const STANDARD_DESCRIBE = 'Compliance standard. Valid values: soc2-type2 | iso27001 | gdpr | hipaa | custom';
+const FORMAT_DESCRIBE = 'Output format. Valid values: html | json';
+const EXPORT_FORMAT_DESCRIBE = 'Export format. Valid values: csv | json | json-ld';
+export function registerComplianceAuditTools(server) {
+    server.registerTool('generate_compliance_report', {
+        description: 'Generate a compliance report mapping Planu features to controls for a given standard ' +
+            '(SOC2 Type 2, ISO 27001, GDPR, HIPAA). ' +
+            'Returns HTML or JSON with control status (satisfied / partial / gap).',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            standard: z
+                .enum(['soc2-type2', 'iso27001', 'gdpr', 'hipaa', 'custom'])
+                .describe(STANDARD_DESCRIBE),
+            outputFormat: z.enum(['html', 'json']).optional().describe(FORMAT_DESCRIBE),
+        },
+        annotations: {
+            title: 'Generate Compliance Report',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('generate_compliance_report', (args) => Promise.resolve(handleGenerateComplianceReport(args))));
+    server.registerTool('audit_log_export', {
+        description: 'Export the project audit trail in CSV, JSON, or JSON-LD format. ' +
+            'Supports optional date range filtering. ' +
+            'Use for compliance reviews, security audits, or data archiving.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            format: z.enum(['csv', 'json', 'json-ld']).optional().describe(EXPORT_FORMAT_DESCRIBE),
+            dateRange: z
+                .object({
+                from: z.string().max(50).optional().describe('Start date ISO string (e.g. 2024-01-01)'),
+                to: z.string().max(50).optional().describe('End date ISO string (e.g. 2024-12-31)'),
+            })
+                .optional()
+                .describe('Optional date range filter for audit entries'),
+        },
+        annotations: {
+            title: 'Export Audit Log',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('audit_log_export', async (args) => handleAuditLogExport(args)));
+    server.registerTool('data_retention_policy', {
+        description: 'Configure the data retention policy for the project. ' +
+            'Specifies how long data should be retained and whether auto-deletion is enabled. ' +
+            'NOTE: Policy describes intent; auto-delete does not run automatically.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            retentionDays: z
+                .number()
+                .int()
+                .min(1)
+                .max(3650)
+                .describe('Number of days to retain data (e.g. 365 for one year)'),
+            autoDelete: z
+                .boolean()
+                .optional()
+                .describe('Whether data should be auto-deleted after retentionDays (default: false)'),
+            notifyBeforeDeleteDays: z
+                .number()
+                .int()
+                .min(0)
+                .max(365)
+                .optional()
+                .describe('Days before deletion to notify (default: 7)'),
+        },
+        annotations: {
+            title: 'Configure Data Retention Policy',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('data_retention_policy', async (args) => handleDataRetentionPolicy(args)));
+    server.registerTool('compliance_gap_analysis', {
+        description: 'Analyze which controls of a compliance standard are NOT fully satisfied by Planu ' +
+            'and provide recommendations to close the gaps. ' +
+            'Returns gaps with severity (critical / high / medium / low).',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            standard: z
+                .enum(['soc2-type2', 'iso27001', 'gdpr', 'hipaa', 'custom'])
+                .describe(STANDARD_DESCRIBE),
+        },
+        annotations: {
+            title: 'Compliance Gap Analysis',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('compliance_gap_analysis', (args) => Promise.resolve(handleComplianceGapAnalysis(args))));
+}
+//# sourceMappingURL=register-compliance-audit-tools.js.map

package/dist/tools/register-compliance-audit-tools.js.map

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

package/dist/tools/register-context-manager-tools.d.ts

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

package/dist/tools/register-context-manager-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-manager-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-context-manager-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoLnE"}

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

@@ -0,0 +1,138 @@
+// tools/register-context-manager-tools.ts — SPEC-370: Register Context Window Management tools
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleContextWindowStatus, handleOptimizeContext, handleContextBudgetConfig, handleArchiveSpecContext, handleCompressSpecHistory, handleRestoreArchivedContext, } from './context-manager-handler.js';
+const STRATEGY_DESCRIBE = 'Archiving strategy. Valid values: archive-oldest | archive-done | compress-history | manual';
+export function registerContextManagerTools(server) {
+    server.registerTool('context_window_status', {
+        description: 'Estimate the number of tokens consumed by the project context. ' +
+            'Uses heuristics: ~1,500 tokens per spec, ~200 per decision, ~150 per lesson. ' +
+            'Shows breakdown by category and compares to configured budget.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+        },
+        annotations: {
+            title: 'Context Window Status',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('context_window_status', async (args) => handleContextWindowStatus(args)));
+    server.registerTool('optimize_context', {
+        description: 'Identify specs that are candidates for archiving to reduce context token usage. ' +
+            'Candidates are done specs older than the configured archiveAfterDays threshold. ' +
+            'Use action="apply" to actually archive them.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            action: z
+                .enum(['suggest', 'apply'])
+                .optional()
+                .describe('Action to take. Valid values: suggest (default, lists candidates) | apply (archives candidates)'),
+        },
+        annotations: {
+            title: 'Optimize Context',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('optimize_context', async (args) => handleOptimizeContext(args)));
+    server.registerTool('context_budget_config', {
+        description: 'Configure the context window budget: maximum tokens, warning threshold, archiving strategy, ' +
+            'and number of days after which done specs are eligible for archiving.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            maxTokens: z
+                .number()
+                .int()
+                .min(10_000)
+                .max(2_000_000)
+                .optional()
+                .describe('Maximum token budget (default: 200,000)'),
+            strategy: z
+                .enum(['archive-oldest', 'archive-done', 'compress-history', 'manual'])
+                .optional()
+                .describe(STRATEGY_DESCRIBE),
+            warnAt: z
+                .number()
+                .int()
+                .min(1_000)
+                .optional()
+                .describe('Token count at which to warn (default: 150,000)'),
+            archiveAfterDays: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe('Days after done before a spec is eligible for archiving (default: 30)'),
+        },
+        annotations: {
+            title: 'Configure Context Budget',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('context_budget_config', async (args) => handleContextBudgetConfig(args)));
+    server.registerTool('archive_spec_context', {
+        description: 'Archive a specific spec to the archived-context/ directory to free up context tokens. ' +
+            'The spec data is preserved and can be restored with restore_archived_context.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            specId: z.string().min(1).max(200).describe('Spec ID to archive (e.g. SPEC-001)'),
+        },
+        annotations: {
+            title: 'Archive Spec Context',
+            readOnlyHint: false,
+            destructiveHint: false,
+        },
+    }, safeLicensed('archive_spec_context', async (args) => handleArchiveSpecContext(args)));
+    server.registerTool('compress_spec_history', {
+        description: 'Describe what would happen when compressing spec version history, keeping only the most recent N versions. ' +
+            'Reduces token usage from version diffs stored in spec-version-history.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            specId: z.string().min(1).max(200).describe('Spec ID whose version history to compress'),
+            keepVersions: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Number of recent versions to keep (default: 3)'),
+        },
+        annotations: {
+            title: 'Compress Spec History',
+            readOnlyHint: false,
+            destructiveHint: true,
+        },
+    }, safeLicensed('compress_spec_history', (args) => Promise.resolve(handleCompressSpecHistory(args))));
+    server.registerTool('restore_archived_context', {
+        description: 'Restore a previously archived spec from archived-context/ back to the active project context.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            specId: z.string().min(1).max(200).describe('Spec ID to restore from archive'),
+        },
+        annotations: {
+            title: 'Restore Archived Context',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('restore_archived_context', async (args) => handleRestoreArchivedContext(args)));
+}
+//# sourceMappingURL=register-context-manager-tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleConfigureContinue, handleContinueStatus } from './continue-config-handler.js';
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root.');
+export function registerContinueTools(server) {
+    server.registerTool('configure_continue', {
+        description: 'Generate .continue/config.json with a Planu MCP server entry for real-time spec adherence in the IDE. ' +
+            'Supports stdio (local npx) and sse (hosted) transports. ' +
+            'Adds slash commands: /spec, /validate, /criteria.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            transport: z
+                .enum(['stdio', 'sse'])
+                .describe('MCP transport to use. ' +
+                '"stdio" runs Planu locally via npx (recommended for local dev). ' +
+                '"sse" connects to a hosted Planu server — requires hostedUrl.'),
+            hostedUrl: z
+                .url()
+                .optional()
+                .describe('URL of the hosted Planu SSE server. Required when transport is "sse". ' +
+                'Example: "https://planu.example.com/mcp/sse".'),
+        },
+        annotations: { title: 'Configure Continue.dev Integration' },
+    }, safeLicensed('configure_continue', (args) => handleConfigureContinue(args)));
+    server.registerTool('continue_status', {
+        description: 'Check whether .continue/config.json exists and has a Planu MCP entry. ' +
+            'Returns configured status, transport type, and config file path.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+        },
+        annotations: { title: 'Continue.dev Integration Status', readOnlyHint: true },
+    }, safeLicensed('continue_status', (args) => handleContinueStatus(args)));
+}
+//# sourceMappingURL=register-continue-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-continue-tools.js","sourceRoot":"","sources":["../../src/tools/register-continue-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAG7F,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,IAAI,CAAC;KACT,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAElD,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,wGAAwG;YACxG,0DAA0D;YAC1D,mDAAmD;QACrD,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;YAC9B,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;iBACtB,QAAQ,CACP,wBAAwB;gBACtB,kEAAkE;gBAClE,+DAA+D,CAClE;YACH,SAAS,EAAE,CAAC;iBACT,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CACP,wEAAwE;gBACtE,+CAA+C,CAClD;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE;KAC7D,EACD,YAAY,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC1C,uBAAuB,CAAC,IAA8B,CAAC,CACxD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,wEAAwE;YACxE,kEAAkE;QACpE,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;SAC/B;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,YAAY,EAAE,IAAI,EAAE;KAC9E,EACD,YAAY,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAA2B,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-cost-budget-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-cost-budget-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6H/D"}

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

@@ -0,0 +1,98 @@
+// tools/register-cost-budget-tools.ts — Registers Cost Budget & Alerts tools (SPEC-367)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureCostBudget, handleCostAlertRules, handleCostForecast, handleCostBudgetStatus, handleBudgetHistory, } from './cost-budget-handler.js';
+export function registerCostBudgetTools(server) {
+    server.registerTool('configure_cost_budget', {
+        description: 'Configure a cost budget for a project. ' +
+            'Sets the maximum spending per period (daily/weekly/monthly/total) in USD or EUR. ' +
+            'Alert thresholds define at what percentage of budget to trigger alerts.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            period: z
+                .enum(['daily', 'weekly', 'monthly', 'total'])
+                .describe('Budget period. Values: daily, weekly, monthly, total.'),
+            maxUSD: z.number().positive().describe('Maximum spend in USD for the period.'),
+            maxTokens: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Optional maximum token count for the period.'),
+            alertThresholds: z
+                .array(z.number().min(0).max(100))
+                .optional()
+                .describe('Alert thresholds as percentages. Default: [50, 80, 100].'),
+            currency: z
+                .enum(['USD', 'EUR'])
+                .optional()
+                .describe('Currency for display. Values: USD, EUR. Default: USD.'),
+        },
+        annotations: { title: 'Configure Cost Budget' },
+    }, safeTracked('configure_cost_budget', (args) => handleConfigureCostBudget(args)));
+    server.registerTool('cost_alert_rules', {
+        description: 'Manage cost alert rules. ' +
+            'List, add, or remove rules that describe when to alert based on spending. ' +
+            'Rules can trigger on budget-percent (% of budget used) or absolute-usd (dollar amount). ' +
+            'Channels describe where alerts would be sent (slack, email, desktop, all).',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            action: z
+                .enum(['list', 'add', 'remove'])
+                .describe('Action to perform. Values: list, add, remove.'),
+            rule: z
+                .object({
+                trigger: z
+                    .enum(['budget-percent', 'absolute-usd'])
+                    .describe('Trigger type. Values: budget-percent, absolute-usd.'),
+                threshold: z.number().describe('Threshold value (percent or USD amount).'),
+                channels: z
+                    .array(z.enum(['slack', 'email', 'desktop', 'all']))
+                    .describe('Channels to alert. Values: slack, email, desktop, all.'),
+                cooldownMinutes: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe('Minimum minutes between repeated alerts. Default: 60.'),
+            })
+                .optional()
+                .describe('Rule definition. Required when action=add.'),
+            ruleId: z.string().optional().describe('Rule ID to remove. Required when action=remove.'),
+        },
+        annotations: { title: 'Cost Alert Rules' },
+    }, safeTracked('cost_alert_rules', (args) => handleCostAlertRules(args)));
+    server.registerTool('cost_forecast', {
+        description: 'Forecast total spending for the current budget period. ' +
+            'Uses the last 7 days of token_usage data to project period-end spend. ' +
+            'Returns "insufficient data" if fewer than 3 days of data are available.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'Cost Forecast', readOnlyHint: true },
+    }, safeTracked('cost_forecast', (args) => handleCostForecast(args)));
+    server.registerTool('cost_budget_status', {
+        description: 'Get current budget status: current spend vs budget, percentage used, ' +
+            'and any alert rules that would be triggered. ' +
+            'Status can be ok, warning, critical, or no-budget.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'Cost Budget Status', readOnlyHint: true },
+    }, safeTracked('cost_budget_status', (args) => handleCostBudgetStatus(args)));
+    server.registerTool('budget_history', {
+        description: 'View daily spending history for the project. ' +
+            'Returns a per-day breakdown of USD spend and token count for the last N days (default: 30).',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            days: z
+                .number()
+                .int()
+                .min(1)
+                .max(365)
+                .optional()
+                .describe('Number of days of history to return. Default: 30.'),
+        },
+        annotations: { title: 'Budget History', readOnlyHint: true },
+    }, safeTracked('budget_history', (args) => handleBudgetHistory(args)));
+}
+//# sourceMappingURL=register-cost-budget-tools.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-dependency-impact-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-dependency-impact-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsErE"}

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleRegisterApiSurface, handleAnalyzeBreakingChanges, handleDependencyImpactReport, handleCheckApiCompatibility, } from './dependency-impact-handler.js';
+const SURFACE_TYPE_ENUM = z
+    .enum(['rest-endpoint', 'graphql', 'typescript-interface', 'database-schema', 'event'])
+    .describe('Surface type. Values: rest-endpoint, graphql, typescript-interface, database-schema, event.');
+const surfaceSchema = z.object({
+    type: SURFACE_TYPE_ENUM,
+    definition: z.string().min(1).max(500).describe('Description of the surface.'),
+    isBreakingIfRemoved: z
+        .boolean()
+        .optional()
+        .describe('Whether removing this surface would be a breaking change.'),
+});
+export function registerDependencyImpactTools(server) {
+    // register_api_surface
+    server.registerTool('register_api_surface', {
+        description: 'Register or update the API surfaces exposed by a spec (REST endpoints, GraphQL schemas, TypeScript interfaces, database schemas, or events).',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).describe('ID of the spec that exposes these surfaces.'),
+            surfaces: z.array(surfaceSchema).min(1).describe('List of API surface definitions.'),
+        },
+    }, safeTracked('register_api_surface', async (args) => handleRegisterApiSurface(args)));
+    // analyze_breaking_changes
+    server.registerTool('analyze_breaking_changes', {
+        description: "Analyze which other specs may be impacted by a change to a spec's API surface. Returns affected specs with impact level (high/medium/low).",
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).describe('ID of the spec being changed.'),
+            changeDescription: z
+                .string()
+                .min(1)
+                .max(1000)
+                .describe('Description of the change being made.'),
+        },
+    }, safeTracked('analyze_breaking_changes', async (args) => handleAnalyzeBreakingChanges(args)));
+    // dependency_impact_report
+    server.registerTool('dependency_impact_report', {
+        description: 'Generate an HTML report of specs affected by a change, including impact classification.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).describe('ID of the spec being changed.'),
+            changeDescription: z
+                .string()
+                .min(1)
+                .max(1000)
+                .describe('Description of the change being made.'),
+        },
+    }, safeTracked('dependency_impact_report', async (args) => handleDependencyImpactReport(args)));
+    // check_api_compatibility
+    server.registerTool('check_api_compatibility', {
+        description: "Check which other specs depend on a given spec's API surfaces, helping identify compatibility risks.",
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).describe('ID of the spec to check compatibility for.'),
+        },
+    }, safeTracked('check_api_compatibility', async (args) => handleCheckApiCompatibility(args)));
+}
+//# sourceMappingURL=register-dependency-impact-tools.js.map

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

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

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

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

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

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