@claudetools/tools 0.8.10 → 0.9.0

package/dist/templates/claude-md.js

@@ -104,26 +104,167 @@ analyze_impact("validateToken")  # See what changing a function affects
 
 ## CodeDNA: Generate Code, Save 99% Tokens
 
-**When creating APIs/CRUD operations:** Call \`codedna_generate_api\` instead of writing code manually.
+**BEFORE writing ANY code, check if CodeDNA can generate it.** Call \`codedna_list_generators()\` to see available generators.
 
-\`\`\`
+### Available Generators (20+)
+
+| Category | Frameworks | Tool |
+|----------|------------|------|
+| **API** | Express, FastAPI, NestJS, Hono, Elysia, tRPC | \`codedna_generate_api\` |
+| **Frontend** | React, Vue, SvelteKit, Astro, React Router v7, TanStack Start | \`codedna_generate_frontend\` |
+| **ORM** | Prisma, Drizzle | \`codedna_generate_api\` with database option |
+| **Auth** | Better Auth, Auth.js, Lucia | \`codedna_generate_api\` with auth option |
+| **Components** | Forms, Tables, Cards, Modals (React/Vue/Svelte) | \`codedna_generate_component\` |
+
+### Usage Examples
+
+\`\`\`typescript
+// API with auth and validation
 codedna_generate_api({
-  spec: "User(email:string:unique, password:string:hashed, age:integer:min(18))",
-  framework: "express",
+  spec: "User(email:string:unique, password:string:hashed)",
+  framework: "express",  // or: fastapi, nestjs, hono, elysia, trpc
   options: { auth: true, validation: true, tests: true }
 })
+
+// Frontend with forms and data fetching
+codedna_generate_frontend({
+  spec: "User(email:string, name:string, role:enum(admin,user))",
+  framework: "react",  // or: vue, nextjs, sveltekit, astro
+  options: { forms: true, tables: true, ui: "shadcn" }
+})
+
+// Single component
+codedna_generate_component({
+  spec: "Product(name:string, price:decimal, inStock:boolean)",
+  type: "form",  // or: table, card, modal
+  framework: "react",
+  options: { validation: true, ui: "shadcn" }
+})
+\`\`\`
+
+### Entity DSL Quick Reference
+
+\`\`\`
+EntityName(field:type:modifier, field2:type:modifier)
+
+Types: string, integer, decimal, boolean, datetime, text, json
+Modifiers: unique, required, optional, hashed, email, min(n), max(n), default(v)
+Relations: userId:User (reference), posts:Post[] (array)
+Enums: role:enum(admin,user,guest)
+\`\`\`
+
+**Token savings:** 30,000 tokens → 200 tokens (99% reduction per generation)
+
+## Kappa v2.5: Declarative Full-Stack Generation
+
+**For even higher-level generation**, use Kappa DSL - a declarative specification language that generates complete applications from compact specs.
+
+### When to Use Kappa vs CodeDNA
+
+| Use Case | Tool |
+|----------|------|
+| Single entity/component | CodeDNA (\`codedna_generate_*\`) |
+| Full application with multiple entities | Kappa (\`kappa_generate_all\`) |
+| Pages, forms, routing together | Kappa |
+| Design system + components | Kappa |
+
+### Kappa Tools
+
+| Tool | Purpose |
+|------|---------|
+| \`kappa_parse\` | Parse and validate Kappa spec |
+| \`kappa_generate_schema\` | Generate Drizzle schema + Zod + types |
+| \`kappa_generate_api\` | Generate API routes (Hono/Express/tRPC) |
+| \`kappa_generate_pages\` | Generate pages (TanStack Start/Next.js) |
+| \`kappa_generate_forms\` | Generate forms (React Hook Form + Zod + shadcn) |
+| \`kappa_generate_components\` | Generate React components (compound, forwardRef) |
+| \`kappa_generate_design\` | Generate CSS variables + Tailwind config |
+| \`kappa_generate_all\` | Generate complete full-stack application |
+
+### Kappa DSL Example
+
+\`\`\`
+// Complete app specification in ~50 lines
+project TaskManager {
+  database postgres
+  framework tanstack-start
+}
+
+entity Task {
+  title string required max(100)
+  description text
+  status enum(todo, in_progress, done) default(todo)
+  dueDate datetime
+  assignee User
+}
+
+entity User {
+  email string unique email
+  name string required
+  tasks Task[]
+}
+
+api /tasks {
+  GET / -> list Task[]
+  POST / -> create Task
+  GET /:id -> get Task
+  PUT /:id -> update Task
+  DELETE /:id -> delete Task
+}
+
+page /tasks {
+  layout dashboard
+  load tasks from /api/tasks
+  components [TaskList, TaskForm]
+}
+
+form TaskForm for Task {
+  fields [title, description, status, dueDate]
+  submit POST /api/tasks
+}
+
+design {
+  colors {
+    primary #3B82F6
+    secondary #6B7280
+  }
+  typography {
+    fontFamily "Inter"
+    scale { sm: "0.875rem", base: "1rem", lg: "1.125rem" }
+  }
+}
+\`\`\`
+
+### Usage
+
+\`\`\`typescript
+// Generate everything from spec
+kappa_generate_all({
+  spec: \`project MyApp { ... }\`,
+  options: {
+    framework: "tanstack-start",
+    ui: "shadcn",
+    dbDialect: "postgres"
+  }
+})
+
+// Or generate incrementally
+kappa_parse({ spec: "..." })  // Validate first
+kappa_generate_schema({ spec: "...", outputs: ["drizzle", "zod", "types"] })
+kappa_generate_api({ spec: "...", framework: "hono" })
+kappa_generate_pages({ spec: "...", framework: "tanstack-start" })
 \`\`\`
 
-**Generates 6 production files** (models, controllers, routes, validators, auth, tests) in ~5 seconds.
-**Saves:** 30,000 tokens → 200 tokens (99% reduction)
+**Token savings:** ~50 lines of Kappa → thousands of lines of production code (95%+ reduction)
 
 ## Best Practices
 
 1. **Trust auto-injection** - Context is injected automatically, don't call memory_search
 2. **Store decisions** - Use \`memory_store_fact\` for architectural choices
 3. **Use task tracking** - Break complex work into tasks
-4. **Use CodeDNA for APIs** - Generate instead of write (99% token savings)
-5. **Minimize tool calls** - Every MCP call costs context tokens
+4. **Use Kappa for full apps** - For multi-entity apps with pages/forms, use \`kappa_generate_all\`
+5. **Use CodeDNA for single components** - For individual entities or components, use \`codedna_generate_*\`
+6. **Minimize tool calls** - Every MCP call costs context tokens
 ${SECTION_END}
 `;
 /**
@@ -136,8 +277,9 @@ ${SECTION_START}
 
 **Project ID:** \`${projectId}\`
 
-Context is **auto-injected** via hooks. Only use \`memory_store_fact\` to store new facts:
+Context is **auto-injected** via hooks - no need to call memory_search.
 
+## Store Facts (DO use this)
 \`\`\`
 memory_store_fact(
   entity1: "ComponentName",
@@ -147,6 +289,21 @@ memory_store_fact(
   project_id: "${projectId}"
 )
 \`\`\`
+
+## Task Management
+\`\`\`
+task_plan({ goal: "...", epic_title: "...", tasks: [...] })
+task_start({ task_id: "task_xxx" })
+task_complete({ task_id: "task_xxx", summary: "What was done" })
+\`\`\`
+
+## CodeDNA (saves 95-99% tokens)
+\`\`\`
+codedna_list_generators()  // See all available generators
+codedna_generate_api("User(email:string:unique, password:string)", "express")
+codedna_generate_frontend("User(email:string, name:string)", "react")
+codedna_generate_component("Product(name:string, price:decimal)", "form", "react")
+\`\`\`
 ${SECTION_END}
 `;
 }

package/dist/tools.js

@@ -1388,6 +1388,205 @@ Explicit lock_duration_minutes parameter overrides the effort-based default.`,
                     required: ['project_id'],
                 },
             },
+            // =========================================================================
+            // Kappa v2.5 DSL Tools
+            // =========================================================================
+            // Kappa is a declarative specification language for full-stack applications.
+            // It generates production-ready code from compact specifications, saving 95-99% tokens.
+            {
+                name: 'kappa_parse',
+                description: 'Parse and validate a Kappa v2.5 specification. Returns the AST and validation results. Use this to check syntax before generating code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification to parse (e.g., "project MyApp { stack: tanstack-start } entity User { id: uuid, primary }")',
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_schema',
+                description: 'Generate database schema (Drizzle), Zod validators, and TypeScript types from Kappa entity definitions. Saves 95%+ tokens vs writing manually.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with entity blocks',
+                        },
+                        outputs: {
+                            type: 'array',
+                            items: { type: 'string', enum: ['drizzle', 'zod', 'types'] },
+                            description: 'What to generate (default: all three)',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean', description: 'Add generation comments (default: true)' },
+                                dbDialect: { type: 'string', enum: ['sqlite', 'postgres', 'mysql'], description: 'Database dialect (default: sqlite)' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_api',
+                description: 'Generate API routes from Kappa API blocks. Supports Hono, Express, and Fastify frameworks.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with API blocks',
+                        },
+                        framework: {
+                            type: 'string',
+                            enum: ['hono', 'express', 'trpc'],
+                            description: 'API framework (default: hono)',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean' },
+                                typescript: { type: 'boolean' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_pages',
+                description: 'Generate page/route components from Kappa page blocks. Supports TanStack Start and Next.js App Router with loaders, guards, and layouts.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with page blocks',
+                        },
+                        framework: {
+                            type: 'string',
+                            enum: ['tanstack-start', 'nextjs'],
+                            description: 'Page framework (default: tanstack-start)',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean' },
+                                typescript: { type: 'boolean' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_forms',
+                description: 'Generate React forms with React Hook Form and Zod validation from Kappa form blocks. Supports shadcn/ui components.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with form blocks',
+                        },
+                        ui: {
+                            type: 'string',
+                            enum: ['shadcn', 'plain'],
+                            description: 'UI component library (default: shadcn)',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean' },
+                                typescript: { type: 'boolean' },
+                                zod: { type: 'boolean', description: 'Generate Zod validation (default: true)' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_components',
+                description: 'Generate React components from Kappa component blocks. Supports simple components, compound components with Context, and variants.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with component blocks',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean' },
+                                typescript: { type: 'boolean' },
+                                forwardRef: { type: 'boolean', description: 'Use forwardRef (default: false)' },
+                                basePath: { type: 'string', description: 'Component output path (default: components)' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_design',
+                description: 'Generate CSS variables and Tailwind config from Kappa design blocks. Supports colors, typography, spacing, borders, shadows, and motion tokens.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Kappa specification with design block',
+                        },
+                        format: {
+                            type: 'string',
+                            enum: ['css', 'tailwind', 'both'],
+                            description: 'Output format (default: both)',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                provenance: { type: 'boolean' },
+                                prefix: { type: 'string', description: 'CSS variable prefix' },
+                                hsl: { type: 'boolean', description: 'Use HSL colors (default: false)' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
+            {
+                name: 'kappa_generate_all',
+                description: 'Generate complete full-stack application from Kappa specification. Includes schema, API, pages, forms, components, and design tokens. Maximum token savings.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Complete Kappa specification',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                framework: { type: 'string', enum: ['tanstack-start', 'nextjs'], description: 'Page framework (default: tanstack-start)' },
+                                apiFramework: { type: 'string', enum: ['hono', 'express', 'trpc'], description: 'API framework (default: hono)' },
+                                ui: { type: 'string', enum: ['shadcn', 'plain'], description: 'UI library (default: shadcn)' },
+                                dbDialect: { type: 'string', enum: ['sqlite', 'postgres', 'mysql'], description: 'Database (default: sqlite)' },
+                                provenance: { type: 'boolean' },
+                                typescript: { type: 'boolean' },
+                            },
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
         ],
     }));
 }