@famgia/omnify-cli 2.0.13 → 2.0.15

package/README.md

@@ -122,6 +122,58 @@ omnify generate --force
 omnify generate -v
 ```
 
+### `omnify ai-guides`
+
+Generate AI assistant guides (Cursor rules, Claude guides/rules, Antigravity rules).
+
+> This command loads `@famgia/omnify-ai-guides`. If it’s not installed, install it first:
+>
+> ```bash
+> pnpm add -D @famgia/omnify-ai-guides
+> ```
+
+```bash
+omnify ai-guides [options]
+```
+
+This command reads from `omnify.config.ts` (if present). Add `aiGuides` section:
+
+```typescript
+export default defineConfig({
+  // ... other config
+  aiGuides: {
+    typescriptBase: 'resources/ts',  // or 'resources/js', 'src', etc.
+    laravelBase: 'app',
+    categories: ['omnify', 'laravel', 'react'],  // optional
+    adapters: ['cursor', 'claude', 'antigravity'],  // optional
+  },
+});
+```
+
+Options (override config):
+
+```bash
+  -v, --verbose                  Enable verbose output
+  -c, --categories <categories>  Categories to generate (comma-separated: omnify,laravel,react)
+  -a, --adapters <adapters>      Adapters to use (comma-separated: cursor,claude,antigravity)
+  --laravel-base <path>          Laravel base path for placeholders
+  --typescript-base <path>       TypeScript base path for placeholders
+  --dry-run                      Show what would be generated without writing files
+```
+
+Common examples:
+
+```bash
+# API-only project (skip React)
+omnify ai-guides --categories omnify,laravel
+
+# Frontend-only (skip Laravel)
+omnify ai-guides --categories omnify,react
+
+# Only Cursor rules
+omnify ai-guides --adapters cursor
+```
+
 ### `omnify create-laravel-project`
 
 Create a new Laravel project from the boilerplate template.
@@ -187,13 +239,13 @@ export default defineConfig({
 
 ### Configuration Options
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `schemasDir` | `string` | Yes | Directory containing schema files |
-| `lockFilePath` | `string` | Yes | Path to lock file for change tracking |
-| `database.driver` | `string` | Yes | Database driver: `mysql`, `postgres`, `sqlite` |
-| `database.devUrl` | `string` | Yes* | Development database URL for Atlas (*required for generate) |
-| `plugins` | `Plugin[]` | No | Array of generator plugins |
+| Option            | Type       | Required | Description                                                 |
+| ----------------- | ---------- | -------- | ----------------------------------------------------------- |
+| `schemasDir`      | `string`   | Yes      | Directory containing schema files                           |
+| `lockFilePath`    | `string`   | Yes      | Path to lock file for change tracking                       |
+| `database.driver` | `string`   | Yes      | Database driver: `mysql`, `postgres`, `sqlite`              |
+| `database.devUrl` | `string`   | Yes*     | Development database URL for Atlas (*required for generate) |
+| `plugins`         | `Plugin[]` | No       | Array of generator plugins                                  |
 
 ### Database URL Format
 
@@ -301,18 +353,18 @@ values:
 
 ## Exit Codes
 
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Validation error |
+| Code | Meaning          |
+| ---- | ---------------- |
+| 0    | Success          |
+| 1    | General error    |
+| 2    | Validation error |
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
+| Variable         | Description                          |
+| ---------------- | ------------------------------------ |
 | `OMNIFY_DEV_URL` | Override database.devUrl from config |
-| `DEBUG` | Set to `omnify:*` for debug output |
+| `DEBUG`          | Set to `omnify:*` for debug output   |
 
 ## Troubleshooting
 

package/dist/cli.js

@@ -839,7 +839,8 @@ async function resolveConfig(userConfig, configPath2) {
     lockFilePath: userConfig.lockFilePath ?? ".omnify.lock",
     discovery,
     ...userConfig.locale && { locale: userConfig.locale },
-    ...allSchemaPaths.length > 0 && { additionalSchemaPaths: allSchemaPaths }
+    ...allSchemaPaths.length > 0 && { additionalSchemaPaths: allSchemaPaths },
+    ...userConfig.aiGuides && { aiGuides: userConfig.aiGuides }
   };
   return result;
 }
@@ -3252,6 +3253,110 @@ function registerVerifyCommand(program2) {
   });
 }
 
+// src/commands/ai-guides.ts
+async function runAIGuides(options) {
+  logger.setVerbose(options.verbose ?? false);
+  logger.header("Generating AI Guides");
+  let generateAIGuides2;
+  let getAvailableCategories;
+  try {
+    const aiGuidesModule = await import("@famgia/omnify-ai-guides");
+    generateAIGuides2 = aiGuidesModule.generateAIGuides;
+    getAvailableCategories = aiGuidesModule.getAvailableCategories;
+  } catch (error) {
+    logger.error("Failed to load @famgia/omnify-ai-guides package");
+    logger.error("Please install it: pnpm add @famgia/omnify-ai-guides");
+    throw error;
+  }
+  const rootDir = process.cwd();
+  let configAiGuides;
+  try {
+    const { config } = await loadConfig();
+    configAiGuides = config.aiGuides;
+    if (configAiGuides) {
+      logger.debug("Loaded aiGuides config from omnify.config.ts");
+    }
+  } catch {
+    logger.debug("No omnify.config.ts found, using defaults");
+  }
+  let categories = getAvailableCategories();
+  if (options.categories) {
+    categories = options.categories.split(",").map((c) => c.trim());
+    logger.debug(`Categories (from CLI): ${categories.join(", ")}`);
+  } else if (configAiGuides?.categories) {
+    categories = [...configAiGuides.categories];
+    logger.debug(`Categories (from config): ${categories.join(", ")}`);
+  }
+  let adapters;
+  if (options.adapters) {
+    adapters = options.adapters.split(",").map((a) => a.trim());
+    logger.debug(`Adapters (from CLI): ${adapters.join(", ")}`);
+  } else if (configAiGuides?.adapters) {
+    adapters = [...configAiGuides.adapters];
+    logger.debug(`Adapters (from config): ${adapters.join(", ")}`);
+  }
+  const placeholders = {
+    LARAVEL_BASE: options.laravelBase ?? configAiGuides?.laravelBase ?? "app",
+    LARAVEL_ROOT: "",
+    TYPESCRIPT_BASE: options.typescriptBase ?? configAiGuides?.typescriptBase ?? "resources/ts"
+  };
+  logger.step("Generating guides...");
+  logger.debug(`Root directory: ${rootDir}`);
+  logger.debug(`Laravel base: ${placeholders.LARAVEL_BASE}`);
+  logger.debug(`TypeScript base: ${placeholders.TYPESCRIPT_BASE}`);
+  logger.debug(`Categories: ${JSON.stringify(categories)}`);
+  logger.debug(`Adapters: ${JSON.stringify(adapters)}`);
+  const result = generateAIGuides2(rootDir, {
+    categories,
+    adapters,
+    placeholders,
+    dryRun: options.dryRun
+  });
+  const claudeCount = result.counts["claude"] || 0;
+  const cursorCount = result.counts["cursor"] || 0;
+  const antigravityCount = result.counts["antigravity"] || 0;
+  const totalCount = claudeCount + cursorCount + antigravityCount;
+  if (options.dryRun) {
+    logger.info("[DRY RUN] Would generate:");
+  }
+  if (claudeCount > 0) {
+    logger.success(`  ${claudeCount} Claude files (.claude/)`);
+  }
+  if (cursorCount > 0) {
+    logger.success(`  ${cursorCount} Cursor rules (.cursor/rules/)`);
+  }
+  if (antigravityCount > 0) {
+    logger.success(`  ${antigravityCount} Antigravity rules (.agent/rules/)`);
+  }
+  if (result.errors?.length) {
+    logger.newline();
+    logger.warn("Warnings:");
+    for (const error of result.errors) {
+      logger.warn(`  ${error}`);
+    }
+  }
+  logger.newline();
+  logger.success(`Generated ${totalCount} AI guide files!`);
+}
+function registerAIGuidesCommand(program2) {
+  program2.command("ai-guides").description("Generate AI assistant guides (Cursor, Claude, Antigravity). Reads from omnify.config.ts").option("-v, --verbose", "Enable verbose output").option(
+    "-c, --categories <categories>",
+    "Categories to generate (comma-separated: omnify,laravel,react). Overrides config"
+  ).option(
+    "-a, --adapters <adapters>",
+    "Adapters to use (comma-separated: cursor,claude,antigravity). Overrides config"
+  ).option("--laravel-base <path>", "Laravel base path for placeholders. Overrides config").option("--typescript-base <path>", "TypeScript base path for placeholders. Overrides config").option("--dry-run", "Show what would be generated without writing files").action(async (opts) => {
+    try {
+      await runAIGuides(opts);
+    } catch (error) {
+      if (error instanceof Error) {
+        logger.error(error.message);
+      }
+      process.exit(1);
+    }
+  });
+}
+
 // src/cli.ts
 var VERSION = "0.0.5";
 var program = new Command();
@@ -3264,6 +3369,7 @@ registerResetCommand(program);
 registerCreateProjectCommand(program);
 registerDeployCommand(program);
 registerVerifyCommand(program);
+registerAIGuidesCommand(program);
 process.on("uncaughtException", (error) => {
   if (error instanceof OmnifyError7) {
     logger.formatError(error);