okstra 0.191.2 → 0.193.0

package/runtime/python/okstra_ctl/verdict_blocks.py

@@ -5,6 +5,14 @@ The response shape is fixed by contract (`prompts/lead/plan-body-verification.md
 per-round ad-hoc regex makes the round's fidelity depend on whoever wrote it,
 and its failure mode is silence: dev-10400 lost 19 of 37 assigned items to a
 no-match that nothing reported. Every shape this module cannot read is an error.
+
+A label that means the same thing is read, not refused. The contract writes
+`**Verdict**: AGREE`; a worker following a lead-authored instruction wrote
+`- Verdict: REFUTED` and the whole reverify round was rejected for it
+(2026-09-09). The bullet form, the colon inside the bold (`**Verdict:**`), a
+bullet before the bold, and a differently-cased key all name the same field —
+refusing them costs a dispatch cycle and yields no information. A bare
+`Verdict:` without bullet or bold is still prose: `Note:` opens sentences.
 """
 from __future__ import annotations
 
@@ -60,11 +68,19 @@ DISAGREE_BASES = frozenset({"counter-evidence", "burden-not-met"})
 _ITEM_RE = re.compile(r"^###[ \t]+(?P<id>[^\s:]+)[ \t]*:?.*$", re.MULTILINE)
 # The contract writes some labels with a parenthetical qualifier —
 # `**Fixability** (only when DISAGREE):` — so the colon may trail a `(...)`.
+# The label shapes read as one field (see the module docstring):
+#   `**Key**: v`  `**Key:** v`  `- Key: v`  `- **Key**: v`  `- **Key:** v`
+# `_field_match` enforces that an opening `**` is closed exactly once and that
+# a label without bold carries a bullet.
+_FIELD_KEYS = ("Verdict", "Fixability", "Note", "Explanation", "Prior dissent",
+               "Basis", "Your evidence")
+_CANONICAL_KEYS = {key.lower(): key for key in _FIELD_KEYS}
 _FIELD_RE = re.compile(
-    r"^\*\*(?P<key>Verdict|Fixability|Note|Explanation|Prior dissent|Basis"
-    r"|Your evidence)\*\*"
-    r"(?:[ \t]*\([^)]*\))?[ \t]*:[ \t]*(?P<value>.*)$",
-    re.MULTILINE,
+    r"^(?P<bullet>[-*+][ \t]+)?(?P<open>\*\*)?"
+    r"(?P<key>" + "|".join(re.escape(key) for key in _FIELD_KEYS) + r")"
+    r"(?P<close>\*\*)?(?:[ \t]*\([^)]*\))?[ \t]*:(?P<close_after>\*\*)?"
+    r"[ \t]*(?P<value>.*)$",
+    re.IGNORECASE,
 )
 _VERDICT_RE = re.compile(r"^(?P<token>[A-Z-]+)(?:\((?P<kind>[a-f])\))?$")
 _PROSE_FIELDS = frozenset({"Explanation", "Note", "Prior dissent", "Your evidence"})
@@ -75,6 +91,20 @@ class VerdictBlockError(ValueError):
     """Raised when a worker response does not match the contract shape."""
 
 
+def _field_match(line: str) -> tuple[str, str] | None:
+    """`(canonical key, value)` when *line* is a field label, else ``None``."""
+    match = _FIELD_RE.match(line)
+    if match is None:
+        return None
+    opened = bool(match.group("open"))
+    closes = sum(1 for name in ("close", "close_after") if match.group(name))
+    if opened and closes != 1:
+        return None
+    if not opened and (closes or not match.group("bullet")):
+        return None
+    return _CANONICAL_KEYS[match.group("key").lower()], match.group("value")
+
+
 @dataclass(frozen=True)
 class FindingVote:
     """One worker's vote on one convergence finding, in schema vocabulary."""
@@ -112,12 +142,12 @@ def _scan_blocks(text: str) -> dict[str, dict[str, str]]:
             continue
         if not item_id:
             continue
-        match = _FIELD_RE.match(line)
+        match = _field_match(line)
         if match:
-            field = match.group("key")
+            field, value = match
             if field in blocks[item_id]:
                 raise VerdictBlockError(f"item `{item_id}` has duplicate field `{field}`")
-            blocks[item_id][field] = match.group("value")
+            blocks[item_id][field] = value
         elif field in _PROSE_FIELDS:
             blocks[item_id][field] += "\n" + line
     return {

package/runtime/python/okstra_ctl/wizard/engine.py

@@ -180,8 +180,13 @@ def _passed_screens(state: WizardState) -> int:
 
 
 def _sim_answer(prompt: Prompt) -> str:
-    """분모 추정 시뮬레이션의 기본답: pick 은 첫 옵션(추천), text 는 빈 값."""
+    """분모 추정 시뮬레이션의 기본답: pick 은 추천(체크박스는 추천 집합, 없으면
+    첫 옵션), text 는 빈 값."""
     if prompt.kind == "pick" and prompt.options:
+        if prompt.multi:
+            flagged = [option.value for option in prompt.options if option.recommended]
+            if flagged:
+                return ",".join(flagged)
         return prompt.options[0].value
     return ""
 
@@ -191,7 +196,10 @@ def _sim_advance(state: WizardState, prompt: Prompt) -> None:
     _submit_group() 은 호출하지 않고 step.submit 만 직접 호출해 재귀를 막는다."""
     try:
         if _is_role_selection_step(prompt.step):
-            _submit_role_prompt(state, prompt, _sim_answer(prompt))
+            # 화면은 호스트 한도에 맞춰 쪽으로 잘린 사본일 수 있다 — 기본답은
+            # 잘리지 않은 원본(추천 집합)에서 낸다.
+            original = next_role_prompt(state) or prompt
+            _submit_role_prompt(state, original, _sim_answer(original))
             if prompt.step not in state.answered:
                 state.answered.append(prompt.step)
             if prompt.step not in state.role_selection_order:
@@ -369,6 +377,12 @@ def submit(state: WizardState, value: str) -> dict[str, Any]:
     if prompt.kind == "pick_group":
         return _submit_group(state, prompt, value)
     if _is_role_selection_step(prompt.step):
+        # 화면은 호스트 한도에 맞춰 쪽으로 잘린 사본일 수 있다(`present_picker`).
+        # 답은 잘리지 않은 원본의 선택지로 검증한다 — 체크박스의 CSV 는 여러
+        # 쪽에 걸쳐 고른 값이다.
+        original = next_role_prompt(state)
+        if original is not None and original.step == prompt.step:
+            prompt = original
         echo = _submit_role_prompt(state, prompt, value or "")
         if prompt.step not in state.answered:
             state.answered.append(prompt.step)

package/runtime/python/okstra_ctl/wizard/registry.py

@@ -648,11 +648,20 @@ STEPS: list[Step] = [
     # 이어가기에 필수인 직전 final-report 가 존재하면 use_defaults 와 무관하게
     # 입력 기회를 노출한다. (과거: use_defaults 게이트 뒤에 숨어 "Use defaults"
     # 를 고르면 직전 리포트가 통째로 누락됐다.)
+    # implementation-planning 의 `--clarification-response` 는 같은 phase 의
+    # 계획서만 받는다(`run._validate_planning_entry_inputs`). 그 계획서가 없는
+    # 첫 계획 run 에서 이 화면은 `없음 / 직접 입력` 뿐이고, 직접 입력으로 넣을
+    # 수 있는 파일도 없다 — 질문이 아니라 막다른 길이다(실측 2026-09-09, grok:
+    # 사용자는 직전 후보비교 run 의 user-responses/ 답변을 넘길 자리를 여기서
+    # 찾았다). 그 답변은 방향 선택 단계(`selected_direction_pick`)가 리포트와
+    # 함께 전달하므로, 계획 run 은 이어받을 계획서가 있을 때만 여기를 묻는다.
     Step(S_CLARIFICATION_PICK,
          applies=lambda s: (S_CLARIFICATION_PICK not in s.answered
                             and s.use_defaults is not None
-                            and (s.use_defaults is False
-                                 or bool(_suggest_latest_final_report(s)))),
+                            and (bool(_suggest_latest_final_report(s))
+                                 if s.task_type == "implementation-planning"
+                                 else (s.use_defaults is False
+                                       or bool(_suggest_latest_final_report(s))))),
          build=_build_clarification_pick, submit=_submit_clarification_pick,
          owns=("clarification_response_path", "clarification_pending_text")),
     Step(S_CLARIFICATION,