okstra 0.206.0 → 0.206.1

package/runtime/python/okstra_ctl/technical_verification_facts.py

@@ -0,0 +1,52 @@
+"""방향 비교와 기술 검증이 함께 읽는 미확정 사실 계약."""
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypedDict
+
+from .clarification_items import USER_INPUT_BLOCKS, progress_blocking_ids
+
+
+class VerificationFact(TypedDict):
+    id: str
+    candidateId: str
+    factIndex: int
+    fact: str
+    whyItMatters: str
+    evidence: list[str]
+
+
+class TechnicalVerificationError(ValueError):
+    """시험 입력 또는 관측 결과가 원본 사실과 일치하지 않는다."""
+
+
+def technical_verification_facts(data: Mapping[str, Any]) -> list[VerificationFact]:
+    """안전 차단이 없는 후보의 명시적인 기술 검증 사실만 추출한다."""
+    blockers = progress_blocking_ids(
+        data.get("clarificationItems"), USER_INPUT_BLOCKS, report_data=data
+    )
+    if blockers:
+        raise TechnicalVerificationError(
+            "unresolved user decisions: " + ", ".join(blockers)
+        )
+    selection = data.get("implementationOptionSelection") or {}
+    facts: list[VerificationFact] = []
+    for candidate in selection.get("candidateAudit") or []:
+        if candidate.get("safetyBlockers"):
+            continue
+        for index, fact in enumerate(candidate.get("unresolvedFeasibilityFacts") or []):
+            if fact.get("resolutionKind") != "technical-verification":
+                continue
+            facts.append(
+                {
+                    "id": f"TV-{len(facts) + 1:03d}",
+                    "candidateId": candidate["id"],
+                    "factIndex": index,
+                    "fact": fact["fact"],
+                    "whyItMatters": fact["whyItMatters"],
+                    "evidence": fact["evidence"],
+                }
+            )
+    if not facts:
+        raise TechnicalVerificationError("no eligible technical-verification facts")
+    return facts

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

