# task-2686 — CALLBACK_SESSION_PROPAGATION_WIRING_FIX

- 담당: dev8 라(팀장 Opus 직접 구현, glm 위임 0 — task md 의 4 원칙 § "Surgical Changes" 준수)
- 완료 상태: `CALLBACK_SESSION_PROPAGATION_WIRING_FIX_IMPLEMENTED`
- 권한: `CHAIR-AUTH-CALLBACK-SESSION-PROPAGATION-WIRING-20260526-JJONGS-IMPLEMENT-001`
- 커밋: `b2fac85e` (`task/task-2686-dev8` 브랜치 · `origin/main` 기준 +1)
- 시각: 2026-05-26 KST 12:42

---

## SCQA 요약

**S**: 8일간 8 incidents 누적 (`SESSION_PROPAGATION_GAP_SUBCLASS_OF_SESSION_DISCONTINUITY`) — ANU key 정상 발사 callback 3건 모두 chair-facing inbound 0건으로, 회장이 "self-key 사고?" 매번 의심해야 하는 routing gap.

**C**: cokacdir `--session <SID>` 옵션은 인프라 단에 존재하나 봇 callback 발사 경로 (`dispatch/normal_fallback_callback_helper.py:build_anu_owned_callback_request`) 에 결선이 0이라 fresh ANU collector 세션이 매번 spawn되어 chair-facing inbound가 발생하지 않는다.

**Q**: 다음 normal callback 발사 시 회장 본 세션 (`53e89540-5bed-4692-a726-ed857820758a`) resume 을 코드 결선으로 보장할 수 있는가?

**A**: helper 의 PASS argv 에 `--session <SID>` 자동 첨부 + dispatch prompt 인라인 + finish-task.sh env 전파 + envelope schema 3 field + classifier `AUTHORITATIVE_BUT_SESSION_DISCONTINUITY` 분기를 단일 PR 로 결선. 신규 regression 34건 + 기존 callback 회귀 86건 PASS. live infra 변경 0건.

(총 약 240단어)

---

## 회장 verbatim 7 항목 1:1 매핑

| # | 항목 | 산출물 |
|---|------|--------|
| 1 | helper `--session` argv 자동 추가 | `dispatch/normal_fallback_callback_helper.py:281-310` (`build_anu_owned_callback_request` + `resolve_chair_facing_sid`) |
| 2 | dispatch prompt 에 `chair_facing_session_id` 전달 | `dispatch/prompt.py:32-58` (`_inline_chair_facing_sid`) + `build_prompt_with_contract` 파라미터 추가 |
| 3 | normal callback cron 등록 시 `--session` 사용 | CLI flag `--chair-facing-sid` (`dispatch.normal_fallback_callback_helper:main`) |
| 4 | finish-task.sh / callback helper 경로 session id 누락 방지 | `scripts/finish-task.sh:1361-1390` (`ANU_CHAIR_FACING_SID` env → `--chair-facing-sid` argv) |
| 5 | envelope schema 3 field 추가 | `schemas/anu_normal_callback_envelope_v1.json` (chair_facing_session_id 필수, collector/delivery 선택, UUID pattern) |
| 6 | mismatch 시 `AUTHORITATIVE_BUT_SESSION_DISCONTINUITY` 분류 | `classify_session_propagation` + `SessionPropagationVerdict` 데이터클래스 (4 enum) |
| 7 | regression 추가 | `tests/regression/callback_session_propagation/` 5 파일 / 34건 |

## 완료 7 보고 필드

