okstra 0.171.0 → 0.172.0

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

@@ -108,6 +108,13 @@ textarea, select { width: 100%; max-width: 60rem; padding: .55rem; font: inherit
 .clarification-expected dt { font-weight: 600; margin-bottom: .3rem; }
 .clarification-expected dd { margin: 0; }
 .clarification-item label { font-weight: 600; margin-bottom: .3rem; }
+.activity-list { display: grid; gap: .8rem; }
+.activity-card { padding: 1rem; border: 1px solid color-mix(in srgb, CanvasText 14%, transparent); border-radius: 12px; }
+.activity-card > :first-child, .approval-context > :first-child { margin-top: 0; }
+.activity-card > :last-child, .approval-context > :last-child { margin-bottom: 0; }
+.activity-card details { margin-top: .8rem; }
+.approval-context { margin: .8rem 0; padding: .8rem 1rem; border-left: 4px solid color-mix(in srgb, Highlight 55%, GrayText); background: color-mix(in srgb, Highlight 7%, Canvas); }
+.clarification-option-disposition { color: GrayText; font-size: .85rem; }
 .user-response-hint { flex-basis: 100%; margin: 0; color: GrayText; font-size: .9rem; }
 button { padding: .5rem 1rem; border-radius: 8px; border: 1px solid color-mix(in srgb, CanvasText 28%, transparent); background: color-mix(in srgb, CanvasText 5%, Canvas); color: CanvasText; font: inherit; cursor: pointer; }
 button:hover { background: color-mix(in srgb, CanvasText 12%, Canvas); }

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

@@ -150,6 +150,7 @@
       "questions-waiting-on-you": "Questions waiting on you",
       "count-questions-waiting-on-you": "{count} questions waiting on you",
       "your-answer-to-id": "Your answer to {id}",
+      "choose-one": "Choose one",
       "recommended": "Recommended",
       "scope-impact": "Scope",
       "added-work": "Added work",
@@ -322,7 +323,11 @@
       "open-decisions-before-approval": "Open decisions before approval",
       "no-open-decision-is-holding-approval": "No open decision is holding approval.",
       "uniform-verifier-label": "Uniform verifier",
-      "uniform-verifier-legend": "This verifier answered the same verdict to every item it voted on, so this round's refutation signal came from its peers alone — the gate above reads as a wider cross-check than it was. A unanimous round is a legitimate outcome; confirm from the worker's audit sidecar that it actually opened the cited evidence."
+      "uniform-verifier-legend": "This verifier answered the same verdict to every item it voted on, so this round's refutation signal came from its peers alone — the gate above reads as a wider cross-check than it was. A unanimous round is a legitimate outcome; confirm from the worker's audit sidecar that it actually opened the cited evidence.",
+      "what-each-agent-did": "What each agent did",
+      "commands-and-evidence": "Commands and evidence",
+      "unblock-condition": "Unblock condition:",
+      "agent-evidence": "Agent evidence:"
     },
     "implementation": {
       "what-was-delivered": "What was delivered",

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

@@ -150,6 +150,7 @@
       "questions-waiting-on-you": "답변을 기다리는 질문",
       "count-questions-waiting-on-you": "답변을 기다리는 질문 {count}건",
       "your-answer-to-id": "{id}에 대한 답변",
+      "choose-one": "하나를 선택하세요",
       "recommended": "권장",
       "scope-impact": "범위",
       "added-work": "추가 작업",
@@ -322,7 +323,11 @@
       "open-decisions-before-approval": "승인 전에 남은 결정",
       "no-open-decision-is-holding-approval": "승인을 막는 미결 결정이 없습니다.",
       "uniform-verifier-label": "단일 판정 검증자",
-      "uniform-verifier-legend": "이 검증자는 자기가 투표한 모든 항목에 같은 판정을 냈습니다. 그래서 이번 라운드의 반증 신호는 나머지 검증자에게서만 나왔고, 위의 게이트 값은 실제보다 넓은 교차 검증처럼 읽힙니다. 만장일치도 정당한 결과이므로, 그 워커의 audit 사이드카에서 인용한 근거를 실제로 열어봤는지 확인하십시오."
+      "uniform-verifier-legend": "이 검증자는 자기가 투표한 모든 항목에 같은 판정을 냈습니다. 그래서 이번 라운드의 반증 신호는 나머지 검증자에게서만 나왔고, 위의 게이트 값은 실제보다 넓은 교차 검증처럼 읽힙니다. 만장일치도 정당한 결과이므로, 그 워커의 audit 사이드카에서 인용한 근거를 실제로 열어봤는지 확인하십시오.",
+      "what-each-agent-did": "에이전트별 수행 내용",
+      "commands-and-evidence": "명령과 근거",
+      "unblock-condition": "승인 해제 조건:",
+      "agent-evidence": "에이전트 근거:"
     },
     "implementation": {
       "what-was-delivered": "무엇을 만들었나",

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

@@ -42,15 +42,27 @@
   <h2>{{ t('macros.forms.count-questions-waiting-on-you') | replace('{count}', items | length) }}</h2>
   <p class="clarification-lede">{{ t('macros.forms.the-code-alone-could-not-settle-these-fill-i') }} <strong>{{ t('macros.forms.export-my-answers') }}</strong> {{ t('macros.forms.at-the-foot-of-the-page') }}</p>
   {% for row in items %}
-  <article class="clarification-item" id="id-{{ row.id }}" data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
+  {% set is_closed = row.status in ['resolved', 'obsolete'] %}
+  {% set approval_context = row.approvalContext | default(None) %}
+  <article class="clarification-item" id="id-{{ row.id }}" data-response-id="{{ row.id }}" data-kind="{{ row.kind }}" data-status="{{ row.status }}">
     <p class="eyebrow">{{ row.id }} · {{ row.kind }}</p>
     {{ row.statement | paragraphs }}
     <dl class="clarification-expected"><dt>{{ t('macros.forms.answer-as') }}</dt><dd>{{ row.expectedForm | inline_code }}</dd></dl>
+    {% if approval_context %}
+    <div class="approval-context" data-approval-classification="{{ approval_context.classification }}">
+      <p class="eyebrow">{{ approval_context.classification }}</p>
+      <p><strong>{{ t('tasks.implementation-planning.unblock-condition') }}</strong> {{ approval_context.unblockCondition | inline_code }}</p>
+      <p><strong>{{ t('tasks.implementation-planning.agent-evidence') }}</strong>
+        {% for activity_id in approval_context.activityIds %}<a href="#id-{{ activity_id }}">{{ activity_id }}</a>{% if not loop.last %}, {% endif %}{% endfor %}
+      </p>
+    </div>
+    {% endif %}
     {% if row.options %}
     <ol class="clarification-options">
       {% for option in row.options %}
       <li class="clarification-option{% if option.role == 'recommended' %} is-recommended{% endif %}">
         <p class="clarification-option-answer">{{ option.answer }}{% if option.role == 'recommended' %} <span class="badge">{{ t('macros.forms.recommended') }}</span>{% endif %}</p>
+        {% if option.disposition | default(None) %}<p class="clarification-option-disposition"><code>{{ option.disposition }}</code></p>{% endif %}
         <p class="clarification-option-rationale">{{ option.rationale }}</p>
         <dl class="clarification-option-impact">
           <dt>{{ t('macros.forms.scope-impact') }}</dt><dd>{{ option.scopeImpact | join(', ') }}</dd>
@@ -62,7 +74,14 @@
     </ol>
     {% endif %}
     <label for="response-{{ row.id }}">{{ t('macros.forms.your-answer-to-id') | replace('{id}', row.id) }}</label>
-    <textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="4">{{ row.userInput | default('') }}</textarea>
+    {% if row.kind == 'decision' and approval_context and row.options %}
+    <select id="response-{{ row.id }}" data-response-id="{{ row.id }}"{% if is_closed %} disabled{% endif %}>
+      <option value="">{{ t('macros.forms.choose-one') }}</option>
+      {% for option in row.options %}<option value="{{ option.answer }}" data-disposition="{{ option.disposition }}"{% if option.role == 'recommended' %} data-recommended="true"{% endif %}{% if row.userInput | default('') == option.answer %} selected{% endif %}>{{ option.answer }}</option>{% endfor %}
+    </select>
+    {% else %}
+    <textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="4"{% if is_closed %} disabled{% endif %}>{{ row.userInput | default('') }}</textarea>
+    {% endif %}
   </article>
   {% endfor %}
 </section>

package/runtime/templates/reports/html/tasks/implementation-planning.template.html

@@ -97,6 +97,31 @@
   <table data-report-field="implementationPlanning.skippedAdrCandidates"><thead><tr><th>{{ t('tasks.implementation-planning.topic') }}</th><th>{{ t('tasks.implementation-planning.why') }}</th></tr></thead><tbody>{% for row in planning.skippedAdrCandidates %}<tr><td>{{ row.topic | inline_code }}</td><td>{{ row.reason | inline_code }}</td></tr>{% endfor %}</tbody></table>{% endif %}
 </section>
 
+{% if agentActivities %}
+<section data-report-section="agent-activity">
+  <h2>{{ t('tasks.implementation-planning.what-each-agent-did') }}</h2>
+  <div class="activity-list">
+    {% for row in agentActivities %}
+    <article class="activity-card" id="id-{{ row.activityId }}">
+      <p class="eyebrow">{{ row.activityId }} · {{ row.agent }}</p>
+      <h3>{{ row.summary | inline_code }}</h3>
+      <p>{{ t('tasks.implementation-planning.result') }}: {{ row.outcome | inline_code }}</p>
+      <details>
+        <summary>{{ t('tasks.implementation-planning.commands-and-evidence') }}</summary>
+        <p><code>{{ row.kind }}</code></p>
+        {% if row.planItemIds %}<p>{{ row.planItemIds | join(', ') | inline_code }}</p>{% endif %}
+        {% for command in row.commands %}
+        <p><code>{{ command.command }}</code> · exit {{ command.exitCode }} · {{ command.outputSummary | inline_code }}</p>
+        {% endfor %}
+        {% if row.evidenceRefs %}<p>{{ row.evidenceRefs | join(', ') | inline_code }}</p>{% endif %}
+        {% if row.resultPath %}<p><code>{{ row.resultPath }}</code></p>{% endif %}
+      </details>
+    </article>
+    {% endfor %}
+  </div>
+</section>
+{% endif %}
+
 <section data-report-section="open-decisions">
   <h2>{{ t('tasks.implementation-planning.open-decisions-before-approval') }}</h2>
   <div class="summary-grid">{% for row in openDecisions %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important", anchor=row.id) }}{% else %}<p>{{ t('tasks.implementation-planning.no-open-decision-is-holding-approval') }}</p>{% endfor %}</div>

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

@@ -60,6 +60,10 @@
       "readerSummary": "The shortest reader path: what was decided, what a human must do next, and which audit details can wait until a deeper review.",
       "endStateCoverage": "One row per end-state id the brief pinned, and how this phase accounted for it. A row that is not `addressed` must say why."
     },
+  "agentActivity": {
+    "heading": "Agent Activity Audit",
+    "intro": "Structured lead activity projected from this run's canonical event log."
+  },
   "analysis": {
     "basisIntro": "Immutable run snapshot, bounded scan scope, current-code facts, inferences, unknowns, and review disposition for this analysis.",
     "projectIntro": "Project components, boundaries, entry points, dependencies, stores, external systems, and the shallow feature index.",

package/runtime/templates/reports/report.js

@@ -44,33 +44,37 @@
     return String(s == null ? "" : s).replace(/^\s+|\s+$/g, "");
   }
 
-  // Read the user-supplied value out of one clarification row. Returns
-  // the empty string when the row has no usable widget, the widget is
-  // disabled, the select sits on its blank "(선택)" placeholder, or the
-  // "기타" branch has an empty input. Caller decides whether to emit
-  // an entry.
-  function readRowValue(row) {
+  // Read the user-supplied value and decision effect from one clarification
+  // row. Returns null when the row has no usable input.
+  function readRowInput(row) {
     var sel = row.querySelector("select[data-response-id]");
     if (sel) {
-      if (sel.disabled) return "";
+      if (sel.disabled) return null;
       var picked = sel.value;
-      if (picked === "") return "";
+      if (picked === "") return null;
       if (picked === "__other__") {
         var rid = sel.getAttribute("data-response-id") || "";
         var other = row.querySelector('textarea[data-other-for="' + rid + '"]');
-        return other ? trimMultiline(other.value) : "";
+        if (other) {
+          var otherValue = trimMultiline(other.value);
+          return otherValue ? { value: otherValue, disposition: "answer" } : null;
+        }
       }
       var opt = sel.options[sel.selectedIndex];
       // Use the visible option text ("(a) one-time backfill") so the
       // user-response sidecar stays human-readable, not just "a".
-      return opt ? trimMultiline(opt.textContent) : picked;
+      return {
+        value: opt ? trimMultiline(opt.textContent) : picked,
+        disposition: opt ? (opt.getAttribute("data-disposition") || "answer") : "answer",
+      };
     }
     var ta = row.querySelector("textarea[data-response-id]");
     if (ta) {
-      if (ta.disabled) return "";
-      return trimMultiline(ta.value);
+      if (ta.disabled) return null;
+      var value = trimMultiline(ta.value);
+      return value ? { value: value, disposition: "answer" } : null;
     }
-    return "";
+    return null;
   }
 
   function collectEntries() {
@@ -84,13 +88,14 @@
     );
     for (var i = 0; i < rows.length; i++) {
       var row = rows[i];
-      var value = readRowValue(row);
-      if (!value) continue;
+      var input = readRowInput(row);
+      if (!input) continue;
       entries.push({
         responseId: row.getAttribute("data-response-id") || "",
         kind: row.getAttribute("data-kind") || "",
-        value: value,
+        value: input.value,
         rationale: null,
+        disposition: input.disposition,
       });
     }
     return entries;
@@ -460,11 +465,15 @@
   // globalThis (works under ESM where the parent uses `vm.runInThisContext`
   // — see tests/test_report_views.py for the byte-identity harness).
   if (typeof module !== "undefined" && module.exports) {
-    module.exports = { buildUserResponseMarkdown: buildUserResponseMarkdown };
+    module.exports = {
+      buildUserResponseMarkdown: buildUserResponseMarkdown,
+      collectEntries: collectEntries,
+    };
   }
   if (typeof globalThis !== "undefined") {
     globalThis.__okstraReportViewExports__ = {
       buildUserResponseMarkdown: buildUserResponseMarkdown,
+      collectEntries: collectEntries,
     };
   }
 })();