@@ -15,11 +15,11 @@ Public surface (re-exported here; the skill calls it through the
 - ``render_args()`` - final args for ``okstra render-bundle`` (``render``).
 - ``wizard_outcome()`` - final args plus persistence actions and confirmation (``render``).
 
-Module order is the import order: ``ids`` → ``state`` → ``prompts`` → ``sources``
-→ ``roles`` → ``statefile`` → ``steps_*`` → ``confirmation`` → ``registry`` →
-``engine`` → ``render`` → ``cli``. A module imports only modules before it;
-``tests/contract/test_no_import_cycles.py`` keeps it that way.
+Package initialization loads identifiers and state types only. Public execution
+functions are composed by ``api`` when requested. Phase modules can import state
+and prompt readers without initializing the registry that imports those phases.
 """
+
 from __future__ import annotations
 
 from .ids import (
@@ -118,31 +118,31 @@ from .state import (
     WizardError,
     WizardState,
 )
-from .roles import (
-    next_role_prompt,
-)
-from .statefile import (
-    load_state_file,
-    save_state_file,
-)
-from .confirmation import (
-    confirmation_block,
-)
-from .registry import (
-    STEPS,
-    STEP_BY_ID,
-)
-from .engine import (
-    init_state,
-    next_prompt,
-    prompt_payload,
-    submit,
-)
-from .render import (
-    render_args,
-    render_role_args,
-)
-from .outcome import wizard_outcome
-from .cli import (
-    main,
+
+_API_EXPORTS = (
+    "next_role_prompt",
+    "load_state_file",
+    "save_state_file",
+    "confirmation_block",
+    "STEPS",
+    "STEP_BY_ID",
+    "init_state",
+    "next_prompt",
+    "prompt_payload",
+    "submit",
+    "render_args",
+    "render_role_args",
+    "wizard_outcome",
+    "main",
 )
+
+__all__ = [name for name in globals() if not name.startswith("_")] + list(_API_EXPORTS)
+
+
+def __getattr__(name: str):
+    """기존 공개 이름을 실행 조립 모듈에 연결한다."""
+    if name not in _API_EXPORTS:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    from . import api
+
+    return getattr(api, name)

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

@@ -0,0 +1,18 @@
+"""질문 실행기의 공개 조립 지점. 단계의 값·프롬프트 판독에서는 적재하지 않는다."""
+
+from .roles import next_role_prompt as next_role_prompt
+from .statefile import (
+    load_state_file as load_state_file,
+    save_state_file as save_state_file,
+)
+from .confirmation import confirmation_block as confirmation_block
+from .registry import STEPS as STEPS, STEP_BY_ID as STEP_BY_ID
+from .engine import (
+    init_state as init_state,
+    next_prompt as next_prompt,
+    prompt_payload as prompt_payload,
+    submit as submit,
+)
+from .render import render_args as render_args, render_role_args as render_role_args
+from .outcome import wizard_outcome as wizard_outcome
+from .cli import main as main

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

@@ -25,18 +25,9 @@ def _render_argv(rendered: dict[str, Any], *, host_runtime: str) -> list[str]:
 def _wizard_persist_actions(state: WizardState) -> list[dict[str, str]]:
     if state.task_type != "release-handoff":
         return []
-    if not state.pr_template_path:
-        return []
-    if state.pr_template_scope not in ("project", "global"):
-        return []
-    return [
-        {
-            "command": "config.set",
-            "key": "pr-template-path",
-            "scope": state.pr_template_scope,
-            "value": state.pr_template_path,
-        }
-    ]
+    from okstra_ctl.phases.release_handoff.wizard import pr_template_persist_actions
+
+    return pr_template_persist_actions(state)
 
 
 def wizard_outcome(state: WizardState) -> dict[str, Any]:

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

@@ -1,6 +1,20 @@
 """단계 등록표 — 순서가 곧 질문 순서인 `STEPS`, `STEP_BY_ID`, 등록표를 되감는 `_reset_from` 과 되감기를 일으키는 단계(edit target, brief carry)."""
 from __future__ import annotations
 
+from okstra_ctl.phases.change_impact_analysis.entry import (
+    _build_feature_evidence,
+    _build_feature_evidence_pick,
+    _submit_feature_evidence,
+    _submit_feature_evidence_pick,
+)
+
+from okstra_ctl.phases.implementation_planning.wizard import (
+    _selected_direction_candidates,
+    _planning_rerun_selected,
+    _build_selected_direction_pick,
+    _submit_selected_direction_pick,
+)
+
 from typing import Optional
 
 from .ids import (
@@ -119,27 +133,25 @@ from .steps_identity import (
     _submit_task_type,
     _submit_task_type_text,
 )
-from .steps_analysis import (
-    _analysis_inputs_after_reuse,
+from okstra_ctl.phases.feature_analysis.wizard import (
     _build_analysis_target,
     _build_analysis_target_pick,
+    _submit_analysis_target,
+    _submit_analysis_target_pick,
+)
+from .steps_analysis import (
+    _analysis_inputs_after_reuse,
     _build_design_prep_confirm,
     _build_design_prep_decision,
     _build_design_prep_overrides,
-    _build_feature_evidence,
-    _build_feature_evidence_pick,
     _build_project_evidence,
     _build_project_evidence_pick,
     _design_prep_confirm_applies,
     _design_prep_decision_applies,
     _design_prep_overrides_applies,
-    _submit_analysis_target,
-    _submit_analysis_target_pick,
     _submit_design_prep_confirm,
     _submit_design_prep_decision,
     _submit_design_prep_overrides,
-    _submit_feature_evidence,
-    _submit_feature_evidence_pick,
     _submit_project_evidence,
     _submit_project_evidence_pick,
 )
@@ -151,12 +163,9 @@ from .steps_plan import (
     _build_handoff_stage_pick,
     _build_reverify_scope_pick,
     _build_reverify_scope_stages,
-    _build_selected_direction_pick,
     _build_stage_pick,
     _fix_cycle_confirm_required,
-    _planning_rerun_selected,
     _reverify_scope_step_pending,
-    _selected_direction_candidates,
     _submit_approve_plan_confirm,
     _submit_approved_plan,
     _submit_approved_plan_pick,
@@ -164,7 +173,6 @@ from .steps_plan import (
     _submit_handoff_stage_pick,
     _submit_reverify_scope_pick,
     _submit_reverify_scope_stages,
-    _submit_selected_direction_pick,
     _submit_stage_pick,
 )
 from .steps_options import (

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

@@ -12,7 +12,6 @@ from okstra_ctl.analysis_inputs import (
     AnalysisReportCandidate,
     list_evidence_candidates,
     load_analysis_report_candidate,
-    resolve_analysis_target,
     resolve_evidence_inputs,
 )
 from okstra_ctl.design_prep import (
@@ -25,13 +24,9 @@ from okstra_ctl.design_prep import (
 from .ids import (
     PICK_SKIP,
     PICK_TYPE_CUSTOM,
-    S_ANALYSIS_TARGET,
-    S_ANALYSIS_TARGET_PICK,
     S_DESIGN_PREP_CONFIRM,
     S_DESIGN_PREP_DECISION,
     S_DESIGN_PREP_OVERRIDES,
-    S_FEATURE_EVIDENCE,
-    S_FEATURE_EVIDENCE_PICK,
     S_PROJECT_EVIDENCE,
     S_PROJECT_EVIDENCE_PICK,
     _RESUME_REUSE_PHASES,
@@ -128,32 +123,6 @@ def _submit_analysis_evidence_pick(
     return t["echo_variants"]["selected"].format(path=candidate.report_path)
 
 
-def _build_feature_evidence_pick(state: WizardState) -> Prompt:
-    return _build_analysis_evidence_pick(
-        state, step=S_FEATURE_EVIDENCE_PICK, relation="feature-baseline"
-    )
-
-
-def _submit_feature_evidence_pick(state: WizardState, value: str) -> Optional[str]:
-    return _submit_analysis_evidence_pick(
-        state, value, step=S_FEATURE_EVIDENCE_PICK,
-        field_name="feature_evidence_path",
-        pending_name="feature_evidence_pending_text",
-    )
-
-
-def _build_feature_evidence(state: WizardState) -> Prompt:
-    t = _p(state.workspace_root, S_FEATURE_EVIDENCE)
-    return Prompt(step=S_FEATURE_EVIDENCE, kind="text", label=t["label"],
-                  echo_template=t["echo_template"])
-
-
-def _submit_feature_evidence(state: WizardState, value: str) -> Optional[str]:
-    candidate = _accept_analysis_evidence(state, value, "feature_evidence_path")
-    state.feature_evidence_pending_text = False
-    return f"feature-evidence: {candidate.report_path}"
-
-
 def _build_project_evidence_pick(state: WizardState) -> Prompt:
     return _build_analysis_evidence_pick(
         state, step=S_PROJECT_EVIDENCE_PICK, relation="project-context"
@@ -181,72 +150,6 @@ def _submit_project_evidence(state: WizardState, value: str) -> Optional[str]:
     return f"project-evidence: {candidate.report_path}"
 
 
-def _feature_description(feature: dict[object, object]) -> str:
-    name = str(feature.get("name") or "")
-    summary = str(feature.get("summary") or "")
-    entry_point = str(
-        feature.get("entryPoint") or feature.get("entrypoint") or ""
-    )
-    return " · ".join(value for value in (name, summary, entry_point) if value)
-
-
-def _build_analysis_target_pick(state: WizardState) -> Prompt:
-    t = _p(state.workspace_root, S_ANALYSIS_TARGET_PICK)
-    try:
-        candidate = load_analysis_report_candidate(
-            Path(state.project_root), Path(state.project_evidence_path)
-        )
-    except AnalysisInputError as exc:
-        raise WizardError(str(exc)) from exc
-    options = [
-        _opt(str(feature["id"]), str(feature["id"]), _feature_description(feature))
-        for feature in candidate.feature_index
-        if isinstance(feature, dict) and isinstance(feature.get("id"), str)
-    ][:3]
-    options.append(_opt(PICK_TYPE_CUSTOM, t["options"][PICK_TYPE_CUSTOM]))
-    return Prompt(step=S_ANALYSIS_TARGET_PICK, kind="pick", label=t["label"],
-                  options=options, echo_template=t["echo_template"])
-
-
-def _accept_analysis_target(state: WizardState, value: str) -> str:
-    candidates: dict[Path, AnalysisReportCandidate] = {}
-    for path in _analysis_evidence_paths(state):
-        try:
-            candidate = load_analysis_report_candidate(Path(state.project_root), path)
-        except AnalysisInputError as exc:
-            raise WizardError(str(exc)) from exc
-        candidates[candidate.report_path] = candidate
-    try:
-        target = resolve_analysis_target(
-            value, _resolve_analysis_evidence(state), candidates
-        )
-    except AnalysisInputError as exc:
-        raise WizardError(str(exc)) from exc
-    requested_value = target["requestedValue"]
-    if not isinstance(requested_value, str):
-        raise WizardError("analysis target resolver returned an invalid requestedValue")
-    state.analysis_target = requested_value
-    state.analysis_target_pending_text = False
-    return requested_value
-
-
-def _submit_analysis_target_pick(state: WizardState, value: str) -> Optional[str]:
-    if value == PICK_TYPE_CUSTOM:
-        state.analysis_target_pending_text = True
-        return None
-    return f"analysis-target: {_accept_analysis_target(state, value)}"
-
-
-def _build_analysis_target(state: WizardState) -> Prompt:
-    t = _p(state.workspace_root, S_ANALYSIS_TARGET)
-    return Prompt(step=S_ANALYSIS_TARGET, kind="text", label=t["label"],
-                  echo_template=t["echo_template"])
-
-
-def _submit_analysis_target(state: WizardState, value: str) -> Optional[str]:
-    return f"analysis-target: {_accept_analysis_target(state, value)}"
-
-
 def _design_prep_items_by_id(state: WizardState) -> dict[str, dict[str, Any]]:
     try:
         items = load_design_prep_items(Path(state.approved_plan_path))