feat(reference): UnityCsReference のローカルキャッシュ参照機構（Phase 1）

[akiojin]

[akiojin]

Phase 1 ビルド完了報告

gwt-build-spec で SPEC #185 Phase 1 を TDD 完走しました。Issue 本文に section markers が無いため、本コメントで Tasks 完了状況と検証エビデンスを報告します。

Tasks（T1-T17 すべて完了）

• T1: src/reference/version.rs を新規作成。detect_from_project(project_root) と VERSION_BRANCH_MAP を実装。RED → GREEN → REFACTOR で 2 unit tests pass（2023.2.x → 2023.2/staging、未知バージョンは --branch ヒント付きエラー）
• T2: src/reference/cache.rs を新規作成。reference_root / version_dir / read_meta / write_meta / list_versions / gc(keep, dry_run) を実装。5 unit tests pass
• T3: src/reference/fetcher.rs を新規作成。build_clone_args 純関数、require_license_accepted、ensure_git_available、run_clone を実装。4 unit tests pass。GITHUB_TOKEN/GH_TOKEN を http.extraHeader=Authorization: token ... で透過注入
• T4: src/reference/search.rs を新規作成。walkdir + regex の run_grep（context lines 付き）と run_view（行範囲）。tests/fixtures/reference-cache/ を新設。5 unit tests pass
• T5: src/reference/mod.rs を maybe_execute_reference_tool(name, params) で reference_fetch / reference_status / reference_search / reference_grep / reference_view / reference_clean を分配する dispatcher 化。3 unit tests pass
• T6: src/main.rs に mod reference;、src/cli.rs の Command enum に Reference { command: ReferenceCommand }、ReferenceCommand を 6 subcommand で定義
• T7: src/app/runner.rs に Command::Reference 分岐と build_reference_call ヘルパを追加し、execute_tool("reference_*", params) 経由で呼び出し
• T8: src/tooling/tool_catalog.rs の TOOL_NAMES に reference_* 6 ツール追加 + tool_executor で Local 判定 + is_read_only_tool で fetch/clean を mutating、それ以外を read-only として登録 + tool_params_schema で個別 schema 定義
• T9: src/tooling/local_tools.rs::maybe_execute_local_tool 冒頭で crate::reference::maybe_execute_reference_tool に委譲
• T10: src/core/managed_binaries.rs::tools_root の隣に cache_root() を追加（UNITY_CLI_CACHE_ROOT 環境変数または ~/.unity/cache/ 既定）。1 unit test pass
• T11: .claude-plugin/plugins/unity-cli/skills/unity-csharp-reference/SKILL.md 新規作成（Skill Contract v1 準拠、unity-cli skills lint --severity error で 0 violations）
• T12: references/runtime-checklist.md / fetch-and-cache.md / symbol-lookup-playbook.md を新規作成
• T13: .claude/skills/unity-csharp-reference と .agents/skills/unity-csharp-reference を SKILL 正本へのシンボリックリンクとして追加。既存 unity-csharp-navigate / unity-csharp-edit / unity-scene-inspect の siblings に unity-csharp-reference を追加（R12/R22 解消）
• T14: docs/tools.md に「Reference Cache (6 tools)」セクション + README.ja.md の特徴に UnityCsReference キャッシュの 1 行を追加
• T15: ATTRIBUTION.md に Unity Companion License 出典を英文 + 日本語要約で追加
• T16: unity-cli skills lint --severity error → 15 skills checked, 0 violations
• T17: cargo fmt --all -- --check / cargo clippy --all-targets -- -D warnings / cargo test --bin unity-cli → 278 passed, 0 failed

検証エビデンス

$ cargo fmt -- --check
(no output → clean)

$ cargo clippy --all-targets -- -D warnings
    Finished `dev` profile [unoptimized + debuginfo] target(s)

$ cargo test --bin unity-cli
test result: ok. 278 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

$ unity-cli skills lint --severity error
15 skills checked, 0 violations

$ UNITY_CLI_CACHE_ROOT="$(mktemp -d)" unity-cli reference status --output json
{ "ok": true, "versions": [] }

受け入れ基準の状況

#	基準	状況
1	unity-cli reference fetch --accept-license で ProjectVersion.txt から検出して shallow clone	実装完了。実 GitHub clone は user の手元検証へ handoff
2	reference status --output json が {version, branch, fetchedAt, sizeBytes, path} を返す	unit test + CLI smoke で確認済み
3	reference grep "class Animator " --context 3 が行番号付きで返す	unit test で確認（fixture）
4	reference view <path> --start-line N --max-lines M でソース表示	unit test で確認（fixture）
5	reference clean --keep 1 --dry-run で削除候補提示	unit test で確認
6	fmt / clippy / test / skills lint 全 Pass	4 ゲート全 Pass（上記参照）
7	ATTRIBUTION.md に Unity Companion License 出典	追記完了
8	README.ja.md と docs/tools.md に新 tool / skill 追記	追記完了
9	LLM が「Animator.Play のシグネチャと内部実装を見たい」で unity-csharp-reference を選択	description trigger 設計済み（実環境での選択確認は user 手元検証へ handoff）

残し（Phase 2/3 別 SPEC 候補）

• Phase 2: reference find-symbol --name <name> --kind <kind> シンボル lookup インデックス
• Phase 3: reference diff <v1> <v2> --symbol <fqn> バージョン差分 + LSP go-to-definition 連携実験

Next

PR 作成（gwt-manage-pr）の承認を user に確認します。