supatool 0.3.7 → 0.4.0

package/dist/bin/supatool.js

@@ -1,8 +1,38 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 // CLI entry point
 // Subcommand support with commander
@@ -19,8 +49,8 @@ const rlsGenerator_1 = require("../generator/rlsGenerator");
 const sync_1 = require("../sync");
 const definitionExtractor_1 = require("../sync/definitionExtractor");
 const seedGenerator_1 = require("../sync/seedGenerator");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const program = new commander_1.Command();
 program
     .name('supatool')
@@ -53,8 +83,8 @@ program
         process.exit(1);
     }
     try {
-        // --schema オプションの処理
-        let schemas = ['public']; // デフォルト
+        // Handle --schema option
+        let schemas = ['public']; // default
         if (options.schema) {
             schemas = options.schema.split(',').map((s) => s.trim());
         }
@@ -67,7 +97,8 @@ program
             all: options.all,
             tablePattern: options.tables,
             force: options.force,
-            schemas: schemas
+            schemas: schemas,
+            version: package_json_1.version
         });
     }
     catch (error) {
@@ -75,135 +106,142 @@ program
         process.exit(1);
     }
 });
-// config:init サブコマンド
+// config:init subcommand
 program
     .command('config:init')
-    .description('設定ファイル雛形を生成')
-    .option('-o, --out <path>', '出力先パス', 'supatool.config.json')
+    .description('Generate config file template')
+    .option('-o, --out <path>', 'Output path', 'supatool.config.json')
     .action((options) => {
     (0, sync_1.createConfigTemplate)(options.out);
 });
-// gen:types サブコマンド
+// gen:types subcommand
 program
     .command('gen:types <modelPath>')
-    .description('モデルYAMLからTypeScript型定義を生成')
-    .option('-o, --out <path>', '出力先パス', 'docs/generated/types.ts')
+    .description('Generate TypeScript types from model YAML')
+    .option('-o, --out <path>', 'Output path', 'docs/generated/types.ts')
     .action((modelPath, options) => {
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
     (0, typeGenerator_1.generateTypesFromModel)(model, options.out);
-    console.log('TypeScript型定義を出力:', options.out);
+    console.log('TypeScript types output:', options.out);
 });
-// gen:crud サブコマンド
+// gen:crud subcommand
 program
     .command('gen:crud <modelPath>')
-    .description('Generate CRUD TypeScript code from model YAML')
-    .option('-o, --out <dir>', '出力先ディレクトリ', 'docs/generated/crud')
+    .description('Generate CRUD TypeScript code from model YAML [deprecated - prefer writing code with LLM]')
+    .option('-o, --out <dir>', 'Output directory', 'docs/generated/crud')
     .action((modelPath, options) => {
+    console.warn('⚠️  gen:crud is deprecated. With LLM development, writing code as needed is often more efficient.');
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
     (0, crudGenerator_1.generateCrudFromModel)(model, options.out);
     console.log('Generated CRUD TypeScript code:', options.out);
 });
-// gen:docs サブコマンド
+// gen:docs subcommand
 program
     .command('gen:docs <modelPath>')
-    .description('モデルYAMLからドキュメント(Markdown)を生成')
-    .option('-o, --out <path>', 'テーブル定義書出力先', 'docs/generated/table-doc.md')
+    .description('Generate documentation (Markdown) from model YAML')
+    .option('-o, --out <path>', 'Table doc output path', 'docs/generated/table-doc.md')
     .action((modelPath, options) => {
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
     (0, docGenerator_1.generateTableDocMarkdown)(model, options.out);
     (0, docGenerator_1.generateRelationsMarkdown)(model, 'docs/generated/relations.md');
-    console.log('テーブル定義書を出力:', options.out);
-    console.log('リレーション一覧を出力: docs/generated/relations.md');
+    console.log('Table doc output:', options.out);
+    console.log('Relations list output: docs/generated/relations.md');
 });
-// gen:sql サブコマンド
+// gen:sql subcommand
 program
     .command('gen:sql <modelPath>')
