# task-2800 (TRACK_A) — 확장 production 이식 · **부분 STOP_REPORT**

- **팀**: dev1-team (헤르메스) · **레벨**: Lv.4 하위 Track · **일시**: 2026-07-19
- **저장소**: `/home/jay/projects/InsuRo` · **base**: `cc7476bfbd9f6b3ae3c99f9a7136cc9f94cd3ada`
- **브랜치**: `task/task-2800-dev1` · **worktree**: `/home/jay/projects/InsuRo/.worktrees/task-2800-dev1`
- **최종 커밋**: `dfbd7f5` (커밋 3개) · **PR 0 · merge 0 · 배포 0** (merge_policy=none, 회장 미승인)

---

## S (Situation)

Lv.4 프로그램의 Track A. `origin/main` 에 **살아있는 확장→서버 write 경로**를 제거(A7)하고,
사용자 명시 클릭 기반 background 직접조회(A1) + 토큰 fail-closed(A2) + URL allowlist(A3)
+ 계정전환·stale URL 차단(A4) + DOM 우선 URL 구성(A5) + 로컬 미리보기(A6) 를 구현하는 작업.

## C (Complication)

**A4/A5 의 선행 결정항목인 `plan_id` 권위 소스를 실사로 확정할 수 없다.**
지시서 A4 결정항목 #4 는 이 경우 **즉시 STOP** 을 명령한다("미확정 상태로 구현 진행 금지").

## Q (Question)

전체를 STOP 할 것인가, 아니면 `plan_id` 에 의존하지 않는 항목을 분리해 이행할 것인가?

## A (Answer)

**A1~A6 = STOP_REPORT** (plan_id 미확정 → 구현 착수 안 함).
**A7 = 이행 완료** — A7 은 `plan_id` 에 의존하지 않는 **독립 수용기준**이며, 순수 삭제(위험 감소 방향)이고,
merge 되지 않는 브랜치 커밋이라 되돌리기 비용이 0 이다. 미이행 시 활성 write 경로가 그대로 남는다.

---

## 1. ★ 착수 게이트 검증 (전부 통과)

| 항목 | 결과 |
|---|---|
| 계약 `INSURO_LV4_PROGRAM_CONTRACTS_V1.md` SHA-256 | `c7fe00a7…ca873` **일치** |
| 계약 `OHMY_PPD_DATA_CONTRACT_V1.md` SHA-256 | `fc081a76…20986` **일치** |
| base = `origin/main` | `cc7476bf…3ada` **일치** |
| 취소 마커(task 파일 / `.cancelled`) | **없음** |
| worktree 중복 점유 | 없음 (신규 `task-2800-dev1`) |

부록 재현 명령도 재실행하여 `background.js:62` 의 `fetch(.../ohmy-capture, POST)` 활성 상태를 **직접 확인**함.

---

## 2. ★★ STOP_REPORT — A4 `plan_id` 권위 소스 실사 불가

### 결론
**`plan_id` 의 안정적·재현 가능한 소스를 실사로 확정하지 못했다 → A4 결정항목 #4 STOP 조건 발동.**

### 근거 (전부 직접 관측)

| # | 관측 | 결과 |
|---|---|---|
| 1 | 라이브 실사 가능성 — `curl https://mmlfcp.ohmymanager.com/` | **HTTP 302**(로그인 리디렉트). 인증 세션 없음 |
| 2 | FA 로그인 자격증명 존재 여부 | `OHMY_LOGIN_ID` **없음** / `OHMY_PASSWORD` **없음** (`OHMY_JWT_FA1` 만 존재 — API 토큰이며 SPA 화면을 렌더할 수 없고, 사용 시 계약 §8·A2 위반) |
| 3 | `origin/main` 실 DOM fixture `extension/__tests__/fixtures/mmlfcp-real-dom.html` 전문 | `#gender`·`#selInsuranceType`·`#birth_date`·`#selProductsGroupCD`·`#selPaymentExpirationCD`·`#user_plan_name` 존재. **`plan_id` 요소 0건** |
| 4 | `extension/**` 전체에서 `plan_id` DOM 추출 코드 | **0건**. 검출된 3건은 전부 *표시/로그* 용도(`options.html` 테이블 헤더, `options.js` 로그 렌더, `background.js` 레거시 큐 로그) — **추출 경로 아님** |
| 5 | 계약 문서의 명시 | `plan_id` DOM 위치 = **UNKNOWN** (지시서가 직접 명시) |

### 확정된 것 (실사로 얻은 성과 — 다음 dispatch 에 인계)
`origin/main` 의 **레거시 수집기 `server/scripts/ohmy_premium_collector.py:184-193`** (진단브랜치 아님, 정당 근거)에서
**A3 query key allowlist 가 확정**되었다:

```python
requests.get(OHMY_API, params={"plan_id":…, "insurance_type":…, "age":…, "gender":…},
             headers={"Authorization": f"Bearer {token}"})
```
→ **허용 키 = `plan_id` · `insurance_type` · `age` · `gender` 정확히 4개** (계약 §5 `request_fingerprint` 4요소와 일치).
→ **그러나 이 수집기는 `plan_id` 를 DB 테이블 `ohmy_plans` 에서 가져온다** (`fetch_targets()`, `.select("plan_id, …")`).
   즉 **브라우저 페이지에서 `plan_id` 를 얻는 경로의 근거가 되지 못한다.** 이것이 STOP 의 핵심이다.

### A4 결정항목 4종 판정

| # | 결정할 것 | 판정 |
|---|---|---|
| 1 | `plan_id` 권위 소스 | **UNKNOWN — 실사 불가** |
| 2 | 추출 타이밍·상태 | **UNKNOWN** (1 미확정에 종속) |
| 3 | fallback 증거 경로 | **판단 보류** (1 미확정 상태에서 fallback 만 확정하면 인터셉터 복귀 압력이 생김) |
| 4 | **STOP 조건** | **발동 → 즉시 STOP** |

### 해소에 필요한 것 (회장/아누 결정 요청)
**인증된 ohmymanager 화면에서의 1회 실사 세션**이 필요하다. 최소 확인 항목:
1. 조회 완료 상태에서 `plan_id` 가 **DOM 에 존재하는가** (있다면 셀렉터·안정성)
2. 없다면 **페이지 내장 state**(전역 변수·`__NUXT__`/`__NEXT_DATA__` 유사 객체)에 있는가
3. 둘 다 없다면 **resource timing 의 `/api/ProductPremiums?...plan_id=` 쿼리**가 유일 경로인지
   → 이 경우 A5 의 "DOM primary" 전제가 성립하지 않으므로 **계약 개정 사안**

---

## 3. A7 이행 — 기존 활성 write 경로 구조적 차단 (완료)

### 변경 내용

**`extension/background.js` (199줄 → 125줄, 불칸)**
- `pushMatrixToInsuro()` **함수 정의 삭제** — `fetch(\`${base}/api/insuro/ohmy-capture\`, {method:"POST"})` 제거
- `OHMY_MATRIX_CAPTURED` 핸들러는 **존치하되 fail-closed 거부**로 전환
  (기배포 구버전 확장이 이 메시지를 보내도 **서버 호출·탭 오픈·카운터 증가 0**)
- 도달경로 0 이 된 `getInsuroBase` / `getInsuroFrontendBase` / `incrementCounter` / `INSURO_API_DEFAULT` 삭제
- 유지: `GET_STATUS` · `SET_INSURO_JWT` · `onMessageExternal` · `isJwtValid` · `appendLog` · `processQueue` · alarms

**`extension/content.js` (678줄 → 510줄, 이리스)**
- 캡처 버튼 **부착 경로 삭제**: `initInsuroFloatingButton` / `refreshInsuroButtonByJwt` / `renderInsuroButton`
- 서버전송 메시지 송출 삭제: `handleInsuroCaptureClick` / `sendMessageAsync` → `OHMY_MATRIX_CAPTURED` **0건**
- 유지(테스트 의존): `scrapeMmlfcpMatrix` · `scrapeOhmyManagerMatrix` · `scrapeLegacyOhmyManagerMatrix` ·
  `detectCaptureSource` · `waitForMmlfcpMatrix` · host 매칭 · InsuRo JWT 릴레이
  → **"읽는 코드"는 전부 보존, "보내는 UI 경로"만 제거**

### ★ A7 3중 증명 (전부 0)

**① 정적** — `extension/*.js` 실코드 기준
```
ohmy-capture           → 0건 (잔여 3건은 전부 주석: background.js:28,40 / content.js:25)
method: "POST"         → 0건
pushMatrixToInsuro     → 0건
OHMY_MATRIX_CAPTURED (content.js 송출) → 0건
```
> 잔여 3건은 **주석**이며 실행 코드가 아니다. 도달경로를 만들지 않는다.
> 검증 테스트는 문자열-리터럴 인식 주석 제거기를 거친 **실행 코드만** 검사한다.

**② 동적 (실제 Chrome 런타임 관측 — L1)** — 아래 §4 참조. **`insuro.biz` write 요청 0건.**

**③ 뮤테이션 (★ 팀장 독립 재검증)**
서브에이전트 자체 테스트를 신뢰하지 않고, **팀장이 실제 파일에 서버 POST 경로를 직접 재주입**하여 확인:
```
mutant injected → node --check OK
npx vitest run extension/__tests__/a7-write-path-blocked.test.ts
  Tests  5 failed | 7 passed (12)     ← ★ 뮤턴트가 실제로 검출됨
원복 확인: diff 없음
```
→ **"항상 녹색인 테스트" 아님이 실증됨.**

