@planu/cli 1.1.2 → 1.3.0

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

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureNotion, handleSyncToNotion, handleNotionStatus, handleRemoveNotion, } from './notion-handler.js';
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root where Planu stores its data.');
+export function registerNotionTools(server) {
+    server.registerTool('configure_notion', {
+        description: 'Configure Notion integration for a project. ' +
+            'Stores credentials locally and uses them for sync_to_notion. ' +
+            'Requires a Notion integration token and database ID. ' +
+            'Get your token at: https://www.notion.so/my-integrations',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            token: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Notion integration token (starts with "secret_"). ' +
+                'Create at https://www.notion.so/my-integrations'),
+            databaseId: z
+                .string()
+                .min(1)
+                .max(100)
+                .describe('Notion database ID (UUID from the database URL). ' +
+                'The integration must be added to the database.'),
+            syncMode: z
+                .enum(['one-way-to-notion', 'bidirectional'])
+                .describe('Sync direction. ' +
+                '"one-way-to-notion" pushes Planu specs to Notion. ' +
+                '"bidirectional" also reads status back from Notion (informational).'),
+            fieldMapping: z
+                .object({
+                title: z.string().optional(),
+                description: z.string().optional(),
+                status: z.string().optional(),
+                priority: z.string().optional(),
+                tags: z.string().optional(),
+            })
+                .optional()
+                .describe('Optional override for Notion database property names. ' +
+                'Default: title→title, description→rich_text, status→select, priority→select, tags→multi_select.'),
+        },
+        annotations: { title: 'Configure Notion Integration' },
+    }, safeTracked('configure_notion', (args) => handleConfigureNotion(args)));
+    server.registerTool('sync_to_notion', {
+        description: 'Sync Planu specs to a Notion database as pages. ' +
+            'By default syncs all approved, in-progress, and done specs. ' +
+            'Creates new pages or updates existing ones based on saved mapping. ' +
+            'Run configure_notion first.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            specId: z
+                .string()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Optional SPEC-XXX identifier to sync a single spec. Omit to sync all.'),
+        },
+        annotations: { title: 'Sync Specs to Notion' },
+    }, safeTracked('sync_to_notion', (args) => handleSyncToNotion(args)));
+    server.registerTool('notion_status', {
+        description: 'Show the current Notion integration status: configuration, synced page count, and recent sync history.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Notion Integration Status', readOnlyHint: true },
+    }, safeTracked('notion_status', (args) => handleNotionStatus(args)));
+    server.registerTool('remove_notion', {
+        description: 'Remove the Notion integration configuration and sync mapping for a project. ' +
+            'Run configure_notion to re-enable.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Remove Notion Integration', destructiveHint: true },
+    }, safeTracked('remove_notion', (args) => handleRemoveNotion(args)));
+}
+//# sourceMappingURL=register-notion-tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleStartOnboarding, handleGuidedTour, handleOnboardingChecklist, handleQuickStart, handleOnboardingProgress, } from './onboarding-handler.js';
+export function registerOnboardingTools(server) {
+    // start_onboarding
+    server.registerTool('start_onboarding', {
+        description: 'Start interactive onboarding for a new project. Generates personalized recommendations based on your role, project type, and team size. Returns a markdown guide with next steps.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root'),
+            role: z
+                .enum(['solo-dev', 'team-lead', 'pm', 'architect'])
+                .describe('Your role: solo-dev, team-lead, pm, architect'),
+            projectType: z
+                .enum(['saas', 'mobile', 'api', 'cli', 'library'])
+                .describe('Project type: saas, mobile, api, cli, library'),
+            teamSize: z.enum(['1', '2-5', '6-20', '20+']).describe('Team size: 1, 2-5, 6-20, 20+'),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('start_onboarding', async (args) => handleStartOnboarding(args)));
+    // guided_tour
+    server.registerTool('guided_tour', {
+        description: 'Get a step-by-step guided tour of a Planu feature area. Returns markdown with numbered steps, examples, and tool hints.',
+        inputSchema: {
+            area: z
+                .enum([
+                'spec-lifecycle',
+                'team-collaboration',
+                'integrations',
+                'ai-tools',
+                'security',
+                'reporting',
+            ])
+                .describe('Tour area: spec-lifecycle, team-collaboration, integrations, ai-tools, security, reporting'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('guided_tour', async (args) => handleGuidedTour(args)));
+    // onboarding_checklist
+    server.registerTool('onboarding_checklist', {
+        description: 'Check what onboarding steps are complete for a project. Verifies planu.json, CLAUDE.md, specs, rules, and skills. Returns a checklist with progress percentage.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('onboarding_checklist', async (args) => handleOnboardingChecklist(args)));
+    // quick_start
+    server.registerTool('quick_start', {
+        description: 'Get a quick start guide for a common project archetype. Returns a markdown guide with copy-paste commands.',
+        inputSchema: {
+            template: z
+                .enum(['solo-dev', 'team-project', 'api-first', 'mobile-app', 'open-source'])
+                .describe('Template: solo-dev, team-project, api-first, mobile-app, open-source'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .optional()
+                .describe('Optional project path to personalize the guide'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('quick_start', async (args) => handleQuickStart(args)));
+    // onboarding_progress
+    server.registerTool('onboarding_progress', {
+        description: 'View onboarding progress for a project. Shows setup checklist, profile, and next recommended steps.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('onboarding_progress', async (args) => handleOnboardingProgress(args)));
+}
+//# sourceMappingURL=register-onboarding-tools.js.map

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

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

package/dist/tools/register-parallel-safety-tools.d.ts

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

package/dist/tools/register-parallel-safety-tools.d.ts.map

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

package/dist/tools/register-parallel-safety-tools.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleCheckParallelSafety } from './parallel-safety-handler.js';
+export function registerParallelSafetyTools(server) {
+    server.registerTool('check_parallel_safety', {
+        description: 'Detects worktree collision risks before launching parallel agents. ' +
+            'Call this before spawning 3+ parallel agents to get safe agent names and avoid silent worktree conflicts.',
+        annotations: { title: 'Check Parallel Safety', readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to project root'),
+            numAgents: z
+                .number()
+                .optional()
+                .describe('Number of agents to prepare safe names for (default: 6)'),
+        },
+    }, safeLicensed('check_parallel_safety', (args) => Promise.resolve(handleCheckParallelSafety(args))));
+}
+//# sourceMappingURL=register-parallel-safety-tools.js.map

package/dist/tools/register-parallel-safety-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-parallel-safety-tools.js","sourceRoot":"","sources":["../../src/tools/register-parallel-safety-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,qEAAqE;YACrE,2GAA2G;QAC7G,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,IAAI,EAAE;QACnE,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACjE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yDAAyD,CAAC;SACvE;KACF,EACD,YAAY,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7C,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,IAAgC,CAAC,CAAC,CAC7E,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-pr-agent-tools.d.ts

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

package/dist/tools/register-pr-agent-tools.d.ts.map

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

package/dist/tools/register-pr-agent-tools.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleReviewPrAgainstSpec, handlePrAgentStatus } from './pr-agent-handler.js';
+export function registerPrAgentTools(server) {
+    server.registerTool('review_pr_against_spec', {
+        description: 'Validates a pull request diff against spec acceptance criteria. ' +
+            'Uses gh CLI to fetch the PR diff and checks each criterion for presence in the diff. ' +
+            'Returns a compliance score (0-100) and per-criterion status.',
+        annotations: { title: 'Review PR Against Spec', readOnlyHint: true },
+        inputSchema: {
+            specId: z.string().describe('Spec ID to validate against (e.g. SPEC-042)'),
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root containing planu/specs/'),
+            prNumber: z.number().int().positive().describe('Pull request number to review'),
+            githubRepo: z
+                .string()
+                .describe('GitHub repository in owner/repo format (e.g. acme/my-app)'),
+        },
+    }, safeLicensed('review_pr_against_spec', (args) => handleReviewPrAgainstSpec(args)));
+    server.registerTool('pr_agent_status', {
+        description: 'Checks whether the gh CLI is installed and whether a PR agent (qodo or pr-agent) ' +
+            'is configured in .github/workflows/. Helps diagnose review_pr_against_spec prerequisites.',
+        annotations: { title: 'PR Agent 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 (optional, for future use)'),
+        },
+    }, safeLicensed('pr_agent_status', (args) => Promise.resolve(handlePrAgentStatus(args))));
+}
+//# sourceMappingURL=register-pr-agent-tools.js.map

package/dist/tools/register-pr-agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-pr-agent-tools.js","sourceRoot":"","sources":["../../src/tools/register-pr-agent-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGvF,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,kEAAkE;YAClE,uFAAuF;YACvF,8DAA8D;QAChE,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,IAAI,EAAE;QACpE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC1E,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,2DAA2D,CAAC;YACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC/E,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,2DAA2D,CAAC;SACzE;KACF,EACD,YAAY,CAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9C,yBAAyB,CAAC,IAAgC,CAAC,CAC5D,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,mFAAmF;YACnF,2FAA2F;QAC7F,WAAW,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,IAAI,EAAE;QAC7D,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,CAAC,mEAAmE,CAAC;SACjF;KACF,EACD,YAAY,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CACvC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAA0B,CAAC,CAAC,CACjE,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-schema-generator-tools.d.ts

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

package/dist/tools/register-schema-generator-tools.d.ts.map

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

package/dist/tools/register-schema-generator-tools.js

@@ -0,0 +1,46 @@
+// tools/register-schema-generator-tools.ts — Registers Validation Schema Generator tools (SPEC-365)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleGenerateValidationSchema, handleGenerateApiClient, } from './schema-generator-handler.js';
+export function registerSchemaGeneratorTools(server) {
+    server.registerTool('generate_validation_schema', {
+        description: 'Analyze a spec and generate validation schema code (Zod, Yup, or Valibot). ' +
+            'Detects entities, fields, and types from the spec text using pattern matching. ' +
+            'Unknown types are generated as z.unknown() with a TODO comment. ' +
+            'Use library="all" to generate schemas for all three libraries at once.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).max(500).describe('Spec ID to analyze (e.g. SPEC-042).'),
+            library: z
+                .enum(['zod', 'yup', 'valibot', 'all'])
+                .describe('Schema library. Values: zod, yup, valibot, all.'),
+            outputFormat: z
+                .enum(['typescript', 'javascript'])
+                .describe('Output format. Values: typescript, javascript.'),
+            outputPath: z
+                .string()
+                .optional()
+                .describe('Optional file path to write the generated schema to.'),
+        },
+        annotations: { title: 'Generate Validation Schema' },
+    }, safeTracked('generate_validation_schema', (args) => handleGenerateValidationSchema(args)));
+    server.registerTool('generate_api_client', {
+        description: 'Generate a TypeScript API client from a spec. ' +
+            'Detects API routes (GET /api/..., POST /api/..., etc.) from the spec text. ' +
+            'Use framework="fetch" for a basic fetch wrapper, ' +
+            '"tanstack-query" for React Query hooks.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).max(500).describe('Spec ID to analyze (e.g. SPEC-042).'),
+            framework: z
+                .enum(['fetch', 'tanstack-query'])
+                .describe('Client framework. Values: fetch, tanstack-query.'),
+            outputPath: z
+                .string()
+                .optional()
+                .describe('Optional file path to write the generated client to.'),
+        },
+        annotations: { title: 'Generate API Client' },
+    }, safeTracked('generate_api_client', (args) => handleGenerateApiClient(args)));
+}
+//# sourceMappingURL=register-schema-generator-tools.js.map

package/dist/tools/register-schema-generator-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-schema-generator-tools.js","sourceRoot":"","sources":["../../src/tools/register-schema-generator-tools.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAGpG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,6EAA6E;YAC7E,iFAAiF;YACjF,kEAAkE;YAClE,wEAAwE;QAC1E,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAClF,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;iBACtC,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,YAAY,EAAE,CAAC;iBACZ,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;iBAClC,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE;KACrD,EACD,WAAW,CAAC,4BAA4B,EAAE,CAAC,IAAI,EAAE,EAAE,CACjD,8BAA8B,CAAC,IAAqC,CAAC,CACtE,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,gDAAgD;YAChD,6EAA6E;YAC7E,mDAAmD;YACnD,yCAAyC;QAC3C,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAClF,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;iBACjC,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE;KAC9C,EACD,WAAW,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC1C,uBAAuB,CAAC,IAA8B,CAAC,CACxD,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleCookbookList, handleCookbookGet, handleCookbookApply, handleCookbookContribute, handleCookbookSearch, } from './spec-cookbook-handler.js';
+export function registerSpecCookbookTools(server) {
+    // cookbook_list
+    server.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)));
+    // cookbook_get
+    server.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)));
+    // cookbook_apply
+    server.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)));
+    // cookbook_contribute
+    server.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)));
+    // cookbook_search
+    server.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)));
+}
+//# sourceMappingURL=register-spec-cookbook-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-cookbook-tools.js","sourceRoot":"","sources":["../../src/tools/register-spec-cookbook-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,gBAAgB;IAChB,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,0IAA0I;QAC5I,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;iBAC9E,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACzF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;YAC1E,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,qCAAqC,CAAC;SACnD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,YAAY,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAClE,CAAC;IAEF,eAAe;IACf,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,yGAAyG;QAC3G,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SACxF;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAChE,CAAC;IAEF,iBAAiB;IACjB,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,2JAA2J;QAC7J,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACrE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;SAC7D;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,YAAY,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CACpE,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;iBAC9E,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,4CAA4C,CAAC;YACzD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACtE,kBAAkB,EAAE,CAAC;iBAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;iBACjC,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,CAAC,6BAA6B,CAAC;YAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC3F;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE;KACrC,EACD,YAAY,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAC9E,CAAC;IAEF,kBAAkB;IAClB,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,8FAA8F;QAChG,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC1D,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,2BAA2B,CAAC;SACzC;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,YAAY,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleVisualSpecDiff, handleThreeWayMerge, handleSmartMergeConflictResolver, handleMergePreview, handleApplyMerge, } from './spec-visual-diff-handler.js';
+export function registerSpecDiffVisualTools(server) {
+    // visual_spec_diff
+    server.registerTool('visual_spec_diff', {
+        description: 'Compute a visual line-by-line diff between two spec texts using LCS algorithm. Returns HTML output (default) or text format with +/- markers.',
+        inputSchema: {
+            textA: z.string().max(500000).describe('First spec text (base/original)'),
+            textB: z.string().max(500000).describe('Second spec text (new/modified)'),
+            labelA: z.string().max(100).optional().describe('Label for textA (default: A)'),
+            labelB: z.string().max(100).optional().describe('Label for textB (default: B)'),
+            outputFormat: z
+                .enum(['html', 'text'])
+                .optional()
+                .describe('Output format: html (default) or text'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('visual_spec_diff', (args) => handleVisualSpecDiff(args)));
+    // three_way_merge
+    server.registerTool('three_way_merge', {
+        description: 'Perform a 3-way merge of two spec texts against a common base. Returns merged text with conflict markers (<<<<<<< A, =======, >>>>>>> B) where conflicts exist.',
+        inputSchema: {
+            base: z.string().max(500000).describe('Common base text'),
+            textA: z.string().max(500000).describe('First branch text'),
+            textB: z.string().max(500000).describe('Second branch text'),
+            labelA: z.string().max(100).optional().describe('Label for textA (default: A)'),
+            labelB: z.string().max(100).optional().describe('Label for textB (default: B)'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('three_way_merge', (args) => handleThreeWayMerge(args)));
+    // smart_merge_conflict_resolver
+    server.registerTool('smart_merge_conflict_resolver', {
+        description: 'Automatically resolve simple merge conflicts: identical content on both sides, or whitespace-only differences. Remaining conflicts kept as-is for manual resolution.',
+        inputSchema: {
+            mergedText: z
+                .string()
+                .max(500000)
+                .describe('Text containing conflict markers from three_way_merge'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('smart_merge_conflict_resolver', (args) => handleSmartMergeConflictResolver(args)));
+    // merge_preview
+    server.registerTool('merge_preview', {
+        description: 'Preview the result of merging two spec texts against a base. Shows whether auto-merge is possible and the merged content.',
+        inputSchema: {
+            base: z.string().max(500000).describe('Common base text'),
+            textA: z.string().max(500000).describe('First branch text'),
+            textB: z.string().max(500000).describe('Second branch text'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('merge_preview', (args) => handleMergePreview(args)));
+    // apply_merge
+    server.registerTool('apply_merge', {
+        description: 'Apply merged spec content to a spec file on disk. Fails if unresolved conflict markers are present.',
+        inputSchema: {
+            mergedText: z
+                .string()
+                .max(500000)
+                .describe('Fully resolved merged text (no conflict markers)'),
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root'),
+            specId: z.string().min(1).max(100).describe('Spec ID to update (e.g. SPEC-001)'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    }, safeLicensed('apply_merge', async (args) => handleApplyMerge(args)));
+}
+//# sourceMappingURL=register-spec-diff-tools.js.map

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

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

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

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

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

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