@claudetools/tools 0.9.1 → 0.9.2

package/dist/cli.js

@@ -7,7 +7,7 @@ import { parseArgs } from 'node:util';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import { runSetup, runUninstall, runInit, runCleanup } from './setup.js';
+import { runSetup, runUninstall, runInit, runCleanup, runOnboard } from './setup.js';
 import { startServer } from './index.js';
 import { startWatcher, stopWatcher, watcherStatus } from './watcher.js';
 import { generateCodebaseMap, generateCodebaseMapLocal } from './helpers/codebase-mapper.js';
@@ -52,6 +52,7 @@ Options:
 
 Commands:
   init             Initialize current directory as a project
+  onboard          Interactive project onboarding (teach Claude about your project)
   cleanup          Remove legacy config and broken hooks
   watch            Start the file watcher daemon
   watch --stop     Stop the watcher daemon
@@ -99,6 +100,13 @@ else if (positionals[0] === 'cleanup') {
         process.exit(1);
     });
 }
+else if (positionals[0] === 'onboard') {
+    // Handle onboard command
+    runOnboard().catch((error) => {
+        console.error('Onboard failed:', error);
+        process.exit(1);
+    });
+}
 else if (positionals[0] === 'watch') {
     // Handle watch command
     const watchArgs = process.argv.slice(3); // Get args after 'watch'

package/dist/codedna/__tests__/examples/mongoose-example.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Example usage of the Kappa Mongoose Generator
+ *
+ * This demonstrates how to generate MongoDB/Mongoose schemas from Kappa entity blocks.
+ */
+export {};

package/dist/codedna/__tests__/examples/mongoose-example.js

@@ -0,0 +1,163 @@
+/**
+ * Example usage of the Kappa Mongoose Generator
+ *
+ * This demonstrates how to generate MongoDB/Mongoose schemas from Kappa entity blocks.
+ */
+import { generateMongooseSchema } from '../../kappa-mongoose-generator.js';
+// Sample entity blocks
+const loc = {
+    startLine: 1,
+    startColumn: 1,
+    endLine: 1,
+    endColumn: 1,
+    startOffset: 0,
+    endOffset: 0,
+};
+const entities = [
+    {
+        kind: 'EntityBlock',
+        name: 'User',
+        loc,
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'email',
+                loc,
+                type: { kind: 'primitive', type: 'email' },
+                modifiers: ['unique'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'username',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 3, max: 20 } },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'bio',
+                loc,
+                type: { kind: 'primitive', type: 'markdown' },
+                modifiers: ['optional'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'role',
+                loc,
+                type: { kind: 'enum', values: ['admin', 'user', 'guest'] },
+                modifiers: [],
+                defaultValue: 'user',
+            },
+        ],
+        relationships: [
+            {
+                kind: 'EntityRelationship',
+                type: 'has_many',
+                entity: 'Post',
+                loc,
+            },
+        ],
+        capabilities: [],
+        lifecycleHooks: [],
+        indexes: [
+            {
+                kind: 'EntityIndex',
+                fields: ['email'],
+                unique: true,
+                loc,
+            },
+        ],
+    },
+    {
+        kind: 'EntityBlock',
+        name: 'Post',
+        loc,
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'title',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 1, max: 200 } },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'content',
+                loc,
+                type: { kind: 'primitive', type: 'markdown' },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'published',
+                loc,
+                type: { kind: 'primitive', type: 'bool' },
+                modifiers: [],
+                defaultValue: 'false',
+            },
+            {
+                kind: 'EntityField',
+                name: 'tags',
+                loc,
+                type: { kind: 'array', itemType: { kind: 'primitive', type: 'string' } },
+                modifiers: ['optional'],
+            },
+        ],
+        relationships: [
+            {
+                kind: 'EntityRelationship',
+                type: 'belongs_to',
+                entity: 'User',
+                as: 'author',
+                loc,
+            },
+        ],
+        capabilities: [],
+        lifecycleHooks: [],
+        indexes: [
+            {
+                kind: 'EntityIndex',
+                fields: ['userId', 'published'],
+                loc,
+            },
+        ],
+    },
+];
+// Generate schemas with all options enabled
+const result = generateMongooseSchema(entities, {
+    typescript: true,
+    provenance: true,
+    separateTypes: true,
+});
+console.log('=== Generated Schema File ===');
+console.log(result.schema);
+console.log('\n=== Generated Types File ===');
+console.log(result.types);
+// Example output structure:
+//
+// Schema file includes:
+// - Mongoose imports
+// - Schema definitions with validators
+// - Virtual relationships
+// - Indexes
+// - Model exports
+//
+// Types file includes:
+// - TypeScript interfaces extending Document
+// - Proper typing for all fields
+// - Relationship types
+// - Timestamp fields (createdAt, updatedAt)