package/runtime/templates/reports/user-response.template.md

@@ -25,12 +25,14 @@ The schema of each response block:
 ```markdown
 ## <Response ID>
 - Kind: <material | decision | data-point>
-- Disposition: <answer | reframe>   # omit the line when answer (default). reframe = defer the answer + re-ask (row stays unresolved)
+- Disposition: <answer | reframe | select | accept-risk | request-revision | reject>   # omit the line when answer (default)
 - Value:
   > <multi-line value, trimmed>
 - Rationale: <optional one-line rationale>
 ```
 
+`answer`, `select`, `accept-risk`, `request-revision`, and `reject` count as user answers when `Value` is non-empty. `reframe` alone does not count as an answer; it defers the answer and asks the next run to present the row again.
+
 An empty response set (when the user presses Export without filling in any row) outputs the following single line in the body:
 
 ```markdown

package/runtime/templates/worker-prompt-preamble.md

@@ -21,6 +21,14 @@ When `**Evidence ledger:** required-v1` is present, append one canonical row to
 
 Every file citation in the result MUST use backticks, a line suffix, and the same project-relative path its ledger row carries — for example `src/config/env.ts:1-22`. A bare filename (`env.ts:1-22`) does not match its row and fails exactly like a file you never opened, however many times you cited the full path earlier. A cited path without a matching ledger row fails Phase 7 in `validators/validate-run.py` `validate_worker_results_audit()`. Do not add a row for a file you did not open.
 
+## Evidence command ledger
+
+Append one canonical JSON row to the audit sidecar for each command that produced or verified a conclusion:
+
+- Evidence command: {"command":"npm run check","cwd":"<project-root>","exitCode":0,"outputSummary":"all checks passed"}
+
+Do not record commands used only to explore, including `rg`, `ls`, and file-opening commands. Do not record environment variable values, tokens, credentials, or authorization headers. `okstra worker-audit-check` rejects malformed command rows and rows containing potential sensitive material through `okstra_ctl.worker_audit_ledger`.
+
 ## Anchor headers (lead-injected, BLOCKING)
 
 Every initial analysis prompt begins with these generated anchors in this exact order, before any other content: