@famgia/omnify-laravel 0.0.88 → 0.0.90

package/dist/index.d.cts

@@ -382,4 +382,51 @@ declare function generateFactories(schemas: SchemaCollection, options?: FactoryG
  */
 declare function getFactoryPath(factory: GeneratedFactory): string;
 
-export { type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, toColumnName, toTableName };
+/**
+ * AI Guides Generator
+ *
+ * Generates AI assistant guides (Claude, Cursor) for Laravel projects.
+ * Simply copies .stub files, removes .stub extension, and replaces placeholders.
+ */
+/**
+ * Options for AI guides generation
+ */
+interface AIGuidesOptions {
+    /**
+     * Laravel models path from config (e.g., 'app/Models')
+     * Used to extract the base path for glob replacement
+     */
+    modelsPath?: string;
+    /**
+     * Laravel migrations path from config
+     */
+    migrationsPath?: string;
+    /**
+     * Base path for Laravel files (default: extracted from modelsPath or 'app')
+     * Used for placeholder replacement in Cursor rules
+     */
+    laravelBasePath?: string;
+}
+/**
+ * Result of AI guides generation
+ */
+interface AIGuidesResult {
+    claudeGuides: number;
+    claudeRules: number;
+    claudeChecklists: number;
+    claudeWorkflows: number;
+    claudeAgents: number;
+    claudeOmnify: number;
+    cursorRules: number;
+    files: string[];
+}
+/**
+ * Generate AI guides for Claude and Cursor
+ */
+declare function generateAIGuides(rootDir: string, options?: AIGuidesOptions): AIGuidesResult;
+/**
+ * Check if AI guides need to be generated
+ */
+declare function shouldGenerateAIGuides(rootDir: string): boolean;
+
+export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };

package/dist/index.d.ts