-    .description('モデルYAMLからテーブル・リレーション・RLS/セキュリティSQLを一括生成')
-    .option('-o, --out <path>', '出力先パス', 'docs/generated/schema.sql')
+    .description('Generate table, relation, RLS/security SQL from model YAML')
+    .option('-o, --out <path>', 'Output path', 'docs/generated/schema.sql')
     .action((modelPath, options) => {
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
-    // 一時ファイルに個別出力
+    // Write to temp files first
     const tmpSchema = 'docs/generated/.tmp_schema.sql';
     const tmpRls = 'docs/generated/.tmp_rls.sql';
     (0, sqlGenerator_1.generateSqlFromModel)(model, tmpSchema);
     (0, rlsGenerator_1.generateRlsSqlFromModel)(model, tmpRls);
-    // 結合して1ファイルにまとめる
-    const schema = fs_1.default.readFileSync(tmpSchema, 'utf-8');
-    const rls = fs_1.default.readFileSync(tmpRls, 'utf-8');
-    fs_1.default.writeFileSync(options.out, schema + '\n' + rls);
-    fs_1.default.unlinkSync(tmpSchema);
-    fs_1.default.unlinkSync(tmpRls);
-    console.log('テーブル・リレーション・RLS/セキュリティSQLを一括出力:', options.out);
+    // Merge into single file
+    const schema = fs.readFileSync(tmpSchema, 'utf-8');
+    const rls = fs.readFileSync(tmpRls, 'utf-8');
+    fs.writeFileSync(options.out, schema + '\n' + rls);
+    fs.unlinkSync(tmpSchema);
+    fs.unlinkSync(tmpRls);
+    console.log('Table, relation, RLS/security SQL output:', options.out);
 });
-// gen:rls サブコマンド
+// gen:rls subcommand
 program
     .command('gen:rls <modelPath>')
-    .description('モデルYAMLからRLS/セキュリティポリシーSQLを生成')
-    .option('-o, --out <path>', '出力先パス', 'docs/generated/rls.sql')
+    .description('Generate RLS/security policy SQL from model YAML')
+    .option('-o, --out <path>', 'Output path', 'docs/generated/rls.sql')
     .action((modelPath, options) => {
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
     (0, rlsGenerator_1.generateRlsSqlFromModel)(model, options.out);
-    console.log('RLS/セキュリティポリシーSQLを出力:', options.out);
+    console.log('RLS/security policy SQL output:', options.out);
 });
-// gen:all サブコマンド
+// gen:all subcommand
 program
     .command('gen:all <modelPath>')
-    .description('モデルYAMLから全て一括生成')
+    .description('Generate all from model YAML')
     .action((modelPath) => {
     const model = (0, modelParser_1.parseModelYaml)(modelPath);
     (0, typeGenerator_1.generateTypesFromModel)(model, 'docs/generated/types.ts');
     (0, crudGenerator_1.generateCrudFromModel)(model, 'docs/generated/crud');
     (0, docGenerator_1.generateTableDocMarkdown)(model, 'docs/generated/table-doc.md');
     (0, docGenerator_1.generateRelationsMarkdown)(model, 'docs/generated/relations.md');
-    console.log('TypeScript型定義を出力: docs/generated/types.ts');
-    console.log('CRUD関数TypeScriptコードを出力: docs/generated/crud/');
-    console.log('テーブル定義書を出力: docs/generated/table-doc.md');
-    console.log('リレーション一覧を出力: docs/generated/relations.md');
+    console.log('TypeScript types output: docs/generated/types.ts');
+    console.log('CRUD code output: docs/generated/crud/');
+    console.log('Table doc output: docs/generated/table-doc.md');
+    console.log('Relations list output: docs/generated/relations.md');
 });
-// create サブコマンド
+// create subcommand
 program
     .command('create <template>')
