okstra 0.102.1 → 0.102.3

package/docs/superpowers/plans/2026-06-10-concurrent-run-team-guard.md

@@ -1,456 +0,0 @@
-# 동시-run team 가드 구현 플랜
-
-> **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:** 같은 task-key 의 implementation run 이 동시에 돌 때, 후발 run 이 team 을 만들지 않고 no-team background 로 worker 를 dispatch 하게 만들어 `~/.claude/teams/` config race 를 예방한다.
-
-**Architecture:** `prepare_task_bundle` 의 stage 선택 단계가 이미 호출하는 `list_active_stage_numbers` 로 동시-run 을 감지한다 → `StageSelection.concurrent_stages` 에 담아 → `ctx["CONCURRENT_RUN_STAGES"]` 로 wire → render 가 "Team Creation Gate" 대신 "no-team background" 블록을 emit + `PrepareOutputs.extras["concurrent_run"]` 로 진입점에 노출. 새 lock·새 추적 없음, enforce 지점은 Python 렌더.
-
-**Tech Stack:** Python 3 (`scripts/okstra_ctl/`), pytest, Markdown 프롬프트/스킬, `npm run build`(소스→`runtime/` 동기화).
-
-**설계 출처:** [docs/superpowers/specs/2026-06-10-concurrent-run-team-guard-design.md](../specs/2026-06-10-concurrent-run-team-guard-design.md)
-
-**전역 규칙:**
-- `runtime/` 는 build output — 직접 편집 금지. 소스(`scripts/`, `prompts/`, `agents/`, `skills/`)만 고치고 Task 7 에서 `npm run build`.
-- 커밋 trailer 금지(`Co-Authored-By` / `Generated with` 등). Conventional Commits header `type(scope): …`.
-- 각 Task 는 소스 + 테스트를 같은 커밋에 담는다.
-
----
-
-## File Structure
-
-| 파일 | 책임 | Task |
-|---|---|---|
-| [scripts/okstra_ctl/render.py](../../../scripts/okstra_ctl/render.py) | `inject_lead_prompt_computed_tokens` 에 no-team 블록 분기 추가 | 1 |
-| [scripts/okstra_ctl/run.py](../../../scripts/okstra_ctl/run.py) | `StageSelection.concurrent_stages` 필드 + 감지·wire + `extras` 전파 | 2, 3 |
-| [agents/SKILL.md](../../../agents/SKILL.md), [prompts/profiles/_common-contract.md](../../../prompts/profiles/_common-contract.md) | no-team fallback 의 새 legal 사유(`status:"skipped"`, `reason:"concurrent-run"`) | 4 |
-| [skills/okstra-run/SKILL.md](../../../skills/okstra-run/SKILL.md) | 대화형 3-옵션 picker | 5 |
-| [tests/test_render_inject_computed_tokens.py](../../../tests/test_render_inject_computed_tokens.py), [tests/test_okstra_run_select_and_apply_implementation_stage.py](../../../tests/test_okstra_run_select_and_apply_implementation_stage.py) | 단위 테스트 | 1, 2 |
-| `tests-e2e/scenario-<id>-concurrent-run-no-team.sh` | e2e (extras 전파 + no-team 블록) | 6 |
-
----
-
-## Task 1: render — 동시-run no-team 블록 분기
-
-**Files:**
-- Modify: `scripts/okstra_ctl/render.py:1645-1664` (`inject_lead_prompt_computed_tokens` 내 team-gate 분기)
-- Test: `tests/test_render_inject_computed_tokens.py`
-
-이 Task 가 ctx 키 계약(`CONCURRENT_RUN_STAGES`)을 먼저 정의한다. Task 2 가 이 키를 채운다.
-
-- [ ] **Step 1: 실패 테스트 작성** — `tests/test_render_inject_computed_tokens.py` 끝에 추가
-
-```python
-def test_inject_concurrent_run_emits_no_team_block():
-    """동시-run 감지 시 Team Creation Gate 대신 no-team background 블록을 emit."""
-    ctx = _base_ctx()
-    ctx["TASK_TYPE"] = "implementation"
-    ctx["EFFECTIVE_STAGES"] = "4"
-    ctx["CONCURRENT_RUN_STAGES"] = "5"
-    inject_lead_prompt_computed_tokens(ctx)
-    gate = ctx["TEAM_CREATION_GATE"]
-    assert "Concurrent-run: no-team background" in gate
-    # 실제 team 생성 호출 형태는 없어야 한다
-    assert 'TeamCreate(team_name:' not in gate
-    assert 'reason: "concurrent-run"' in gate
-    assert "run_in_background" in gate
-
-
-def test_inject_no_concurrent_keeps_team_gate():
-    """CONCURRENT_RUN_STAGES 가 없으면 기존 Team Creation Gate 그대로(회귀 방지)."""
-    ctx = _base_ctx()
-    ctx["TASK_TYPE"] = "implementation"
-    ctx["EFFECTIVE_STAGES"] = "4"
-    inject_lead_prompt_computed_tokens(ctx)
-    assert "Team Creation Gate (BLOCKING)" in ctx["TEAM_CREATION_GATE"]
-    assert 'TeamCreate(team_name: "okstra-demo/task-a-s4"' in ctx["TEAM_CREATION_GATE"]
-```
-
-- [ ] **Step 2: 실패 확인**
-
-Run: `python3 -m pytest tests/test_render_inject_computed_tokens.py::test_inject_concurrent_run_emits_no_team_block -v`
-Expected: FAIL — `"Concurrent-run: no-team background"` 가 gate 에 없음(현재는 Team Creation Gate 가 나옴).
-
-- [ ] **Step 3: 분기 추가** — `render.py` 의 `task_type = ctx.get("TASK_TYPE", "")` 줄(현 1645) 바로 아래에 `concurrent_stages` 를 읽고, `if task_type == "release-handoff" or not selected:` 와 `else:` 사이에 `elif` 를 끼운다. 최종 형태:
-
-```python
-    task_type = ctx.get("TASK_TYPE", "")
-    concurrent_stages = str(ctx.get("CONCURRENT_RUN_STAGES", "") or "").strip()
-    if task_type == "release-handoff" or not selected:
-        team_creation_gate_block = (
-            "## Single-Lead Phase (no team creation)\n"
-            "\n"
-            "This run is single-lead. There is no worker roster, no\n"
-            "`TeamCreate` call, no `Agent(...)` worker dispatch, and no\n"
-            "convergence loop. The Claude lead performs every step inline\n"
-            "(reading inputs, drafting commit / PR text when applicable,\n"
-            "asking the user, running git / gh, and writing the final\n"
-            "report). Do NOT call `TeamCreate` or dispatch any sub-agent\n"
-            "from this run — that would be a contract violation."
-        )
-    elif task_type == "implementation" and concurrent_stages:
-        team_creation_gate_block = (
-            "## Concurrent-run: no-team background (BLOCKING)\n"
-            "\n"
-            "A concurrent implementation run of the same task-key holds stage(s)\n"
-            f"`{concurrent_stages}` right now. Creating a team would race the shared\n"
-            "`~/.claude/teams/` config and can make another stage's `config.json`\n"
-            "unreadable. This run therefore does NOT create a team.\n"
-            "\n"
-            "Required actions, in order:\n"
-            "\n"
-            "1. Do NOT call `TeamCreate`, and do NOT dispatch any worker with\n"
-            "   `Agent(... team_name: ...)`.\n"
-            "2. Before any dispatch, record in team-state:\n"
-            '   `teamCreate: { attempted: false, status: "skipped",'
-            f' reason: "concurrent-run", concurrentStages: [{concurrent_stages}] }}`.\n'
-            "3. Dispatch every worker with `run_in_background: true` and NO\n"
-            "   `team_name` (the Phase 5 fallback). Worker completion is detected by\n"
-            "   result-file polling, so analysis output is equivalent — only the\n"
-            "   Teams split-pane view is lost."
-        )
-    else:
-        team_name = f'okstra-{ctx.get("TASK_KEY", "")}'
-        stage = str(ctx.get("EFFECTIVE_STAGES", "") or "").strip()
-        if task_type == "implementation" and stage:
-            # stage 격리 run 은 stage 별 team — 같은 task 의 다른 stage 가 남긴
-            # team 과 이름이 충돌하지 않는다(worktree branch `-s<N>` 접미사와 동형).
-            team_name = f"{team_name}-s{stage}"
-        team_creation_gate_block = (
-            # ... 기존 "## Team Creation Gate (BLOCKING)" 블록 그대로 유지 ...
-        )
-```
-
-> 주의: `else:` 안의 기존 Team Creation Gate 블록 본문(현 1665-1703)은 **그대로 둔다**. `elif` 만 끼우는 변경이다.
-
-- [ ] **Step 4: 통과 확인**
-
-Run: `python3 -m pytest tests/test_render_inject_computed_tokens.py -v`
-Expected: PASS (신규 2개 + 기존 전부).
-
-- [ ] **Step 5: 커밋**
-
-```bash
-git add scripts/okstra_ctl/render.py tests/test_render_inject_computed_tokens.py
-git commit -m "feat(okstra-ctl): 동시-run 시 no-team background 게이트 블록 렌더"
-```
-
----
-
-## Task 2: run — 동시-run 감지 + ctx wire
-
-**Files:**
-- Modify: `scripts/okstra_ctl/run.py:1297-1313` (`StageSelection` 필드 추가)
-- Modify: `scripts/okstra_ctl/run.py:1340-1412` (`_select_and_provision_implementation_stage` 채우기)
-- Modify: `scripts/okstra_ctl/run.py:1426-1429` (`_apply_implementation_stage` ctx wire)
-- Test: `tests/test_okstra_run_select_and_apply_implementation_stage.py`
-
-- [ ] **Step 1: 실패 테스트 작성** — 파일 끝에 추가. registry 에 다른 stage 를 active 로 미리 예약해 동시-run 을 시뮬레이션한다.
-
-```python
-def test_select_flags_concurrent_active_stage(tmp_path, monkeypatch):
-    """다른 run 이 stage 6 을 active 로 점유 중이면, stage 4 선택 결과의
-    concurrent_stages 에 6 이 담긴다."""
-    sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "scripts"))
-    from okstra_ctl import worktree_registry as reg
-    from okstra_ctl.run import _select_and_provision_implementation_stage
-
-    repo = tmp_path / "repo"
-    head = _init_repo(repo)
-
-    # 다른 동시 run 이 stage 6 을 active 로 점유 중이라고 가정
-    reg.reserve(
-        project_id="proj", task_group="grp", task_id="tid",
-        worktree_path=str(tmp_path / "s6"), branch="feature-tid-s6",
-        base_ref=head, stage_number=6,
-    )
-
-    plan = _consumers_dir(tmp_path)
-    inp = _Inp(project_root=str(repo), approved_plan_path=str(plan), stage="auto")
-    stages = [_stage(4, []), _stage(6, [])]
-
-    sel = _select_and_provision_implementation_stage(
-        inp, stages, "grp", "tid", "proj:grp:tid", "ok",
-    )
-    assert sel.stage == 4
-    assert sel.concurrent_stages == [6]
-
-
-def test_select_no_concurrent_when_alone(tmp_path):
-    """동시 run 이 없으면 concurrent_stages 는 빈 리스트."""
-    sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "scripts"))
-    from okstra_ctl.run import _select_and_provision_implementation_stage
-
-    repo = tmp_path / "repo"
-    head = _init_repo(repo)
-    plan = _consumers_dir(tmp_path)
-    inp = _Inp(project_root=str(repo), approved_plan_path=str(plan), stage="auto")
-    stages = [_stage(4, [])]
-
-    sel = _select_and_provision_implementation_stage(
-        inp, stages, "grp", "tid", "proj:grp:tid", "ok",
-    )
-    assert sel.stage == 4
-    assert sel.concurrent_stages == []
-```
-
-> `conftest.py` 가 `OKSTRA_HOME` 를 격리하므로 registry 는 테스트 임시 경로에 쓰인다. `_init_repo` / `_stage` / `_Inp` / `_consumers_dir` 는 파일 상단의 기존 헬퍼다.
-
-- [ ] **Step 2: 실패 확인**
-
-Run: `python3 -m pytest tests/test_okstra_run_select_and_apply_implementation_stage.py::test_select_flags_concurrent_active_stage -v`
-Expected: FAIL — `AttributeError: 'StageSelection' object has no attribute 'concurrent_stages'`.
-
-- [ ] **Step 3a: `StageSelection` 필드 추가** — `run.py:1306-1312` 의 dataclass 끝(`started_head_commit: str` 다음 줄)에 추가:
-
-```python
-    started_head_commit: str
-    concurrent_stages: list = field(default_factory=list)
-```
-
-> 파일 상단에 `from dataclasses import dataclass, field` 가 이미 있는지 확인하고, `field` 가 없으면 import 에 추가한다.
-
-- [ ] **Step 3b: 감지값 계산 + 두 반환 경로에 담기** — `_select_and_provision_implementation_stage` 안, `selected = batch[0]`(현 1350) 바로 다음 줄에:
-
-```python
-    selected = batch[0]
-    concurrent_stages = sorted(reserved_stages - {selected})
-```
-
-그리고 이 함수의 **두 `return StageSelection(...)`** (degrade 경로 현 1356, 정상 경로 현 1404) 둘 다 마지막 인자로 추가:
-
-```python
-        started_head_commit=head,            # degrade 경로
-        concurrent_stages=concurrent_stages,
-```
-
-```python
-        started_head_commit=prov.base_ref,   # 정상 경로
-        concurrent_stages=concurrent_stages,
-```
-
-- [ ] **Step 3c: ctx wire** — `_apply_implementation_stage` 안, `ctx["EFFECTIVE_STAGES"] = csv`(현 1429) 다음 줄에:
-
-```python
-    ctx["CONCURRENT_RUN_STAGES"] = ",".join(str(s) for s in sel.concurrent_stages)
-```
-
-- [ ] **Step 4: 통과 확인**
-
-Run: `python3 -m pytest tests/test_okstra_run_select_and_apply_implementation_stage.py -v`
-Expected: PASS (신규 2개 + 기존 전부).
-
-- [ ] **Step 5: 커밋**
-
-```bash
-git add scripts/okstra_ctl/run.py tests/test_okstra_run_select_and_apply_implementation_stage.py
-git commit -m "feat(okstra-ctl): 동시 active stage 를 StageSelection.concurrent_stages 로 감지·wire"
-```
-
----
-
-## Task 3: run — `extras.concurrent_run` 전파
-
-**Files:**
-- Modify: `scripts/okstra_ctl/run.py:2005-2009` (`prepare_task_bundle` 의 `return PrepareOutputs(...)`)
-
-진입점(스킬 / okstra.sh)이 동시-run 여부를 읽을 수 있도록 `extras` 에 싣는다. 전체 사이클 검증은 Task 6 e2e 가 담당한다.
-
-- [ ] **Step 1: `return PrepareOutputs(...)` 수정** — 현재:
-
-```python
-    return PrepareOutputs(
-        ctx=ctx,
-        prompt_text=prompt_text,
-        extras={"profile_content": profile_content},
-    )
-```
-
-를 다음으로:
-
-```python
-    concurrent_run: dict = {}
-    if impl_stage_selection is not None and impl_stage_selection.concurrent_stages:
-        concurrent_run = {
-            "detected": True,
-            "active_stages": impl_stage_selection.concurrent_stages,
-        }
-    return PrepareOutputs(
-        ctx=ctx,
-        prompt_text=prompt_text,
-        extras={
-            "profile_content": profile_content,
-            "concurrent_run": concurrent_run,
-        },
-    )
-```
-
-> `impl_stage_selection` 은 현 1825/1831 에서 정의돼 이 지점까지 유효하다(implementation 외 task-type 은 `None`).
-
-- [ ] **Step 2: import 회귀 확인** (단위 테스트 없음 — 코드 단순, Task 6 e2e 가 실측)
-
-Run: `python3 -c "import sys; sys.path.insert(0,'scripts'); from okstra_ctl.run import prepare_task_bundle; print('ok')"`
-Expected: `ok`
-
-- [ ] **Step 3: 커밋**
-
-```bash
-git add scripts/okstra_ctl/run.py
-git commit -m "feat(okstra-ctl): PrepareOutputs.extras 로 concurrent_run 노출"
-```
-
----
-
-## Task 4: 프롬프트/agent 계약 — no-team 의 새 legal 사유
-
-**Files:**
-- Modify: `agents/SKILL.md:231`
-- Modify: `prompts/profiles/_common-contract.md:53`
-
-현재 no-`team_name` fallback 은 `teamCreate.status == "error"` 일 때만 legal 이다. 동시-run 사전 skip 을 legal 로 추가한다.
-
-- [ ] **Step 1: `agents/SKILL.md:231` 수정** — 현재 문장:
-
-> The no-`team_name` fallback (Phase 5) is only legal when team-state's `teamCreate.status` is `"error"` for this run.
-
-를 다음으로:
-
-> The no-`team_name` fallback (Phase 5) is legal when team-state's `teamCreate.status` is `"error"` (TeamCreate attempted and failed) OR `"skipped"` with `reason: "concurrent-run"` (the launch prompt's "Concurrent-run: no-team background" gate pre-decided no team to avoid racing a concurrent same-task run's `~/.claude/teams/` config). In both cases `teamCreate` is recorded in team-state before any dispatch.
-
-- [ ] **Step 2: `_common-contract.md:53` 수정** — 현재 문장:
-
-> This step applies only when team-state's `teamCreate.status == "ok"` (Teams mode was actually used). In the no-`team_name` fallback there is no team to delete, so silent-skip.
-
-를 다음으로:
-
-> This step applies only when team-state's `teamCreate.status == "ok"` (Teams mode was actually used). In the no-`team_name` fallback — whether `teamCreate.status` is `"error"` or `"skipped"` (`reason: "concurrent-run"`) — there is no team to delete, so silent-skip.
-
-- [ ] **Step 3: grep 검증**
-
-Run: `grep -n 'concurrent-run' agents/SKILL.md prompts/profiles/_common-contract.md`
-Expected: 두 파일 각각 최소 1줄 매칭.
-
-- [ ] **Step 4: 커밋**
-
-```bash
-git add agents/SKILL.md prompts/profiles/_common-contract.md
-git commit -m "docs(agents): no-team fallback 에 concurrent-run skipped legal 사유 추가"
-```
-
----
-
-## Task 5: okstra-run 스킬 — 대화형 3-옵션 picker
-
-**Files:**
-- Modify: `skills/okstra-run/SKILL.md` (conformance-waiver picker 섹션, 현 192 부근 근처에 동형 섹션 추가)
-
-- [ ] **Step 1: 섹션 추가** — conformance-waiver picker 설명 블록과 같은 패턴으로, prepare 호출 결과에서 `extras.concurrent_run.detected == true` 일 때의 분기를 추가한다. 본문:
-
-```markdown
-### 동시-run 감지 분기 (concurrent-run)
-
-`prepare_task_bundle` 결과의 `extras.concurrent_run.detected` 가 `true` 이면(같은
-task-key 의 다른 implementation run 이 `extras.concurrent_run.active_stages` 를
-점유 중), launch 프롬프트는 이미 "Concurrent-run: no-team background" 게이트로
-렌더돼 있다. dispatch 전에 사용자에게 3-옵션 recommendation picker 를 제시한다
-(run-prompt recommendation 규칙: 1–2 추천 + 직접 입력; 이 picker 는 스킬이
-author 하는 것이라 wizard `options[]` 제약과 무관):
-
-1. (추천) 이대로 no-team background 로 진행 — 이미 렌더된 bundle 을 그대로 사용한다.
-   team 을 만들지 않아 `~/.claude/teams/` race 를 회피한다(Teams split-pane 관찰성만 포기).
-2. 대기 — 지금 dispatch 를 보류한다. stage worktree·run-context 는 보존되므로,
-   점유 중인 다른 run 종료 후 같은 stage 를 resume 으로 재개하면 그때는 정상 team
-   경로다. resume 명령(`okstra-inspect` history → resume)을 사용자에게 출력한다.
-3. 직접 입력.
-```
-
-> 위치: conformance-waiver picker 설명([skills/okstra-run/SKILL.md](../../../skills/okstra-run/SKILL.md) 의 "Conformance waiver" 섹션) 바로 다음. 같은 "스킬이 author 하는 picker" 부류이므로 인접 배치한다.
-
-- [ ] **Step 2: grep 검증**
-
-Run: `grep -n 'concurrent-run\|no-team background\|동시-run' skills/okstra-run/SKILL.md`
-Expected: 최소 1줄 매칭.
-
-- [ ] **Step 3: 커밋**
-
-```bash
-git add skills/okstra-run/SKILL.md
-git commit -m "feat(skills/okstra-run): 동시-run 시 no-team/대기 3-옵션 picker 추가"
-```
-
----
-
-## Task 6: e2e 시나리오 — extras 전파 + no-team 블록
-
-**Files:**
-- Create: `tests-e2e/scenario-<다음번호>-concurrent-run-no-team.sh`
-
-기존 시나리오 번호를 확인해 다음 번호를 쓴다: `ls tests-e2e/ | grep -oE 'scenario-[0-9]+' | sort -u | tail -1`.
-
-- [ ] **Step 1: 시나리오 작성** — 기존 시나리오 골격(`mktemp -d` 로 `OKSTRA_HOME`, `trap` EXIT 정리)을 따른다. 핵심 단계:
-  1. 임시 git repo + `.okstra/project.json` 셋업, implementation plan(stage 4·6) 준비.
-  2. registry 에 stage 6 을 active 로 reserve(다른 run 점유 시뮬레이션).
-  3. `prepare_task_bundle`(또는 `okstra.sh --task-type implementation --stage auto`)로 stage 4 run 을 prepare.
-  4. 검증: 렌더된 launch 프롬프트에 `"Concurrent-run: no-team background"` 포함 + `'TeamCreate(team_name:'` **미포함**.
-  5. 검증: prepare 의 `extras.concurrent_run.detected == true`, `active_stages == [6]`.
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-OKSTRA_HOME="$(mktemp -d)"; export OKSTRA_HOME
-trap 'rm -rf "$OKSTRA_HOME"' EXIT
-# ... repo/project/plan 셋업 (기존 scenario-01 패턴 참조) ...
-# ... reg.reserve(stage_number=6) ...
-# ... prepare 호출 후 launch 프롬프트 grep "Concurrent-run: no-team background" ...
-echo "PASS: concurrent-run no-team scenario"
-```
-
-- [ ] **Step 2: 실행**
-
-Run: `bash tests-e2e/scenario-<번호>-concurrent-run-no-team.sh`
-Expected: `PASS: concurrent-run no-team scenario`
-
-- [ ] **Step 3: 커밋**
-
-```bash
-git add tests-e2e/scenario-<번호>-concurrent-run-no-team.sh
-git commit -m "test(e2e): 동시-run no-team background 시나리오 추가"
-```
-
----
-
-## Task 7: build + 전체 회귀
-
-**Files:**
-- Modify: `runtime/**` (build output — 직접 편집 아님, `npm run build` 산출)
-
-- [ ] **Step 1: build**
-
-Run: `npm run build`
-Expected: 에러 없이 `scripts/`·`prompts/`·`agents/`·`skills/` 가 `runtime/` 로 동기화.
-
-- [ ] **Step 2: 전체 단위 테스트**
-
-Run: `python3 -m pytest tests/ -q`
-Expected: 전부 PASS (신규 포함, 회귀 없음).
-
-- [ ] **Step 3: phase contract validator**
-
-Run: `bash validators/validate-workflow.sh`
-Expected: PASS.
-
-- [ ] **Step 4: 커밋**
-
-```bash
-git add runtime/
-git commit -m "chore(build): 동시-run team 가드 runtime 동기화"
-```
-
----
-
-## Self-Review (작성자 체크 완료)
-
-- **Spec 커버리지:** §4.1 감지→Task 2, §4.2 no-team 렌더→Task 1, §4.3 대화형 picker→Task 5, §4.4 비대화형 기본값→Task 1+3(렌더가 자동 no-team, 진입점 분기 없음), §4.5 단일 수렴점→Task 3(`prepare_task_bundle` 한 곳), §4.6 legal 사유→Task 4, §7 테스트→Task 1·2·6. 누락 없음.
-- **비대화형(§4.4)** 은 별도 코드가 아니라 "picker 를 안 띄우면 렌더된 no-team bundle 그대로 진행"으로 자동 충족됨 — 추가 Task 불필요.
-- **타입 일관성:** `concurrent_stages` 는 `list[int]`(Task 2) → ctx 에서 csv `str`(Task 2 wire) → render 가 `str` 으로 읽음(Task 1) → `extras.active_stages` 는 `list[int]`(Task 3). 경계마다 형 변환 명시.
-- **Placeholder:** 없음(시나리오 번호만 실행 시 확정 — Task 6 Step 0 에 조회 명령 제공).