copy_tuner_client 1.5.0 → 2.0.0

data/skills/copy-tuner-to-t-migrate/scripts/migrate_tt.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+# copy_tuner_client v2.0.0 移行: tt → t 置換スクリプト（SKILL.md 手順 1〜2）。
+#
+# copy_tuner_client が生やしていた独自ヘルパー tt は PR #122 で削除された。gem を上げた
+# アプリのビューに tt(...) が残ると NoMethodError になるため t へ移す。大半は機械的に
+# tt( → t( で済むが、訳文を文字列加工している箇所だけは素朴に t へ変えると開発環境で
+# マーカートークン混入バグが再発する（skills/copy-tuner/SKILL.md の罠を参照）。そこは
+# I18n.t（絶対キー）へ変換すべきなので、このスクリプトは自動変換せず「怪しい」として抽出する。
+#
+# Rails context は不要なので素の ruby で動く:
+#
+#   ruby skills/copy-tuner-to-t-migrate/scripts/migrate_tt.rb --report
+#   ruby skills/copy-tuner-to-t-migrate/scripts/migrate_tt.rb --apply-safe
+#
+# 出力する 3 分類:
+#   (1) safe       : 文字列加工されていない tt 呼び出し。tt( → t( に決定論的変換できる。
+#   (2) suspicious : 戻り値が同一行で文字列加工されている tt 呼び出し。I18n.t 提案・要確認。
+#   (3) other      : app 外 / tt を含む別識別子の誤検出など。自動変換せず目視で確認。
+#
+# 判定はヒューリスティック（完全な AST 解析ではない）。誤判定のコストは
+#   safe 誤分類（怪しいのに safe）= マーカー混入バグ再発 → 重大
+#   suspicious 誤分類（安全なのに suspicious）= 人間が 1 件確認するだけ → 軽微
+# なので、疑わしきは suspicious に倒す。
+
+require 'optparse'
+
+# NOTE: 中断を呼び出し側（Bash 手順）へ確実に伝えるため warn + exit(1) を使う。
+def die(message)
+  warn message
+  exit(1)
+end
+
+# ---- 引数 ----
+options = { mode: :report, root: '.' }
+parser =
+  OptionParser.new do |opts|
+    opts.banner = 'Usage: ruby migrate_tt.rb [--report | --apply-safe] [--root DIR]'
+    opts.on('--report', '3 分類を出力する（既定）。ファイルは変更しない') { options[:mode] = :report }
+    opts.on('--apply-safe', 'safe 分類のみ tt( → t( を実ファイルに適用する') { options[:mode] = :apply_safe }
+    opts.on('--root DIR', 'リポジトリルート（既定: カレントディレクトリ）') { |v| options[:root] = v }
+    opts.on('--json', 'report を JSON で出力する（機械処理用）') { options[:json] = true }
+    opts.on('-h', '--help', 'ヘルプ') do
+      puts opts
+      exit(0)
+    end
+  end
+parser.parse!(ARGV)
+
+ROOT = File.expand_path(options[:root])
+die("ルートが見つからない: #{ROOT}") unless File.directory?(ROOT)
+
+# 対象: app 配下の .rb / .haml / .erb。それ以外のヒットは other 扱いで提示のみ。
+APP_GLOB = File.join(ROOT, 'app', '**', '*.{rb,haml,erb}')
+# app 外も走査して other に入れる（lib/ 等の取りこぼし提示用）。
+ALL_GLOB = File.join(ROOT, '**', '*.{rb,haml,erb}')
+
+# 単語境界の tt 呼び出し。tt( だけでなく haml の `= tt '...'`（括弧なし）も拾う。
+# 直前が識別子文字（attr/http/setting 等の一部や `.tt` のメソッド呼び出し）でないことを (?<![\w.]) で担保。
+TT_CALL = /(?<![\w.])tt(\s*\(|\s+['":@])/
+
+# tt の「定義」側（呼び出しではない）。アプリが後方互換で `def tt` を生やしている場合がある。
+# これを safe として t( へ機械置換すると Rails の t を再定義してしまい破滅的なので、定義は別扱いにする。
+TT_DEFINITION = /\b(?:def\s+(?:self\.)?tt\b|alias(?:_method)?\s+:?tt\b|alias(?:_method)?\s+['"]tt['"])/
+
+# tt(...) の戻り値が同一行で文字列加工されているかの判定に使う語彙。
+STRING_HELPERS = %w[truncate simple_format strip_tags highlight excerpt word_wrap].freeze
+STRING_METHODS = %w[
+  length size bytesize slice first last truncate truncate_words
+  gsub sub gsub! sub! strip lstrip rstrip chomp chop chars bytes lines
+  scan match match? =~ start_with? end_with? include? index rindex
+  upcase downcase capitalize ljust rjust center delete squeeze tr
+  to_i to_f to_sym html_safe
+].freeze
+
+# (a) truncate( ... tt( ... ) のように文字列加工ヘルパーの引数になっている
+STRING_HELPER_RE = /\b(?:#{STRING_HELPERS.join('|')})\s*\(\s*[^)]*\btt\b/
+# (b) tt(...) または tt '...' の直後に .method / =~ / [ が続く。引数の閉じ括弧をまたぐ単純近似。
+STRING_METHOD_RE = /\btt\b\s*(?:\([^\n]*?\)|['":@][^\n,]*)\s*(?:\.\s*(?:#{STRING_METHODS.join('|')})\b|=~|\[)/
+
+# 先頭ドットの相対キー tt('.foo') は I18n.t では解決できず絶対キー化が要る → 強調表示用。
+RELATIVE_KEY_RE = /\btt\b\s*(?:\(\s*)?['":]\s*\./
+
+def relative(path)
+  path.sub("#{ROOT}/", '')
+end
+
+safe = []
+suspicious = []
+other = []
+
+app_set = Dir.glob(APP_GLOB).to_set
+
+# 1 ファイル分を走査し、ヒット行を safe / suspicious / other へ振り分ける。
+def scan_file(path, in_app:)
+  rel = relative(path)
+  File.readlines(path).each_with_index do |line, idx|
+    next unless line =~ TT_CALL
+
+    entry = { file: rel, lineno: idx + 1, code: line.rstrip }
+    yield(classify_line(line, entry, in_app: in_app))
+  end
+rescue StandardError
+  nil
+end
+
+# ヒット 1 行を分類し、[:safe | :suspicious | :other, entry] を返す。
+def classify_line(line, entry, in_app:)
+  # tt の定義（def/alias）は呼び出しではない。t( へ置換すると Rails の t を壊すので絶対に自動変換しない。
+  if line.match?(TT_DEFINITION)
+    entry[:reason] = 'tt の定義（def/alias）。自動変換禁止。呼び出しを全て t へ移した後に手動で削除する'
+    return [:other, entry]
+  end
+
+  unless in_app
+    entry[:reason] = 'app 外（要目視）'
+    return [:other, entry]
+  end
+
+  return [:safe, entry] unless line.match?(STRING_HELPER_RE) || line.match?(STRING_METHOD_RE)
+
+  entry[:relative_key] = line.match?(RELATIVE_KEY_RE)
+  entry[:hint] = if entry[:relative_key]
+                   'I18n.t へ。相対キー(.foo)は絶対キーへ書き換えが必要'
+                 else
+                   'I18n.t(絶対キー) へ置換を検討'
+                 end
+  [:suspicious, entry]
+end
+
+buckets = { safe: safe, suspicious: suspicious, other: other }
+Dir.glob(ALL_GLOB).each do |path|
+  # vendor / node_modules / tmp 等のノイズを除外
+  next if relative(path).start_with?('vendor/', 'node_modules/', 'tmp/', '.git/')
+
+  scan_file(path, in_app: app_set.include?(path)) do |bucket, entry|
+    buckets[bucket] << entry
+  end
+end
+
+if options[:json]
+  require 'json'
+  puts JSON.pretty_generate(safe: safe, suspicious: suspicious, other: other)
+  exit(0)
+end
+
+def print_section(title, entries)
+  puts "\n== #{title} (#{entries.size}) =="
+  entries.each do |e|
+    suffix = if e[:hint]
+               "  # #{e[:hint]}"
+             else
+               (e[:reason] ? "  # #{e[:reason]}" : '')
+             end
+    puts "#{e[:file]}:#{e[:lineno]}: #{e[:code].strip}#{suffix}"
+  end
+end
+
+if options[:mode] == :report
+  print_section('safe（tt( → t( に決定論的変換できる）', safe)
+  print_section('suspicious（文字列加工あり・I18n.t 提案・要 1 件ずつ確認）', suspicious)
+  print_section('other（app 外・誤検出・要目視）', other)
+  puts "\n合計: safe=#{safe.size} suspicious=#{suspicious.size} other=#{other.size}"
+  exit(0)
+end
+
+# ---- --apply-safe: safe 分類のみ tt( → t( を適用 ----
+# 同一ファイル内の safe 行だけを対象に、単語境界の tt を t へ置換する。
+# suspicious / other 行は触らない（行番号で限定）。
+by_file = safe.group_by { |e| e[:file] }
+changed = 0
+by_file.each do |rel, entries|
+  path = File.join(ROOT, rel)
+  lines = File.readlines(path)
+  target_linenos = entries.to_set { |e| e[:lineno] }
+  target_linenos.each do |lineno|
+    line = lines[lineno - 1]
+    # safe 行内の tt 呼び出しのみ t へ。tt('...') や tt(... の tt を t に。
+    new_line = line.gsub(TT_CALL) { "t#{Regexp.last_match(1)}" }
+    if new_line != line
+      lines[lineno - 1] = new_line
+      changed += 1
+    end
+  end
+  File.write(path, lines.join)
+end
+
+puts "safe 置換を適用: #{changed} 箇所 / #{by_file.size} ファイル"
+puts "残った suspicious=#{suspicious.size} other=#{other.size} は手作業で対応すること（--report で再確認）"

data/spec/copy_tuner_client/cache_spec.rb

@@ -24,16 +24,6 @@ describe 'CopyTunerClient::Cache' do
     expect(cache.keys).to match_array(%w[en.test.key en.test.other_key])
   end
 
-  it 'exclude_key_regexpが設定されている場合、該当データを除外すること' do
-    cache = build_cache(exclude_key_regexp: /^en\.test\.other_key$/)
-    cache['en.test.key']       = 'expected'
-    cache['en.test.other_key'] = 'expected'
-
-    cache.download
-
-    expect(cache.queued.keys).to match_array(%w[en.test.key])
-  end
-
   it 'local_first_key_regexpにマッチするキー（locale除く）はアップロードキューに入れないこと' do
     cache = build_cache(local_first_key_regexp: /\Aviews\./)
     cache['ja.views.foo']    = 'local value'
@@ -284,6 +274,7 @@ describe 'CopyTunerClient::Cache' do
   it 'トップレベルからflushできること' do
     cache = build_cache
     CopyTunerClient.configure do |config|
+      config.project_id = 1
       config.cache = cache
     end
     expect(cache).to receive(:flush).at_least(:once)
@@ -410,6 +401,7 @@ describe 'CopyTunerClient::Cache' do
 
     it 'トップレベル定数から呼び出せること' do
       CopyTunerClient.configure do |config|
+        config.project_id = 1
         config.cache = cache
       end
       expect(cache).to receive(:export)

data/spec/copy_tuner_client/client_spec.rb

@@ -207,6 +207,7 @@ describe 'CopyTunerClient' do
     client = build_client
     allow(client).to receive(:download)
     CopyTunerClient.configure do |config|
+      config.project_id = 1
       config.client = client
     end
     expect(client).to receive(:deploy)

data/spec/copy_tuner_client/configuration_spec.rb

@@ -253,27 +253,24 @@ describe CopyTunerClient::Configuration do
     end
   end
 
-  describe '#exclude_key_regexp= (deprecated)' do
-    let(:config) { CopyTunerClient::Configuration.new }
-    let(:deprecator) { instance_double(ActiveSupport::Deprecation, warn: nil) }
-
-    before { allow(ActiveSupport::Deprecation).to receive(:new).and_return(deprecator) }
-
-    it 'warns when a value is set' do
-      expect(deprecator).to receive(:warn).with(/exclude_key_regexp is deprecated/)
-
-      config.exclude_key_regexp = /\Aja\.views\./
+  describe 'project_id の必須化' do
+    let(:config) do
+      config = CopyTunerClient::Configuration.new
+      config.api_key = 'abc123'
+      config
     end
 
-    it 'stores the assigned value' do
-      config.exclude_key_regexp = /\Aja\.views\./
-      expect(config.exclude_key_regexp).to eq(/\Aja\.views\./)
+    it 'project_id が未設定のとき apply が ArgumentError を出すこと' do
+      expect { config.apply }.to raise_error(ArgumentError, 'project_id is required')
     end
 
-    it 'does not warn when set to nil' do
-      expect(deprecator).not_to receive(:warn)
+    it 'project_id が未設定のとき project_url が ArgumentError を出すこと' do
+      expect { config.project_url }.to raise_error(ArgumentError, 'project_id is required')
+    end
 
-      config.exclude_key_regexp = nil
+    it 'project_id を設定すると project_url がそれを使った URL を返すこと' do
+      config.project_id = 77
+      expect(config.project_url).to include('/projects/77')
     end
   end
 end
@@ -294,6 +291,9 @@ shared_context 'stubbed configuration' do
     allow(CopyTunerClient::Poller).to receive(:new).and_return(poller)
     allow(CopyTunerClient::ProcessGuard).to receive(:new).and_return(process_guard)
     subject.logger = logger
+    # NOTE: apply は project_id 必須になったため、未設定だと raise する。applied 系テストは
+    #       project_id 自体を検証しないので適当な値を補っておく
+    subject.project_id ||= 1
     apply
   end
 end

data/spec/copy_tuner_client/copyray/marker_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require 'copy_tuner_client/copyray/marker'
+
+describe CopyTunerClient::Copyray::Marker do
+  describe '.encode' do
+    it 'キーを可視トークンの区切り記号で囲む' do
+      expect(described_class.encode('views.home.index.message')).to eq '⟦CT:views.home.index.message⟧'
+    end
+
+    it 'ドット・アンダースコア・スラッシュを含むキーをそのまま保持する' do
+      expect(described_class.encode('en.foo_bar.baz/qux')).to eq '⟦CT:en.foo_bar.baz/qux⟧'
+    end
+
+    it 'マルチバイトキーをそのまま保持する' do
+      expect(described_class.encode('ja.見出し')).to eq '⟦CT:ja.見出し⟧'
+    end
+  end
+
+  describe '::SCAN_REGEXP' do
+    it 'エンコード済みトークンからキーを取り出す' do
+      key = 'views.home.index.message'
+      match = described_class::SCAN_REGEXP.match(described_class.encode(key))
+      expect(match[1]).to eq key
+    end
+
+    it 'ドット・アンダースコア・スラッシュ・マルチバイトを含むキーを取り出す' do
+      key = 'ja.foo_bar.baz/qux.見出し'
+      match = described_class::SCAN_REGEXP.match(described_class.encode(key))
+      expect(match[1]).to eq key
+    end
+
+    it '非貪欲マッチで隣接するトークンを分離する' do
+      text = "#{described_class.encode('a.b')}hello#{described_class.encode('c.d')}"
+      expect(text.scan(described_class::SCAN_REGEXP).flatten).to eq ['a.b', 'c.d']
+    end
+
+    it 'プレーンテキストにはマッチしない' do
+      expect('just a normal sentence with CT: and brackets [x]').not_to match described_class::SCAN_REGEXP
+    end
+  end
+end

data/spec/copy_tuner_client/copyray/rewriter_spec.rb

@@ -0,0 +1,216 @@
+require 'spec_helper'
+require 'copy_tuner_client/copyray/marker'
+require 'copy_tuner_client/copyray/rewriter'
+
+describe CopyTunerClient::Copyray::Rewriter do
+  def marker(key)
+    CopyTunerClient::Copyray::Marker.encode(key)
+  end
+
+  def ascii8(str)
+    str.dup.force_encoding(Encoding::ASCII_8BIT)
+  end
+
+  describe '.rewrite' do
+    # NOTE: rewrite は [html, skipped] を返すが、既存テストの大半は html だけを検証する。
+    # 1 回の呼び出しを let でメモ化して共有し、result は html、skipped は 2 要素目を指す。
+    let(:rewritten) { described_class.rewrite(html) }
+    subject(:result) { rewritten.first }
+    let(:skipped) { rewritten.last }
+
+    context '要素直下の単純なテキストノード' do
+      let(:html) { "<html><body><p>#{marker('a.b')}Hello</p></body></html>" }
+
+      it '親要素に data-copyray-key を付与する' do
+        expect(result).to include('data-copyray-key="a.b"')
+      end
+
+      it 'マーカートークンを除去する' do
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+        expect(result).to include('>Hello<')
+      end
+
+      it 'skipped が false を返す（属性付与に成功した）' do
+        expect(skipped).to be false
+      end
+    end
+
+    context 'ActionView が body を html エスケープした平文訳文（トークンは無傷）' do
+      # NOTE: 平文訳文は ActionView がエスケープするため body の & < > はエンティティ化するが、
+      # トークンの区切り記号 ⟦⟧ は HTML 特殊文字ではないので無傷で残る。Rewriter はこれを拾えること。
+      let(:html) { "<html><body><p>#{marker('plain.key')}Hello &amp; &lt;World&gt;</p></body></html>" }
+
+      it '要素に属性を付与しトークンを除去するが、エスケープ済み body はそのまま残す' do
+        expect(Nokogiri::HTML(result).at_css('p')['data-copyray-key']).to eq 'plain.key'
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+        expect(result).to include('Hello &amp; &lt;World&gt;')
+      end
+    end
+
+    context 'ネストしたインライン要素内のマーカー' do
+      let(:html) { "<html><body><p>foo <a>#{marker('link.key')}Hi</a> bar</p></body></html>" }
+
+      it '最も近い親要素（<a>）に属性を付与する' do
+        fragment = Nokogiri::HTML(result)
+        a = fragment.at_css('a')
+        expect(a['data-copyray-key']).to eq 'link.key'
+        expect(fragment.at_css('p')['data-copyray-key']).to be_nil
+      end
+    end
+
+    context 'テキスト中間に置かれたマーカー' do
+      let(:html) { "<html><body><p>foo #{marker('mid.key')}Hi</p></body></html>" }
+
+      it '内包する要素に属性を付与する' do
+        expect(Nokogiri::HTML(result).at_css('p')['data-copyray-key']).to eq 'mid.key'
+      end
+    end
+
+    context '属性値の中のマーカー' do
+      let(:html) { %(<html><body><input placeholder="#{marker('search.placeholder')}検索"></body></html>) }
+
+      it '要素自身に data-copyray-key を付与する' do
+        expect(Nokogiri::HTML(result).at_css('input')['data-copyray-key']).to eq 'search.placeholder'
+      end
+
+      it '属性値からトークンを除去する' do
+        placeholder = Nokogiri::HTML(result).at_css('input')['placeholder']
+        expect(placeholder).to eq '検索'
+      end
+    end
+
+    context 'head（title）の中のマーカー' do
+      let(:html) { "<html><head><title>#{marker('page.title')}タイトル</title></head><body></body></html>" }
+
+      it 'トークンを除去する' do
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+        expect(Nokogiri::HTML(result).at_css('title').text).to eq 'タイトル'
+      end
+    end
+
+    context '同一テキストノード内の複数マーカー' do
+      let(:html) { "<html><body><p>#{marker('first.key')}A#{marker('second.key')}B</p></body></html>" }
+
+      it 'すべてのキーをカンマ区切りで data-copyray-key に保持する' do
+        expect(Nokogiri::HTML(result).at_css('p')['data-copyray-key']).to eq 'first.key,second.key'
+      end
+
+      it 'すべてのトークンを除去する' do
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+      end
+    end
+
+    context '同一属性値内の複数マーカー' do
+      let(:html) { %(<html><body><input placeholder="#{marker('a.key')}x#{marker('b.key')}y"></body></html>) }
+
+      it 'すべてのキーをカンマ区切りで data-copyray-key に保持する' do
+        expect(Nokogiri::HTML(result).at_css('input')['data-copyray-key']).to eq 'a.key,b.key'
+      end
+
+      it '属性値からすべてのトークンを除去する' do
+        expect(Nokogiri::HTML(result).at_css('input')['placeholder']).to eq 'xy'
+      end
+    end
+
+    context 'マーカーが無い html' do
+      let(:html) { '<html><body><p>Nothing to see</p></body></html>' }
+
+      it 'html を無変形で返す（no-op 高速パス）' do
+        expect(result).to eq html
+      end
+
+      it 'skipped が false を返す（変形していない）' do
+        expect(skipped).to be false
+      end
+    end
+
+    context 'HTML が閾値（MAX_REWRITE_BYTESIZE）を超える場合' do
+      # NOTE: マーカーを含みつつ閾値超のサイズにするため、padding でかさ増しする。
+      let(:padding) { '<span>x</span>' * ((described_class::MAX_REWRITE_BYTESIZE / 14) + 1) }
+      let(:html) { "<html><body><p>#{marker('big.key')}Hello</p>#{padding}</body></html>" }
+
+      it '閾値を超えるサイズである（前提確認）' do
+        expect(html.bytesize).to be > described_class::MAX_REWRITE_BYTESIZE
+      end
+
+      it 'マーカートークンを除去する' do
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+      end
+
+      it 'data-copyray-key を付与しない（Nokogiri を通さない）' do
+        expect(result).not_to include(described_class::DATA_ATTR)
+      end
+
+      it 'skipped が true を返す' do
+        expect(skipped).to be true
+      end
+    end
+
+    context 'ASCII-8BIT に転落したがマーカーを含む body' do
+      let(:html) { ascii8("<html><body><p>#{marker('a.b')}日本語</p></body></html>") }
+
+      it '例外を投げず親要素に属性を付与する' do
+        expect { result }.not_to raise_error
+        expect(Nokogiri::HTML(result).at_css('p')['data-copyray-key']).to eq 'a.b'
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+      end
+    end
+
+    context 'マーカーが無い ASCII-8BIT の body' do
+      let(:html) { ascii8('<html><body><p>日本語</p></body></html>') }
+
+      it '例外を投げず無変形で返す' do
+        expect { result }.not_to raise_error
+      end
+
+      it '渡された文字列のエンコーディングを破壊しない' do
+        result
+        expect(html.encoding).to eq Encoding::ASCII_8BIT
+      end
+    end
+
+    context 'rewrite が内部で例外を投げる' do
+      # NOTE: 壊れた HTML 等で Nokogiri 処理が例外を投げる状況を模す。
+      #       Copyray は開発支援機能なので、ここでページを 500 にしない（フォールバック動作）。
+      let(:html) { "<html><body><p>#{marker('a.b')}Hello</p></body></html>" }
+
+      before do
+        allow(described_class).to receive(:rewrite_with_nokogiri).and_raise(RuntimeError, 'boom')
+      end
+
+      it '例外を伝播させずトークンだけ除去して返す' do
+        expect { result }.not_to raise_error
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+        expect(result).to include('<p>Hello</p>')
+      end
+
+      it 'skipped が true を返す（属性付与できなかった）' do
+        expect(skipped).to be true
+      end
+
+      it 'logger.warn で例外内容を記録する' do
+        logger = double('logger')
+        allow(CopyTunerClient.configuration).to receive(:logger).and_return(logger)
+        expect(logger).to receive(:warn).with(/Rewriter failed.*RuntimeError.*boom/)
+        result
+      end
+
+      it 'logger が nil でもフォールバックが落ちない' do
+        allow(CopyTunerClient.configuration).to receive(:logger).and_return(nil)
+        expect { result }.not_to raise_error
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+      end
+    end
+
+    context '出力にマーカートークンが一切残らない' do
+      let(:html) do
+        "<html><head><title>#{marker('t')}T</title></head>" \
+          "<body><input placeholder=\"#{marker('p')}x\"><p>#{marker('a')}A<a>#{marker('b')}B</a></p></body></html>"
+      end
+
+      it 'シリアライズ後の出力にトークンが残っていない' do
+        expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+      end
+    end
+  end
+end

data/spec/copy_tuner_client/copyray_middleware_spec.rb

@@ -0,0 +1,89 @@
+require 'spec_helper'
+require 'copy_tuner_client/copyray_middleware'
+require 'copy_tuner_client/copyray/marker'
+require 'copy_tuner_client/translation_log'
+
+describe CopyTunerClient::CopyrayMiddleware do
+  def marker(key)
+    CopyTunerClient::Copyray::Marker.encode(key)
+  end
+
+  let(:headers) { { 'Content-Type' => 'text/html' } }
+  let(:app) { ->(_env) { [status, headers, [body]] } }
+  let(:status) { 200 }
+
+  subject(:middleware) { described_class.new(app) }
+
+  before do
+    CopyTunerClient.configure do |configuration|
+      configuration.project_id = 1
+      configuration.client = FakeClient.new
+    end
+    # NOTE: CSS/JS 挿入は Rails の ActionController::Base.helpers に依存するため、
+    # Rewriter の効果だけを検証できるよう no-op にスタブする。
+    allow(middleware).to receive(:append_css) { |html, _| html }
+    allow(middleware).to receive(:append_js) { |html, *| html }
+  end
+
+  context 'マーカートークンを含む HTML レスポンスのとき' do
+    let(:body) { "<html><body><p>#{marker('a.b')}Hello</p></body></html>" }
+
+    it 'マーカーを data-copyray-key 属性に書き換え、トークンを除去する' do
+      _status, _headers, response = middleware.call({})
+      result = response.join
+
+      expect(result).to include('data-copyray-key="a.b"')
+      expect(result).not_to match CopyTunerClient::Copyray::Marker::SCAN_REGEXP
+    end
+
+    it '書き換え後のボディから Content-Length を再計算する' do
+      _status, out_headers, response = middleware.call({})
+      expect(out_headers['Content-Length']).to eq response.join.bytesize.to_s
+    end
+  end
+
+  context 'HTML 以外のレスポンスのとき' do
+    let(:headers) { { 'Content-Type' => 'application/json' } }
+    let(:body) { "{\"x\":\"#{marker('a.b')}\"}" }
+
+    it '書き換えずにそのまま通過させる' do
+      _status, _headers, response = middleware.call({})
+      expect(response.join).to eq body
+    end
+  end
+
+  describe '#append_js' do
+    # NOTE: append_js は private かつ Rails の view ヘルパー（javascript_tag 等）に依存する。
+    # トップレベルの no-op スタブを外して実体を呼び、ヘルパーは渡された script 本文をそのまま
+    # 返す最小フェイクに差し替えて、window.CopyTuner に keysSkipped が埋まることだけ検証する。
+    subject(:script) { middleware.__send__(:append_js, '<html><body></body></html>', nil, skipped: skipped) }
+
+    let(:fake_helpers) do
+      Class.new {
+        def javascript_tag(content, **_opts) = content
+        def javascript_include_tag(*, **) = ''
+      }.new
+    end
+
+    before do
+      allow(middleware).to receive(:append_js).and_call_original
+      allow(middleware).to receive(:helpers).and_return(fake_helpers)
+    end
+
+    context 'skipped が true のとき' do
+      let(:skipped) { true }
+
+      it 'window.CopyTuner に keysSkipped: true を出力する' do
+        expect(script).to include('keysSkipped: true')
+      end
+    end
+
+    context 'skipped が false のとき' do
+      let(:skipped) { false }
+
+      it 'window.CopyTuner に keysSkipped: false を出力する' do
+        expect(script).to include('keysSkipped: false')
+      end
+    end
+  end
+end