FlowPilot/docs/superpowers/plans/2026-04-19-163-mail-body-fallback.md

163 Mail Body Fallback Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Let the 163 mailbox provider read verification codes from opened email bodies when the inbox list does not show the code inline.

Architecture: Keep the existing list-first polling flow in content/mail-163.js, then add a provider-local fallback that opens candidate messages, reads body text, and returns to the inbox before continuing. Do not add targetEmail filtering in this change.

Tech Stack: Manifest V3 Chrome extension, plain JavaScript content scripts, Node built-in test runner

---

Task 1: Lock the regression with a failing test

Files:

• Create: D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js

• Test: D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js

• Step 1: Write the failing test

test('handlePollEmail opens a matching 163 message and reads the body when the list row has no inline code', async () => {
  const bundle = extractFunction('handlePollEmail');
  const api = new Function(`...`)();
  const result = await api.handlePollEmail(8, {
    senderFilters: ['openai'],
    subjectFilters: ['chatgpt'],
    maxAttempts: 1,
    intervalMs: 1,
  });
  assert.equal(result.code, '480382');
});

• Step 2: Run test to verify it fails

Run: node --test tests/mail-163-content.test.js Expected: FAIL because handlePollEmail never opens the message body.

Task 2: Add the 163 opened-mail fallback

Files:

• Modify: D:\github\codex-oauth-automation-extension-Pro2.0\content\mail-163.js

• Test: D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js

• Step 1: Add minimal helpers

function findInboxLink() { /* find the 163 inbox entry */ }
async function returnToInbox() { /* restore inbox list view */ }
function readOpenedMailText() { /* read visible detail text and iframe text */ }
async function openMailAndGetMessageText(item) { /* open, read, return */ }

• Step 2: Update handlePollEmail

if (!code) {
  const openedText = await openMailAndGetMessageText(item);
  const bodyCode = extractVerificationCode(openedText);
  if (bodyCode) {
    return { ok: true, code: bodyCode, emailTimestamp: Date.now(), mailId: id };
  }
}

• Step 3: Run the targeted test

Run: node --test tests/mail-163-content.test.js Expected: PASS

Task 3: Verify no regressions in adjacent polling logic

Files:

• Test: D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js

• Test: D:\github\codex-oauth-automation-extension-Pro2.0\tests\verification-flow-polling.test.js

• Step 1: Run the local regression slice

Run: node --test tests/mail-163-content.test.js tests/verification-flow-polling.test.js Expected: PASS

• Step 2: Update docs only if behavior scope changed

No root docs update is required if the change stays inside existing 163 polling behavior and does not alter the documented top-level flow.