mcp-ts-morph: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

概要

MCP ts-morph Refactoring Tools - ts-morphを利用したTypeScript/JavaScriptのリファクタリングツールを提供するMCPサーバー。

開発コマンド

ビルド

pnpm build        # TypeScriptをコンパイル（dist/に出力）
pnpm clean        # distディレクトリをクリーン

テスト

pnpm test         # テスト実行（単一スレッドで実行）
pnpm test:watch   # ウォッチモードでテスト実行
pnpm test -- path/to/test.ts  # 特定のテストファイルを実行
pnpm test:e2e     # 実リポジトリ E2E（hono/zustand を clone して全ツール適用）

E2E テスト（pnpm test:e2e）

e2e/ は、バージョン固定の実 OSS（hono / zustand）を clone し、各 MCP ツールを 実プロジェクトに適用して「差分緑」（baseline と比較し新規型エラー・新規失敗テスト が無いこと）を検証する。ユニットテストでは拾えない実世界の AST 不整合を掘り当てる （例: move_symbol_to_file の逆向き import バグ）。

• デフォルトの pnpm test からは除外（vitest.config.ts の exclude）。CI には 未組み込み（nightly + 手動 dispatch を予定）。
• 初回は clone + 依存インストールが走る（bun / pnpm が必要。無ければ baseline 未取得で各ケース skip）。2 回目以降は e2e/.cache/*.ready マーカで再利用。
• 実行時間の目安: キャッシュ有りで 2〜3 分。

Claude への指示: src/ts-morph/** のリファクタロジック（特に move-symbol-to-file / rename-* / remove-path-alias / change-signature）に 触れた変更は、仕上げ段階（コミット前 / PR 化前）で pnpm test:e2e を実行して 実リポジトリで退行が無いことを確認すること。時間がかかるので開発の各イテレーション ではなく、まとまった作業の最後に回す。ネットワークや bun 不在で skip された場合は その旨をユーザーに伝える。

型チェック・リント・フォーマット

pnpm check-types  # TypeScriptの型チェック（コンパイルなし）
pnpm lint         # Biomeでリントチェック
pnpm lint:fix     # Biomeでリント修正
pnpm format       # Biomeでコードフォーマット

デバッグ

pnpm inspector    # MCP Inspectorでデバッグ実行

リリース（バージョン bump）

Git タグが単一の真実の source。手で bump しない。

• package.json の version と src/version.ts の VERSION はどちらも 0.0.0-development に固定。
• リリースは git tag vX.Y.Z && git push origin vX.Y.Z のみ。
• .github/workflows/release.yml が tag から値を抽出して両ファイルを書き換え、pnpm build → pnpm test → dist の整合性確認 → pnpm publish を実行する。
• 詳細手順は .claude/skills/release/SKILL.md および README の「リリース」セクション参照。
• ユーザーから「リリース」「タグを打って」等を言われたら release skill を使うこと。

プロジェクト構造

コアアーキテクチャ