@famgia/omnify-cli 0.0.24 → 0.0.26

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync5 } from "fs";
-import { resolve as resolve7 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { resolve as resolve8 } from "path";
 import { Command } from "commander";
 import { OmnifyError as OmnifyError5 } from "@famgia/omnify-core";
 
@@ -670,8 +670,8 @@ function registerDiffCommand(program2) {
 }
 
 // src/commands/generate.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { resolve as resolve5, dirname as dirname4 } from "path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import { resolve as resolve6, dirname as dirname4 } from "path";
 import {
   loadSchemas as loadSchemas3,
   validateSchemas as validateSchemas3,
@@ -694,6 +694,481 @@ import {
   getModelPath
 } from "@famgia/omnify-laravel";
 import { generateTypeScript } from "@famgia/omnify-typescript";
+
+// src/guides/index.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve5 } from "path";
+var CLAUDE_MD = `## Omnify
+
+This project uses Omnify for schema-driven code generation.
+
+**Documentation**: \`.claude/omnify/\`
+- \`schema-guide.md\` - Schema format and property types
+- \`laravel-guide.md\` - Laravel generator (if installed)
+- \`typescript-guide.md\` - TypeScript generator (if installed)
+- \`japan-guide.md\` - Japan plugin types (if installed)
+
+**Commands**:
+- \`npx omnify generate\` - Generate code from schemas
+- \`npx omnify validate\` - Validate schemas
+`;
+var SCHEMA_GUIDE = `# Omnify Schema Guide
+
+## Schema File Format
+
+Schemas are YAML files defining data models. Each file represents one entity.
+
+\`\`\`yaml
+name: User
+displayName:
+  ja: \u30E6\u30FC\u30B6\u30FC
+  en: User
+kind: object
+
+properties:
+  email:
+    type: Email
+    unique: true
+  name:
+    type: String
+  bio:
+    type: Text
+    nullable: true
+
+options:
+  timestamps: true
+  softDelete: true
+\`\`\`
+
+## Property Types
+
+### String Types
+- \`String\` - VARCHAR(255)
+- \`Text\` - TEXT
+- \`LongText\` - LONGTEXT
+- \`Email\` - VARCHAR(255) for email addresses
+- \`Password\` - VARCHAR(255), hidden in serialization
+
+### Numeric Types
+- \`Int\` - INTEGER
+- \`BigInt\` - BIGINT
+- \`TinyInt\` - TINYINT
+- \`Float\` - DOUBLE
+- \`Decimal\` - DECIMAL(precision, scale)
+
+### Date/Time Types
+- \`Date\` - DATE
+- \`Time\` - TIME
+- \`DateTime\` - DATETIME
+- \`Timestamp\` - TIMESTAMP
+
+### Other Types
+- \`Boolean\` - BOOLEAN
+- \`Json\` - JSON
+- \`Enum\` - ENUM with values
+- \`EnumRef\` - Reference to enum schema
+
+## Property Options
+
+\`\`\`yaml
+propertyName:
+  type: String
+  nullable: true       # Can be NULL
+  unique: true         # Unique constraint
+  default: "value"     # Default value
+  length: 100          # VARCHAR length
+  hidden: true         # Hide from JSON output
+  fillable: false      # Exclude from mass assignment
+\`\`\`
+
+## Associations
+
+\`\`\`yaml
+# Many-to-One (belongsTo)
+author:
+  type: Association
+  relation: ManyToOne
+  target: User
+  onDelete: CASCADE
+
+# One-to-Many (hasMany)
+posts:
+  type: Association
+  relation: OneToMany
+  target: Post
+
+# Many-to-Many (belongsToMany)
+tags:
+  type: Association
+  relation: ManyToMany
+  target: Tag
+  joinTable: post_tags
+
+# Polymorphic
+commentable:
+  type: Association
+  relation: MorphTo
+\`\`\`
+
+## Indexes
+
+\`\`\`yaml
+indexes:
+  - columns: [status, published_at]
+  - columns: [email]
+    unique: true
+\`\`\`
+
+## Schema Options
+
+\`\`\`yaml
+options:
+  timestamps: true   # Add created_at, updated_at
+  softDelete: true   # Add deleted_at
+  idType: BigInt     # Primary key type (Int, BigInt, Uuid)
+\`\`\`
+`;
+var LARAVEL_GUIDE = `# Laravel Generator Guide
+
+## Generated Files
+
+### Migrations
+Located in \`database/migrations/omnify/\`
+- Auto-generated from schema changes
+- Handles column additions, modifications, removals
+- Preserves manual migrations outside omnify folder
+
+### Models
+Two-tier model structure:
+- \`app/Models/OmnifyBase/*BaseModel.php\` - Auto-generated, DO NOT EDIT
+- \`app/Models/*.php\` - User models, extend base models, safe to customize
+
+### Factories
+Located in \`database/factories/\`
+- Generated once, safe to customize
+- Uses appropriate Faker methods for each type
+
+## Model Features
+
+### Fillable
+All schema properties are mass-assignable by default.
+Use \`fillable: false\` to exclude.
+
+### Hidden
+Use \`hidden: true\` to exclude from JSON/array output.
+
+\`\`\`yaml
+password:
+  type: Password
+  hidden: true
+\`\`\`
+
+### Casts
+Auto-generated based on property types:
+- \`Boolean\` \u2192 \`'boolean'\`
+- \`Json\` \u2192 \`'array'\`
+- \`Timestamp\` \u2192 \`'datetime'\`
+
+### Relationships
+Generated from Association properties:
+- \`ManyToOne\` \u2192 \`belongsTo()\`
+- \`OneToMany\` \u2192 \`hasMany()\`
+- \`ManyToMany\` \u2192 \`belongsToMany()\`
+- \`MorphTo\` \u2192 \`morphTo()\`
+- \`MorphMany\` \u2192 \`morphMany()\`
+
+## Commands
+
+\`\`\`bash
+# Generate migrations and models
+npx omnify generate
+
+# Force regeneration
+npx omnify generate --force
+
+# Validate schemas
+npx omnify validate
+\`\`\`
+`;
+var TYPESCRIPT_GUIDE = `# TypeScript Generator Guide
+
+## Generated Types
+
+Types are generated in the configured output directory.
+
+### Interface Generation
+
+Each schema generates a TypeScript interface:
+
+\`\`\`typescript
+export interface User {
+  id: number;
+  email: string;
+  name: string;
+  bio: string | null;
+  created_at: string;
+  updated_at: string;
+}
+\`\`\`
+
+### Type Mappings
+
+| Omnify Type | TypeScript Type |
+|-------------|-----------------|
+| String, Text | string |
+| Int, BigInt | number |
+| Float, Decimal | number |
+| Boolean | boolean |
+| Date, DateTime | string |
+| Json | Record<string, unknown> |
+| Enum | union of literals |
+
+### Nullable Types
+
+Nullable properties become \`T | null\`:
+
+\`\`\`typescript
+bio: string | null;
+\`\`\`
+
+### Associations
+
+Associations generate optional relation properties:
+
+\`\`\`typescript
+export interface Post {
+  id: number;
+  title: string;
+  author_id: number;
+  author?: User;       // Optional relation
+  comments?: Comment[]; // Optional array relation
+}
+\`\`\`
+`;
+var JAPAN_GUIDE = `# Japan Plugin Types Guide
+
+This project uses \`@famgia/omnify-japan\` plugin which provides Japan-specific types.
+
+## Available Types
+
+### Simple Types
+
+#### JapanPhone
+Japanese phone number format (e.g., \`090-1234-5678\`, \`03-1234-5678\`)
+- SQL: \`VARCHAR(15)\`
+- Accepts with or without hyphens
+
+\`\`\`yaml
+phone:
+  type: JapanPhone
+\`\`\`
+
+#### JapanPostalCode
+Japanese postal code format (e.g., \`123-4567\`)
+- SQL: \`VARCHAR(8)\`
+- Accepts with or without hyphen
+
+\`\`\`yaml
+postal_code:
+  type: JapanPostalCode
+  nullable: true
+\`\`\`
+
+### Compound Types
+
+Compound types expand into multiple database columns automatically.
+
+#### JapanName
+Japanese name with kanji and kana variants.
+
+**Expands to 4 columns:**
+- \`{property}_lastname\` - VARCHAR(50) - Family name (\u59D3)
+- \`{property}_firstname\` - VARCHAR(50) - Given name (\u540D)
+- \`{property}_kana_lastname\` - VARCHAR(100) - Family name in katakana
+- \`{property}_kana_firstname\` - VARCHAR(100) - Given name in katakana
+
+**Accessors generated:**
+- \`{property}_full_name\` - "\u59D3 \u540D" (space-separated)
+- \`{property}_full_name_kana\` - "\u30BB\u30A4 \u30E1\u30A4" (space-separated)
+
+\`\`\`yaml
+name:
+  type: JapanName
+  displayName:
+    ja: \u6C0F\u540D
+    en: Full Name
+  # Per-field overrides
+  fields:
+    KanaLastname:
+      nullable: true
+      hidden: true
+    KanaFirstname:
+      nullable: true
+      hidden: true
+\`\`\`
+
+#### JapanAddress
+Japanese address with postal code and prefecture ID.
+
+**Expands to 5 columns:**
+- \`{property}_postal_code\` - VARCHAR(8) - Postal code (\u90F5\u4FBF\u756A\u53F7)
+- \`{property}_prefecture_id\` - TINYINT UNSIGNED - Prefecture ID 1-47 (\u90FD\u9053\u5E9C\u770C)
+- \`{property}_address1\` - VARCHAR(255) - City/Ward (\u5E02\u533A\u753A\u6751)
+- \`{property}_address2\` - VARCHAR(255) - Street address (\u4E01\u76EE\u756A\u5730\u53F7)
+- \`{property}_address3\` - VARCHAR(255) NULLABLE - Building name (\u30D3\u30EB\u30FB\u30DE\u30F3\u30B7\u30E7\u30F3\u540D)
+
+**Accessors generated:**
+- \`{property}_full_address\` - Concatenation of address1 + address2 + address3
+
+\`\`\`yaml
+address:
+  type: JapanAddress
+  displayName:
+    ja: \u4F4F\u6240
+    en: Address
+  fields:
+    Address3:
+      nullable: true
+\`\`\`
+
+**Prefecture IDs (JIS X 0401):**
+| ID | Prefecture | ID | Prefecture | ID | Prefecture |
+|----|-----------|----|-----------|----|-----------|
+| 1 | \u5317\u6D77\u9053 | 17 | \u77F3\u5DDD\u770C | 33 | \u5CA1\u5C71\u770C |
+| 2 | \u9752\u68EE\u770C | 18 | \u798F\u4E95\u770C | 34 | \u5E83\u5CF6\u770C |
+| 3 | \u5CA9\u624B\u770C | 19 | \u5C71\u68A8\u770C | 35 | \u5C71\u53E3\u770C |
+| 4 | \u5BAE\u57CE\u770C | 20 | \u9577\u91CE\u770C | 36 | \u5FB3\u5CF6\u770C |
+| 5 | \u79CB\u7530\u770C | 21 | \u5C90\u961C\u770C | 37 | \u9999\u5DDD\u770C |
+| 6 | \u5C71\u5F62\u770C | 22 | \u9759\u5CA1\u770C | 38 | \u611B\u5A9B\u770C |
+| 7 | \u798F\u5CF6\u770C | 23 | \u611B\u77E5\u770C | 39 | \u9AD8\u77E5\u770C |
+| 8 | \u8328\u57CE\u770C | 24 | \u4E09\u91CD\u770C | 40 | \u798F\u5CA1\u770C |
+| 9 | \u6803\u6728\u770C | 25 | \u6ECB\u8CC0\u770C | 41 | \u4F50\u8CC0\u770C |
+| 10 | \u7FA4\u99AC\u770C | 26 | \u4EAC\u90FD\u5E9C | 42 | \u9577\u5D0E\u770C |
+| 11 | \u57FC\u7389\u770C | 27 | \u5927\u962A\u5E9C | 43 | \u718A\u672C\u770C |
+| 12 | \u5343\u8449\u770C | 28 | \u5175\u5EAB\u770C | 44 | \u5927\u5206\u770C |
+| 13 | \u6771\u4EAC\u90FD | 29 | \u5948\u826F\u770C | 45 | \u5BAE\u5D0E\u770C |
+| 14 | \u795E\u5948\u5DDD\u770C | 30 | \u548C\u6B4C\u5C71\u770C | 46 | \u9E7F\u5150\u5CF6\u770C |
+| 15 | \u65B0\u6F5F\u770C | 31 | \u9CE5\u53D6\u770C | 47 | \u6C96\u7E04\u770C |
+| 16 | \u5BCC\u5C71\u770C | 32 | \u5CF6\u6839\u770C | | |
+
+#### JapanBankAccount
+Japanese bank account information.
+
+**Expands to 5 columns:**
+- \`{property}_bank_code\` - VARCHAR(4) - Bank code (\u9280\u884C\u30B3\u30FC\u30C9)
+- \`{property}_branch_code\` - VARCHAR(3) - Branch code (\u652F\u5E97\u30B3\u30FC\u30C9)
+- \`{property}_account_type\` - ENUM - Account type: 1=\u666E\u901A, 2=\u5F53\u5EA7, 4=\u8CAF\u84C4
+- \`{property}_account_number\` - VARCHAR(7) - Account number (\u53E3\u5EA7\u756A\u53F7)
+- \`{property}_account_holder\` - VARCHAR(100) - Account holder name (\u53E3\u5EA7\u540D\u7FA9)
+
+\`\`\`yaml
+bank_account:
+  type: JapanBankAccount
+\`\`\`
+
+## Per-field Overrides
+
+All compound types support per-field overrides:
+
+\`\`\`yaml
+name:
+  type: JapanName
+  fields:
+    KanaLastname:
+      nullable: true
+      hidden: true
+    KanaFirstname:
+      nullable: true
+      hidden: true
+\`\`\`
+
+**Available overrides:**
+- \`nullable\` - Whether the field can be NULL
+- \`hidden\` - Exclude from JSON/array output
+- \`fillable\` - Control mass assignment
+
+## Factory Examples
+
+\`\`\`php
+$faker = fake('ja_JP');
+
+return [
+    // JapanName
+    'name_lastname' => $faker->lastName(),
+    'name_firstname' => $faker->firstName(),
+    'name_kana_lastname' => $faker->lastKanaName(),
+    'name_kana_firstname' => $faker->firstKanaName(),
+
+    // JapanPhone
+    'phone' => $faker->phoneNumber(),
+
+    // JapanPostalCode
+    'postal_code' => $faker->postcode(),
+
+    // JapanAddress
+    'address_postal_code' => $faker->postcode(),
+    'address_prefecture_id' => $faker->numberBetween(1, 47),
+    'address_address1' => $faker->city(),
+    'address_address2' => $faker->streetAddress(),
+    'address_address3' => $faker->optional(0.5)->secondaryAddress(),
+];
+\`\`\`
+
+## Model Accessors
+
+\`\`\`php
+// JapanName accessors
+$customer->name_full_name;      // "\u7530\u4E2D \u592A\u90CE"
+$customer->name_full_name_kana; // "\u30BF\u30CA\u30AB \u30BF\u30ED\u30A6"
+
+// JapanAddress accessor
+$customer->address_full_address; // "\u5343\u4EE3\u7530\u533A\u4E38\u306E\u51851-1-1\u30D3\u30EB5F"
+\`\`\`
+`;
+function isJapanPlugin(plugin) {
+  return plugin.name === "@famgia/omnify-japan";
+}
+function isLaravelPlugin(plugin) {
+  return plugin.name === "@famgia/omnify-laravel";
+}
+function isTypeScriptPlugin(plugin) {
+  return plugin.name === "@famgia/omnify-typescript";
+}
+function generateAIGuides(rootDir, plugins) {
+  const guidesDir = resolve5(rootDir, ".claude/omnify");
+  let filesWritten = 0;
+  if (!existsSync3(guidesDir)) {
+    mkdirSync2(guidesDir, { recursive: true });
+  }
+  const claudeMdPath = resolve5(rootDir, "CLAUDE.md");
+  if (!existsSync3(claudeMdPath)) {
+    writeFileSync2(claudeMdPath, CLAUDE_MD);
+    filesWritten++;
+  }
+  const schemaGuidePath = resolve5(guidesDir, "schema-guide.md");
+  writeFileSync2(schemaGuidePath, SCHEMA_GUIDE);
+  filesWritten++;
+  for (const plugin of plugins) {
+    if (isLaravelPlugin(plugin)) {
+      const laravelGuidePath = resolve5(guidesDir, "laravel-guide.md");
+      writeFileSync2(laravelGuidePath, LARAVEL_GUIDE);
+      filesWritten++;
+    }
+    if (isTypeScriptPlugin(plugin)) {
+      const tsGuidePath = resolve5(guidesDir, "typescript-guide.md");
+      writeFileSync2(tsGuidePath, TYPESCRIPT_GUIDE);
+      filesWritten++;
+    }
+    if (isJapanPlugin(plugin)) {
+      const japanGuidePath = resolve5(guidesDir, "japan-guide.md");
+      writeFileSync2(japanGuidePath, JAPAN_GUIDE);
+      filesWritten++;
+    }
+  }
+  return filesWritten;
+}
+
+// src/commands/generate.ts
 function hasPluginGenerators(plugins) {
   return plugins.some((p) => p.generators && p.generators.length > 0);
 }
@@ -763,7 +1238,12 @@ function propertyToVersionSnapshot(prop) {
     ...prop.mappedBy !== void 0 && { mappedBy: prop.mappedBy },
     ...prop.inversedBy !== void 0 && { inversedBy: prop.inversedBy },
     ...prop.joinTable !== void 0 && { joinTable: prop.joinTable },
-    ...prop.owning !== void 0 && { owning: prop.owning }
+    ...prop.owning !== void 0 && { owning: prop.owning },
+    // Laravel-specific properties
+    ...prop.hidden !== void 0 && { hidden: prop.hidden },
+    ...prop.fillable !== void 0 && { fillable: prop.fillable },
+    // Per-field overrides for compound types
+    ...prop.fields !== void 0 && { fields: prop.fields }
   };
 }
 function schemasToVersionSnapshot(schemas) {
@@ -869,17 +1349,17 @@ function schemaChangeToVersionChange(change) {
 function writeGeneratorOutputs(outputs, rootDir) {
   const counts = { migrations: 0, types: 0, models: 0, factories: 0, other: 0 };
   for (const output of outputs) {
-    const filePath = resolve5(rootDir, output.path);
+    const filePath = resolve6(rootDir, output.path);
     const dir = dirname4(filePath);
-    if (!existsSync3(dir)) {
-      mkdirSync2(dir, { recursive: true });
+    if (!existsSync4(dir)) {
+      mkdirSync3(dir, { recursive: true });
       logger.debug(`Created directory: ${dir}`);
     }
-    if (output.skipIfExists && existsSync3(filePath)) {
+    if (output.skipIfExists && existsSync4(filePath)) {
       logger.debug(`Skipped (exists): ${output.path}`);
       continue;
     }
-    writeFileSync2(filePath, output.content);
+    writeFileSync3(filePath, output.content);
     logger.debug(`Created: ${output.path}`);
     if (output.type === "migration") counts.migrations++;
     else if (output.type === "type") counts.types++;
@@ -918,9 +1398,9 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
   let modelsGenerated = 0;
   if (!options.typesOnly && config.output.laravel) {
     logger.step("Generating Laravel migrations...");
-    const migrationsDir = resolve5(rootDir, config.output.laravel.migrationsPath);
-    if (!existsSync3(migrationsDir)) {
-      mkdirSync2(migrationsDir, { recursive: true });
+    const migrationsDir = resolve6(rootDir, config.output.laravel.migrationsPath);
+    if (!existsSync4(migrationsDir)) {
+      mkdirSync3(migrationsDir, { recursive: true });
       logger.debug(`Created directory: ${migrationsDir}`);
     }
     const addedSchemaNames = new Set(
@@ -935,8 +1415,8 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
       );
       const createMigrations = generateMigrations(addedSchemas);
       for (const migration of createMigrations) {
-        const filePath = resolve5(migrationsDir, migration.fileName);
-        writeFileSync2(filePath, migration.content);
+        const filePath = resolve6(migrationsDir, migration.fileName);
+        writeFileSync3(filePath, migration.content);
         logger.debug(`Created: ${migration.fileName}`);
         migrationsGenerated++;
       }
@@ -944,8 +1424,8 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
     if (alterChanges.length > 0) {
       const alterMigrations = generateMigrationsFromChanges(alterChanges);
       for (const migration of alterMigrations) {
-        const filePath = resolve5(migrationsDir, migration.fileName);
-        writeFileSync2(filePath, migration.content);
+        const filePath = resolve6(migrationsDir, migration.fileName);
+        writeFileSync3(filePath, migration.content);
         logger.debug(`Created: ${migration.fileName}`);
         migrationsGenerated++;
       }
@@ -956,29 +1436,29 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
     logger.step("Generating Laravel models...");
     const modelsPath = config.output.laravel.modelsPath;
     const baseModelsPath = config.output.laravel.baseModelsPath ?? `${modelsPath}/OmnifyBase`;
-    const modelsDir = resolve5(rootDir, modelsPath);
-    const baseModelsDir = resolve5(rootDir, baseModelsPath);
-    if (!existsSync3(modelsDir)) {
-      mkdirSync2(modelsDir, { recursive: true });
+    const modelsDir = resolve6(rootDir, modelsPath);
+    const baseModelsDir = resolve6(rootDir, baseModelsPath);
+    if (!existsSync4(modelsDir)) {
+      mkdirSync3(modelsDir, { recursive: true });
     }
-    if (!existsSync3(baseModelsDir)) {
-      mkdirSync2(baseModelsDir, { recursive: true });
+    if (!existsSync4(baseModelsDir)) {
+      mkdirSync3(baseModelsDir, { recursive: true });
     }
     const models = generateModels(schemas, {
       modelPath: modelsPath,
       baseModelPath: baseModelsPath
     });
     for (const model of models) {
-      const filePath = resolve5(rootDir, getModelPath(model));
+      const filePath = resolve6(rootDir, getModelPath(model));
       const fileDir = dirname4(filePath);
-      if (!existsSync3(fileDir)) {
-        mkdirSync2(fileDir, { recursive: true });
+      if (!existsSync4(fileDir)) {
+        mkdirSync3(fileDir, { recursive: true });
       }
-      if (!model.overwrite && existsSync3(filePath)) {
+      if (!model.overwrite && existsSync4(filePath)) {
         logger.debug(`Skipped (exists): ${getModelPath(model)}`);
         continue;
       }
-      writeFileSync2(filePath, model.content);
+      writeFileSync3(filePath, model.content);
       logger.debug(`Created: ${getModelPath(model)}`);
       modelsGenerated++;
     }
@@ -986,23 +1466,23 @@ function runDirectGeneration(schemas, config, rootDir, options, changes) {
   }
   if (!options.migrationsOnly && config.output.typescript) {
     logger.step("Generating TypeScript types...");
-    const typesDir = resolve5(rootDir, config.output.typescript.path);
-    if (!existsSync3(typesDir)) {
-      mkdirSync2(typesDir, { recursive: true });
+    const typesDir = resolve6(rootDir, config.output.typescript.path);
+    if (!existsSync4(typesDir)) {
+      mkdirSync3(typesDir, { recursive: true });
       logger.debug(`Created directory: ${typesDir}`);
     }
     const typeFiles = generateTypeScript(schemas);
     for (const file of typeFiles) {
-      const filePath = resolve5(typesDir, file.filePath);
+      const filePath = resolve6(typesDir, file.filePath);
       const fileDir = dirname4(filePath);
-      if (!existsSync3(fileDir)) {
-        mkdirSync2(fileDir, { recursive: true });
+      if (!existsSync4(fileDir)) {
+        mkdirSync3(fileDir, { recursive: true });
       }
-      if (!file.overwrite && existsSync3(filePath)) {
+      if (!file.overwrite && existsSync4(filePath)) {
         logger.debug(`Skipped (exists): ${file.filePath}`);
         continue;
       }
-      writeFileSync2(filePath, file.content);
+      writeFileSync3(filePath, file.content);
       logger.debug(`Created: ${file.filePath}`);
       typesGenerated++;
     }
@@ -1017,7 +1497,7 @@ async function runGenerate(options) {
   const { config, configPath: configPath2 } = await loadConfig();
   const rootDir = configPath2 ? dirname4(configPath2) : process.cwd();
   validateConfig(config, rootDir);
-  const schemaPath = resolve5(rootDir, config.schemasDir);
+  const schemaPath = resolve6(rootDir, config.schemasDir);
   logger.step(`Loading schemas from ${schemaPath}`);
   const schemas = await loadSchemas3(schemaPath);
   const schemaCount = Object.keys(schemas).length;
@@ -1047,7 +1527,7 @@ async function runGenerate(options) {
     process.exit(2);
   }
   logger.step("Checking for changes...");
-  const lockPath = resolve5(rootDir, config.lockFilePath);
+  const lockPath = resolve6(rootDir, config.lockFilePath);
   const existingLock = await readLockFile(lockPath);
   const currentSnapshots = await buildSchemaSnapshots(schemas);
   const v2Lock = existingLock && isLockFileV2(existingLock) ? existingLock : null;
@@ -1121,6 +1601,14 @@ async function runGenerate(options) {
   } catch (versionError) {
     logger.debug(`Could not save version history: ${versionError.message}`);
   }
+  try {
+    const guidesWritten = generateAIGuides(rootDir, config.plugins);
+    if (guidesWritten > 0) {
+      logger.debug(`Updated ${guidesWritten} AI guide file(s)`);
+    }
+  } catch (guideError) {
+    logger.debug(`Could not generate AI guides: ${guideError.message}`);
+  }
   logger.newline();
   logger.success("Generation complete!");
   if (migrationsGenerated > 0 && config.output.laravel) {
@@ -1151,23 +1639,23 @@ function registerGenerateCommand(program2) {
 }
 
 // src/commands/reset.ts
-import { existsSync as existsSync4, readdirSync, rmSync, statSync } from "fs";
-import { resolve as resolve6, dirname as dirname5, join } from "path";
+import { existsSync as existsSync5, readdirSync, rmSync, statSync } from "fs";
+import { resolve as resolve7, dirname as dirname5, join } from "path";
 import { createInterface } from "readline";
 async function confirm2(message) {
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     rl.question(`${message} (y/N) `, (answer) => {
       rl.close();
-      resolve8(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve9(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
 function countFiles(dir) {
-  if (!existsSync4(dir)) return 0;
+  if (!existsSync5(dir)) return 0;
   let count = 0;
   const entries = readdirSync(dir);
   for (const entry of entries) {
@@ -1182,7 +1670,7 @@ function countFiles(dir) {
   return count;
 }
 function deleteDir(dir, verbose) {
-  if (!existsSync4(dir)) return 0;
+  if (!existsSync5(dir)) return 0;
   const count = countFiles(dir);
   rmSync(dir, { recursive: true, force: true });
   if (verbose) {
@@ -1191,7 +1679,7 @@ function deleteDir(dir, verbose) {
   return count;
 }
 function deleteFilesInDir(dir, pattern, verbose) {
-  if (!existsSync4(dir)) return 0;
+  if (!existsSync5(dir)) return 0;
   let count = 0;
   const entries = readdirSync(dir);
   for (const entry of entries) {
@@ -1220,8 +1708,8 @@ async function runReset(options) {
     "src/Models/OmnifyBase"
   ];
   for (const relPath of omnifyBasePaths) {
-    const omnifyBasePath = resolve6(rootDir, relPath);
-    if (existsSync4(omnifyBasePath)) {
+    const omnifyBasePath = resolve7(rootDir, relPath);
+    if (existsSync5(omnifyBasePath)) {
       paths.push({ name: "OmnifyBase models", path: omnifyBasePath, type: "dir" });
       break;
     }
@@ -1231,8 +1719,8 @@ async function runReset(options) {
     "backend/database/migrations/omnify"
   ];
   for (const relPath of migrationPaths) {
-    const migrationsPath = resolve6(rootDir, relPath);
-    if (existsSync4(migrationsPath)) {
+    const migrationsPath = resolve7(rootDir, relPath);
+    if (existsSync5(migrationsPath)) {
       paths.push({
         name: "Omnify migrations",
         path: migrationsPath,
@@ -1244,15 +1732,15 @@ async function runReset(options) {
   }
   const laravelConfig = config.output.laravel;
   if (laravelConfig?.modelsPath) {
-    const modelsPath = resolve6(rootDir, laravelConfig.modelsPath);
+    const modelsPath = resolve7(rootDir, laravelConfig.modelsPath);
     const omnifyBasePath = join(modelsPath, "OmnifyBase");
-    if (existsSync4(omnifyBasePath) && !paths.some((p) => p.path === omnifyBasePath)) {
+    if (existsSync5(omnifyBasePath) && !paths.some((p) => p.path === omnifyBasePath)) {
       paths.push({ name: "OmnifyBase models", path: omnifyBasePath, type: "dir" });
     }
   }
   if (laravelConfig?.migrationsPath) {
-    const migrationsPath = resolve6(rootDir, laravelConfig.migrationsPath);
-    if (existsSync4(migrationsPath) && !paths.some((p) => p.path === migrationsPath)) {
+    const migrationsPath = resolve7(rootDir, laravelConfig.migrationsPath);
+    if (existsSync5(migrationsPath) && !paths.some((p) => p.path === migrationsPath)) {
       paths.push({
         name: "Omnify migrations",
         path: migrationsPath,
@@ -1261,12 +1749,12 @@ async function runReset(options) {
       });
     }
   }
-  const lockFilePath = resolve6(rootDir, config.lockFilePath);
-  if (existsSync4(lockFilePath)) {
+  const lockFilePath = resolve7(rootDir, config.lockFilePath);
+  if (existsSync5(lockFilePath)) {
     paths.push({ name: "Lock file", path: lockFilePath, type: "file" });
   }
-  const omnifyDir = resolve6(rootDir, ".omnify");
-  if (existsSync4(omnifyDir)) {
+  const omnifyDir = resolve7(rootDir, ".omnify");
+  if (existsSync5(omnifyDir)) {
     paths.push({ name: ".omnify directory", path: omnifyDir, type: "dir" });
   }
   if (paths.length === 0) {
@@ -1367,8 +1855,8 @@ process.on("unhandledRejection", (reason) => {
 var args = process.argv.slice(2);
 var firstArg = args[0];
 var hasCommand = firstArg !== void 0 && !firstArg.startsWith("-");
-var configPath = resolve7(process.cwd(), "omnify.config.ts");
-var hasConfig = existsSync5(configPath);
+var configPath = resolve8(process.cwd(), "omnify.config.ts");
+var hasConfig = existsSync6(configPath);
 if (!hasCommand && !hasConfig) {
   runInit({}).catch((error) => {
     if (error instanceof Error) {