validate サブコマンドで設定・接続を診断

[polidog]

背景

env-sync 実行時に以下の警告が出るが、原因（teamId 未設定 / token のスコープ違い / projectId 不一致 など）を切り分ける手段がない。

警告: 既存 key の取得に失敗したため新規/更新の分類をスキップします: 既存 key 取得失敗: HTTP 404: Project not found.

設定・認証・API 到達性を読み取り専用で診断する validate サブコマンドを用意し、何が原因か self-service で調べられるようにする。

requirements

• env-sync に validate サブコマンドを追加する（cmd/env-sync/main.go の os.Args 分岐に setup と同様の形で追加）
• 認証 config（.env-sync.config.yaml / ~/.config/env-sync/config.yaml）・env-sync.yaml・.env(.production) を読み込み、設定の解決結果を表示する
• Vercel ターゲットごとに token / projectId / teamId の 解決値と取得元（環境変数 / config / .vercel/project.json の orgId）を表示する。token は値をマスクする
• 実際に Vercel API（GET /v10/projects/{projectID}/env 等）を叩き、projectId + teamId + token の組み合わせが有効かを検証して HTTP ステータスを表示する
• 失敗時（404 / 403 等）に推定原因を提示する:
  • 404 → teamId 未設定でチーム配下プロジェクトに到達できていない可能性 / projectId 不一致
  • 401 / 403 → token のスコープ・権限違い
• GitHub プロバイダーが対象の場合は repo / token の有効性も検証する（余力があれば）
• validate は 読み取り専用。環境変数の登録・更新・削除など書き込み API を一切呼ばない
• env-sync --help に validate の説明を追加する

参考実装ポイント

• 既存の取得ロジック internal/provider/vercel/vercel.go の vercelFetchExistingKeys（GET /v10/projects/{id}/env）が到達確認にそのまま使える
• TeamID 解決順は internal/config/appconfig.go の ResolveVercelTeamID / resolveVercelTeamID（per-target > 環境変数 > config）、単一ターゲット時の .vercel/project.json orgId フォールバックは vercel.go:75-76

acceptanceCriteria

完了条件

• env-sync validate を実行すると、解決された Vercel target（name / projectId / teamId / token 有無・取得元）が一覧表示される
• token は値が表示されずマスクされる
• Vercel API への到達確認が行われ、成功時は OK、失敗時は HTTP ステータスと推定原因が表示される
• teamId 未設定でチーム配下プロジェクトにアクセスして 404 になるケースで「teamId が未設定の可能性」が原因候補として提示される
• validate は環境変数を一切登録・変更しない（読み取り専用）
• env-sync --help に validate の説明が追加されている

確認手順

• go build ./... でビルドが通る
• teamId を設定せずチーム配下プロジェクトを指定して env-sync validate を実行し、404 と「teamId 未設定の可能性」が表示されることを確認する
• 正しい teamId を設定して env-sync validate を実行し、OK が表示されることを確認する
• env-sync validate 実行後、Vercel ダッシュボードで環境変数が変更されていないことを確認する
• go test ./... が通る

---

priority: medium

[polidog]

TDD 作業レポート

ステップ 6: cmd/env-sync dispatch と runValidate

• Red: cmd/env-sync/validate_test.go に 3 件追加（TestValidateSubcommand_HelpExitsZero / TestValidateSubcommand_NoDefOrEnv / TestValidateSubcommand_InUsage）。HelpExitsZero が exit status 1 で失敗することを確認（Red 確認済み）
• Green: cmd/env-sync/validate.go を新規作成（runValidate 関数: config.ParseFlags → provider.LookupProvider → provider.Validator 型アサート → v.Validate）。cmd/env-sync/main.go に args[0] == "validate" dispatch ブロックを setup ブロック直後に追加
• Refactor: gofmt -w でフォーマット修正
• 検証: lint / build 共に Green。go test -race ./... 全 8 パッケージ PASS

実装サマリ

• Validator オプショナルインターフェースを provider.go に追加し、各 provider が自分の検証を実装・出力する設計
• Vercel: vercelCheckAccess（GET /v10/projects/{id}/env のみ）で到達確認。404→teamId未設定/projectId不一致、401→token無効、403→スコープ不足の推定原因を提示
• GitHub: 読み取り専用 API で repo/token 検証
• token は完全マスク（秘匿値の文字を一切出さない）+ 取得元表示
• source 付きリゾルバ（env / config / project.json / git remote）を appconfig.go に追加
• i18n キー 24 件を en/ja 両方に追加（parity 維持）

検証結果

• go vet ./... — clean
• gofmt -l . — clean
• go build ./... — clean
• go test -race ./... — 全 8 パッケージ PASS

[polidog]

PR: #38

[polidog]

実装・受け入れテスト完了。PR: #38

実装サマリ

読み取り専用の validate サブコマンドを追加。Validator オプショナルインターフェースを介し各 provider が自分の検証を実装・出力する設計。

• Vercel: GET /v10/projects/{id}/env で到達確認（404→teamId未設定/projectId不一致、401→token無効、403→スコープ不足）
• GitHub: GET /repos/{owner}/{repo} で repo/token 検証
• token / projectId / teamId / repo の解決値と取得元（env / config / project.json / git remote）を表示。token は完全マスク
• 書き込み API は一切呼ばない（GET のみ）。--help（en/ja）に validate 追加

品質ゲート結果

• go vet / gofmt / go build / go test -race：全 8 パッケージ green
• code-quality：Critical 0
• 設計レビュー（reviewer）：Critical 0、Warning 3件は修正済み（未使用ヘルパー/i18nキー削除、出力ライタ統一）
• 自動テスト：httptest で 200/404/401/403・GET-only・source トラッキングを検証（test-builder で 11 ケース追加）
• perf 静的解析：validate 実装に問題なし（指摘は既存 sync 経路で本PRスコープ外）
• 受け入れテスト：実バイナリで Vercel 403 / GitHub 401 の到達確認・推定原因・token マスク・exit code・日本語/英語表示を確認
• Copilot レビュー：3ラウンドで 11 件すべて修正（--version 対応、二重カッコ表示修正、httpTimeout 定数化、project.json source 条件修正など）。見送りなし

review 状態で完了。マージは /ptyhard:loop-finish 34 で実施予定。

[polidog]

PR をマージし done に完了。merged: https://github.com/ptyhard/env-sync/pull/38（方式: squash）worktree / ローカルブランチ feat/34 を撤去済み。