bitbank-lab-mcp: Instructions file for Claude Code

CLAUDE.md

コマンド

npm test                    # unit / integration（vitest）。tests/e2e/** は除外
npm run test:e2e            # stdio サブプロセス E2E（手動 / nightly。PR では走らせない）
npm run lint:fix            # Oxlint で自動修正
npm run format              # Biome でフォーマット
npm run gen:types           # Zod スキーマから型定義を生成
npm run typecheck           # tsc --noEmit

コード品質

• リンター（Biome / Oxlint）・pre-commit hook・banned-patterns が検出するルールに従う。 警告やエラーが出たら無視・回避せず修正する。
• 独自の可視化コード生成は禁止 → .claude/rules/charting.md
• コメントはコードから読み取れない理由だけを 1 行で書く → .claude/rules/comments.md

アーキテクチャ

• スキーマ変更は src/schema/ 配下の Zod 定義を単一ソースとする（src/schemas.ts は re-export）
• 全ツールは Result<T, M> パターン（ok() / fail()）で返す
• lib/ に共通ユーティリティがある処理は、外部ライブラリの直接利用や自前実装をせず lib/ を使う
• private API の接続先（src/private/client.ts）を環境変数・.env・設定ファイルから変えられるようにしない。 研究用の差し替えは lab/ の起動口だけ（npm の配布物に入らない。ADR-0008、ガードは tests/private-api-origin-tripwire.test.ts）。
• 対応ペアは JPY 建てのみ（表示層が円前提）。非 JPY 建て対応は別途、表示層の quote 通貨移行が前提（lib/validate.ts の ALLOWED_PAIRS、ガードは tests/lib/validate.test.ts）。
• stdio 以外のトランスポート（HTTP 等）を src/server.ts に足す変更は、同じ PR で confirmation_token の session / principal 束縛を実装しない限り入れない（ADR-0007 判断事項 B）。 トークンの HMAC ペイロードは action + params + expiresAt のみで session 束縛が無い （署名鍵の per-process nonce はプロセス境界を閉じるだけで、HTTP では 1 プロセスに複数 セッションが同居するため session 境界には効かない）。UI スナップショットの キーと MRTR の bind は未設定 sessionId を空文字に畳んでいる。stdio は 1 接続なので今日は無害だが、 HTTP を足した瞬間に別クライアントからの execute を弾けなくなる。ガードは tests/http-transport-tripwire.test.ts（必要な実装内容が失敗メッセージに出る）。

リポジトリルール

• main ブランチ保護。PR 経由でマージ。
• AGENTS.md は CLAUDE.md への symlink。