@claudetools/tools 0.8.11 → 0.9.0

package/dist/handlers/kappa-handlers.js

@@ -0,0 +1,465 @@
+// =============================================================================
+// Kappa v2.5 MCP Tool Handlers
+// =============================================================================
+//
+// Handlers for Kappa DSL code generation tools. Kappa is a declarative
+// specification language for full-stack applications that generates
+// production-ready code from compact specifications.
+//
+import { parseKappaToAST, validateKappaSpec, formatValidationResults, generateDrizzleSchema, generateZodSchemas, generateTypeScriptTypes, generateAPI, generatePages, generateForms, generateComponents, generateDesign, } from '../codedna/index.js';
+// Map user-friendly dialect names to internal ones
+function normalizeDialect(dialect) {
+    switch (dialect) {
+        case 'postgres':
+        case 'postgresql':
+            return 'postgresql';
+        case 'mysql':
+            return 'mysql';
+        case 'sqlite':
+        default:
+            return 'sqlite';
+    }
+}
+// =============================================================================
+// Parse & Validate Handler
+// =============================================================================
+/**
+ * Handle kappa_parse tool call
+ * Parses and validates a Kappa specification
+ */
+export async function handleKappaParse(args) {
+    const { spec } = args;
+    if (!spec || typeof spec !== 'string') {
+        return { success: false, errors: ['spec is required and must be a string'] };
+    }
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return {
+                success: false,
+                errors: ['Failed to parse Kappa specification'],
+            };
+        }
+        // Validate the AST
+        const validation = validateKappaSpec(ast);
+        if (validation.errors.length > 0) {
+            return {
+                success: false,
+                errors: formatValidationResults(validation).split('\n').filter(Boolean),
+            };
+        }
+        return {
+            success: true,
+            ast,
+            summary: {
+                project: ast.project?.name,
+                entities: ast.entities.length,
+                apis: ast.apis.length,
+                pages: ast.pages?.length ?? 0,
+                forms: ast.forms?.length ?? 0,
+                components: ast.components?.length ?? 0,
+                hasDesign: !!ast.design,
+                hasAuth: !!ast.auth,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Schema Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_schema tool call
+ * Generates Drizzle schema, Zod validators, and TypeScript types
+ */
+export async function handleKappaGenerateSchema(args) {
+    const { spec, outputs = ['drizzle', 'zod', 'types'], options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        const validation = validateKappaSpec(ast);
+        if (validation.errors.length > 0) {
+            return { success: false, errors: validation.errors.map((e) => e.message) };
+        }
+        const files = [];
+        let totalLines = 0;
+        // Generate Drizzle schema
+        if (outputs.includes('drizzle')) {
+            const drizzle = generateDrizzleSchema(ast.entities, {
+                provenance: options.provenance ?? true,
+                dialect: normalizeDialect(options.dbDialect),
+            });
+            files.push({ path: 'db/schema.ts', content: drizzle.schema });
+            totalLines += drizzle.schema.split('\n').length;
+            if (drizzle.relations) {
+                files.push({ path: 'db/relations.ts', content: drizzle.relations });
+                totalLines += drizzle.relations.split('\n').length;
+            }
+            files.push({ path: 'db/types.ts', content: drizzle.types });
+            totalLines += drizzle.types.split('\n').length;
+        }
+        // Generate Zod schemas
+        if (outputs.includes('zod')) {
+            const zod = generateZodSchemas(ast.entities, {
+                provenance: options.provenance ?? true,
+            });
+            files.push({ path: 'lib/schemas.ts', content: zod.schemas });
+            totalLines += zod.schemas.split('\n').length;
+        }
+        // Generate TypeScript types
+        if (outputs.includes('types')) {
+            const types = generateTypeScriptTypes(ast.entities, {
+                provenance: options.provenance ?? true,
+            });
+            files.push({ path: 'lib/types.ts', content: types.types });
+            totalLines += types.types.split('\n').length;
+        }
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// API Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_api tool call
+ * Generates API routes from Kappa API blocks
+ */
+export async function handleKappaGenerateApi(args) {
+    const { spec, framework = 'hono', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (ast.apis.length === 0) {
+            return { success: false, errors: ['No API blocks found in specification'] };
+        }
+        const files = [];
+        let totalLines = 0;
+        // Generate API routes (pass all APIs at once)
+        const result = generateAPI(ast.apis, {
+            framework,
+            provenance: options.provenance ?? true,
+        });
+        files.push({ path: 'api/routes.ts', content: result.routes });
+        totalLines += result.routes.split('\n').length;
+        if (result.validation) {
+            files.push({ path: 'api/validation.ts', content: result.validation });
+            totalLines += result.validation.split('\n').length;
+        }
+        if (result.errors) {
+            files.push({ path: 'api/errors.ts', content: result.errors });
+            totalLines += result.errors.split('\n').length;
+        }
+        if (result.openapi) {
+            files.push({ path: 'api/openapi.json', content: result.openapi });
+            totalLines += result.openapi.split('\n').length;
+        }
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Page Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_pages tool call
+ * Generates page/route components for TanStack Start or Next.js
+ */
+export async function handleKappaGeneratePages(args) {
+    const { spec, framework = 'tanstack-start', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.pages || ast.pages.length === 0) {
+            return { success: false, errors: ['No page blocks found in specification'] };
+        }
+        const result = generatePages(ast.pages, {
+            framework,
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+        });
+        const files = result.pages.map((p) => ({ path: p.path, content: p.content }));
+        const totalLines = files.reduce((sum, f) => sum + f.content.split('\n').length, 0);
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Form Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_forms tool call
+ * Generates React forms with React Hook Form and Zod validation
+ */
+export async function handleKappaGenerateForms(args) {
+    const { spec, ui = 'shadcn', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.forms || ast.forms.length === 0) {
+            return { success: false, errors: ['No form blocks found in specification'] };
+        }
+        const result = generateForms(ast.forms, {
+            ui,
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+            zod: options.zod ?? true,
+        });
+        const files = result.forms.map((f) => ({ path: f.path, content: f.content }));
+        const totalLines = files.reduce((sum, f) => sum + f.content.split('\n').length, 0);
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Component Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_components tool call
+ * Generates React components including compound components
+ */
+export async function handleKappaGenerateComponents(args) {
+    const { spec, options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.components || ast.components.length === 0) {
+            return { success: false, errors: ['No component blocks found in specification'] };
+        }
+        const result = generateComponents(ast.components, {
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+            forwardRef: options.forwardRef ?? false,
+            basePath: options.basePath ?? 'components',
+        });
+        const files = result.components.map((c) => ({ path: c.path, content: c.content }));
+        const totalLines = files.reduce((sum, f) => sum + f.content.split('\n').length, 0);
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Design Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_design tool call
+ * Generates CSS variables and Tailwind config from design tokens
+ */
+export async function handleKappaGenerateDesign(args) {
+    const { spec, format = 'both', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.design) {
+            return { success: false, errors: ['No design block found in specification'] };
+        }
+        const result = generateDesign(ast.design, {
+            format,
+            provenance: options.provenance ?? true,
+            prefix: options.prefix ?? '',
+            hsl: options.hsl ?? false,
+        });
+        const files = [];
+        if (result.css) {
+            files.push({ path: result.css.path, content: result.css.content });
+        }
+        if (result.tailwind) {
+            files.push({ path: result.tailwind.path, content: result.tailwind.content });
+        }
+        const totalLines = files.reduce((sum, f) => sum + f.content.split('\n').length, 0);
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 200,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+// =============================================================================
+// Full Stack Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_all tool call
+ * Generates complete full-stack application from Kappa specification
+ */
+export async function handleKappaGenerateAll(args) {
+    const { spec, options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        const validation = validateKappaSpec(ast);
+        if (validation.errors.length > 0) {
+            return { success: false, errors: validation.errors.map((e) => e.message) };
+        }
+        const files = [];
+        const { framework = 'tanstack-start', apiFramework = 'hono', ui = 'shadcn', dbDialect = 'sqlite', provenance = true, typescript = true, } = options;
+        // 1. Generate database schema
+        if (ast.entities.length > 0) {
+            const drizzle = generateDrizzleSchema(ast.entities, {
+                provenance,
+                dialect: normalizeDialect(dbDialect),
+            });
+            files.push({ path: 'db/schema.ts', content: drizzle.schema });
+            if (drizzle.relations) {
+                files.push({ path: 'db/relations.ts', content: drizzle.relations });
+            }
+            files.push({ path: 'db/types.ts', content: drizzle.types });
+            const zod = generateZodSchemas(ast.entities, { provenance });
+            files.push({ path: 'lib/schemas.ts', content: zod.schemas });
+            const types = generateTypeScriptTypes(ast.entities, { provenance });
+            files.push({ path: 'lib/types.ts', content: types.types });
+        }
+        // 2. Generate API routes
+        if (ast.apis.length > 0) {
+            const result = generateAPI(ast.apis, {
+                framework: apiFramework,
+                provenance,
+            });
+            files.push({ path: 'api/routes.ts', content: result.routes });
+            if (result.validation) {
+                files.push({ path: 'api/validation.ts', content: result.validation });
+            }
+            if (result.errors) {
+                files.push({ path: 'api/errors.ts', content: result.errors });
+            }
+        }
+        // 3. Generate pages
+        if (ast.pages && ast.pages.length > 0) {
+            const result = generatePages(ast.pages, { framework, provenance, typescript });
+            for (const page of result.pages) {
+                files.push({ path: page.path, content: page.content });
+            }
+        }
+        // 4. Generate forms
+        if (ast.forms && ast.forms.length > 0) {
+            const result = generateForms(ast.forms, { ui, provenance, typescript, zod: true });
+            for (const form of result.forms) {
+                files.push({ path: form.path, content: form.content });
+            }
+        }
+        // 5. Generate components
+        if (ast.components && ast.components.length > 0) {
+            const result = generateComponents(ast.components, { provenance, typescript });
+            for (const component of result.components) {
+                files.push({ path: component.path, content: component.content });
+            }
+        }
+        // 6. Generate design tokens
+        if (ast.design) {
+            const result = generateDesign(ast.design, { format: 'both', provenance });
+            if (result.css)
+                files.push({ path: result.css.path, content: result.css.content });
+            if (result.tailwind)
+                files.push({ path: result.tailwind.path, content: result.tailwind.content });
+        }
+        const totalLines = files.reduce((sum, f) => sum + f.content.split('\n').length, 0);
+        return {
+            success: true,
+            files,
+            metadata: {
+                filesGenerated: files.length,
+                linesOfCode: totalLines,
+                estimatedTokensSaved: totalLines * 25 - 300,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}

package/dist/handlers/tool-handlers.js

@@ -16,6 +16,7 @@ import { createTask, listTasks, getTask, claimTask, releaseTask, updateTaskStatu
 import { detectTimedOutTasks, retryTask, failTask, autoRetryTimedOutTasks, } from '../helpers/tasks-retry.js';
 import { detectLibrariesFromPlan } from '../helpers/library-detection.js';
 import { handleGenerateApi, handleGenerateFrontend, handleGenerateComponent, handleListGenerators, handleValidateSpec, handleListPatterns, handleGetPattern, handleDetectPatterns, handleInitProject, } from './codedna-handlers.js';
+import { handleKappaParse, handleKappaGenerateSchema, handleKappaGenerateApi, handleKappaGeneratePages, handleKappaGenerateForms, handleKappaGenerateComponents, handleKappaGenerateDesign, handleKappaGenerateAll, } from './kappa-handlers.js';
 export function registerToolHandlers(server) {
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
@@ -912,6 +913,15 @@ export function registerToolHandlers(server) {
                     const taskId = args?.task_id;
                     const summary = args?.summary;
                     const agentId = args?.agent_id || 'claude-code';
+                    // Try to claim first in case task wasn't started via task_start
+                    // This makes task_complete work standalone without requiring task_start
+                    try {
+                        await claimTask(DEFAULT_USER_ID, projectId, taskId, agentId, 5); // Short claim just for completion
+                    }
+                    catch {
+                        // Ignore claim errors - task might already be claimed by this agent or another
+                        // releaseTask will handle the actual authorization check
+                    }
                     // Add completion context
                     await addTaskContext(DEFAULT_USER_ID, projectId, taskId, 'work_log', summary, agentId);
                     // Release and mark as done
@@ -1980,6 +1990,117 @@ export function registerToolHandlers(server) {
                             }],
                     };
                 }
+                // =====================================================================
+                // Kappa v2.5 DSL Tools
+                // =====================================================================
+                case 'kappa_parse': {
+                    const result = await handleKappaParse(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            }],
+                    };
+                }
+                case 'kappa_generate_schema': {
+                    const result = await handleKappaGenerateSchema(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_api': {
+                    const result = await handleKappaGenerateApi(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_pages': {
+                    const result = await handleKappaGeneratePages(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_forms': {
+                    const result = await handleKappaGenerateForms(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_components': {
+                    const result = await handleKappaGenerateComponents(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_design': {
+                    const result = await handleKappaGenerateDesign(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
+                case 'kappa_generate_all': {
+                    const result = await handleKappaGenerateAll(args);
+                    mcpLogger.toolResult(name, true, timer());
+                    let output = JSON.stringify(result, null, 2);
+                    if (workflowWarnings) {
+                        output += '\n\n' + workflowWarnings;
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: output,
+                            }],
+                    };
+                }
                 default:
                     throw new Error(`Unknown tool: ${name}`);
             }

package/dist/templates/claude-md.d.ts

@@ -5,7 +5,7 @@ export declare const PROJECT_SECTION_END = "<!-- CLAUDETOOLS:PROJECT:END -->";
 /**
  * Global CLAUDE.md content - added to ~/.claude/CLAUDE.md
  */
-export declare const GLOBAL_TEMPLATE = "\n<!-- CLAUDETOOLS:START -->\n# ClaudeTools Memory System\n\nYou have access to a persistent memory system. **Context is AUTO-INJECTED via hooks** - you rarely need to call memory tools explicitly.\n\n## \u26A0\uFE0F IMPORTANT: Hooks vs MCP Tools\n\n**AUTOMATIC (via hooks - zero context cost):**\n- Context injection \u2192 `user-prompt-submit` hook runs on every message\n- Fact extraction \u2192 `post-tool-use` hook extracts from your work\n- Session context \u2192 `session-start` hook provides initial context\n\n**EXPLICIT (MCP tools - costs context):**\n- `memory_store_fact` \u2192 Store a specific fact you learned\n- `task_plan` / `task_start` / `task_complete` \u2192 Task management\n\n**DO NOT CALL these tools routinely (context already injected):**\n- `memory_search` - only if you need DIFFERENT search params\n- `memory_inject` - only if you need to refresh for a different query\n- `memory_get_context` - only for debugging\n- `memory_index` - only for debugging\n\n## Storing Facts (DO use this)\n```\nmemory_store_fact(\n  entity1: \"UserService\",\n  relationship: \"USES\",\n  entity2: \"bcrypt\",\n  context: \"Password hashing uses bcrypt with 12 rounds\"\n)\n```\nStore important facts when you learn something concrete. The `post-tool-use` hook also extracts facts automatically.\n\n## Task Management\n\n### Creating Work Plans with Auto-Dispatch\n```\ntask_plan(\n  goal: \"Add user authentication\",\n  epic_title: \"User Auth System\",\n  tasks: [...]\n)\n```\nBreak down complex work into tracked tasks. **Tasks are automatically set to `ready` status.**\n\nAfter `task_plan` completes, you will receive Task tool invocations to spawn parallel agents.\n**Execute ALL Task tool calls in a SINGLE message** to enable parallel execution.\n\n### Parallel Agent Workflow\n1. User describes work needed\n2. Call `task_plan_draft` to present the plan\n3. User says \"go\" to approve\n4. Call `task_plan` - tasks created in `ready` status\n5. Execute the provided Task tool calls in ONE message\n6. Agents work in parallel, each calling `task_complete` when done\n\n### Manual Task Start (Sequential)\n```\ntask_start(task_id: \"task_xxx\")\n```\nClaim a task before working on it. Use for sequential execution.\n\n### Completing Tasks\n```\ntask_complete(task_id: \"task_xxx\", summary: \"Implemented JWT auth with refresh tokens\")\n```\nMark tasks done with a summary of work completed. **Always call this when a task is finished.**\n\n## Codebase Intelligence\n\n### Start with codebase_map() - ALWAYS\n```\ncodebase_map()  # FIRST TOOL when exploring unfamiliar code\n```\n**When to use:** Starting a new task, exploring unfamiliar code, understanding project structure, finding entry points.\n\nThe map shows:\n- Project structure and key directories\n- Entry points and their exports\n- Framework detection (React, Express, etc.)\n- Key symbols and their locations\n\n**Use codebase_map BEFORE using Grep/Glob** - it gives you the lay of the land so you know where to look.\n\n### Then use targeted tools\n```\ncodebase_find(\"UserService\")  # Find specific symbols/files\ncodebase_context(\"src/auth.ts\")  # Get file dependencies\nanalyze_impact(\"validateToken\")  # See what changing a function affects\n```\n\n## CodeDNA: Generate Code, Save 99% Tokens\n\n**When creating APIs/CRUD operations:** Call `codedna_generate_api` instead of writing code manually.\n\n```\ncodedna_generate_api({\n  spec: \"User(email:string:unique, password:string:hashed, age:integer:min(18))\",\n  framework: \"express\",\n  options: { auth: true, validation: true, tests: true }\n})\n```\n\n**Generates 6 production files** (models, controllers, routes, validators, auth, tests) in ~5 seconds.\n**Saves:** 30,000 tokens \u2192 200 tokens (99% reduction)\n\n## Best Practices\n\n1. **Trust auto-injection** - Context is injected automatically, don't call memory_search\n2. **Store decisions** - Use `memory_store_fact` for architectural choices\n3. **Use task tracking** - Break complex work into tasks\n4. **Use CodeDNA for APIs** - Generate instead of write (99% token savings)\n5. **Minimize tool calls** - Every MCP call costs context tokens\n<!-- CLAUDETOOLS:END -->\n";
+export declare const GLOBAL_TEMPLATE = "\n<!-- CLAUDETOOLS:START -->\n# ClaudeTools Memory System\n\nYou have access to a persistent memory system. **Context is AUTO-INJECTED via hooks** - you rarely need to call memory tools explicitly.\n\n## \u26A0\uFE0F IMPORTANT: Hooks vs MCP Tools\n\n**AUTOMATIC (via hooks - zero context cost):**\n- Context injection \u2192 `user-prompt-submit` hook runs on every message\n- Fact extraction \u2192 `post-tool-use` hook extracts from your work\n- Session context \u2192 `session-start` hook provides initial context\n\n**EXPLICIT (MCP tools - costs context):**\n- `memory_store_fact` \u2192 Store a specific fact you learned\n- `task_plan` / `task_start` / `task_complete` \u2192 Task management\n\n**DO NOT CALL these tools routinely (context already injected):**\n- `memory_search` - only if you need DIFFERENT search params\n- `memory_inject` - only if you need to refresh for a different query\n- `memory_get_context` - only for debugging\n- `memory_index` - only for debugging\n\n## Storing Facts (DO use this)\n```\nmemory_store_fact(\n  entity1: \"UserService\",\n  relationship: \"USES\",\n  entity2: \"bcrypt\",\n  context: \"Password hashing uses bcrypt with 12 rounds\"\n)\n```\nStore important facts when you learn something concrete. The `post-tool-use` hook also extracts facts automatically.\n\n## Task Management\n\n### Creating Work Plans with Auto-Dispatch\n```\ntask_plan(\n  goal: \"Add user authentication\",\n  epic_title: \"User Auth System\",\n  tasks: [...]\n)\n```\nBreak down complex work into tracked tasks. **Tasks are automatically set to `ready` status.**\n\nAfter `task_plan` completes, you will receive Task tool invocations to spawn parallel agents.\n**Execute ALL Task tool calls in a SINGLE message** to enable parallel execution.\n\n### Parallel Agent Workflow\n1. User describes work needed\n2. Call `task_plan_draft` to present the plan\n3. User says \"go\" to approve\n4. Call `task_plan` - tasks created in `ready` status\n5. Execute the provided Task tool calls in ONE message\n6. Agents work in parallel, each calling `task_complete` when done\n\n### Manual Task Start (Sequential)\n```\ntask_start(task_id: \"task_xxx\")\n```\nClaim a task before working on it. Use for sequential execution.\n\n### Completing Tasks\n```\ntask_complete(task_id: \"task_xxx\", summary: \"Implemented JWT auth with refresh tokens\")\n```\nMark tasks done with a summary of work completed. **Always call this when a task is finished.**\n\n## Codebase Intelligence\n\n### Start with codebase_map() - ALWAYS\n```\ncodebase_map()  # FIRST TOOL when exploring unfamiliar code\n```\n**When to use:** Starting a new task, exploring unfamiliar code, understanding project structure, finding entry points.\n\nThe map shows:\n- Project structure and key directories\n- Entry points and their exports\n- Framework detection (React, Express, etc.)\n- Key symbols and their locations\n\n**Use codebase_map BEFORE using Grep/Glob** - it gives you the lay of the land so you know where to look.\n\n### Then use targeted tools\n```\ncodebase_find(\"UserService\")  # Find specific symbols/files\ncodebase_context(\"src/auth.ts\")  # Get file dependencies\nanalyze_impact(\"validateToken\")  # See what changing a function affects\n```\n\n## CodeDNA: Generate Code, Save 99% Tokens\n\n**BEFORE writing ANY code, check if CodeDNA can generate it.** Call `codedna_list_generators()` to see available generators.\n\n### Available Generators (20+)\n\n| Category | Frameworks | Tool |\n|----------|------------|------|\n| **API** | Express, FastAPI, NestJS, Hono, Elysia, tRPC | `codedna_generate_api` |\n| **Frontend** | React, Vue, SvelteKit, Astro, React Router v7, TanStack Start | `codedna_generate_frontend` |\n| **ORM** | Prisma, Drizzle | `codedna_generate_api` with database option |\n| **Auth** | Better Auth, Auth.js, Lucia | `codedna_generate_api` with auth option |\n| **Components** | Forms, Tables, Cards, Modals (React/Vue/Svelte) | `codedna_generate_component` |\n\n### Usage Examples\n\n```typescript\n// API with auth and validation\ncodedna_generate_api({\n  spec: \"User(email:string:unique, password:string:hashed)\",\n  framework: \"express\",  // or: fastapi, nestjs, hono, elysia, trpc\n  options: { auth: true, validation: true, tests: true }\n})\n\n// Frontend with forms and data fetching\ncodedna_generate_frontend({\n  spec: \"User(email:string, name:string, role:enum(admin,user))\",\n  framework: \"react\",  // or: vue, nextjs, sveltekit, astro\n  options: { forms: true, tables: true, ui: \"shadcn\" }\n})\n\n// Single component\ncodedna_generate_component({\n  spec: \"Product(name:string, price:decimal, inStock:boolean)\",\n  type: \"form\",  // or: table, card, modal\n  framework: \"react\",\n  options: { validation: true, ui: \"shadcn\" }\n})\n```\n\n### Entity DSL Quick Reference\n\n```\nEntityName(field:type:modifier, field2:type:modifier)\n\nTypes: string, integer, decimal, boolean, datetime, text, json\nModifiers: unique, required, optional, hashed, email, min(n), max(n), default(v)\nRelations: userId:User (reference), posts:Post[] (array)\nEnums: role:enum(admin,user,guest)\n```\n\n**Token savings:** 30,000 tokens \u2192 200 tokens (99% reduction per generation)\n\n## Kappa v2.5: Declarative Full-Stack Generation\n\n**For even higher-level generation**, use Kappa DSL - a declarative specification language that generates complete applications from compact specs.\n\n### When to Use Kappa vs CodeDNA\n\n| Use Case | Tool |\n|----------|------|\n| Single entity/component | CodeDNA (`codedna_generate_*`) |\n| Full application with multiple entities | Kappa (`kappa_generate_all`) |\n| Pages, forms, routing together | Kappa |\n| Design system + components | Kappa |\n\n### Kappa Tools\n\n| Tool | Purpose |\n|------|---------|\n| `kappa_parse` | Parse and validate Kappa spec |\n| `kappa_generate_schema` | Generate Drizzle schema + Zod + types |\n| `kappa_generate_api` | Generate API routes (Hono/Express/tRPC) |\n| `kappa_generate_pages` | Generate pages (TanStack Start/Next.js) |\n| `kappa_generate_forms` | Generate forms (React Hook Form + Zod + shadcn) |\n| `kappa_generate_components` | Generate React components (compound, forwardRef) |\n| `kappa_generate_design` | Generate CSS variables + Tailwind config |\n| `kappa_generate_all` | Generate complete full-stack application |\n\n### Kappa DSL Example\n\n```\n// Complete app specification in ~50 lines\nproject TaskManager {\n  database postgres\n  framework tanstack-start\n}\n\nentity Task {\n  title string required max(100)\n  description text\n  status enum(todo, in_progress, done) default(todo)\n  dueDate datetime\n  assignee User\n}\n\nentity User {\n  email string unique email\n  name string required\n  tasks Task[]\n}\n\napi /tasks {\n  GET / -> list Task[]\n  POST / -> create Task\n  GET /:id -> get Task\n  PUT /:id -> update Task\n  DELETE /:id -> delete Task\n}\n\npage /tasks {\n  layout dashboard\n  load tasks from /api/tasks\n  components [TaskList, TaskForm]\n}\n\nform TaskForm for Task {\n  fields [title, description, status, dueDate]\n  submit POST /api/tasks\n}\n\ndesign {\n  colors {\n    primary #3B82F6\n    secondary #6B7280\n  }\n  typography {\n    fontFamily \"Inter\"\n    scale { sm: \"0.875rem\", base: \"1rem\", lg: \"1.125rem\" }\n  }\n}\n```\n\n### Usage\n\n```typescript\n// Generate everything from spec\nkappa_generate_all({\n  spec: `project MyApp { ... }`,\n  options: {\n    framework: \"tanstack-start\",\n    ui: \"shadcn\",\n    dbDialect: \"postgres\"\n  }\n})\n\n// Or generate incrementally\nkappa_parse({ spec: \"...\" })  // Validate first\nkappa_generate_schema({ spec: \"...\", outputs: [\"drizzle\", \"zod\", \"types\"] })\nkappa_generate_api({ spec: \"...\", framework: \"hono\" })\nkappa_generate_pages({ spec: \"...\", framework: \"tanstack-start\" })\n```\n\n**Token savings:** ~50 lines of Kappa \u2192 thousands of lines of production code (95%+ reduction)\n\n## Best Practices\n\n1. **Trust auto-injection** - Context is injected automatically, don't call memory_search\n2. **Store decisions** - Use `memory_store_fact` for architectural choices\n3. **Use task tracking** - Break complex work into tasks\n4. **Use Kappa for full apps** - For multi-entity apps with pages/forms, use `kappa_generate_all`\n5. **Use CodeDNA for single components** - For individual entities or components, use `codedna_generate_*`\n6. **Minimize tool calls** - Every MCP call costs context tokens\n<!-- CLAUDETOOLS:END -->\n";
 /**
  * Project-level CLAUDE.md content - added to .claude/CLAUDE.md
  */