-    .description('テンプレートYAML雛形を生成')
-    .option('-o, --out <path>', '出力先パス', 'docs/model-schema-example.yaml')
+    .description('Generate template YAML')
+    .option('-o, --out <path>', 'Output path', 'docs/model-schema-example.yaml')
     .action((template, options) => {
-    const srcPath = path_1.default.join(__dirname, '../templates/yaml', `${template}.yaml`);
+    const srcPath = path.join(__dirname, '../templates/yaml', `${template}.yaml`);
     const destPath = options.out;
-    if (!fs_1.default.existsSync(srcPath)) {
-        console.error(`テンプレートが見つかりません: ${srcPath}`);
+    if (!fs.existsSync(srcPath)) {
+        console.error(`Template not found: ${srcPath}`);
         process.exit(1);
     }
-    fs_1.default.copyFileSync(srcPath, destPath);
-    console.log(`テンプレート雛形を生成: ${destPath}`);
+    fs.copyFileSync(srcPath, destPath);
+    console.log(`Template generated: ${destPath}`);
 });
-// crud コマンド（Supabase型定義→CRUD生成）
+// crud command (Supabase types -> CRUD generation)
 program
     .command('crud')
-    .description('Supabase型定義(TypeScript)からCRUD関数TypeScriptコードを生成')
-    .option('-i, --input <path>', '型定義の入力パス', 'shared/')
-    .option('-o, --output <path>', 'CRUDコード出力先', 'src/integrations/supabase/')
-    .option('-t, --tables <names>', '生成対象テーブル（カンマ区切り）')
-    .option('-f, --force', '出力先を強制上書き')
+    .description('Generate CRUD from Supabase type definitions [deprecated - prefer writing code with LLM]')
+    .option('-i, --input <path>', 'Type definition input path', 'shared/')
+    .option('-o, --output <path>', 'CRUD code output path', 'src/integrations/supabase/')
+    .option('-t, --tables <names>', 'Target tables (comma-separated)')
+    .option('-f, --force', 'Force overwrite output')
     .action((options) => {
-    // コマンドライン引数をmain()に渡すため、process.argvをそのまま利用
+    console.warn('⚠️  crud is deprecated. With LLM development, writing code as needed is often more efficient.');
+    // Pass argv to main() for CLI args
     (0, index_1.main)();
 });
-// helpサブコマンド
+// help subcommand
 program
     .command('help')
     .description('Show help')
     .action(() => {
     console.log(helptext_1.helpText);
 });
-// sync コマンド
+// sync command (deprecated)
 program
     .command('sync')
-    .description('ローカルスキーマとリモートスキーマを同期')
+    .description('Synchronize local and remote schemas [deprecated]')
     .option('-c, --connection <string>', 'Supabase connection string')
-    .option('-s, --schema-dir <path>', 'ローカルスキーマディレクトリ', './supabase/schemas')
-    .option('-t, --tables <pattern>', 'テーブルパターン（ワイルドカード対応）', '*')
-    .option('-f, --force', '強制上書き（確認なし）')
-    .option('--config <path>', '設定ファイルパス')
+    .option('-s, --schema-dir <path>', 'Local schema directory', './supabase/schemas')
+    .option('-t, --tables <pattern>', 'Table pattern (wildcards supported)', '*')
+    .option('-f, --force', 'Force overwrite (no confirmation)')
+    .option('--config <path>', 'Configuration file path')
     .action(async (options) => {
+    console.warn('⚠️  WARNING: sync command is deprecated.');
+    console.warn('   Please use `supatool deploy` command instead.');
+    console.warn('   Example: supatool deploy --table users --dry-run');
+    console.warn('   Example: supatool deploy --table all --dry-run  # all tables');
+    console.warn('');
     const config = (0, sync_1.resolveConfig)({
         connectionString: options.connection
     }, options.config);
@@ -228,16 +266,86 @@ program
         process.exit(1);
     }
 });
