@famgia/omnify 1.0.17 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify",
-  "version": "1.0.17",
+  "version": "1.0.21",
   "description": "Schema-driven database migration system with TypeScript types and Laravel migrations",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,13 +24,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@famgia/omnify-cli": "0.0.16",
-    "@famgia/omnify-core": "0.0.16",
-    "@famgia/omnify-types": "0.0.12",
-    "@famgia/omnify-typescript": "0.0.4",
-    "@famgia/omnify-laravel": "0.0.22",
-    "@famgia/omnify-mcp": "0.0.4",
-    "@famgia/omnify-atlas": "0.0.12"
+    "@famgia/omnify-cli": "0.0.20",
+    "@famgia/omnify-core": "0.0.20",
+    "@famgia/omnify-types": "0.0.16",
+    "@famgia/omnify-laravel": "0.0.26",
+    "@famgia/omnify-atlas": "0.0.16",
+    "@famgia/omnify-typescript": "0.0.8",
+    "@famgia/omnify-mcp": "0.0.8"
   },
   "keywords": [
     "omnify",

package/scripts/postinstall.js

@@ -11,6 +11,7 @@ This project uses Omnify for schema-driven code generation.
 
 **Documentation**: \`.claude/omnify/\`
 - \`schema-guide.md\` - Schema format and property types
+- \`config-guide.md\` - Configuration (omnify.config.ts)
 - \`laravel-guide.md\` - Laravel generator (if installed)
 - \`typescript-guide.md\` - TypeScript generator (if installed)
 
@@ -27,6 +28,7 @@ Schemas are in \`schemas/\` directory with \`.yaml\` extension.
 
 For detailed documentation, read these files:
 - .claude/omnify/schema-guide.md - Base schema format
+- .claude/omnify/config-guide.md - Configuration (omnify.config.ts)
 - .claude/omnify/laravel-guide.md - Laravel generator (if exists)
 - .claude/omnify/typescript-guide.md - TypeScript generator (if exists)
 
@@ -48,7 +50,7 @@ All schemas are stored in \`schemas/\` directory with \`.yaml\` extension.
 ## Object Schema Structure
 
 \`\`\`yaml
-# yaml-language-server: $schema=https://unpkg.com/@famgia/omnify-types/schemas/omnify-schema.json
+# yaml-language-server: $schema=./node_modules/@famgia/omnify-types/schemas/omnify-schema.json
 name: ModelName          # Required: PascalCase
 kind: object             # Optional: 'object' (default) or 'enum'
 displayName:             # Optional: i18n display name
@@ -185,6 +187,98 @@ If Omnify MCP is configured, these tools are available:
 - \`omnify_get_examples\` - Example schemas
 `;
 
+// Config guide skill file
+const CONFIG_GUIDE_CONTENT = `# Omnify Configuration Guide
+
+## Configuration File
+
+Create \`omnify.config.ts\` in project root:
+
+\`\`\`typescript
+import { defineConfig } from '@famgia/omnify';
+
+export default defineConfig({
+  schemasDir: './schemas',
+
+  database: {
+    driver: 'mysql',  // 'mysql' | 'pgsql' | 'sqlite' | 'sqlsrv' | 'mariadb'
+  },
+
+  output: {
+    laravel: {
+      migrationsPath: './database/migrations/omnify',
+      modelsPath: './app/Models',
+      enumsPath: './app/Enums',
+    },
+    typescript: {
+      path: './src/types/model',
+      singleFile: false,
+    },
+  },
+
+  // Multi-language support (optional)
+  locale: {
+    locales: ['en', 'ja', 'vi'],
+    defaultLocale: 'en',
+    fallbackLocale: 'en',
+  },
+});
+\`\`\`
+
+## Configuration Options
+
+### database (required)
+| Option | Type | Description |
+|--------|------|-------------|
+| \`driver\` | string | Database driver: mysql, pgsql, sqlite, sqlsrv, mariadb |
+| \`devUrl\` | string | Development database URL for Atlas diff |
+| \`enableFieldComments\` | boolean | Enable field comments in migrations (MySQL) |
+
+### output.laravel
+| Option | Type | Description |
+|--------|------|-------------|
+| \`migrationsPath\` | string | Directory for generated migrations |
+| \`modelsPath\` | string | Directory for generated models |
+| \`modelsNamespace\` | string | PHP namespace for models |
+| \`factoriesPath\` | string | Directory for generated factories |
+| \`enumsPath\` | string | Directory for generated enums |
+| \`enumsNamespace\` | string | PHP namespace for enums |
+
+### output.typescript
+| Option | Type | Description |
+|--------|------|-------------|
+| \`path\` | string | Output directory for TypeScript types |
+| \`singleFile\` | boolean | Generate single file vs multiple files |
+| \`generateEnums\` | boolean | Generate enum types |
+| \`generateRelationships\` | boolean | Generate relationship types |
+
+### locale (optional)
+| Option | Type | Description |
+|--------|------|-------------|
+| \`locales\` | string[] | Supported locale codes: ['en', 'ja', 'vi'] |
+| \`defaultLocale\` | string | Default locale for simple strings |
+| \`fallbackLocale\` | string | Fallback when requested locale not found |
+
+## Common Mistakes
+
+❌ **Wrong** - \`locales\` at root level:
+\`\`\`typescript
+{
+  locales: ['en', 'ja'],  // ERROR: locales not in OmnifyConfig
+}
+\`\`\`
+
+✅ **Correct** - \`locales\` inside \`locale\` object:
+\`\`\`typescript
+{
+  locale: {
+    locales: ['en', 'ja'],
+    defaultLocale: 'en',
+  },
+}
+\`\`\`
+`;
+
 const MCP_CONFIG = {
   omnify: {
     command: 'npx',
@@ -225,7 +319,12 @@ function createOmnifySkillFiles(projectRoot) {
     const schemaGuidePath = path.join(omnifyDir, 'schema-guide.md');
     fs.writeFileSync(schemaGuidePath, SCHEMA_GUIDE_CONTENT, 'utf-8');
 
+    // Write config guide
+    const configGuidePath = path.join(omnifyDir, 'config-guide.md');
+    fs.writeFileSync(configGuidePath, CONFIG_GUIDE_CONTENT, 'utf-8');
+
     console.log('  Created .claude/omnify/schema-guide.md');
+    console.log('  Created .claude/omnify/config-guide.md');
     return true;
   } catch (error) {
     console.log('  Note: Could not create .claude/omnify/ skill files');