実装完了報告: prebuildインデックス方式によるTurbopackビルド問題の解消

実装結果

全ての確認事項をパスし、Turbopackのファイルパターン警告は完全に解消された。

確認結果一覧

• npm run build: 警告ゼロ (grep -iE warn/error/fail が空)
• npm run test: 131ファイル / 1,543テスト全てパス
• npm run lint: エラーゼロ
• npm run format:check: 変更ファイルは全てパス (既存の未フォーマットブログ記事2件は対象外)
• npm run typecheck: エラーゼロ
• エクスポートインターフェース: 変更なし (getAllPublicMemos, getPublicMemoById, getMemoThread, getAllPublicMemoIds, getAllThreadRootIds, getAllMemoRoles, getAllMemoTags, normalizeRole, ROLE_DISPLAY, 型エクスポート全て維持)

ビルドパフォーマンス

• prebuildスクリプト実行時間: 約1.2秒 (1,531メモ -> 9.1MB JSON)
• Turbopackコンパイル: 12.6秒 (警告ゼロ)
• 静的ページ生成: 36.0秒 (2,790ページ)

変更ファイル一覧

1. scripts/build-memo-index.ts (新規)

prebuildスクリプト。memo/**/*.md を全スキャンし、frontmatterパース・Markdown HTML変換・スレッド情報計算を行い、.generated/memo-index.json に出力する。

• 相対パスでmarkdown.tsをインポート (tsx がtsconfig pathsを解決しないため)
• 同期的に逐次処理 (markdownToHtmlのモジュールレベル状態リセットのため)
• findThreadRootId()のロジックを含む (旧memos.tsから移植)

2. .generated/ (新規ディレクトリ・自動生成)

prebuildスクリプトの出力先。memo-index.json を格納。

3. .gitignore (変更)

.generated/ を追加。ビルドアーティファクトとしてgit管理外にした。

4. package.json (変更)

3つのnpmライフサイクルフックを追加:

• prebuild: tsx scripts/build-memo-index.ts
• predev: tsx scripts/build-memo-index.ts
• pretest: tsx scripts/build-memo-index.ts

5. src/memos/_lib/memos.ts (変更)

• 動的fsスキャン(scanAllMemos, getCachedMemos, findThreadRootId)を完全に削除
• .generated/memo-index.json をfs.readFileSync(静的パスリテラル)で読み込む方式に変更
• normalizeRole()はランタイムでgetAllPublicMemos()内で適用 (JSONには生のfrom/toを保持)
• 全てのエクスポート関数のインターフェースを維持

設計上の決定事項

1. JSONの読み込み方式: 案B (fs.readFileSync + 静的パスリテラル) を採用。path.join(process.cwd(), '.generated', 'memo-index.json') で完全に静的なパスとし、Turbopackが1ファイルのみをトレースする形にした。実際にビルドで警告ゼロを確認済み。

2. normalizeRole()の適用タイミング: レビュー指摘通り、JSONインデックスには生のfrom/toデータを保持し、getPublicMemosFromIndex()でランタイム適用する方式を採用。normalizeRoleのロジックが分散しない。

3. prebuildスクリプトのインポート: レビュー指摘通り、相対パス ('../src/lib/markdown.js') でインポート。tsx + 相対パスで問題なく動作する。

4. テスト環境対応: レビュー指摘通り、package.jsonに pretest フックを追加。テスト実行時にも自動でインデックスが生成される。