@claudetools/tools 0.9.0 → 0.9.2

package/dist/handlers/codedna-handlers.d.ts

@@ -186,7 +186,7 @@ export declare function handleListGenerators(args?: {
         byFramework: Record<string, number>;
         byDomain: Record<string, number> | undefined;
         availableUiLibraries: string[];
-        filteredByDomain?: "api" | "frontend" | "component" | undefined;
+        filteredByDomain?: "api" | "component" | "frontend" | undefined;
         total: number;
     };
     usage: {

package/dist/handlers/codegen-handlers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Handle the unified codegen tool
+ */
+export declare function handleCodegen(args: Record<string, unknown>): Promise<{
+    success: boolean;
+    files?: Array<{
+        path: string;
+        content: string;
+        description: string;
+    }>;
+    entities?: string[];
+    summary?: string;
+    error?: string;
+    errors?: string[];
+    stack?: {
+        orm: string;
+        api: string;
+        db: string;
+    };
+}>;

package/dist/handlers/codegen-handlers.js

@@ -0,0 +1,60 @@
+// =============================================================================
+// Unified Codegen Handler
+// =============================================================================
+//
+// ONE tool to replace 20+ broken CodeDNA/Kappa tools.
+// Natural language in → generated code out.
+//
+import { codegen, detectStack } from '../codegen/index.js';
+/**
+ * Handle the unified codegen tool
+ */
+export async function handleCodegen(args) {
+    const describe = args.describe;
+    if (!describe || typeof describe !== 'string') {
+        return {
+            success: false,
+            error: 'Missing required "describe" parameter. Describe what you want to generate, e.g., "User with email, password, role (admin/user)"',
+        };
+    }
+    // Build input
+    const input = {
+        describe,
+    };
+    // Optional stack override
+    if (args.stack && typeof args.stack === 'object') {
+        input.stack = args.stack;
+    }
+    // Optional generate filter
+    if (args.generate && Array.isArray(args.generate)) {
+        input.generate = args.generate;
+    }
+    // Optional package.json for stack detection
+    let packageJson;
+    if (args.package_json && typeof args.package_json === 'object') {
+        packageJson = args.package_json;
+    }
+    // Run codegen
+    const result = codegen(input, packageJson);
+    if (!result.success) {
+        return {
+            success: false,
+            error: result.summary,
+            errors: result.errors,
+        };
+    }
+    // Detect stack for response
+    const detected = detectStack(packageJson);
+    const stack = {
+        orm: input.stack?.orm || detected.orm || 'drizzle',
+        api: input.stack?.api || detected.api || 'hono',
+        db: input.stack?.db || detected.db || 'sqlite',
+    };
+    return {
+        success: true,
+        files: result.files,
+        entities: result.entities,
+        summary: result.summary,
+        stack,
+    };
+}

package/dist/handlers/kappa-handlers.d.ts

@@ -114,3 +114,100 @@ export declare function handleKappaGenerateAll(args: {
         typescript?: boolean;
     };
 }): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_mongoose tool call
+ * Generates MongoDB/Mongoose models from Kappa entity definitions
+ */
+export declare function handleKappaGenerateMongoose(args: {
+    spec: string;
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+        separateTypes?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_typeorm tool call
+ * Generates TypeORM entities from Kappa entity definitions
+ */
+export declare function handleKappaGenerateTypeorm(args: {
+    spec: string;
+    dialect?: 'postgres' | 'mysql' | 'sqlite';
+    options?: {
+        provenance?: boolean;
+        migrations?: boolean;
+        repositories?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_tests tool call
+ * Generates Vitest/Jest test suites from Kappa specifications
+ */
+export declare function handleKappaGenerateTests(args: {
+    spec: string;
+    framework?: 'vitest' | 'jest';
+    testType?: 'unit' | 'integration' | 'e2e';
+    options?: {
+        provenance?: boolean;
+        factories?: boolean;
+        mocks?: boolean;
+        coverage?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_radix tool call
+ * Generates Radix UI components from Kappa component blocks
+ */
+export declare function handleKappaGenerateRadix(args: {
+    spec: string;
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+        forwardRef?: boolean;
+        tailwind?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_mantine tool call
+ * Generates Mantine UI components from Kappa specifications
+ */
+export declare function handleKappaGenerateMantine(args: {
+    spec: string;
+    options?: {
+        provenance?: boolean;
+        typescript?: boolean;
+        notifications?: boolean;
+        modals?: boolean;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_gofiber tool call
+ * Generates Go code with Fiber framework from Kappa specifications
+ */
+export declare function handleKappaGenerateGoFiber(args: {
+    spec: string;
+    options?: {
+        packageName?: string;
+        provenance?: boolean;
+        gorm?: boolean;
+        validation?: boolean;
+        basePath?: string;
+        modulePath?: string;
+    };
+}): Promise<KappaGenerateResult>;
+/**
+ * Handle kappa_generate_laravel tool call
+ * Generates Laravel code from Kappa specifications
+ */
+export declare function handleKappaGenerateLaravel(args: {
+    spec: string;
+    options?: {
+        modelNamespace?: string;
+        controllerNamespace?: string;
+        provenance?: boolean;
+        migrations?: boolean;
+        formRequests?: boolean;
+        apiResources?: boolean;
+        basePath?: string;
+    };
+}): Promise<KappaGenerateResult>;

package/dist/handlers/kappa-handlers.js

@@ -463,3 +463,411 @@ export async function handleKappaGenerateAll(args) {
         };
     }
 }
+// =============================================================================
+// Phase 1: Extended ORM Generators
+// =============================================================================
+/**
+ * Handle kappa_generate_mongoose tool call
+ * Generates MongoDB/Mongoose models from Kappa entity definitions
+ */
+export async function handleKappaGenerateMongoose(args) {
+    const { spec, options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.entities || ast.entities.length === 0) {
+            return { success: false, errors: ['No entity blocks found in specification'] };
+        }
+        // Import generator dynamically to avoid circular dependencies
+        const { generateMongooseSchema } = await import('../codedna/kappa-mongoose-generator.js');
+        const result = generateMongooseSchema(ast.entities, {
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+            separateTypes: options.separateTypes ?? true,
+        });
+        const files = [
+            { path: 'models/schemas.ts', content: result.schema },
+        ];
+        if (result.types) {
+            files.push({ path: 'models/types.ts', content: result.types });
+        }
+        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)],
+        };
+    }
+}
+/**
+ * Handle kappa_generate_typeorm tool call
+ * Generates TypeORM entities from Kappa entity definitions
+ */
+export async function handleKappaGenerateTypeorm(args) {
+    const { spec, dialect = 'postgres', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.entities || ast.entities.length === 0) {
+            return { success: false, errors: ['No entity blocks found in specification'] };
+        }
+        // Import generator dynamically
+        const { generateTypeORMEntities } = await import('../codedna/kappa-typeorm-generator.js');
+        const result = generateTypeORMEntities(ast.entities, {
+            dialect,
+            provenance: options.provenance ?? true,
+            migrations: options.migrations ?? false,
+            repositories: options.repositories ?? false,
+        });
+        const files = [];
+        // Convert entities record to file array
+        for (const [entityName, content] of Object.entries(result.entities)) {
+            files.push({
+                path: `src/entities/${entityName}.ts`,
+                content,
+            });
+        }
+        // Add data source
+        files.push({
+            path: 'src/data-source.ts',
+            content: result.dataSource,
+        });
+        // Add repositories if enabled
+        if (result.repositories) {
+            for (const [repoName, content] of Object.entries(result.repositories)) {
+                files.push({
+                    path: `src/repositories/${repoName}.ts`,
+                    content,
+                });
+            }
+        }
+        // Add migration if enabled
+        if (result.migration) {
+            const timestamp = Date.now();
+            files.push({
+                path: `src/migrations/${timestamp}-CreateInitialSchema.ts`,
+                content: result.migration,
+            });
+        }
+        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)],
+        };
+    }
+}
+// =============================================================================
+// Phase 1: Testing Generator
+// =============================================================================
+/**
+ * Handle kappa_generate_tests tool call
+ * Generates Vitest/Jest test suites from Kappa specifications
+ */
+export async function handleKappaGenerateTests(args) {
+    const { spec, framework = 'vitest', testType = 'unit', options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (!ast.entities || ast.entities.length === 0) {
+            return { success: false, errors: ['No entity blocks found in specification'] };
+        }
+        // Import generator dynamically
+        const { generateTests } = await import('../codedna/kappa-vitest-generator.js');
+        const result = generateTests(ast.entities, ast.apis, {
+            testType,
+            provenance: options.provenance ?? true,
+            factories: options.factories ?? true,
+            mocks: options.mocks ?? true,
+        });
+        const files = result.testFiles.map((t) => ({
+            path: t.path,
+            content: t.content,
+        }));
+        if (result.factories) {
+            files.push({ path: '__tests__/factories.ts', content: result.factories });
+        }
+        if (result.mocks) {
+            files.push({ path: '__tests__/mocks.ts', content: result.mocks });
+        }
+        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)],
+        };
+    }
+}
+// =============================================================================
+// Phase 1: UI Library Generators
+// =============================================================================
+/**
+ * Handle kappa_generate_radix tool call
+ * Generates Radix UI components from Kappa component blocks
+ */
+export async function handleKappaGenerateRadix(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'] };
+        }
+        // Import generator dynamically
+        const { generateRadixComponents } = await import('../codedna/kappa-radix-generator.js');
+        const result = generateRadixComponents(ast.components, {
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+        });
+        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)],
+        };
+    }
+}
+/**
+ * Handle kappa_generate_mantine tool call
+ * Generates Mantine UI components from Kappa specifications
+ */
+export async function handleKappaGenerateMantine(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) && (!ast.forms || ast.forms.length === 0)) {
+            return { success: false, errors: ['No component or form blocks found in specification'] };
+        }
+        // Import generators dynamically
+        const { generateMantineComponents, generateMantineForms } = await import('../codedna/kappa-mantine-generator.js');
+        const generatorOptions = {
+            provenance: options.provenance ?? true,
+            typescript: options.typescript ?? true,
+        };
+        const componentResult = generateMantineComponents(ast.components || [], generatorOptions);
+        const formResult = generateMantineForms(ast.forms || [], generatorOptions);
+        const files = [
+            ...componentResult.files.map((c) => ({ path: c.path, content: c.content })),
+            ...formResult.files.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)],
+        };
+    }
+}
+// =============================================================================
+// Go/Fiber Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_gofiber tool call
+ * Generates Go code with Fiber framework from Kappa specifications
+ */
+export async function handleKappaGenerateGoFiber(args) {
+    const { spec, options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (ast.apis.length === 0 && ast.entities.length === 0) {
+            return { success: false, errors: ['No API or entity blocks found in specification'] };
+        }
+        // Import generator dynamically
+        const { KappaGoFiberGenerator } = await import('../codedna/kappa-gofiber-generator.js');
+        const generator = new KappaGoFiberGenerator({
+            packageName: options.packageName ?? 'main',
+            provenance: options.provenance ?? true,
+            gorm: options.gorm ?? true,
+            validation: options.validation ?? true,
+            basePath: options.basePath ?? '/api',
+            modulePath: options.modulePath ?? 'app',
+        });
+        const result = generator.generateAll(ast.apis, ast.entities);
+        const files = [];
+        let totalLines = 0;
+        if (result.routes) {
+            files.push({ path: 'routes.go', content: result.routes });
+            totalLines += result.routes.split('\n').length;
+        }
+        if (result.handlers) {
+            files.push({ path: 'handlers.go', content: result.handlers });
+            totalLines += result.handlers.split('\n').length;
+        }
+        if (result.models) {
+            files.push({ path: 'models.go', content: result.models });
+            totalLines += result.models.split('\n').length;
+        }
+        if (result.types) {
+            files.push({ path: 'types.go', content: result.types });
+            totalLines += result.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)],
+        };
+    }
+}
+// =============================================================================
+// PHP/Laravel Generation Handler
+// =============================================================================
+/**
+ * Handle kappa_generate_laravel tool call
+ * Generates Laravel code from Kappa specifications
+ */
+export async function handleKappaGenerateLaravel(args) {
+    const { spec, options = {} } = args;
+    try {
+        const ast = parseKappaToAST(spec);
+        if (!ast) {
+            return { success: false, errors: ['Failed to parse Kappa specification'] };
+        }
+        if (ast.apis.length === 0 && ast.entities.length === 0) {
+            return { success: false, errors: ['No API or entity blocks found in specification'] };
+        }
+        // Import generator dynamically
+        const { KappaLaravelGenerator } = await import('../codedna/kappa-laravel-generator.js');
+        const generator = new KappaLaravelGenerator({
+            modelNamespace: options.modelNamespace ?? 'App\\Models',
+            controllerNamespace: options.controllerNamespace ?? 'App\\Http\\Controllers',
+            provenance: options.provenance ?? true,
+            migrations: options.migrations ?? true,
+            formRequests: options.formRequests ?? true,
+            apiResources: options.apiResources ?? true,
+            basePath: options.basePath ?? '/api',
+        });
+        const result = generator.generateAll(ast.apis, ast.entities);
+        const files = [];
+        let totalLines = 0;
+        // Add routes
+        if (result.routes) {
+            files.push({ path: 'routes/api.php', content: result.routes });
+            totalLines += result.routes.split('\n').length;
+        }
+        // Add controllers
+        for (const [name, content] of Object.entries(result.controllers)) {
+            files.push({ path: `app/Http/Controllers/${name}.php`, content });
+            totalLines += content.split('\n').length;
+        }
+        // Add models
+        for (const [name, content] of Object.entries(result.models)) {
+            files.push({ path: `app/Models/${name}.php`, content });
+            totalLines += content.split('\n').length;
+        }
+        // Add migrations
+        if (result.migrations) {
+            for (const [name, content] of Object.entries(result.migrations)) {
+                const timestamp = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+                files.push({ path: `database/migrations/${timestamp}_${name}.php`, content });
+                totalLines += content.split('\n').length;
+            }
+        }
+        // Add form requests
+        if (result.formRequests) {
+            for (const [name, content] of Object.entries(result.formRequests)) {
+                files.push({ path: `app/Http/Requests/${name}.php`, content });
+                totalLines += content.split('\n').length;
+            }
+        }
+        // Add resources
+        if (result.resources) {
+            for (const [name, content] of Object.entries(result.resources)) {
+                files.push({ path: `app/Http/Resources/${name}.php`, content });
+                totalLines += content.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)],
+        };
+    }
+}