3.3 Build explorer

[goofmint]

Part of Phase 3 — Directory workflow (tasks.md Task 3.3).

Summary

Build the file explorer: tree view, file operations, and .gitignore-aware visibility.

Details

• Tree view using the tecode.ui Tree component over workspace.fs.readdir + watch (live refresh on external changes).
• Open file on enter; create/rename/delete via showInputBox prompts with error surfacing; delete confirms first.
• .gitignore visibility: check git availability once (Bun.spawn(["git","--version"])); if present, batch git check-ignore --stdin per directory; otherwise a minimal .gitignore glob matcher (*, **, / anchors, ! negation, trailing-/ dirs).
• explorer.showHidden setting bypasses ignore logic and dotfile hiding; live-updates on config change.
• explorerFocus context key; ctrl+shift+e focuses the view (activity-bar registration per Req 6.2).
• Expose the ignore-aware walk as the shared utility consumed by ctrl+p (Task 3.2).

Completion requirements

• Glob matcher test suite (anchors, **, negation, directory patterns)
• git/no-git switch covered (spawn stubbed both ways)
• Tree create/rename/delete verified against a temp directory, incl. error paths (existing name, permission denied)
• watch-driven refresh on external file creation
• explorer.showHidden toggle reflects without restart
• bun test and lint pass

References

• requirements.md: Req 11.2
• design.md: §13

Dependencies