-// seed コマンド
+// deploy command (recommended)
+program
+    .command('deploy')
+    .description('Deploy local schema to remote (diff detection, migration generation, confirm before apply)')
+    .option('-c, --connection <string>', 'Supabase connection string')
+    .option('-s, --schema-dir <path>', 'Local schema directory', './supabase/schemas')
+    .option('-t, --table <name>', 'Target table name (specify "all" for all tables)')
+    .option('--auto-apply', 'Auto-apply to remote (no confirmation)')
+    .option('--dry-run', 'Preview changes only (recommended)')
+    .option('--generate-only', 'Generate migration files only (no apply)')
+    .option('--config <path>', 'Configuration file path')
+    .action(async (options) => {
+    const config = (0, sync_1.resolveConfig)({
+        connectionString: options.connection
+    }, options.config);
+    if (!config.connectionString) {
+        console.error('Connection string is required. Set it using one of:');
+        console.error('1. --connection option');
+        console.error('2. SUPABASE_CONNECTION_STRING environment variable');
+        console.error('3. DATABASE_URL environment variable');
+        console.error('4. supatool.config.json configuration file');
+        process.exit(1);
+    }
+    // Validate table specification
+    if (!options.table) {
+        console.error('❌ Table name is required. Use --table <table-name>');
+        console.error('   Example: supatool deploy --table users --dry-run');
+        console.error('   Example: supatool deploy --table all --dry-run  # all tables');
+        process.exit(1);
+    }
+    const tablePattern = options.table === 'all' ? '*' : options.table;
+    // Option processing
+    const isDryRun = options.dryRun || false;
+    const isAutoApply = options.autoApply || false;
+    const isGenerateOnly = options.generateOnly || false;
+    // Conflict check
+    const activeOptions = [isDryRun, isAutoApply, isGenerateOnly].filter(Boolean).length;
+    if (activeOptions > 1) {
+        console.error('❌ --dry-run, --auto-apply, --generate-only cannot be specified simultaneously');
+        process.exit(1);
+    }
+    if (isDryRun) {
+        console.log('🔍 Preview mode: showing changes');
+    }
+    else if (isAutoApply) {
+        console.log('⚡ Auto-apply mode: executing without confirmation');
+    }
+    else if (isGenerateOnly) {
+        console.log('📝 Migration generation mode: file generation only');
+    }
+    else {
+        console.log('✅ Confirmation mode: generating migration then confirming before execution');
+    }
+    try {
+        console.log(`Target tables: ${tablePattern}`);
+        await (0, sync_1.syncAllTables)({
+            connectionString: config.connectionString,
+            schemaDir: options.schemaDir,
+            tablePattern: tablePattern,
+            force: isAutoApply,
+            dryRun: isDryRun,
+            generateOnly: isGenerateOnly,
+            requireConfirmation: !isDryRun && !isAutoApply && !isGenerateOnly
+        });
+    }
+    catch (error) {
+        console.error('⚠️ Deploy error:', error);
+        process.exit(1);
+    }
+});
+// seed command
 program
     .command('seed')
-    .description('指定テーブルのデータをリモートDBから取得し、AI用シードJSONを生成')
-    .option('-c, --connection <string>', 'Supabase接続文字列')
-    .option('-t, --tables <path>', '取得テーブル一覧YAML', 'tables.yaml')
-    .option('-o, --out <dir>', '出力ディレクトリ', 'supabase/seeds')
-    .option('--config <path>', '設定ファイルパス')
+    .description('Fetch table data from remote DB and generate AI seed JSON')
+    .option('-c, --connection <string>', 'Supabase connection string')
+    .option('-t, --tables <path>', 'Tables list YAML', 'tables.yaml')
+    .option('-o, --out <dir>', 'Output directory', 'supabase/seeds')
+    .option('--config <path>', 'Configuration file path')
     .action(async (options) => {
-    // 接続情報の解決
+    // Resolve connection
     const config = (0, sync_1.resolveConfig)({
         connectionString: options.connection
     }, options.config);
@@ -257,7 +365,7 @@ program
         });
     }
     catch (error) {
-        console.error('⚠️ Seed取得エラー:', error);
+        console.error('⚠️ Seed fetch error:', error);
         process.exit(1);
     }
 });

package/dist/generator/client.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.supabase = void 0;
-// Supabaseクライアント定義（自動生成/手動編集可）
-// 日本語コメント
+// Supabase client definition (auto-generated / editable)
 const supabase_js_1 = require("@supabase/supabase-js");
 const supabaseUrl = process.env.SUPABASE_URL || '';
 const supabaseKey = process.env.SUPABASE_KEY || '';

package/dist/generator/crudGenerator.js