1. **helper argv `--session` unit test**: `test_helper_session_argv.py::test_helper_argv_includes_session_when_explicit_sid` + env-fallback 변형 = PASS. argv 인덱스 검증으로 위치 결정 (직전 항목 `--key`).
2. **dispatch prompt sid 자동 inline 검증**: `test_prompt_inline.py` 4건 PASS (헤더 append / 빈 SID skip / 멱등 / 빈 base prompt).
3. **finish-task.sh env propagation 검증**: `bash -x` trace 산출물 (아래 부록) + `test_finish_task_env_propagation.py` 5건 정적 검사 PASS.
4. **envelope schema 3 field**: `test_envelope_schema_fields.py` 6건 PASS. UUID pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-...$` 검증.
5. **classifier 4 enum**: `test_classifier_enum.py::test_session_propagation_enum_has_exactly_four_values` + 9 분기 케이스 PASS. `AUTHORITATIVE_BUT_SESSION_DISCONTINUITY` 강제 분류 확인.
6. **regression 통과 수**: 신규 34/34 PASS + 기존 callback 회귀 86/86 PASS (test_callback_runtime_enforcement_2626 외 5 파일).
7. **forbidden_action_count 0 + code_change scope 4**: live settings.json / hooks live / Axis runtime / `dispatch.py` root / PR merge / auto-merge / HARNESS_ENFORCED 선언 = 모두 0건. 코드 수정 4 파일 (`dispatch/__init__.py` + helper + prompt + finish-task.sh). schema·tests 는 신규 artifact (수정 아님).

## 변경 파일 (git diff stat)

```
 dispatch/__init__.py                                              |  10 +
 dispatch/normal_fallback_callback_helper.py                       | 251 ++++-
 dispatch/prompt.py                                                |  47 ++
 schemas/anu_normal_callback_envelope_v1.json                      |  92 ++ (신규)
 scripts/finish-task.sh                                            |  20 +-
 tests/regression/callback_session_propagation/__init__.py         |   0 (신규)
 tests/regression/callback_session_propagation/test_classifier_enum.py            | 192 ++ (신규)
 tests/regression/callback_session_propagation/test_envelope_schema_fields.py     |  76 ++ (신규)
 tests/regression/callback_session_propagation/test_finish_task_env_propagation.py|  64 ++ (신규)
 tests/regression/callback_session_propagation/test_helper_session_argv.py        | 151 ++ (신규)
 tests/regression/callback_session_propagation/test_prompt_inline.py              |  81 ++ (신규)
 11 files changed, 979 insertions(+), 5 deletions(-)
