@planu/cli 1.1.2 → 1.3.0

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

@@ -0,0 +1,124 @@
+// tools/register-spec-hooks-tools.ts — SPEC-368: Register spec lifecycle hook tools
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleConfigureSpecHooks, handleListSpecHooks, handleTestSpecHook, handleDisableSpecHook, handleEnableSpecHook, } from './spec-hooks-handler.js';
+const EVENT_DESCRIBE = 'Event that triggers the hook. Valid values: on-status-change | on-create | on-approve | on-done | on-drift-alert | on-validation-fail';
+const ACTION_DESCRIBE = 'Action to execute. Valid values: challenge-spec | check-readiness | notify-slack | create-git-branch | generate-changelog | send-email-digest | run-validate';
+export function registerSpecHooksTools(server) {
+    server.registerTool('configure_spec_hooks', {
+        description: 'Configure an event-driven hook for the spec lifecycle. ' +
+            'Hooks automatically trigger actions when spec events fire (status change, creation, approval, etc.). ' +
+            'Examples: auto-challenge high-risk specs on approve, auto-create git branch on implementing.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            hookName: z
+                .string()
+                .min(1)
+                .max(200)
+                .describe('Unique name for this hook (e.g. "auto-challenge-on-approve")'),
+            event: z
+                .enum([
+                'on-status-change',
+                'on-create',
+                'on-approve',
+                'on-done',
+                'on-drift-alert',
+                'on-validation-fail',
+            ])
+                .describe(EVENT_DESCRIBE),
+            action: z
+                .enum([
+                'challenge-spec',
+                'check-readiness',
+                'notify-slack',
+                'create-git-branch',
+                'generate-changelog',
+                'send-email-digest',
+                'run-validate',
+            ])
+                .describe(ACTION_DESCRIBE),
+            filter: z
+                .object({
+                tags: z.array(z.string().max(100)).optional().describe('Only fire for specs with these tags'),
+                priority: z.string().max(50).optional().describe('Only fire for specs with this priority'),
+                fromStatus: z.string().max(50).optional().describe('Only fire when status changes FROM this value'),
+                toStatus: z.string().max(50).optional().describe('Only fire when status changes TO this value'),
+            })
+                .optional()
+                .describe('Optional filter conditions — hook only fires when all conditions match'),
+            enabled: z.boolean().optional().describe('Whether the hook is active (default: true)'),
+        },
+        annotations: {
+            title: 'Configure Spec Hook',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('configure_spec_hooks', async (args) => handleConfigureSpecHooks(args)));
+    server.registerTool('list_spec_hooks', {
+        description: 'List all configured spec lifecycle hooks with their run statistics ' +
+            '(runCount, failCount, lastRunAt) and current enabled/disabled status.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+        },
+        annotations: {
+            title: 'List Spec Hooks',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('list_spec_hooks', async (args) => handleListSpecHooks(args)));
+    server.registerTool('test_spec_hook', {
+        description: 'Simulate a spec lifecycle event and describe what hooks would fire and what actions ' +
+            'would be triggered — without executing any side effects. ' +
+            'Use this to verify hook configuration before it fires in production.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            hookName: z.string().min(1).max(200).describe('Name of the hook to test'),
+            specId: z.string().min(1).max(200).describe('Spec ID to use in the simulation (e.g. SPEC-001)'),
+        },
+        annotations: {
+            title: 'Test Spec Hook (Simulation)',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('test_spec_hook', async (args) => handleTestSpecHook(args)));
+    server.registerTool('disable_spec_hook', {
+        description: 'Disable a spec lifecycle hook so it no longer fires. The hook config is preserved and can be re-enabled.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            hookName: z.string().min(1).max(200).describe('Name of the hook to disable'),
+        },
+        annotations: {
+            title: 'Disable Spec Hook',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('disable_spec_hook', async (args) => handleDisableSpecHook(args)));
+    server.registerTool('enable_spec_hook', {
+        description: 'Enable a previously disabled spec lifecycle hook.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            hookName: z.string().min(1).max(200).describe('Name of the hook to enable'),
+        },
+        annotations: {
+            title: 'Enable Spec Hook',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('enable_spec_hook', async (args) => handleEnableSpecHook(args)));
+}
+//# sourceMappingURL=register-spec-hooks-tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,79 @@
+// tools/register-spec-lint-tools.ts — Registers Custom Spec Lint Rules tools (SPEC-364)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleDefineLintRule, handleListLintRules, handleRunSpecLint, handleDeleteLintRule, } from './spec-lint-handler.js';
+const LintConditionSchema = z.object({
+    field: z
+        .enum(['tags', 'acceptanceCriteria', 'estimatedHours', 'priority', 'description', 'title'])
+        .describe('Field to check. Values: tags, acceptanceCriteria, estimatedHours, priority, description, title.'),
+    operator: z
+        .enum([
+        'includes',
+        'not-includes',
+        'min-length',
+        'max-length',
+        'any-contains',
+        'none-contain',
+        'greater-than',
+        'less-than',
+        'exists',
+        'not-exists',
+    ])
+        .describe('Operator. Values: includes, not-includes, min-length, max-length, any-contains, none-contain, greater-than, less-than, exists, not-exists.'),
+    value: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe('Value to compare against. Not required for exists/not-exists operators.'),
+});
+export function registerSpecLintTools(server) {
+    server.registerTool('define_spec_lint_rule', {
+        description: 'Define a custom lint rule for specs. Rules check that specs satisfy structural or content conditions. ' +
+            'Use "when" for a guard condition (rule only applies when guard is true), ' +
+            '"then" for the condition that must be satisfied. ' +
+            'Use appliesTo.all=true to apply to all specs, or appliesTo.tags to target specific tags.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            name: z.string().min(1).max(200).describe('Human-readable name for the rule.'),
+            description: z.string().min(1).max(500).describe('What this rule checks.'),
+            when: LintConditionSchema.optional().describe('Optional guard condition. Rule only activates when this is true.'),
+            then: LintConditionSchema.describe('Condition that MUST be satisfied.'),
+            severity: z.enum(['warning', 'error']).describe('Severity. Values: warning, error.'),
+            appliesTo: z
+                .object({
+                tags: z.array(z.string()).optional().describe('Spec tags this rule applies to.'),
+                all: z.boolean().optional().describe('If true, applies to all specs.'),
+            })
+                .describe('Scope of the rule.'),
+        },
+        annotations: { title: 'Define Spec Lint Rule' },
+    }, safeTracked('define_spec_lint_rule', (args) => handleDefineLintRule(args)));
+    server.registerTool('list_spec_lint_rules', {
+        description: 'List all custom lint rules defined for a project.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'List Spec Lint Rules', readOnlyHint: true },
+    }, safeTracked('list_spec_lint_rules', (args) => handleListLintRules(args)));
+    server.registerTool('run_spec_lint', {
+        description: 'Run all custom lint rules against specs in a project. ' +
+            'If specId is provided, only that spec is linted. Otherwise all specs are checked. ' +
+            'Returns a list of violations with severity, field, and message.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z
+                .string()
+                .optional()
+                .describe('Optional spec ID to lint (e.g. SPEC-042). Omit to lint all specs.'),
+        },
+        annotations: { title: 'Run Spec Lint', readOnlyHint: true },
+    }, safeTracked('run_spec_lint', (args) => handleRunSpecLint(args)));
+    server.registerTool('delete_spec_lint_rule', {
+        description: 'Delete a custom lint rule by ID.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            ruleId: z.string().min(1).max(100).describe('ID of the rule to delete (e.g. rule-abc123).'),
+        },
+        annotations: { title: 'Delete Spec Lint Rule', destructiveHint: true },
+    }, safeTracked('delete_spec_lint_rule', (args) => handleDeleteLintRule(args)));
+}
+//# sourceMappingURL=register-spec-lint-tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleSimulateParallelExecution, handleCriticalPathAnalyzer, handleParallelEfficiencyScore, handleOptimizeSpecScheduling, } from './spec-scheduler-handler.js';
+export function registerSpecSchedulerTools(server) {
+    // simulate_parallel_execution
+    server.registerTool('simulate_parallel_execution', {
+        description: 'Simulate parallel execution of a set of specs across multiple agents. Returns a timeline with Gantt chart and critical path.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specIds: z
+                .array(z.string())
+                .min(1)
+                .describe('List of spec IDs to include in the simulation.'),
+            numAgents: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .describe('Number of agents (parallel workers) to simulate.'),
+        },
+    }, safeTracked('simulate_parallel_execution', async (args) => handleSimulateParallelExecution(args)));
+    // critical_path_analyzer
+    server.registerTool('critical_path_analyzer', {
+        description: 'Identify the critical path (longest chain of specs by estimated hours) for a project or a subset of specs.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specIds: z
+                .array(z.string())
+                .optional()
+                .describe('Optional subset of spec IDs. Omit to analyze all project specs.'),
+        },
+    }, safeTracked('critical_path_analyzer', async (args) => handleCriticalPathAnalyzer(args)));
+    // parallel_efficiency_score
+    server.registerTool('parallel_efficiency_score', {
+        description: 'Calculate the parallel efficiency (utilization ratio) for executing a set of specs with N agents. Returns a score and interpretation.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specIds: z
+                .array(z.string())
+                .min(1)
+                .describe('List of spec IDs to include in the efficiency calculation.'),
+            numAgents: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .describe('Number of agents to calculate efficiency for.'),
+        },
+    }, safeTracked('parallel_efficiency_score', async (args) => handleParallelEfficiencyScore(args)));
+    // optimize_spec_scheduling
+    server.registerTool('optimize_spec_scheduling', {
+        description: 'Suggest an optimized scheduling order for specs to minimize agent idle time when executing in parallel.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specIds: z
+                .array(z.string())
+                .optional()
+                .describe('Optional subset of spec IDs. Omit to optimize all project specs.'),
+            numAgents: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .optional()
+                .describe('Number of agents (default: 2).'),
+        },
+    }, safeTracked('optimize_spec_scheduling', async (args) => handleOptimizeSpecScheduling(args)));
+}
+//# sourceMappingURL=register-spec-scheduler-tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleSyncSpecFromCode, handleMarkAsSpecSource, handleListSpecBindings, } from './spec-source-handler.js';
+export function registerSpecSourceTools(server) {
+    server.registerTool('sync_spec_from_code', {
+        description: 'Scan source files for @spec markers and sync them with the spec bindings store. Detects // @spec SPEC-XXX comments in code.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            filePaths: z
+                .array(z.string())
+                .describe('List of absolute file paths to scan for @spec markers.'),
+        },
+        annotations: { title: 'Sync Spec from Code', destructiveHint: false },
+    }, safeTracked('sync_spec_from_code', async (args) => handleSyncSpecFromCode(args)));
+    server.registerTool('mark_as_spec_source', {
+        description: 'Mark a source file as implementing a specific spec by creating a binding. Also shows the marker comment to add to the file.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to bind (e.g. SPEC-001).'),
+            filePath: z.string().describe('Absolute path to the source file implementing the spec.'),
+            lineNumber: z
+                .number()
+                .optional()
+                .describe('Optional line number where the implementation starts.'),
+        },
+        annotations: { title: 'Mark as Spec Source', destructiveHint: false },
+    }, safeTracked('mark_as_spec_source', async (args) => handleMarkAsSpecSource(args)));
+    server.registerTool('list_spec_bindings', {
+        description: 'List all spec-to-code bindings for a project. Optionally filter by spec ID or unmark a binding.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z
+                .string()
+                .optional()
+                .describe('Filter bindings to a specific spec ID (e.g. SPEC-001).'),
+            action: z
+                .enum(['list', 'unmark'])
+                .optional()
+                .describe('Action to perform. Values: list (default), unmark.'),
+            bindingId: z
+                .string()
+                .optional()
+                .describe('Binding ID to remove. Required for unmark action.'),
+        },
+        annotations: { title: 'List Spec Bindings', readOnlyHint: true },
+    }, safeTracked('list_spec_bindings', async (args) => handleListSpecBindings(args)));
+}
+//# sourceMappingURL=register-spec-source-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-source-tools.js","sourceRoot":"","sources":["../../src/tools/register-spec-source-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GAIvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,SAAS,EAAE,CAAC;iBACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CAAC,wDAAwD,CAAC;SACtE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,EAAE;KACtE,EACD,WAAW,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAChD,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YACxF,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;SACrE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,EAAE;KACtE,EACD,WAAW,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAChD,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,iGAAiG;QACnG,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;iBACxB,QAAQ,EAAE;iBACV,QAAQ,CAAC,oDAAoD,CAAC;YACjE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SACjE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,IAAI,EAAE;KACjE,EACD,WAAW,CAAC,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC/C,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleCreateSweepIssue, handleSweepStatus } from './sweep-integration-handler.js';
+export function registerSweepTools(server) {
+    server.registerTool('create_sweep_issue', {
+        description: 'Create a GitHub issue formatted for Sweep AI from a Planu spec. ' +
+            'Reads acceptance criteria from spec.md and affected files from technical.md. ' +
+            'Sweep AI will automatically open a PR addressing the acceptance criteria. ' +
+            'Use dryRun=true to preview the issue body without creating it.',
+        annotations: { title: 'Create Sweep Issue', destructiveHint: false },
+        inputSchema: {
+            specId: z
+                .string()
+                .describe('Spec ID to create the Sweep issue for (e.g. SPEC-042). ' +
+                'Must match a directory in planu/specs/ following the SPEC-NNN-slug convention.'),
+            projectPath: z.string().describe('Absolute path to the project root'),
+            githubRepo: z
+                .string()
+                .describe('GitHub repository in owner/repo format (e.g. acme/my-project). ' +
+                'The repository must have the "sweep" label for Sweep AI to pick up the issue.'),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe('If true, returns the issue body without creating the GitHub issue. ' +
+                'Default: false. Valid values: true, false.'),
+        },
+    }, safeLicensed('create_sweep_issue', (args) => handleCreateSweepIssue(args)));
+    server.registerTool('sweep_status', {
+        description: 'Check whether the gh CLI is installed and whether the "sweep" label exists on the target GitHub repo. ' +
+            'Run this before create_sweep_issue to confirm prerequisites are in place.',
+        annotations: { title: 'Sweep Status', readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root'),
+            githubRepo: z
+                .string()
+                .optional()
+                .describe('GitHub repository in owner/repo format to check the sweep label. ' +
+                'Omit to only check whether gh CLI is installed.'),
+        },
+    }, safeLicensed('sweep_status', (args) => Promise.resolve(handleSweepStatus(args))));
+}
+//# sourceMappingURL=register-sweep-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-sweep-tools.js","sourceRoot":"","sources":["../../src/tools/register-sweep-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAG3F,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,kEAAkE;YAClE,+EAA+E;YAC/E,4EAA4E;YAC5E,gEAAgE;QAClE,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,KAAK,EAAE;QACpE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACP,yDAAyD;gBACvD,gFAAgF,CACnF;YACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CACP,iEAAiE;gBAC/D,+EAA+E,CAClF;YACH,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,qEAAqE;gBACnE,4CAA4C,CAC/C;SACJ;KACF,EACD,YAAY,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC1C,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,wGAAwG;YACxG,2EAA2E;QAC7E,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE;QAC1D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mEAAmE;gBACjE,iDAAiD,CACpD;SACJ;KACF,EACD,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CACpC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAwB,CAAC,CAAC,CAC7D,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-tech-debt-tools.d.ts

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

