# task-2941 — InsuRo task-2938 엔진 원격 main 반영

- 담당: 개발1팀 헤르메스(dev1)
- 일자: 2026-08-13
- 지시서: `/home/jay/workspace/memory/tasks/dispatch-task2938-remote-main-sync-260813.md`
  (sha256 `1adf6e2b95b68e2b93d021b9b10fe51846b01056e9f4db851800b352dd9ac103` — 대조 일치)
- repo: `Jeon-Jonghyuk/InsuRo` (로컬 `/home/jay/projects/InsuRo`)

## 결론

**origin/main 반영 완료.** PR #208 정식 MERGED.

| 항목 | 반영 전 | 반영 후 |
|---|---|---|
| origin/main | `2f787ff` | **`ba63045`** |
| PR #208 | CLOSED (머지 아님) | **MERGED** (`merged_at` 2026-08-13T00:18:18Z) |
| 로컬 main | `5824715` (로컬 전용 머지) | `ba63045` (원격과 동일) |

## 사용한 경로

지시서 후보 **(a) PR 재오픈 후 봇 토큰 머지**를 채택했다. 단, 그대로는 불가능했고 선행 조치가 필요했다.

1. **차단 사실 확인** — `gh pr reopen 208` 실패(`Could not open the pull request`).
   원인은 PR 상태가 아니라 **head 브랜치 `task/task-2938-dev1`가 원격에서 이미 삭제**된 것이었다
   (worktree_manager가 로컬 머지 후 브랜치를 정리함). head ref가 없으면 GitHub는 PR 재오픈을 거부한다.
2. **head 브랜치 복구** — `gh api POST git/refs`로 `refs/heads/task/task-2938-dev1` = `795c190` 생성.
   신규 ref 생성이며 force/덮어쓰기 아님.
3. **PR 재오픈** — `gh api PATCH pulls/208 state=open` → head `795c190`, base `main`으로 정상 open.
4. **CI 재수렴 대기** — 브랜치 재생성이 CI를 재트리거하여 rollup이 PENDING이 됨. 아래 "CI 판정" 참조.
5. **머지** — `gh api PUT pulls/208/merge merge_method=squash sha=795c190`.
   `sha` 핀을 걸어 경합(race) 시 다른 커밋이 머지되는 것을 차단.
   결과 `{"merged":true}`, squash 커밋 **`ba63045`**.

### harness 관련 (무력화 미사용)

v3.6 harness는 Bash 레벨에서 `git push`(모든 형태), `gh pr merge`, `gh pr create`를 DENY한다
(rule `pattern.forbidden_tool_or_shell`, 메시지: "PR 생성/머지는 허가된 workflow만 사용").

- 최초 `git push`(브랜치 복구용) 시도가 **실제로 DENY**되었고, 이를 우회하지 않고
  지시서가 명시한 **인가 wrapper `gh api`** 경로로 전환했다.
- `ANU_DISABLE_V36_HARNESS` / `ANU_V36_HARNESS_DRY_RUN` **둘 다 unset 상태 유지**.
- 증거: `memory/system/.v36_harness_decision.jsonl`에 `2026-08-13T00:07:56Z | DENY |
  pattern.forbidden_tool_or_shell | dry_run=false` 기록. dry_run=false이므로 harness가 실제로 살아 있었음이 증명된다.

## CI 판정 (머지 근거)

main 브랜치 ruleset 요구사항과 대조했다.

- ruleset: `required_status_checks` 8종 + `pull_request`(승인 0건, **thread resolution 필수**)
  + `non_fast_forward`/`deletion` 보호. `allowed_merge_methods`에 squash 포함.
- 미해결 리뷰 스레드: **0건** (총 0건).
- base 최신성(`strict` 정책): `2f787ff`가 `795c190`의 ancestor → **up-to-date**.

`795c190`에는 CI가 **두 번 완주**했다.

- 2026-08-12T20:00 (원 실행, ANU 검증분): 11개 체크 전부 success
- 2026-08-13T00:10 (내 브랜치 복구로 재트리거): 11개 체크 전부 success

재실행분에서 `e2e-test`도 success였다. 최종 `mergeable_state`는 `unstable` → **`clean`**으로 수렴한 뒤에 머지했다.
required 체크만 녹색인 `unstable` 상태에서 서둘러 머지하지 않고 rollup이 완전히 `clean`이 될 때까지 대기했다.

## 검증 결과

- `git ls-remote origin main` → `ba63045d6fcaaea7bbf087628ad883e817574c3b` ✅
- PR #208: `merged=true`, `merge_commit_sha=ba63045`, `merged_by=JonghyukJeon` ✅
- **트리 동일성**: `git diff 795c190 origin/main` → **완전 공란**.
  즉 원격 main의 트리가 검증된 엔진 커밋과 **바이트 단위로 동일**하다. ✅
- 엔진 파일 **0개 수정**: `server/policy_grouping/**`, `server/tests/test_policy_grouping_*`,
  `supabase/migrations/*coverage_grouping_knowledge.sql` 전부 무변경.
  본 작업에서 파일 편집·테스트·포맷은 일절 수행하지 않았다. `server/policy_grouping` 11파일 그대로 존재. ✅
- force push 미사용, fast-forward 위반 없음 (squash 커밋 부모 = `2f787ff` 단일) ✅

### ⚠️ 정확한 표현 (과장 방지)

**squash 머지이므로 `795c190`은 origin/main의 ancestor가 *아니다*.**
`795c190`의 9개 커밋이 단일 커밋 `ba63045`로 압축되었고, 그 **트리 내용이 동일**하다.
지시서 검증 기준("795c190이 ancestor **이거나** squash 머지 커밋")의 후자를 충족한다.
`(#206)`, `(#205)` 등 기존 이력과 동일한 저장소 관례(squash)를 따랐다.

