@claudetools/tools 0.3.8 → 0.4.0

package/dist/tools.js

@@ -668,6 +668,128 @@ export function registerToolDefinitions(server) {
                     properties: {},
                 },
             },
+            {
+                name: 'task_epic_status',
+                description: 'Get epic progress status with task counts by status. Auto-completes epic when all child tasks are done. Use this to track epic progress and see completion percentage.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        epic_id: {
+                            type: 'string',
+                            description: 'The epic ID to get status for',
+                        },
+                    },
+                    required: ['epic_id'],
+                },
+            },
+            {
+                name: 'task_detect_timeouts',
+                description: 'Detect tasks that have timed out (lock expired while in_progress). These are likely abandoned or failed tasks that need attention.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_id: {
+                            type: 'string',
+                            description: 'Project ID (optional, uses default if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'task_retry',
+                description: 'Retry a failed or timed-out task. Resets task to ready status if under retry limit, or marks as failed permanently if limit exceeded.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        task_id: {
+                            type: 'string',
+                            description: 'The task ID to retry',
+                        },
+                        max_retries: {
+                            type: 'number',
+                            description: 'Maximum number of retries allowed (default: 3)',
+                        },
+                        error_context: {
+                            type: 'string',
+                            description: 'Description of the error or failure reason',
+                        },
+                        project_id: {
+                            type: 'string',
+                            description: 'Project ID (optional, uses default if not provided)',
+                        },
+                    },
+                    required: ['task_id'],
+                },
+            },
+            {
+                name: 'task_fail',
+                description: 'Explicitly mark a task as failed with error context. Use when a task cannot be completed.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        task_id: {
+                            type: 'string',
+                            description: 'The task ID to mark as failed',
+                        },
+                        error_context: {
+                            type: 'string',
+                            description: 'Description of why the task failed',
+                        },
+                        agent_id: {
+                            type: 'string',
+                            description: 'Agent ID (optional, defaults to "claude-code")',
+                        },
+                        project_id: {
+                            type: 'string',
+                            description: 'Project ID (optional, uses default if not provided)',
+                        },
+                    },
+                    required: ['task_id', 'error_context'],
+                },
+            },
+            {
+                name: 'task_auto_retry_timeouts',
+                description: 'Automatically detect and retry all timed-out tasks. Tasks under retry limit are reset to ready, those exceeding limit are marked as failed.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        max_retries: {
+                            type: 'number',
+                            description: 'Maximum number of retries per task (default: 3)',
+                        },
+                        project_id: {
+                            type: 'string',
+                            description: 'Project ID (optional, uses default if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'task_orchestrate',
+                description: 'Orchestrate autonomous multi-agent execution for an epic. Dispatches parallel workers, monitors progress, handles failures, and continues until completion.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        epic_id: {
+                            type: 'string',
+                            description: 'Epic ID to orchestrate',
+                        },
+                        max_parallel: {
+                            type: 'number',
+                            description: 'Max parallel tasks (default: 5)',
+                        },
+                        max_retries: {
+                            type: 'number',
+                            description: 'Max retries per task (default: 3)',
+                        },
+                        dry_run: {
+                            type: 'boolean',
+                            description: 'Preview without executing (default: false)',
+                        },
+                    },
+                    required: ['epic_id'],
+                },
+            },
             // =========================================================================
             // CODEBASE MAPPING TOOLS
             // =========================================================================
@@ -743,6 +865,198 @@ export function registerToolDefinitions(server) {
                     required: ['function_name'],
                 },
             },