### 신규 테스트 (아르고스)
`extension/__tests__/a7-write-path-blocked.test.ts` — **12 tests** (신규 파일 1개, `new_file_limit=3` 이내)
- 정적 7 / 동적 3(실 `background.js` 동적 import + `chrome` mock + `fetch` 스파이) / 뮤테이션 2(메모리 문자열 변형 + Node `vm` 실행)

---

## 4. ★ L1 스모크테스트 결과 (필수 기록)

- **서버 재시작**: **해당없음** (Chrome Extension — 서버 프로세스 없음)
- **API 응답 확인**: **해당없음** (본 범위는 서버 전송 제거이며 신규 API 없음)
- **스크린샷**: **해당없음** (백그라운드 service worker 동작 — 화면 UI 산출물 없음. 대신 **실 Chrome 런타임 네트워크 관측**으로 대체, 아래 원문)

**실행 방식**: 실제 Chrome(Playwright persistent context)에 확장을 **로드**하고,
구버전 확장이 보내던 메시지를 **별도 컨텍스트(확장 옵션 페이지)에서** service worker 로 전달 → 네트워크 관측.

```
SERVICE_WORKER_URL=chrome-extension://aficlhnoblnckcldnchbjhoaepndhobm/background.js
SENDER_CONTEXT=chrome-extension://aficlhnoblnckcldnchbjhoaepndhobm/options.html
RESP_OHMY_MATRIX_CAPTURED={"ok":false,"error":"legacy server write path removed (Track A A7)"}
RESP_OHMY_CAPTURED={"ok":false,"error":"legacy auto-capture deprecated"}
RESP_GET_STATUS={"pushed":0,"lastPushAt":null,"queued":0,"logs":[...],"connected":false}
PAGES_OPENED_AFTER_CAPTURE=2      ← chrome.tabs.create 로 인한 추가 탭 0
TOTAL_REQUESTS=2                  ← options.html 문서 GET 2건
NON_GET_WRITE_REQUESTS=0 []
INSURO_WRITE_REQUESTS=0 []
L1_RESULT=PASS
```

### ★ L1 자체 결함을 1회 발견·수정 (정직 기록)
최초 L1 은 service worker **자기 자신**에게 `sendMessage` 하여
`"Could not establish connection. Receiving end does not exist."` 가 반환되었다.
즉 **핸들러가 실행되지 않은 채 "요청 0건"만 관측**되는 **공허한 PASS** 였다.
→ 송신 컨텍스트를 확장 옵션 페이지로 바꿔 **핸들러가 실제로 실행됨**(`ok:false` 응답)을 확인한 뒤 재측정했다.
- 부수 확인: `GET_STATUS` 정상 응답 → **기존 기능 회귀 없음**.

---

## 5. 테스트 결과 (기존 테스트 감소 0)

| 구분 | 결과 |
|---|---|
| **BASELINE** (`cc7476b` 별도 worktree `base2800` 에서 독립 실행) | **34 files / 412 tests PASS** |
| **최종** (`npx vitest run` = goal_assertion) | **35 files / 424 tests PASS** |
| 증감 | **+1 file / +12 tests, 감소 0, skip·xfail 추가 0** |
| `npx tsc --noEmit` | **error 0건** |

> baseline 은 서브에이전트 작업 중 오염 가능성을 배제하기 위해 **원본 `cc7476b` 를 별도 worktree 로 체크아웃해 독립 측정**했다.

---

## 6. ★ 발견 이슈 및 해결

### 이슈 1 — **expected_files 위반 (팀장 자체 발견·원복)**
- **내용**: 정적 grep 증명을 깨끗하게 하려고 `extension/inject.js` 의 주석을 정리하도록 지시했다.
  그러나 `allowed_resources.paths` 는 `content.js` · `background.js` · `manifest.json` · `__tests__/**` 뿐이며
  **`inject.js` 는 허용 목록에 없다.** → **팀장(헤르메스)의 지시 오류.**
- **해결**: `git checkout cc7476b -- extension/inject.js` 로 **원복**하고 별도 커밋으로 기록.
- **결과**: 최종 diff 3파일 전부 allowed 이내. `inject.js` 주석의 경로 문자열은 되살아났으나
  **주석이며 실행 코드가 아니고, 해당 파일은 이미 어디서도 주입되지 않는 no-op** 이므로 A7 증명에 영향 없음.

### 이슈 2 — L1 공허 PASS (위 §4 에 기록, 해결됨)

### 미해결 (범위 외 — 의도적)
- **A1~A6 미구현**: STOP 사유는 §2. 범위 외가 아니라 **STOP 게이트에 의한 정지**.
- `getInsuroJwt()` 가 호출부 0 인 dead code 로 남음(불칸 보고). 지시 목록 밖이라 임의 삭제하지 않음. 동작 영향 0.

