@planu/cli 1.1.1 → 1.2.0

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

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleGenerateSpecFromDiff, handleGenerateSpecFromPr, handleGenerateSpecFromCommitRange, } from './diff-spec-generator-handler.js';
+export function registerDiffSpecTools(server) {
+    server.registerTool('generate_spec_from_diff', {
+        description: 'Generate a spec draft from a git diff string. Analyzes modified files, added functions, and new endpoints to infer acceptance criteria.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            diff: z
+                .string()
+                .min(1)
+                .describe('Raw git diff output (e.g. output of "git diff HEAD~1..HEAD").'),
+            outputMode: z
+                .enum(['draft', 'create'])
+                .optional()
+                .describe('Output mode. Values: draft (return content only), create (suggest create_spec call). Default: draft.'),
+            title: z
+                .string()
+                .optional()
+                .describe('Optional title override. If omitted, title is inferred from the diff.'),
+        },
+        annotations: { title: 'Generate Spec from Diff', readOnlyHint: true },
+    }, safeTracked('generate_spec_from_diff', async (args) => handleGenerateSpecFromDiff(args)));
+    server.registerTool('generate_spec_from_pr', {
+        description: 'Generate a spec draft from a GitHub Pull Request by fetching its diff via the GitHub CLI (gh). Requires gh to be installed and authenticated.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            prNumber: z.number().int().positive().describe('Pull Request number (e.g. 42).'),
+            repoPath: z
+                .string()
+                .optional()
+                .describe('Optional path to the git repository. Defaults to projectPath.'),
+            outputMode: z
+                .enum(['draft', 'create'])
+                .optional()
+                .describe('Output mode. Values: draft, create. Default: draft.'),
+        },
+        annotations: { title: 'Generate Spec from PR', readOnlyHint: true },
+    }, safeTracked('generate_spec_from_pr', async (args) => handleGenerateSpecFromPr(args)));
+    server.registerTool('generate_spec_from_commit_range', {
+        description: 'Generate a spec draft from a git commit range (e.g. HEAD~5..HEAD or abc123..def456).',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            commitRange: z
+                .string()
+                .describe('Git commit range in the format from..to (e.g. HEAD~3..HEAD or sha1..sha2).'),
+            outputMode: z
+                .enum(['draft', 'create'])
+                .optional()
+                .describe('Output mode. Values: draft, create. Default: draft.'),
+        },
+        annotations: { title: 'Generate Spec from Commit Range', readOnlyHint: true },
+    }, safeTracked('generate_spec_from_commit_range', async (args) => handleGenerateSpecFromCommitRange(args)));
+}
+//# sourceMappingURL=register-diff-spec-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-diff-spec-tools.js","sourceRoot":"","sources":["../../src/tools/register-diff-spec-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,GAIlC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,+DAA+D,CAAC;YAC5E,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,QAAQ,CACP,sGAAsG,CACvG;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uEAAuE,CAAC;SACrF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,IAAI,EAAE;KACtE,EACD,WAAW,CAAC,yBAAyB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACpD,0BAA0B,CAAC,IAAwC,CAAC,CACrE,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,+IAA+I;QACjJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAChF,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;YAC5E,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,IAAI,EAAE;KACpE,EACD,WAAW,CAAC,uBAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAClD,wBAAwB,CAAC,IAAsC,CAAC,CACjE,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,WAAW,EACT,sFAAsF;QACxF,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,4EAA4E,CAAC;YACzF,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,YAAY,EAAE,IAAI,EAAE;KAC9E,EACD,WAAW,CAAC,iCAAiC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC5D,iCAAiC,CAAC,IAA+C,CAAC,CACnF,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-drift-monitor-tools.d.ts

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

package/dist/tools/register-drift-monitor-tools.d.ts.map

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

