@claudetools/tools 0.3.9 → 0.5.0

package/dist/handlers/codedna-handlers.js

@@ -0,0 +1,194 @@
+// =============================================================================
+// CodeDNA MCP Tool Handlers
+// =============================================================================
+//
+// Handlers for code generation tools that save 95-99% tokens by generating
+// production code from compact Entity DSL specifications.
+//
+import { validateSpec } from '../codedna/parser.js';
+import { TemplateRegistry } from '../codedna/registry.js';
+import { ExpressApiGenerator } from '../codedna/generators/express-api.js';
+import { errorTracker } from '../helpers/error-tracking.js';
+import { analytics } from '../helpers/usage-analytics.js';
+// Singleton registry instance
+const registry = new TemplateRegistry();
+/**
+ * Handle codedna_generate_api tool call
+ */
+export async function handleGenerateApi(args) {
+    const { spec, framework, options = {} } = args;
+    // Validate Entity DSL specification
+    const validation = validateSpec(spec);
+    if (!validation.valid) {
+        // Track validation error
+        await errorTracker.trackValidationError(spec, validation.errors || []);
+        return {
+            error: 'Invalid entity specification',
+            details: validation.errors,
+        };
+    }
+    // Select generator based on framework
+    let generator;
+    if (framework === 'express') {
+        generator = new ExpressApiGenerator(registry);
+    }
+    else if (framework === 'fastapi') {
+        return {
+            error: 'FastAPI generator not yet implemented',
+            message: 'Currently only Express is supported. Coming soon: FastAPI, NestJS',
+        };
+    }
+    else if (framework === 'nestjs') {
+        return {
+            error: 'NestJS generator not yet implemented',
+            message: 'Currently only Express is supported. Coming soon: FastAPI, NestJS',
+        };
+    }
+    else {
+        return {
+            error: `Unsupported framework: ${framework}`,
+            supported: ['express', 'fastapi', 'nestjs'],
+        };
+    }
+    try {
+        const startTime = Date.now();
+        // Generate code
+        const result = await generator.generate(validation.parsed, options);
+        const executionTime = Date.now() - startTime;
+        // Track successful generation
+        await analytics.trackGeneration({
+            operation: 'generate_api',
+            generator: `${framework}-api`,
+            framework,
+            entityName: validation.parsed.name,
+            fieldCount: validation.parsed.fields.length,
+            specLength: spec.length,
+            filesGenerated: result.metadata.filesGenerated,
+            linesOfCode: result.metadata.linesOfCode,
+            tokensSaved: result.metadata.estimatedTokensSaved,
+            options: options,
+            executionTimeMs: executionTime,
+        });
+        return {
+            success: true,
+            files: result.files,
+            metadata: result.metadata,
+            tokenSavings: {
+                traditional: result.metadata.linesOfCode * 25, // ~25 tokens per line
+                codedna: 150, // ~150 tokens for MCP call
+                saved: result.metadata.estimatedTokensSaved,
+                percentSaved: ((result.metadata.estimatedTokensSaved / (result.metadata.linesOfCode * 25)) * 100).toFixed(1) + '%',
+            },
+        };
+    }
+    catch (error) {
+        // Track generation error
+        await errorTracker.trackGenerationError(framework, spec, error instanceof Error ? error : new Error(String(error)));
+        return {
+            error: 'Code generation failed',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Handle codedna_generate_frontend tool call
+ */
+export async function handleGenerateFrontend(args) {
+    const { spec, framework, options = {} } = args;
+    // Validate Entity DSL specification
+    const validation = validateSpec(spec);
+    if (!validation.valid) {
+        return {
+            error: 'Invalid entity specification',
+            details: validation.errors,
+        };
+    }
+    // Frontend generators not yet implemented
+    return {
+        error: 'Frontend generators not yet implemented',
+        message: 'Coming soon: Next.js, React, Vue frontend generation',
+        frameworks: ['nextjs', 'react', 'vue'],
+        status: 'planned',
+    };
+}
+/**
+ * Handle codedna_generate_component tool call
+ */
+export async function handleGenerateComponent(args) {
+    const { spec, type, framework, options = {} } = args;
+    // Validate Entity DSL specification
+    const validation = validateSpec(spec);
+    if (!validation.valid) {
+        return {
+            error: 'Invalid entity specification',
+            details: validation.errors,
+        };
+    }
+    // Component generators not yet implemented
+    return {
+        error: 'Component generators not yet implemented',
+        message: 'Coming soon: Form, Table, Card, Modal components',
+        types: ['form', 'table', 'card', 'modal'],
+        frameworks: ['react', 'vue', 'svelte'],
+        status: 'planned',
+    };
+}
+/**
+ * Handle codedna_list_generators tool call
+ */
+export async function handleListGenerators() {
+    try {
+        const generators = await registry.listGenerators();
+        return {
+            generators,
+            summary: {
+                total: generators.length,
+                byFramework: generators.reduce((acc, gen) => {
+                    acc[gen.framework] = (acc[gen.framework] || 0) + 1;
+                    return acc;
+                }, {}),
+            },
+        };
+    }
+    catch (error) {
+        // Track network error for registry access
+        await errorTracker.trackNetworkError('list_generators', error instanceof Error ? error : new Error(String(error)));
+        return {
+            error: 'Failed to list generators',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Handle codedna_validate_spec tool call
+ */
+export async function handleValidateSpec(args) {
+    const { spec } = args;
+    const validation = validateSpec(spec);
+    // Track validation
+    if (validation.valid && validation.parsed) {
+        await analytics.trackValidation(spec, true, validation.parsed.name, validation.parsed.fields.length);
+        return {
+            valid: true,
+            entity: {
+                name: validation.parsed.name,
+                fields: validation.parsed.fields.map(f => ({
+                    name: f.name,
+                    type: f.type,
+                    constraints: f.constraints.map(c => c.kind),
+                })),
+            },
+            summary: {
+                totalFields: validation.parsed.fields.length,
+                hasReferences: validation.parsed.fields.some(f => f.type.kind === 'reference'),
+                hasEnums: validation.parsed.fields.some(f => f.type.kind === 'enum'),
+                hasConstraints: validation.parsed.fields.some(f => f.constraints.length > 0),
+            },
+        };
+    }
+    await analytics.trackValidation(spec, false);
+    return {
+        valid: false,
+        errors: validation.errors,
+    };
+}