supatool 0.3.7 → 0.4.0

package/dist/sync/fetchRemoteSchemas.js

@@ -40,63 +40,63 @@ const util_1 = require("util");
 const definitionExtractor_1 = require("./definitionExtractor");
 const dnsLookup = (0, util_1.promisify)(dns.lookup);
 /**
- * DDL文字列を正規化（空白・改行・タブを統一）
+ * Normalize DDL string (unify whitespace, newlines, tabs)
  */
 function normalizeDDL(ddl) {
     return ddl
-        .replace(/\s+/g, ' ') // 連続する空白文字を1つのスペースに
-        .replace(/;\s+/g, ';\n') // セミコロン後に改行
-        .trim(); // 前後の空白を削除
+        .replace(/\s+/g, ' ') // collapse consecutive whitespace to single space
+        .replace(/;\s+/g, ';\n') // newline after semicolon
+        .trim(); // trim leading/trailing
 }
 /**
- * リモートSupabaseからスキーマを取得
+ * Fetch schema from remote Supabase
  */
-async function fetchRemoteSchemas(connectionString) {
+async function fetchRemoteSchemas(connectionString, targetTableNames) {
     const schemas = {};
-    // console.log('データベースに接続中...');
+    // console.log('Connecting to database...');
     try {
-        // 接続文字列の基本チェック
+        // Basic connection string check
         if (!connectionString || !connectionString.startsWith('postgresql://')) {
-            throw new Error('無効な接続文字列です。postgresql://で始まる形式で指定してください。');
+            throw new Error('Invalid connection string. Please specify a valid postgresql:// format.');
         }
-        // URL解析して接続先を表示
+        // Parse URL and display connection info
         const url = new URL(connectionString);
-        console.log(`接続先: ${url.hostname}:${url.port}`);
-        console.log(`ユーザー: ${url.username}`);
-        // パスワードに特殊文字が含まれている場合の対処
+        console.log(`Target: ${url.hostname}:${url.port}`);
+        console.log(`User: ${url.username}`);
+        // Handle special characters in password
         const decodedPassword = decodeURIComponent(url.password || '');
-        // 接続文字列を再構築（パスワードを適切にエンコード）
+        // Rebuild connection string with proper password encoding
         const encodedPassword = encodeURIComponent(decodedPassword);
-        // Session poolerのモードを明示的に指定
+        // Explicit session pooler mode
         let reconstructedConnectionString = `postgresql://${url.username}:${encodedPassword}@${url.hostname}:${url.port}${url.pathname}`;
-        // Session poolingモードのパラメータを追加
+        // Add session pooling params
         const searchParams = new URLSearchParams(url.search);
         searchParams.set('sslmode', 'require');
         searchParams.set('application_name', 'supatool');
         reconstructedConnectionString += `?${searchParams.toString()}`;
-        // IPv4を優先に変更
+        // Prefer IPv4
         dns.setDefaultResultOrder('ipv4first');
-        // DNS解決テスト
+        // DNS resolution test
         try {
             const addresses = await dns.promises.lookup(url.hostname, { all: true });
         }
         catch (dnsError) {
-            console.error('❌ DNS解決に失敗しました');
+            console.error('❌ DNS resolution failed');
             throw dnsError;
         }
-        // Session pooler用の設定
+        // Session pooler config
         const clientConfig = {
             connectionString: reconstructedConnectionString,
             ssl: {
                 rejectUnauthorized: false
             },
-            // Session pooler用の追加設定
+            // Session pooler extra options
             statement_timeout: 30000,
             query_timeout: 30000,
             connectionTimeoutMillis: 10000,
             idleTimeoutMillis: 10000
         };
-        console.log('Session pooler経由で接続中...');
+        console.log('Connecting via session pooler...');
         let client;
         try {
             client = new pg_1.Client(clientConfig);
@@ -107,8 +107,8 @@ async function fetchRemoteSchemas(connectionString) {
                 sslError.message.includes('SCRAM') ||
                 sslError.message.includes('certificate') ||
                 sslError.message.includes('SELF_SIGNED_CERT'))) {
-                console.log('SSL接続不可のため、SSL無効化で再試行中...');
-                // SSL無効化バージョンを試行
+                console.log('SSL connection failed, retrying with SSL disabled...');
+                // Retry with SSL disabled
                 const noSslConnectionString = reconstructedConnectionString.replace('sslmode=require', 'sslmode=disable');
                 const noSslConfig = {
                     ...clientConfig,
@@ -118,12 +118,12 @@ async function fetchRemoteSchemas(connectionString) {
                 try {
                     client = new pg_1.Client(noSslConfig);
                     await client.connect();
-                    console.log('SSL無効化での接続に成功');
+                    console.log('Connection successful with SSL disabled');
                 }
                 catch (noSslError) {
                     if (noSslError instanceof Error && (noSslError.message.includes('SASL') || noSslError.message.includes('SCRAM'))) {
-                        console.log('Session poolerでSASLエラー継続。Direct connectionで再試行中...');
-                        // Direct connection (ポート5432) で再試行
+                        console.log('SASL error continues with session pooler. Retrying with direct connection...');
+                        // Retry with direct connection (port 5432)
                         const directConnectionString = noSslConnectionString.replace('pooler.supabase.com:5432', 'supabase.co:5432');
                         const directConfig = {
                             ...noSslConfig,
@@ -131,7 +131,7 @@ async function fetchRemoteSchemas(connectionString) {
                         };
                         client = new pg_1.Client(directConfig);
                         await client.connect();
-                        console.log('Direct connectionでの接続に成功');
+                        console.log('Direct connection successful');
                     }
                     else {
                         throw noSslError;
@@ -142,29 +142,45 @@ async function fetchRemoteSchemas(connectionString) {
                 throw sslError;
             }
         }
-        // 接続テストクエリ
+        // Connection test query
         const testResult = await client.query('SELECT version()');
-        // テーブル一覧を取得
-        const tablesResult = await client.query(`
-      SELECT tablename 
-      FROM pg_tables 
-      WHERE schemaname = 'public'
-      ORDER BY tablename
-    `);
-        console.log(`リモートテーブル：${tablesResult.rows.length}`);
-        // ローディングアニメーション用
+        // Fetch table list
+        let tablesResult;
+        if (targetTableNames && targetTableNames.length > 0) {
+            // When targeting specific tables only
+            const placeholders = targetTableNames.map((_, index) => `$${index + 1}`).join(',');
+            tablesResult = await client.query(`
+        SELECT tablename 
+        FROM pg_tables 
+        WHERE schemaname = 'public' 
+        AND tablename IN (${placeholders})
+        ORDER BY tablename
+      `, targetTableNames);
+            console.log(`Remote tables (filtered): ${tablesResult.rows.length}/${targetTableNames.length}`);
+        }
+        else {
+            // All tables
+            tablesResult = await client.query(`
+        SELECT tablename 
+        FROM pg_tables 
+        WHERE schemaname = 'public'
+        ORDER BY tablename
+      `);
+            console.log(`Remote tables: ${tablesResult.rows.length}`);
+        }
+        // For loading animation
         const spinner = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
         let spinnerIndex = 0;
         const startTime = Date.now();
         const spinnerInterval = setInterval(() => {
             const elapsed = Math.floor((Date.now() - startTime) / 1000);
-            process.stdout.write(`\r${spinner[spinnerIndex]} スキーマ取得中... ${elapsed}s`);
+            process.stdout.write(`\r${spinner[spinnerIndex]} Fetching schemas... ${elapsed}s`);
             spinnerIndex = (spinnerIndex + 1) % spinner.length;
         }, 100);
-        // 各テーブルのスキーマ情報を取得
+        // Fetch schema info for each table
         for (const row of tablesResult.rows) {
             const tableName = row.tablename;
-            // テーブルの最終更新時刻を取得（省略: 既存ロジック流用）
+            // Get table last updated time (reuse existing logic)
             let timestamp = Math.floor(Date.now() / 1000);
             try {
                 const tableStatsResult = await client.query(`
@@ -188,14 +204,14 @@ async function fetchRemoteSchemas(connectionString) {
             catch {
                 timestamp = Math.floor(new Date('2020-01-01').getTime() / 1000);
             }
-            // DDL生成をdefinitionExtractorの関数で統一
+            // DDL generation unified with definitionExtractor
             const ddl = await (0, definitionExtractor_1.generateCreateTableDDL)(client, tableName, 'public');
             schemas[tableName] = {
                 ddl,
                 timestamp
             };
         }
-        // ローディングアニメーション停止
+        // Stop loading animation
         clearInterval(spinnerInterval);
         const totalTime = Math.floor((Date.now() - startTime) / 1000);
         process.stdout.write(`\rSchema fetch completed (${totalTime}s)                    \n`);

package/dist/sync/generateMigration.js

@@ -38,22 +38,22 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const diff_1 = require("diff");
 /**
- * DDL差分からALTER TABLE文を生成
+ * Generate ALTER TABLE statements from DDL diff
  */
 function generateAlterStatements(tableName, fromDdl, toDdl) {
     const statements = [];
     const diff = (0, diff_1.diffLines)(fromDdl, toDdl);
-    // デバッグ情報削除 - シンプルな表示
-    // カラム名変更の検出用
+    // Debug output removed - simple display
+    // For column rename detection
     const removedColumns = [];
     const addedColumns = [];
     for (const part of diff) {
         if (part.added) {
-            // 追加された行をALTER TABLE文に変換
+            // Convert added lines to ALTER TABLE
             const lines = part.value.split('\n').filter(line => line.trim());
             for (const line of lines) {
                 const trimmed = line.trim();
-                // カラム定義の追加を検出
+                // Detect column definition addition
                 if (trimmed.includes('  ') && !trimmed.startsWith('CREATE') && !trimmed.startsWith('PRIMARY') && !trimmed.startsWith('CONSTRAINT')) {
                     const columnDef = trimmed.replace(/,$/, '').trim();
                     const columnMatch = columnDef.match(/^(\w+)\s+(.+)$/);
@@ -66,11 +66,11 @@ function generateAlterStatements(tableName, fromDdl, toDdl) {
             }
         }
         else if (part.removed) {
-            // 削除された行をALTER TABLE文に変換  
+            // Convert removed lines to ALTER TABLE  
             const lines = part.value.split('\n').filter(line => line.trim());
             for (const line of lines) {
                 const trimmed = line.trim();
-                // カラム定義の削除を検出
+                // Detect column definition removal
                 if (trimmed.includes('  ') && !trimmed.startsWith('CREATE') && !trimmed.startsWith('PRIMARY') && !trimmed.startsWith('CONSTRAINT')) {
                     const columnDef = trimmed.replace(/,$/, '').trim();
                     const columnMatch = columnDef.match(/^(\w+)\s+(.+)$/);
@@ -83,47 +83,47 @@ function generateAlterStatements(tableName, fromDdl, toDdl) {
             }
         }
     }
-    // カラム名変更の検出（型定義が同じで名前が違う場合）
+    // Column rename detection (same type, different name)
     const renames = [];
     for (const removed of removedColumns) {
         const matching = addedColumns.find(added => added.definition === removed.definition);
         if (matching) {
             renames.push({ from: removed.name, to: matching.name });
-            // 処理済みとしてマーク
+            // Mark as processed
             removedColumns.splice(removedColumns.indexOf(removed), 1);
             addedColumns.splice(addedColumns.indexOf(matching), 1);
         }
     }
-    // デバッグログ削除 - シンプルな表示
-    // RENAME COLUMN文を生成
+    // Debug log removed - simple display
+    // Generate RENAME COLUMN statements
     for (const rename of renames) {
         statements.push(`ALTER TABLE ${tableName} RENAME COLUMN ${rename.from} TO ${rename.to};`);
     }
-    // 残りの削除されたカラム
+    // Remaining removed columns
     for (const removed of removedColumns) {
         statements.push(`ALTER TABLE ${tableName} DROP COLUMN ${removed.name};`);
     }
-    // 残りの追加されたカラム
+    // Remaining added columns
     for (const added of addedColumns) {
         statements.push(`ALTER TABLE ${tableName} ADD COLUMN ${added.name} ${added.definition};`);
     }
     return statements;
 }
 /**
- * マイグレーションファイルを生成
+ * Generate migration file
  */
 async function generateMigrationFile(tableName, fromDdl, toDdl, projectDir = '.') {
     const migrationDir = path.join(projectDir, 'supabase', 'migrations');
-    // migrations ディレクトリを作成
+    // Create migrations directory
     if (!fs.existsSync(migrationDir)) {
         fs.mkdirSync(migrationDir, { recursive: true });
     }
-    // ALTER TABLE文を生成
+    // Generate ALTER TABLE statements
     const alterStatements = generateAlterStatements(tableName, fromDdl, toDdl);
     if (alterStatements.length === 0) {
         return await generateManualMigrationTemplate(tableName, fromDdl, toDdl, projectDir);
     }
-    // タイムスタンプでファイル名を生成
+    // Generate filename from timestamp
     const now = new Date();
     const timestamp = now.toISOString()
         .replace(/[-:]/g, '')
@@ -131,37 +131,37 @@ async function generateMigrationFile(tableName, fromDdl, toDdl, projectDir = '.'
         .replace('T', '');
     const filename = `${timestamp}_update_${tableName}.sql`;
     const filepath = path.join(migrationDir, filename);
-    // マイグレーションファイルの内容を生成
+    // Build migration file content
     const content = `-- Migration generated by supatool
 -- Table: ${tableName}
 -- Generated at: ${now.toISOString()}
 
 ${alterStatements.join('\n')}
 `;
-    // ファイルを書き込み
+    // Write file
     fs.writeFileSync(filepath, content, 'utf-8');
-    console.log(`マイグレーションファイル生成: ${filename}`);
+    console.log(`Migration file generated: ${filename}`);
     return filepath;
 }
 /**
- * DDLからカラム定義を抽出
+ * Extract column definitions from DDL
  */
 function extractColumns(ddl) {
     const columns = [];
-    // CREATE TABLE部分を抽出
+    // Extract CREATE TABLE part
     const createTableMatch = ddl.match(/CREATE TABLE[^(]*\((.*)\);?/is);
     if (!createTableMatch) {
         return columns;
     }
     const tableContent = createTableMatch[1];
-    // カラム定義とCONSTRAINTを分離
+    // Split column definitions and CONSTRAINTs
     const parts = tableContent.split(',').map(part => part.trim());
     for (const part of parts) {
-        // CONSTRAINTやPRIMARY KEYは除外
+        // Exclude CONSTRAINT, PRIMARY KEY
         if (part.match(/^(PRIMARY|CONSTRAINT|UNIQUE|FOREIGN|CHECK)/i)) {
             continue;
         }
-        // カラム名とデータ型を分離
+        // Split column name and data type
         const columnMatch = part.trim().match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s+(.+)$/);
         if (columnMatch) {
             const columnName = columnMatch[1];
@@ -172,29 +172,29 @@ function extractColumns(ddl) {
     return columns;
 }
 /**
- * 差分からカラム変更を解析
+ * Analyze column changes from diff
  */
 function analyzeDiffForTemplate(fromDdl, toDdl) {
-    // 各DDLからカラムを抽出
+    // Extract columns from each DDL
     const fromColumns = extractColumns(fromDdl);
     const toColumns = extractColumns(toDdl);
-    // 削除されたカラム（FROMにあってTOにない）
+    // Removed columns (in FROM but not in TO)
     const removedColumns = fromColumns.filter(fromCol => !toColumns.some(toCol => toCol.name === fromCol.name));
-    // 追加されたカラム（TOにあってFROMにない）
+    // Added columns (in TO but not in FROM)
     const addedColumns = toColumns.filter(toCol => !fromColumns.some(fromCol => fromCol.name === toCol.name));
     return { removedColumns, addedColumns };
 }
 /**
- * 手動マイグレーションテンプレートを生成
+ * Generate manual migration template
  */
 async function generateManualMigrationTemplate(tableName, fromDdl, toDdl, projectDir) {
     const migrationDir = path.join(projectDir, 'supabase', 'migrations');
     if (!fs.existsSync(migrationDir)) {
         fs.mkdirSync(migrationDir, { recursive: true });
     }
-    // 差分を解析
+    // Analyze diff
     const { removedColumns, addedColumns } = analyzeDiffForTemplate(fromDdl, toDdl);
-    // タイムスタンプでファイル名を生成
+    // Generate filename from timestamp
     const now = new Date();
     const timestamp = now.toISOString()
         .replace(/[-:]/g, '')
@@ -202,9 +202,9 @@ async function generateManualMigrationTemplate(tableName, fromDdl, toDdl, projec
         .replace('T', '');
     const filename = `${timestamp}_manual_update_${tableName}.sql`;
     const filepath = path.join(migrationDir, filename);
-    // 実際の変更を基にテンプレートを生成
+    // Build template from actual changes
     let migrationStatements = [];
-    // カラム名変更の可能性を検出
+    // Detect possible column renames
     const potentialRenames = [];
     for (const removed of removedColumns) {
         const matching = addedColumns.find(added => added.definition === removed.definition);
@@ -216,10 +216,10 @@ async function generateManualMigrationTemplate(tableName, fromDdl, toDdl, projec
             });
         }
     }
-    // 残りの削除・追加
+    // Remaining removals and additions
     const remainingRemoved = removedColumns.filter(r => !potentialRenames.some(p => p.from === r.name));
     const remainingAdded = addedColumns.filter(a => !potentialRenames.some(p => p.to === a.name));
-    // テンプレート文を生成（DROP → ADD → RENAME の順序）
+    // Generate template statements (DROP -> ADD -> RENAME order)
     if (remainingRemoved.length > 0) {
         migrationStatements.push('-- Column removals:');
         for (const removed of remainingRemoved) {
@@ -242,7 +242,7 @@ async function generateManualMigrationTemplate(tableName, fromDdl, toDdl, projec
             migrationStatements.push(`ALTER TABLE ${tableName} RENAME COLUMN ${rename.from} TO ${rename.to};`);
         }
     }
-    // フォールバック: 何も検出されなかった場合
+    // Fallback when nothing detected
     if (migrationStatements.length === 0) {
         migrationStatements = [
             `-- Manual migration for ${tableName}`,
@@ -259,18 +259,18 @@ async function generateManualMigrationTemplate(tableName, fromDdl, toDdl, projec
 ${migrationStatements.join('\n')}
 `;
     fs.writeFileSync(filepath, content, 'utf-8');
-    console.log(`手動マイグレーションテンプレート生成: ${filename}`);
+    console.log(`Manual migration template generated: ${filename}`);
     return filepath;
 }
 /**
- * より高度な差分解析（カラム変更を検出）
+ * Advanced diff analysis (detect column changes)
  */
 function analyzeColumnChanges(tableName, localDdl, remoteDdl) {
     const statements = [];
-    // 簡単な例：カラム名の変更を検出
+    // Simple case: detect column name change
     const localLines = localDdl.split('\n').map(line => line.trim()).filter(line => line);
     const remoteLines = remoteDdl.split('\n').map(line => line.trim()).filter(line => line);
-    // カラムの型変更やデフォルト値変更などの高度な検出は今後実装
-    // 現在は基本的な追加/削除のみ対応
+    // Advanced detection (type change, default change) to be implemented later
+    // Currently only basic add/remove
     return statements;
 }

package/dist/sync/parseLocalSchemas.js

@@ -37,16 +37,16 @@ exports.parseLocalSchemas = parseLocalSchemas;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 /**
- * DDL文字列を正規化（空白・改行・タブを統一）
+ * Normalize DDL string (unify whitespace, newlines, tabs)
  */
 function normalizeDDL(ddl) {
     return ddl
-        .replace(/\s+/g, ' ') // 連続する空白文字を1つのスペースに
-        .replace(/;\s+/g, ';\n') // セミコロン後に改行
-        .trim(); // 前後の空白を削除
+        .replace(/\s+/g, ' ') // collapse consecutive whitespace to single space
+        .replace(/;\s+/g, ';\n') // newline after semicolon
+        .trim(); // trim leading/trailing
 }
 /**
- * ローカルSQLファイルからスキーマを解析
+ * Parse schema from local SQL files
  */
 async function parseLocalSchemas(schemaDir) {
     const schemas = {};
@@ -54,16 +54,19 @@ async function parseLocalSchemas(schemaDir) {
         return schemas;
     }
     const files = fs.readdirSync(schemaDir);
+    console.log(`Reading schema directory: ${schemaDir}`);
+    console.log(`Found SQL files: ${files.filter(f => f.endsWith('.sql')).join(', ') || 'none'}`);
     for (const file of files) {
         if (!file.endsWith('.sql'))
             continue;
         const filePath = path.join(schemaDir, file);
         const stats = fs.statSync(filePath);
         const fileContent = fs.readFileSync(filePath, 'utf-8');
-        // ファイル名からテーブル名を取得（.sqlを除く）
+        // Get table name from filename (without .sql)
         const tableName = path.basename(file, '.sql');
-        // ファイル内のコメントからタイムスタンプを抽出
-        let timestamp = Math.floor(stats.mtime.getTime() / 1000); // フォールバック
+        console.log(`Processing file: ${file} -> tableName: ${tableName}`);
+        // Extract timestamp from comment in file; fallback to mtime
+        let timestamp = Math.floor(stats.mtime.getTime() / 1000);
         const timestampMatch = fileContent.match(/-- Remote last updated: (.+)/);
         if (timestampMatch) {
             try {
@@ -74,16 +77,16 @@ async function parseLocalSchemas(schemaDir) {
                 }
             }
             catch (error) {
-                // エラーの場合はファイル更新日時を使用
+                // On error use file mtime
             }
         }
-        // DDL部分のみを抽出（コメント行と空白行を完全に除外）
+        // Extract DDL only (exclude comment and blank lines)
         const ddlLines = fileContent.split('\n').filter(line => {
             const trimmed = line.trim();
             return trimmed && !trimmed.startsWith('--');
         });
         const rawDDL = ddlLines.join('\n').trim();
-        // DDLを正規化
+        // Normalize DDL
         const ddl = normalizeDDL(rawDDL);
         schemas[tableName] = {
             ddl: rawDDL,

package/dist/sync/seedGenerator.js

@@ -9,17 +9,17 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 /**
- * 指定テーブルのデータをリモートDBから取得し、AI用シードJSONを生成
+ * Fetch table data from remote DB and generate AI seed JSON
  * @param options SeedGenOptions
  */
 async function generateSeedsFromRemote(options) {
-    // tables.yaml読み込み
+    // Load tables.yaml
     const yamlObj = js_yaml_1.default.load(fs_1.default.readFileSync(options.tablesYamlPath, 'utf8'));
     if (!yamlObj || !Array.isArray(yamlObj.tables)) {
-        throw new Error('tables.yamlの形式が不正です。tables: [ ... ] で指定してください');
+        throw new Error('Invalid tables.yaml format. Specify as tables: [ ... ]');
     }
     const tables = yamlObj.tables;
-    // 日時付きサブディレクトリ名生成（例: 20250705_1116_supatool）
+    // Generate datetime subdir name (e.g. 20250705_1116_supatool)
     const now = new Date();
     const y = now.getFullYear();
     const m = String(now.getMonth() + 1).padStart(2, '0');
@@ -28,28 +28,28 @@ async function generateSeedsFromRemote(options) {
     const mm = String(now.getMinutes()).padStart(2, '0');
     const folderName = `${y}${m}${d}_${hh}${mm}_supatool`;
     const outDir = path_1.default.join(options.outputDir, folderName);
-    // 出力ディレクトリ作成
+    // Create output directory
     if (!fs_1.default.existsSync(outDir)) {
         fs_1.default.mkdirSync(outDir, { recursive: true });
     }
-    // DB接続
+    // DB connection
     const client = new pg_1.Client({ connectionString: options.connectionString });
     await client.connect();
     let processedCount = 0;
     for (const tableFullName of tables) {
-        // スキーマ指定なし→public
+        // No schema specified -> public
         let schema = 'public';
         let table = tableFullName;
         if (tableFullName.includes('.')) {
             [schema, table] = tableFullName.split('.');
         }
-        // データ取得
+        // Fetch data
         const res = await client.query(`SELECT * FROM "${schema}"."${table}"`);
         const rows = res.rows;
-        // ファイル名
+        // File name
         const fileName = `${table}_seed.json`;
         const filePath = path_1.default.join(outDir, fileName);
-        // 出力JSON
+        // Output JSON
         const json = {
             table: `${schema}.${table}`,
             fetched_at: now.toISOString(),
@@ -61,16 +61,17 @@ async function generateSeedsFromRemote(options) {
         processedCount++;
     }
     await client.end();
-    // llms.txtインデックス出力（supabase/seeds直下に毎回上書き）
+    // llms.txt index output (overwrite under supabase/seeds each run)
     const files = fs_1.default.readdirSync(outDir);
     const seedFiles = files.filter(f => f.endsWith('_seed.json'));
     let llmsTxt = `# AI seed data index (generated by supatool)\n`;
     llmsTxt += `# fetched_at: ${now.toISOString()}\n`;
     llmsTxt += `# folder: ${folderName}\n`;
+    llmsTxt += `# Schema catalog: ../schemas/llms.txt\n`;
     for (const basename of seedFiles) {
         const file = path_1.default.join(outDir, basename);
         const content = JSON.parse(fs_1.default.readFileSync(file, 'utf8'));
-        // テーブルコメント（なければ空）
+        // Table comment (empty if none)
         let tableComment = '';
         try {
             const [schema, table] = content.table.split('.');
@@ -86,11 +87,11 @@ async function generateSeedsFromRemote(options) {
     }
     const llmsPath = path_1.default.join(options.outputDir, 'llms.txt');
     fs_1.default.writeFileSync(llmsPath, llmsTxt, 'utf8');
-    // 英語でまとめて出力
+    // Output summary in English
     console.log(`Seed export completed. Processed tables: ${processedCount}`);
     console.log(`llms.txt index written to: ${llmsPath}`);
 }
-// テーブルコメント取得ユーティリティ
+/** Utility to get table comment */
 async function getTableComment(connectionString, schema, table) {
     const client = new pg_1.Client({ connectionString });
     await client.connect();