package/dist/tools/register-tech-debt-tools.d.ts.map

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

package/dist/tools/register-tech-debt-tools.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleTrackTechDebt, handleTechDebtBudget, handleListTechDebt, handleDebtForecast, handleResolveTechDebt, handleTechDebtReport, } from './tech-debt-handler.js';
+const SEVERITY_ENUM = z
+    .enum(['low', 'medium', 'high', 'critical'])
+    .describe('Severity level. Values: low, medium, high, critical.');
+const CATEGORY_ENUM = z
+    .enum(['testing', 'documentation', 'refactoring', 'architecture', 'security'])
+    .describe('Category. Values: testing, documentation, refactoring, architecture, security.');
+const STATUS_ENUM = z
+    .enum(['open', 'resolved', 'all'])
+    .describe('Filter by status. Values: open, resolved, all.');
+export function registerTechDebtTools(server) {
+    // track_tech_debt
+    server.registerTool('track_tech_debt', {
+        description: 'Track a new tech debt item for a project. Records description, estimated hours, severity, and category.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            description: z.string().min(1).max(500).describe('Description of the tech debt.'),
+            estimatedHours: z
+                .number()
+                .min(0.5)
+                .max(1000)
+                .describe('Estimated hours to resolve this debt.'),
+            severity: SEVERITY_ENUM,
+            category: CATEGORY_ENUM,
+            specId: z.string().optional().describe('Optional spec ID this debt is linked to.'),
+        },
+    }, safeTracked('track_tech_debt', async (args) => handleTrackTechDebt(args)));
+    // tech_debt_budget
+    server.registerTool('tech_debt_budget', {
+        description: 'Configure tech debt budget limits: max hours allowed, max percent of backlog, and alert threshold.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            maxHours: z
+                .number()
+                .min(1)
+                .optional()
+                .describe('Maximum total open hours of tech debt allowed.'),
+            maxPercentOfBacklog: z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe('Maximum tech debt as a percentage of backlog hours.'),
+            alertThreshold: z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe('Percentage of budget that triggers an alert.'),
+        },
+    }, safeTracked('tech_debt_budget', async (args) => handleTechDebtBudget(args)));
+    // list_tech_debt
+    server.registerTool('list_tech_debt', {
+        description: 'List tech debt items for a project, optionally filtered by status, severity, or category.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            status: STATUS_ENUM.optional().default('open'),
+            severity: SEVERITY_ENUM.optional(),
+            category: CATEGORY_ENUM.optional(),
+        },
+    }, safeTracked('list_tech_debt', async (args) => handleListTechDebt(args)));
+    // debt_forecast
+    server.registerTool('debt_forecast', {
+        description: 'Forecast tech debt growth based on historical accumulation rate. Projects weeks until budget is exceeded.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+    }, safeTracked('debt_forecast', async (args) => handleDebtForecast(args)));
+    // resolve_tech_debt
+    server.registerTool('resolve_tech_debt', {
+        description: 'Mark a tech debt item as resolved.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            id: z.string().min(1).describe('ID of the tech debt item to resolve.'),
+            resolvedNotes: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional notes on how it was resolved.'),
+        },
+    }, safeTracked('resolve_tech_debt', async (args) => handleResolveTechDebt(args)));
+    // tech_debt_report
+    server.registerTool('tech_debt_report', {
+        description: 'Generate an HTML report of all tech debt items with metrics and forecast summary.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+    }, safeTracked('tech_debt_report', async (args) => handleTechDebtReport(args)));
+}
+//# sourceMappingURL=register-tech-debt-tools.js.map

package/dist/tools/register-tech-debt-tools.js.map

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

package/dist/tools/register-token-optimizer-tools.d.ts

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

package/dist/tools/register-token-optimizer-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-token-optimizer-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-token-optimizer-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgCnE"}

package/dist/tools/register-token-optimizer-tools.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleSuggestTokenOptimizer, handleTokenOptimizerStatus, } from './ecosystem-tools-handler.js';
+export function registerTokenOptimizerTools(server) {
+    server.registerTool('suggest_token_optimizer', {
+        description: 'Detect whether RTK (Response Token Killer) or Headroom are configured in the project. ' +
+            'Returns recommendations with install commands to reduce token usage by 30-60% on large codebases.',
+        annotations: { title: 'Suggest Token Optimizer', readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root directory'),
+        },
+    }, safeLicensed('suggest_token_optimizer', async (args) => handleSuggestTokenOptimizer(args)));
+    server.registerTool('token_optimizer_status', {
+        description: 'Returns the installation status of RTK and Headroom token optimization tools. ' +
+            'Includes version info and number of configured PreToolUse hooks.',
+        annotations: { title: 'Token Optimizer Status', readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root directory'),
+        },
+    }, safeLicensed('token_optimizer_status', async (args) => handleTokenOptimizerStatus(args)));
+}
+//# sourceMappingURL=register-token-optimizer-tools.js.map

package/dist/tools/register-token-optimizer-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-token-optimizer-tools.js","sourceRoot":"","sources":["../../src/tools/register-token-optimizer-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,wFAAwF;YACxF,mGAAmG;QACrG,WAAW,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,IAAI,EAAE;QACrE,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAChF;KACF,EACD,YAAY,CAAC,yBAAyB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACrD,2BAA2B,CAAC,IAAkC,CAAC,CAChE,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,gFAAgF;YAChF,kEAAkE;QACpE,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,IAAI,EAAE;QACpE,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAChF;KACF,EACD,YAAY,CAAC,wBAAwB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACpD,0BAA0B,CAAC,IAAiC,CAAC,CAC9D,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-validation-loop-tools.d.ts

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

package/dist/tools/register-validation-loop-tools.d.ts.map

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