@claudetools/tools 0.9.0 → 0.9.2

package/dist/codedna/kappa-gofiber-generator.js

@@ -0,0 +1,587 @@
+// =============================================================================
+// Kappa v2.5 Go/Fiber Generator
+// =============================================================================
+//
+// Generates Go code with Fiber framework from Kappa specifications.
+// Supports: API routes, GORM models, validation.
+//
+// =============================================================================
+// Type Mappings
+// =============================================================================
+const PRIMITIVE_GO_MAP = {
+    string: 'string',
+    int: 'int',
+    float: 'float64',
+    bool: 'bool',
+    timestamp: 'time.Time',
+    date: 'time.Time',
+    time: 'time.Time',
+    duration: 'time.Duration',
+    uuid: 'uuid.UUID',
+    email: 'string',
+    url: 'string',
+    phone: 'string',
+    slug: 'string',
+    markdown: 'string',
+    json: 'json.RawMessage',
+};
+const CRUD_METHOD_MAP = {
+    create: 'Post',
+    read: 'Get',
+    update: 'Patch',
+    delete: 'Delete',
+    list: 'Get',
+};
+const CRUD_PATH_SUFFIX = {
+    create: '',
+    read: '/:id',
+    update: '/:id',
+    delete: '/:id',
+    list: '',
+};
+const GORM_TAGS = {
+    string: '',
+    int: '',
+    float: '',
+    bool: '',
+    timestamp: '',
+    date: 'type:date',
+    time: 'type:time',
+    duration: '',
+    uuid: 'type:uuid',
+    email: '',
+    url: '',
+    phone: '',
+    slug: 'index',
+    markdown: 'type:text',
+    json: 'type:jsonb',
+};
+// =============================================================================
+// Generator Class
+// =============================================================================
+export class KappaGoFiberGenerator {
+    packageName;
+    provenance;
+    gorm;
+    validation;
+    basePath;
+    modulePath;
+    constructor(options = {}) {
+        this.packageName = options.packageName ?? 'main';
+        this.provenance = options.provenance ?? true;
+        this.gorm = options.gorm ?? true;
+        this.validation = options.validation ?? true;
+        this.basePath = options.basePath ?? '/api';
+        this.modulePath = options.modulePath ?? 'app';
+    }
+    // ===========================================================================
+    // Main Generation Methods
+    // ===========================================================================
+    generateFromAPIs(apis) {
+        return {
+            routes: this.generateRoutes(apis),
+            handlers: this.generateHandlers(apis),
+            types: this.generateRequestTypes(apis),
+        };
+    }
+    generateFromEntities(entities) {
+        return {
+            routes: '',
+            models: this.generateModels(entities),
+        };
+    }
+    generateAll(apis, entities) {
+        return {
+            routes: this.generateRoutes(apis),
+            handlers: this.generateHandlers(apis),
+            types: this.generateRequestTypes(apis),
+            models: this.generateModels(entities),
+        };
+    }
+    // ===========================================================================
+    // Route Generation
+    // ===========================================================================
+    generateRoutes(apis) {
+        const lines = [];
+        const routes = this.extractRoutes(apis);
+        // Header
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push('// Framework: Go/Fiber');
+            lines.push('');
+        }
+        lines.push(`package ${this.packageName}`);
+        lines.push('');
+        // Imports
+        lines.push('import (');
+        lines.push('\t"github.com/gofiber/fiber/v2"');
+        if (routes.some((r) => r.requiresAuth)) {
+            lines.push(`\t"${this.modulePath}/middleware"`);
+        }
+        lines.push(')');
+        lines.push('');
+        // Setup function
+        lines.push('// SetupRoutes configures all API routes');
+        lines.push('func SetupRoutes(app *fiber.App) {');
+        lines.push(`\tapi := app.Group("${this.basePath}")`);
+        lines.push('');
+        // Group routes by API
+        for (const api of apis) {
+            const apiRoutes = routes.filter((r) => this.isRouteFromAPI(r, api));
+            if (apiRoutes.length > 0) {
+                lines.push(`\t// ${api.name}`);
+                for (const route of apiRoutes) {
+                    const middleware = route.requiresAuth ? 'middleware.RequireAuth, ' : '';
+                    lines.push(`\tapi.${route.method}("${route.path}", ${middleware}${route.handlerName})`);
+                }
+                lines.push('');
+            }
+        }
+        lines.push('}');
+        lines.push('');
+        return lines.join('\n');
+    }
+    isRouteFromAPI(route, api) {
+        // Check explicit operations
+        if (api.operations?.some((op) => op.name === route.operationName)) {
+            return true;
+        }
+        // Check CRUD operations
+        for (const crud of api.crud || []) {
+            if (route.operationName.toLowerCase().endsWith(crud.entity.toLowerCase())) {
+                return true;
+            }
+        }
+        return false;
+    }
+    extractRoutes(apis) {
+        const routes = [];
+        for (const api of apis) {
+            const apiPath = `/${this.toKebabCase(api.name)}`;
+            // Convert CRUD shorthand (crud is an array)
+            for (const crud of api.crud || []) {
+                routes.push(...this.crudToRoutes(crud, apiPath));
+            }
+            // Convert explicit operations
+            if (api.operations) {
+                for (const op of api.operations) {
+                    routes.push(this.operationToRoute(op, apiPath));
+                }
+            }
+        }
+        return routes;
+    }
+    operationToRoute(op, apiPath) {
+        const method = this.inferMethod(op.name);
+        const path = `${apiPath}/${this.toKebabCase(op.name)}`;
+        return {
+            method,
+            path,
+            handlerName: `Handle${this.toPascalCase(op.name)}`,
+            operationName: op.name,
+            effects: op.effects,
+            requiresAuth: op.effects.includes('Auth'),
+            parameters: op.parameters,
+        };
+    }
+    crudToRoutes(crud, apiPath) {
+        const routes = [];
+        const entityPath = `${apiPath}/${this.toKebabCase(crud.entity)}s`;
+        for (const action of crud.actions) {
+            const method = CRUD_METHOD_MAP[action.action] ?? 'Get';
+            const pathSuffix = CRUD_PATH_SUFFIX[action.action] ?? '';
+            routes.push({
+                method,
+                path: `${entityPath}${pathSuffix}`,
+                handlerName: `Handle${this.toPascalCase(action.action)}${crud.entity}`,
+                operationName: `${action.action}${crud.entity}`,
+                effects: action.effects,
+                requiresAuth: action.effects.includes('Auth'),
+                parameters: [],
+            });
+        }
+        return routes;
+    }
+    inferMethod(name) {
+        const lower = name.toLowerCase();
+        if (lower.startsWith('get') ||
+            lower.startsWith('list') ||
+            lower.startsWith('find') ||
+            lower.startsWith('fetch')) {
+            return 'Get';
+        }
+        if (lower.startsWith('create') || lower.startsWith('add') || lower.startsWith('register')) {
+            return 'Post';
+        }
+        if (lower.startsWith('update') || lower.startsWith('edit')) {
+            return 'Patch';
+        }
+        if (lower.startsWith('delete') || lower.startsWith('remove')) {
+            return 'Delete';
+        }
+        return 'Post';
+    }
+    // ===========================================================================
+    // Handler Generation
+    // ===========================================================================
+    generateHandlers(apis) {
+        const lines = [];
+        const routes = this.extractRoutes(apis);
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push('// Framework: Go/Fiber');
+            lines.push('');
+        }
+        lines.push(`package ${this.packageName}`);
+        lines.push('');
+        lines.push('import (');
+        lines.push('\t"github.com/gofiber/fiber/v2"');
+        lines.push('\t"gorm.io/gorm"');
+        lines.push(')');
+        lines.push('');
+        lines.push('// db is the database instance (inject or initialize)');
+        lines.push('var db *gorm.DB');
+        lines.push('');
+        for (const route of routes) {
+            lines.push(this.generateHandler(route));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    generateHandler(route) {
+        const lines = [];
+        lines.push(`// ${route.handlerName} handles ${route.method} ${route.path}`);
+        if (route.effects.length > 0) {
+            lines.push(`// Effects: ${route.effects.join(', ')}`);
+        }
+        lines.push(`func ${route.handlerName}(c *fiber.Ctx) error {`);
+        // Check if this is a CRUD operation and generate proper implementation
+        const opLower = route.operationName.toLowerCase();
+        if (opLower.startsWith('list')) {
+            lines.push(...this.generateListHandler(route));
+        }
+        else if (opLower.startsWith('create')) {
+            lines.push(...this.generateCreateHandler(route));
+        }
+        else if (opLower.startsWith('read') || opLower.startsWith('get')) {
+            lines.push(...this.generateReadHandler(route));
+        }
+        else if (opLower.startsWith('update')) {
+            lines.push(...this.generateUpdateHandler(route));
+        }
+        else if (opLower.startsWith('delete')) {
+            lines.push(...this.generateDeleteHandler(route));
+        }
+        else {
+            // Custom operation - generate TODO stub
+            lines.push(`\t// TODO: Implement ${route.operationName}`);
+            lines.push('\treturn c.Status(501).JSON(fiber.Map{');
+            lines.push('\t\t"error": "Not implemented",');
+            lines.push('\t})');
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+    generateListHandler(route) {
+        const entityName = this.extractEntityName(route.operationName);
+        return [
+            '\tvar items []' + entityName,
+            '\t',
+            '\t// TODO: Add pagination, filtering, sorting',
+            '\tif err := db.Find(&items).Error; err != nil {',
+            '\t\treturn c.Status(500).JSON(fiber.Map{"error": err.Error()})',
+            '\t}',
+            '\t',
+            '\treturn c.JSON(items)',
+        ];
+    }
+    generateCreateHandler(route) {
+        const entityName = this.extractEntityName(route.operationName);
+        return [
+            '\tvar item ' + entityName,
+            '\t',
+            '\tif err := c.BodyParser(&item); err != nil {',
+            '\t\treturn c.Status(400).JSON(fiber.Map{"error": "Invalid request body"})',
+            '\t}',
+            '\t',
+            '\t// TODO: Add validation',
+            '\tif err := db.Create(&item).Error; err != nil {',
+            '\t\treturn c.Status(500).JSON(fiber.Map{"error": err.Error()})',
+            '\t}',
+            '\t',
+            '\treturn c.Status(201).JSON(item)',
+        ];
+    }
+    generateReadHandler(route) {
+        const entityName = this.extractEntityName(route.operationName);
+        return [
+            '\tid := c.Params("id")',
+            '\tvar item ' + entityName,
+            '\t',
+            '\tif err := db.First(&item, "id = ?", id).Error; err != nil {',
+            '\t\treturn c.Status(404).JSON(fiber.Map{"error": "Not found"})',
+            '\t}',
+            '\t',
+            '\treturn c.JSON(item)',
+        ];
+    }
+    generateUpdateHandler(route) {
+        const entityName = this.extractEntityName(route.operationName);
+        return [
+            '\tid := c.Params("id")',
+            '\tvar item ' + entityName,
+            '\t',
+            '\tif err := db.First(&item, "id = ?", id).Error; err != nil {',
+            '\t\treturn c.Status(404).JSON(fiber.Map{"error": "Not found"})',
+            '\t}',
+            '\t',
+            '\tif err := c.BodyParser(&item); err != nil {',
+            '\t\treturn c.Status(400).JSON(fiber.Map{"error": "Invalid request body"})',
+            '\t}',
+            '\t',
+            '\t// TODO: Add validation',
+            '\tif err := db.Save(&item).Error; err != nil {',
+            '\t\treturn c.Status(500).JSON(fiber.Map{"error": err.Error()})',
+            '\t}',
+            '\t',
+            '\treturn c.JSON(item)',
+        ];
+    }
+    generateDeleteHandler(route) {
+        const entityName = this.extractEntityName(route.operationName);
+        return [
+            '\tid := c.Params("id")',
+            '\tvar item ' + entityName,
+            '\t',
+            '\tif err := db.First(&item, "id = ?", id).Error; err != nil {',
+            '\t\treturn c.Status(404).JSON(fiber.Map{"error": "Not found"})',
+            '\t}',
+            '\t',
+            '\tif err := db.Delete(&item).Error; err != nil {',
+            '\t\treturn c.Status(500).JSON(fiber.Map{"error": err.Error()})',
+            '\t}',
+            '\t',
+            '\treturn c.SendStatus(204)',
+        ];
+    }
+    extractEntityName(operationName) {
+        // Extract entity name from operation name like "listUser" -> "User" or "createPost" -> "Post"
+        const match = operationName.match(/(?:list|create|read|update|delete|get)(.+)/i);
+        return match ? match[1] : 'Entity';
+    }
+    // ===========================================================================
+    // Model Generation (GORM)
+    // ===========================================================================
+    generateModels(entities) {
+        const lines = [];
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push('// ORM: GORM');
+            lines.push('');
+        }
+        lines.push(`package ${this.packageName}`);
+        lines.push('');
+        // Collect required imports
+        const imports = new Set();
+        imports.add('"time"');
+        imports.add('"github.com/google/uuid"');
+        imports.add('"gorm.io/gorm"');
+        imports.add('"encoding/json"');
+        lines.push('import (');
+        for (const imp of imports) {
+            lines.push(`\t${imp}`);
+        }
+        lines.push(')');
+        lines.push('');
+        // Suppress unused import warning
+        lines.push('var (');
+        lines.push('\t_ = time.Now');
+        lines.push('\t_ = uuid.New');
+        lines.push('\t_ json.RawMessage');
+        lines.push(')');
+        lines.push('');
+        for (const entity of entities) {
+            lines.push(this.generateModel(entity));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    generateModel(entity) {
+        const lines = [];
+        lines.push(`// ${entity.name} represents the ${entity.name.toLowerCase()} entity`);
+        lines.push(`type ${entity.name} struct {`);
+        // GORM base model if using UUID
+        const hasUUID = entity.fields.some((f) => f.type.kind === 'primitive' && f.type.type === 'uuid' && f.modifiers.includes('primary'));
+        if (!hasUUID) {
+            lines.push('\tgorm.Model');
+        }
+        for (const field of entity.fields) {
+            lines.push(this.generateModelField(field));
+        }
+        lines.push('}');
+        // TableName method
+        lines.push('');
+        lines.push(`// TableName returns the table name for ${entity.name}`);
+        lines.push(`func (${entity.name}) TableName() string {`);
+        lines.push(`\treturn "${this.pluralizeTableName(entity.name)}"`);
+        lines.push('}');
+        return lines.join('\n');
+    }
+    generateModelField(field) {
+        const goType = this.fieldToGoType(field.type);
+        const fieldName = this.toPascalCase(field.name);
+        const tags = this.generateFieldTags(field);
+        return `\t${fieldName} ${goType} ${tags}`;
+    }
+    fieldToGoType(type) {
+        switch (type.kind) {
+            case 'primitive':
+                return PRIMITIVE_GO_MAP[type.type] ?? 'string';
+            case 'array':
+                const elementType = this.fieldToGoType(type.itemType);
+                return `[]${elementType}`;
+            case 'reference':
+                return type.entity;
+            case 'enum':
+                return 'string';
+            default:
+                return 'interface{}';
+        }
+    }
+    generateFieldTags(field) {
+        const tags = [];
+        // JSON tag
+        const jsonName = this.toSnakeCase(field.name);
+        tags.push(`json:"${jsonName}"`);
+        // GORM tags
+        if (this.gorm) {
+            const gormParts = [];
+            gormParts.push(`column:${jsonName}`);
+            if (field.modifiers.includes('primary')) {
+                gormParts.push('primaryKey');
+            }
+            if (field.modifiers.includes('unique')) {
+                gormParts.push('uniqueIndex');
+            }
+            if (!field.modifiers.includes('optional')) {
+                gormParts.push('not null');
+            }
+            // Type-specific GORM tags
+            if (field.type.kind === 'primitive') {
+                const gormTypeTag = GORM_TAGS[field.type.type];
+                if (gormTypeTag) {
+                    gormParts.push(gormTypeTag);
+                }
+            }
+            tags.push(`gorm:"${gormParts.join(';')}"`);
+        }
+        // Validation tags
+        if (this.validation) {
+            const validParts = [];
+            if (!field.modifiers.includes('optional')) {
+                validParts.push('required');
+            }
+            if (field.type.kind === 'primitive') {
+                if (field.type.type === 'email') {
+                    validParts.push('email');
+                }
+                if (field.type.type === 'url') {
+                    validParts.push('url');
+                }
+                if (field.type.type === 'uuid') {
+                    validParts.push('uuid');
+                }
+            }
+            if (validParts.length > 0) {
+                tags.push(`validate:"${validParts.join(',')}"`);
+            }
+        }
+        return '`' + tags.join(' ') + '`';
+    }
+    // ===========================================================================
+    // Request/Response Types
+    // ===========================================================================
+    generateRequestTypes(apis) {
+        const lines = [];
+        const routes = this.extractRoutes(apis);
+        if (this.provenance) {
+            lines.push('// Generated by Kappa v2.5 CodeDNA');
+            lines.push('// Request/Response types for Go/Fiber');
+            lines.push('');
+        }
+        lines.push(`package ${this.packageName}`);
+        lines.push('');
+        for (const route of routes) {
+            if (route.parameters.length > 0) {
+                lines.push(this.generateRequestType(route));
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    generateRequestType(route) {
+        const lines = [];
+        const typeName = `${this.toPascalCase(route.operationName)}Request`;
+        lines.push(`// ${typeName} represents the request body for ${route.operationName}`);
+        lines.push(`type ${typeName} struct {`);
+        for (const param of route.parameters) {
+            const goType = this.fieldToGoType(param.type);
+            const fieldName = this.toPascalCase(param.name);
+            const jsonName = this.toSnakeCase(param.name);
+            const optional = param.optional ? ',omitempty' : '';
+            lines.push(`\t${fieldName} ${goType} \`json:"${jsonName}${optional}"\``);
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+    // ===========================================================================
+    // Utility Methods
+    // ===========================================================================
+    toPascalCase(str) {
+        return str
+            .replace(/[-_](.)/g, (_, c) => c.toUpperCase())
+            .replace(/^(.)/, (_, c) => c.toUpperCase());
+    }
+    toKebabCase(str) {
+        return str
+            .replace(/([a-z])([A-Z])/g, '$1-$2')
+            .replace(/[_\s]+/g, '-')
+            .toLowerCase();
+    }
+    toSnakeCase(str) {
+        return str
+            .replace(/([a-z])([A-Z])/g, '$1_$2')
+            .replace(/[-\s]+/g, '_')
+            .toLowerCase();
+    }
+    pluralizeTableName(entityName) {
+        const snakeCase = this.toSnakeCase(entityName);
+        // Simple pluralization rules for table names
+        // If already plural (ends with 's'), don't add another 's'
+        if (snakeCase.endsWith('s')) {
+            return snakeCase;
+        }
+        if (snakeCase.endsWith('x') || snakeCase.endsWith('ch') || snakeCase.endsWith('sh')) {
+            return `${snakeCase}es`;
+        }
+        if (snakeCase.endsWith('y') && !/[aeiou]y$/.test(snakeCase)) {
+            return `${snakeCase.slice(0, -1)}ies`;
+        }
+        return `${snakeCase}s`;
+    }
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+export function generateGoFiberAPI(apis, options) {
+    const generator = new KappaGoFiberGenerator(options);
+    return generator.generateFromAPIs(apis);
+}
+export function generateGoFiberModels(entities, options) {
+    const generator = new KappaGoFiberGenerator(options);
+    return generator.generateFromEntities(entities).models ?? '';
+}
+export function generateGoFiber(apis, entities, options) {
+    const generator = new KappaGoFiberGenerator(options);
+    return generator.generateAll(apis, entities);
+}

package/dist/codedna/kappa-laravel-generator.d.ts

@@ -0,0 +1,68 @@
+import type { APIBlock, EntityBlock } from './kappa-ast.js';
+export interface LaravelGeneratorOptions {
+    /** Namespace for models (default: 'App\\Models') */
+    modelNamespace?: string;
+    /** Namespace for controllers (default: 'App\\Http\\Controllers') */
+    controllerNamespace?: string;
+    /** Add provenance comments (default: true) */
+    provenance?: boolean;
+    /** Generate migrations (default: true) */
+    migrations?: boolean;
+    /** Generate Form Requests (default: true) */
+    formRequests?: boolean;
+    /** Use API resources (default: true) */
+    apiResources?: boolean;
+    /** Base path for routes (default: '/api') */
+    basePath?: string;
+}
+export interface GeneratedLaravelFiles {
+    /** API routes file */
+    routes: string;
+    /** Controller files (keyed by controller name) */
+    controllers: Record<string, string>;
+    /** Model files (keyed by model name) */
+    models: Record<string, string>;
+    /** Migration files (keyed by migration name) */
+    migrations?: Record<string, string>;
+    /** Form Request files */
+    formRequests?: Record<string, string>;
+    /** API Resource files */
+    resources?: Record<string, string>;
+}
+export declare class KappaLaravelGenerator {
+    private modelNamespace;
+    private controllerNamespace;
+    private provenance;
+    private migrations;
+    private formRequests;
+    private apiResources;
+    private basePath;
+    private entities;
+    constructor(options?: LaravelGeneratorOptions);
+    generateFromAPIs(apis: APIBlock[]): GeneratedLaravelFiles;
+    generateFromEntities(entities: EntityBlock[]): GeneratedLaravelFiles;
+    generateAll(apis: APIBlock[], entities: EntityBlock[]): GeneratedLaravelFiles;
+    private generateRoutes;
+    private generateRouteDefinition;
+    private extractRoutes;
+    private operationToRoute;
+    private crudToRoutes;
+    private inferMethod;
+    private groupByController;
+    private generateController;
+    private generateControllerMethod;
+    private generateModel;
+    private generateCasts;
+    private generateMigration;
+    private generateMigrationColumn;
+    private generateFormRequest;
+    private generateValidationRules;
+    private generateResource;
+    private toPascalCase;
+    private toCamelCase;
+    private toKebabCase;
+    private toSnakeCase;
+}
+export declare function generateLaravelAPI(apis: APIBlock[], options?: LaravelGeneratorOptions): GeneratedLaravelFiles;
+export declare function generateLaravelModels(entities: EntityBlock[], options?: LaravelGeneratorOptions): GeneratedLaravelFiles;
+export declare function generateLaravel(apis: APIBlock[], entities: EntityBlock[], options?: LaravelGeneratorOptions): GeneratedLaravelFiles;