```

## 테스트 결과

### 신규 regression (callback_session_propagation): 34/34 PASS

```
test_helper_session_argv.py        : 9 PASS  (--session argv 자동 첨부 / env fallback / invalid skip / self-key fail-closed)
test_classifier_enum.py            : 11 PASS (4 enum + 9 분기 + JSON roundtrip)
test_envelope_schema_fields.py     : 6 PASS  (3 field + UUID pattern + required + ANU pin)
test_finish_task_env_propagation.py: 5 PASS  (env 참조 / --chair-facing-sid 전달 / envelope 3 라인 / helper invocation 보존)
test_prompt_inline.py              : 4 PASS  (헤더 append / 빈 SID skip / 멱등 / 빈 base prompt)
```

### 기존 callback 회귀: 86/86 PASS

- `test_callback_runtime_enforcement_2626.py`
- `test_anu_callback_registrar.py`
- `test_callback_lifecycle_classifier.py`
- `test_callback_lifecycle_wiring_2630.py`
- `test_callback_lifecycle_e2e_2631.py`
- `test_spawn_callback_contract_validator.py`

`test_callback_registration_enforcement.py` 의 4건 실패는 본 task 도입 이전부터 존재 (worktree base = `319170b9 origin/main` 에서 동일 결과 재현 — git stash 검증). 본 task scope 밖 (`dispatch.finalize_hooks` 미존재 이슈).

## L1 스모크테스트

- **서버 재시작**: 해당없음 (분석/CLI 모듈, 서버 컴포넌트 아님)
- **pytest 결과**: 34 passed (callback_session_propagation 신규) + 86 passed (기존 callback 회귀) — `pytest tests/regression/callback_session_propagation/ -v` 전체 PASS
- **API 응답 확인 (CLI dry-run)**:
  ```
  $ PYTHONPATH=. python3 -m dispatch.normal_fallback_callback_helper launch \
      --kind normal --task-id task-2686 \
      --executor-key 9c4f7c5e9c4f7c5e --owner-key c119085addb0f8b7 \
      --chat-id 6937032012 \
      --prompt "<envelope>" --at "2026-05-26 14:00:00" \
      --canonical-root /home/jay/workspace \
      --chair-facing-sid 53e89540-5bed-4692-a726-ed857820758a

  → verdict=PASS, status=ANU_OWNED_READY
  → argv 마지막 두 요소: ["--session", "53e89540-5bed-4692-a726-ed857820758a"]
  ```
- **env fallback 경로 확인**:
  ```
  ANU_CHAIR_FACING_SID=53e89540-... CLI 실행 (--chair-facing-sid 생략)
  → argv has --session: True
  → --session value: 53e89540-5bed-4692-a726-ed857820758a
  ```
- **finish-task.sh shell -x trace** (회장 verbatim 4번 검증):
  ```
  + T2686_CHAIR_SID_ARGS=(--chair-facing-sid "$T2686_CHAIR_SID")
  + T2686_ENVELOPE_SID_LINES=
    chair_facing_session_id=53e89540-...
    collector_session_id=53e89540-...
    delivery_session_id=53e89540-...
  ```
- **스크림샷**: 해당없음 (UI 없음, CLI 산출물만)

## 발견 이슈 및 해결

- **이슈**: `tests/regression/test_callback_registration_enforcement.py` 4건 실패.
  - 진단: `dispatch.finalize_hooks` 모듈 미존재 + `dispatch.finalize_with_callback_registration` 미export. `git stash` 한 뒤 origin/main 그대로의 상태에서도 동일 실패 재현 확인.
  - 결정: 본 task scope 밖 (allowed paths 에 `dispatch/finalize_hooks.py` 없음). 회장 verbatim 7 항목 중 어디에도 해당 모듈 결선 없음. 별도 task 로 분리 권고.
- **이슈**: 신규 테스트가 helper 호출 시 4-tuple cron id 누락으로 fail-closed 발생 → 테스트 fixture 에 `cron_id`/`dispatch_cron_id`/`normal_collector_cron_id`/`no_fallback=True` 명시로 해소.

## 머지 판단

- **머지 필요**: Yes (Lv.3 코드 변경)
- **브랜치**: `task/task-2686-dev8`
- **워크트리 경로**: `/home/jay/workspace/.worktrees/task-2686-dev8`
- **머지 의견**: 테스트 신규 34건 + 기존 86건 PASS, live infra 변경 0건, frozen anchors 5건 모두 준수. 그러나 task md 최하단 anchor "★ 본 task md 는 발행 준비만 완료. 실제 dispatch 발사는 회장 verbatim 발사 명령 (executor 봇 지정 + dispatch.py 호출 승인) 대기" 가 있으므로 **PR 생성까지만 자동 수행, 자동 머지는 차단**. allowed_resources.merge_policy 도 `wiring_fix_pr_only_no_auto_merge`. 회장 결정 대기.

## frozen anchors 준수 확인

- **ANCHOR-1**: `chair_facing_session_id` 는 owner_key/collector_key 와 별개 routing field. schema 에서 별도 property 로 정의, helper argv 에서 `--key` 와 `--session` 위치 분리.
- **ANCHOR-2**: key authority (`is_anu_key`) 와 session continuity (`is_valid_session_id` + classifier) 분리. classifier 가 self-key 와 session gap 을 별 enum 으로 분류.
- **ANCHOR-3**: `settings.json` / `hooks/` / `Axis/` / `dispatch.py` 0 byte 변경. `git diff origin/main..HEAD` 에 포함 안됨 (allowed paths 만 변경).
- **ANCHOR-4**: task-2680 (`utils/callback_authority_4source_validator.py`) / PR #149 (task-2661 Phase 2b) / PR #150 (`utils/pr_watcher_terminal_state_classifier.py`) 산출물 변경 0건.
- **ANCHOR-5**: 본 task 의 ANU callback envelope (`memory/events/anu_callback/task-2686-normal-completion.json`) 도 `--session 53e89540-...` 옵션 dogfood 적용 — finish-task.sh 호출 시 `ANU_CHAIR_FACING_SID` 환경변수만 set 하면 자동 propagation.

## 모델 사용 기록

- **라(팀장 · Opus 4.7 1M)**: 설계 / 코드 작성 / 테스트 작성 / 검증 (★ 본 작업은 frozen anchors 5건 + 회장 verbatim 7 항목 정밀 매핑이 핵심 — Sonnet 위임 시 단순 코드 만든 후 anchor 미준수 위험. 4 원칙 § "Think Before Coding" + "Surgical Changes" 적용).
- glm 위임: 0건 (정밀도가 비용보다 우선되는 task).

## 다음 단계 (회장 결정 대기)

1. **PR 생성 승인**: `worktree_manager.py finish ... --action pr` 호출 권한 (Lv.3 게이트 G3 진입).
2. **executor 봇 dispatch 발사 명령**: task md 최하단 anchor 에 따라 별도 verbatim 필요.
3. **다음 task 발행** (선택): task-2687 `callback_4tuple_durable_registry` (spec 5번 Tier 4 후속).

## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회