@famgia/omnify 1.0.13 → 1.0.17

package/dist/index.cjs

@@ -28,14 +28,14 @@ __export(index_exports, {
   diffHclSchemas: () => import_omnify_atlas.diffHclSchemas,
   findReferencedSchemas: () => import_omnify_core.findReferencedSchemas,
   findReferencingSchemas: () => import_omnify_core.findReferencingSchemas,
-  generateEnums: () => import_omnify_laravel.generateEnums,
+  generateEnums: () => import_omnify_typescript.generateEnums,
   generateHclSchema: () => import_omnify_atlas.generateHclSchema,
-  generateInterfaces: () => import_omnify_laravel.generateInterfaces,
+  generateInterfaces: () => import_omnify_typescript.generateInterfaces,
   generateMigrationFromSchema: () => import_omnify_laravel.generateMigrationFromSchema,
   generateMigrations: () => import_omnify_laravel.generateMigrations,
   generatePreview: () => import_omnify_atlas.generatePreview,
-  generateTypeScript: () => import_omnify_laravel.generateTypeScript,
-  generateTypeScriptFile: () => import_omnify_laravel.generateTypeScriptFile,
+  generateTypeScript: () => import_omnify_typescript.generateTypeScript,
+  generateTypeScriptFiles: () => import_omnify_typescript.generateTypeScriptFiles,
   getEntitySchemas: () => import_omnify_core.getEntitySchemas,
   getEnumSchemas: () => import_omnify_core.getEnumSchemas,
   getGroups: () => import_omnify_core.getGroups,
@@ -54,7 +54,7 @@ __export(index_exports, {
   renderHcl: () => import_omnify_atlas.renderHcl,
   runAtlasDiff: () => import_omnify_atlas.runAtlasDiff,
   schemaToBlueprint: () => import_omnify_laravel.schemaToBlueprint,
-  schemaToInterface: () => import_omnify_laravel.schemaToInterface,
+  schemaToInterface: () => import_omnify_typescript.schemaToInterface,
   validateSchemas: () => import_omnify_core.validateSchemas,
   writeLockFile: () => import_omnify_atlas.writeLockFile
 });
@@ -62,6 +62,7 @@ module.exports = __toCommonJS(index_exports);
 var import_omnify_cli = require("@famgia/omnify-cli");
 var import_omnify_core = require("@famgia/omnify-core");
 var import_omnify_laravel = require("@famgia/omnify-laravel");
+var import_omnify_typescript = require("@famgia/omnify-typescript");
 var import_omnify_atlas = require("@famgia/omnify-atlas");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -80,7 +81,7 @@ var import_omnify_atlas = require("@famgia/omnify-atlas");
   generateMigrations,
   generatePreview,
   generateTypeScript,
-  generateTypeScriptFile,
+  generateTypeScriptFiles,
   getEntitySchemas,
   getEnumSchemas,
   getGroups,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @famgia/omnify - Schema-driven database migration system\n *\n * Main entry point that re-exports key APIs.\n */\n\n// CLI exports (for config files)\nexport { defineConfig, loadConfig } from '@famgia/omnify-cli';\nexport type { OmnifyConfig as ConfigType, ResolvedOmnifyConfig, DatabaseConfig, OutputConfig } from '@famgia/omnify-cli';\n\n// Core exports\nexport {\n  loadSchemas,\n  validateSchemas,\n  createOmnify,\n  Omnify,\n  PluginManager,\n  getSchemaMetadata,\n  introspectSchema,\n  introspectSchemas,\n  getSchemaNames,\n  getEntitySchemas,\n  getEnumSchemas,\n  getSchemasByGroup,\n  getGroups,\n  findReferencingSchemas,\n  findReferencedSchemas,\n  getRelationshipGraph,\n  hasCircularReferences,\n  getTopologicalOrder,\n} from '@famgia/omnify-core';\n\n// Type exports\nexport type {\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n  PropertyDefinition,\n  AssociationDefinition,\n  OmnifyPlugin,\n  OmnifyConfig,\n} from '@famgia/omnify-types';\n\n// Laravel generator exports\nexport {\n  generateMigrations,\n  generateMigrationFromSchema,\n  generateTypeScript,\n  generateTypeScriptFile,\n  generateInterfaces,\n  generateEnums,\n  schemaToBlueprint,\n  schemaToInterface,\n} from '@famgia/omnify-laravel';\n\nexport type {\n  MigrationFile,\n  MigrationOptions,\n  TypeScriptFile,\n  TypeScriptOptions,\n} from '@famgia/omnify-laravel';\n\n// Atlas adapter exports\nexport {\n  runAtlasDiff,\n  diffHclSchemas,\n  generateHclSchema,\n  renderHcl,\n  readLockFile,\n  writeLockFile,\n  compareSchemas,\n  generatePreview,\n  parseDiffOutput,\n} from '@famgia/omnify-atlas';\n\nexport type {\n  AtlasDiffResult,\n  HclSchema,\n  LockFile,\n  DiffResult,\n  ChangePreview,\n} from '@famgia/omnify-atlas';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,wBAAyC;AAIzC,yBAmBO;AAcP,4BASO;AAUP,0BAUO;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @famgia/omnify - Schema-driven database migration system\n *\n * Main entry point that re-exports key APIs.\n */\n\n// CLI exports (for config files)\nexport { defineConfig, loadConfig } from '@famgia/omnify-cli';\nexport type { OmnifyConfig as ConfigType, ResolvedOmnifyConfig, DatabaseConfig, OutputConfig } from '@famgia/omnify-cli';\n\n// Core exports\nexport {\n  loadSchemas,\n  validateSchemas,\n  createOmnify,\n  Omnify,\n  PluginManager,\n  getSchemaMetadata,\n  introspectSchema,\n  introspectSchemas,\n  getSchemaNames,\n  getEntitySchemas,\n  getEnumSchemas,\n  getSchemasByGroup,\n  getGroups,\n  findReferencingSchemas,\n  findReferencedSchemas,\n  getRelationshipGraph,\n  hasCircularReferences,\n  getTopologicalOrder,\n} from '@famgia/omnify-core';\n\n// Type exports\nexport type {\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n  PropertyDefinition,\n  AssociationDefinition,\n  OmnifyPlugin,\n  OmnifyConfig,\n} from '@famgia/omnify-types';\n\n// Laravel generator exports (migrations only)\nexport {\n  generateMigrations,\n  generateMigrationFromSchema,\n  schemaToBlueprint,\n} from '@famgia/omnify-laravel';\n\nexport type {\n  MigrationFile,\n  MigrationOptions,\n} from '@famgia/omnify-laravel';\n\n// TypeScript generator exports\nexport {\n  generateTypeScript,\n  generateTypeScriptFiles,\n  generateInterfaces,\n  generateEnums,\n  schemaToInterface,\n} from '@famgia/omnify-typescript';\n\nexport type {\n  TypeScriptFile,\n  TypeScriptOptions,\n} from '@famgia/omnify-typescript';\n\n// Atlas adapter exports\nexport {\n  runAtlasDiff,\n  diffHclSchemas,\n  generateHclSchema,\n  renderHcl,\n  readLockFile,\n  writeLockFile,\n  compareSchemas,\n  generatePreview,\n  parseDiffOutput,\n} from '@famgia/omnify-atlas';\n\nexport type {\n  AtlasDiffResult,\n  HclSchema,\n  LockFile,\n  DiffResult,\n  ChangePreview,\n} from '@famgia/omnify-atlas';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,wBAAyC;AAIzC,yBAmBO;AAcP,4BAIO;AAQP,+BAMO;AAQP,0BAUO;","names":[]}

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 export { OmnifyConfig as ConfigType, DatabaseConfig, OutputConfig, ResolvedOmnifyConfig, defineConfig, loadConfig } from '@famgia/omnify-cli';
 export { Omnify, PluginManager, createOmnify, findReferencedSchemas, findReferencingSchemas, getEntitySchemas, getEnumSchemas, getGroups, getRelationshipGraph, getSchemaMetadata, getSchemaNames, getSchemasByGroup, getTopologicalOrder, hasCircularReferences, introspectSchema, introspectSchemas, loadSchemas, validateSchemas } from '@famgia/omnify-core';
 export { AssociationDefinition, LoadedSchema, OmnifyConfig, OmnifyPlugin, PropertyDefinition, SchemaCollection, SchemaDefinition } from '@famgia/omnify-types';
-export { MigrationFile, MigrationOptions, TypeScriptFile, TypeScriptOptions, generateEnums, generateInterfaces, generateMigrationFromSchema, generateMigrations, generateTypeScript, generateTypeScriptFile, schemaToBlueprint, schemaToInterface } from '@famgia/omnify-laravel';
+export { MigrationFile, MigrationOptions, generateMigrationFromSchema, generateMigrations, schemaToBlueprint } from '@famgia/omnify-laravel';
+export { TypeScriptFile, TypeScriptOptions, generateEnums, generateInterfaces, generateTypeScript, generateTypeScriptFiles, schemaToInterface } from '@famgia/omnify-typescript';
 export { AtlasDiffResult, ChangePreview, DiffResult, HclSchema, LockFile, compareSchemas, diffHclSchemas, generateHclSchema, generatePreview, parseDiffOutput, readLockFile, renderHcl, runAtlasDiff, writeLockFile } from '@famgia/omnify-atlas';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { OmnifyConfig as ConfigType, DatabaseConfig, OutputConfig, ResolvedOmnifyConfig, defineConfig, loadConfig } from '@famgia/omnify-cli';
 export { Omnify, PluginManager, createOmnify, findReferencedSchemas, findReferencingSchemas, getEntitySchemas, getEnumSchemas, getGroups, getRelationshipGraph, getSchemaMetadata, getSchemaNames, getSchemasByGroup, getTopologicalOrder, hasCircularReferences, introspectSchema, introspectSchemas, loadSchemas, validateSchemas } from '@famgia/omnify-core';
 export { AssociationDefinition, LoadedSchema, OmnifyConfig, OmnifyPlugin, PropertyDefinition, SchemaCollection, SchemaDefinition } from '@famgia/omnify-types';
-export { MigrationFile, MigrationOptions, TypeScriptFile, TypeScriptOptions, generateEnums, generateInterfaces, generateMigrationFromSchema, generateMigrations, generateTypeScript, generateTypeScriptFile, schemaToBlueprint, schemaToInterface } from '@famgia/omnify-laravel';
+export { MigrationFile, MigrationOptions, generateMigrationFromSchema, generateMigrations, schemaToBlueprint } from '@famgia/omnify-laravel';
+export { TypeScriptFile, TypeScriptOptions, generateEnums, generateInterfaces, generateTypeScript, generateTypeScriptFiles, schemaToInterface } from '@famgia/omnify-typescript';
 export { AtlasDiffResult, ChangePreview, DiffResult, HclSchema, LockFile, compareSchemas, diffHclSchemas, generateHclSchema, generatePreview, parseDiffOutput, readLockFile, renderHcl, runAtlasDiff, writeLockFile } from '@famgia/omnify-atlas';

package/dist/index.js

@@ -23,13 +23,15 @@ import {
 import {
   generateMigrations,
   generateMigrationFromSchema,
+  schemaToBlueprint
+} from "@famgia/omnify-laravel";
+import {
   generateTypeScript,
-  generateTypeScriptFile,
+  generateTypeScriptFiles,
   generateInterfaces,
   generateEnums,
-  schemaToBlueprint,
   schemaToInterface
-} from "@famgia/omnify-laravel";
+} from "@famgia/omnify-typescript";
 import {
   runAtlasDiff,
   diffHclSchemas,
@@ -57,7 +59,7 @@ export {
   generateMigrations,
   generatePreview,
   generateTypeScript,
-  generateTypeScriptFile,
+  generateTypeScriptFiles,
   getEntitySchemas,
   getEnumSchemas,
   getGroups,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @famgia/omnify - Schema-driven database migration system\n *\n * Main entry point that re-exports key APIs.\n */\n\n// CLI exports (for config files)\nexport { defineConfig, loadConfig } from '@famgia/omnify-cli';\nexport type { OmnifyConfig as ConfigType, ResolvedOmnifyConfig, DatabaseConfig, OutputConfig } from '@famgia/omnify-cli';\n\n// Core exports\nexport {\n  loadSchemas,\n  validateSchemas,\n  createOmnify,\n  Omnify,\n  PluginManager,\n  getSchemaMetadata,\n  introspectSchema,\n  introspectSchemas,\n  getSchemaNames,\n  getEntitySchemas,\n  getEnumSchemas,\n  getSchemasByGroup,\n  getGroups,\n  findReferencingSchemas,\n  findReferencedSchemas,\n  getRelationshipGraph,\n  hasCircularReferences,\n  getTopologicalOrder,\n} from '@famgia/omnify-core';\n\n// Type exports\nexport type {\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n  PropertyDefinition,\n  AssociationDefinition,\n  OmnifyPlugin,\n  OmnifyConfig,\n} from '@famgia/omnify-types';\n\n// Laravel generator exports\nexport {\n  generateMigrations,\n  generateMigrationFromSchema,\n  generateTypeScript,\n  generateTypeScriptFile,\n  generateInterfaces,\n  generateEnums,\n  schemaToBlueprint,\n  schemaToInterface,\n} from '@famgia/omnify-laravel';\n\nexport type {\n  MigrationFile,\n  MigrationOptions,\n  TypeScriptFile,\n  TypeScriptOptions,\n} from '@famgia/omnify-laravel';\n\n// Atlas adapter exports\nexport {\n  runAtlasDiff,\n  diffHclSchemas,\n  generateHclSchema,\n  renderHcl,\n  readLockFile,\n  writeLockFile,\n  compareSchemas,\n  generatePreview,\n  parseDiffOutput,\n} from '@famgia/omnify-atlas';\n\nexport type {\n  AtlasDiffResult,\n  HclSchema,\n  LockFile,\n  DiffResult,\n  ChangePreview,\n} from '@famgia/omnify-atlas';\n"],"mappings":";AAOA,SAAS,cAAc,kBAAkB;AAIzC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @famgia/omnify - Schema-driven database migration system\n *\n * Main entry point that re-exports key APIs.\n */\n\n// CLI exports (for config files)\nexport { defineConfig, loadConfig } from '@famgia/omnify-cli';\nexport type { OmnifyConfig as ConfigType, ResolvedOmnifyConfig, DatabaseConfig, OutputConfig } from '@famgia/omnify-cli';\n\n// Core exports\nexport {\n  loadSchemas,\n  validateSchemas,\n  createOmnify,\n  Omnify,\n  PluginManager,\n  getSchemaMetadata,\n  introspectSchema,\n  introspectSchemas,\n  getSchemaNames,\n  getEntitySchemas,\n  getEnumSchemas,\n  getSchemasByGroup,\n  getGroups,\n  findReferencingSchemas,\n  findReferencedSchemas,\n  getRelationshipGraph,\n  hasCircularReferences,\n  getTopologicalOrder,\n} from '@famgia/omnify-core';\n\n// Type exports\nexport type {\n  SchemaDefinition,\n  LoadedSchema,\n  SchemaCollection,\n  PropertyDefinition,\n  AssociationDefinition,\n  OmnifyPlugin,\n  OmnifyConfig,\n} from '@famgia/omnify-types';\n\n// Laravel generator exports (migrations only)\nexport {\n  generateMigrations,\n  generateMigrationFromSchema,\n  schemaToBlueprint,\n} from '@famgia/omnify-laravel';\n\nexport type {\n  MigrationFile,\n  MigrationOptions,\n} from '@famgia/omnify-laravel';\n\n// TypeScript generator exports\nexport {\n  generateTypeScript,\n  generateTypeScriptFiles,\n  generateInterfaces,\n  generateEnums,\n  schemaToInterface,\n} from '@famgia/omnify-typescript';\n\nexport type {\n  TypeScriptFile,\n  TypeScriptOptions,\n} from '@famgia/omnify-typescript';\n\n// Atlas adapter exports\nexport {\n  runAtlasDiff,\n  diffHclSchemas,\n  generateHclSchema,\n  renderHcl,\n  readLockFile,\n  writeLockFile,\n  compareSchemas,\n  generatePreview,\n  parseDiffOutput,\n} from '@famgia/omnify-atlas';\n\nexport type {\n  AtlasDiffResult,\n  HclSchema,\n  LockFile,\n  DiffResult,\n  ChangePreview,\n} from '@famgia/omnify-atlas';\n"],"mappings":";AAOA,SAAS,cAAc,kBAAkB;AAIzC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify",
-  "version": "1.0.13",
+  "version": "1.0.17",
   "description": "Schema-driven database migration system with TypeScript types and Laravel migrations",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,14 +20,17 @@
     "dist",
     "bin",
     "docs",
+    "scripts",
     "README.md"
   ],
   "dependencies": {
-    "@famgia/omnify-cli": "0.0.11",
-    "@famgia/omnify-core": "0.0.9",
-    "@famgia/omnify-types": "0.0.9",
-    "@famgia/omnify-atlas": "0.0.9",
-    "@famgia/omnify-laravel": "0.0.11"
+    "@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"
   },
   "keywords": [
     "omnify",
@@ -36,7 +39,10 @@
     "laravel",
     "typescript",
     "atlas",
-    "database"
+    "database",
+    "mcp",
+    "ai",
+    "claude"
   ],
   "author": "Famgia",
   "license": "MIT",
@@ -45,6 +51,8 @@
     "clean": "rm -rf dist",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
-    "lint": "eslint src"
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node scripts/postinstall.js"
   }
 }

package/scripts/postinstall.js

@@ -0,0 +1,361 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+// Content for CLAUDE.md
+const CLAUDE_MD_SECTION = `## 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)
+
+**Commands**:
+- \`npx omnify generate\` - Generate code from schemas
+- \`npx omnify validate\` - Validate schemas
+`;
+
+// Cursor rules content
+const CURSORRULES_CONTENT = `# Omnify Schema Rules
+
+This project uses Omnify for schema-driven code generation.
+Schemas are in \`schemas/\` directory with \`.yaml\` extension.
+
+For detailed documentation, read these files:
+- .claude/omnify/schema-guide.md - Base schema format
+- .claude/omnify/laravel-guide.md - Laravel generator (if exists)
+- .claude/omnify/typescript-guide.md - TypeScript generator (if exists)
+
+Commands:
+- npx omnify generate - Generate code from schemas
+- npx omnify validate - Validate all schemas
+`;
+
+// Marker to check if Omnify section exists
+const OMNIFY_MARKER = '.claude/omnify/';
+
+// Schema guide skill file
+const SCHEMA_GUIDE_CONTENT = `# Omnify Schema Format Guide
+
+## Schema Location
+
+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
+name: ModelName          # Required: PascalCase
+kind: object             # Optional: 'object' (default) or 'enum'
+displayName:             # Optional: i18n display name
+  ja: 日本語名
+  en: English Name
+description:             # Optional: i18n description
+  ja: 説明文
+  en: Description
+group: group-name        # Optional: for organizing schemas
+options:
+  softDelete: true       # Enable soft delete (deleted_at column)
+  timestamps: true       # Enable created_at, updated_at
+  table: custom_table    # Custom table name
+properties:
+  # Property definitions here
+\`\`\`
+
+## Property Types
+
+### String Types
+| Type | Description | Options |
+|------|-------------|---------|
+| \`String\` | Short text (varchar) | \`maxLength\`, \`minLength\`, \`default\` |
+| \`LongText\` | Long text (text) | \`default\` |
+
+### Numeric Types
+| Type | Description | Options |
+|------|-------------|---------|
+| \`Int\` | Integer | \`min\`, \`max\`, \`default\`, \`unsigned\` |
+| \`BigInt\` | Big integer | \`min\`, \`max\`, \`default\`, \`unsigned\` |
+| \`Float\` | Decimal | \`precision\`, \`scale\`, \`default\` |
+
+### Other Types
+| Type | Description | Options |
+|------|-------------|---------|
+| \`Boolean\` | True/false | \`default\` |
+| \`Date\` | Date only | \`default\` |
+| \`DateTime\` | Date and time | \`default\` |
+| \`Json\` | JSON object | \`default\` |
+| \`EnumRef\` | Reference to enum | \`enum\` (required), \`default\` |
+
+### Association Type
+| Type | Description | Options |
+|------|-------------|---------|
+| \`Association\` | Relation | \`relation\`, \`target\`, \`onDelete\`, \`mappedBy\` |
+
+## Property Options
+
+\`\`\`yaml
+properties:
+  name:
+    type: String
+    displayName:
+      ja: 名前
+      en: Name
+    required: true           # Not nullable
+    unique: true            # Unique constraint
+    index: true             # Create index
+    maxLength: 255          # For String
+    default: 'default'      # Default value
+\`\`\`
+
+## Association Relations
+
+### ManyToOne (N:1)
+\`\`\`yaml
+author:
+  type: Association
+  relation: ManyToOne
+  target: User
+  onDelete: CASCADE        # CASCADE, SET_NULL, RESTRICT
+\`\`\`
+
+### OneToMany (1:N)
+\`\`\`yaml
+posts:
+  type: Association
+  relation: OneToMany
+  target: Post
+  mappedBy: author         # Property name in Post that references this
+\`\`\`
+
+### ManyToMany (N:M)
+\`\`\`yaml
+tags:
+  type: Association
+  relation: ManyToMany
+  target: Tag
+  pivotTable: post_tags    # Optional: custom pivot table name
+  pivotFields:             # Optional: extra pivot fields
+    - name: order
+      type: Int
+      default: 0
+\`\`\`
+
+### OneToOne (1:1)
+\`\`\`yaml
+profile:
+  type: Association
+  relation: OneToOne
+  target: Profile
+  onDelete: CASCADE
+\`\`\`
+
+## Enum Schema
+
+\`\`\`yaml
+name: PostStatus
+kind: enum
+displayName:
+  ja: 投稿ステータス
+  en: Post Status
+values:
+  draft: ドラフト          # value: displayName format
+  published: 公開済み
+  archived: アーカイブ
+\`\`\`
+
+Use enum in object schema:
+\`\`\`yaml
+status:
+  type: EnumRef
+  enum: PostStatus         # Reference enum name
+  default: draft           # Default value from enum
+\`\`\`
+
+## MCP Tools
+
+If Omnify MCP is configured, these tools are available:
+- \`omnify_create_schema\` - Generate schema YAML
+- \`omnify_validate_schema\` - Validate YAML content
+- \`omnify_get_types\` - Property types documentation
+- \`omnify_get_relationships\` - Relationship guide
+- \`omnify_get_examples\` - Example schemas
+`;
+
+const MCP_CONFIG = {
+  omnify: {
+    command: 'npx',
+    args: ['@famgia/omnify-mcp'],
+  },
+};
+
+function findProjectRoot() {
+  // npm/pnpm set INIT_CWD to the directory where the install was run
+  // This is more reliable than process.cwd() during postinstall
+  let dir = process.env.INIT_CWD || process.cwd();
+
+  // If we're in node_modules, go up to find the actual project
+  const nodeModulesIndex = dir.indexOf('node_modules');
+  if (nodeModulesIndex !== -1) {
+    dir = dir.substring(0, nodeModulesIndex - 1);
+  }
+
+  // Verify it's a project root by checking for package.json
+  const packageJsonPath = path.join(dir, 'package.json');
+  if (fs.existsSync(packageJsonPath)) {
+    return dir;
+  }
+
+  return null;
+}
+
+function createOmnifySkillFiles(projectRoot) {
+  const omnifyDir = path.join(projectRoot, '.claude', 'omnify');
+
+  try {
+    // Create .claude/omnify directory
+    if (!fs.existsSync(omnifyDir)) {
+      fs.mkdirSync(omnifyDir, { recursive: true });
+    }
+
+    // Write base schema guide (plugin-specific guides are created by each plugin)
+    const schemaGuidePath = path.join(omnifyDir, 'schema-guide.md');
+    fs.writeFileSync(schemaGuidePath, SCHEMA_GUIDE_CONTENT, 'utf-8');
+
+    console.log('  Created .claude/omnify/schema-guide.md');
+    return true;
+  } catch (error) {
+    console.log('  Note: Could not create .claude/omnify/ skill files');
+    return false;
+  }
+}
+
+function createClaudeMd(projectRoot) {
+  const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+
+  // Check if CLAUDE.md exists
+  if (fs.existsSync(claudeMdPath)) {
+    const existingContent = fs.readFileSync(claudeMdPath, 'utf-8');
+
+    // Check if Omnify section already exists
+    if (existingContent.includes(OMNIFY_MARKER)) {
+      console.log('  CLAUDE.md already has Omnify section, skipping...');
+      return false;
+    }
+
+    // Append Omnify section to existing CLAUDE.md
+    const newContent = existingContent.trimEnd() + '\n\n' + CLAUDE_MD_SECTION;
+    fs.writeFileSync(claudeMdPath, newContent, 'utf-8');
+    console.log('  Appended Omnify section to CLAUDE.md');
+    return true;
+  }
+
+  // Create new CLAUDE.md with just the Omnify section
+  fs.writeFileSync(claudeMdPath, CLAUDE_MD_SECTION, 'utf-8');
+  console.log('  Created CLAUDE.md');
+  return true;
+}
+
+function createCursorRules(projectRoot) {
+  const cursorDir = path.join(projectRoot, '.cursor', 'rules');
+  const cursorRulesPath = path.join(cursorDir, 'omnify.md');
+
+  try {
+    // Create .cursor/rules directory
+    if (!fs.existsSync(cursorDir)) {
+      fs.mkdirSync(cursorDir, { recursive: true });
+    }
+
+    // Always overwrite - this file is fully managed by Omnify
+    fs.writeFileSync(cursorRulesPath, CURSORRULES_CONTENT, 'utf-8');
+    console.log('  Updated .cursor/rules/omnify.md');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function configureClaudeMcp() {
+  const homeDir = os.homedir();
+  const claudeDir = path.join(homeDir, '.claude');
+  const configPath = path.join(claudeDir, 'claude_desktop_config.json');
+
+  try {
+    // Create .claude directory if not exists
+    if (!fs.existsSync(claudeDir)) {
+      fs.mkdirSync(claudeDir, { recursive: true });
+    }
+
+    let config = { mcpServers: {} };
+
+    // Read existing config if exists
+    if (fs.existsSync(configPath)) {
+      try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        config = JSON.parse(content);
+        if (!config.mcpServers) {
+          config.mcpServers = {};
+        }
+      } catch {
+        // Invalid JSON, start fresh
+        config = { mcpServers: {} };
+      }
+    }
+
+    // Check if omnify is already configured
+    if (config.mcpServers.omnify) {
+      console.log('  Omnify MCP already configured');
+      return false;
+    }
+
+    // Add omnify MCP server
+    config.mcpServers.omnify = MCP_CONFIG.omnify;
+
+    // Write config
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    console.log('  Configured Omnify MCP server in ~/.claude/claude_desktop_config.json');
+    return true;
+  } catch (error) {
+    // Silently fail - MCP config is optional
+    console.log('  Note: Could not auto-configure MCP (optional)');
+    return false;
+  }
+}
+
+function main() {
+  // Skip in CI environments
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
+    return;
+  }
+
+  // Skip if in omnify-ts monorepo (source code), but allow examples/
+  const projectDir = process.env.INIT_CWD || process.cwd();
+  if (projectDir.includes('omnify-ts') && !projectDir.includes('omnify-ts/examples')) {
+    return;
+  }
+
+  console.log('\n🔧 Omnify: Setting up Claude Code integration...\n');
+
+  const projectRoot = findProjectRoot();
+
+  if (projectRoot) {
+    // Create .claude/omnify/ skill files
+    createOmnifySkillFiles(projectRoot);
+
+    // Create or update CLAUDE.md in project root
+    createClaudeMd(projectRoot);
+
+    // Create Cursor rules
+    createCursorRules(projectRoot);
+  }
+
+  // Configure MCP server in user's home directory
+  configureClaudeMcp();
+
+  console.log('\n✅ Omnify setup complete!\n');
+}
+
+main();