人にログインさせるブラウザ自動化を「1回で済む」作りにする（Playwright persistent context）

API の無いサービス（個人 SNS のメッセージ等）を Playwright の永続プロファイルで読む時、最初の1回だけ人にログインしてもらう。 この「人ログイン画面」で、ツールがログイン途中に勝手に閉じる事故が起きやすい（2段階認証・確認画面の途中 URL を「ログイン済み」と誤判定）。 同梱 Chromium と playwright-core の revision ずれで、ログイン後の遷移でブラウザごと落ちることもある。結果、人が何度もログインをやり直す。

ルール（4つ）

1. ツール側から閉じない。 URL や画面で「ログイン済み」を推定しない。人が × で閉じる（全ページが閉じる / context の close イベント）まで待つだけ。
2. 正規版 Google Chrome を優先する（%PROGRAMFILES%\Google\Chrome\Application\chrome.exe → (x86) → %LOCALAPPDATA% → mac の /Applications/Google Chrome.app/...）。無い時だけ同梱 Chromium。
3. 閉じた後に Cookie で成否判定し、その場で OK / ERROR: 不足 <cookie名> を出す。同じ profile を headless で開き直して context.cookies() を見る（例: Facebook は c_user/xs、Google は SID）。
4. 人に渡す前に、AI 側で「起動→ログイン画面表示」まで実機で確認してから渡す。

共通関数の形

• resolveBrowserExecutable({env, exists, findChromium})
• waitForHumanLogin(context, {timeoutMs=20分, sleep, now}) → {closedByUser}。close は絶対に呼ばない。タイムアウトでも閉じない
• missingLoginCookies(cookies, required, domain)（サブドメインも親ドメイン要求に一致させる）
• runHumanLogin({chromium, profileDir, url, requiredCookies, cookieDomain}) → code 0（OK）/ 3（Cookie 不足）/ 4（ブラウザ・playwright 無し）/ 5（閉じられずタイムアウト）
• playwright-core は動的 import にして、テストはブラウザ無しで回す（fake context の close が呼ばれたら fail、等）

CI で強制する

tools/**/*.mjs を走査し、headless: false を含むのに runHumanLogin を import していないファイルがあれば fail する静的テストを置く。新しいツールが同じ事故を再発させない。

運用の注意

• 人ログイン中は profile がロックされる（Chrome は exit 21）。定期読み取りタスクと同じ profile を使うなら、ログイン・一括取得の間はタスクを一時停止し、終わったら必ず再開（try/finally）。
• Cookie ファイル（Default/Network/Cookies）はブラウザ起動中は読めない。閉じてから判定する。