okstra 0.148.0 → 0.148.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.148.0",
+  "version": "0.148.1",
   "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.148.0",
-  "builtAt": "2026-08-03T19:00:08.212Z",
+  "package": "0.148.1",
+  "builtAt": "2026-08-04T05:55:30.824Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/python/okstra_ctl/report_html/render.py

@@ -9,6 +9,7 @@ import okstra_vendor  # noqa: F401  # registers vendored dependency aliases
 from jinja2 import Environment, FileSystemLoader, StrictUndefined, select_autoescape
 
 from ..final_report_schema import load_schema_for_data, validate
+from ..report_view_artifacts import user_responses_dir_for_report
 from .filters import audit_json, code_evidence, evidence_refs, inline_code, paragraphs
 from .models import HtmlRunMeta
 from .router import HtmlRenderError, resolve_html_route
@@ -73,4 +74,8 @@ def render_v2_html_view(
     }
     output_path = _html_path(data_path)
     output_path.write_text(env.get_template(route.template_name).render(**context), encoding="utf-8")
+    if context["clarificationItems"]:
+        # The footer tells the reader to drop the exported file here, so the
+        # directory has to exist before they go looking for it.
+        user_responses_dir_for_report(data_path).mkdir(parents=True, exist_ok=True)
     return output_path

package/runtime/templates/reports/html/assets/base.css

@@ -36,6 +36,12 @@ th, td { text-align: left; vertical-align: top; border-bottom: 1px solid color-m
 .human-report-footer pre { flex-basis: 100%; white-space: pre-wrap; max-height: 14em; overflow: auto; }
 fieldset, label { display: block; margin: .7rem 0; }
 textarea, select { width: 100%; max-width: 60rem; padding: .55rem; font: inherit; }
+.clarification-lede, .clarification-item p { max-width: 78ch; }
+.clarification-item { padding: 1.2rem 0; border-top: 1px solid color-mix(in srgb, CanvasText 14%, transparent); }
+.clarification-item:first-of-type { border-top: 0; }
+.clarification-expected { color: GrayText; font-size: .9rem; }
+.clarification-item label { font-weight: 600; margin-bottom: .3rem; }
+.user-response-hint { flex-basis: 100%; margin: 0; color: GrayText; font-size: .9rem; }
 @media (max-width: 640px) { section { padding: 1rem; } .visualization { display: none; } }
 @media print { .skip-link, .audit, script { display: none !important; } body { color: #000; background: #fff; } section { break-inside: avoid; border-color: #bbb; } .visualization-fallback { display: table; } }
 code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .9em; padding: .1em .3em; border-radius: 4px; background: color-mix(in srgb, CanvasText 8%, Canvas); }

package/runtime/templates/reports/html/base.template.html

@@ -64,6 +64,7 @@
     <button type="button" data-action="export-user-response">사용자 응답 내보내기</button>
     <button type="button" data-action="copy-user-response">복사</button>
     <button type="button" data-action="dismiss-user-response" hidden>닫기</button>
+    <p class="user-response-hint">내보내기를 누르면 <code>user-response-{{ runMeta.task_type }}-{{ runMeta.seq }}.md</code> 가 다운로드됩니다. 그 파일을 <code>runs/{{ runMeta.task_type }}/user-responses/</code> 에 넣고 다음 run 을 실행하면 답변이 자동으로 반영됩니다.</p>
     <pre id="user-response-output" aria-live="polite"></pre>
   </footer>
   <script id="run-meta" type="application/json">{{ {

package/runtime/templates/reports/html/macros/forms.html

@@ -32,16 +32,18 @@
 
 {% macro clarification_responses(items) -%}
 {% if items %}
-<section class="clarification-responses" aria-label="열린 질문에 답하기">
-  <h2>열린 질문에 답하기</h2>
-  <table><thead><tr><th>ID</th><th>질문</th><th>기대 형식</th><th>사용자 응답</th></tr></thead><tbody>
+<section class="clarification-responses" aria-label="답변이 필요한 질문">
+  <h2>답변이 필요한 질문 {{ items | length }}개</h2>
+  <p class="clarification-lede">코드만 봐서는 정할 수 없어 남겨 둔 항목입니다. 답을 채운 뒤 맨 아래 <strong>사용자 응답 내보내기</strong>를 누르세요.</p>
   {% for row in items %}
-    <tr data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
-      <td>{{ row.id }}</td><td>{{ row.statement | inline_code }}</td><td>{{ row.expectedForm | inline_code }}</td>
-      <td><label for="response-{{ row.id }}">{{ row.id }} 사용자 응답</label><textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="3">{{ row.userInput | default('') }}</textarea></td>
-    </tr>
+  <article class="clarification-item" data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
+    <p class="eyebrow">{{ row.id }} · {{ row.kind }}</p>
+    {{ row.statement | paragraphs }}
+    <p class="clarification-expected"><strong>답변 형식</strong> — {{ row.expectedForm | inline_code }}</p>
+    <label for="response-{{ row.id }}">{{ row.id }} 답변</label>
+    <textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="4">{{ row.userInput | default('') }}</textarea>
+  </article>
   {% endfor %}
-  </tbody></table>
 </section>
 {% endif %}
 {%- endmacro %}

package/runtime/templates/reports/report.js

@@ -74,7 +74,13 @@
 
   function collectEntries() {
     var entries = [];
-    var rows = document.querySelectorAll("tr[data-response-id]");
+    // `tr` is the legacy Markdown-derived view; `article` is the v2 task
+    // template's card. Both container shapes carry the id and kind, and an
+    // allowlist of the two keeps the inner widgets (which repeat
+    // `data-response-id`) from matching as containers themselves.
+    var rows = document.querySelectorAll(
+      "tr[data-response-id], article[data-response-id]"
+    );
     for (var i = 0; i < rows.length; i++) {
       var row = rows[i];
       var value = readRowValue(row);