package/dist/tools/register-drift-monitor-tools.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureDriftMonitoring, handleDriftAlertRules, handleDriftSummaryReport, } from './drift-monitor-handler.js';
+export function registerDriftMonitorTools(server) {
+    server.registerTool('configure_drift_monitoring', {
+        description: 'Configure continuous drift monitoring for a project. Drift monitoring detects when code diverges from its spec over time.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            action: z
+                .enum(['enable', 'disable', 'set-threshold', 'set-schedule', 'status'])
+                .describe('Action to perform. Values: enable, disable, set-threshold, set-schedule, status.'),
+            threshold: z
+                .number()
+                .min(0)
+                .max(100)
+                .optional()
+                .describe('Drift score (0–100) above which alerts fire. Used with set-threshold.'),
+            scheduleHours: z
+                .number()
+                .min(1)
+                .optional()
+                .describe('How often to check for drift (in hours). Used with set-schedule.'),
+        },
+        annotations: { title: 'Configure Drift Monitoring', destructiveHint: false },
+    }, safeTracked('configure_drift_monitoring', async (args) => handleConfigureDriftMonitoring(args)));
+    server.registerTool('drift_alert_rules', {
+        description: 'Manage alert rules for drift monitoring. Rules allow fine-grained thresholds per spec pattern.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            action: z
+                .enum(['set-rules', 'list'])
+                .describe('Action to perform. Values: set-rules (replace all rules), list.'),
+            rules: z
+                .array(z.object({
+                name: z.string().describe('Human-readable rule name.'),
+                specIdPattern: z
+                    .string()
+                    .describe('Spec ID pattern to match (e.g. SPEC-* or SPEC-001).'),
+                thresholdOverride: z
+                    .number()
+                    .min(0)
+                    .max(100)
+                    .optional()
+                    .describe('Override threshold for matching specs.'),
+                enabled: z.boolean().describe('Whether this rule is active.'),
+            }))
+                .optional()
+                .describe('Array of rules to set. Required for set-rules action.'),
+        },
+        annotations: { title: 'Drift Alert Rules', destructiveHint: false },
+    }, safeTracked('drift_alert_rules', async (args) => handleDriftAlertRules(args)));
+    server.registerTool('drift_summary_report', {
+        description: 'Generate an on-demand drift summary report for a project. Shows drifted vs clean specs and active alerts.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specIds: z
+                .array(z.string())
+                .optional()
+                .describe('Optional list of spec IDs to include. If omitted, includes all known specs.'),
+        },
+        annotations: { title: 'Drift Summary Report', readOnlyHint: true },
+    }, safeTracked('drift_summary_report', async (args) => handleDriftSummaryReport(args)));
+}
+//# sourceMappingURL=register-drift-monitor-tools.js.map

package/dist/tools/register-drift-monitor-tools.js.map

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

package/dist/tools/register-global-rules-tools.d.ts

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

package/dist/tools/register-global-rules-tools.d.ts.map

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

package/dist/tools/register-global-rules-tools.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleManageGlobalRules, handleGlobalRulesStatus, } from './global-rules-handler.js';
+export function registerGlobalRulesTools(server) {
+    server.registerTool('manage_global_rules', {
+        description: 'Manage global steering rules stored in ~/.planu/global-rules/. Rules can be applied to any project CLAUDE.md to inject consistent conventions.',
+        inputSchema: {
+            action: z
+                .enum(['create', 'list', 'get', 'update', 'delete', 'apply', 'export'])
+                .describe('Action to perform. Values: create (new rule), list (all rules), get (one rule), update (modify), delete (remove), apply (inject to CLAUDE.md), export (raw content).'),
+            slug: z
+                .string()
+                .optional()
+                .describe('Rule slug — kebab-case identifier (e.g. "no-any-types"). Required for get, update, delete, apply, export.'),
+            name: z.string().optional().describe('Human-readable rule name. Required for create.'),
+            content: z.string().optional().describe('Rule body in Markdown. Required for create.'),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe('Optional tag list for filtering (e.g. ["typescript", "quality"]).'),
+            author: z.string().optional().describe('Optional author identifier.'),
+            version: z
+                .string()
+                .optional()
+                .describe('Semver version string (e.g. "1.0.0"). Defaults to "1.0.0".'),
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Absolute project path. Required for apply action.'),
+        },
+        annotations: { title: 'Manage Global Rules', destructiveHint: false },
+    }, safeTracked('manage_global_rules', async (args) => handleManageGlobalRules(args)));
+    server.registerTool('global_rules_status', {
+        description: 'Show a summary of all global steering rules stored in ~/.planu/global-rules/.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Optional project path (unused, for context only).'),
+        },
+        annotations: { title: 'Global Rules Status', readOnlyHint: true },
+    }, safeTracked('global_rules_status', async (args) => handleGlobalRulesStatus(args)));
+}
+//# sourceMappingURL=register-global-rules-tools.js.map