@@ -382,4 +382,51 @@ declare function generateFactories(schemas: SchemaCollection, options?: FactoryG
  */
 declare function getFactoryPath(factory: GeneratedFactory): string;
 
-export { type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, toColumnName, toTableName };
+/**
+ * AI Guides Generator
+ *
+ * Generates AI assistant guides (Claude, Cursor) for Laravel projects.
+ * Simply copies .stub files, removes .stub extension, and replaces placeholders.
+ */
+/**
+ * Options for AI guides generation
+ */
+interface AIGuidesOptions {
+    /**
+     * Laravel models path from config (e.g., 'app/Models')
+     * Used to extract the base path for glob replacement
+     */
+    modelsPath?: string;
+    /**
+     * Laravel migrations path from config
+     */
+    migrationsPath?: string;
+    /**
+     * Base path for Laravel files (default: extracted from modelsPath or 'app')
+     * Used for placeholder replacement in Cursor rules
+     */
+    laravelBasePath?: string;
+}
+/**
+ * Result of AI guides generation
+ */
+interface AIGuidesResult {
+    claudeGuides: number;
+    claudeRules: number;
+    claudeChecklists: number;
+    claudeWorkflows: number;
+    claudeAgents: number;
+    claudeOmnify: number;
+    cursorRules: number;
+    files: string[];
+}
+/**
+ * Generate AI guides for Claude and Cursor
+ */
+declare function generateAIGuides(rootDir: string, options?: AIGuidesOptions): AIGuidesResult;
+/**
+ * Check if AI guides need to be generated
+ */
+declare function shouldGenerateAIGuides(rootDir: string): boolean;
+
+export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   formatForeignKey,
   formatIndex,
   formatMigrationFile,
+  generateAIGuides,
   generateAlterMigration,
   generateDropMigrationForTable,
   generateDropTableMigration,
@@ -22,14 +23,16 @@ import {
   laravelPlugin,
   propertyToColumnMethod,
   schemaToBlueprint,
+  shouldGenerateAIGuides,
   toColumnName,
   toTableName
-} from "./chunk-YVVAJA3T.js";
+} from "./chunk-2QSKZS63.js";
 export {
   formatColumnMethod,
   formatForeignKey,
   formatIndex,
   formatMigrationFile,
+  generateAIGuides,
   generateAlterMigration,
   generateDropMigrationForTable,
   generateDropTableMigration,
@@ -49,6 +52,7 @@ export {
   laravelPlugin,
   propertyToColumnMethod,
   schemaToBlueprint,
+  shouldGenerateAIGuides,
   toColumnName,
   toTableName
 };

package/dist/plugin.cjs

@@ -24,8 +24,8 @@ __export(plugin_exports, {
   laravelPlugin: () => laravelPlugin
 });
 module.exports = __toCommonJS(plugin_exports);
-var import_node_fs = require("fs");
-var import_node_path = require("path");
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
 
 // src/migration/schema-builder.ts
 var import_omnify_types = require("@famgia/omnify-types");
@@ -3896,6 +3896,162 @@ function getResourcePath(resource) {
   return resource.path;
 }
 
+// src/ai-guides/generator.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_meta = {};
+var __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
+var __dirname = (0, import_node_path.dirname)(__filename);
+function getStubsDir() {
+  const devPath = (0, import_node_path.resolve)(__dirname, "../../stubs/ai-guides");
+  if ((0, import_node_fs.existsSync)(devPath)) {
+    return devPath;
+  }
+  const distPath = (0, import_node_path.resolve)(__dirname, "../stubs/ai-guides");
+  if ((0, import_node_fs.existsSync)(distPath)) {
+    return distPath;
+  }
+  throw new Error("AI guides stubs not found");
+}
+function extractLaravelBasePath(modelsPath) {
+  if (!modelsPath) return "app";
+  const normalized = modelsPath.replace(/\\/g, "/");
+  const match = normalized.match(/^(.+?)\/Models(?:\/.*)?$/);
+  if (match && match[1]) {
+    return match[1];
+  }
+  const parts = normalized.split("/").filter(Boolean);
+  if (parts.length > 1) {
+    return parts.slice(0, -1).join("/");
+  }
+  return "app";
+}
+function replacePlaceholders(content, basePath) {
+  return content.replace(/\{\{LARAVEL_BASE\}\}/g, basePath);
+}
+function copyStubs(srcDir, destDir, transform) {
+  const writtenFiles = [];
+  if (!(0, import_node_fs.existsSync)(srcDir)) {
+    return writtenFiles;
+  }
+  if (!(0, import_node_fs.existsSync)(destDir)) {
+    (0, import_node_fs.mkdirSync)(destDir, { recursive: true });
+  }
+  const entries = (0, import_node_fs.readdirSync)(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = (0, import_node_path.join)(srcDir, entry.name);
+    if (entry.isDirectory()) {
+      const subDestDir = (0, import_node_path.join)(destDir, entry.name);
+      const subFiles = copyStubs(srcPath, subDestDir, transform);
+      writtenFiles.push(...subFiles);
+    } else if (entry.isFile() && entry.name.endsWith(".stub")) {
+      const destName = entry.name.slice(0, -5);
+      const destPath = (0, import_node_path.join)(destDir, destName);
+      let content = (0, import_node_fs.readFileSync)(srcPath, "utf-8");
+      if (transform) {
+        content = transform(content);
+      }
+      (0, import_node_fs.writeFileSync)(destPath, content);
+      writtenFiles.push(destPath);
+    }
+  }
+  return writtenFiles;
+}
+function generateAIGuides(rootDir, options = {}) {
+  const stubsDir = getStubsDir();
+  const basePath = options.laravelBasePath || extractLaravelBasePath(options.modelsPath);
+  const result = {
+    claudeGuides: 0,
+    claudeRules: 0,
+    claudeChecklists: 0,
+    claudeWorkflows: 0,
+    claudeAgents: 0,
+    claudeOmnify: 0,
+    cursorRules: 0,
+    files: []
+  };
+  const readmeSrcPath = (0, import_node_path.join)(stubsDir, "README.md.stub");
+  if ((0, import_node_fs.existsSync)(readmeSrcPath)) {
+    const readmeDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify");
+    if (!(0, import_node_fs.existsSync)(readmeDestDir)) {
+      (0, import_node_fs.mkdirSync)(readmeDestDir, { recursive: true });
+    }
+    const content = (0, import_node_fs.readFileSync)(readmeSrcPath, "utf-8");
+    (0, import_node_fs.writeFileSync)((0, import_node_path.resolve)(readmeDestDir, "README.md"), content);
+    result.files.push((0, import_node_path.resolve)(readmeDestDir, "README.md"));
+  }
+  const claudeSrcDir = (0, import_node_path.join)(stubsDir, "laravel");
+  const claudeDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/guides/laravel");
+  if ((0, import_node_fs.existsSync)(claudeSrcDir)) {
+    const files = copyStubs(claudeSrcDir, claudeDestDir);
+    result.claudeGuides = files.length;
+    result.files.push(...files);
+  }
+  const claudeRulesSrcDir = (0, import_node_path.join)(stubsDir, "claude-rules");
+  const claudeRulesDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/rules");
+  if ((0, import_node_fs.existsSync)(claudeRulesSrcDir)) {
+    const files = copyStubs(claudeRulesSrcDir, claudeRulesDestDir);
+    result.claudeRules = files.length;
+    result.files.push(...files);
+  }
+  const claudeChecklistsSrcDir = (0, import_node_path.join)(stubsDir, "claude-checklists");
+  const claudeChecklistsDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/checklists");
+  if ((0, import_node_fs.existsSync)(claudeChecklistsSrcDir)) {
+    const files = copyStubs(claudeChecklistsSrcDir, claudeChecklistsDestDir);
+    result.claudeChecklists = files.length;
+    result.files.push(...files);
+  }
+  const claudeWorkflowsSrcDir = (0, import_node_path.join)(stubsDir, "claude-workflows");
+  const claudeWorkflowsDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/workflows");
+  if ((0, import_node_fs.existsSync)(claudeWorkflowsSrcDir)) {
+    const files = copyStubs(claudeWorkflowsSrcDir, claudeWorkflowsDestDir);
+    result.claudeWorkflows = files.length;
+    result.files.push(...files);
+  }
+  const claudeAgentsSrcDir = (0, import_node_path.join)(stubsDir, "claude-agents");
+  const claudeAgentsDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/agents");
+  if ((0, import_node_fs.existsSync)(claudeAgentsSrcDir)) {
+    const files = copyStubs(claudeAgentsSrcDir, claudeAgentsDestDir);
+    result.claudeAgents = files.length;
+    result.files.push(...files);
+  }
+  const claudeOmnifySrcDir = (0, import_node_path.join)(stubsDir, "claude-omnify");
+  const claudeOmnifyDestDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/guides/omnify");
+  if ((0, import_node_fs.existsSync)(claudeOmnifySrcDir)) {
+    const files = copyStubs(claudeOmnifySrcDir, claudeOmnifyDestDir);
+    result.claudeOmnify = files.length;
+    result.files.push(...files);
+  }
+  const cursorSrcDir = (0, import_node_path.join)(stubsDir, "cursor");
+  const cursorDestDir = (0, import_node_path.resolve)(rootDir, ".cursor/rules/omnify");
+  if ((0, import_node_fs.existsSync)(cursorSrcDir)) {
+    const files = copyStubs(
+      cursorSrcDir,
+      cursorDestDir,
+      (content) => replacePlaceholders(content, basePath)
+    );
+    result.cursorRules = files.length;
+    result.files.push(...files);
+  }
+  return result;
+}
+function shouldGenerateAIGuides(rootDir) {
+  const claudeDir = (0, import_node_path.resolve)(rootDir, ".claude/omnify/guides/laravel");
+  const cursorDir = (0, import_node_path.resolve)(rootDir, ".cursor/rules/omnify");
+  if (!(0, import_node_fs.existsSync)(claudeDir) || !(0, import_node_fs.existsSync)(cursorDir)) {
+    return true;
+  }
+  try {
+    const claudeFiles = (0, import_node_fs.readdirSync)(claudeDir);
+    const cursorFiles = (0, import_node_fs.readdirSync)(cursorDir);
+    const hasLaravelRules = cursorFiles.some((f) => f.startsWith("laravel"));
+    return claudeFiles.length === 0 || !hasLaravelRules;
+  } catch {
+    return true;
+  }
+}
+
 // src/plugin.ts
 function inferLaravelRoot(providersPath) {
   const normalized = providersPath.replace(/\\/g, "/");
@@ -3911,11 +4067,11 @@ function inferLaravelRoot(providersPath) {
 }
 function getExistingMigrationTables(migrationsDir) {
   const existingTables = /* @__PURE__ */ new Set();
-  if (!(0, import_node_fs.existsSync)(migrationsDir)) {
+  if (!(0, import_node_fs2.existsSync)(migrationsDir)) {
     return existingTables;
   }
   try {
-    const files = (0, import_node_fs.readdirSync)(migrationsDir);
+    const files = (0, import_node_fs2.readdirSync)(migrationsDir);
     const createMigrationPattern = /^\d{4}_\d{2}_\d{2}_\d{6}_create_(.+)_table\.php$/;
     for (const file of files) {
       const match = file.match(createMigrationPattern);
@@ -4081,7 +4237,7 @@ function laravelPlugin(options) {
         customTypes: ctx.customTypes
       };
       const outputs = [];
-      const migrationsDir = (0, import_node_path.join)(ctx.cwd, resolved.migrationsPath);
+      const migrationsDir = (0, import_node_path2.join)(ctx.cwd, resolved.migrationsPath);
       const existingTables = getExistingMigrationTables(migrationsDir);
       if (ctx.changes !== void 0) {
         if (ctx.changes.length === 0) {
@@ -4181,20 +4337,20 @@ function laravelPlugin(options) {
       const laravelRoot = inferLaravelRoot(resolved.providersPath);
       const bootstrapProvidersRelPath = laravelRoot ? `${laravelRoot}/bootstrap/providers.php` : "bootstrap/providers.php";
       const configAppRelPath = laravelRoot ? `${laravelRoot}/config/app.php` : "config/app.php";
-      const bootstrapProvidersPath = (0, import_node_path.join)(ctx.cwd, bootstrapProvidersRelPath);
-      const configAppPath = (0, import_node_path.join)(ctx.cwd, configAppRelPath);
+      const bootstrapProvidersPath = (0, import_node_path2.join)(ctx.cwd, bootstrapProvidersRelPath);
+      const configAppPath = (0, import_node_path2.join)(ctx.cwd, configAppRelPath);
       let existingContent = null;
       let laravelVersion;
-      if ((0, import_node_fs.existsSync)(bootstrapProvidersPath)) {
+      if ((0, import_node_fs2.existsSync)(bootstrapProvidersPath)) {
         laravelVersion = "laravel11+";
         try {
-          existingContent = (0, import_node_fs.readFileSync)(bootstrapProvidersPath, "utf-8");
+          existingContent = (0, import_node_fs2.readFileSync)(bootstrapProvidersPath, "utf-8");
         } catch {
           existingContent = null;
         }
-      } else if ((0, import_node_fs.existsSync)(configAppPath)) {
+      } else if ((0, import_node_fs2.existsSync)(configAppPath)) {
         try {
-          const configContent = (0, import_node_fs.readFileSync)(configAppPath, "utf-8");
+          const configContent = (0, import_node_fs2.readFileSync)(configAppPath, "utf-8");
           if (/'providers'\s*=>\s*\[/.test(configContent)) {
             laravelVersion = "laravel10-";
             existingContent = configContent;
@@ -4307,6 +4463,24 @@ function laravelPlugin(options) {
       }));
     }
   };
+  const aiGuidesGenerator = {
+    name: "laravel-ai-guides",
+    description: "Generate AI assistant guides (Claude, Cursor) for Laravel development",
+    generate: async (ctx) => {
+      if (!shouldGenerateAIGuides(ctx.cwd)) {
+        ctx.logger.debug("AI guides already exist, skipping");
+        return [];
+      }
+      const result = generateAIGuides(ctx.cwd, {
+        modelsPath: resolved.modelsPath,
+        migrationsPath: resolved.migrationsPath,
+        laravelBasePath: "app"
+      });
+      const claudeTotal = result.claudeGuides + result.claudeRules + result.claudeChecklists + result.claudeWorkflows + result.claudeAgents + result.claudeOmnify;
+      ctx.logger.info(`Generated ${claudeTotal} Claude files, ${result.cursorRules} Cursor rules`);
+      return [];
+    }
+  };
   const generators = [migrationGenerator];
   if (resolved.generateModels) {
     generators.push(modelGenerator);
@@ -4320,6 +4494,7 @@ function laravelPlugin(options) {
   if (resolved.generateResources) {
     generators.push(resourceGenerator);
   }
+  generators.push(aiGuidesGenerator);
   return {
     name: "@famgia/omnify-laravel",
     version: "0.0.14",