@famgia/omnify-cli 0.0.25 → 0.0.27

package/dist/index.js

@@ -663,8 +663,8 @@ function registerDiffCommand(program) {
 }
 
 // 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,
@@ -687,6 +687,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);
 }
@@ -867,17 +1342,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++;
@@ -916,9 +1391,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(
@@ -933,8 +1408,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++;
       }
@@ -942,8 +1417,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++;
       }
@@ -954,29 +1429,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++;
     }
@@ -984,23 +1459,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++;
     }
@@ -1015,7 +1490,7 @@ async function runGenerate(options) {
   const { config, configPath } = await loadConfig();
   const rootDir = configPath ? dirname4(configPath) : 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;
@@ -1045,7 +1520,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;
@@ -1119,6 +1594,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) {