ビルドの検証

LocalLens にはプロジェクトが気にするチェックをすべて実行する複合スクリプトが 1 つあります。

bun run check

実際に走る内容

bun run check は 4 ステップをチェーンします。それぞれ個別にも実行できます。

ステップ	コマンド	内容
Lint + フォーマット	`bun run lint`(`biome check .`)	リポジトリ全体のスタイルチェックと明らかなバグの検出。設定は `biome.json`。
型	`bun run typecheck`(`tsc --noEmit`)	`src/` と `tests/` に対する TypeScript strict mode。
テスト	`bun run test`	`tests/` 配下の Bun テスト。現在は `chunker.test.ts` と `prompt.test.ts`。
ビルド	`bun run build`	`bun build src/server.ts --target=bun --outdir=dist`。バンドラーで壊れないことを確認するスモークテスト。

どれか 1 つでも失敗すれば、スクリプト全体が非ゼロで終了します。CI も同じスクリプトを実行します。

テストファイルは 2 つだけです。静かに退行(リグレッション)しやすい部分を重点的にカバーしています。

tests/chunker.test.ts — chunkDocument が安定したソースメタデータ付きの重複チャンクを生成し、不正なチャンク設定を拒否することを検証します。
tests/prompt.test.ts — buildGroundedHistory がソース文脈と「文脈なし」フォールバックを含むこと、システムプロンプトがソースに基づいた回答を強制すること、ブラケット引用フォーマットが組み込まれていることを検証します。

src/rag.ts か src/files.ts に手を入れる場合、これらのテストが第一防衛線になります。

bun run format

Biome を --write で実行します。pre-commit ステップとして便利です。