bun-file-io

以下の場合に使用してください

• packages/opencode のファイル I/O またはスキャンを編集するとき
• ディレクトリ操作または外部ツールを扱うとき

Bun のファイル API（Bun のドキュメントより）

• Bun.file(path) は遅延実行されます。読み込むには text、json、stream、arrayBuffer、bytes、exists を呼び出します。
• メタデータ：file.size、file.type、file.name。
• Bun.write(dest, input) は文字列、バッファー、Blob、Response、ファイルを書き込みます。
• Bun.file(...).delete() はファイルを削除します。
• file.writer() は、段階的な書き込みに使う FileSink を返します。
• スキャンには Bun.Glob と Array.fromAsync(glob.scan({ cwd, absolute, onlyFiles, dot })) を使用します。
• バイナリを見つけるには Bun.which を使用し、その後 Bun.spawn で実行します。
• ストリーム出力には Bun.readableStreamToText/Bytes/JSON を使用します。

node:fs を使用する場合

• ディレクトリ操作（mkdir、readdir、再帰操作）には node:fs/promises を使用します。

リポジトリのパターン

• ファイルアクセスには Node fs より Bun API を優先してください。
• 読み込む前に Bun.file(...).exists() を確認してください。
• バイナリファイルや大容量ファイルには arrayBuffer() と、file.type による MIME チェックを使用してください。
• スキャンには Bun.Glob と Array.fromAsync を使用してください。
• ツールの stderr は Bun.readableStreamToText でデコードしてください。
• 大容量の書き込みには Bun.write(Bun.file(path), text) を使用してください。

NOTE: Bun.file(...).exists() は、値がディレクトリの場合に false を返します。 パスがファイルまたはディレクトリのどちらである可能性もある場合は、代わりに Filesystem.exists(...) を使用してください。

簡易チェックリスト

• まず Bun API を使用してください。
• パスには path.join／path.resolve を使用してください。
• 可能な場合は try/catch より Promise の .catch(...) を優先してください。