+            // =========================================================================
+            // DOCUMENTATION CACHING TOOLS
+            // =========================================================================
+            {
+                name: 'docs_cache',
+                description: 'Ensure documentation for a library is cached. Automatically fetches from Context7 if not already cached. Use simple library names like "react", "next.js", "zod", "tanstack-query".',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        library: {
+                            type: 'string',
+                            description: 'Library name to cache docs for (e.g., "react", "next.js", "zod", "tanstack-query", "supabase")',
+                        },
+                        topic: {
+                            type: 'string',
+                            description: 'Optional topic to focus on (e.g., "routing", "authentication")',
+                        },
+                    },
+                    required: ['library'],
+                },
+            },
+            {
+                name: 'docs_list',
+                description: 'List all cached documentation libraries (global cache shared across projects).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'docs_get',
+                description: 'Get cached documentation for a specific library. Returns the full cached content.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        library: {
+                            type: 'string',
+                            description: 'Library name to get docs for (e.g., "react", "next.js")',
+                        },
+                        topic: {
+                            type: 'string',
+                            description: 'Optional topic to filter docs by',
+                        },
+                    },
+                    required: ['library'],
+                },
+            },
+            // =========================================================================
+            // CODEDNA CODE GENERATION TOOLS
+            // =========================================================================
+            {
+                name: 'codedna_generate_api',
+                description: 'Generate a complete REST API with CRUD operations from an Entity DSL specification. Saves 95-99% tokens vs writing code manually. Example: codedna_generate_api("User(email:string:unique, password:string:hashed)", "express", { auth: true })',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Entity DSL specification (e.g., "User(email:string:unique:required, password:string:hashed, age:integer:min(18))")',
+                        },
+                        framework: {
+                            type: 'string',
+                            enum: ['express', 'fastapi', 'nestjs'],
+                            description: 'API framework to use',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                auth: {
+                                    type: 'boolean',
+                                    description: 'Include JWT authentication middleware',
+                                },
+                                validation: {
+                                    type: 'boolean',
+                                    description: 'Add input validation',
+                                },
+                                tests: {
+                                    type: 'boolean',
+                                    description: 'Generate test files',
+                                },
+                                database: {
+                                    type: 'string',
+                                    enum: ['postgresql', 'mysql', 'mongodb'],
+                                    description: 'Target database',
+                                },
+                            },
+                        },
+                    },
+                    required: ['spec', 'framework'],
+                },
+            },
+            {
+                name: 'codedna_generate_frontend',
+                description: 'Generate frontend application with forms and tables from Entity DSL. Saves 95-99% tokens vs writing components manually.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Entity DSL specification',
+                        },
+                        framework: {
+                            type: 'string',
+                            enum: ['nextjs', 'react', 'vue'],
+                            description: 'Frontend framework to use',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                ui: {
+                                    type: 'string',
+                                    enum: ['shadcn', 'mui', 'chakra'],
+                                    description: 'UI component library',
+                                },
+                                forms: {
+                                    type: 'boolean',
+                                    description: 'Generate forms',
+                                },
+                                tables: {
+                                    type: 'boolean',
+                                    description: 'Generate data tables',
+                                },
+                                routing: {
+                                    type: 'boolean',
+                                    description: 'Setup routing',
+                                },
+                            },
+                        },
+                    },
+                    required: ['spec', 'framework'],
+                },
+            },
+            {
+                name: 'codedna_generate_component',
+                description: 'Generate single UI component (form, table, card, modal) from Entity DSL.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Entity DSL specification or component spec',
+                        },
+                        type: {
+                            type: 'string',
+                            enum: ['form', 'table', 'card', 'modal'],
+                            description: 'Component type to generate',
+                        },
+                        framework: {
+                            type: 'string',
+                            enum: ['react', 'vue', 'svelte'],
+                            description: 'Frontend framework',
+                        },
+                        options: {
+                            type: 'object',
+                            properties: {
+                                ui: {
+                                    type: 'string',
+                                    enum: ['shadcn', 'mui', 'chakra'],
+                                    description: 'UI library',
+                                },
+                                validation: {
+                                    type: 'boolean',
+                                    description: 'Include validation',
+                                },
+                            },
+                        },
+                    },
+                    required: ['spec', 'type', 'framework'],
+                },
+            },
+            {
+                name: 'codedna_list_generators',
+                description: 'List all available code generators and their capabilities.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'codedna_validate_spec',
+                description: 'Validate Entity DSL syntax without generating code. Returns parsed structure or errors.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        spec: {
+                            type: 'string',
+                            description: 'Entity DSL specification to validate',
+                        },
+                    },
+                    required: ['spec'],
+                },
+            },
         ],
     }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudetools/tools",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "description": "Persistent AI memory, task management, and codebase intelligence for Claude Code",
   "type": "module",
   "main": "dist/index.js",
@@ -48,11 +48,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chalk": "^5.6.2",
+    "nunjucks": "^3.2.4",
     "ora": "^9.0.0",
     "prompts": "^2.4.2"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
+    "@types/nunjucks": "^3.2.6",
     "@types/prompts": "^2.4.9",
     "@vitest/ui": "^4.0.15",
     "tsx": "^4.7.0",