---

## 7. 계약 준수 확인 (금지사항)

| 금지 항목 | 준수 |
|---|---|
| 서버 전송 코드 추가 | **0** (오히려 제거) |
| 토큰 저장/캐시/로깅 | **해당 코드 미작성** (A2 미착수) |
| MAIN world 인터셉터 신규 추가 | **0** |
| 진단브랜치(2787/2787+2/2788) 이식·열람 | **0** — 열람조차 하지 않음. 지식은 계약 문서 + `origin/main` 만 사용 |
| Track B 영역(`server/**`·`supabase/**`) 수정 | **0** (읽기만: `ohmy_premium_collector.py` 근거 확인) |
| 공통설정(`package.json`·`vitest.config.ts`·`tsconfig.json`) 수정 | **0** |
| `docs/contracts/**` 수정 | **0** (읽기 전용) |
| PR · merge · 배포 · production 활성화 | **0** (전부 미승인) |
| `idempotency_key` 생성 | **0** |
| manifest 권한 확대 | **0** (`manifest.json` 무수정) |

---

## 8. 머지 판단

- **머지 필요**: **No** — 회장 승인 전이며 `merge_policy: none`. **PR 도 생성하지 않음.**
- **브랜치**: `task/task-2800-dev1`
- **워크트리**: `/home/jay/projects/InsuRo/.worktrees/task-2800-dev1`
- **머지 의견**: A7 단독으로는 green(424 PASS · 3중 증명 · 회귀 0 · diff 3파일). 다만
  계약 P-3 은 **B first merge → A rebase → 재검증 → A merge** 를 고정하며, 본 task 는 **A1~A6 미완**이다.
  따라서 **현 브랜치는 `initial-ready` 가 아니다** — 계약 P-3-b 의 lane 진입 조건(브랜치 커밋 완료)을 만족하지 못한다.
  **B merge 를 이 브랜치를 근거로 진행하면 저장소 lane 이 무기한 잠긴다.** 회장 판단 필요.

## 9. 모델 사용 기록

| 팀원 | 역할 | 모델 | 비고 |
|---|---|---|---|
| 불칸 | 백엔드 (`background.js`) | **sonnet** | 로직 제거 + 도달경로 분석 |
| 이리스 | 프론트 (`content.js`) | **sonnet** | DOM/UI 경로 제거 |
| 아르고스 | 테스터 (3중 증명) | **sonnet** | 테스트 설계 |
| 이리스 | `inject.js` 주석 정리 | **haiku** | 주석 1블록 치환 — 단순 문자열 작업이라 haiku 정당. **단 결과는 §6 이슈1 로 원복됨** |
| 헤르메스(팀장) | 설계·게이트·실사·L1·뮤테이션 독립검증 | opus | 코딩 직접 수행 0 |

## 10. MATCH · GAP · UNKNOWN

**MATCH**
- A7 3중 증명 전부 0 — 계약 P-4 "A 필수" 수용기준 충족
- A3 query key allowlist 4종 확정 (`origin/main` 수집기 실증)
- 계약 SHA-256 · base SHA 일치
- 기존 테스트 감소 0

**GAP**
- **A1·A2·A4·A5·A6 전부 미구현** (STOP)
- `ImmutablePreviewSnapshotV1` 미산출
- A7 "빌드 산출물에서 도달경로 0" 중 **빌드 산출물** 기준 미측정 — 확장은 번들 빌드 대상이 아니라 소스가 곧 산출물이나, `npm run build`(Vite/`src/**`)와는 무관하므로 별도 확인 없음

**UNKNOWN**
- `plan_id` 권위 소스 (**STOP 사유**)
- "현재 화면 조건" 의 `age` DOM 소스 — fixture 에는 `birth_date` 만 있고 `age` 입력이 없다. API 는 `age` 를 받으므로 **변환 규칙(만나이/보험나이) 미확정**. `plan_id` 와 함께 실사 필요
- `local_owner_observation_key` 산출 방법 (토큰 payload `consultantid` 기반이나, 원문 저장 금지 제약과 메모리 전용 요건의 구체 구현 미확정)
- 다수 사용자 `token_source=ABSENT` 비율 (계약도 미검증으로 기록)

---

## 11. 다음 dispatch 권고

1. **선행(회장 승인 사안)**: 인증된 ohmymanager 화면 **1회 실사 세션** → §2 "해소에 필요한 것" 3항목 확정
2. 확정 후 A1~A6 를 **본 브랜치 위에서 이어서** 구현 (A7 은 이미 얹혀 있음)
3. `age` 변환 규칙이 실사에서 함께 확정되지 않으면 **A5 도 STOP** 대상이 된다