package/dist/codedna/__tests__/fixtures/typeorm-production-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/codedna/__tests__/fixtures/typeorm-production-test.js

@@ -0,0 +1,231 @@
+import { generateTypeORMEntities } from '../../kappa-typeorm-generator.js';
+const loc = {
+    startLine: 1,
+    startColumn: 1,
+    endLine: 1,
+    endColumn: 1,
+    startOffset: 0,
+    endOffset: 0,
+};
+function createEntity(name, overrides = {}) {
+    return {
+        kind: 'EntityBlock',
+        name,
+        loc,
+        fields: [],
+        relationships: [],
+        capabilities: [],
+        lifecycleHooks: [],
+        indexes: [],
+        ...overrides,
+    };
+}
+// Comprehensive production test covering all major TypeORM features
+const entities = [
+    createEntity('User', {
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'email',
+                loc,
+                type: { kind: 'primitive', type: 'email' },
+                modifiers: ['unique'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'firstName',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 1, max: 100 } },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'lastName',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 1, max: 100 } },
+                modifiers: ['optional'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'age',
+                loc,
+                type: { kind: 'primitive', type: 'int' },
+                modifiers: ['optional'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'role',
+                loc,
+                type: { kind: 'enum', values: ['admin', 'user', 'moderator'] },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'settings',
+                loc,
+                type: { kind: 'primitive', type: 'json' },
+                modifiers: [],
+            },
+        ],
+        indexes: [
+            {
+                kind: 'EntityIndex',
+                fields: ['email'],
+                unique: true,
+                loc,
+            },
+        ],
+        relationships: [
+            {
+                kind: 'EntityRelationship',
+                type: 'has_many',
+                entity: 'Post',
+                loc,
+            },
+        ],
+    }),
+    createEntity('Post', {
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'title',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 1, max: 200 } },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'content',
+                loc,
+                type: { kind: 'primitive', type: 'markdown' },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'published',
+                loc,
+                type: { kind: 'primitive', type: 'bool' },
+                modifiers: [],
+                defaultValue: 'false',
+            },
+            {
+                kind: 'EntityField',
+                name: 'publishedAt',
+                loc,
+                type: { kind: 'primitive', type: 'timestamp' },
+                modifiers: ['optional'],
+            },
+        ],
+        relationships: [
+            {
+                kind: 'EntityRelationship',
+                type: 'belongs_to',
+                entity: 'User',
+                as: 'author',
+                cascade: 'delete',
+                loc,
+            },
+            {
+                kind: 'EntityRelationship',
+                type: 'has_many',
+                entity: 'Tag',
+                through: 'PostTag',
+                loc,
+            },
+        ],
+    }),
+    createEntity('Tag', {
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'int' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'name',
+                loc,
+                type: { kind: 'primitive', type: 'string', range: { min: 1, max: 50 } },
+                modifiers: ['unique'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'slug',
+                loc,
+                type: { kind: 'primitive', type: 'slug' },
+                modifiers: ['unique'],
+            },
+        ],
+    }),
+];
+console.log('=== Testing PostgreSQL Dialect ===\n');
+const pgResult = generateTypeORMEntities(entities, { dialect: 'postgres', migrations: true });
+console.log('User Entity (PostgreSQL):');
+console.log(pgResult.entities.User);
+console.log('\n---\n');
+console.log('Post Entity (PostgreSQL):');
+console.log(pgResult.entities.Post);
+console.log('\n---\n');
+console.log('Tag Entity (PostgreSQL):');
+console.log(pgResult.entities.Tag);
+console.log('\n---\n');
+console.log('Migration (PostgreSQL):');
+console.log(pgResult.migration);
+console.log('\n\n=== Testing MySQL Dialect ===\n');
+const mysqlResult = generateTypeORMEntities(entities, { dialect: 'mysql', migrations: true });
+console.log('User Entity (MySQL - excerpt):');
+console.log(mysqlResult.entities.User.split('\n').slice(0, 25).join('\n'));
+console.log('\n---\n');
+console.log('Post FK Column (MySQL):');
+const postLines = mysqlResult.entities.Post.split('\n');
+const fkLineIndex = postLines.findIndex(line => line.includes('userId'));
+console.log(postLines.slice(Math.max(0, fkLineIndex - 1), fkLineIndex + 2).join('\n'));
+console.log('\n\n=== Production Readiness Checks ===\n');
+// Verify key features
+const checks = [
+    ['PostgreSQL UUID FK type', pgResult.entities.Post.includes("type: 'uuid'")],
+    ['MySQL varchar FK type', mysqlResult.entities.Post.includes("type: 'varchar', length: 36")],
+    ['Enum with length', pgResult.entities.User.includes("type: 'varchar', length: 50")],
+    ['Proper decorator syntax', pgResult.entities.User.includes('@PrimaryGeneratedColumn("uuid")')],
+    ['Snake case table names', pgResult.entities.User.includes("@Entity('user')")],
+    ['Snake case column names', pgResult.entities.User.includes("name: 'first_name'")],
+    ['Nullable columns', pgResult.entities.User.includes('lastName?: string')],
+    ['Unique indexes', pgResult.entities.User.includes('@Index(["email"], { unique: true })')],
+    ['ManyToOne relationship', pgResult.entities.Post.includes('@ManyToOne(() => User')],
+    ['ManyToMany relationship', pgResult.entities.Post.includes('@ManyToMany(() => Tag')],
+    ['Cascade delete', pgResult.entities.Post.includes('onDelete: "CASCADE"')],
+    ['Migration SQL', pgResult.migration?.includes('CREATE TABLE') ?? false],
+    ['Data source config', pgResult.dataSource.includes('AppDataSource')],
+];
+let passed = 0;
+let failed = 0;
+checks.forEach(([check, result]) => {
+    if (result) {
+        console.log(`✓ ${check}`);
+        passed++;
+    }
+    else {
+        console.log(`✗ ${check}`);
+        failed++;
+    }
+});
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0) {
+    process.exit(1);
+}

