@planu/cli 3.9.7 → 3.9.9

package/dist/tools/tool-registry/group-misc.js

@@ -1,1367 +0,0 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-/* eslint-disable max-lines -- thematic registry group consolidated by SPEC refactor-phase3 (commit aafeea60); each block is a declarative tool registration ~20 lines, split would re-create the ~120 register-*.ts files this phase intentionally collapsed */
-// tools/tool-registry/group-misc.ts — Group G: Misc/Platform tools
-// Consolidates: team, llm-provider, spec-observability, workspace-dashboard, hook-generator,
-// project-dna, steering, skill-bootstrap, release-notes, token-optimizer, tokens,
-// validation-loop, spec-cookbook, doc-compliance, spec-prompt, test-reverse-engineer,
-// governance, reconcile-rules, reconcile-skills, reconcile-hooks, ai-ecosystem-status,
-// sync-ai-configs, sync-spec-state, generate-dashboard, generate-proposal, export-pdf
-// (Phase 3 registry refactor — inline, no delegation)
-import { z } from 'zod';
-import { safeLicensed, safeTracked, safe } from '../safe-handler.js';
-import { projectIdSchema, withProject } from '../tool-registry-helpers.js';
-// ── Team tools (register-team-tools.ts) ──────────────────────────────────────
-import { handleGenerateTeammatePrompt, handleGenerateLayerPrompts, } from '../generate-teammate-prompt.js';
-import { handleValidateTeamResults } from '../validate-team-results.js';
-import { handlePlanTeamDistribution } from '../plan-team-distribution.js';
-// ── LLM Provider tools (register-llm-provider-tools.ts) ──────────────────────
-import { handleConfigureLLMProviders } from '../configure-llm-providers-handler.js';
-import { handleLLMProviderStatus } from '../llm-provider-status-handler.js';
-import { ConfigureLLMProvidersActionEnum, LoadBalancingStrategyEnum, LLMCapabilityEnum, QualityTierEnum, } from '../schemas/llm-provider-schemas.js';
-// ── SPEC-739: flag_spec_gap ───────────────────────────────────────────────────
-import { handleFlagSpecGap } from '../flag-spec-gap.js';
-// ── SPEC-751: housekeeping_sweep ──────────────────────────────────────────────
-import { handleHousekeepingSweep, HousekeepingSweepInputSchema } from '../housekeeping-sweep.js';
-// ── Spec observability (register-spec-observability-tools.ts) ────────────────
-import { handleSpecUsageReport } from '../spec-usage-report.js';
-// ── Workspace dashboard (register-workspace-dashboard-tools.ts) ───────────────
-import { handleWorkspaceOverview, handleWorkspaceHealth, handleBulkProjectOperations, handleWorkspaceReport, handleWorkspaceSearch, handleWorkspaceAlerts, } from '../workspace-dashboard-handler.js';
-// ── Hook generator (register-hook-generator.ts) ───────────────────────────────
-import { handleGenerateHooksForStack, handlePreviewHooks, handleMergeHooks, } from '../hook-generator-handler.js';
-// ── Project DNA (register-project-dna.ts) ────────────────────────────────────
-import { handleDetectProjectDNA, handleBootstrapProjectIntelligence, handleUpdateProjectDNA, DetectProjectDNAInputSchema, BootstrapProjectIntelligenceInputSchema, UpdateDNAInputSchema, } from '../project-dna-handler.js';
-// ── Steering tools (register-steering-tools.ts) ───────────────────────────────
-import { handleGenerateSteeringFile, handleListSteeringFiles } from '../steering-handler.js';
-// ── Skill bootstrap (register-skill-bootstrap-tools.ts) ───────────────────────
-import { handleDiscoverSkillsFromRegistries, handleBootstrapSkills, handleConfigureSkillRegistries, DiscoverSkillsInputSchema, BootstrapSkillsInputSchema, ConfigureSkillRegistriesInputSchema, } from '../skill-bootstrap-handler.js';
-// ── Release notes (register-release-notes-tools.ts) ──────────────────────────
-import { handleGenerateReleaseNotes, handlePreviewReleaseNotes, handleConfigureReleaseNotes, } from '../release-notes-handler.js';
-// ── Tokens (register-tokens-tool.ts) ─────────────────────────────────────────
-import { handleTokens } from '../tokens-handler.js';
-// ── Validation loop (register-validation-loop-tools.ts) ───────────────────────
-import { handleSpecHealthCheck, handleHealthCheckAll, handleRunValidationLoop, } from '../validation-loop-handler.js';
-// ── Spec cookbook (register-spec-cookbook-tools.ts) ───────────────────────────
-import { handleCookbookList, handleCookbookGet, handleCookbookApply, handleCookbookContribute, handleCookbookSearch, } from '../spec-cookbook-handler.js';
-// ── Doc compliance (register-doc-compliance-tools.ts) ────────────────────────
-import { handleDocComplianceReport } from '../doc-compliance-handler.js';
-// ── Spec prompt (register-spec-prompt-tools.ts) ───────────────────────────────
-import { registerSpecPromptHandlers } from '../spec-prompt-handler.js';
-// ── Test reverse engineer (register-test-reverse-engineer-tools.ts) ───────────
-import { ReverseEngineerTestsInputSchema, handleReverseEngineerTests, } from '../test-reverse-engineer-handler.js';
-// ── Reconcile rules (reconcile-rules.ts) ─────────────────────────────────────
-import { reconcileRules } from '../../engine/rules-reconciler.js';
-// ── Reconcile skills (reconcile-skills.ts) ────────────────────────────────────
-import { ReconcileSkillsInputSchema } from '../schemas/reconcile-skills-schemas.js';
-import { reconcileSkills, autoFixSkills } from '../../engine/skills-reconciler.js';
-import { sanitizePath } from '../sanitize-path.js';
-import { knowledgeStore, specStore } from '../../storage/index.js';
-// ── Reconcile hooks (reconcile-hooks.ts) ──────────────────────────────────────
-import { reconcileHooks, patchHooks } from '../../engine/hooks-reconciler.js';
-// ── AI ecosystem status (ai-ecosystem-status.ts) ──────────────────────────────
-import { handleAiEcosystemStatus, AiEcosystemStatusSchema } from '../ai-ecosystem-status.js';
-import { resolveProjectId, missingProjectIdError } from '../resolve-project-id.js';
-// ── Sync AI configs (sync-ai-configs.ts) ──────────────────────────────────────
-import { handleSyncAiConfigs, SyncAiConfigsSchema } from '../sync-ai-configs.js';
-// ── Sync spec state (sync-spec-state-handler.ts) ──────────────────────────────
-import { registerSyncSpecStateTool } from '../sync-spec-state-handler.js';
-import { registerRepairFrontmatterDriftTool } from '../repair-frontmatter-drift.js';
-// ── Generate dashboard (generate-dashboard.ts) ────────────────────────────────
-import { regenerateSpecSummaryHtml } from '../../engine/spec-summary-html.js';
-import { hashProjectPath } from '../../storage/base-store.js';
-// ── Generate proposal (generate-proposal.ts) ──────────────────────────────────
-import { registerGenerateProposalTool } from '../generate-proposal.js';
-// ── Execute SDD flow (SPEC-583) ───────────────────────────────────────────────
-// handleExecuteSddFlow import removed — registration replaced by deprecation stub (SPEC-658)
-import { makeDeprecationStub } from './deprecated-stubs.js';
-import { registerFromEntries } from '../tool-entry.js';
-// ── Reconcile interactive question hooks (SPEC-584) ────────────────────────────
-import { handleReconcileInteractiveQuestionHooks } from '../reconcile-interactive-question-hooks.js';
-// ── Planu session checkpoint (SPEC-585) ───────────────────────────────────────
-import { handlePlanSessionCheckpoint } from '../planu-session-checkpoint.js';
-// ── SPEC-753: workspace_overview (single-call state query) + reconcile_status_json ──
-import { handleProjectOverview } from '../workspace-overview.js';
-import { handleReconcileStatusJson } from '../reconcile-status-json.js';
-// ── SPEC-969: force_status_analytics ─────────────────────────────────────────
-import { handleForceStatusAnalytics } from '../force-status-analytics.js';
-// ---------------------------------------------------------------------------
-// Reconcile rules — inline helpers
-// ---------------------------------------------------------------------------
-function formatRulesReconciliation(result) {
-    const { rulesInSync, newRulesNeeded, staleRules, updatedRules, healthScore } = result;
-    const lines = [];
-    lines.push('# Rules Reconciliation Report');
-    lines.push('');
-    lines.push(`## Health Score: ${healthScore}/100`);
-    lines.push('');
-    lines.push(`- Status: **${rulesInSync ? 'IN SYNC' : 'DRIFT DETECTED'}**`);
-    lines.push('');
-    if (updatedRules.length > 0) {
-        lines.push('## Auto-Generated Rules Files');
-        lines.push('');
-        lines.push('The following files were created in `.claude/rules/` for uncovered convention categories:');
-        lines.push('');
-        for (const f of updatedRules) {
-            lines.push(`  - ${f}`);
-        }
-        lines.push('');
-    }
-    if (newRulesNeeded.length > 0 && updatedRules.length === 0) {
-        lines.push('## Missing Coverage');
-        lines.push('');
-        lines.push('Convention categories in CLAUDE.md with no rules file coverage:');
-        lines.push('');
-        for (const cat of newRulesNeeded) {
-            lines.push(`  - ${cat}`);
-        }
-        lines.push('');
-    }
-    if (staleRules.length > 0) {
-        lines.push('## Potentially Stale Rules');
-        lines.push('');
-        lines.push('These files have no categories matching current CLAUDE.md conventions — review manually:');
-        lines.push('');
-        for (const f of staleRules) {
-            lines.push(`  - ${f}`);
-        }
-        lines.push('');
-    }
-    if (rulesInSync && updatedRules.length === 0) {
-        lines.push('All convention categories are covered by .claude/rules/ files. No drift detected.');
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-// ---------------------------------------------------------------------------
-// Reconcile skills — inline helpers
-// ---------------------------------------------------------------------------
-async function handleReconcileSkillsInline(args) {
-    const projectPath = sanitizePath(args.projectPath);
-    const knowledge = await knowledgeStore.getKnowledge(args.projectId);
-    const reconciliation = await reconcileSkills(projectPath, knowledge);
-    if (args.autoFix === true) {
-        const fixResult = await autoFixSkills(reconciliation, projectPath);
-        return buildSkillsAutoFixReport(fixResult);
-    }
-    return buildSkillsReadOnlyReport(reconciliation);
-}
-function buildSkillsReadOnlyReport(result) {
-    const lines = [];
-    lines.push(`## Skills Reconciliation Report`);
-    lines.push(`**Health score**: ${result.healthScore}/100`);
-    lines.push(`**In sync**: ${result.skillsInSync ? 'Yes' : 'No'}`);
-    lines.push('');
-    if (result.newSkillsDetected.length > 0) {
-        lines.push(`### New skills detected (${result.newSkillsDetected.length})`);
-        lines.push('These skills are recommended for your current stack but are not installed:');
-        for (const name of result.newSkillsDetected) {
-            lines.push(`- \`${name}\``);
-        }
-        lines.push('');
-        lines.push('Run `skill_install` for each skill, or use `suggest_tooling` for full details.');
-    }
-    else {
-        lines.push('All recommended skills are installed.');
-    }
-    lines.push('');
-    if (result.staleSkills.length > 0) {
-        lines.push(`### Stale skills (${result.staleSkills.length})`);
-        lines.push('These skills are installed for technologies no longer detected in the stack:');
-        for (const name of result.staleSkills) {
-            lines.push(`- \`${name}\``);
-        }
-        lines.push('');
-        lines.push('Consider removing them from `.claude/skills/` if they are no longer needed.');
-    }
-    else {
-        lines.push('No stale skills detected.');
-    }
-    return { content: [{ type: 'text', text: lines.join('\n') }] };
-}
-function buildSkillsAutoFixReport(fix) {
-    const lines = [];
-    lines.push('## Skills Auto-Fix Report');
-    lines.push(`**Health score after fix**: ${fix.healthScore}/100`);
-    lines.push('');
-    if (fix.installed.length > 0) {
-        lines.push(`### Installed (${fix.installed.length})`);
-        for (const name of fix.installed) {
-            lines.push(`- \`${name}\``);
-        }
-        lines.push('');
-    }
-    else {
-        lines.push('No missing skills to install.');
-        lines.push('');
-    }
-    if (fix.removed.length > 0) {
-        lines.push(`### Removed (${fix.removed.length})`);
-        for (const name of fix.removed) {
-            lines.push(`- \`${name}\``);
-        }
-        lines.push('');
-    }
-    else {
-        lines.push('No stale skills to remove.');
-        lines.push('');
-    }
-    if (fix.pathsFixed.length > 0) {
-        lines.push(`### Paths corrected (${fix.pathsFixed.length})`);
-        for (const name of fix.pathsFixed) {
-            lines.push(`- \`${name}\``);
-        }
-        lines.push('');
-    }
-    else {
-        lines.push('No corrupt manifest paths detected.');
-    }
-    return { content: [{ type: 'text', text: lines.join('\n') }] };
-}
-// ---------------------------------------------------------------------------
-// Reconcile hooks — inline helpers
-// ---------------------------------------------------------------------------
-function formatHooksReconciliation(result) {
-    const { hooksInSync, missingHooks, outdatedHooks, healthScore } = result;
-    const lines = [];
-    lines.push('# Hooks Reconciliation Report');
-    lines.push('');
-    lines.push(`## Health Score: ${healthScore}/100`);
-    lines.push('');
-    lines.push(`- Status: **${hooksInSync ? 'IN SYNC' : 'DRIFT DETECTED'}**`);
-    lines.push('');
-    if (missingHooks.length > 0) {
-        lines.push('## Missing Checks');
-        lines.push('');
-        lines.push('Expected quality gates not found in current hook scripts:');
-        lines.push('');
-        for (const item of missingHooks) {
-            lines.push(`  - ${item}`);
-        }
-        lines.push('');
-        lines.push('Run `configure_hooks` or `manage_git setup-hooks` to add missing steps.');
-        lines.push('');
-    }
-    if (outdatedHooks.length > 0) {
-        lines.push('## Enhancement Opportunities');
-        lines.push('');
-        lines.push('Hooks could be improved based on detected project capabilities:');
-        lines.push('');
-        for (const item of outdatedHooks) {
-            lines.push(`  - ${item}`);
-        }
-        lines.push('');
-    }
-    if (hooksInSync) {
-        lines.push('All detected project capabilities are covered by git hook scripts. No drift found.');
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-function formatHooksPatchResult(reconcileResult, patchResult) {
-    const lines = [];
-    lines.push('# Hooks Reconciliation Report (Auto-Fix Applied)');
-    lines.push('');
-    lines.push(`## Health Score: ${patchResult.healthScore}/100`);
-    lines.push('');
-    lines.push(`- Status: **${reconcileResult.hooksInSync ? 'IN SYNC' : 'DRIFT DETECTED (before fix)'}**`);
-    lines.push('');
-    if (patchResult.patched.length > 0) {
-        lines.push('## Patched Checks');
-        lines.push('');
-        for (const p of patchResult.patched) {
-            lines.push(`  - ${p.hook}: \`${p.added}\``);
-        }
-        lines.push('');
-    }
-    if (patchResult.skipped.length > 0) {
-        lines.push('## Skipped (already present or covered by lint-staged)');
-        lines.push('');
-        for (const s of patchResult.skipped) {
-            lines.push(`  - ${s}`);
-        }
-        lines.push('');
-    }
-    if (patchResult.patched.length === 0 && patchResult.skipped.length === 0) {
-        lines.push('No patches needed — hooks are already up to date.');
-        lines.push('');
-    }
-    if (reconcileResult.outdatedHooks.length > 0) {
-        lines.push('## Enhancement Opportunities (not auto-fixed)');
-        lines.push('');
-        for (const item of reconcileResult.outdatedHooks) {
-            lines.push(`  - ${item}`);
-        }
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-function handleReconcileHooksInline(args) {
-    const result = reconcileHooks(args.projectPath);
-    if (!args.autoFix) {
-        const text = formatHooksReconciliation(result);
-        const isError = result.healthScore === 0 && !result.hooksInSync;
-        return { content: [{ type: 'text', text }], isError };
-    }
-    const patch = patchHooks(result.missingHooks, args.projectPath);
-    const text = formatHooksPatchResult(result, patch);
-    const isError = patch.healthScore === 0 && patch.patched.length === 0;
-    return { content: [{ type: 'text', text }], isError };
-}
-// ---------------------------------------------------------------------------
-// Hook section sub-schema (for merge_hooks)
-// ---------------------------------------------------------------------------
-const hookSectionSchema = z.object({
-    id: z.string().max(200).describe('Unique section identifier, e.g. typescript-typecheck'),
-    phase: z
-        .enum(['pre-commit', 'commit-msg', 'pre-push', 'post-merge', 'post-checkout'])
-        .describe('Git hook phase. Values: pre-commit | commit-msg | pre-push | post-merge | post-checkout'),
-    stack: z.string().max(100).describe('Stack token this section targets'),
-    content: z.string().max(5000).describe('Hook commands or config content'),
-    description: z.string().max(500).describe('Human-readable description of what this section does'),
-});
-// ---------------------------------------------------------------------------
-// Release notes shared sub-schemas
-// ---------------------------------------------------------------------------
-const audienceSchema = z
-    .enum(['developer', 'user', 'stakeholder'])
-    .optional()
-    .describe('Target audience for the release notes. Valid values: developer, user, stakeholder. ' +
-    'developer: includes spec IDs and technical tags. ' +
-    'user: simple language without technical IDs. ' +
-    'stakeholder: executive summary with business impact. ' +
-    'Defaults to user.');
-const formatSchema = z
-    .enum(['markdown', 'html', 'plain'])
-    .optional()
-    .describe('Output format. Valid values: markdown, html, plain. Defaults to markdown.');
-// ---------------------------------------------------------------------------
-// Token deprecation note
-// ---------------------------------------------------------------------------
-const DEPRECATION_NOTE = '[DEPRECATED] This tool will be removed in a future version. Use `tokens` with the appropriate view instead.';
-// ---------------------------------------------------------------------------
-// Main export
-// ---------------------------------------------------------------------------
-// eslint-disable-next-line max-lines-per-function -- registration catalog: one block per tool, each ~20 lines
-export function registerMiscGroupTools(s) {
-    // ── Team tools ─────────────────────────────────────────────────────────────
-    s.registerTool('plan_team_distribution', {
-        description: 'Plan how to distribute approved specs across an Agent Team. Detects file overlaps between specs and produces a phased execution order — non-conflicting specs run in parallel (phase 1), conflicting specs run sequentially (phase 2+). Returns teammate roster, file ownership map, and warnings for any shared files.',
-        inputSchema: {
-            ...projectIdSchema,
-            specIds: z
-                .array(z.string().max(500))
-                .min(1)
-                .max(100)
-                .describe('Spec IDs to distribute across the team. Typically approved/ready specs.'),
-            template: z
-                .string()
-                .max(200)
-                .optional()
-                .describe('Optional team template ID (e.g. "parallel-specs"). Defaults to "parallel-specs".'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('plan_team_distribution', withProject((args) => handlePlanTeamDistribution(args))));
-    s.registerTool('generate_teammate_prompt', {
-        description: 'Generate structured agent prompts for an Agent Team. Two modes: ' +
-            '(1) Spec mode — provide specId + teammateName + assignedFiles + role to generate a prompt for a specific spec and teammate. ' +
-            '(2) Layer mode — provide only projectId (and optional layer) to generate prompts for each detected architecture layer (frontend, backend, engine, storage, etc.). ' +
-            'Layer mode includes file ownership, stack-specific conventions, and quality gates per layer.',
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Spec mode: Spec ID assigned to this teammate. Omit to use layer mode instead.'),
-            teammateName: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Spec mode: Unique name for this teammate'),
-            assignedFiles: z
-                .array(z.string().max(4096))
-                .max(1000)
-                .optional()
-                .describe('Spec mode: Files this teammate has exclusive write access to'),
-            role: z
-                .enum(['planner', 'implementer', 'reviewer', 'tester', 'researcher'])
-                .optional()
-                .describe('Spec mode: Role: planner | implementer | reviewer | tester | researcher'),
-            layer: z
-                .string()
-                .max(200)
-                .optional()
-                .describe('Layer mode: Architecture layer to generate a prompt for (e.g. frontend, backend, engine, storage, types). Omit to generate prompts for all detected layers.'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('generate_teammate_prompt', withProject((args) => {
-        const typedArgs = args;
-        if (!typedArgs.specId) {
-            return handleGenerateLayerPrompts({
-                projectId: typedArgs.projectId,
-                layer: typedArgs.layer,
-            });
-        }
-        return handleGenerateTeammatePrompt(typedArgs);
-    })));
-    s.registerTool('validate_team_results', {
-        description: 'Validate the combined results from all teammates after parallel execution. ' +
-            'Checks for file conflicts, criteria coverage, and recommends merge order.',
-        inputSchema: {
-            ...projectIdSchema,
-            specIds: z.array(z.string().max(500)).max(100).describe('Spec IDs that were distributed'),
-            teammateNames: z
-                .array(z.string().max(500))
-                .max(100)
-                .describe('Names of teammates whose results to validate'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('validate_team_results', withProject((args) => handleValidateTeamResults(args))));
-    // ── LLM Provider tools ─────────────────────────────────────────────────────
-    s.registerTool('configure_llm_providers', {
-        description: 'Configure LLM providers for multi-provider support. ' +
-            'Add/remove providers, set failover priority, and choose load balancing strategy. ' +
-            'Supports: Anthropic, OpenAI, Google/Gemini, Mistral, Ollama, DeepSeek, and custom providers.',
-        inputSchema: {
-            action: ConfigureLLMProvidersActionEnum.describe('Action to perform: add | remove | update | set_priority | set_strategy'),
-            providerId: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Provider ID to remove (required for "remove" action).'),
-            provider: z
-                .object({
-                id: z.string().max(500).describe('Unique provider identifier.'),
-                name: z.string().max(500).describe('Human-readable provider name.'),
-                models: z
-                    .array(z.object({
-                    id: z.string().max(500).describe('Model identifier.'),
-                    name: z.string().max(500).describe('Model display name.'),
-                    tier: QualityTierEnum,
-                    pricingPerMToken: z.object({
-                        input: z.number().describe('Price per 1M input tokens in USD.'),
-                        output: z.number().describe('Price per 1M output tokens in USD.'),
-                    }),
-                    contextWindow: z.number().describe('Maximum context window in tokens.'),
-                    maxOutputTokens: z.number().describe('Maximum output tokens.'),
-                }))
-                    .max(100)
-                    .describe('Available models for this provider.'),
-                apiKeyEnv: z.string().max(500).describe('Environment variable name for the API key.'),
-                baseUrl: z.string().max(4096).describe('Base URL for the provider API.'),
-                capabilities: z.array(LLMCapabilityEnum).max(100).describe('Provider capabilities.'),
-                keyPattern: z.string().max(500).describe('Regex pattern to validate API key format.'),
-                rateLimits: z
-                    .object({
-                    requestsPerMinute: z.number().min(0).describe('Max requests per minute.'),
-                    tokensPerMinute: z.number().min(0).describe('Max tokens per minute.'),
-                })
-                    .describe('Rate limits for this provider.'),
-            })
-                .optional()
-                .describe('Provider definition (required for "add" and "update" actions).'),
-            failoverOrder: z
-                .array(z.string().max(500))
-                .max(100)
-                .optional()
-                .describe('Ordered list of provider IDs for failover priority.'),
-            strategy: LoadBalancingStrategyEnum.optional().describe('Load balancing strategy to use.'),
-        },
-        annotations: { title: 'Configure LLM Providers' },
-    }, safeLicensed('configure_llm_providers', (args) => Promise.resolve(handleConfigureLLMProviders(args))));
-    s.registerTool('llm_provider_status', {
-        description: 'Show status of all configured LLM providers including health, available models, ' +
-            'cost tracking, and recommendations. Displays a summary table with provider health, ' +
-            'API key status, model count, and accumulated costs.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Optional project path to show project-specific cost tracking.'),
-            detailed: z.boolean().optional().describe('Show detailed model information per provider.'),
-        },
-        annotations: { title: 'LLM Provider Status', readOnlyHint: true },
-    }, safeLicensed('llm_provider_status', (args) => Promise.resolve(handleLLMProviderStatus(args))));
-    // ── Spec observability ─────────────────────────────────────────────────────
-    s.registerTool('spec_usage_report', {
-        description: 'Generate a spec observability report showing which specs agents are actively using. ' +
-            'Identifies hot specs (frequently accessed), cold specs (approved but forgotten), ' +
-            'AC hotspots, and the tool-to-spec usage matrix. Useful for gap analysis and team focus.',
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z
-                .string()
-                .max(50)
-                .optional()
-                .describe('Optional: filter report to a single spec (e.g. "SPEC-042"). When omitted, returns full project report.'),
-            period: z
-                .enum(['day', 'week', 'month', 'all'])
-                .optional()
-                .describe('Time window for the report. Options: day | week | month | all. Defaults to week.'),
-        },
-        annotations: { title: 'Spec Usage Report', readOnlyHint: true },
-    }, safeLicensed('spec_usage_report', withProject((args) => handleSpecUsageReport(args))));
-    // ── Workspace dashboard ────────────────────────────────────────────────────
-    s.registerTool('workspace_overview', {
-        description: 'Get an overview of all registered projects in the workspace. Shows spec counts, progress, and health scores per project. Prefer resource: planu://workspace/overview (no parameters, zero tool slots).',
-        inputSchema: {
-            healthThreshold: z
-                .number()
-                .int()
-                .min(0)
-                .max(100)
-                .optional()
-                .default(50)
-                .describe('Health score threshold % for highlighting (default: 50)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('workspace_overview', async (args) => handleWorkspaceOverview(args)));
-    s.registerTool('workspace_health', {
-        description: 'Get aggregated health metrics across all registered workspace projects. Returns totals for specs, done, in-progress, blocked, and average health score. Prefer resource: planu://workspace/health (no parameters, zero tool slots).',
-        inputSchema: {
-            healthThreshold: z
-                .number()
-                .int()
-                .min(0)
-                .max(100)
-                .optional()
-                .default(50)
-                .describe('Health threshold % to classify projects (default: 50)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('workspace_health', async (args) => handleWorkspaceHealth(args)));
-    s.registerTool('bulk_project_operations', {
-        description: 'Run a bulk operation across multiple workspace projects. Supports validate-all (scan specs) and generate-reports. Use dryRun to preview affected projects.',
-        inputSchema: {
-            operation: z
-                .enum(['validate-all', 'generate-reports'])
-                .describe('Operation to run: validate-all or generate-reports'),
-            projectPaths: z
-                .array(z.string().min(1).max(4096))
-                .optional()
-                .describe('Specific project paths to target (omit for all registered projects)'),
-            dryRun: z
-                .boolean()
-                .optional()
-                .default(false)
-                .describe('Preview affected projects without running (default: false)'),
-        },
-        annotations: { readOnlyHint: false },
-    }, safeLicensed('bulk_project_operations', async (args) => handleBulkProjectOperations(args)));
-    s.registerTool('workspace_report', {
-        description: 'Generate an HTML workspace report summarizing all projects, spec counts, health scores, and progress. Suitable for stakeholder sharing.',
-        inputSchema: {
-            includeCharts: z
-                .boolean()
-                .optional()
-                .default(false)
-                .describe('Include visual charts (default: false)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('workspace_report', async (args) => handleWorkspaceReport(args)));
-    s.registerTool('workspace_search', {
-        description: 'Search for specs by keyword across all registered workspace projects. Searches spec IDs and titles.',
-        inputSchema: {
-            query: z.string().min(1).max(200).describe('Search keyword'),
-            maxResults: z
-                .number()
-                .int()
-                .min(1)
-                .max(200)
-                .optional()
-                .default(50)
-                .describe('Max results (default: 50)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('workspace_search', async (args) => handleWorkspaceSearch(args)));
-    s.registerTool('workspace_alerts', {
-        description: 'List stale specs across all workspace projects. Highlights specs in blocked or in-progress status that have not been updated for the configured number of days.',
-        inputSchema: {
-            staleDaysThreshold: z
-                .number()
-                .int()
-                .min(1)
-                .max(365)
-                .optional()
-                .default(14)
-                .describe('Days without update to consider a spec stale (default: 14)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('workspace_alerts', async (args) => handleWorkspaceAlerts(args)));
-    // ── Hook generator ─────────────────────────────────────────────────────────
-    s.registerTool('generate_hooks_for_stack', {
-        description: 'Generates git hooks and AI-tool-specific hooks based on the detected or specified ' +
-            'project stack. Merges intelligently with existing hook files using planu markers ' +
-            '(<!-- planu:generated:ID -->) so manual edits outside markers are never overwritten.',
-        inputSchema: {
-            projectPath: z.string().max(1000).describe('Absolute path to the project root directory'),
-            stack: z
-                .array(z.string().max(100))
-                .optional()
-                .describe('Stack tokens to generate hooks for. If omitted, auto-detected from project files. Examples: typescript, eslint, prettier, vitest, jest, python, go, commitlint'),
-            aiTool: z
-                .string()
-                .max(100)
-                .optional()
-                .describe('AI tool to generate tool-specific hooks for. If omitted, auto-detected. Values: claude | cursor | windsurf | gemini | kiro | cline | copilot | aider'),
-            dryRun: z
-                .boolean()
-                .optional()
-                .describe('If true, shows what would be generated without writing files. Default: false'),
-        },
-        annotations: { title: 'Generate Hooks for Stack', readOnlyHint: false },
-    }, safeLicensed('generate_hooks_for_stack', async (args) => handleGenerateHooksForStack(args)));
-    s.registerTool('preview_hooks', {
-        description: 'Previews what generate_hooks_for_stack would add or update without writing any files. ' +
-            'Shows which phases would be modified, which sections are already present, and what new sections would be injected.',
-        inputSchema: {
-            projectPath: z.string().max(1000).describe('Absolute path to the project root directory'),
-            stack: z
-                .array(z.string().max(100))
-                .optional()
-                .describe('Stack tokens to preview. If omitted, auto-detected. Examples: typescript, eslint, vitest, python, go'),
-        },
-        annotations: { title: 'Preview Hook Changes', readOnlyHint: true },
-    }, safeTracked('preview_hooks', async (args) => handlePreviewHooks(args)));
-    s.registerTool('merge_hooks', {
-        description: 'Merges explicit HookSection entries into the appropriate git hook files. ' +
-            'Uses planu markers for idempotent injection — re-running the same sections is safe and produces no duplicate output.',
-        inputSchema: {
-            projectPath: z.string().max(1000).describe('Absolute path to the project root directory'),
-            sections: z
-                .array(hookSectionSchema)
-                .describe('Hook sections to merge into the project hook files'),
-            dryRun: z
-                .boolean()
-                .optional()
-                .describe('If true, computes the merged content but does NOT write files. Default: false'),
-        },
-        annotations: { title: 'Merge Hook Sections', readOnlyHint: false },
-    }, safeLicensed('merge_hooks', async (args) => {
-        const typed = args;
-        const input = {
-            projectPath: typed.projectPath,
-            sections: typed.sections,
-            dryRun: typed.dryRun,
-        };
-        return handleMergeHooks(input);
-    }));
-    // ── Project DNA ────────────────────────────────────────────────────────────
-    s.registerTool('detect_project_dna', {
-        description: 'Detect the technology stack and active AI tool for a project. ' +
-            'Reads package.json, Cargo.toml, go.mod, requirements.txt, tsconfig.json, ' +
-            'and AI tool detection files to build a complete Project DNA profile.',
-        inputSchema: DetectProjectDNAInputSchema,
-        annotations: {
-            title: 'Detect Project DNA',
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    }, safeTracked('detect_project_dna', async (args) => handleDetectProjectDNA(args)));
-    s.registerTool('bootstrap_project_intelligence', {
-        description: 'Generate AI tool rules and suggest skills based on the detected project stack. ' +
-            'Creates rules files in the format expected by the active AI tool ' +
-            '(markdown for Claude/Kiro/Gemini, .mdc for Cursor, appended sections for Windsurf/Cline/Copilot). ' +
-            'Supported stack tokens: supabase, typescript, nextjs, vitest, react, prisma, zod, stripe, jest, ' +
-            'fastapi, django, flask, gin, axum, tailwind.',
-        inputSchema: BootstrapProjectIntelligenceInputSchema,
-        annotations: {
-            title: 'Bootstrap Project Intelligence',
-            readOnlyHint: false,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    }, safeLicensed('bootstrap_project_intelligence', async (args) => handleBootstrapProjectIntelligence(args)));
-    s.registerTool('update_project_dna', {
-        description: 'Re-scan a project to refresh its DNA profile (stack, AI tool, package manager). ' +
-            'Use after adding new dependencies or switching AI tools. ' +
-            'After updating, run bootstrap_project_intelligence to apply the new configuration.',
-        inputSchema: UpdateDNAInputSchema,
-        annotations: {
-            title: 'Update Project DNA',
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    }, safeLicensed('update_project_dna', async (args) => handleUpdateProjectDNA(args)));
-    // ── Steering tools ─────────────────────────────────────────────────────────
-    s.registerTool('generate_steering_file', {
-        description: 'Generate steering files that provide persistent project context to AI tools. ' +
-            'Supports Kiro (.kiro/steering/), Cursor (.cursorrules), Claude Code (CLAUDE.md section), ' +
-            'and Cline (.clinerules). Based on project stack and Planu spec data.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(2000)
-                .describe('Absolute path to the project root directory.'),
-            target: z
-                .enum(['kiro', 'cursor', 'claude', 'cline', 'copilot', 'codex', 'all'])
-                .describe('AI tool target for steering files. Valid values: kiro, cursor, claude, cline, copilot, codex, all.'),
-            stack: z
-                .array(z.string().max(200))
-                .max(50)
-                .optional()
-                .describe('Technology stack list (e.g. ["typescript", "react", "nextjs"]). Used to generate relevant architecture guidance.'),
-            specCount: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe('Total number of specs in the project. Included in architecture section.'),
-            conventions: z
-                .array(z.string().max(500))
-                .max(50)
-                .optional()
-                .describe('Key project conventions to include in architecture steering (e.g. ["Use camelCase for variables", "All imports use .js extensions"]).'),
-        },
-        annotations: { readOnlyHint: false },
-    }, safeLicensed('generate_steering_file', async (args) => handleGenerateSteeringFile(args)));
-    s.registerTool('list_steering_files', {
-        description: 'Show previously generated steering files for a project. Lists the files created by the last generate_steering_file call.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(2000)
-                .describe('Absolute path to the project root directory.'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('list_steering_files', async (args) => handleListSteeringFiles(args)));
-    // ── Skill bootstrap ────────────────────────────────────────────────────────
-    s.registerTool('discover_skills_from_registries', {
-        description: 'Detect the project tech stack and discover available skills from external registries ' +
-            '(awesome-cursorrules, skills.sh, custom GitHub sources). Shows what would be installed ' +
-            'without writing any files. Great for exploring available skills before bootstrapping.',
-        inputSchema: DiscoverSkillsInputSchema,
-        annotations: { readOnlyHint: true },
-    }, safeTracked('discover_skills_from_registries', (input) => handleDiscoverSkillsFromRegistries(input)));
-    s.registerTool('bootstrap_skills', {
-        description: 'Auto-detect the project stack and install the best matching skills from external ' +
-            'registries (awesome-cursorrules, skills.sh, custom GitHub repos) into the appropriate ' +
-            'AI tool config files: .cursorrules, .windsurfrules, CLAUDE.md, .kiro/steering/, ' +
-            'AGENTS.md, .clinerules. Use dryRun:true to preview without writing.',
-        inputSchema: BootstrapSkillsInputSchema,
-        annotations: { destructiveHint: true },
-    }, safeLicensed('bootstrap_skills', (input) => handleBootstrapSkills(input)));
-    s.registerTool('configure_skill_registries', {
-        description: 'Configure which skill registries to use, which AI tool files to write, and whether ' +
-            'to append or overwrite existing files. Add custom GitHub repos as additional skill sources.',
-        inputSchema: ConfigureSkillRegistriesInputSchema,
-    }, safeLicensed('configure_skill_registries', (input) => handleConfigureSkillRegistries(input)));
-    // ── Release notes ──────────────────────────────────────────────────────────
-    s.registerTool('preview_release_notes', {
-        description: 'Preview how many specs are eligible for release notes in a given date range. Shows count and first 3 titles without generating the full document. Free tier.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            fromDate: z
-                .string()
-                .optional()
-                .describe('ISO date string for the start of the range (default: 30 days ago).'),
-            toDate: z
-                .string()
-                .optional()
-                .describe('ISO date string for the end of the range (default: now).'),
-            maxEntries: z
-                .number()
-                .int()
-                .min(1)
-                .max(200)
-                .optional()
-                .describe('Maximum number of entries to return (default: 10).'),
-        },
-    }, safeTracked('preview_release_notes', async (args) => handlePreviewReleaseNotes(args)));
-    s.registerTool('generate_release_notes', {
-        description: 'Generate human-readable release notes from specs in "done" status filtered by date range. ' +
-            'Supports multiple audiences (developer, user, stakeholder) and formats (markdown, html, plain). Pro tier.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            fromDate: z
-                .string()
-                .optional()
-                .describe('ISO date string for the start of the range (default: 30 days ago).'),
-            toDate: z
-                .string()
-                .optional()
-                .describe('ISO date string for the end of the range (default: now).'),
-            version: z
-                .string()
-                .max(50)
-                .optional()
-                .describe('Version label to include in the header (e.g. "v1.17.0").'),
-            audience: audienceSchema,
-            format: formatSchema,
-            maxEntries: z
-                .number()
-                .int()
-                .min(1)
-                .max(500)
-                .optional()
-                .describe('Maximum number of entries to include (default: 50).'),
-        },
-    }, safeLicensed('generate_release_notes', async (args) => handleGenerateReleaseNotes(args)));
-    s.registerTool('configure_release_notes', {
-        description: 'Save default settings for release notes generation (audience, format, groupByTag). ' +
-            'These defaults are applied when generate_release_notes is called without explicit options. Pro tier.',
-        annotations: { readOnlyHint: false },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            defaultAudience: audienceSchema,
-            defaultFormat: formatSchema,
-            includeBreakingChanges: z
-                .boolean()
-                .optional()
-                .describe('Whether to include breaking changes section (default: true).'),
-            groupByTag: z
-                .boolean()
-                .optional()
-                .describe('Whether to group entries by tag category (default: false).'),
-        },
-    }, safeLicensed('configure_release_notes', async (args) => handleConfigureReleaseNotes(args)));
-    // ── Tokens ─────────────────────────────────────────────────────────────────
-    s.registerTool('tokens', {
-        description: 'Unified token management dashboard. Choose a view to see different aspects of token usage. ' +
-            'Views: usage (session metrics + cache), intelligence (cost analytics + budget), ' +
-            'optimizer (RTK/Headroom installation status), savings (spec-guided vs unstructured comparison).',
-        inputSchema: {
-            view: z
-                .enum(['usage', 'intelligence', 'optimizer', 'savings'])
-                .describe('View to show. Values: usage, intelligence, optimizer, savings. usage=session token metrics; intelligence=cost analytics dashboard; optimizer=RTK/Headroom status; savings=spec-guided savings report.'),
-            projectPath: z
-                .string()
-                .optional()
-                .describe('Absolute path to the project root. Required for optimizer and savings views.'),
-            projectId: z.string().optional().describe('Project ID hash. Prefer projectPath.'),
-            period: z
-                .string()
-                .optional()
-                .describe('Time period filter. For usage: current_session|last_hour|today|all_time. For intelligence/savings: today|week|month|all_time.'),
-            groupBy: z
-                .string()
-                .optional()
-                .describe('Group results by. For usage: tool|session. For intelligence: tool|model|spec|day.'),
-            specId: z
-                .string()
-                .optional()
-                .describe('Filter intelligence view by a specific spec ID (e.g. SPEC-180).'),
-            intelligenceView: z
-                .string()
-                .optional()
-                .describe('Intelligence sub-view: summary|detailed|budget|reconciliation|trends. Defaults to summary.'),
-        },
-        annotations: { title: 'Tokens', readOnlyHint: true },
-    }, safe(async (args) => handleTokens(args)));
-    s.registerTool('token_usage', {
-        description: `${DEPRECATION_NOTE} Shows token consumption metrics.`,
-        inputSchema: {
-            period: z
-                .enum(['current_session', 'last_hour', 'today', 'all_time'])
-                .optional()
-                .describe('Time period: current_session | last_hour | today | all_time.'),
-            groupBy: z.enum(['tool', 'session']).optional().describe('Group by: tool | session.'),
-        },
-        annotations: { title: 'Token Usage (deprecated)', readOnlyHint: true },
-    }, safe(async (args) => {
-        const shimArgs = args;
-        const result = await handleTokens({ view: 'usage', ...shimArgs });
-        return {
-            ...result,
-            content: [
-                {
-                    type: 'text',
-                    text: `> ${DEPRECATION_NOTE}\n\n${result.content[0]?.text ?? ''}`,
-                },
-            ],
-        };
-    }));
-    s.registerTool('token_intelligence', {
-        description: `${DEPRECATION_NOTE} Advanced token analytics dashboard.`,
-        inputSchema: {
-            period: z
-                .enum(['today', 'week', 'month', 'all_time'])
-                .optional()
-                .describe('Time period: today | week | month | all_time.'),
-            groupBy: z
-                .enum(['tool', 'model', 'spec', 'day'])
-                .optional()
-                .describe('Group by: tool | model | spec | day.'),
-            view: z
-                .enum(['summary', 'detailed', 'budget', 'reconciliation', 'trends'])
-                .optional()
-                .describe('Dashboard view: summary | detailed | budget | reconciliation | trends.'),
-            specId: z.string().optional().describe('Filter by a specific spec ID.'),
-            projectPath: z.string().optional().describe('Absolute path to the project root.'),
-        },
-        annotations: { title: 'Token Intelligence (deprecated)', readOnlyHint: true },
-    }, safe(async (args) => {
-        const shimArgs = args;
-        const result = await handleTokens({
-            view: 'intelligence',
-            period: shimArgs.period,
-            groupBy: shimArgs.groupBy,
-            intelligenceView: shimArgs.view,
-            specId: shimArgs.specId,
-            projectPath: shimArgs.projectPath,
-        });
-        return {
-            ...result,
-            content: [
-                {
-                    type: 'text',
-                    text: `> ${DEPRECATION_NOTE}\n\n${result.content[0]?.text ?? ''}`,
-                },
-            ],
-        };
-    }));
-    s.registerTool('token_savings_report', {
-        description: `${DEPRECATION_NOTE} Compares spec-guided vs unstructured token usage.`,
-        inputSchema: {
-            period: z
-                .enum(['today', 'week', 'month', 'all_time'])
-                .optional()
-                .describe('Time period: today | week | month | all_time. Defaults to month.'),
-            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
-            projectPath: z.string().max(4096).optional().describe('Absolute path to project root.'),
-        },
-        annotations: { title: 'Token Savings Report (deprecated)', readOnlyHint: true },
-    }, safe(async (args) => {
-        const shimArgs = args;
-        const result = await handleTokens({ view: 'savings', ...shimArgs });
-        return {
-            ...result,
-            content: [
-                {
-                    type: 'text',
-                    text: `> ${DEPRECATION_NOTE}\n\n${result.content[0]?.text ?? ''}`,
-                },
-            ],
-        };
-    }));
-    // ── Validation loop ────────────────────────────────────────────────────────
-    s.registerTool('spec_health_check', {
-        description: 'Compute a 0-100 health score for a spec by checking: completeness (title + description + criteria), ' +
-            'test file existence, last validation result, spec status (done = coverage ok), and drift status. ' +
-            'Each dimension is worth 20 points.',
-        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 check (e.g. SPEC-001)'),
-            since: z
-                .string()
-                .optional()
-                .describe('ISO 8601 date (e.g. 2026-01-01). When provided, shows the health score delta since that date.'),
-        },
-        annotations: { title: 'Spec Health Check', readOnlyHint: true },
-    }, safeLicensed('spec_health_check', async (args) => handleSpecHealthCheck(args)));
-    s.registerTool('health_check_all', {
-        description: 'Run spec_health_check on all specs in the project and return them sorted from worst to best score. Use this to identify which specs need the most attention.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-        },
-        annotations: { title: 'Health Check All Specs', readOnlyHint: true },
-    }, safeLicensed('health_check_all', async (args) => handleHealthCheckAll(args)));
-    s.registerTool('run_validation_loop', {
-        description: 'Generate a structured validation execution plan for a set of specs. ' +
-            'Shows the steps to validate each spec (validate → test → fix → re-validate) ' +
-            'with the specified number of iterations. ' +
-            'NOTE: Planu cannot run shell commands — this returns the plan for you to execute.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-            specIds: z
-                .array(z.string().min(1).max(200))
-                .min(1)
-                .max(50)
-                .describe('List of spec IDs to validate (e.g. ["SPEC-001", "SPEC-002"])'),
-            maxIterations: z
-                .number()
-                .int()
-                .min(1)
-                .max(10)
-                .optional()
-                .describe('Maximum number of fix-and-retry iterations (default: 3)'),
-            testCommand: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Shell command to run tests (default: "pnpm test")'),
-            autoFix: z
-                .boolean()
-                .optional()
-                .describe('Whether to include auto-fix steps in the plan (default: false)'),
-        },
-        annotations: { title: 'Run Validation Loop (Plan)', readOnlyHint: true },
-    }, safeLicensed('run_validation_loop', (args) => Promise.resolve(handleRunValidationLoop(args))));
-    // ── Spec cookbook ──────────────────────────────────────────────────────────
-    s.registerTool('cookbook_list', {
-        description: 'List spec cookbook entries. Filter by domain or feature type. Returns a table of available spec templates you can apply to your project.',
-        inputSchema: {
-            domain: z
-                .enum(['ecommerce', 'saas', 'mobile', 'api', 'fintech', 'devtools', 'general'])
-                .optional()
-                .describe('Filter by domain: ecommerce, saas, mobile, api, fintech, devtools, general'),
-            featureType: z
-                .string()
-                .max(100)
-                .optional()
-                .describe('Filter by feature type (e.g. auth, payments, notifications)'),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .default(50)
-                .describe('Max entries to return (default: 50)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('cookbook_list', (args) => handleCookbookList(args)));
-    s.registerTool('cookbook_get', {
-        description: 'Get details for a specific cookbook entry by ID. Shows acceptance criteria, tags, and estimated effort.',
-        inputSchema: {
-            id: z.string().min(1).max(200).describe('Cookbook entry ID (e.g. ecommerce-user-auth)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('cookbook_get', (args) => handleCookbookGet(args)));
-    s.registerTool('cookbook_apply', {
-        description: 'Generate a spec template from a cookbook entry. Returns ready-to-use spec content with [PLACEHOLDER] markers. Copy the output and pass it to create_spec.',
-        inputSchema: {
-            id: z.string().min(1).max(200).describe('Cookbook entry ID to apply'),
-            projectName: z
-                .string()
-                .max(200)
-                .optional()
-                .describe('Project name to personalize the spec template'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('cookbook_apply', (args) => handleCookbookApply(args)));
-    s.registerTool('cookbook_contribute', {
-        description: 'Add a new entry to the cookbook (in-memory for this session). Use to share patterns with your team.',
-        inputSchema: {
-            domain: z
-                .enum(['ecommerce', 'saas', 'mobile', 'api', 'fintech', 'devtools', 'general'])
-                .describe('Domain: ecommerce, saas, mobile, api, fintech, devtools, general'),
-            featureType: z
-                .string()
-                .min(1)
-                .max(100)
-                .describe('Feature type (e.g. auth, payments, search)'),
-            title: z.string().min(1).max(200).describe('Entry title'),
-            description: z.string().min(1).max(1000).describe('Entry description'),
-            acceptanceCriteria: z
-                .array(z.string().min(1).max(500))
-                .min(1)
-                .max(20)
-                .describe('List of acceptance criteria'),
-            tags: z.array(z.string().min(1).max(50)).min(1).max(10).describe('Tags for searchability'),
-        },
-        annotations: { readOnlyHint: false },
-    }, safeLicensed('cookbook_contribute', (args) => handleCookbookContribute(args)));
-    s.registerTool('cookbook_search', {
-        description: 'Search cookbook entries by keyword. Searches ID, title, description, domain, type, and tags.',
-        inputSchema: {
-            query: z.string().min(1).max(200).describe('Search query'),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(50)
-                .optional()
-                .default(20)
-                .describe('Max results (default: 20)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('cookbook_search', (args) => handleCookbookSearch(args)));
-    // ── Doc compliance ─────────────────────────────────────────────────────────
-    s.registerTool('doc_compliance_report', {
-        description: 'Check whether a spec aligns with official documentation best practices for detected technologies. ' +
-            'Automatically detects techs from spec content, fetches official docs, and reports anti-patterns ' +
-            'and missing best practices.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root'),
-            specId: z.string().describe('Spec ID to check (e.g. SPEC-042)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('doc_compliance_report', async (args) => handleDocComplianceReport(args)));
-    // ── Spec prompt (delegates to registerSpecPromptHandlers) ──────────────────
-    registerSpecPromptHandlers(s);
-    // ── Test reverse engineer ──────────────────────────────────────────────────
-    s.registerTool('reverse_engineer_tests', {
-        description: 'Parse an existing E2E or unit test file (Playwright, Cypress, Jest) and extract its test descriptions as Planu acceptance criteria. Optionally create a new spec from the generated ACs. Useful for reverse-engineering undocumented test suites into structured specs.',
-        inputSchema: ReverseEngineerTestsInputSchema.shape,
-        annotations: { readOnlyHint: false },
-    }, safeTracked('reverse_engineer_tests', async (args) => handleReverseEngineerTests(args)));
-    // ── Reconcile rules ────────────────────────────────────────────────────────
-    s.registerTool('reconcile_rules', {
-        description: 'Compare CLAUDE.md conventions against existing .claude/rules/ files and auto-patch drift. Generates new rules files for convention categories not yet covered. Returns a health score (0-100) and list of stale or missing rules.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .describe('Absolute path to the project root containing CLAUDE.md and .claude/rules/'),
-        },
-        annotations: { readOnlyHint: false, destructiveHint: false, title: 'Reconcile Rules' },
-    }, safeTracked('reconcile_rules', (args) => {
-        const result = reconcileRules(args.projectPath);
-        const text = formatRulesReconciliation(result);
-        const isError = result.healthScore === 0 && !result.rulesInSync;
-        return Promise.resolve({ content: [{ type: 'text', text }], isError });
-    }));
-    // ── Reconcile skills ───────────────────────────────────────────────────────
-    s.registerTool('reconcile_skills', {
-        description: "Analyze the gap between the project's current tech stack and its installed Claude skills. " +
-            'Detects skills that are recommended for the stack but not yet installed (newSkillsDetected) ' +
-            'and skills installed for technologies no longer in use (staleSkills). ' +
-            'Returns a health score (0–100) indicating how well skills match the current stack. ' +
-            'Pass autoFix:true to automatically install missing skills, remove stale skills, ' +
-            'and repair corrupt manifest paths (mutates .claude/skills/).',
-        inputSchema: {
-            projectId: ReconcileSkillsInputSchema.shape.projectId,
-            projectPath: ReconcileSkillsInputSchema.shape.projectPath,
-            autoFix: ReconcileSkillsInputSchema.shape.autoFix,
-        },
-        annotations: { title: 'Reconcile Skills', readOnlyHint: false },
-    }, safeTracked('reconcile_skills', async (args) => handleReconcileSkillsInline(args)));
-    // ── Reconcile hooks ────────────────────────────────────────────────────────
-    s.registerTool('reconcile_hooks', {
-        description: 'Detect drift between the project CI/quality pipeline and its git hooks. Checks whether hooks enforce TypeScript, ESLint, tests, commitlint, and Prettier based on what the project has installed. Returns a health score (0-100) and lists missing or outdated steps. ' +
-            'With autoFix:true, automatically patches husky hook files to add missing quality checks (idempotent).',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .describe('Absolute path to the project root to analyse git hooks against CI capabilities'),
-            autoFix: z
-                .boolean()
-                .optional()
-                .describe('When true, automatically patches husky hook files to add missing quality checks. Idempotent: checks already present are skipped. Default: false.'),
-        },
-        annotations: { readOnlyHint: false, destructiveHint: false, title: 'Reconcile Hooks' },
-    }, safeTracked('reconcile_hooks', (args) => Promise.resolve(handleReconcileHooksInline(args))));
-    // ── AI ecosystem status ────────────────────────────────────────────────────
-    s.registerTool('ecosystem_status', {
-        description: 'Scan the AI tool ecosystem of a project and return a health report showing which AI tools are detected and how well they are configured for Planu SDD workflow.',
-        inputSchema: AiEcosystemStatusSchema,
-        annotations: { readOnlyHint: true, destructiveHint: false, title: 'AI Ecosystem Status' },
-    }, safeTracked('ecosystem_status', async (args) => {
-        const pid = resolveProjectId(args);
-        if (!pid) {
-            return missingProjectIdError;
-        }
-        return handleAiEcosystemStatus(args);
-    }));
-    // ── Sync AI configs ────────────────────────────────────────────────────────
-    s.registerTool('sync_ai_configs', {
-        description: 'Detect installed AI coding tools and synchronize their configuration files with the Planu SDD workflow. Generates .cursorrules, .windsurfrules, .aider.conf.yml, etc. for detected tools.',
-        inputSchema: SyncAiConfigsSchema,
-        annotations: { readOnlyHint: false, destructiveHint: false, title: 'Sync AI Configs' },
-    }, safeTracked('sync_ai_configs', async (args) => {
-        const pid = resolveProjectId(args);
-        if (!pid) {
-            return missingProjectIdError;
-        }
-        return handleSyncAiConfigs(args);
-    }));
-    // ── Sync spec state (delegates — has complex startup helpers) ──────────────
-    registerSyncSpecStateTool(s);
-    // ── Repair frontmatter drift (SPEC-698) ─────────────────────────────────────
-    registerRepairFrontmatterDriftTool(s);
-    // ── Generate dashboard ─────────────────────────────────────────────────────
-    s.registerTool('generate_spec_dashboard', {
-        description: 'Regenerate planu/index.html dashboard with all specs, metrics, and pagination. Call after bulk changes or to fix a stale dashboard.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root directory'),
-        },
-        annotations: { readOnlyHint: false },
-    }, async (args) => {
-        const projectId = hashProjectPath(args.projectPath);
-        const specs = await specStore.listSpecs(projectId);
-        await regenerateSpecSummaryHtml(args.projectPath, specs);
-        const doneCount = specs.filter((sp) => sp.status === 'done').length;
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Dashboard regenerated: ${String(specs.length)} specs (${String(doneCount)} done). File: planu/index.html`,
-                },
-            ],
-        };
-    });
-    // ── Generate proposal (handler is private — delegate to registerer) ───────────
-    registerGenerateProposalTool(s);
-    // ── Planu session checkpoint (SPEC-585) ───────────────────────────────────
-    s.registerTool('planu_session_checkpoint', {
-        description: 'Run a session continuity checkpoint: regenerate session-context.md if stale, flush ' +
-            'learnings-buffer to MEMORY.md, detect unpushed commits with age warning (>2h), and ' +
-            'optionally push them if autopush is enabled in planu/config.json. ' +
-            'Idempotent — safe to call at any time. Called automatically by the PreCompaction hook.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Absolute path to the project root. Defaults to process.cwd() when omitted.'),
-            dryRun: z
-                .boolean()
-                .optional()
-                .describe('When true, report what would happen without making any changes. Default: false.'),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            title: 'Planu Session Checkpoint',
-        },
-    }, safeTracked('planu_session_checkpoint', async (args) => handlePlanSessionCheckpoint(args)));
-    // ── Execute SDD flow (SPEC-583 → migrated to skill, SPEC-658) ───────────────
-    // Tool stays registered for backward compat; callers receive a deprecation notice.
-    registerFromEntries(s, [
-        makeDeprecationStub('execute_sdd_flow', '.claude/skills/new-feature.md', 'new-feature'),
-    ]);
-    // ── Reconcile interactive question hooks (SPEC-584) ────────────────────────
-    s.registerTool('reconcile_interactive_question_hooks', {
-        description: 'CRITICAL — Install the PostToolUse hook that forces AskUserQuestion relay when Planu returns interactiveQuestions. ' +
-            'Writes .claude/hooks/planu-force-ask-user-question.sh and registers the mcp__planu__.* PostToolUse matcher in .claude/settings.json. ' +
-            'Idempotent — safe to call multiple times. Called automatically during init_project; use this for existing client projects.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .describe('Absolute path to the client project root where .claude/ should be written'),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            title: 'Reconcile Interactive Question Hooks',
-        },
-    }, safeTracked('reconcile_interactive_question_hooks', async (args) => handleReconcileInteractiveQuestionHooks(args)));
-    // ── SPEC-753: project_overview (single-call state query) ──────────────────
-    s.registerTool('project_overview', {
-        description: 'SPEC-753: Single-call project state query — counts by status, top pending specs, ' +
-            'version sync, self-healing health, stale-implementing detector, drift score. ' +
-            'Use this instead of combining planu_status + list_specs + filesystem reads. ' +
-            'Returns structuredContent for programmatic use.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Project root path (auto-resolved from cwd if omitted)'),
-            includeStaleImplementing: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe('Include stale-implementing detection (default: true)'),
-            staleDays: z
-                .number()
-                .int()
-                .min(1)
-                .optional()
-                .default(7)
-                .describe('Days threshold for stale-implementing detector (default: 7)'),
-            topN: z
-                .number()
-                .int()
-                .min(1)
-                .max(50)
-                .optional()
-                .default(10)
-                .describe('How many top pending specs to return (default: 10)'),
-        },
-        annotations: { readOnlyHint: true, title: 'Project Overview (SPEC-753)' },
-    }, safeLicensed('project_overview', async (args) => handleProjectOverview(args)));
-    // ── SPEC-753: reconcile_status_json ────────────────────────────────────────
-    s.registerTool('reconcile_status_json', {
-        description: 'SPEC-753: Reconcile status.json with spec.md frontmatter values. ' +
-            'Detects drift between what status.json thinks and what frontmatters say. ' +
-            'Use source=frontmatter-wins to trust frontmatters (safest). ' +
-            'Default is dryRun=true — set dryRun=false to actually apply corrections.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Project root path (auto-resolved from cwd if omitted)'),
-            source: z
-                .enum(['frontmatter-wins', 'status-wins', 'newest-wins'])
-                .optional()
-                .default('frontmatter-wins')
-                .describe("Source of truth: 'frontmatter-wins' (default), 'status-wins', 'newest-wins'"),
-            dryRun: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe('Preview changes without applying (default: true)'),
-        },
-        annotations: { readOnlyHint: false, title: 'Reconcile status.json (SPEC-753)' },
-    }, safeLicensed('reconcile_status_json', async (args) => handleReconcileStatusJson(args)));
-    // ── SPEC-969: force_status_analytics ────────────────────────────────────────
-    s.registerTool('force_status_analytics', {
-        description: 'SPEC-969: Query force-usage analytics for a project. ' +
-            'Returns a list of specs that bypassed gates via forceStatus or forceApprove, ' +
-            'including reasons, agents, and timestamps. ' +
-            'Set generateReport=true to write a quality-exceptions.md report to planu/reports/.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Project root path (auto-resolved from cwd if omitted)'),
-            generateReport: z
-                .boolean()
-                .optional()
-                .default(false)
-                .describe('Generate a quality-exceptions.md report in planu/reports/ (default: false)'),
-        },
-        annotations: { readOnlyHint: true, title: 'Force Status Analytics (SPEC-969)' },
-    }, safeLicensed('force_status_analytics', async (args) => handleForceStatusAnalytics(args)));
-    // ── SPEC-739: flag_spec_gap ─────────────────────────────────────────────────
-    s.registerTool('flag_spec_gap', {
-        description: 'Record a spec implementation gap discovered mid-implementation. ' +
-            'Persists a hash-chained entry to planu/research/gaps.jsonl with severity ' +
-            "classification ('low' | 'medium' | 'high') and affected spec links. " +
-            'Existing callers without severity or affectedSpecs continue to work (defaults applied).',
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).describe('Spec ID where the gap was discovered (e.g. SPEC-732)'),
-            description: z.string().min(1).max(2000).describe('Human-readable description of the gap'),
-            severity: z
-                .enum(['low', 'medium', 'high'])
-                .optional()
-                .describe("Gap severity. Defaults to 'medium' when omitted"),
-            affectedSpecs: z
-                .array(z.string())
-                .optional()
-                .describe('Spec IDs affected by this gap. Defaults to [specId] when omitted'),
-        },
-        annotations: { readOnlyHint: false, destructiveHint: false, title: 'Flag Spec Gap' },
-    }, safe((args) => handleFlagSpecGap(args)));
-    // ── SPEC-751: housekeeping_sweep ─────────────────────────────────────────────
-    s.registerTool('housekeeping_sweep', {
-        description: 'Scan for and optionally delete stale git branches (tmp-*, feat/spec-*, worktree-agent-*), ' +
-            'git worktrees (.claude/worktrees/agent-*), and old stashes. ' +
-            'Defaults to dryRun: true — no changes until you opt in. ' +
-            'Always writes a backup log to planu/.housekeeping-history.jsonl for recovery. ' +
-            'Use after a release or after marking specs done to keep the git workspace clean.',
-        inputSchema: HousekeepingSweepInputSchema.shape,
-        annotations: { readOnlyHint: false, destructiveHint: true, title: 'Housekeeping Sweep' },
-    }, safeLicensed('housekeeping_sweep', async (args) => {
-        const raw = args;
-        const projectPath = raw.projectPath ?? process.cwd();
-        return handleHousekeepingSweep(raw, projectPath);
-    }));
-}
-//# sourceMappingURL=group-misc.js.map