okstra 0.102.2 → 0.102.4

package/docs/superpowers/plans/2026-06-18-subagent-pane-reclaim.md

@@ -1,483 +0,0 @@
-# Worker pane 완료-즉시 회수 + 내성 fallback 구현 계획
-
-> **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:** 외부 CLI worker(codex/antigravity)의 trace pane 을 완료 즉시 회수하고, pane 생성 실패 시 in-process 대체로 run 이 멈추지 않게 하여 tmux pane 한도 초과를 방지한다.
-
-**Architecture:** wrapper 가 trace pane 에 자기 status 파일 경로를 태그(`@okstra_status`)로 단다 → `SubagentStop`/`TaskCompleted` 훅이 `active.jsonl` 의 활성 run 을 순회하며 `okstra-trace-cleanup.sh --reclaim-completed` 를 호출 → 그 모드는 status 가 `exited`(완료)인 trace pane 만 닫고 진행 중은 보존한다. 하니스가 만드는 teammate pane 은 okstra 가 태그할 수 없어 회수 대상에서 제외하고, lead 계약의 내성 fallback 으로 다룬다.
-
-**Tech Stack:** Bash(wrapper/cleanup/hook 엔트리), Python(`okstra_ctl` — 완료 판정은 기존 `wrapper_status.read_wrapper_status` 재사용), tmux user-options(`@okstra_*`), Claude Code hooks.
-
-## Global Constraints
-
-- `runtime/` 는 빌드 산출물 — 직접 수정 금지. 소스는 `scripts/`, `templates/` 에 두고 `npm run build` 로 동기화([CLAUDE.md](../../../CLAUDE.md)).
-- 사용자 영향 수정은 seed/template 에 — 훅은 [templates/reports/settings.template.json](../../../templates/reports/settings.template.json) 에 배선(개인 `.claude/` 아님).
-- Bash 는 thin 엔트리/어댑터. 판정 로직은 Python 모듈 재사용 — Bash 에 비즈니스 로직 복제 금지.
-- 새/대폭 수정 함수는 유효 50줄 이내.
-- pre-1.0 — 하위호환 shim 없음.
-- 문서/주석 한국어(코드 식별자·경로·CLI 인자는 영어).
-- 완료 판정 SSOT: `wrapper_status.WrapperStatus.is_terminal`(`stage == "exited"`) — 새 판정 로직 만들지 말 것.
-- "worktree" 용어는 실제 git worktree 에만 — stage 폴더 상위는 "상위 디렉터리".
-
----
-
-## Task 0: 실측 게이트 — teammate pane title 확인 (코드 작성 전 1회)
-
-설계의 단 하나 미검증 가정: **하니스가 teammate(subagent) pane title 을 `*-worker` 로 다는가.** 이 결과가 회수 범위를 정한다(trace pane 만 vs teammate pane 도). tmux 안에서 실측한다.
-
-**Files:** 없음(조사).
-
-- [ ] **Step 1: tmux 세션 안에서 okstra worker 1개를 띄운 직후 pane title 덤프**
-
-tmux 안에서 `/okstra-run` 또는 직접 dispatch 로 worker 1개를 띄운 뒤:
-
-Run: `tmux list-panes -a -F '#{pane_id}\t#{pane_title}\t#{@okstra_trace_run}\t#{@okstra_worker_run}'`
-
-- [ ] **Step 2: 판정 기록**
-
-- teammate pane title 이 `claude-worker` / `codex-worker` / `antigravity-worker` / `report-writer-worker` 중 하나와 `*<title>*` 매칭되면 → **회수 가능**. 이 plan 의 Task 2 끝 "조건부 확장" 을 적용한다.
-- 매칭 안 되거나(빈 title, 하니스 고유 라벨) 같은 title 이 여러 worker 에 중복돼 진행중/완료 구분이 불가하면 → **trace pane 만 회수**. teammate 누적은 Task 5 내성에 의존(설계대로). 이 경우 Task 2 "조건부 확장" 은 건너뛴다.
-- 결과를 이 파일 Task 0 아래 한 줄로 적어 후속 task 가 참조하게 한다.
-
-> 실측 불가 환경(현재 세션이 tmux 밖)이면: trace pane 만 회수하는 경로로 진행하고, teammate 회수는 미적용으로 둔다. 이는 안전한 기본값이다(없는 기능을 가정해 진행 중 pane 을 죽이는 것보다 낫다).
-
----
-
-## Task 1: wrapper 가 trace pane 에 `@okstra_status` 태그 추가
-
-trace pane 을 그 worker 의 status 파일과 연결한다. cleanup 이 이 태그로 완료 여부를 읽는다.
-
-**Files:**
-- Modify: `scripts/okstra-codex-exec.sh` (trace pane 태그 블록, 현재 `@okstra_trace_run` 설정부 근처 ~272-281)
-- Modify: `scripts/okstra-antigravity-exec.sh` (동일 블록 ~214-220)
-
-**Interfaces:**
-- Consumes: 각 wrapper 가 이미 보유한 `$status_path`(`${prompt_path%.md}.status.json`, codex:182 / antigravity:138)와 `$trace_pane`(split 결과 pane id).
-- Produces: trace pane 의 tmux user-option `@okstra_status=<status_path 절대경로>`.
-
-- [ ] **Step 1: codex wrapper — `@okstra_trace_run` 설정 직후 status 태그 추가**
-
-`scripts/okstra-codex-exec.sh` 의 `tmux set-option -p -t "$trace_pane" @okstra_trace_run "$run_dir"` 줄 **직후**에 추가:
-
-```bash
-    [[ -n "$status_path" ]] && tmux set-option -p -t "$trace_pane" @okstra_status "$status_path" 2>/dev/null || true
-```
-
-- [ ] **Step 2: antigravity wrapper — 동일 추가**
-
-`scripts/okstra-antigravity-exec.sh` 의 동일한 `@okstra_trace_run` 설정 줄 직후에 같은 한 줄을 추가(변수명 `$status_path` / `$trace_pane` 동일).
-
-- [ ] **Step 3: 태그 라인이 두 파일에 들어갔는지 확인**
-
-Run: `grep -n '@okstra_status' scripts/okstra-codex-exec.sh scripts/okstra-antigravity-exec.sh`
-Expected: 두 파일 각각 1줄.
-
-- [ ] **Step 4: 커밋**
-
-```bash
-git add scripts/okstra-codex-exec.sh scripts/okstra-antigravity-exec.sh
-git commit -m "feat(wrapper): trace pane 에 @okstra_status 태그를 달아 완료 회수 연결"
-```
-
----
-
-## Task 2: `okstra-trace-cleanup.sh --reclaim-completed` 모드
-
-완료된(`stage == "exited"`) worker 의 trace pane 만 닫고 진행 중은 보존하는 모드. 완료 판정은 Python SSOT 를 호출한다.
-
-**Files:**
-- Create: `scripts/okstra_ctl/pane_reclaim.py` (완료 판정 wrapper — 테스트 대상)
-- Modify: `scripts/okstra-trace-cleanup.sh` (인자 파싱 + collect 에 완료 필터)
-- Test: `tests/test_pane_reclaim.py`
-
-**Interfaces:**
-- Consumes: trace pane 의 `@okstra_status` 태그(Task 1), `@okstra_trace_run` 태그(기존).
-- Produces: `pane_reclaim.is_completed_status(status_path: str) -> bool` (CLI: `python3 -m okstra_ctl.pane_reclaim <status_path>` → exit 0 완료 / 1 미완료·부재). `okstra-trace-cleanup.sh --reclaim-completed --run-dir <RUN_DIR>`.
-
-- [ ] **Step 1: 완료 판정 테스트 작성 (실패)**
-
-`tests/test_pane_reclaim.py`:
-
-```python
-from pathlib import Path
-from okstra_ctl.pane_reclaim import is_completed_status
-
-
-def _write(p: Path, stage: str) -> Path:
-    p.write_text('{"stage": "%s", "exit_code": 0}' % stage, encoding="utf-8")
-    return p
-
-
-def test_exited_status_is_completed(tmp_path):
-    assert is_completed_status(str(_write(tmp_path / "w.status.json", "exited"))) is True
-
-
-def test_started_status_is_not_completed(tmp_path):
-    assert is_completed_status(str(_write(tmp_path / "w.status.json", "started"))) is False
-
-
-def test_missing_status_is_not_completed(tmp_path):
-    assert is_completed_status(str(tmp_path / "absent.status.json")) is False
-```
-
-- [ ] **Step 2: 테스트 실패 확인**
-
-Run: `python3 -m pytest tests/test_pane_reclaim.py -v`
-Expected: FAIL — `ModuleNotFoundError: okstra_ctl.pane_reclaim`
-
-- [ ] **Step 3: `pane_reclaim.py` 구현 (기존 SSOT 재사용)**
-
-`scripts/okstra_ctl/pane_reclaim.py`:
-
-```python
-"""완료(terminal) worker 판정 — pane 회수용. 판정 SSOT 는
-wrapper_status.read_wrapper_status 이며 여기서 재사용한다."""
-from __future__ import annotations
-
-import sys
-from pathlib import Path
-
-from .wrapper_status import read_wrapper_status
-
-
-def is_completed_status(status_path: str) -> bool:
-    status = read_wrapper_status(Path(status_path))
-    return status is not None and status.is_terminal
-
-
-def main(argv: list[str]) -> int:
-    if len(argv) != 1:
-        return 1
-    return 0 if is_completed_status(argv[0]) else 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(main(sys.argv[1:]))
-```
-
-- [ ] **Step 4: 테스트 통과 확인**
-
-Run: `python3 -m pytest tests/test_pane_reclaim.py -v`
-Expected: PASS (3 passed)
-
-- [ ] **Step 5: `okstra-trace-cleanup.sh` 에 `--reclaim-completed` 인자 추가**
-
-옵션 파싱(`while` 루프 `case`)에 추가:
-
-```bash
-    --reclaim-completed) MODE="reclaim" ;;
-```
-
-`MODE` 초기값 주석에 `reclaim` 추가. `--reclaim-completed` 는 `--run-dir` 필수(기존 검증 재사용).
-
-- [ ] **Step 6: collect 에 완료 필터 적용**
-
-`collect_okstra_panes` 의 (1) 태그 스캔 루프에서, `MODE == "reclaim"` 일 때 trace pane 은 `@okstra_status` 가 완료일 때만 포함하도록 분기. tmux 수집 포맷에 `@okstra_status` 컬럼을 추가하고 판정을 끼운다:
-
-```bash
-  while IFS=$'\t' read -r pid trace_tag worker_tag status_tag; do
-    [[ -n "$pid" ]] || continue
-    [[ "$pid" == "$lead_pane" ]] && continue
-    if _tag_in_scope "$trace_tag" || _tag_in_scope "$worker_tag"; then
-      if [[ "$MODE" == "reclaim" ]]; then
-        # reclaim 모드: 완료(stage=exited)된 worker 의 pane 만. status 태그가
-        # 없거나(teammate/비-wrapper pane) 미완료면 보존.
-        [[ -n "$status_tag" ]] || continue
-        python3 -m okstra_ctl.pane_reclaim "$status_tag" || continue
-      fi
-      panes+=("$pid")
-    fi
-  done < <(tmux list-panes -a \
-             -F '#{pane_id}'$'\t''#{@okstra_trace_run}'$'\t''#{@okstra_worker_run}'$'\t''#{@okstra_status}' \
-             2>/dev/null || true)
-```
-
-`MODE == "reclaim"` 에서는 (2) title-allowlist teammate 스캔을 **건너뛴다**(Task 0 미통과 기본값 — teammate pane 보존). `MODE` 가 `kill`/`list` 일 때는 기존 동작 유지. `kill` 분기는 `MODE in (kill, reclaim)` 가 동일 kill 경로를 타도록 마지막 실행부 조건을 `[[ "$MODE" != "list" ]]` 로 둔다.
-
-> **Task 0 통과 시에만** — teammate pane 도 회수하려면, reclaim 모드에서 (2) title 스캔을 살리되 각 teammate pane 의 완료 판정을 추가해야 한다. 단 teammate pane 엔 `@okstra_status` 태그가 없으므로(okstra 가 못 닮) 완료를 디스크에서 역매핑할 수단이 필요하다. Task 0 결과가 "회수 가능"이면 그 매핑(title→worker→status_path)을 별도 스텝으로 설계해 추가하고, 아니면 이 박스는 무시한다.
-
-- [ ] **Step 7: PYTHONPATH 확인 — cleanup 이 `okstra_ctl` 를 import 할 수 있는지**
-
-`okstra-trace-cleanup.sh` 가 `python3 -m okstra_ctl.pane_reclaim` 를 호출하려면 `scripts/` 가 `sys.path` 에 있어야 한다. 스크립트 상단(기존 `_clean_script_dir` 도출 직후)에 추가:
-
-```bash
-export PYTHONPATH="$_clean_script_dir${PYTHONPATH:+:$PYTHONPATH}"
-```
-
-설치 레이아웃에서 `pane_reclaim.py`/`wrapper_status.py` 가 `$_clean_script_dir` 기준 어디에 놓이는지 [src/install.mjs](../../../src/install.mjs) 의 python 페이로드 경로와 대조해 PYTHONPATH 를 맞춘다(repo 는 `scripts/`, 설치본은 `~/.okstra/lib/python/`).
-
-- [ ] **Step 8: e2e 시나리오 — 완료 pane 회수 / 진행 중 보존**
-
-`tests-e2e/scenario-<id>-pane-reclaim.sh`: `mktemp -d` OKSTRA_HOME, tmux 가용할 때만 실행(없으면 skip). 모의 run-dir 에 두 worker prompt+status(`exited` 1개, `started` 1개)와 태그된 모의 pane 2개를 만들고, `--reclaim-completed --list` 가 `exited` pane 만 출력하는지 검증. `trap` 으로 OKSTRA_HOME 정리.
-
-- [ ] **Step 9: 단위 테스트 통과 + 커밋**
-
-Run: `python3 -m pytest tests/test_pane_reclaim.py -v && bash -n scripts/okstra-trace-cleanup.sh`
-Expected: PASS + 문법 오류 없음
-
-```bash
-git add scripts/okstra_ctl/pane_reclaim.py scripts/okstra-trace-cleanup.sh tests/test_pane_reclaim.py tests-e2e/scenario-*-pane-reclaim.sh
-git commit -m "feat(cleanup): --reclaim-completed 모드 — 완료된 trace pane 만 회수"
-```
-
----
-
-## Task 3: 훅 진입점 `okstra-subagent-reclaim.sh` — 활성 run 순회
-
-`SubagentStop`/`TaskCompleted` 가 주는 stdin 은 run-dir 을 직접 주지 않고 `cwd` 도 run-dir 보장이 없다. session_id 매핑 대신 `active.jsonl` 의 활성 run 을 모두 순회한다 — 완료 판정(Task 2)이 cross-run 안전을 보장하므로 다른 run 의 진행 중 pane 을 건드리지 않는다.
-
-**Files:**
-- Create: `scripts/okstra-subagent-reclaim.sh`
-- Test: `tests/test_subagent_reclaim_targets.py` (run-dir 추출 로직을 Python helper 로 분리해 테스트)
-
-**Interfaces:**
-- Consumes: stdin JSON(무시 가능 — 어느 worker 가 끝났든 활성 run 전체를 reclaim), `~/.okstra/active.jsonl`(`runDirRel`/`projectRoot`/`status`).
-- Produces: `pane_reclaim.active_run_dirs(home: Path) -> list[Path]` (status 가 종료 상태가 아닌 run 들의 절대 run-dir).
-
-- [ ] **Step 1: active run-dir 추출 테스트 작성 (실패)**
-
-`tests/test_subagent_reclaim_targets.py`:
-
-```python
-import json
-from pathlib import Path
-from okstra_ctl.pane_reclaim import active_run_dirs
-
-
-def test_active_run_dirs_resolves_absolute(tmp_path):
-    home = tmp_path
-    (home / "active.jsonl").write_text(
-        json.dumps({"status": "running", "runDirRel": "tasks/g/t/runs/x", "projectRoot": "/proj"}) + "\n",
-        encoding="utf-8",
-    )
-    dirs = active_run_dirs(home)
-    assert dirs == [home / "tasks/g/t/runs/x"]
-
-
-def test_finished_runs_excluded(tmp_path):
-    home = tmp_path
-    (home / "active.jsonl").write_text(
-        json.dumps({"status": "done", "runDirRel": "tasks/g/t/runs/x", "projectRoot": "/proj"}) + "\n",
-        encoding="utf-8",
-    )
-    assert active_run_dirs(home) == []
-```
-
-> **구현 전 확인:** `runDirRel` 의 base 가 `home` 인지 `projectRoot` 인지 [index.py](../../../scripts/okstra_ctl/index.py) `reserve_active` 호출부에서 확정하고, 위 테스트의 기대 경로를 그에 맞춘다. `status` 의 "활성" 집합(`reserving`/`running`/...)도 같은 파일에서 확인해 제외 조건을 맞춘다.
-
-- [ ] **Step 2: 테스트 실패 확인**
-
-Run: `python3 -m pytest tests/test_subagent_reclaim_targets.py -v`
-Expected: FAIL — `active_run_dirs` 없음
-
-- [ ] **Step 3: `active_run_dirs` 를 `pane_reclaim.py` 에 추가**
-
-```python
-import json
-
-_FINISHED = {"done", "complete", "error", "aborted"}  # index.py 의 종료 status 와 대조해 확정
-
-
-def active_run_dirs(home: Path) -> list[Path]:
-    path = home / "active.jsonl"
-    if not path.is_file():
-        return []
-    dirs: list[Path] = []
-    for line in path.read_text(encoding="utf-8").splitlines():
-        line = line.strip()
-        if not line:
-            continue
-        try:
-            row = json.loads(line)
-        except json.JSONDecodeError:
-            continue
-        rel = row.get("runDirRel")
-        if not rel or row.get("status") in _FINISHED:
-            continue
-        dirs.append(home / rel)
-    return dirs
-```
-
-- [ ] **Step 4: 테스트 통과 확인**
-
-Run: `python3 -m pytest tests/test_subagent_reclaim_targets.py -v`
-Expected: PASS
-
-- [ ] **Step 5: 훅 엔트리 스크립트 작성**
-
-`scripts/okstra-subagent-reclaim.sh`:
-
-```bash
-#!/usr/bin/env bash
-#
-# okstra-subagent-reclaim.sh — SubagentStop / TaskCompleted 훅 엔트리.
-# stdin(JSON)은 읽고 버린다(어느 worker 가 끝났든 활성 run 전체의 완료 pane 만
-# 회수하므로). active.jsonl 의 각 활성 run 에 대해 cleanup --reclaim-completed.
-# 모든 실패는 조용히 삼킨다 — 훅은 세션 진행을 절대 막지 않는다.
-set -u
-cat >/dev/null 2>&1 || true   # drain stdin
-
-_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-home="${OKSTRA_HOME:-$HOME/.okstra}"
-export PYTHONPATH="$_dir${PYTHONPATH:+:$PYTHONPATH}"
-
-while IFS= read -r run_dir; do
-  [[ -n "$run_dir" ]] || continue
-  "$_dir/okstra-trace-cleanup.sh" --reclaim-completed --run-dir "$run_dir" 2>/dev/null || true
-done < <(python3 -m okstra_ctl.pane_reclaim --active-dirs "$home" 2>/dev/null || true)
-
-exit 0
-```
-
-`pane_reclaim.main` 에 `--active-dirs <home>` 서브커맨드를 추가해 `active_run_dirs` 결과를 한 줄씩 출력하게 한다(기존 단일 status_path 판정과 분기).
-
-- [ ] **Step 6: `pane_reclaim.main` 에 `--active-dirs` 분기 추가**
-
-```python
-def main(argv: list[str]) -> int:
-    if len(argv) == 2 and argv[0] == "--active-dirs":
-        for d in active_run_dirs(Path(argv[1])):
-            print(d)
-        return 0
-    if len(argv) == 1:
-        return 0 if is_completed_status(argv[0]) else 1
-    return 1
-```
-
-- [ ] **Step 7: 실행권한 + 문법 + 테스트**
-
-Run: `chmod +x scripts/okstra-subagent-reclaim.sh && bash -n scripts/okstra-subagent-reclaim.sh && python3 -m pytest tests/test_subagent_reclaim_targets.py tests/test_pane_reclaim.py -v`
-Expected: PASS
-
-- [ ] **Step 8: 커밋**
-
-```bash
-git add scripts/okstra-subagent-reclaim.sh scripts/okstra_ctl/pane_reclaim.py tests/test_subagent_reclaim_targets.py
-git commit -m "feat(hook): okstra-subagent-reclaim.sh — 활성 run 의 완료 pane 회수 엔트리"
-```
-
----
-
-## Task 4: 훅 배선 — `settings.template.json`
-
-완료 이벤트에 reclaim 엔트리를 배선한다. no-team(Agent) 경로는 `SubagentStop`, Teams 경로는 `TaskCompleted`.
-
-**Files:**
-- Modify: `templates/reports/settings.template.json` (`hooks` 객체)
-
-- [ ] **Step 1: 두 이벤트 훅 추가**
-
-`hooks` 객체에 추가(기존 `PreToolUse`, `SessionEnd` 유지):
-
-```json
-    "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "$HOME/.okstra/bin/okstra-subagent-reclaim.sh"
-          }
-        ]
-      }
-    ],
-    "TaskCompleted": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "$HOME/.okstra/bin/okstra-subagent-reclaim.sh"
-          }
-        ]
-      }
-    ]
-```
-
-- [ ] **Step 2: JSON 유효성 확인**
-
-Run: `python3 -c "import json; json.load(open('templates/reports/settings.template.json'))"`
-Expected: 오류 없음
-
-- [ ] **Step 3: 설치 payload 에 새 스크립트가 포함되는지 확인**
-
-[src/install.mjs](../../../src/install.mjs) 가 `scripts/okstra-*.sh` 를 `~/.okstra/bin/` 으로 복사하는 규칙에 `okstra-subagent-reclaim.sh` 가 자동 포함되는지(glob/명시 목록) 확인. 명시 목록이면 추가한다.
-
-Run: `grep -n 'okstra-trace-cleanup\|okstra-.*\.sh\|bin/' src/install.mjs | head`
-
-- [ ] **Step 4: 커밋**
-
-```bash
-git add templates/reports/settings.template.json src/install.mjs
-git commit -m "feat(hook): SubagentStop/TaskCompleted 에 pane reclaim 배선"
-```
-
----
-
-## Task 5: 내성 계약 — `_common-contract.md`
-
-하니스 teammate pane 생성 실패는 okstra Python 이 못 보므로 코드 강제 불가. lead 행동 계약에 명시한다(declaration, prompt 지시임을 분명히).
-
-**Files:**
-- Modify: `prompts/profiles/_common-contract.md` (dispatch/convergence 절)
-
-- [ ] **Step 1: pane-실패 fallback 문단 추가**
-
-기존 dispatch 관련 절에 추가(한국어/영어는 그 파일의 기존 언어 관행에 맞춤):
-
-> **Pane-budget fallback (tolerance).** worker dispatch 가 `no room for another tmux split`(또는 동등한 teammate pane 생성 실패)로 거부되면, 그 worker 를 `run_in_background` 없이 in-process 로 재시도하거나, 외부 CLI worker 였다면 in-process claude 분석으로 **대체**하고 그 사실(provider 불가)을 run 기록·convergence 노트에 남긴다. 완료된 외부 CLI worker 의 trace pane 은 `SubagentStop` 훅이 자동 회수하지만, 하니스가 만든 teammate pane 누적은 okstra 가 직접 회수할 수 없으므로 이 fallback 이 최후 방어선이다. (이는 코드 강제가 아닌 prompt 지시다.)
-
-- [ ] **Step 2: declaration ≠ enforcement 규칙 준수 확인**
-
-이 문단이 "MUST/BLOCKING" 같은 강제 용어를 enforcement 없이 쓰지 않는지 확인(글로벌 5.5). "최후 방어선"·"대체한다" 수준의 행동 지시로 유지하고, 코드 강제가 아님을 명시한 현재 문구를 지킨다.
-
-- [ ] **Step 3: 커밋**
-
-```bash
-git add prompts/profiles/_common-contract.md
-git commit -m "docs(contract): pane-budget fallback — pane 실패 시 in-process 대체"
-```
-
----
-
-## Task 6: 빌드 동기화 + 전체 검증
-
-**Files:** 없음(빌드/검증).
-
-- [ ] **Step 1: 빌드**
-
-Run: `npm run build`
-Expected: `done. NN/NN sources synced.`
-
-- [ ] **Step 2: 전체 단위 + 워크플로 검증**
-
-Run: `python3 -m pytest tests/ -q && bash validators/validate-workflow.sh`
-Expected: 모두 통과
-
-- [ ] **Step 3: CLI 스모크 + doctor**
-
-Run: `node bin/okstra --version && node bin/okstra doctor`
-Expected: 정상
-
-- [ ] **Step 4: CHANGES.md 항목 추가 (사용자 영향)**
-
-`CHANGES.md` 최상단 날짜 섹션에 항목 추가 — trace pane 완료-즉시 회수 + 내성 fallback 이 pane 한도 초과를 완화한다는 `사용자 영향:` 줄 포함. 한국어.
-
-- [ ] **Step 5: 커밋**
-
-```bash
-git add CHANGES.md
-git commit -m "docs(changes): worker trace pane 완료-회수 + 내성 fallback"
-```
-
----
-
-## 완료 기준
-
-- 외부 CLI worker 완료 시 그 trace pane 이 `SubagentStop`/`TaskCompleted` 훅으로 자동 회수되고, 진행 중 worker 의 pane 은 보존된다(e2e 시나리오로 입증).
-- pane 생성 실패 시 lead 가 in-process 대체로 진행하도록 계약에 명시된다.
-- 전체 pytest + validate-workflow 통과, 빌드 동기화 완료.
-- teammate pane 회수는 Task 0 실측 결과에 따라 적용/미적용이 명확히 기록된다.
-
-## 알려진 한계 (spec §9 와 일치)
-
-- 하니스 teammate pane 은 okstra 가 태그·식별을 보장할 수 없어, Task 0 미통과 시 회수 대상이 아니다 — 그 누적은 Task 5 내성에 의존하며, 내성은 코드 강제가 불가능한 prompt 계약이다.
-- 한 세션 다중 동시 run 시 active.jsonl 순회가 모든 run 을 reclaim 하지만, 완료 판정이 진행 중 pane 을 보호하므로 안전하다.