package/dist/codedna/__tests__/fixtures/typeorm-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/codedna/__tests__/fixtures/typeorm-test.js

@@ -0,0 +1,124 @@
+import { generateTypeORMEntities } from '../../kappa-typeorm-generator.js';
+const loc = {
+    startLine: 1,
+    startColumn: 1,
+    endLine: 1,
+    endColumn: 1,
+    startOffset: 0,
+    endOffset: 0,
+};
+function createEntity(name, overrides = {}) {
+    return {
+        kind: 'EntityBlock',
+        name,
+        loc,
+        fields: [],
+        relationships: [],
+        capabilities: [],
+        lifecycleHooks: [],
+        indexes: [],
+        ...overrides,
+    };
+}
+const entities = [
+    createEntity('User', {
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'email',
+                loc,
+                type: { kind: 'primitive', type: 'email' },
+                modifiers: ['unique'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'name',
+                loc,
+                type: { kind: 'primitive', type: 'string' },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'age',
+                loc,
+                type: { kind: 'primitive', type: 'int' },
+                modifiers: ['optional'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'role',
+                loc,
+                type: { kind: 'enum', values: ['admin', 'user', 'moderator'] },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'status',
+                loc,
+                type: { kind: 'enum', values: ['active', 'inactive', 'suspended'] },
+                modifiers: ['optional'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'metadata',
+                loc,
+                type: { kind: 'primitive', type: 'json' },
+                modifiers: [],
+            },
+        ],
+    }),
+    createEntity('Post', {
+        fields: [
+            {
+                kind: 'EntityField',
+                name: 'id',
+                loc,
+                type: { kind: 'primitive', type: 'uuid' },
+                modifiers: ['primary', 'auto'],
+            },
+            {
+                kind: 'EntityField',
+                name: 'title',
+                loc,
+                type: { kind: 'primitive', type: 'string' },
+                modifiers: [],
+            },
+            {
+                kind: 'EntityField',
+                name: 'published',
+                loc,
+                type: { kind: 'primitive', type: 'bool' },
+                modifiers: [],
+            },
+        ],
+        relationships: [
+            {
+                kind: 'EntityRelationship',
+                type: 'belongs_to',
+                entity: 'User',
+                cascade: 'delete',
+                loc,
+            },
+        ],
+    }),
+];
+const result = generateTypeORMEntities(entities);
+console.log('=== User Entity ===');
+console.log(result.entities.User);
+console.log('\n=== Post Entity ===');
+console.log(result.entities.Post);
+console.log('\n=== Tag Entity ===');
+console.log(result.entities.Tag);
+console.log('\n=== Data Source ===');
+console.log(result.dataSource);
+if (result.migration) {
+    console.log('\n=== Migration ===');
+    console.log(result.migration);
+}

package/dist/codedna/__tests__/laravel-output-review.d.ts

@@ -0,0 +1 @@
+export {};