Blocked by: 3.1 (#27) for prompts; tree rendering only needs Phase 1 (#16).

[goofmint]

@coderabbitai make plan in Japanese

---

Generated by Claude Code

[coderabbitai]

Coding Plan

Summary

• ホスト側に不足するプリミティブ（fs の書き込み操作、Tree のキーボード操作・制御展開・起動・フォーカス連携）をコアへ追加する。
• .gitignore 判定と走査を packages/builtin/ 配下の共有モジュールとして新規作成する。注入可能な GitRunner で git 有無を切り替える。ctrl+p から再利用できるよう公開する。
• explorer 本体は @tecode/api のみに依存する。manifest 宣言と activate 配線で、ツリー表示・ファイル操作・設定ライブ更新・explorerFocus を実現する。
• 一時ディレクトリと GitRunner スタブを用いたテストで、ファイル操作・watch 更新・showHidden 切替・glob/git 切替を検証する。

Design Choices

Design Choice 1: 削除確認の UI をどう実装するか

Options Considered:

1. showQuickPick に Delete / Cancel の 2 項目を渡して確認する。
2. showInputBox にファイル名の再入力を求めて確認する。

Chosen Option: 1

Rationale: 既存のブロッキングプリミティブを使う。最小の操作で確認できる。showMessage はボタンを持たない。ブロッキングな確認手段が必要である。

Design Choice 2: explorerFocus コンテキストキーをどこで設定するか

Options Considered:

1. コア側 Tree に focusContextKey プロパティを追加し、内部で useFocusTracking を使う。
2. explorer 拡張が @opentui/react を直接依存に加えてフォーカスイベントを処理する。

Chosen Option: 1

Rationale: 既存の findWidgetFocus パターンを再利用できる。拡張側を UI 配管から切り離せる。組み込み拡張は @tecode/core の useFocusTracking を import できない。

Design Choice 3: 無視判定つき走査ユーティリティをどこに置くか

Options Considered:

1. packages/builtin/ 配下に新しい共有サブフォルダを作り、@tecode/api のみを import する。
2. explorer 内部に実装し、command-palette から相対 import する。

Chosen Option: 1

Rationale: 階層ルールを満たしつつ重複を避ける。共有意図を明確にできる。explorer と command-palette の両方が同一ロジックを使う。

Design Choice 4: git 検出のテスト容易性をどう確保するか

Options Considered:

1. DiscoveryFs の前例に倣い、注入可能な spawn シーム（GitRunner）を設け、既定で Bun.spawn を使う。
2. 実際のサブプロセスを起動し、PATH を操作して git を隠す。

Chosen Option: 1

Rationale: 環境依存の不安定さを避ける。既存の注入シーム慣習に一致する。Bun.spawn はグローバルであり、既存のスタブ実装がない。

💡 User Tips

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

Implementation Steps

Phase 1: ホスト基盤の拡張

このフェーズでは、explorer が必要とするホスト側プリミティブを追加する。ファイルシステムに書き込み系操作を追加する。Tree コンポーネントにキーボード操作・制御可能な展開状態・起動コールバック・フォーカス連携を追加する。両者はコアに閉じた変更であり、explorer 本体より先に用意する。

Task 1: FileSystem に delete/rename/mkdir を追加

ファイル作成・リネーム・削除に必要な書き込み系メソッドを追加する。

• packages/api/src/namespaces.ts の FileSystem インターフェースに delete(uri)、rename(oldUri, newUri)、mkdir(uri) を追加する。
• packages/core/src/buffer/fileSystem.ts の createFileSystem に、node:fs/promises を用いた実装を追加する。
• 既存 read/write と同じく、失敗時は reject する。エラー内容は保持する（呑み込まない）。
• packages/core/src/buffer/fileSystem.test.ts に、一時ディレクトリでの作成・リネーム・削除の成功系と、既存名・権限拒否などの失敗系のテストを追加する。

Task 2: Tree コンポーネントの拡張

「Enter で開く」「矢印キーで移動」「フォーカス連携」を実現するため Tree を拡張する。

• packages/core/src/ui/components.tsx の Tree に、制御可能な展開状態（expandedIds と onToggle）を追加する。既存の非制御 defaultExpanded は後方互換で残す。
• onActivate(id) プロパティを追加する。ルートがフォーカス中のとき、上下キーで選択移動、左右キーで折り畳み・展開、Enter で onActivate を発火する。
• 任意の focusContextKey プロパティを追加する。指定時はルートの focusable ノードで ui/focus.tsx の useFocusTracking を用いてフォーカス状態をコンテキストキーへ反映する。
• packages/core/src/ui/components.test.tsx に、制御された展開、キーボード移動、Enter による起動、フォーカスキー反映のテストを追加する。

🤖 Prompt for AI agents

このフェーズでは、explorer 拡張が必要とするホスト側プリミティブをコアへ追加する。目的は、ファイルシステムの書き込み系操作と、Tree
コンポーネントのキーボード操作・フォーカス連携を用意することである。

FileSystem の拡張:
- `packages/api/src/namespaces.ts` の `FileSystem` インターフェースに
`delete(uri)`、`rename(oldUri, newUri)`、`mkdir(uri)` を追加する。
- `packages/core/src/buffer/fileSystem.ts` の `createFileSystem` に
`node:fs/promises` を用いた実装を追加する。
- 失敗時は既存の `read`/`write` と同様に reject する。エラー内容を呑み込まない。
- `packages/core/src/buffer/fileSystem.test.ts`
に、一時ディレクトリを用いた成功系（作成・リネーム・削除）と失敗系（既存名・権限拒否）のテストを追加する。

Tree コンポーネントの拡張:
- `packages/core/src/ui/components.tsx` の `Tree` に、制御可能な展開状態として `expandedIds` と
`onToggle` を追加する。既存の非制御 `defaultExpanded` は後方互換のため残す。
- `onActivate(id)` プロパティを追加する。ルートがフォーカス中のとき、上下キーで選択移動、左右キーで折り畳み・展開、Enter で
`onActivate` を発火するようにする。
- 任意の `focusContextKey` プロパティを追加する。指定時は、ルートの focusable ノードで `ui/focus.tsx` の
`useFocusTracking` を用いてフォーカス状態をコンテキストキーへ反映する。
- `packages/core/src/ui/components.test.tsx` に、制御された展開、キーボード移動、Enter
による起動、フォーカスキー反映についてのテストを追加する。

Phase 2: 無視判定つきワークスペース走査の共有ユーティリティ

このフェーズでは、.gitignore を考慮した表示・走査ロジックを共有モジュールとして新規作成する。git 検出、git check-ignore のバッチ実行、最小 glob マッチャ、explorer.showHidden による回避を含む。command-palette の ctrl+p（Task 3.2）が再利用できるよう公開する。

Task 1: git 検出と check-ignore のバッチ実行

git が利用可能なとき、git の無視判定に委譲する。

• packages/builtin/ 配下に新しい共有サブフォルダ（例: packages/builtin/shared/）を作成する。@tecode/api のみを import する。
• 起動時に一度だけ git --version を実行して git の有無を判定し、結果をキャッシュする。
• git がある場合、1 ディレクトリ分の候補パスを標準入力へまとめて渡し、git check-ignore --stdin をバッチ実行して無視対象を判定する。
• Bun.spawn を直接呼ばず、注入可能な GitRunner シームを介する。既定実装は Bun.spawn を用いる。

Task 2: 最小 .gitignore glob マッチャ

git が無いときの代替として、最小の glob マッチャを実装する。

• 同じ共有サブフォルダに、.gitignore の一般的なパターンを扱うマッチャを実装する。
• *、**、/ アンカー、! 否定、末尾 / のディレクトリパターンを扱う。
• パスは uriToPath 相当で素のパスへ変換する。その後、node:path の relative でルート相対に正規化してから判定する。

Task 3: 無視判定つき走査ユーティリティの公開

両ブランチと表示設定を統合した走査ユーティリティを公開する。

• git 判定と glob マッチャを束ねる。showHidden が真のときは無視判定とドットファイル非表示の両方を回避する走査関数を提供する。
• 走査は tecode.workspace.fs.readdir を用いる。ディレクトリ単位で候補を無視判定にかける。
• explorer と command-palette の双方から import できる形でエクスポートする。
• glob マッチャのパターン別ケース、git 有無の切り替え（GitRunner を両方向にスタブ）をテストする。

🤖 Prompt for AI agents

このフェーズでは、`.gitignore` を考慮した表示・走査ロジックを共有モジュールとして新規作成する。目的は、explorer と
command-palette（`ctrl+p`、Task 3.2）の両方から再利用できる走査ユーティリティを提供することである。

git 検出と check-ignore:
- `packages/builtin/` 配下に新しい共有サブフォルダ（例:
`packages/builtin/shared/`）を作成する。このモジュールは `@tecode/api` のみを import する。
- 起動時に一度だけ `git --version` を実行し、git の有無を判定してキャッシュする。
- git がある場合、1 ディレクトリ分の候補パスをまとめて標準入力へ渡し、`git check-ignore --stdin`
をバッチ実行して無視対象を判定する。
- `Bun.spawn` を直接呼ばず、注入可能な `GitRunner` シームを介する。既定実装は `Bun.spawn` を用いる。

最小 glob マッチャ:
- git が無いときの代替として、同じ共有サブフォルダに `.gitignore` の一般的なパターンを扱うマッチャを実装する。
- `*`、`**`、`/` アンカー、`!` 否定、末尾 `/` のディレクトリパターンを扱う。
- パスは `uriToPath` 相当で素のパスへ変換し、`node:path` の `relative` でルート相対に正規化してから判定する。

走査ユーティリティの公開:
- git 判定と glob マッチャを統合する。`showHidden` が真のときは、無視判定とドットファイル非表示の両方を回避する走査関数を提供する。
- 走査は `tecode.workspace.fs.readdir` を用いる。ディレクトリ単位で候補を無視判定にかける。
- explorer と command-palette の双方から import できる形でエクスポートする。
- glob マッチャのパターン別ケースと、`GitRunner` を両方向にスタブした git 有無の切り替えをテストする。

Phase 3: explorer 拡張の実装

このフェーズでは、explorer 拡張本体を組み立てる。manifest で貢献を宣言する。ビュー・コマンド・コンテキストキー・設定購読を activate で登録する。ツリー状態を readdir と watch から構築し、外部変更で更新する。ファイル操作は showInputBox と削除確認で行う。最後に組み込み集約点へ登録する。

Task 1: explorer マニフェストの作成

貢献を宣言し、アクティビティバー項目とビューの対を生成する。

• packages/builtin/explorer/manifest.ts を新規作成する。export default {...} satisfies Manifest の形にする。@tecode/api の型のみ import する。
• contributes.views に { id: "explorer", title: "Explorer", slot: "sidebar", icon: ... } を宣言し、アクティビティバー項目を自動生成する。
• contributes.commands に開く・作成・リネーム・削除・フォーカスの各コマンドを宣言する。
• contributes.keybindings に ctrl+shift+e をフォーカスコマンドへ、Enter などの操作を when: "explorerFocus" で宣言する。
• contributes.configuration.properties["explorer.showHidden"] を type: "boolean"、default、description 付きで宣言する。
• activationEvents にフォーカスコマンドの onCommand: を指定する。サイドバー切替時は requestActivation による遅延起動に任せる。

Task 2: ExplorerView コンポーネントの作成

ツリー表示とフォーカス連携を担う React コンポーネントを作成する。

• packages/builtin/explorer/ に、tecode.ui.Tree を包む React コンポーネントを作成する。@tecode/core は import しない。
• explorer のツリーストア（readdir と watch から構築）を購読し、変更時に再描画する。
• Tree に nodes、selectedId、expandedIds、onSelect、onToggle、onActivate、focusContextKey="explorerFocus" を渡す。
• onActivate はファイルを開く処理へ接続する。onSelect は選択更新へ接続する。
• コンポーネント作成のため packages/builtin/package.json に react 依存を追加する。

Task 3: activate による登録とファイル操作

ツリー状態・ビュー・コマンド・設定購読を配線する。

• packages/builtin/explorer/index.ts を実装し、activate(ctx) と deactivate() を公開する。
• ctx.api.workspace.rootUri を起点にツリー状態を構築する。rootUri が undefined のときは空表示に劣化させる。
• ctx.api.workspace.fs.watch を購読する。created/deleted/changed で該当ディレクトリを再読込してストアを更新する。
• ctx.api.ui.registerView("sidebar.view", "explorer", ExplorerView) でビューを登録する。
• explorer.showHidden を起動時に一度読む。onDidChange で affectsConfiguration("explorer.showHidden") を判定してライブ更新する（editor-core と同じ形）。
• 開くコマンドは ctx.api.workspace.openDocument(uri) を呼ぶ。作成・リネームは showInputBox（validateInput で不正名を弾く）で名前を得て Phase 1 の fs 操作を呼ぶ。削除は showQuickPick の Delete/Cancel で確認してから削除する。
• 操作失敗時は showMessage(..., "error") でエラーを表示する。
• 登録物はすべて ctx.subscriptions に push する。

Task 4: 組み込み集約点への登録

explorer を組み込み拡張として有効化する。

• packages/builtin/index.ts の builtinManifests に explorer の manifest を追加する。
• builtinModules に { [manifest.id]: module } を追加する。
• 埋め込みアセットは無いため、アセットマップの変更は不要である。

Task 5: explorer の統合テスト

一時ディレクトリに対して主要な振る舞いを検証する。

• packages/builtin/explorer/ にテストを追加する。作成・リネーム・削除を一時ディレクトリで検証する。既存名・権限拒否の失敗系も含める。
• 外部でのファイル作成に対する watch 駆動の更新を、waitFor ヘルパで検証する。
• explorer.showHidden の切り替えが再起動なしで表示へ反映されることを検証する。
• 既存の index.test.ts のプレースホルダテストを実装に合わせて置き換える。

🤖 Prompt for AI agents

このフェーズでは、explorer
拡張本体を組み立てる。目的は、ツリー表示・ファイル操作・設定連携・フォーカス連携を備えた組み込み拡張として動作させることである。

マニフェストの作成:
- `packages/builtin/explorer/manifest.ts` を新規作成する。`export default {...}
satisfies Manifest` の形にする。`@tecode/api` の型のみ import する。
- `contributes.views` に `{ id: "explorer", title: "Explorer", slot: "sidebar",
icon: ... }` を宣言する。これによりアクティビティバー項目を自動生成する。
- `contributes.commands` に開く・作成・リネーム・削除・フォーカスの各コマンドを宣言する。
- `contributes.keybindings` に `ctrl+shift+e` をフォーカスコマンドへ割り当てる。Enter などの操作は
`when: "explorerFocus"` で宣言する。
- `contributes.configuration.properties["explorer.showHidden"]` を `type:
"boolean"`、`default`、`description` 付きで宣言する。
- `activationEvents` にフォーカスコマンドの `onCommand:` を指定する。サイドバー切替時は
`requestActivation` による遅延起動に任せる。

ExplorerView コンポーネントの作成:
- `packages/builtin/explorer/` に `tecode.ui.Tree` を包む React
コンポーネントを作成する。`@tecode/core` は import しない。
- explorer のツリーストア（`readdir` と `watch` から構築）を購読し、変更時に再描画する。
- `Tree` に
`nodes`、`selectedId`、`expandedIds`、`onSelect`、`onToggle`、`onActivate`、`focusContextKey="explorerFocus"`
を渡す。
- `onActivate` はファイルを開く処理へ、`onSelect` は選択更新へ接続する。
- `packages/builtin/package.json` に `react` 依存を追加する。

activate による登録とファイル操作:
- `packages/builtin/explorer/index.ts` に `activate(ctx)` と `deactivate()` を実装する。
- `ctx.api.workspace.rootUri` を起点にツリー状態を構築する。`rootUri` が `undefined`
のときは空表示に劣化させる。
- `ctx.api.workspace.fs.watch` を購読する。`created`/`deleted`/`changed`
の通知を受けたら該当ディレクトリを再読込してストアを更新する。
- `ctx.api.ui.registerView("sidebar.view", "explorer", ExplorerView)` でビューを登録する。
- `explorer.showHidden` を起動時に一度読む。`onDidChange` で
`affectsConfiguration("explorer.showHidden")` を判定し、editor-core と同じ形でライブ更新する。
- 開くコマンドは `ctx.api.workspace.openDocument(uri)` を呼ぶ。作成・リネームは
`showInputBox`（`validateInput` で不正名を弾く）で名前を取得し、Phase 1 の fs 操作を呼ぶ。削除は
`showQuickPick` の `Delete`/`Cancel` で確認してから実行する。
- 操作失敗時は `showMessage(..., "error")` でエラーを表示する。
- 登録物はすべて `ctx.subscriptions` に push する。

組み込み集約点への登録:
- `packages/builtin/index.ts` の `builtinManifests` に explorer の manifest を追加する。
- `builtinModules` に `{ [manifest.id]: module }` を追加する。
- 埋め込みアセットの変更は不要である。

統合テスト:
- `packages/builtin/explorer/`
にテストを追加する。作成・リネーム・削除の成功系と、既存名・権限拒否の失敗系を一時ディレクトリで検証する。
- 外部でのファイル作成に対する `watch` 駆動の更新を `waitFor` ヘルパで検証する。
- `explorer.showHidden` の切り替えが再起動なしで表示へ反映されることを検証する。
- 既存の `index.test.ts` のプレースホルダテストを実装に合わせて置き換える。

Research

packages/builtin/explorer は現在プレースホルダのみである。manifest.ts は存在しない。組み込み拡張は @tecode/api だけを import できる。@tecode/core の直接 import は ESLint の階層ルールで禁止されている。ホスト側の基盤は多くが既に存在する。

tecode.workspace.fs は read/write/stat/readdir/watch を提供するが、delete/rename/mkdir は存在しない。

tecode.ui.Tree は最小構成で、展開状態は非制御であり、キーボード操作と onActivate を持たない。

contributes.views（slot: "sidebar"）はアクティビティバー項目を自動生成する。

tecode.window.showInputBox は validateInput を持ち、showMessage はボタンを持たないトースト表示である。

tecode.context.set/get はコンテキストキーを設定する。設定内容は when 評価に即時反映される。

ui/focus.tsx の useFocusTracking は、フォーカスをコンテキストキーへ反映する既存パターンである。

tecode.workspace.rootUri はツリーの起点となる。

git 検出・check-ignore・glob マッチャは未実装である。Bun.spawn のスタブ実装は存在しないため、注入可能なシームを設ける必要がある。

---

🚀 Next Steps

🤖 All AI agent prompts combined

Task: 1

このフェーズでは、explorer 拡張が必要とするホスト側プリミティブをコアへ追加する。目的は、ファイルシステムの書き込み系操作と、Tree
コンポーネントのキーボード操作・フォーカス連携を用意することである。

FileSystem の拡張:
- `packages/api/src/namespaces.ts` の `FileSystem` インターフェースに
`delete(uri)`、`rename(oldUri, newUri)`、`mkdir(uri)` を追加する。
- `packages/core/src/buffer/fileSystem.ts` の `createFileSystem` に
`node:fs/promises` を用いた実装を追加する。
- 失敗時は既存の `read`/`write` と同様に reject する。エラー内容を呑み込まない。
- `packages/core/src/buffer/fileSystem.test.ts`
に、一時ディレクトリを用いた成功系（作成・リネーム・削除）と失敗系（既存名・権限拒否）のテストを追加する。

Tree コンポーネントの拡張:
- `packages/core/src/ui/components.tsx` の `Tree` に、制御可能な展開状態として `expandedIds` と
`onToggle` を追加する。既存の非制御 `defaultExpanded` は後方互換のため残す。
- `onActivate(id)` プロパティを追加する。ルートがフォーカス中のとき、上下キーで選択移動、左右キーで折り畳み・展開、Enter で
`onActivate` を発火するようにする。
- 任意の `focusContextKey` プロパティを追加する。指定時は、ルートの focusable ノードで `ui/focus.tsx` の
`useFocusTracking` を用いてフォーカス状態をコンテキストキーへ反映する。
- `packages/core/src/ui/components.test.tsx` に、制御された展開、キーボード移動、Enter
による起動、フォーカスキー反映についてのテストを追加する。
===============================================================================

Task: 2

このフェーズでは、`.gitignore` を考慮した表示・走査ロジックを共有モジュールとして新規作成する。目的は、explorer と
command-palette（`ctrl+p`、Task 3.2）の両方から再利用できる走査ユーティリティを提供することである。

git 検出と check-ignore:
- `packages/builtin/` 配下に新しい共有サブフォルダ（例:
`packages/builtin/shared/`）を作成する。このモジュールは `@tecode/api` のみを import する。
- 起動時に一度だけ `git --version` を実行し、git の有無を判定してキャッシュする。
- git がある場合、1 ディレクトリ分の候補パスをまとめて標準入力へ渡し、`git check-ignore --stdin`
をバッチ実行して無視対象を判定する。
- `Bun.spawn` を直接呼ばず、注入可能な `GitRunner` シームを介する。既定実装は `Bun.spawn` を用いる。

最小 glob マッチャ:
- git が無いときの代替として、同じ共有サブフォルダに `.gitignore` の一般的なパターンを扱うマッチャを実装する。
- `*`、`**`、`/` アンカー、`!` 否定、末尾 `/` のディレクトリパターンを扱う。
- パスは `uriToPath` 相当で素のパスへ変換し、`node:path` の `relative` でルート相対に正規化してから判定する。

走査ユーティリティの公開:
- git 判定と glob マッチャを統合する。`showHidden` が真のときは、無視判定とドットファイル非表示の両方を回避する走査関数を提供する。
- 走査は `tecode.workspace.fs.readdir` を用いる。ディレクトリ単位で候補を無視判定にかける。
- explorer と command-palette の双方から import できる形でエクスポートする。
- glob マッチャのパターン別ケースと、`GitRunner` を両方向にスタブした git 有無の切り替えをテストする。
===============================================================================

Task: 3

このフェーズでは、explorer
拡張本体を組み立てる。目的は、ツリー表示・ファイル操作・設定連携・フォーカス連携を備えた組み込み拡張として動作させることである。

マニフェストの作成:
- `packages/builtin/explorer/manifest.ts` を新規作成する。`export default {...}
satisfies Manifest` の形にする。`@tecode/api` の型のみ import する。
- `contributes.views` に `{ id: "explorer", title: "Explorer", slot: "sidebar",
icon: ... }` を宣言する。これによりアクティビティバー項目を自動生成する。
- `contributes.commands` に開く・作成・リネーム・削除・フォーカスの各コマンドを宣言する。
- `contributes.keybindings` に `ctrl+shift+e` をフォーカスコマンドへ割り当てる。Enter などの操作は
`when: "explorerFocus"` で宣言する。
- `contributes.configuration.properties["explorer.showHidden"]` を `type:
"boolean"`、`default`、`description` 付きで宣言する。
- `activationEvents` にフォーカスコマンドの `onCommand:` を指定する。サイドバー切替時は
`requestActivation` による遅延起動に任せる。

ExplorerView コンポーネントの作成:
- `packages/builtin/explorer/` に `tecode.ui.Tree` を包む React
コンポーネントを作成する。`@tecode/core` は import しない。
- explorer のツリーストア（`readdir` と `watch` から構築）を購読し、変更時に再描画する。
- `Tree` に
`nodes`、`selectedId`、`expandedIds`、`onSelect`、`onToggle`、`onActivate`、`focusContextKey="explorerFocus"`
を渡す。
- `onActivate` はファイルを開く処理へ、`onSelect` は選択更新へ接続する。
- `packages/builtin/package.json` に `react` 依存を追加する。

activate による登録とファイル操作:
- `packages/builtin/explorer/index.ts` に `activate(ctx)` と `deactivate()` を実装する。
- `ctx.api.workspace.rootUri` を起点にツリー状態を構築する。`rootUri` が `undefined`
のときは空表示に劣化させる。
- `ctx.api.workspace.fs.watch` を購読する。`created`/`deleted`/`changed`
の通知を受けたら該当ディレクトリを再読込してストアを更新する。
- `ctx.api.ui.registerView("sidebar.view", "explorer", ExplorerView)` でビューを登録する。
- `explorer.showHidden` を起動時に一度読む。`onDidChange` で
`affectsConfiguration("explorer.showHidden")` を判定し、editor-core と同じ形でライブ更新する。
- 開くコマンドは `ctx.api.workspace.openDocument(uri)` を呼ぶ。作成・リネームは
`showInputBox`（`validateInput` で不正名を弾く）で名前を取得し、Phase 1 の fs 操作を呼ぶ。削除は
`showQuickPick` の `Delete`/`Cancel` で確認してから実行する。
- 操作失敗時は `showMessage(..., "error")` でエラーを表示する。
- 登録物はすべて `ctx.subscriptions` に push する。

組み込み集約点への登録:
- `packages/builtin/index.ts` の `builtinManifests` に explorer の manifest を追加する。
- `builtinModules` に `{ [manifest.id]: module }` を追加する。
- 埋め込みアセットの変更は不要である。

統合テスト:
- `packages/builtin/explorer/`
にテストを追加する。作成・リネーム・削除の成功系と、既存名・権限拒否の失敗系を一時ディレクトリで検証する。
- 外部でのファイル作成に対する `watch` 駆動の更新を `waitFor` ヘルパで検証する。
- `explorer.showHidden` の切り替えが再起動なしで表示へ反映されることを検証する。
- 既存の `index.test.ts` のプレースホルダテストを実装に合わせて置き換える。

💡 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.

---