okstra 0.102.1 → 0.102.3

package/docs/superpowers/plans/2026-06-23-phase-batch-cleanup-enforcement.md

@@ -1,409 +0,0 @@
-# Phase-batch cleanup 강제화 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:** lead 가 phase 전환(배치 경계)마다 이전 팀원·pane 을 정리하도록, 정리 단계를 검증 가능한 `PROGRESS: phase-batch-cleanup` 체크포인트로 만들고 conformance 검증기가 누락 시 run 을 `contract-violated` 로 실패시킨다.
-
-**Architecture:** 정리 로직 자체는 이미 `prompts/profiles/_common-contract.md` "Phase-start cleanup" 에 존재하나 **강제 장치가 없어** lead 가 조용히 건너뛴다(검증되는 PROGRESS 마커 목록에 cleanup 항목 부재). freeform 상태줄을 구조화 마커로 승격하고, 기존 `_check_progress_checkpoints` 의 timestamp-anchor 패턴(이미 `_check_implementation_sidecar_reads` 에서 검증됨)을 그대로 써서 "convergence round 1 직전" 과 "report-writer dispatch 직전" 두 경계에 cleanup 마커가 선행하는지 검사한다. 부수적으로 cleanup 스크립트가 `lead_pane` 미해석 시 worker-agent pane 정리를 통째로 건너뛰던 약점을 태그-기반 anchor fallback 으로 보강한다(Task 2, 선택).
-
-**Tech Stack:** Python 3 (검증기 `validators/`, pytest `tests/`), Bash (`scripts/okstra-trace-cleanup.sh`), Markdown 계약 문서(`prompts/`), Node 빌드(`tools/build.mjs` via `npm run build`).
-
-## Global Constraints
-
-- `runtime/` 는 빌드 산출물 — **직접 수정 금지**. 소스(`prompts/`, `scripts/`, `validators/`)만 고치고 `npm run build` 로 동기화한다.
-- 수정은 반드시 **소스 파일**에 — 개인 `.claude/` 가 아니라 end-user 에게 전파되는 seed/template/소스 파일에.
-- CI 게이트 = `npm run check` 가 exit 0 (test:js 실패 시 test:py 가 안 돌므로 통합 명령으로 확인).
-- 신규/대폭 수정 함수는 effective 50줄 이하.
-- 마커 토큰명: 정확히 **`phase-batch-cleanup`** (validator·계약 문서·테스트 3곳 철자 일치 필수).
-- 문서 산문은 한국어, 코드·경로·식별자·CLI 인자는 영어.
-
----
-
-## File Structure
-
-| 파일 | 책임 | 작업 |
-|---|---|---|
-| `validators/validate_session_conformance.py` | conformance 검증기. `_check_progress_checkpoints` 가 필수 PROGRESS 체크포인트를 `require()`/anchor 로 강제 | 신규 헬퍼 `_check_batch_cleanup_checkpoints` 추가 + 호출부 배선 |
-| `tests/contract/test_validate_session_conformance.py` | 검증기 단위 테스트. `Fixture` 빌더 + `HAPPY_PROGRESS` 공용 시퀀스 | `HAPPY_PROGRESS` 에 cleanup 마커 추가, `Fixture.write_convergence_state` 헬퍼 추가, 신규 테스트 3종 |
-| `prompts/lead/okstra-lead-contract.md` | lead 계약 SSOT. "Progress reporting (BLOCKING)" 의 필수 마커 목록 + Enforcement 문구 | 마커 1줄 추가 + enforcement 문구에 cleanup 검사 포함 |
-| `prompts/profiles/_common-contract.md` | "Phase-start cleanup" 정의(공유 sidecar) | freeform 상태줄 → 구조화 마커 emit 으로 문구 교체 |
-| `scripts/okstra-trace-cleanup.sh` | (Task 2, 선택) run 의 trace+worker-agent pane 닫기 | `lead_pane` 미해석 시 태그-anchor 세션 fallback |
-| `tests/worktree/test_okstra_trace_cleanup.py` | (Task 2, 선택) cleanup 스크립트 real-tmux 테스트 | anchor fallback 테스트 1종 |
-| `runtime/**` | 빌드 산출물 | 손대지 않음 — `npm run build` 가 갱신 |
-
-**왜 검증기 + 계약 문서를 한 Task 로 묶는가:** 마커 정의(계약)와 강제(검증기)는 함께 배포돼야 의미가 있다 — 검사 없는 마커, 또는 문서화 안 된 마커를 강제하는 검증기는 둘 다 미완성이라 리뷰어가 함께 reject 한다.
-
----
-
-## Task 1: cleanup 마커 강제화 (검증기 + 계약 문서)
-
-**Files:**
-- Modify: `validators/validate_session_conformance.py` (헬퍼 추가 ~line 349 뒤, 호출부 `_check_progress_checkpoints` line 395-407)
-- Test: `tests/contract/test_validate_session_conformance.py` (`HAPPY_PROGRESS` line 131-142, `Fixture` class line 154-232, 신규 테스트는 `test_missing_checkpoints_each_reported` line 347 부근 뒤)
-- Modify: `prompts/lead/okstra-lead-contract.md` (line 103 뒤 마커 추가, line 112 enforcement 문구)
-- Modify: `prompts/profiles/_common-contract.md` (line 37, line 43)
-
-**Interfaces:**
-- Consumes: 기존 `_check_progress_checkpoints(evidence, team_state, run_dir, suffix, errors)`, `_convergence_rounds_ran(run_dir, suffix) -> bool`, `by_phase: dict[str, list[tuple[ts, line]]]`, `_DISPATCHED_STATUSES`, `_is_report_writer(worker)`.
-- Produces: `_check_batch_cleanup_checkpoints(by_phase, convergence_ran: bool, report_writer_dispatched: bool, errors: list[str]) -> None` — `phase-batch-cleanup` 마커가 두 배치 경계에 선행하지 않으면 `errors` 에 문자열 append.
-- 새 마커 토큰: `phase-batch-cleanup` (라인 형식 `PROGRESS: phase-batch-cleanup panes=<n> teammates=<m>`).
-
-- [ ] **Step 1: 실패 테스트 작성 — report-writer 직전 cleanup 누락**
-
-`tests/contract/test_validate_session_conformance.py` 의 `test_missing_checkpoints_each_reported`(line 347) 바로 뒤에 추가:
-
-```python
-def test_missing_batch_cleanup_before_report_writer_fails(tmp_path, module):
-    """report-writer dispatch(phase-6-synthesis) 직전에 phase-batch-cleanup
-    마커가 없으면 실패 — 이전 배치 pane/teammate 가 안 치워진 채 다음 배치가
-    뜨는(화면 누적) 상태를 잡는다."""
-    fx = Fixture(tmp_path)
-    progress = [(ts, line) for ts, line in HAPPY_PROGRESS
-                if "phase-batch-cleanup" not in line]
-    fx.write_jsonl([_text_record(ts, line) for ts, line in progress])
-    fx.write_heartbeat()
-    errors = "\n".join(fx.validate(module).errors)
-    assert "phase-batch-cleanup" in errors
-    assert "phase-6-synthesis" in errors
-```
-
-- [ ] **Step 2: 테스트 실패 확인**
-
-Run: `python3 -m pytest tests/contract/test_validate_session_conformance.py::test_missing_batch_cleanup_before_report_writer_fails -v`
-Expected: FAIL — `HAPPY_PROGRESS` 에 아직 `phase-batch-cleanup` 이 없어 `progress` 필터가 무의미하고, 검증기도 마커를 요구하지 않아 `errors` 가 비어 `assert "phase-batch-cleanup" in errors` 가 깨진다.
-
-- [ ] **Step 3: 검증기 헬퍼 구현**
-
-`validators/validate_session_conformance.py` 의 `_check_worker_checkpoint_lines`(line 323-348) 정의 **뒤**, `_check_progress_checkpoints` **앞**에 추가:
-
-```python
-def _check_batch_cleanup_checkpoints(
-    by_phase: dict[str, list[tuple[str, str]]],
-    convergence_ran: bool,
-    report_writer_dispatched: bool,
-    errors: list[str],
-) -> None:
-    """phase-batch-cleanup: 각 배치 경계 직전에 이전 배치 pane/teammate 정리가
-    실제로 일어났는지 (prompts/profiles/_common-contract.md 'Phase-start cleanup').
-    R1=convergence round 1 직전, R2=report-writer dispatch 직전(수렴이 있었으면
-    마지막 라운드 이후 별도 1회). ISO-8601 ts 는 lexicographic 비교가 곧 시간순."""
-    detail = "prompts/profiles/_common-contract.md 'Phase-start cleanup'"
-    cleanup_ts = sorted(ts for ts, _line in by_phase.get("phase-batch-cleanup", []))
-    conv_ts = sorted(ts for ts, _line in by_phase.get("phase-5.5-convergence", []))
-    synth_ts = sorted(ts for ts, _line in by_phase.get("phase-6-synthesis", []))
-
-    if convergence_ran and conv_ts and not any(ts <= conv_ts[0] for ts in cleanup_ts):
-        errors.append(
-            "PROGRESS checkpoint missing: no `phase-batch-cleanup` line before the "
-            f"first `phase-5.5-convergence` round ({conv_ts[0]}) — the prior analysis "
-            f"batch's panes/teammates must be cleared first ({detail})."
-        )
-
-    if report_writer_dispatched and synth_ts:
-        lower = conv_ts[-1] if (convergence_ran and conv_ts) else ""
-        if not any(lower <= ts <= synth_ts[0] for ts in cleanup_ts):
-            errors.append(
-                "PROGRESS checkpoint missing: no `phase-batch-cleanup` line before "
-                f"`phase-6-synthesis` ({synth_ts[0]}) — the prior batch must be cleared "
-                f"before dispatching report-writer ({detail})."
-            )
-```
-
-- [ ] **Step 4: 호출부 배선**
-
-`_check_progress_checkpoints` 의 마지막 블록(현재 line 395-407)을 교체. 기존:
-
-```python
-    require(
-        "phase-5.5-convergence",
-        _convergence_rounds_ran(run_dir, suffix),
-        "at the start of each convergence round (state artifact records totalRounds >= 1)",
-    )
-    report_writer = next((w for w in workers if _is_report_writer(w)), None)
-    require(
-        "phase-6-synthesis",
-        report_writer is not None
-        and str(report_writer.get("status", "")).strip() in _DISPATCHED_STATUSES,
-        "at the start of Phase 6 (report-writer dispatch)",
-    )
-    require("phase-7-persist", True, "at the start of Phase 7")
-```
-
-교체 후:
-
-```python
-    convergence_ran = _convergence_rounds_ran(run_dir, suffix)
-    require(
-        "phase-5.5-convergence",
-        convergence_ran,
-        "at the start of each convergence round (state artifact records totalRounds >= 1)",
-    )
-    report_writer = next((w for w in workers if _is_report_writer(w)), None)
-    report_writer_dispatched = (
-        report_writer is not None
-        and str(report_writer.get("status", "")).strip() in _DISPATCHED_STATUSES
-    )
-    require(
-        "phase-6-synthesis",
-        report_writer_dispatched,
-        "at the start of Phase 6 (report-writer dispatch)",
-    )
-    require("phase-7-persist", True, "at the start of Phase 7")
-    _check_batch_cleanup_checkpoints(
-        by_phase, convergence_ran, report_writer_dispatched, errors
-    )
-```
-
-- [ ] **Step 5: HAPPY_PROGRESS 에 cleanup 마커 추가**
-
-`HAPPY_PROGRESS`(line 131-142)의 `phase-6-synthesis`(`T.format(30)`) 항목 **앞**에 한 줄 삽입:
-
-```python
-    (T.format(20), "PROGRESS: phase-5-collect worker=claude-worker status=completed"),
-    (T.format(21), "PROGRESS: phase-5-collect worker=codex-worker status=completed"),
-    (T.format(25), "PROGRESS: phase-batch-cleanup panes=2 teammates=2"),
-    (T.format(30), "PROGRESS: phase-6-synthesis dispatching report-writer-worker"),
-```
-
-`HAPPY_PROGRESS` 는 `test_happy_path_passes` / `test_codex_lead_events_...` / `test_external_lead_events_...` 3곳이 공유하므로 이 한 줄로 세 happy-path 가 모두 green 유지. (happy-path 는 convergence state artifact 가 없어 `convergence_ran=False` → R1 미적용, R2 만 `lower=""` 로 적용되어 `T.format(25) <= T.format(30)` 충족.)
-
-- [ ] **Step 6: 실패 테스트가 통과로 바뀌는지 확인**
-
-Run: `python3 -m pytest tests/contract/test_validate_session_conformance.py -v`
-Expected: PASS — Step 1 의 신규 테스트 + 기존 happy-path 3종 포함 전부 통과.
-
-- [ ] **Step 7: convergence 경계 테스트 2종 추가**
-
-먼저 `Fixture` class(line 154-232)에 헬퍼 추가 — `validate` 메서드(line 236) 앞:
-
-```python
-    def write_convergence_state(self, total_rounds: int = 1) -> None:
-        (self.run_dir / "state" / f"convergence-{self.suffix}.json").write_text(
-            json.dumps({"totalRounds": total_rounds}), encoding="utf-8"
-        )
-```
-
-그리고 Step 1 테스트 뒤에 추가:
-
-```python
-def test_batch_cleanup_before_convergence_required_when_rounds_ran(tmp_path, module):
-    """convergence 가 실제로 돌았으면(round 1 직전) 그 앞에 cleanup 마커가
-    있어야 한다 — 분석 워커 배치가 안 치워진 채 reverify 가 뜨는 걸 잡는다."""
-    fx = Fixture(tmp_path)
-    fx.write_convergence_state(total_rounds=1)
-    progress = [
-        (T.format(1), "PROGRESS: phase-1-intake reading task bundle"),
-        (T.format(2), "PROGRESS: phase-1-intake complete"),
-        (T.format(3), "PROGRESS: phase-2-prompts preparing 3 worker prompts"),
-        (T.format(4), "PROGRESS: phase-3-team-create attempting TeamCreate"),
-        (T.format(5), "PROGRESS: phase-4-dispatch worker=claude-worker model=opus"),
-        (T.format(6), "PROGRESS: phase-4-dispatch worker=codex-worker model=gpt-5.5"),
-        (T.format(20), "PROGRESS: phase-5-collect worker=claude-worker status=completed"),
-        (T.format(21), "PROGRESS: phase-5-collect worker=codex-worker status=completed"),
-        # NOTE: round 1 직전 cleanup 누락
-        (T.format(22), "PROGRESS: phase-5.5-convergence round=1 queue=3"),
-        (T.format(28), "PROGRESS: phase-batch-cleanup panes=2 teammates=2"),
-        (T.format(30), "PROGRESS: phase-6-synthesis dispatching report-writer-worker"),
-        (T.format(40), "PROGRESS: phase-7-persist updating manifests"),
-    ]
-    fx.write_jsonl([_text_record(ts, line) for ts, line in progress])
-    fx.write_heartbeat()
-    errors = "\n".join(fx.validate(module).errors)
-    assert "phase-batch-cleanup" in errors
-    assert "phase-5.5-convergence" in errors
-
-
-def test_batch_cleanup_two_boundaries_pass(tmp_path, module):
-    """convergence round 1 직전 + report-writer 직전 두 번 cleanup 하면 통과."""
-    fx = Fixture(tmp_path)
-    fx.write_convergence_state(total_rounds=1)
-    progress = [
-        (T.format(1), "PROGRESS: phase-1-intake reading task bundle"),
-        (T.format(2), "PROGRESS: phase-1-intake complete"),
-        (T.format(3), "PROGRESS: phase-2-prompts preparing 3 worker prompts"),
-        (T.format(4), "PROGRESS: phase-3-team-create attempting TeamCreate"),
-        (T.format(5), "PROGRESS: phase-4-dispatch worker=claude-worker model=opus"),
-        (T.format(6), "PROGRESS: phase-4-dispatch worker=codex-worker model=gpt-5.5"),
-        (T.format(20), "PROGRESS: phase-5-collect worker=claude-worker status=completed"),
-        (T.format(21), "PROGRESS: phase-5-collect worker=codex-worker status=completed"),
-        (T.format(7), "PROGRESS: phase-batch-cleanup panes=3 teammates=3"),
-        (T.format(22), "PROGRESS: phase-5.5-convergence round=1 queue=3"),
-        (T.format(28), "PROGRESS: phase-batch-cleanup panes=2 teammates=2"),
-        (T.format(30), "PROGRESS: phase-6-synthesis dispatching report-writer-worker"),
-        (T.format(40), "PROGRESS: phase-7-persist updating manifests"),
-    ]
-    fx.write_jsonl([_text_record(ts, line) for ts, line in progress])
-    fx.write_heartbeat()
-    result = fx.validate(module)
-    assert result.errors == []
-    assert result.ok
-```
-
-주의: `T.format(7)` 이 list 상 `T.format(20/21)` 뒤에 오지만, 검증기는 `by_phase` 안에서 ts 로 정렬(`sorted`)하므로 list 순서 무관 — `T.format(7) <= T.format(22)`(round 1) 이 성립해 R1 충족. (`T = "2026-06-08T01:{:02d}:00Z"` 의 `{:02d}` 가 항상 zero-pad → `01:07:00 <= 01:22:00` lexicographic = 시간순 보장. 확인 완료, 추가 조치 불필요.)
-
-- [ ] **Step 8: 신규 테스트 3종 통과 확인**
-
-Run: `python3 -m pytest tests/contract/test_validate_session_conformance.py -v`
-Expected: PASS (전체).
-
-- [ ] **Step 9: 계약 문서 — 필수 마커 목록에 추가**
-
-`prompts/lead/okstra-lead-contract.md` line 103 (`phase-6-synthesis` 마커) **앞**에 한 줄 삽입:
-
-```markdown
-- `PROGRESS: phase-batch-cleanup panes=<n> teammates=<m>` — 이전 배치 pane·완료 teammate 를 정리한 직후, 각 배치 경계에서(① 첫 `phase-5.5-convergence` round 직전 ② `phase-6-synthesis` report-writer dispatch 직전). 카운트만 노출하고 `%NNN`/lead-pane.id/raw Agent name 은 절대 노출하지 않는다. 첫 배치(분석 워커 dispatch) 직전엔 치울 게 없어 no-op 이며 마커도 생략.
-```
-
-- [ ] **Step 10: 계약 문서 — Enforcement 문구 갱신**
-
-`prompts/lead/okstra-lead-contract.md` line 112 의 Enforcement 문단에서, 검사 항목 열거에 cleanup 을 포함하도록 수정. 기존 `... including the per-worker `phase-4-dispatch` / `phase-5-collect` lines, which must name each worker's role.` 를:
-
-```markdown
-... including the per-worker `phase-4-dispatch` / `phase-5-collect` lines (which must name each worker's role) and the `phase-batch-cleanup` lines that MUST precede the first `phase-5.5-convergence` round and the `phase-6-synthesis` report-writer dispatch.
-```
-
-- [ ] **Step 11: `_common-contract.md` — freeform 상태줄을 구조화 마커로 교체**
-
-`prompts/profiles/_common-contract.md` line 43 의 마지막 문장에서 freeform 예시(`이전 배치 okstra pane 3개 · teammate 2명 정리`)를 마커 emit 으로 교체. 기존:
-
-```markdown
-  - Both (a) and (b) run **automatically without any interactive prompt**. Still emit one short, plain-language status line for the pair (e.g. `이전 배치 okstra pane 3개 · teammate 2명 정리`) and proceed — never expose internal identifiers (`%NNN`, `lead-pane.id`, raw Agent names, step names like "phase-start cleanup"). **Effect caveat:** ...
-```
-
-교체 후(앞부분만 수정, `**Effect caveat:**` 이후는 유지):
-
-```markdown
-  - Both (a) and (b) run **automatically without any interactive prompt**. After running them, emit the checkpoint line `PROGRESS: phase-batch-cleanup panes=<n> teammates=<m>` (counts only — NEVER expose `%NNN`, `lead-pane.id`, or raw Agent names) and proceed; this is the BLOCKING checkpoint the Phase 7 validator requires before each convergence round and before the report-writer dispatch (`prompts/lead/okstra-lead-contract.md` "Progress reporting (BLOCKING)"). **Effect caveat:** ...
-```
-
-그리고 line 37 의 boundary 설명이 마커 기준임을 명확히 — 기존 `at the SAME boundaries: just before each `PROGRESS: phase-5.5-convergence round=<N>` marker and just before `PROGRESS: phase-6-synthesis dispatching report-writer-worker`` 는 그대로 두되, 이미 정확하므로 수정 불필요(확인만).
-
-- [ ] **Step 12: 마커명 일관성 grep**
-
-Run: `grep -rn "phase-batch-cleanup" prompts/ validators/ tests/`
-Expected: `okstra-lead-contract.md`(마커 목록 + enforcement), `_common-contract.md`(emit 문구), `validate_session_conformance.py`(헬퍼), `test_validate_session_conformance.py`(HAPPY_PROGRESS + 테스트 3종) — 철자 `phase-batch-cleanup` 로 전부 일치, 오타/변형 없음.
-
-- [ ] **Step 13: 빌드 + 전체 CI**
-
-Run: `npm run build && npm run check`
-Expected: `npm run build` 가 `runtime/` 동기화(특히 `runtime/prompts/`, `runtime/python/`), `npm run check` exit 0.
-
-- [ ] **Step 14: 커밋**
-
-```bash
-git add validators/validate_session_conformance.py \
-        tests/contract/test_validate_session_conformance.py \
-        prompts/lead/okstra-lead-contract.md \
-        prompts/profiles/_common-contract.md \
-        runtime/
-git commit -m "feat(conformance): enforce phase-batch-cleanup checkpoint before each batch boundary"
-```
-
----
-
-## Task 2 (선택, defense-in-depth): cleanup 스크립트 anchor fallback
-
-**근거:** Task 1 로 lead 가 정리를 실제 수행하면, tmux 안에서 실행된 run 은 `lead-pane.id` 가 정상 기록되어 `okstra-trace-cleanup.sh` 가 worker-agent pane 까지 닫는다. 다만 `lead-pane.id` 기록이 실패하거나 foreign pane 으로 해석되면 worker-agent title 스캔(`scripts/okstra-trace-cleanup.sh:165`)이 통째로 skip 되어 `claude-worker` 류 pane 이 남는다. 같은 run 의 태그된 trace pane 을 세션 anchor 로 써서 이 경우를 보강한다. **이 Task 는 mixed run(codex/antigravity 가 있어 `-tail` trace pane 이 존재)에서만 효과** — 순수 claude run 은 태그 anchor 가 없어 여전히 `lead-pane.id` 의존. 그래서 선택 사항.
-
-**Files:**
-- Modify: `scripts/okstra-trace-cleanup.sh` (`collect_okstra_panes` line 131-181)
-- Test: `tests/worktree/test_okstra_trace_cleanup.py` (real-tmux, tmux 없으면 skip)
-
-**Interfaces:**
-- Consumes: 기존 tag 스캔이 채우는 `panes` 배열, `lead_pane`, `_tag_in_scope`.
-- Produces: `lead_pane` 미해석 시에도 태그된 in-scope pane 의 세션에서 worker-agent title 스캔 수행.
-
-- [ ] **Step 1: 실패 테스트 작성**
-
-`tests/worktree/test_okstra_trace_cleanup.py` 기존 패턴(`_new_detached_session`/`_split_pane`/`@okstra_trace_run` 태깅)을 따라 추가. lead-pane.id 를 **쓰지 않고**, 태그된 trace pane + `claude-worker` 제목 pane 을 같은 세션에 두고 `--list` 가 worker-agent pane 을 집어내는지 검증:
-
-```python
-def test_worker_agent_pane_found_via_tag_anchor_without_lead_pane_id(session_name, tmp_path):
-    if not _TMUX_SPAWN_AVAILABLE:
-        pytest.skip("tmux detached sessions not available")
-    run_dir = tmp_path / "run"
-    (run_dir / "state").mkdir(parents=True)  # lead-pane.id 는 일부러 쓰지 않음
-
-    lead = _new_detached_session(session_name)
-    trace = _split_pane(session_name)
-    worker = _split_pane(session_name)
-    _tmux("set-option", "-p", "-t", trace, "@okstra_trace_run", str(run_dir.resolve()))
-    _tmux("select-pane", "-t", worker, "-T", "claude-worker")
-
-    res = subprocess.run(
-        ["bash", str(SCRIPT), "--list", "--run-dir", str(run_dir)],
-        capture_output=True, text=True, check=False,
-    )
-    out_ids = {line.split("\t", 1)[0] for line in res.stdout.strip().splitlines() if line}
-    assert worker in out_ids, res.stdout  # anchor fallback 으로 worker-agent pane 포착
-    assert lead not in out_ids            # lead pane 은 절대 미포함
-```
-
-(헬퍼 시그니처는 파일 상단 실제 정의와 맞춘다 — `_split_pane` 가 `session` 만 받는지, 반환이 pane_id 인지 line 85-90 확인.)
-
-- [ ] **Step 2: 테스트 실패 확인**
-
-Run: `python3 -m pytest tests/worktree/test_okstra_trace_cleanup.py::test_worker_agent_pane_found_via_tag_anchor_without_lead_pane_id -v`
-Expected: FAIL — `lead_pane` 미해석 → 현재 코드는 title 스캔 자체를 skip → `worker` pane 이 출력에 없음.
-
-- [ ] **Step 3: anchor fallback 구현**
-
-`scripts/okstra-trace-cleanup.sh` `collect_okstra_panes`(line 131-181) 수정. (1) tag 스캔 루프에서 in-scope 첫 pane 을 `scope_anchor` 로 기억, (2) title 스캔을 `lead_pane` 과 `scope_anchor` 두 세션에 대해 수행(dedup 은 기존 line 178-180 이 처리). 기존 `local pid trace_tag worker_tag status_tag title` 선언에 `scope_anchor` 추가하고, in-scope 매치 직후 `[[ -z "$scope_anchor" ]] && scope_anchor="$pid"` 한 줄 추가. title 스캔 블록(line 165-175)을 교체:
-
-```bash
-  # (2) Title-allowlisted worker-agent panes. Scope to the lead's session AND
-  # (fallback when lead-pane.id was unrecorded or resolved to a foreign pane) the
-  # session of any tagged in-scope pane found above — both are THIS run's session,
-  # so the scan never reaches unrelated sessions. dedup below drops overlaps.
-  if [[ "$REAP" -eq 0 && "$RECLAIM" -eq 0 ]]; then
-    local -a _scopes=()
-    [[ -n "$lead_pane" ]] && _scopes+=("$lead_pane")
-    [[ -n "$scope_anchor" ]] && _scopes+=("$scope_anchor")
-    local _scope
-    for _scope in "${_scopes[@]}"; do
-      while IFS=$'\t' read -r pid title; do
-        [[ -n "$pid" ]] || continue
-        [[ "$pid" == "$lead_pane" ]] && continue
-        case "$title" in
-          *claude-worker*|*codex-worker*|*antigravity-worker*|*report-writer-worker*)
-            panes+=("$pid") ;;
-        esac
-      done < <(tmux list-panes -s -t "$_scope" \
-                 -F '#{pane_id}'$'\t''#{pane_title}' 2>/dev/null || true)
-    done
-  fi
-```
-
-- [ ] **Step 4: 테스트 통과 확인**
-
-Run: `python3 -m pytest tests/worktree/test_okstra_trace_cleanup.py -v`
-Expected: PASS (신규 + 기존 전부). lead-pane.id 가 있는 기존 테스트도 `_scopes` 에 `lead_pane` 우선 포함되어 동작 동일.
-
-- [ ] **Step 5: 빌드 + CI + 커밋**
-
-```bash
-npm run build && npm run check
-git add scripts/okstra-trace-cleanup.sh tests/worktree/test_okstra_trace_cleanup.py runtime/
-git commit -m "fix(cleanup): scope worker-agent pane scan via tagged anchor when lead pane unresolved"
-```
-
----
-
-## 범위 밖 (이번 계획에서 다루지 않음)
-
-- **완료 감지 강제화(Fix 3):** 사용자의 최초 질문이었으나 스크린샷상 이번 run 은 감지가 동작 중(`@report-writer-2 came to rest` → result-missing 분류까지 진행). lead 가 idle 알림 대신 항상 background 폴링 루프를 띄우게 하는 enforcement 는 별도 설계 대상(`team-contract.md` "Worker-completion detection")이라 분리. 필요 시 후속 계획으로.
-- **roster idle-pill 잔상:** `_common-contract.md:43` 의 "Effect caveat" — Claude Code 가 mid-run roster 항목을 외과적으로 지우는 도구를 노출하지 않음. tmux **pane** 은 이 계획으로 닫히지만 FleetView **pill** 잔상은 harness 한계로 남음(고칠 수 없음, 문서화된 상태 유지).
-
----
-
-## Self-Review
-
-**1. Spec coverage:**
-- "phase 전환 시 정리 안 됨 → 화면 복잡" 근본원인(강제 부재) → Task 1 (마커 + 검증기).
-- "정리하고 다음 팀원 생성" 두 경계(convergence 직전 / report-writer 직전) → Task 1 R1+R2.
-- pane 이 실제로 안 닫히는 보조 결함(`lead_pane` skip) → Task 2.
-- 최초 질문(완료 감지) → 범위 밖으로 명시 + 근거.
-
-**2. Placeholder scan:** 모든 Step 에 실제 코드/명령/기대출력 기재. TBD/"적절히 처리" 없음. `T` zero-pad 가정은 Step 7 에서 grep 확인 + 대체값 명시로 방어.
-
-**3. Type consistency:** 마커 토큰 `phase-batch-cleanup` 4개 파일 동일(Step 12 grep 으로 강제). 헬퍼 시그니처 `_check_batch_cleanup_checkpoints(by_phase, convergence_ran, report_writer_dispatched, errors)` — 호출부(Step 4)와 정의(Step 3) 인자 순서·이름 일치. `by_phase` 값 타입 `(ts, line)` — 기존 line 358-360 과 동일. `_convergence_rounds_ran`/`_DISPATCHED_STATUSES`/`_is_report_writer` 모두 기존 심볼 재사용.