okstra 0.102.2 → 0.102.4

package/docs/superpowers/plans/2026-06-23-implementation-stage-multiselect-chain.md

@@ -1,630 +0,0 @@
-# implementation stage 다중선택 + 무인 연쇄 구현 계획
-
-> **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:** okstra-run 의 implementation stage picker 에 진행 상태를 표시하고, 여러 stage 를 체크박스로 골라 현재 세션이 의존성 순서대로 무인 연쇄 실행하게 한다.
-
-**Architecture:** wizard picker(입력 수집)와 SKILL.md(오케스트레이션)만 확장한다. stage 상태·ready·의존성 판정은 prepare 측 SSOT(`stage_targets.py`/`consumers.py`/`worktree_registry.py`)를 재사용하고, "1 run = 1 stage" 격리(worktree·registry 예약·base commit)는 불변으로 둔다. 연쇄는 단일-stage run 을 N 회 순차 실행하는 것이다.
-
-**Tech Stack:** Python 3 (`scripts/okstra_ctl/`), pytest(`tests/`), Markdown 스킬(`skills/okstra-run/SKILL.md`), JSON 프롬프트(`prompts/wizard/prompts.ko.json`), 빌드(`tools/build.mjs` → `npm run build`).
-
-## Global Constraints
-
-- `runtime/` 은 빌드 산출물 — 직접 편집 금지. 소스 변경 후 `npm run build` 로 동기화.
-- "1 run = 1 stage" 격리(stage worktree·registry stage-key 예약·base commit 계산)는 변경 금지.
-- 비대화형 CLI `--stage <auto|N>` 단일-stage 의미 보존. 다중선택은 대화형 wizard picker 에만 추가.
-- stage 상태/의존성 판정은 prepare SSOT 재사용 — wizard 가 자체 재구현 금지.
-- pre-1.0: 호환 shim 없이 단일선택 동작을 다중선택으로 교체(단일 stage 1개 선택 = 기존 동작 동치).
-- 문서/주석 산문은 한국어, 코드 식별자·경로·CLI 인자는 영어.
-- 커밋: Conventional Commits(`type(scope): 한 문장`), AI attribution trailer 금지. 동시 세션 환경이므로 amend 금지 — 항상 새 커밋.
-- 완료 판정 CI: `npm run check`(exit 0).
-
----
-
-## Task 1: stage 상태 집합 헬퍼 (started / reserved)
-
-기능 A·B 가 공유할, "현재 started / reserved 인 stage 번호 집합" 읽기 헬퍼를 추가한다. done 은 기존 [`_done_stage_numbers`](../../scripts/okstra_ctl/wizard.py:961)가 이미 제공한다.
-
-**Files:**
-- Modify: `scripts/okstra_ctl/wizard.py` (`_done_stage_numbers` 바로 아래, [wizard.py:976](../../scripts/okstra_ctl/wizard.py:976) 부근)
-- Test: `tests/wizard/test_wizard_stage_pick.py`
-
-**Interfaces:**
-- Consumes: `read_consumers(plan_run_root)` ([consumers.py:24](../../scripts/okstra_ctl/consumers.py:24)), `worktree_registry.list_active_stage_numbers(project_id, task_group, task_id)` ([worktree_registry.py:278](../../scripts/okstra_ctl/worktree_registry.py:278)).
-- Produces: `_started_stage_numbers(state: WizardState) -> set[int]`, `_reserved_stage_numbers(state: WizardState) -> set[int]`. Task 2·4 가 호출한다.
-
-- [ ] **Step 1: Write the failing test**
-
-`tests/wizard/test_wizard_stage_pick.py` 에 추가. 기존 테스트의 state/plan 픽스처 헬퍼를 재사용한다(파일 상단의 기존 헬퍼 확인). consumers.jsonl 에 started 행을 쓰고, started 집합에 잡히는지 본다.
-
-```python
-def test_started_stage_numbers_reads_started_rows(tmp_path, monkeypatch):
-    state = _impl_state_with_plan(tmp_path)  # 기존 헬퍼 패턴 재사용
-    run_root = Path(state.approved_plan_path).resolve().parents[1]
-    from okstra_ctl.consumers import append_consumer
-    append_consumer(run_root, impl_task_key="k#stage-2", stage=2, status="started")
-    from okstra_ctl.wizard import _started_stage_numbers
-    assert _started_stage_numbers(state) == {2}
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py::test_started_stage_numbers_reads_started_rows -v`
-Expected: FAIL — `ImportError: cannot import name '_started_stage_numbers'`
-
-- [ ] **Step 3: Write minimal implementation**
-
-`scripts/okstra_ctl/wizard.py`, `_done_stage_numbers` 아래에 추가. `_done_stage_numbers` 의 순수-읽기 규약(carry backfill 금지)을 동일하게 따른다.
-
-```python
-def _started_stage_numbers(state: WizardState) -> set:
-    """approved plan 을 소비한 run 들의 consumers.jsonl 에서 status:started 인
-    stage 번호 집합. _done_stage_numbers 와 같은 순수 읽기 — carry backfill 금지."""
-    if not state.approved_plan_path:
-        return set()
-    from .consumers import read_consumers
-    plan_run_root = Path(state.approved_plan_path).resolve().parents[1]
-    rows = read_consumers(plan_run_root)
-    return {r["stage"] for r in rows
-            if r.get("status") == "started" and isinstance(r.get("stage"), int)}
-
-
-def _reserved_stage_numbers(state: WizardState) -> set:
-    """worktree-registry 가 active 로 잡고 있는 stage 번호 집합(점유 SSOT).
-    implementation prepare 와 동일 인자로 list_active_stage_numbers 를 호출한다."""
-    if not (state.project_id and state.task_group and state.task_id):
-        return set()
-    from .worktree_registry import list_active_stage_numbers
-    return list_active_stage_numbers(
-        state.project_id, state.task_group, state.task_id)
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py::test_started_stage_numbers_reads_started_rows -v`
-Expected: PASS
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add scripts/okstra_ctl/wizard.py tests/wizard/test_wizard_stage_pick.py
-git commit -m "feat(wizard): add started/reserved stage-number helpers for stage picker"
-```
-
----
-
-## Task 2: 기능 A — implementation picker 진행 상태 마커
-
-implementation picker 의 각 stage 옵션 뒤에 `[완료]/[진행중]/[준비됨]/[대기]` 마커를 붙인다. final-verification 의 `[done]/[미완]` 은 변경하지 않는다.
-
-**Files:**
-- Modify: `prompts/wizard/prompts.ko.json` ([prompts.ko.json:240](../../prompts/wizard/prompts.ko.json:240) `stage_pick.options`)
-- Modify: `scripts/okstra_ctl/wizard.py` (`_build_stage_pick` [wizard.py:1812](../../scripts/okstra_ctl/wizard.py:1812))
-- Test: `tests/wizard/test_wizard_stage_pick.py`
-
-**Interfaces:**
-- Consumes: `_done_stage_numbers` ([wizard.py:961](../../scripts/okstra_ctl/wizard.py:961)), `_started_stage_numbers`/`_reserved_stage_numbers` (Task 1), ready 판정식(`all(d in done for d in s.depends_on)`, [stage_targets.py:83](../../scripts/okstra_ctl/stage_targets.py:83)).
-- Produces: implementation 분기에서 마커가 붙은 옵션 라벨. Task 4 의 multi picker 가 같은 build 를 확장한다.
-
-- [ ] **Step 1: Write the failing test**
-
-```python
-def test_impl_stage_pick_shows_status_markers(tmp_path):
-    # stage 1 done, stage 2 ready(deps=[1] 충족), stage 3 대기(deps=[2] 미충족)
-    state = _impl_state_with_plan(tmp_path, stages=[(1, []), (2, [1]), (3, [2])])
-    run_root = Path(state.approved_plan_path).resolve().parents[1]
-    from okstra_ctl.consumers import append_consumer
-    append_consumer(run_root, impl_task_key="k#stage-1", stage=1, status="done",
-                    head_commit="abc")
-    from okstra_ctl.wizard import _build_stage_pick
-    labels = {o.value: o.label for o in _build_stage_pick(state).options}
-    assert "[완료]" in labels["1"]
-    assert "[준비됨]" in labels["2"]
-    assert "[대기]" in labels["3"]
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py::test_impl_stage_pick_shows_status_markers -v`
-Expected: FAIL — 라벨에 마커 없음(AssertionError)
-
-- [ ] **Step 3: Add marker strings to prompts.ko.json**
-
-`prompts/wizard/prompts.ko.json` 의 `stage_pick.options` 에 4종 추가(기존 `done_mark`/`undone_mark` 유지):
-
-```json
-      "options": {
-        "auto": "auto (다음 미완료 stage)",
-        "whole_task": "전체 task 검증 (모든 stage)",
-        "all_stages": "전체 (남은 미완료 stage 모두)",
-        "done_mark": "[done]",
-        "undone_mark": "[미완]",
-        "mark_done": "[완료]",
-        "mark_active": "[진행중]",
-        "mark_ready": "[준비됨]",
-        "mark_blocked": "[대기]"
-      }
-```
-
-- [ ] **Step 4: Implement markers in `_build_stage_pick`**
-
-`scripts/okstra_ctl/wizard.py` 의 `_build_stage_pick` 에서, implementation 일 때 상태 집합을 구해 suffix 를 결정한다. 기존 `is_fv` 분기는 그대로 둔다.
-
-```python
-def _build_stage_pick(state: WizardState) -> Prompt:
-    """Parse the Stage Map from the approved plan and build the stage picker."""
-    t = _p(state.workspace_root, "stage_pick")
-    stages = _parse_stage_objects(state)
-    is_fv = state.task_type == "final-verification"
-    is_impl = state.task_type == "implementation"
-    label = (t["label_final_verification"] or t["label"]) if is_fv else t["label"]
-    done = _done_stage_numbers(state)
-    started = _started_stage_numbers(state) if is_impl else set()
-    reserved = _reserved_stage_numbers(state) if is_impl else set()
-    options = []
-    if _whole_task_allowed(state, stages=stages, done=done):
-        options.append(_opt(WHOLE_TASK_STAGE, t["options"]["whole_task"]))
-    if is_impl:
-        options.append(_opt(ALL_STAGES, t["options"]["all_stages"]))
-    for s in stages:
-        depends = ",".join(map(str, s.depends_on)) or "(none)"
-        suffix = ""
-        if is_fv:
-            suffix = "  " + (t["options"]["done_mark"]
-                             if s.stage_number in done
-                             else t["options"]["undone_mark"])
-        elif is_impl:
-            suffix = "  " + _impl_stage_marker(t, s, done, started, reserved)
-        options.append(_opt(
-            str(s.stage_number),
-            f"{s.stage_number}: {s.title}  "
-            f"[depends-on: {depends} | steps: {s.step_count}]{suffix}",
-        ))
-    return Prompt(
-        step=S_STAGE_PICK, kind="pick", multi=is_impl,
-        label=label,
-        options=options,
-        echo_template=t["echo_template"],
-    )
-
-
-def _impl_stage_marker(t, stage, done, started, reserved) -> str:
-    n = stage.stage_number
-    if n in done:
-        return t["options"]["mark_done"]
-    if n in started or n in reserved:
-        return t["options"]["mark_active"]
-    if all(d in done for d in stage.depends_on):
-        return t["options"]["mark_ready"]
-    return t["options"]["mark_blocked"]
-```
-
-참고: `_stage_auto_allowed` 기반 auto 옵션 추가([wizard.py:1820-1821](../../scripts/okstra_ctl/wizard.py:1820))는 이 교체로 제거된다(Task 4 의 "auto 제거" 결정과 일치). `multi=is_impl` 도 여기서 함께 켜진다(Task 4 가 submit 으로 완성). `ALL_STAGES` 상수는 Task 4 Step 3 에서 정의하므로, 이 task 만 단독 실행 시 `ALL_STAGES` 정의를 [wizard.py:1636](../../scripts/okstra_ctl/wizard.py:1636) `WHOLE_TASK_STAGE` 옆에 먼저 추가한다: `ALL_STAGES = "__all_stages__"`.
-
-- [ ] **Step 5: Update the auto-asserting test, then run**
-
-기존 `test_stage_pick_option_list_includes_auto_and_all_stages`([tests/wizard/test_wizard_stage_pick.py:53](../../tests/wizard/test_wizard_stage_pick.py:53))는 implementation picker 에 `auto` 가 있다고 단언한다(이름과 달리 실제로는 auto+stage 번호만 검증). 이 task 가 auto 를 제거하므로 갱신한다: `assert "auto" not in values`, `assert wizard.ALL_STAGES in values`, `assert {"1","2","3"} <= set(values)` (테스트명도 `..._excludes_auto_includes_all` 로). final-verification 테스트([:72](../../tests/wizard/test_wizard_stage_pick.py:72))는 불변.
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py -v`
-Expected: 마커 테스트 + 갱신한 옵션 테스트 PASS. submit 계열 테스트(`stores_auto`/`stores_numeric_stage`/`rejects_empty`/corrupt-envelope)는 이 시점에 깨질 수 있고 Task 4 에서 갱신된다(같은 PR 연속 task) — 그대로 두고 진행.
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add scripts/okstra_ctl/wizard.py prompts/wizard/prompts.ko.json tests/wizard/test_wizard_stage_pick.py
-git commit -m "feat(wizard): show stage progress markers in implementation picker"
-```
-
----
-
-## Task 3: 의존성 closure + 위상정렬 헬퍼 (stage_targets.py)
-
-선택한 stage 집합에 미완료 의존성을 자동 포함하고 의존성 순서로 정렬하는 순수 함수를 SSOT 모듈에 추가한다.
-
-**Files:**
-- Modify: `scripts/okstra_ctl/stage_targets.py` (모듈 함수, [stage_targets.py:97](../../scripts/okstra_ctl/stage_targets.py:97) 아래)
-- Test: `tests/run/test_stage_targets_closure.py` (없으면 생성; 기존 `tests/run/` 도메인 사용)
-
-**Interfaces:**
-- Produces: `order_stage_closure(stages, selected, done) -> list[int]` — `stages` 는 `(stage_number:int, depends_on:list[int])` 시퀀스, `selected`/`done` 은 `set[int]`. 반환: selected ∪ (미완료 의존성 closure) 를 위상순서(번호 오름차순 안정)로 정렬한 리스트. Task 4 가 wizard 에서 호출한다.
-
-- [ ] **Step 1: Write the failing test**
-
-```python
-def test_order_stage_closure_pulls_unmet_deps_in_order():
-    from okstra_ctl.stage_targets import order_stage_closure
-    stages = [(1, []), (2, [1]), (3, [2]), (4, [2])]
-    # 4 를 골랐고 2 는 미완료, 1 은 done → closure 는 {2,4}, 위상순서 [2,4]
-    assert order_stage_closure(stages, selected={4}, done={1}) == [2, 4]
-
-
-def test_order_stage_closure_drops_done_deps():
-    from okstra_ctl.stage_targets import order_stage_closure
-    stages = [(1, []), (2, [1])]
-    # 2 선택, 1 done → 1 은 closure 에 안 들어감
-    assert order_stage_closure(stages, selected={2}, done={1}) == [2]
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `python3 -m pytest tests/run/test_stage_targets_closure.py -v`
-Expected: FAIL — `ImportError: cannot import name 'order_stage_closure'`
-
-- [ ] **Step 3: Write minimal implementation**
-
-`scripts/okstra_ctl/stage_targets.py` 의 `resolve_effective_stages` 아래에 추가. Stage Map 번호가 1..N 단조임이 validator 에서 이미 보장되므로 순환은 없다 — 단순 closure + 번호 정렬로 위상순서를 만든다(작은 번호가 큰 번호에만 의존).
-
-```python
-def order_stage_closure(
-    stages, selected: set[int], done: set[int],
-) -> list[int]:
-    """selected ∪ (미완료 depends-on closure) 를 의존성 순서로 정렬해 반환.
-
-    Stage Map 번호는 validator 가 1..N 단조로 강제하므로 순환이 없다.
-    번호 오름차순이 곧 위상순서다(낮은 번호가 선행)."""
-    deps = {n: list(d) for n, d in stages}
-    want = set(selected)
-    frontier = list(selected)
-    while frontier:
-        n = frontier.pop()
-        for d in deps.get(n, []):
-            if d not in done and d not in want:
-                want.add(d)
-                frontier.append(d)
-    return sorted(want)
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-Run: `python3 -m pytest tests/run/test_stage_targets_closure.py -v`
-Expected: PASS
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add scripts/okstra_ctl/stage_targets.py tests/run/test_stage_targets_closure.py
-git commit -m "feat(stage-targets): add dependency-closure topological ordering helper"
-```
-
----
-
-## Task 4: 기능 B — picker 다중선택 + submit 정규화
-
-implementation picker 를 체크박스로 만들고, submit 에서 점유 stage 거부 → closure → 위상정렬 → `selected_stages` 저장.
-
-**Files:**
-- Modify: `scripts/okstra_ctl/wizard.py` — `WizardState` ([wizard.py:367](../../scripts/okstra_ctl/wizard.py:367)), `WHOLE_TASK_STAGE` 옆 상수([wizard.py:1636](../../scripts/okstra_ctl/wizard.py:1636)), `_submit_stage_pick` ([wizard.py:1845](../../scripts/okstra_ctl/wizard.py:1845)), Step `owns` ([wizard.py:2936](../../scripts/okstra_ctl/wizard.py:2936))
-- Modify: `prompts/wizard/prompts.ko.json` — `stage_pick` 에 errors/echo 추가
-- Test: `tests/wizard/test_wizard_stage_pick.py`
-
-**Interfaces:**
-- Consumes: `order_stage_closure` (Task 3), `_done/_started/_reserved_stage_numbers` (Task 1·2), `_parse_stage_objects` ([wizard.py:937](../../scripts/okstra_ctl/wizard.py:937)).
-- Produces: `state.selected_stages: str` (위상정렬 CSV). Task 5 의 render-args 가 읽는다.
-
-- [ ] **Step 1: Write the failing tests**
-
-```python
-def test_submit_stage_pick_multi_closure_orders(tmp_path):
-    state = _impl_state_with_plan(tmp_path, stages=[(1, []), (2, [1]), (3, [2])])
-    from okstra_ctl.wizard import _submit_stage_pick
-    _submit_stage_pick(state, "3")  # 3 선택, 1·2 미완료 → closure [1,2,3]
-    assert state.selected_stages == "1,2,3"
-
-
-def test_submit_stage_pick_rejects_occupied(tmp_path):
-    state = _impl_state_with_plan(tmp_path, stages=[(1, []), (2, [1])])
-    run_root = Path(state.approved_plan_path).resolve().parents[1]
-    from okstra_ctl.consumers import append_consumer
-    append_consumer(run_root, impl_task_key="k#stage-1", stage=1, status="done",
-                    head_commit="abc")
-    from okstra_ctl.wizard import _submit_stage_pick, WizardError
-    import pytest
-    with pytest.raises(WizardError):
-        _submit_stage_pick(state, "1")  # done stage 선택 거부
-
-
-def test_submit_stage_pick_all_expands_to_unoccupied(tmp_path):
-    state = _impl_state_with_plan(tmp_path, stages=[(1, []), (2, [1])])
-    from okstra_ctl.wizard import _submit_stage_pick, ALL_STAGES
-    _submit_stage_pick(state, ALL_STAGES)
-    assert state.selected_stages == "1,2"
-```
-
-- [ ] **Step 2: Run tests to verify they fail**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py -k "multi_closure or rejects_occupied or all_expands" -v`
-Expected: FAIL — `selected_stages` 미정의 / 단일선택 submit 이라 closure 없음
-
-- [ ] **Step 3: Add state field and constant**
-
-`WizardState` 에 필드 추가([wizard.py:367](../../scripts/okstra_ctl/wizard.py:367) `selected_stage` 아래):
-
-```python
-    selected_stage: str = "auto"
-    selected_stages: str = ""   # implementation 다중선택 위상정렬 CSV
-```
-
-`WHOLE_TASK_STAGE` 옆([wizard.py:1636](../../scripts/okstra_ctl/wizard.py:1636))에(Task 2 에서 이미 추가했다면 생략):
-
-```python
-WHOLE_TASK_STAGE = "__whole_task__"
-ALL_STAGES = "__all_stages__"
-```
-
-`new_state_file` 의 직렬화 디폴트 dict([wizard.py:3189](../../scripts/okstra_ctl/wizard.py:3189) `"selected_stage": "auto"` 부근)에 `"selected_stages": ""` 를 추가한다(필드 누락 시 역직렬화 깨짐 방지 — 기존 패턴 확인).
-
-- [ ] **Step 4: Rewrite `_submit_stage_pick`**
-
-final-verification 단일선택 로직은 보존하고, implementation 분기를 다중선택으로 교체한다.
-
-```python
-def _submit_stage_pick(state: WizardState, answer: str) -> Optional[str]:
-    if state.task_type == "implementation":
-        return _submit_impl_stage_pick(state, answer)
-    # final-verification: 단일선택 유지 (whole-task 또는 단일 정수; auto 불가)
-    if not answer:
-        raise WizardError("value required")
-    if answer == WHOLE_TASK_STAGE:
-        if not _whole_task_allowed(state):
-            raise WizardError(
-                "whole-task verification requires final-verification "
-                "with all stages done")
-    else:
-        try:
-            int(answer)
-        except ValueError:
-            raise WizardError(
-                f"answer must be whole-task or a stage number, got {answer!r}")
-    state.selected_stage = answer
-    return f"stage: {answer}"
-
-
-def _submit_impl_stage_pick(state: WizardState, answer: str) -> Optional[str]:
-    t = _p(state.workspace_root, "stage_pick")
-    picks = [v.strip() for v in (answer or "").split(",") if v.strip()]
-    if not picks:
-        raise WizardError(t["errors"]["none_selected"])
-    stages = _parse_stage_objects(state)
-    all_nums = {s.stage_number for s in stages}
-    done = _done_stage_numbers(state)
-    occupied = done | _started_stage_numbers(state) | _reserved_stage_numbers(state)
-    if ALL_STAGES in picks:
-        if len(picks) > 1:
-            raise WizardError(t["errors"]["all_exclusive"])
-        chosen = {n for n in all_nums if n not in occupied}
-        if not chosen:
-            raise WizardError(t["errors"]["nothing_selectable"])
-    else:
-        try:
-            nums = {int(p) for p in picks}
-        except ValueError:
-            raise WizardError(t["errors"]["bad_number"].format(answer=answer))
-        unknown = sorted(nums - all_nums)
-        if unknown:
-            raise WizardError(t["errors"]["unknown_stage"].format(
-                bad=", ".join(map(str, unknown))))
-        bad = sorted(nums & occupied)
-        if bad:
-            raise WizardError(t["errors"]["occupied"].format(
-                bad=", ".join(map(str, bad))))
-        chosen = nums
-    ordered = order_stage_closure(
-        [(s.stage_number, s.depends_on) for s in stages], chosen, done)
-    state.selected_stages = ",".join(map(str, ordered))
-    state.selected_stage = str(ordered[0]) if ordered else "auto"
-    added = [n for n in ordered if n not in chosen]
-    if added:
-        return t["echo_variants"]["with_closure"].format(
-            stages=state.selected_stages, added=", ".join(map(str, added)))
-    return t["echo_variants"]["plain"].format(stages=state.selected_stages)
-```
-
-`prompts/wizard/prompts.ko.json` 의 `stage_pick` 에 `errors`·`echo_variants` 추가:
-
-```json
-    "stage_pick": {
-      "label": "...",
-      "label_final_verification": "...",
-      "echo_template": "stage: {value}",
-      "options": { "...": "..." },
-      "errors": {
-        "none_selected": "stage 를 하나 이상 선택하세요.",
-        "all_exclusive": "'전체' 는 단독으로만 선택할 수 있습니다.",
-        "nothing_selectable": "선택 가능한 stage 가 없습니다 (모두 완료/진행중).",
-        "bad_number": "stage 번호가 올바르지 않습니다: {answer}",
-        "unknown_stage": "Stage Map 에 없는 stage 입니다: {bad}",
-        "occupied": "이미 완료/진행중인 stage 는 선택할 수 없습니다: {bad}"
-      },
-      "echo_variants": {
-        "plain": "stages: {stages}",
-        "with_closure": "stages: {stages} (의존성 자동 포함: {added})"
-      }
-    }
-```
-
-Step `owns` 갱신([wizard.py:2936](../../scripts/okstra_ctl/wizard.py:2936)):
-
-```python
-         owns=("selected_stage", "selected_stages")),
-```
-
-- [ ] **Step 5: Update existing submit tests to multi-select semantics, then run**
-
-테스트 픽스처는 `_plan_with_approval(tmp_path)` + 직접 `WizardState(...)` 구성 패턴을 따른다(이 파일에 `_impl_state_with_plan` 헬퍼는 없다). consumers 행을 읽는 테스트는 plan 을 `tmp_path/runs/implementation/reports/final-report.md` 에 두고 `append_consumer(tmp_path/"runs"/"implementation", ...)` 로 써야 `_done/_started_stage_numbers` 의 `parents[1]` 경로와 맞는다(Task 1 테스트와 동일 구조).
-
-기존 submit 테스트 갱신:
-- `test_submit_stage_pick_stores_auto`([:89](../../tests/wizard/test_wizard_stage_pick.py:89)): implementation 은 auto 미수용 → 삭제(Task 4 신규 multi/all 테스트가 대체).
-- `test_submit_stage_pick_stores_numeric_stage`([:121](../../tests/wizard/test_wizard_stage_pick.py:121)): 이제 `state.selected_stages == "2"` 단언 + echo 가 `stages: 2`(`selected_stage == "2"` 도 유지).
-- `test_submit_stage_pick_rejects_empty`([:155](../../tests/wizard/test_wizard_stage_pick.py:155)): 메시지가 `value required` → `none_selected`("stage 를 하나 이상 선택하세요") 로 바뀌므로 단언 문자열 갱신.
-- `test_submit_stage_pick_rejects_invalid`([:137](../../tests/wizard/test_wizard_stage_pick.py:137)): `bogus` 거부 유지(통과).
-- `test_step_cli_corrupt_stage_map_returns_clean_envelope`([:214](../../tests/wizard/test_wizard_stage_pick.py:214)): `_submit_impl_stage_pick` 가 `_parse_stage_objects` 를 먼저 호출하므로 손상 Stage Map 에서 여전히 WizardError('Stage Map') → `current=None` 으로 통과해야 한다. 통과하면 그대로, 깨지면 answer `"auto"` 를 `"1"` 로 바꾼다.
-final-verification submit 테스트([:105](../../tests/wizard/test_wizard_stage_pick.py:105))는 불변.
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py -v`
-Expected: 신규 3개 + 갱신한 기존 테스트 모두 PASS.
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add scripts/okstra_ctl/wizard.py prompts/wizard/prompts.ko.json tests/wizard/test_wizard_stage_pick.py
-git commit -m "feat(wizard): make implementation stage picker multi-select with dependency closure"
-```
-
----
-
-## Task 5: render-args 에 chain-stages 출력
-
-implementation 의 render-args 가 위상정렬된 stage CSV 를 내보내, SKILL.md 연쇄 루프가 소비할 수 있게 한다.
-
-**Files:**
-- Modify: `scripts/okstra_ctl/wizard.py` — `render_args` ([wizard.py:3412](../../scripts/okstra_ctl/wizard.py:3412), [wizard.py:3440](../../scripts/okstra_ctl/wizard.py:3440))
-- Test: `tests/wizard/test_wizard_stage_pick.py` (또는 기존 render-args 테스트 파일)
-
-**Interfaces:**
-- Consumes: `state.selected_stages` (Task 4).
-- Produces: render-args dict 의 `chain-stages` 키(위상정렬 CSV). 단수 `stage` 는 `ordered[0]`(첫 stage)로 유지해 기존 render-bundle 단일-stage 경로와 호환.
-
-- [ ] **Step 1: Write the failing test**
-
-```python
-def test_render_args_emits_chain_stages(tmp_path):
-    state = _impl_state_ready_for_render(tmp_path)  # 기존 render-args 테스트 헬퍼
-    state.selected_stages = "1,2,3"
-    state.selected_stage = "1"
-    from okstra_ctl.wizard import render_args
-    args = render_args(state)
-    assert args["chain-stages"] == "1,2,3"
-    assert args["stage"] == "1"
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py::test_render_args_emits_chain_stages -v`
-Expected: FAIL — `KeyError: 'chain-stages'`
-
-- [ ] **Step 3: Implement in `render_args`**
-
-implementation 분기([wizard.py:3412-3413](../../scripts/okstra_ctl/wizard.py:3412))와 반환 dict([wizard.py:3440](../../scripts/okstra_ctl/wizard.py:3440))을 수정:
-
-```python
-    chain_stages = ""
-    if state.task_type == "implementation":
-        chain_stages = state.selected_stages or (state.selected_stage or "auto")
-        stage = state.selected_stage or "auto"
-    elif state.task_type == "final-verification":
-        ...기존 그대로...
-    else:
-        stage = ""
-```
-
-반환 dict 에 키 추가(기존 `"stage": stage`, `"stages": state.handoff_stages` 옆):
-
-```python
-        "stage": stage,
-        "stages": state.handoff_stages,
-        "chain-stages": chain_stages,
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-Run: `python3 -m pytest tests/wizard/test_wizard_stage_pick.py::test_render_args_emits_chain_stages -v`
-Expected: PASS
-
-- [ ] **Step 5: Run the full wizard suite**
-
-Run: `python3 -m pytest tests/wizard/ -v`
-Expected: PASS (회귀 없음)
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add scripts/okstra_ctl/wizard.py tests/wizard/test_wizard_stage_pick.py
-git commit -m "feat(wizard): emit chain-stages render-arg for implementation"
-```
-
----
-
-## Task 6: SKILL.md 무인 연쇄 루프 + 빌드
-
-현재 세션이 오케스트레이터가 되어, `chain-stages` 큐를 의존성 순서로 무인 실행한다. 예외 게이트에서는 멈춰 사용자에게 인계한다.
-
-**Files:**
-- Modify: `skills/okstra-run/SKILL.md` (Step 5 render-bundle 호출 [SKILL.md:146-194](../../skills/okstra-run/SKILL.md:146), Step 6 [SKILL.md:247-254](../../skills/okstra-run/SKILL.md:247), 종료 [SKILL.md:293](../../skills/okstra-run/SKILL.md:293))
-- Modify: `CHANGES.md` (사용자 영향 항목)
-- Build: `npm run build`
-
-**Interfaces:**
-- Consumes: render-args 의 `chain-stages` CSV (Task 5), Phase 6 의 `done` append([_implementation-deliverable.md:50](../../prompts/profiles/_implementation-deliverable.md:50)).
-
-- [ ] **Step 1: SKILL.md 에 연쇄 루프 절 추가**
-
-Step 6 뒤(또는 종료 규칙 [SKILL.md:293](../../skills/okstra-run/SKILL.md:293) 직전)에 새 절을 추가한다. 내용(한국어 산문):
-
-```markdown
-## Step 7: implementation 무인 연쇄 (chain-stages)
-
-`task-type == implementation` 이고 render-args 의 `chain-stages` CSV 가 원소 2개
-이상이면, 현재 세션이 오케스트레이터로서 stage 를 의존성 순서대로 무인 연쇄
-실행한다(단일 원소면 기존 단일 run 과 동일, 이 절은 건너뛴다).
-
-큐 = `chain-stages` 를 `,` 로 분해한 위상정렬 stage 리스트. 각 stage `N` 에 대해
-순서대로:
-
-1. `render-bundle` 을 Step 5 와 동일 인자로, 단 `--stage N` 으로 호출한다
-   (base commit 은 prepare 가 predecessor done commit 으로 자동 계산).
-2. Step 6 대로 Claude lead 가 되어 그 stage 의 Phase 1~7 을 인라인 실행하고,
-   Phase 6 에서 `done` 행을 append 한다(implementation 프로파일 지시).
-3. `done` 이 기록됐는지(또는 carry 사이드카로 backfill 되는지) 확인한 뒤 다음
-   stage 로 넘어간다. 매 stage 경계에서 컨텍스트를 정리한다.
-4. 각 stage 시작/완료마다 한 줄 보고: `stage N/<총개수> 시작` / `stage N done → 다음 K`.
-
-큐를 모두 소화하거나, 다음 stage 의 render-bundle 이 ready 아님으로 거부되면
-종료하고 남은 큐를 사용자에게 보고한다.
-
-### 연쇄 중 예외 게이트
-render-bundle 이 동시-run 충돌 감지(`Step 5` 의 concurrency 분기)나 git stale-SHA
-재조정(같은 곳의 reconcile 분기)을 띄우면, **그 stage 에서 연쇄를 멈추고** 게이트를
-사용자에게 그대로 제시한다. 사용자가 게이트를 해소하면 그 자리에서 연쇄를
-재개한다(남은 큐 이어서 처리). 데이터 손상·동시 점유 충돌은 사람이 확인한다 —
-이것이 무인 연쇄의 안전 경계다.
-```
-
-종료 규칙([SKILL.md:293](../../skills/okstra-run/SKILL.md:293))은 단일 run 기준이므로, 연쇄 시 "큐가 빌 때까지 Step 7 을 반복한 뒤 종료"로 읽히게 한 줄 보강한다.
-
-- [ ] **Step 2: CHANGES.md 항목 추가**
-
-`CHANGES.md` 최상단에 사용자 영향 항목(한국어):
-
-```markdown
-- implementation stage picker 가 각 stage 의 진행 상태([완료]/[진행중]/[준비됨]/[대기])를
-  표시하고, 여러 stage 를 체크박스로 골라 의존성 순서대로 무인 연쇄 실행할 수 있다.
-  '전체' 를 고르면 남은 미완료 stage 가 모두 큐에 들어간다.
-  사용자 영향: implementation 을 여러 stage 에 걸쳐 한 번의 선택으로 진행할 수 있고,
-  점유/완료된 stage 를 고르는 실수를 picker 단계에서 미리 막는다.
-```
-
-- [ ] **Step 3: Build runtime**
-
-Run: `npm run build`
-Expected: exit 0, `runtime/skills/okstra-run/SKILL.md` 등에 변경 반영.
-
-- [ ] **Step 4: Full check**
-
-Run: `npm run check`
-Expected: exit 0 (JS + Python 스위트 통과).
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add skills/okstra-run/SKILL.md CHANGES.md runtime/
-git commit -m "feat(okstra-run): chain selected implementation stages unattended in dependency order"
-```
-
----
-
-## Self-Review
-
-- **Spec coverage:** 기능 A(상태 표시) = Task 1·2. 기능 B picker multi = Task 4, closure = Task 3, render-args = Task 5, 무인 연쇄 루프 = Task 6, 예외 게이트 = Task 6 Step 1. "전체" 정의(점유 제외) = Task 4 Step 4 `chosen = {n ... not in occupied}`. auto 제거 = Task 2 Step 4 주석 + Task 4(implementation submit 이 auto 미수용). 비대화형 CLI auto 보존 = render-args 만 변경하고 `resolve_effective_stages` 불변 → 충족.
-- **Placeholder scan:** 모든 step 에 실제 코드/명령/예상 출력 존재. TBD 없음.
-- **Type consistency:** `order_stage_closure(stages, selected, done)` 시그니처가 Task 3 정의와 Task 4 호출(`order_stage_closure([(s.stage_number, s.depends_on)...], chosen, done)`)에서 일치. `selected_stages: str` 가 Task 4(저장)·Task 5(읽기)에서 일치. `_started_stage_numbers`/`_reserved_stage_numbers` 가 Task 1 정의·Task 2·4 사용에서 일치. `ALL_STAGES` 상수가 Task 2/4 에서 일치.
-- **주의:** Task 2 와 Task 4 가 `_build_stage_pick`/`_submit_stage_pick` 를 연속 수정하므로 두 task 는 같은 PR 에서 순차 실행한다. Task 2 단독 완료 시점에 일부 기존 stage_pick 테스트가 깨질 수 있으며 Task 4 에서 정리된다.