package/dist/tools/register-global-rules-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-global-rules-tools.js","sourceRoot":"","sources":["../../src/tools/register-global-rules-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAGxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,gJAAgJ;QAClJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACtE,QAAQ,CACP,sKAAsK,CACvK;YACH,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,2GAA2G,CAC5G;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YACtF,IAAI,EAAE,CAAC;iBACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;YAChF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YACrE,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACzE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SACjE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,EAAE;KACtE,EACD,WAAW,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAChD,uBAAuB,CAAC,IAA8B,CAAC,CACxD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SACjE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,IAAI,EAAE;KAClE,EACD,WAAW,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAChD,uBAAuB,CAAC,IAA8B,CAAC,CACxD,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-incoming-webhook-tools.d.ts

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

package/dist/tools/register-incoming-webhook-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-incoming-webhook-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-incoming-webhook-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyEpE"}

package/dist/tools/register-incoming-webhook-tools.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureIncomingWebhooks, handleIncomingWebhookStatus, handleStopIncomingWebhooks, handleGenerateWebhookDocs, } from './incoming-webhook-handler.js';
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root where Planu stores its data.');
+export function registerIncomingWebhookTools(server) {
+    server.registerTool('configure_incoming_webhooks', {
+        description: 'Start a local HTTP server that accepts REST API calls to create and manage Planu specs. ' +
+            'Exposes: GET /api/specs, POST /api/specs, PATCH /api/specs/:id. ' +
+            'All endpoints require Bearer token authentication. ' +
+            'Useful for CI/CD pipelines, external tools, or automation scripts.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            port: z
+                .number()
+                .int()
+                .min(1024)
+                .max(65535)
+                .describe('TCP port for the webhook server (e.g. 3456). Must be available.'),
+            secret: z
+                .string()
+                .min(8)
+                .max(256)
+                .describe('Bearer token secret for authenticating requests. ' +
+                'Pass this as Authorization: Bearer <secret> in all requests.'),
+        },
+        annotations: { title: 'Start Incoming Webhook Server' },
+    }, safeTracked('configure_incoming_webhooks', (args) => handleConfigureIncomingWebhooks(args)));
+    server.registerTool('incoming_webhook_status', {
+        description: 'Show the current status of the incoming webhook server: port, running state, and configuration.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Incoming Webhook Server Status', readOnlyHint: true },
+    }, safeTracked('incoming_webhook_status', (args) => handleIncomingWebhookStatus(args)));
+    server.registerTool('stop_incoming_webhooks', {
+        description: 'Stop the running incoming webhook server and remove its configuration. ' +
+            'Run configure_incoming_webhooks to restart.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Stop Incoming Webhook Server', destructiveHint: true },
+    }, safeTracked('stop_incoming_webhooks', (args) => handleStopIncomingWebhooks(args)));
+    server.registerTool('generate_webhook_docs', {
+        description: 'Generate OpenAPI 3.0 YAML documentation for the incoming webhook server API. ' +
+            'Returns the full spec with endpoint descriptions, request/response schemas, and auth info.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Generate Webhook API Docs', readOnlyHint: true },
+    }, safeTracked('generate_webhook_docs', (args) => handleGenerateWebhookDocs(args)));
+}
+//# sourceMappingURL=register-incoming-webhook-tools.js.map