公開ページの実表示から「料金の階段」を逆算し、変更の前後を対照群つきで比べる

管理画面の設定値ではなく、客が実際に見ている画面の総額から料金構造（閾値と単価）を割り出し、 設定変更の効果を exit code で判定するための指示書。宿泊・チケット・レンタル・SaaS の人数課金など、 「N を増やすと総額が増える」形の料金すべてに使える。

この指示書が防ぐ失敗

1. 両端2点で割って、実在しない単価を報告する 最小 N と最大 N の総額差を N 差で割ると滑らかな数字が出るが、料金表が階段だとその数字は どの区間にも存在しない。実例: 総額が N=2,3,4 で同額、N=5 から段が付く料金で、両端割りは 「750/人」を出した。実体は「4 まで無料・5 から 1,500/人」。この嘘を信じると、既に正しく 設定されている項目を「未反映」と誤判定して二重に触ることになる。
2. 同じ名前の別ユニットを比べる 一覧型ページは N によって表示される商品が入れ替わる。名前だけを鍵にすると、N=2 のときの 「標準プラン（定員6）」と N=6 のときの「標準プラン（定員12）」を突き合わせて嘘の差額が出る。
3. 取れなかったを 0 と混同する 抽出に失敗した点を「差なし」として扱うと、変更が入っていないのに「入った」と読める。
4. 1回の順位・1回の価格で語る 検索順位は測定ごとに揺れる。前後比較は中央値と、影響を受けないはずの帯（対照群）が 一緒に動いていないかの検定をセットにしないと、市場の揺れを効果と誤認する。

作るもの（2本）

A. 料金階段の計測器（exit 0/1/2）

node tools/price-step-meter.mjs --url-template "<URL テンプレート>" --vary 2,3,4,5,6 \
  --expect-unit 1500 --expect-threshold 4 --json out.json

実装の要点:

1. 入力は連続にする。2,3,4,5,6 のように隙間なく測る。隙間があると閾値は範囲でしか 決まらない。範囲でしか決まらないときは pinned: false を出力に必ず入れる。
2. 各点で headless ブラウザ（playwright 等）でページを開き、描画待ちを置いてから innerText を取る。API ではなく実表示を読むのが目的。
3. 総額の抽出はラベル基準にする。数字の最大値を拾うような当て推量はしない。 取れなかった点は method: 'none' として記録し、その場で exit 2。代替推定をしない。
4. 一覧型ページでは、商品名の行を上方向に探し、画面部品の行を除外する （「すべて表示」「詳細を見る」「〜を選択」など。これらは商品名と同じ語を含むことがある）。 鍵は 商品名＋容量（定員・席数など） の組にする。名前だけでは衝突する。
5. 容量表記は上にも下にもある。単品ページでは価格枠の下にしか出ないことがある。 上方向を探して見つからなければ下方向も探す。
6. 逆算は隣接区間の増分で行う: step(n_i → n_j) = (総額_j − 総額_i) / (n_j − n_i) / 単位数（泊数・日数など）
   • 増分が 0 の区間 = 加算なし
   • 増分が出る最初の区間の下端 = 閾値
   • 加算ありの区間の増分の中央値 = 単価
   • 加算ありの区間どうしで増分がばらつく → 1つの数字で語れない形なので exit 2
7. 複数商品があるなら商品ごとに閾値と単価を出し、商品間で一致しているかも確認する。 食い違えば exit 2（設定が商品ごとに違うか、抽出が壊れている）。
8. 判定より先に表を全部出力する。測定不能で落ちるときこそ、何をどう読んだかが残っていないと 原因を追えない。

出力例:

区間 2→3 | 増分=0
区間 3→4 | 増分=0
区間 4→5 | 増分=1500
区間 5→6 | 増分=1500
商品 A | 閾値=4 | 単価=1500
判定: 一致（1500）

B. 前後比較（対照群つき・exit 0/1/2）

順位・露出・転換率など「変更で動くはずの指標」を、変更前後で複数回測って比べる。

node tools/rank-compare.mjs --before b1.json --before b2.json --before b3.json \
  --after a1.json --after a2.json --after a3.json --margin 0.05

実装の要点:

1. 1回では判定しない。片側 3 回程度を集め、指標はパーセンタイル （順位 ÷ 母数）に正規化してから中央値を取る。母数が回ごとに違っても比べられる。
2. 対照群を必ず持つ。料金の閾値が 4 なら、N ≤ 閾値 の帯は理屈上影響を受けない。 その帯を対照群として同じ計算をする。
3. 判定:
   • 影響を受ける帯が margin を超えて改善 → exit 0
   • 改善なし・悪化 → exit 1
   • 対照群も同じ向きに margin を超えて動いた → exit 2（効果と市場の揺れを切り分けられない）
   • 前後で条件（日付・地理範囲・帯の一覧）が違う、測定回数が足りない → exit 2
4. 「不在」は最下位相当（パーセンタイル 1.0）として扱い、absent の回数を必ず併記する。 在庫切れなど正当な理由で出ないケースがあるので、不在を症状と決めつけない。
5. 自己検定: before と after に同じファイルを渡して delta が 0 になることを確認してから使う。 合成データで「対照群も動いた」ケースを作り、exit 2 が実際に出ることも確認する。

手順（このまま AI に渡せる）

1. 対象ページの URL 形式と、変えるパラメータ（人数・枚数・席数）を確定する。
2. まず1点だけ実際に開き、本文テキストをファイルに保存して目で見る。 ラベル（総額・容量）の実際の表記と、一覧型か単品型かをここで決める。推測で正規表現を書かない。 通貨記号の位置（前置か後置か）と括弧が全角か半角かもここで確認する。
3. A を実装し、既に正しい設定になっていると分かっている対象で exit 0 が出ることを確認する （＝対照群での検定）。これをせずに「異常」を報告しない。
4. 変更前の値と指標を測って保存する（生 JSON をリポジトリに残す）。
5. 設定を変更する。管理画面がログイン必須で自動化できない場合、そこだけは人に頼む。 その際は URL・変更する項目名・期待値・「変えられなかった場合の逃げ道」を1通に書く。 見たことのない画面の手順を創作しない（先にスクリーンショットを1枚もらう）。
6. A を --expect-* 付きで叩いて exit 0 を確認 → B で前後比較 → exit code で報告する。

報告の作法

• 「反映した」ではなく「この画面のこの数字がこうなった」と、読み戻した値で言う。
• 0 件・0 円を報告するときは、その 0 が何を数えた 0 かを必ず併記する （母数・列挙数・抽出方法）。抽出に失敗した 0 と、本当に 0 の 0 は区別が付かない。
• 測定不能（exit 2）は失敗ではなく情報。無理に 0 か 1 に丸めない。