1.15 Wire the startup sequence in cli

[goofmint]

Part of Phase 1 — Core skeleton (tasks.md Task 1.15). Closes out Phase 1.

Summary

Wire everything into the real startup sequence with first paint before any extension code runs.

Details

• Argv parsing: file or directory argument.
• Sync-before-first-frame phase (< 100 ms budget, Req 12.2): load config + keybindings, terminal capability detection stub (real detection in Task 4.2), render the Shell with empty slots and placeholder editor area.
• Deferred phase (queueMicrotask after first frame): discovery → registration → onStartup activations → open the argv file/directory (fires onLanguage:*).
• Startup-to-first-frame timing instrumentation (also feeds the CI check in Task 4.5).

Completion requirements

• Integration test proves the shell renders before any extension index.ts loads (module-load spy)
• Startup order matches Req 12.1 exactly (config → discover → register → lazy activate → render → open)
• Timing check passes with headroom over the 100 ms first-frame budget on CI hardware
• bun run cli <dir> opens the empty shell interactively (manual smoke test)
• bun test and lint pass

Phase 1 exit criterion: bun run cli opens the empty shell with working command registry, keymap, documents (headless), and config.

References

• requirements.md: Req 12.1, 12.2
• design.md: §3, §15

Dependencies

Blocked by: 1.14 (#15).

[goofmint]

@coderabbitai make plan in Japanese

---

Generated by Claude Code

[coderabbitai]

Coding Plan

Summary

• main.ts の起動処理を design.md §3 の順序に沿って同期フェーズと遅延フェーズへ再構成し、registerTecodeAlias の順序不変条件を保持する。
• 循環依存はコードベース既存の前方参照クロージャパターンで解決し、コマンドレジストリとドキュメントマネージャに拡張ホストのフックを渡す。
• シェル描画は単一の呼び出しシームとして構造化し、Task 1.14 の実体到着後に完全動作する。ビルトインマニフェストは @tecode/builtin の集約エクスポートで供給する。
• performance.now() で最初のフレームまでの時間を計測し、モジュール読み込みスパイのサブプロセステストで「描画が拡張コード実行より前」であることと 100 ms 予算のヘッドルームを検証する。

Design Choices

Design Choice 1: シェル描画の依存（Task 1.14 が未完成）をどう扱うか

Options Considered:

1. 1.14 の完成まで本タスクを完全ブロックする。
2. 起動シーケンス内に「シェル描画呼び出し点（描画シーム）」を定義し、現状の core/ui プレースホルダに対して呼び出す。1.14 が実体を埋める。
3. 本タスク内で最小限のシェル描画も実装する（1.14 の範囲へ侵入）。

Chosen Option: 2

Rationale: 本チケットは「シェルを描画する」ことを求める。しかし packages/core/src/ui/index.ts は UII_PLACEHOLDER = true のスタブのみである。Task 1.14（UI シェル）は未実装であり、描画対象の実体が存在しない。起動シーケンスの正しさ（フェーズ分離・順序・タイミング計測）を本タスクで完成させる。シェル描画は明確な単一の呼び出し点として構造化する。実体描画は 1.14 が埋める。対話的スモークテスト（bun run cli <dir> が空シェルを表示）は 1.14 の到着後に完全に満たされる。

Design Choice 2: ビルトイン拡張マニフェストの供給方法

Options Considered:

1. main.ts から常に builtins: [] を渡す。
2. @tecode/builtin にアグリゲータ（ビルトインマニフェスト配列を返すモジュール）を追加し、cli から import する。現状は空配列を返す。

Chosen Option: 2

Rationale: packages/builtin/* にはまだ Manifest が存在しない。配線点を将来対応にするため、@tecode/builtin に集約エクスポートを追加する。ビルトインが実マニフェストを得た時点で、cli 側の変更なしに反映される。

Design Choice 3: タイミング計測の実現手段

Options Considered:

1. 既存の Clock（Date.now()）を流用する。
2. performance.now() を用いた高精度計測を新規に導入する。

Chosen Option: 2

Rationale: design.md はタイミング計測の具体的な API を規定していない。buffer/clock.ts はミリ秒精度の Date.now() ベースで undo 用に限定されている。100 ms 予算の判定には高精度が望ましい。performance.now() でプロセス起動時と最初のフレーム描画時を計測し、HostLog を通じて構造化メトリクスとして出力する。

💡 User Tips

Regenerate the plan with different choices with @coderabbitai <feedback>.

Implementation Steps

Phase 1: argv 解析と起動フェーズの構造化

このフェーズは main.ts を、単一の buildAssemblyRoot 呼び出しから、明確に分離した起動フェーズへ再構成する。既存の createTecodeApi → registerTecodeAlias の順序不変条件は保持する。

Task 1: argv 解析を追加する

argv からファイル引数またはディレクトリ引数を解決する。

• packages/cli/src/main.ts の main(argv) を拡張する。既存の --version 分岐は保持する。
• 位置引数を 1 つ受け取る。引数が存在すれば絶対パスへ解決する。引数が無ければ process.cwd() を用いる。
• 解決したパスを stat し、ディレクトリかファイルかを判定する。ディレクトリなら workspaceRoot に設定し、初期ドキュメントは開かない。ファイルなら親ディレクトリを workspaceRoot に設定し、そのファイルを遅延フェーズで開く対象として保持する。
• パス解決結果（workspaceRoot と任意の初期ファイル URI）を後続フェーズへ渡す構造体として返す。

Task 2: 起動シーケンスを同期フェーズと遅延フェーズに分離する

起動処理を design.md §3 の順序に沿って 2 フェーズに再構成する。

• packages/cli/src/main.ts に、同期フェーズ関数と遅延フェーズ関数を明確に分ける起動オーケストレータを実装する。
• 同期フェーズは次の順序で実行する。設定とキーバインドの読み込み（config.ready を待機）、端末機能検出スタブの実行、テーマ構築（現状は core の既定を使用）、シェル描画呼び出し。
• 遅延フェーズは queueMicrotask で最初のフレーム描画後にスケジュールする。順序は discovery → registration → onStartup 起動 → argv のファイル/ディレクトリのオープンとする。
• buildAssemblyRoot の既存不変条件（registerTecodeAlias は createTecodeApi 直後、かつ拡張モジュール import より厳密に前）を保持する。遅延フェーズの拡張活性化は必ずエイリアス登録後に実行する。

Task 3: 端末機能検出スタブとシェル描画シームを追加する

描画前に必要な同期ステップの呼び出し点を定義する。

• 端末機能検出スタブを packages/cli/src/ に追加する。固定の既定機能値を返すだけとする。実検出は Task 4.2 の担当であるとコメントで明記する。
• シェル描画呼び出し点を core/ui に対する単一の呼び出しとして構造化する。現状 core/ui はプレースホルダのため、Task 1.14 が実体を埋める前提で呼び出しシームを設ける。
• 描画呼び出しが返った直後を「最初のフレーム」とみなし、タイミング計測（Task 1.4）の終端点とする。

Task 4: 起動タイミング計測を追加する

最初のフレームまでの所要時間を計測して出力する。

• performance.now() を用いて、プロセス起動時点とシェル描画完了時点を記録する。
• 経過時間を HostLog 経由で構造化メトリクスとして出力する。CI 判定（Task 4.5）が参照できる形式にする。
• 詳細出力は環境変数で制御可能にする（例: 計測ログの有効化フラグ）。既定では簡潔にする。

🤖 Prompt for AI agents

このフェーズでは、`packages/cli/src/main.ts` を単一の `buildAssemblyRoot`
呼び出しから、明確に分離した起動フェーズへ再構成する。既存の `createTecodeApi` → `registerTecodeAlias`
の順序不変条件を保持する。

1. argv 解析を追加する。`main(argv)` を拡張し、既存の `--version` 分岐は保持する。位置引数を 1
つ受け取り、存在すれば絶対パスへ解決する。引数が無ければ `process.cwd()` を使う。解決したパスを `stat`
してディレクトリかファイルかを判定する。ディレクトリなら `workspaceRoot` に設定し初期ドキュメントは開かない。ファイルなら親ディレクトリを
`workspaceRoot` に設定し、そのファイルを遅延フェーズで開く対象として保持する。パス解決結果（`workspaceRoot` と任意の初期ファイル
URI）を後続フェーズへ渡す構造体として返す。

2. 起動シーケンスを同期フェーズと遅延フェーズに分離する。`main.ts`
に、同期フェーズ関数と遅延フェーズ関数を明確に分ける起動オーケストレータを実装する。同期フェーズは、設定とキーバインドの読み込み（`config.ready`
を待機）、端末機能検出スタブの実行、テーマ構築（現状は core の既定を使用）、シェル描画呼び出しの順に実行する。遅延フェーズは
`queueMicrotask` で最初のフレーム描画後にスケジュールし、discovery → registration → `onStartup` 起動 →
argv のファイル/ディレクトリのオープンの順に実行する。`buildAssemblyRoot` の既存不変条件（`registerTecodeAlias`
は `createTecodeApi` 直後、かつ拡張モジュール import
より厳密に前）を保持し、遅延フェーズの拡張活性化は必ずエイリアス登録後に実行する。

3. 端末機能検出スタブとシェル描画シームを追加する。端末機能検出スタブを `packages/cli/src/`
に追加し、固定の既定機能値を返すだけとする。実検出は別タスクの担当であるとコメントで明記する。シェル描画呼び出し点を `core/ui`
に対する単一の呼び出しとして構造化する。現状 `core/ui`
はプレースホルダであるため、別タスクが実体を埋める前提で呼び出しシームを設ける。描画呼び出しが返った直後を「最初のフレーム」とみなし、タイミング計測の終端点とする。

4. 起動タイミング計測を追加する。`performance.now()` を用いて、プロセス起動時点とシェル描画完了時点を記録する。経過時間を
`HostLog` 経由で構造化メトリクスとして出力し、CI 判定が参照できる形式にする。詳細出力は環境変数で制御可能にし、既定では簡潔にする。

Phase 2: 同期フェーズのキーマップ配線

このフェーズは、同期フェーズで設定からキーバインドを取り込み、キーマップの binding table を組み立てる。現状 createBindingTable はどの合成ルートからも呼ばれていない。

設定サービスからキーマップへのハンドオフを配線する

config.getKeybindingEntries() の結果を keymap レイヤへ渡す。

• packages/cli/src/main.ts の合成処理で、createConfigService に onKeybindingsChange フックを渡す。
• 同期フェーズで config.ready 待機後、getKeybindingEntries() を取得する。
• createBindingTable を呼び、defaults レイヤと、設定由来の user レイヤを組み合わせて binding table を構築する。fallback（端末機能）レイヤと extension レイヤは後続で埋める前提とする。
• onKeybindingsChange 発火時に binding table を再構築する配線を設ける。

🤖 Prompt for AI agents

このフェーズでは、同期フェーズで設定からキーバインドを取り込み、キーマップの binding table を組み立てる。現状
`createBindingTable` はどの合成ルートからも呼ばれていないため、これを配線する。

- `packages/cli/src/main.ts` の合成処理で、`createConfigService` に
`onKeybindingsChange` フックを渡す。
- 同期フェーズで `config.ready` 待機後、`getKeybindingEntries()` を取得する。
- `createBindingTable` を呼び出し、`defaults` レイヤと、設定由来の `user` レイヤを組み合わせて binding
table を構築する。`fallback`（端末機能）レイヤと `extension` レイヤは後続フェーズで埋める前提とする。
- `onKeybindingsChange` 発火時に binding table を再構築する配線を設ける。

Phase 3: 遅延フェーズの拡張ホスト配線と初期オープン

このフェーズは遅延フェーズを実装する。拡張の discovery/registration/activation を配線し、循環依存をクロージャの前方参照で解決し、argv 対象を開く。

Task 1: 循環依存を前方参照クロージャで解決する

コマンドレジストリとドキュメントマネージャに拡張ホストのフックを渡す。

• packages/cli/src/main.ts の合成処理で、host/activation.test.ts が示す前方参照パターンを用いる。
• createCommandRegistry に activateExtension: (id) => host.activateExtension(id) を渡す。host は後続で宣言する。
• createDocumentManager に onLanguageActivation: (languageId) => host.onLanguage(languageId) を渡す。
• これらのフックはクロージャで host バインディングを参照する。実際の呼び出しは host 初期化後にのみ発生する。

Task 2: ビルトインマニフェストのアグリゲータを追加する

@tecode/builtin に集約エクスポートを追加する。

• packages/builtin/ に集約モジュール（新規 packages/builtin/index.ts 等）を追加する。各サブパッケージの実マニフェストを配列として集約してエクスポートする。実マニフェストが未整備の現状は空配列を返す。
• packages/cli/package.json の dependencies に @tecode/builtin を workspace:* で追加する。
• ESLint の階層ルールは cli を除外対象としているため、cli からの @tecode/builtin import は許容される。

Task 3: 遅延フェーズで拡張の読み込みと活性化を配線する

loadExtensions と createExtensionHost を呼ぶ。

• 遅延フェーズで loadExtensions({ log, sink, commands, configRegistrar?, builtins, workspaceRoot, fs }) を呼ぶ。builtins には Task 3.2 のアグリゲータ結果を渡す。workspaceRoot には argv 解決結果を渡す。
• LoadExtensionsResult.loaded から ExtensionRecord[] を組み立てる。各レコードに、実 import() を行う loadModule() クロージャ、extensionUri、storagePath を供給する。この変換は core ではなく合成層（cli）の責務である。
• createExtensionHost({ extensions, api, log, sink }) を呼び、host を得る。Task 3.1 のクロージャがこの host を参照する。
• registration が返す extensionKeybindings を keymap の extension レイヤに供給し、binding table を再構築する。

Task 4: `onStartup` 起動と初期ファイル/ディレクトリのオープンを配線する

遅延フェーズ末尾の起動と初期オープンを実装する。

• registration 完了後に await host.activateStartupExtensions() を呼び、onStartup 拡張を起動する。
• Task 1.1 の解決結果に初期ファイル URI があれば、documents.openDocument(uri) を呼ぶ。これにより onLanguage:* 活性化が発火する。
• 引数がディレクトリの場合は初期ドキュメントを開かない。workspaceRoot の設定のみを行う。
• プロセス終了時に await host.disposeAll() を呼ぶ配線を設ける。

🤖 Prompt for AI agents

このフェーズでは遅延フェーズを実装する。拡張の discovery/registration/activation
を配線し、循環依存をクロージャの前方参照で解決し、argv 対象を開く。

1. 循環依存を前方参照クロージャで解決する。`packages/cli/src/main.ts`
の合成処理で、`host/activation.test.ts` が示す前方参照パターンを用いる。`createCommandRegistry` に
`activateExtension: (id) => host.activateExtension(id)` を渡す。`host`
は後続で宣言する。`createDocumentManager` に `onLanguageActivation: (languageId) =>
host.onLanguage(languageId)` を渡す。これらのフックはクロージャで `host` バインディングを参照し、実際の呼び出しは
`host` 初期化後にのみ発生させる。

2. ビルトインマニフェストのアグリゲータを追加する。`packages/builtin/` に集約モジュール（新規
`packages/builtin/index.ts`
等）を追加し、各サブパッケージの実マニフェストを配列として集約してエクスポートする。実マニフェストが未整備の現状は空配列を返す。`packages/cli/package.json`
の `dependencies` に `@tecode/builtin` を `workspace:*` で追加する。ESLint の階層ルールは `cli`
を除外対象としているため、`cli` からの `@tecode/builtin` import は許容される。

3. 遅延フェーズで拡張の読み込みと活性化を配線する。`loadExtensions({ log, sink, commands,
configRegistrar?, builtins, workspaceRoot, fs })` を呼ぶ。`builtins`
にはアグリゲータの結果を渡し、`workspaceRoot` には argv 解決結果を渡す。`LoadExtensionsResult.loaded` から
`ExtensionRecord[]` を組み立て、各レコードに実 `import()` を行う `loadModule()`
クロージャ、`extensionUri`、`storagePath` を供給する。この変換は core
ではなく合成層（cli）の責務とする。`createExtensionHost({ extensions, api, log, sink })` を呼び
`host` を得て、前方参照クロージャがこの `host` を参照するようにする。registration が返す
`extensionKeybindings` を keymap の `extension` レイヤに供給し、binding table を再構築する。

4. `onStartup` 起動と初期ファイル/ディレクトリのオープンを配線する。registration 完了後に `await
host.activateStartupExtensions()` を呼び、`onStartup` 拡張を起動する。argv 解決結果に初期ファイル URI
があれば `documents.openDocument(uri)` を呼び、`onLanguage:*`
活性化を発火させる。引数がディレクトリの場合は初期ドキュメントを開かず、`workspaceRoot` の設定のみを行う。プロセス終了時に `await
host.disposeAll()` を呼ぶ配線を設ける。

Phase 4: 起動スクリプト、統合テスト、スモーク検証

このフェーズは実行スクリプトを追加し、順序保証とタイミングの自動テストを追加する。

Task 1: ルートに `cli` スクリプトを追加する

bun run cli <dir> を成立させる。

• ルート package.json の scripts に cli を追加する。packages/cli/src/main.ts を実行し、引数を転送する。
• Phase 1 の終了基準（bun run cli が空シェルを開く）の入口を提供する。

Task 2: モジュール読み込みスパイによる統合テストを追加する

シェル描画が拡張の index.ts 読み込みより前に発生することを証明する。

• packages/cli/src/ に新規統合テストを追加する。layering.test.ts のサブプロセス+使い捨てフィクスチャ+try/finally クリーンアップの構成を参考にする。
• ディスク上にフィクスチャ拡張（index.ts がモジュール読み込み時に痕跡を記録するもの）を配置する。Bun.spawn で main.ts を起動する。
• シェル描画完了の記録が、拡張 index.ts の読み込み記録よりも前に発生することを構造化出力で検証する。
• 起動タイミングを取得し、100 ms 予算に余裕があることを検証する。フレークを避けるため、閾値には十分なヘッドルームを設ける。
• サブプロセス起動を伴うため、テストのデフォルトタイムアウトを引き上げる。

Task 3: 既存の合成配線テストを更新する

main.test.ts を新しい配線に合わせる。

• packages/cli/src/main.test.ts の buildAssemblyRoot 配線テストを、キーマップ配線と拡張ホストのフックを含む新しい合成に合わせて更新する。
• 既存の --version テストと API 名前空間・凍結・rootUri の検証は保持する。
• 一時ディレクトリで HOME/APPDATA を退避する既存パターンを踏襲する。

🤖 Prompt for AI agents

このフェーズでは実行スクリプトを追加し、順序保証とタイミングの自動テストを追加する。

1. ルートに `cli` スクリプトを追加する。ルート `package.json` の `scripts` に `cli`
を追加し、`packages/cli/src/main.ts` を実行して引数を転送するようにする。これにより `bun run cli <dir>`
が空シェルを開くという終了基準の入口を提供する。

2. モジュール読み込みスパイによる統合テストを追加する。`packages/cli/src/` に新規統合テストを追加し、`layering.test.ts`
のサブプロセス+使い捨てフィクスチャ+`try/finally` クリーンアップの構成を参考にする。ディスク上にフィクスチャ拡張（`index.ts`
がモジュール読み込み時に痕跡を記録するもの）を配置し、`Bun.spawn` で `main.ts` を起動する。シェル描画完了の記録が、拡張
`index.ts` の読み込み記録よりも前に発生することを構造化出力で検証する。起動タイミングを取得し、100 ms
予算に余裕があることを検証する。フレークを避けるため、閾値には十分なヘッドルームを設ける。サブプロセス起動を伴うため、テストのデフォルトタイムアウトを引き上げる。

3. 既存の合成配線テストを更新する。`packages/cli/src/main.test.ts` の `buildAssemblyRoot`
配線テストを、キーマップ配線と拡張ホストのフックを含む新しい合成に合わせて更新する。既存の `--version` テストと API
名前空間・凍結・`rootUri` の検証は保持する。一時ディレクトリで `HOME`/`APPDATA` を退避する既存パターンを踏襲する。

Research

本リポジトリは Bun/TypeScript のワークスペースモノレポである。@tecode/api は型のみの契約層である。@tecode/core はコマンドレジストリ、キーマップ、ドキュメント、設定、拡張ホスト（discovery/registration/activation）、API 組み立て（createTecodeApi/registerTecodeAlias）を実装する。@tecode/builtin はビルトイン拡張のプレースホルダを持つ。@tecode/cli は唯一の合成ルートである。@tecode/cli だけが @tecode/core を直接 import できる。

現状 packages/cli/src/main.ts の buildAssemblyRoot は UI 以外の core サービスをすべて配線する。createTecodeApi の直後に registerTecodeAlias を呼ぶ。ただし次の機能は未実装である。argv 解析（--version のみ対応）、config.ready の待機、キーマップの binding table 配線、拡張ホストの配線、シェル描画、タイミング計測。core 側の拡張ホスト部品（loadExtensions、createExtensionHost）は実装済みである。ただし main.ts からは呼ばれていない。

---

🚀 Next Steps

🤖 All AI agent prompts combined

Task: 1

このフェーズでは、`packages/cli/src/main.ts` を単一の `buildAssemblyRoot`
呼び出しから、明確に分離した起動フェーズへ再構成する。既存の `createTecodeApi` → `registerTecodeAlias`
の順序不変条件を保持する。

1. argv 解析を追加する。`main(argv)` を拡張し、既存の `--version` 分岐は保持する。位置引数を 1
つ受け取り、存在すれば絶対パスへ解決する。引数が無ければ `process.cwd()` を使う。解決したパスを `stat`
してディレクトリかファイルかを判定する。ディレクトリなら `workspaceRoot` に設定し初期ドキュメントは開かない。ファイルなら親ディレクトリを
`workspaceRoot` に設定し、そのファイルを遅延フェーズで開く対象として保持する。パス解決結果（`workspaceRoot` と任意の初期ファイル
URI）を後続フェーズへ渡す構造体として返す。

2. 起動シーケンスを同期フェーズと遅延フェーズに分離する。`main.ts`
に、同期フェーズ関数と遅延フェーズ関数を明確に分ける起動オーケストレータを実装する。同期フェーズは、設定とキーバインドの読み込み（`config.ready`
を待機）、端末機能検出スタブの実行、テーマ構築（現状は core の既定を使用）、シェル描画呼び出しの順に実行する。遅延フェーズは
`queueMicrotask` で最初のフレーム描画後にスケジュールし、discovery → registration → `onStartup` 起動 →
argv のファイル/ディレクトリのオープンの順に実行する。`buildAssemblyRoot` の既存不変条件（`registerTecodeAlias`
は `createTecodeApi` 直後、かつ拡張モジュール import
より厳密に前）を保持し、遅延フェーズの拡張活性化は必ずエイリアス登録後に実行する。

3. 端末機能検出スタブとシェル描画シームを追加する。端末機能検出スタブを `packages/cli/src/`
に追加し、固定の既定機能値を返すだけとする。実検出は別タスクの担当であるとコメントで明記する。シェル描画呼び出し点を `core/ui`
に対する単一の呼び出しとして構造化する。現状 `core/ui`
はプレースホルダであるため、別タスクが実体を埋める前提で呼び出しシームを設ける。描画呼び出しが返った直後を「最初のフレーム」とみなし、タイミング計測の終端点とする。

4. 起動タイミング計測を追加する。`performance.now()` を用いて、プロセス起動時点とシェル描画完了時点を記録する。経過時間を
`HostLog` 経由で構造化メトリクスとして出力し、CI 判定が参照できる形式にする。詳細出力は環境変数で制御可能にし、既定では簡潔にする。
===============================================================================

Task: 2

このフェーズでは、同期フェーズで設定からキーバインドを取り込み、キーマップの binding table を組み立てる。現状
`createBindingTable` はどの合成ルートからも呼ばれていないため、これを配線する。

- `packages/cli/src/main.ts` の合成処理で、`createConfigService` に
`onKeybindingsChange` フックを渡す。
- 同期フェーズで `config.ready` 待機後、`getKeybindingEntries()` を取得する。
- `createBindingTable` を呼び出し、`defaults` レイヤと、設定由来の `user` レイヤを組み合わせて binding
table を構築する。`fallback`（端末機能）レイヤと `extension` レイヤは後続フェーズで埋める前提とする。
- `onKeybindingsChange` 発火時に binding table を再構築する配線を設ける。
===============================================================================

Task: 3

このフェーズでは遅延フェーズを実装する。拡張の discovery/registration/activation
を配線し、循環依存をクロージャの前方参照で解決し、argv 対象を開く。

1. 循環依存を前方参照クロージャで解決する。`packages/cli/src/main.ts`
の合成処理で、`host/activation.test.ts` が示す前方参照パターンを用いる。`createCommandRegistry` に
`activateExtension: (id) => host.activateExtension(id)` を渡す。`host`
は後続で宣言する。`createDocumentManager` に `onLanguageActivation: (languageId) =>
host.onLanguage(languageId)` を渡す。これらのフックはクロージャで `host` バインディングを参照し、実際の呼び出しは
`host` 初期化後にのみ発生させる。

2. ビルトインマニフェストのアグリゲータを追加する。`packages/builtin/` に集約モジュール（新規
`packages/builtin/index.ts`
等）を追加し、各サブパッケージの実マニフェストを配列として集約してエクスポートする。実マニフェストが未整備の現状は空配列を返す。`packages/cli/package.json`
の `dependencies` に `@tecode/builtin` を `workspace:*` で追加する。ESLint の階層ルールは `cli`
を除外対象としているため、`cli` からの `@tecode/builtin` import は許容される。

3. 遅延フェーズで拡張の読み込みと活性化を配線する。`loadExtensions({ log, sink, commands,
configRegistrar?, builtins, workspaceRoot, fs })` を呼ぶ。`builtins`
にはアグリゲータの結果を渡し、`workspaceRoot` には argv 解決結果を渡す。`LoadExtensionsResult.loaded` から
`ExtensionRecord[]` を組み立て、各レコードに実 `import()` を行う `loadModule()`
クロージャ、`extensionUri`、`storagePath` を供給する。この変換は core
ではなく合成層（cli）の責務とする。`createExtensionHost({ extensions, api, log, sink })` を呼び
`host` を得て、前方参照クロージャがこの `host` を参照するようにする。registration が返す
`extensionKeybindings` を keymap の `extension` レイヤに供給し、binding table を再構築する。

4. `onStartup` 起動と初期ファイル/ディレクトリのオープンを配線する。registration 完了後に `await
host.activateStartupExtensions()` を呼び、`onStartup` 拡張を起動する。argv 解決結果に初期ファイル URI
があれば `documents.openDocument(uri)` を呼び、`onLanguage:*`
活性化を発火させる。引数がディレクトリの場合は初期ドキュメントを開かず、`workspaceRoot` の設定のみを行う。プロセス終了時に `await
host.disposeAll()` を呼ぶ配線を設ける。
===============================================================================

Task: 4

このフェーズでは実行スクリプトを追加し、順序保証とタイミングの自動テストを追加する。

1. ルートに `cli` スクリプトを追加する。ルート `package.json` の `scripts` に `cli`
を追加し、`packages/cli/src/main.ts` を実行して引数を転送するようにする。これにより `bun run cli <dir>`
が空シェルを開くという終了基準の入口を提供する。

2. モジュール読み込みスパイによる統合テストを追加する。`packages/cli/src/` に新規統合テストを追加し、`layering.test.ts`
のサブプロセス+使い捨てフィクスチャ+`try/finally` クリーンアップの構成を参考にする。ディスク上にフィクスチャ拡張（`index.ts`
がモジュール読み込み時に痕跡を記録するもの）を配置し、`Bun.spawn` で `main.ts` を起動する。シェル描画完了の記録が、拡張
`index.ts` の読み込み記録よりも前に発生することを構造化出力で検証する。起動タイミングを取得し、100 ms
予算に余裕があることを検証する。フレークを避けるため、閾値には十分なヘッドルームを設ける。サブプロセス起動を伴うため、テストのデフォルトタイムアウトを引き上げる。

3. 既存の合成配線テストを更新する。`packages/cli/src/main.test.ts` の `buildAssemblyRoot`
配線テストを、キーマップ配線と拡張ホストのフックを含む新しい合成に合わせて更新する。既存の `--version` テストと API
名前空間・凍結・`rootUri` の検証は保持する。一時ディレクトリで `HOME`/`APPDATA` を退避する既存パターンを踏襲する。

💡 Iterate on the plan with: `@coderabbitai` <feedback>

Example Feedback
- `@coderabbitai` You can skip phase 3. Add a simple unit test case for phase 2.
- `@coderabbitai` For design choice 1 go ahead with option 3 and replan.

---