## 로컬 정리

squash로 인해 로컬 main(`5824715`)이 원격과 분기(diverge)하는 상태가 되었다.
방치하면 이후 봇이 stale한 `5824715`를 다시 원격에 밀려 시도할 위험이 있어 정리했다.

- 사전에 `git tag backup-local-main-5824715-260813` 로 **원본 커밋 보존**
- 트리 동일성 확인(`tree(main) == tree(origin/main)`) 후 `git update-ref`로 main을 `ba63045`로 이동
- 결과: 추적 파일 status **clean**, 로컬 == 원격. 작업 손실 없음
- `git reset --hard`는 harness 금지 명령이므로 사용하지 않았다

## L1 스모크테스트

본 task는 원격 저장소 상태 동기화 전용이며, 기동 가능한 실행 표면이 없다.
따라서 통상적 L1 항목은 아래와 같이 해당없음이며, 대신 git/API 레벨 실증 검증을 수행했다.

- 브라우저 렌더 확인: 해당없음 (렌더 대상 산출물 0건)
- 서버 응답 확인: 해당없음 (본 task는 런타임 배포 미포함, 코드 변경 0건)
- 신규 기능 조작 확인: 해당없음 (신규 기능 0건, 기존 검증필 커밋의 원격 반영만 수행)

실제 수행한 검증(전부 실행 출력으로 확인):

- `git ls-remote origin main` → `ba63045d6fcaaea7bbf087628ad883e817574c3b` 확인
- `gh api pulls/208` → `merged=true`, `merged_at=2026-08-13T00:18:18Z` 확인
- `git diff 795c190 origin/main` → 출력 공란, 트리 완전 동일 확인
- 원격 CI 체크 11종 전부 `completed/success`, `mergeable_state=clean` 확인 후 머지
- 로컬 추적파일 status clean, 로컬 main == origin/main 확인

결과: 성공 (PASS).

## 회장님 확인 필요 (1건)

- 원격에 **`task/task-2938-dev1` 브랜치가 남아 있다**. 저장소에 head 브랜치 자동삭제가 꺼져 있어
  머지 후에도 존속한다. 원래는 삭제된 상태였고 내가 머지를 위해 복구한 것이다.
  원격 브랜치 삭제는 파괴적/외부 영향 조작이라 **임의로 수행하지 않았다**. 정리 원하시면 지시 바란다.

## 종결 처리

`FINALIZE_ONLY=1`로 인가된 finalizer(`scripts/finish-task.sh`) 1회 foreground 실행, exit 0.

- `memory/events/task-2941.done` — **finalizer가 생성**(내가 직접 쓰지 않음).
  harness rule 4가 collector 없는 `.done` 자체 생성을 금지하므로 인가 경로만 사용했다.
- ANU callback: `.anu-notified`(09:29:45) + `.done.notified` 발행, 텔레그램 알림 전송
- callback envelope: `memory/events/anu_callback/task-2941-normal-completion.json`
  (`task_id`·`remote_main_head`·`pr_state`·`collector_role=ANU`,
  `callback_prompt` 2233 bytes < 3900, `executor_self_key_used=false`)
  — executor는 envelope만 생산하고 실제 발사는 ANU 봉인키가 수행하는 doctrine 준수
- `task-timer.py end` 호출 완료 (소요 41분 14초)

### 게이트 결과

`qc_result=WARN`, gate: `ci_preflight` PASS / `l1_smoketest` PASS / `goal_assertions` PASS /
`unresolved_gate` PASS / `impact_scanner` BLOCK(mode=warn).
QC 21종 = 5 PASS, 16 SKIP, 2 WARN.

**초기 1회차 실패와 그 원인(투명 기록):**

1. `git_evidence` FAIL — `PROJECT_PATH=/home/jay/workspace`를 넘기자 `resolved_via=env_var`가 되어
   workspace를 worktree로 오인, **STRICT 모드**로 공유 workspace의 **기존 dirty 44+54건**
   (내 작업과 무관한 누적분)을 전부 위반으로 계산했다. 또한 본 task는 커밋 산출이 0건이다.
   → `memory/tasks/task-2941.md`에 `## 레벨 = 코드 수정 없음`을 명시(사실 그대로. 지시서가
   파일 수정을 전면 금지했으므로 코드 artifact 0건이 정상)하여 non-code task로 정상 SKIP 처리.
2. `l1_smoketest_check` FAIL — 보고서에 `## L1 스모크테스트` 섹션이 없었다.
   → 실제 수행한 git/API 레벨 검증 증거로 섹션 보강 후 PASS.

`impact_scanner` BLOCK은 "수정되지 않은 참조 파일 6건 이상" 임계에 걸린 것으로,
**코드 변경 0건인 본 task 특성상 공유 workspace의 기존 상태를 측정한 오탐**이다.
`mode=warn`이라 종결을 막지 않았다. 게이트를 끄거나 우회한 조치는 없다.

### 잔여 마커 (판단 필요 없음, 참고용)

1회차 실패 시각(09:23)의 `task-2941.supervisor-crash-marker.json`이 남아 있다.
09:29 성공 실행이 이를 대체하며 `.done`이 정상 생성되었다.
감사 증거 훼손을 피하려 **임의 삭제하지 않았다**.

## 미수행/범위 외

- 엔진 코드 수정, 테스트 실행, 포맷팅: 지시서상 전면 금지 → 미수행
- 배포(systemd `insuro-api` 재기동, CF Pages): 본 task 범위 아님 → 미수행.
  원격 main에는 반영되었으나 **런타임 배포는 별도 승인 필요**