自己デバッグのエージェントに、ログイン後とペイウォール後の画面を必ず踏ませる

// verify-paywall.ts — プレビュー環境専用の状態注入ハーネス
import { chromium, Browser, BrowserContext } from "playwright";
 
const PREVIEW = process.env.PREVIEW_URL ?? "https://preview.example.pages.dev";
const PREMIUM_ARTICLE = "/articles/agents/some-premium-slug";
 
// プレビュー限定の検証用トークン（本番の署名鍵とは別物を使う）
const PREVIEW_PREMIUM_TOKEN = process.env.PREVIEW_PREMIUM_TOKEN ?? "";
 
async function seedMemberContext(browser: Browser): Promise<BrowserContext> {
  const ctx = await browser.newContext();
  // ナビゲーション前に会員 Cookie を焼き込む
  await ctx.addCookies([
    {
      name: "premium_token",
      value: PREVIEW_PREMIUM_TOKEN,
      domain: new URL(PREVIEW).hostname, // ドメイン不一致は無効化されるので厳密に
      path: "/",
      httpOnly: true,
      secure: true,
      sameSite: "Lax",
    },
  ]);
  return ctx;
}
 
async function main() {
  const browser = await chromium.launch();
 
  // (A) 無料訪問者としてのペイウォール表示を確認
  const guest = await browser.newContext();
  const guestPage = await guest.newPage();
  await guestPage.goto(PREVIEW + PREMIUM_ARTICLE, { waitUntil: "networkidle" });
  const paywallShown = await guestPage.locator("[data-paywall]").count();
 
  // (B) 会員としての全文表示を確認
  const member = await seedMemberContext(browser);
  const memberPage = await member.newPage();
  await memberPage.goto(PREVIEW + PREMIUM_ARTICLE, { waitUntil: "networkidle" });
  const fullBodyShown = await memberPage.locator("[data-premium-body]").count();
 
  console.log(JSON.stringify({ paywallShown, fullBodyShown }));
  await browser.close();
 
  // 無料はペイウォールが出て、会員は本文が出る、が同時に成り立つべき
  if (paywallShown < 1 || fullBodyShown < 1) {
    process.exit(1);
  }
}
 
main();

// coverage-assert.ts — 必須状態の到達をカバレッジとして検査する
type Visited = { key: string; seen: boolean };
 
const REQUIRED: Visited[] = [
  { key: "guest_paywall", seen: false },   // 無料で data-paywall を見た
  { key: "member_full_body", seen: false } // 会員で data-premium-body を見た
];
 
export function markVisited(key: string) {
  const target = REQUIRED.find((v) => v.key === key);
  if (target) target.seen = true;
}
 
export function assertCoverage(): void {
  const missed = REQUIRED.filter((v) => !v.seen).map((v) => v.key);
  if (missed.length > 0) {
    // ここで落とすことで「無料画面だけ見て合格」を構造的に禁止する
    throw new Error("uncovered paywall states: " + missed.join(", "));
  }
}

## 自己デバッグの必須カバレッジ
- 課金に関わる画面は verify-paywall.ts 経由でのみ検証すること
- guest_paywall と member_full_body の両方に到達したうえで assertCoverage() を通すこと
- どちらか一方でも未到達なら、その run は失敗として報告すること