okstra 0.60.2 → 0.61.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.60.2",
+  "version": "0.61.0",
   "description": "Multi-agent cross-verification orchestrator runtime + Claude Code skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.60.2",
-  "builtAt": "2026-06-09T06:03:11.725Z",
+  "package": "0.61.0",
+  "builtAt": "2026-06-09T07:19:02.278Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/bin/lib/okstra/interactive.sh

@@ -357,10 +357,16 @@ run_resume_clarification() {
   local report_path="${lookup_result%$'\t'*}"
   local resolved_type="${lookup_result##*$'\t'}"
 
+  # implementation-planning 도 §1 Clarification Items(plan-body 결정: 예 C-205
+  # tx-배관 step 누락)를 가지므로, 사용자가 결정란을 채운 뒤 같은 phase 를
+  # clarification-response 자동공급으로 재실행해 plan 을 재생성·gate 재판정할 수
+  # 있다. 자동검색(task_type_filter 없음)은 파일명 사전순 max 라 implementation-
+  # planning 이 requirements-discovery 에 밀리므로, 이 경로는 --task-type
+  # implementation-planning 을 명시했을 때만 해소된다.
   case "$resolved_type" in
-    requirements-discovery|error-analysis) ;;
+    requirements-discovery|error-analysis|implementation-planning) ;;
     *)
-      printf '%s (resolved task-type: %s)\n' '--resume-clarification only applies to requirements-discovery or error-analysis runs' "$resolved_type" >&2
+      printf '%s (resolved task-type: %s)\n' '--resume-clarification only applies to requirements-discovery, error-analysis, or implementation-planning runs' "$resolved_type" >&2
       exit 1
       ;;
   esac

package/runtime/python/okstra_ctl/render_final_report.py

@@ -522,7 +522,12 @@ def render_to_file(
     except json.JSONDecodeError as exc:
         raise FinalReportRenderError(f"invalid JSON in {data_path}: {exc}") from exc
 
-    resolved_template = template_path or find_default_template(data_path)
+    # 템플릿은 data.json 위치가 아니라 이 모듈(설치본은 ~/.okstra/lib/python,
+    # repo 는 scripts/) 위치 기준으로 찾는다. data_path 를 start 로 넘기면
+    # 프로젝트의 .okstra 트리만 위로 뒤지다 templates/reports 를 못 찾아
+    # 설치본에서 항상 'could not locate template' 으로 실패한다(OKSTRA_HOME 을
+    # 수동 설정해야 했던 원인). 프로젝트별 override 는 --template 으로 한다.
+    resolved_template = template_path or find_default_template()
     rendered = render(
         data,
         template_path=resolved_template,

package/runtime/templates/reports/final-report.template.md

@@ -32,6 +32,24 @@ implementation-option: {{ frontmatter.implementationOption | yaml_scalar }}
 {% for row in followUpTasks if row.origin == 'phase-continuation' %}{% if loop.first %}- Next Step: run `/okstra-run`, select task `{{ header.taskKey }}`, choose task-type `{{ row.suggestedTaskType }}`
 {% endif %}{% endfor %}- Okstra Version: `{{ header.okstraVersion }}`
 
+{% if clarificationCarryIn and clarificationCarryIn.sourceFile %}
+## 0. Clarification Response Carried In From Previous Run
+
+{{ t("sectionIntro.clarificationCarryIn") }}
+
+- Source file: `{{ clarificationCarryIn.sourceFile }}`
+
+{% endif %}
+## Summary of the Problem or Verification Target
+
+{{ t("sectionIntro.ticketCoverage") }}
+
+| {{ t("columns.recordMeta") }} | {{ t("columns.summary") }} |
+|--------|------------|
+{% for row in summary -%}
+| **{{ row.id }}**<br>Ticket: `{{ row.ticketId }}`<br>{{ t("columns.source") }}: {{ row.source }} | {{ row.summary }} |
+{% endfor %}
+
 ## Verdict Card
 
 {{ t("sectionIntro.verdictCard") }}
@@ -61,12 +79,6 @@ implementation-option: {{ frontmatter.implementationOption | yaml_scalar }}
 {% for row in clarificationItems -%}
 | **{{ row.id }}**<br>Ticket: `{{ row.ticketId }}`<br>Kind: `{{ row.kind }}`<br>Blocks: `{{ row.blocks }}`<br>Status: {{ row.status }} | {{ row.statement }} | {{ row.expectedForm }} | {{ row.userInput or '' }} |
 {% endfor %}
-
-{{ t("clarification.columnGuide") }}
-
-- **`Kind`** ∈ `{material, decision, data-point}`.
-- **`Blocks`** ∈ `{approval, next-phase, none}`.
-- **`Status`** ∈ `{open, answered, resolved, obsolete}`.
 {%- endif %}
 
 ## 2. Evidence and Detailed Analysis
@@ -599,23 +611,6 @@ Acceptance: {{ stage.acceptance }}
 | {{ t("verdictCard.rationaleLabel") }} | {{ finalVerdict.rationaleRowIds | join(', ') }} |
 | {{ t("verdictCard.nextStepLabel") }} | {{ finalVerdict.nextStep }} |
 
-{% if clarificationCarryIn and clarificationCarryIn.sourceFile %}
-## 0. Clarification Response Carried In From Previous Run
-
-- Source file: `{{ clarificationCarryIn.sourceFile }}`
-- {{ t("sectionIntro.clarificationCarryIn") }}
-
-{% endif %}
-## Summary of the Problem or Verification Target
-
-{{ t("sectionIntro.ticketCoverage") }}
-
-| {{ t("columns.recordMeta") }} | {{ t("columns.summary") }} |
-|--------|------------|
-{% for row in summary -%}
-| **{{ row.id }}**<br>Ticket: `{{ row.ticketId }}`<br>{{ t("columns.source") }}: {{ row.source }} | {{ row.summary }} |
-{% endfor %}
-
 {% if ticketCoverage.omit %}
 {# Ticket Coverage omitted entirely — release-handoff / final-verification #}
 {%- else %}

package/runtime/templates/reports/i18n/en.json

@@ -126,8 +126,7 @@
   },
   "clarification": {
     "fillAndRerun": "Fill in your answers then re-run the same phase:",
-    "separateTerminalLabel": "Separate terminal",
-    "columnGuide": "Record cell field values:"
+    "separateTerminalLabel": "Separate terminal"
   },
   "followUpTasks": {
     "headingAside": "Follow-up Tasks"

package/runtime/templates/reports/i18n/ko.json

@@ -126,8 +126,7 @@
   },
   "clarification": {
     "fillAndRerun": "답을 채우신 뒤 같은 phase 를 다시 실행:",
-    "separateTerminalLabel": "별도 터미널",
-    "columnGuide": "항목 칸 안의 값 설명:"
+    "separateTerminalLabel": "별도 터미널"
   },
   "followUpTasks": {
     "headingAside": "후속 작업"