copy-tuner-to-locales-cleanup

copy_tuner 撤去スキル（クリーンアップ）

copy-tuner-to-locales-migrate-prefix スキルで全 prefix を config/locales へ移行し終えた後に、 1 回だけ実行する。local_first_key_regexp が全キーを覆っている（= もう CopyTuner から引かれるキーが無い） ことを確認してから、gem・初期化子・CI・deploy・ドキュメント・MCP 設定をまとめて撤去する。

このスキルは特定のリポジトリに依存しない。固有値を覚えず、毎回リポジトリを探索して touchpoint を発見する。 種別ごとの典型的な在処は references/example-touchpoints.md を参照。

なぜ完了判定を関門にするのか

local_first_key_regexp でカバーできていない prefix が 1 つでも残ったまま gem を抜くと、その prefix のキーが config/locales に無く、一斉に未訳化する。だから「全キーが regexp にマッチしている」ことを gem 撤去前の 関門にする。判定には gem 自身の local_first_key? を使い、export した全キーを 1 件ずつ通す。

ワークフロー

1. 完了判定（関門）

CopyTuner の全キーが local_first_key_regexp にマッチする（= 全 prefix 移行済み）ことを確認する。

# 全件 export（一時ファイルへ。読み取り専用検証だが export は書き込むので捨て場へ）
bundle exec rake copy_tuner:export[tmp/copy_tuner_check.yml]

export YAML から locale を除いた全キーを取り出し、gem の判定そのもので 100% マッチを確認する:

bin/rails runner '
  require "yaml"
  data = YAML.load_file("tmp/copy_tuner_check.yml")
  locale = data.keys.first                      # 例: "ja"
  keys = []
  walk = ->(h, prefix) do
    h.each do |k, v|
      key = prefix.empty? ? k.to_s : "#{prefix}.#{k}"
      v.is_a?(Hash) ? walk.call(v, key) : keys << key
    end
  end
  walk.call(data[locale], "")
  unmatched = keys.reject { |k| CopyTunerClient.configuration.local_first_key?(k) }
  if unmatched.empty?
    puts "OK: 全 #{keys.size} キーが local_first_key_regexp にマッチ。cleanup へ進める。"
  else
    puts "STOP: 未マッチ #{unmatched.size} 件（未移行 prefix が残存）。migrate-prefix へ戻る。"
    puts unmatched.first(30)
  end
'

STOP が出たら cleanup を中止し、copy-tuner-to-locales-migrate-prefix で残 prefix を移行してから出直す。 OK のときだけ次へ進む。

NOTE: ここで export を実行できるのは gem がまだ入っているから。完了判定は gem 撤去より前に行う。

補助目印: migrate は prefix を移すたびにオリジナル（0000_original_*.yml）から該当サブツリーを削除するので、 全移行を経た場合は 0000_original_*.yml がほぼ空になっているはず（非表現値も migrate_prefix.rb が 移行分側の --out へ再適用済みで、オリジナル側に隔離ファイルとして残ることはない）。local_first_key? のマッチ判定が主の関門で、ファイルが空かどうかは副次的な目視確認。食い違うとき（regexp は全マッチなのに オリジナルに blurb 化できるキーが残っている等）は削除漏れを疑う。