@@ -4,14 +4,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateCrudFromModel = generateCrudFromModel;
-// CRUD関数TypeScriptコード自動生成（Supabase実動作対応）
-// 日本語コメント
+// CRUD TypeScript code auto-generation (Supabase-compatible)
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 /**
- * dataSchemaまたはmodels/tablesから各テーブルごとのCRUD関数TypeScriptファイルを生成
- * @param model モデルオブジェクト
- * @param outDir 出力先ディレクトリ
+ * Generate CRUD TypeScript file per table from dataSchema or models/tables
+ * @param model Model object
+ * @param outDir Output directory
  */
 function generateCrudFromModel(model, outDir) {
     if (!fs_1.default.existsSync(outDir)) {
@@ -35,15 +34,15 @@ function generateCrudFromModel(model, outDir) {
             continue;
         const tableName = tableObj.tableName;
         const capitalizedName = capitalize(tableName);
-        let code = `// 自動生成: ${tableName}用CRUD関数\n\n`;
+        let code = `// Auto-generated: CRUD for ${tableName}\n\n`;
         code += `import { supabase } from '../client';\n`;
         code += `import type { ${tableName} } from '../types';\n\n`;
-        // 型定義
-        code += `// フィルター型定義\n`;
+        // Type definitions
+        code += `// Filter type definition\n`;
         code += `type FilterValue = string | number | boolean | null;\n`;
         code += `type Filters = Record<string, FilterValue | FilterValue[]>;\n\n`;
-        // 全件取得関数（改良版）
-        code += `/** 全件取得 */\n`;
+        // Select all (improved)
+        code += `/** Select all */\n`;
         code += `export async function select${capitalizedName}Rows(): Promise<${tableName}[]> {\n`;
         code += `  try {\n`;
         code += `    const { data, error } = await supabase.from('${tableName}').select('*');\n`;
@@ -60,8 +59,8 @@ function generateCrudFromModel(model, outDir) {
         code += `    throw error;\n`;
         code += `  }\n`;
         code += `}\n\n`;
-        // IDで1件取得関数（改良版）
-        code += `/** IDで1件取得 */\n`;
+        // Select by ID (improved)
+        code += `/** Select by ID */\n`;
         code += `export async function select${capitalizedName}RowById({ id }: { id: string }): Promise<${tableName} | null> {\n`;
         code += `  if (!id) {\n`;
         code += `    throw new Error('ID is required');\n`;
@@ -69,7 +68,7 @@ function generateCrudFromModel(model, outDir) {
         code += `  try {\n`;
         code += `    const { data, error } = await supabase.from('${tableName}').select('*').eq('id', id).single();\n`;
         code += `    if (error) {\n`;
-        code += `      // レコードが見つからない場合（PGRST116）は null を返す\n`;
+        code += `      // Return null when record not found (PGRST116)\n`;
         code += `      if (error.code === 'PGRST116') {\n`;
         code += `        return null;\n`;
         code += `      }\n`;
@@ -82,15 +81,15 @@ function generateCrudFromModel(model, outDir) {
         code += `    throw error;\n`;
         code += `  }\n`;
         code += `}\n\n`;
-        // フィルターで検索関数
-        code += `/** フィルターで複数件取得 */\n`;
+        // Select by filters
+        code += `/** Select multiple by filters */\n`;
         code += `export async function select${capitalizedName}RowsWithFilters({ filters }: { filters: Filters }): Promise<${tableName}[]> {\n`;
-        code += `  // filtersのガード\n`;
+        code += `  // Guard for filters\n`;
         code += `  if (!filters || typeof filters !== 'object') return [];\n`;
         code += `  try {\n`;
         code += `    let query = supabase.from('${tableName}').select('*');\n`;
         code += `    \n`;
-        code += `    // フィルターを適用\n`;
+        code += `    // Apply filters\n`;
         code += `    for (const [key, value] of Object.entries(filters)) {\n`;
         code += `      if (Array.isArray(value)) {\n`;
         code += `        query = query.in(key, value);\n`;
@@ -110,8 +109,8 @@ function generateCrudFromModel(model, outDir) {
         code += `    throw error;\n`;
         code += `  }\n`;
         code += `}\n\n`;
-        // 作成関数
-        code += `/** 新規作成 */\n`;
+        // Insert
+        code += `/** Insert */\n`;
         code += `export async function insert${capitalizedName}Row({ data }: { data: Omit<${tableName}, 'id' | 'created_at' | 'updated_at'> }): Promise<${tableName}> {\n`;
         code += `  if (!data) {\n`;
         code += `    throw new Error('Data is required for creation');\n`;
@@ -135,8 +134,8 @@ function generateCrudFromModel(model, outDir) {
         code += `    throw error;\n`;
         code += `  }\n`;
         code += `}\n\n`;
-        // 更新関数
-        code += `/** 更新 */\n`;
+        // Update
+        code += `/** Update */\n`;
         code += `export async function update${capitalizedName}Row({ id, data }: { id: string; data: Partial<Omit<${tableName}, 'id' | 'created_at'>> }): Promise<${tableName}> {\n`;
         code += `  if (!id) {\n`;
         code += `    throw new Error('ID is required for update');\n`;
@@ -167,8 +166,8 @@ function generateCrudFromModel(model, outDir) {
         code += `    throw error;\n`;
         code += `  }\n`;
         code += `}\n\n`;
-        // 削除関数
-        code += `/** 削除 */\n`;
+        // Delete
+        code += `/** Delete */\n`;
         code += `export async function delete${capitalizedName}Row({ id }: { id: string }): Promise<boolean> {\n`;
         code += `  if (!id) {\n`;
         code += `    throw new Error('ID is required for deletion');\n`;

package/dist/generator/docGenerator.js

@@ -5,31 +5,30 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateTableDocMarkdown = generateTableDocMarkdown;
 exports.generateRelationsMarkdown = generateRelationsMarkdown;
-// ドキュメント生成（最小雛形）
-// 日本語コメント
+// Document generation (minimal template)
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 /**
- * テーブル定義書（Markdown）を生成して保存
- * @param model モデルオブジェクト
- * @param outPath 出力先パス
+ * Generate and save table definition doc (Markdown)
+ * @param model Model object
+ * @param outPath Output path
  */
 function generateTableDocMarkdown(model, outPath) {
-    // 出力先ディレクトリを作成
+    // Create output directory
     const dir = path_1.default.dirname(outPath);
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
-    let md = '# テーブル定義書\n\n';
+    let md = '# Table definition doc\n\n';
     for (const m of model.models) {
         const tables = m.tables || {};
         for (const [tableName, table] of Object.entries(tables)) {
             const t = table;
-            let skipNote = t.skipCreate ? '（作成不要: Supabase組み込み）' : '';
+            let skipNote = t.skipCreate ? ' (skip: Supabase built-in)' : '';
             md += `## ${tableName}${skipNote}\n`;
             if (t.description)
                 md += `${t.description}\n`;
-            md += '\n| カラム | 型 | 主キー | NotNull | デフォルト | ラベル |\n|---|---|---|---|---|---|\n';
+            md += '\n| Column | Type | PK | NotNull | Default | Label |\n|---|---|---|---|---|---|\n';
             for (const [colName, col] of Object.entries(t.fields || {})) {
                 const c = col;
                 md += `| ${colName} | ${c.type || ''} | ${c.primary ? '★' : ''} | ${c.notNull ? '○' : ''} | ${c.default || ''} | ${c.label || ''} |\n`;
@@ -40,16 +39,16 @@ function generateTableDocMarkdown(model, outPath) {
     fs_1.default.writeFileSync(outPath, md);
 }
 /**
- * リレーション一覧（Markdown）を生成して保存
- * @param model モデルオブジェクト
- * @param outPath 出力先パス
+ * Generate and save relations list (Markdown)
+ * @param model Model object
+ * @param outPath Output path
  */
 function generateRelationsMarkdown(model, outPath) {
     const dir = path_1.default.dirname(outPath);
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
-    let md = '# リレーション一覧\n\n| テーブル | 関係 | 対象 | 外部キー |\n|---|---|---|---|\n';
+    let md = '# Relations list\n\n| Table | Relation | Target | Foreign key |\n|---|---|---|---|\n';
     for (const m of model.models) {
         const tables = m.tables || {};
         for (const [tableName, table] of Object.entries(tables)) {