okstra 0.146.1 → 0.148.0

package/runtime/templates/reports/html/tasks/final-verification.template.html

@@ -0,0 +1,39 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="verification-verdict">
+  <h2>검증 판정</h2>
+  <p><span class="status status-{{ verdict.verdictToken }}">{{ verdict.verdictToken }}</span></p>
+  {{ render_narrative(narrative.verdictExplanation, "finalVerification.userNarrative.verdictExplanation", evidenceIndex) }}
+</section>
+
+<section data-report-section="requirement-results" data-report-field="finalVerification.validationEvidence">
+  <h2>요구사항별 결과</h2>
+  {{ render_narrative(narrative.coverageExplanation, "finalVerification.userNarrative.coverageExplanation", evidenceIndex) }}
+  {{ figure(coverageFigure) }}
+</section>
+
+<section data-report-section="blockers" data-report-field="finalVerification.acceptanceBlockers">
+  <h2>수락 차단 항목</h2>
+  {{ render_narrative(narrative.blockerExplanation, "finalVerification.userNarrative.blockerExplanation", evidenceIndex) }}
+  <div class="summary-grid">{% for row in final.acceptanceBlockers %}{{ summary_card(row.id ~ " · " ~ row.severity, row.statement, "important") }}{% else %}<p>수락을 막는 항목이 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="residual-risk" data-report-field="finalVerification.residualRisk">
+  <h2>잔여 위험</h2>
+  <div class="summary-grid">{% for row in final.residualRisk %}<article class="summary-card"><h3>{{ row.id }}</h3><p>{{ row.item | inline_code }}</p><p><strong>담당:</strong> {{ row.owner | inline_code }}</p><p><strong>상향 조건:</strong> {{ row.escalationTrigger | inline_code }}</p></article>{% else %}<p>기록된 잔여 위험이 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="manual-results" data-report-field="finalVerification.manualUserTest">
+  <h2>수동 사용자 테스트 결과</h2>
+  {% if final.manualUserTest.applicable %}{% for row in final.manualUserTest.results %}<article class="summary-card tone-{{ row.result }}"><h3>{{ row.target | inline_code }} · {{ row.result }}</h3><p>{{ row.performed | inline_code }}</p><p>{{ row.observed | inline_code }}</p></article>{% endfor %}{% else %}<p>{{ final.manualUserTest.exemptionReaffirm | inline_code }}</p>{% endif %}
+</section>
+
+<section data-report-section="release-route">
+  <h2>릴리스 경로</h2>
+  {{ render_narrative(narrative.releaseReadiness, "finalVerification.userNarrative.releaseReadiness", evidenceIndex) }}
+  {% if releaseAllowed %}<p>{{ final.routingRecommendation | inline_code }}</p>{% else %}<p>현재 판정으로는 release-handoff를 시작할 수 없습니다. 차단 또는 조건을 먼저 해소하세요.</p>{% endif %}
+</section>
+{% endblock %}

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

@@ -0,0 +1,47 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/forms.html" import plan_approval %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="planning-goal">
+  <h2>계획 목표</h2>
+  <p>{{ humanSummary.outcome | inline_code }}</p>
+  <div class="summary-grid">{% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가 " ~ loop.index, reason, "important") }}{% endfor %}</div>
+</section>
+
+<section data-report-section="option-comparison">
+  <h2>구현 대안 비교</h2>
+  {{ render_narrative(narrative.optionExplanation, "implementationPlanning.userNarrative.optionExplanation", evidenceIndex) }}
+  <div class="summary-grid" data-report-field="implementationPlanning.optionCandidates">{% for row in planning.optionCandidates %}<article class="summary-card"><h3>{{ row.name | inline_code }}</h3><p><strong>인터페이스:</strong> {{ row.interfaces | inline_code }}</p><p><strong>영향 범위:</strong> {{ row.blastRadius | inline_code }}</p><ul>{% for file in row.fileStructure %}<li>{{ file.action }} <code>{{ file.path }}</code> — {{ file.summary | inline_code }}</li>{% endfor %}</ul></article>{% endfor %}</div>
+  <table data-report-field="implementationPlanning.tradeoffMatrix"><thead><tr><th>옵션</th><th>복잡도</th><th>위험</th><th>가역성</th><th>테스트 비용</th><th>배포 비용</th></tr></thead><tbody>{% for row in planning.tradeoffMatrix %}<tr><td>{{ row.option | inline_code }}</td><td>{{ row.complexity | inline_code }}</td><td>{{ row.risk | inline_code }}</td><td>{{ row.reversibility | inline_code }}</td><td>{{ row.testCoverageCost | inline_code }}</td><td>{{ row.rolloutCost | inline_code }}</td></tr>{% endfor %}</tbody></table>
+</section>
+
+<section data-report-section="recommendation" data-report-field="implementationPlanning.recommendedOption">
+  <h2>권장안</h2>
+  {{ render_narrative(narrative.recommendationExplanation, "implementationPlanning.userNarrative.recommendationExplanation", evidenceIndex) }}
+  <article class="summary-card tone-important"><h3>{{ planning.recommendedOption.name | inline_code }}</h3><p>{{ planning.recommendedOption.coreReason | inline_code }}</p><p>{{ planning.recommendedOption.rationale | inline_code }}</p><p><strong>선택하지 않은 안:</strong> {{ planning.recommendedOption.rejectedSummary | inline_code }}</p></article>
+</section>
+
+<section data-report-section="stage-map" data-report-field="implementationPlanning.stageMap">
+  <h2>단계별 실행 지도</h2>
+  {{ render_narrative(narrative.stageStrategy, "implementationPlanning.userNarrative.stageStrategy", evidenceIndex) }}
+  {{ figure(stageFigure) }}
+  <div class="summary-grid">{% for row in planning.stages %}<article class="summary-card"><h3>Stage {{ row.stage }} · {{ row.title | inline_code }}</h3><p>{{ row.sliceValue | inline_code }}</p><p><strong>완료 조건:</strong> {{ row.acceptance | inline_code }}</p><p><strong>검증:</strong> {{ row.stageValidation | inline_code }}</p></article>{% endfor %}</div>
+</section>
+
+<section data-report-section="validation-and-rollback">
+  <h2>검증과 롤백</h2>
+  {{ render_narrative(narrative.validationAndRollback, "implementationPlanning.userNarrative.validationAndRollback", evidenceIndex) }}
+  <h3>검증 체크리스트</h3><table data-report-field="implementationPlanning.validationChecklist"><thead><tr><th>ID</th><th>시점</th><th>확인</th><th>명령</th><th>기대 결과</th></tr></thead><tbody>{% for row in planning.validationChecklist %}<tr><td>{{ row.id }}</td><td>{{ row.phase }}</td><td>{{ row.check | inline_code }}</td><td><code>{{ row.commandOrObservation }}</code></td><td>{{ row.expectedOutcome | inline_code }}</td></tr>{% endfor %}</tbody></table>
+  <h3>롤백 전략</h3><div class="summary-grid" data-report-field="implementationPlanning.rollbackStrategy">{% for row in planning.rollbackStrategy %}{{ summary_card(row.id ~ " · " ~ (row.triggerSignal | inline_code), row.action, "important") }}{% endfor %}</div>
+</section>
+
+<section data-report-section="open-decisions">
+  <h2>승인 전 열린 결정</h2>
+  <div class="summary-grid">{% for row in openDecisions %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important") }}{% else %}<p>승인을 막는 열린 결정이 없습니다.</p>{% endfor %}</div>
+  {{ action_list(humanSummary.actions) }}
+</section>
+
+{{ plan_approval(approval) }}
+{% endblock %}

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

@@ -0,0 +1,40 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="delivered-outcome">
+  <h2>전달된 결과</h2>
+  {{ render_narrative(narrative.deliveredOutcome, "implementation.userNarrative.deliveredOutcome", evidenceIndex) }}
+  <p>{{ humanSummary.outcome | inline_code }}</p>
+</section>
+
+<section data-report-section="change-map" data-report-field="implementation.diffSummary">
+  <h2>무엇이 달라졌는가</h2>
+  {{ render_narrative(narrative.changeExplanation, "implementation.userNarrative.changeExplanation", evidenceIndex) }}
+  {{ figure(changeFigure) }}
+</section>
+
+<section data-report-section="requirement-coverage">
+  <h2>요구사항 충족</h2>
+  <table data-report-field="implementation.requirementCoverage"><thead><tr><th>ID</th><th>요구사항</th><th>구현·증거</th><th>상태</th></tr></thead><tbody>{% for row in implementation.requirementCoverage %}<tr><td>{{ row.id }}</td><td>{{ row.requirement | inline_code }}</td><td>{{ row.coveredBy | inline_code }}</td><td><span class="status status-{{ row.status }}">{{ row.status }}</span></td></tr>{% endfor %}</tbody></table>
+</section>
+
+<section data-report-section="validation" data-report-field="implementation.validationEvidence">
+  <h2>검증 결과</h2>
+  {{ render_narrative(narrative.validationExplanation, "implementation.userNarrative.validationExplanation", evidenceIndex) }}
+  <div class="summary-grid">{% for row in implementation.validationEvidence %}{{ summary_card(row.phase ~ " · 종료 코드 " ~ row.exitCode, row.outputTail, "important" if row.exitCode else "neutral") }}{% endfor %}</div>
+  <p><strong>독립 검증:</strong> {% for row in implementation.verifierResults %}<span class="status status-{{ row.verdict | lower }}">{{ row.verdict }}</span>{% if not loop.last %}, {% endif %}{% endfor %}</p>
+</section>
+
+<section data-report-section="remaining-issues">
+  <h2>남은 문제</h2>
+  {{ render_narrative(narrative.remainingIssues, "implementation.userNarrative.remainingIssues", evidenceIndex) }}
+  <div class="summary-grid">{% for row in implementation.outOfPlanEdits %}{{ summary_card(row.id ~ " · " ~ row.file, row.rationale, "important") }}{% else %}<p>계획 밖 수정 사항이 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="manual-test" data-report-field="implementation.manualUserTest">
+  <h2>수동 사용자 테스트</h2>
+  {% if implementation.manualUserTest.applicable %}{% for row in implementation.manualUserTest["items"] %}<article class="summary-card"><h3>{{ row.target | inline_code }}</h3><p><strong>환경:</strong> {{ row.environmentSetup | inline_code }}</p><ol>{% for step in row.steps %}<li>{{ step | inline_code }}</li>{% endfor %}</ol><p><strong>기대 결과:</strong> {{ row.expectedResult | inline_code }}</p></article>{% endfor %}{% else %}<p>{{ implementation.manualUserTest.exemptionReason | inline_code }}</p>{% endif %}
+</section>
+{% endblock %}

package/runtime/templates/reports/html/tasks/improvement-discovery.template.html

@@ -0,0 +1,29 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="opportunities">
+  <h2>발견한 개선 기회</h2>
+  {{ render_narrative(narrative.opportunityOverview, "improvementDiscovery.userNarrative.opportunityOverview", evidenceIndex) }}
+  <table data-report-field="improvementDiscovery.lensCoverage"><thead><tr><th>렌즈</th><th>결과</th><th>설명</th><th>근거</th></tr></thead><tbody>{% for row in improvement.lensCoverage %}<tr><td>{{ row.lens }}</td><td>{{ row.status }}</td><td>{{ row.rationale | inline_code }}</td><td>{{ row.evidence | evidence_refs(evidenceIndex) }}</td></tr>{% endfor %}</tbody></table>
+</section>
+
+<section data-report-section="ranked-candidates">
+  <h2>우선순위 후보</h2>
+  {{ render_narrative(narrative.prioritizationExplanation, "improvementDiscovery.userNarrative.prioritizationExplanation", evidenceIndex) }}
+  <div class="summary-grid" data-report-field="improvementDiscovery.candidates">{% for row in improvement.candidates %}<article class="summary-card tone-{{ row.severity }}"><p class="eyebrow">{{ loop.index }}순위 · {{ row.id }} · 영향 {{ row.severity }} · 노력 {{ row.effort }}</p><h3>{{ row.title | inline_code }}</h3><p>{{ row.expectedBehaviorAfter | inline_code }}</p><p><strong>다음 단계:</strong> {{ row.recommendedNextPhase }}</p><p class="evidence-refs">근거: {{ row.evidence | evidence_refs(evidenceIndex) }}</p></article>{% else %}<p>선택할 개선 후보가 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="impact-effort">
+  <h2>영향도와 노력도</h2>
+  {{ figure(matrixFigure) }}
+</section>
+
+<section data-report-section="selection">
+  <h2>선택 안내</h2>
+  {{ render_narrative(narrative.selectionGuidance, "improvementDiscovery.userNarrative.selectionGuidance", evidenceIndex) }}
+  <p><strong>선택 상한:</strong> 최대 {{ improvement.selectionLimit }}개</p>
+  <ul>{% for row in improvement.candidates %}<li><label><input type="checkbox" name="improvement-candidate" value="{{ row.id }}"> {{ row.id }} · {{ row.title | inline_code }}</label></li>{% endfor %}</ul>
+</section>
+{% endblock %}

package/runtime/templates/reports/html/tasks/project-analysis.template.html

@@ -0,0 +1,57 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="project-overview">
+  <h2>프로젝트 개요</h2>
+  {{ render_narrative(narrative.projectOverview, "projectAnalysis.userNarrative.projectOverview", evidenceIndex) }}
+  <div class="summary-grid">
+    {% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가 " ~ loop.index, reason, "important") }}{% endfor %}
+  </div>
+</section>
+
+<section data-report-section="architecture" data-report-field="projectAnalysis.components">
+  <h2>아키텍처와 의존성</h2>
+  {{ render_narrative(narrative.architectureExplanation, "projectAnalysis.userNarrative.architectureExplanation", evidenceIndex) }}
+  {{ figure(architectureFigure) }}
+</section>
+
+<section data-report-section="boundaries">
+  <h2>시스템 경계</h2>
+  <div class="summary-grid" data-report-field="projectAnalysis.entryPoints">
+    {% for row in project.entryPoints %}{{ summary_card(row.symbol, row.role) }}{% endfor %}
+  </div>
+  <h3>데이터 저장소</h3>
+  <ul data-report-field="projectAnalysis.dataStores">{% for row in project.dataStores %}<li><strong>{{ row.name | inline_code }}</strong> — {{ row.readBoundary | inline_code }} / {{ row.writeBoundary | inline_code }}</li>{% endfor %}</ul>
+  <h3>외부 시스템</h3>
+  <ul data-report-field="projectAnalysis.externalSystems">{% for row in project.externalSystems %}<li><strong>{{ row.name | inline_code }}</strong> — {{ row.adapter | inline_code }} ({{ row.direction | inline_code }})</li>{% endfor %}</ul>
+</section>
+
+<section data-report-section="hotspots" data-report-field="projectAnalysis.rankedHotspots">
+  <h2>우선 검토할 핫스팟</h2>
+  {{ render_narrative(narrative.hotspotExplanation, "projectAnalysis.userNarrative.hotspotExplanation", evidenceIndex) }}
+  <div class="summary-grid">
+    {% for row in project.rankedHotspots %}
+    <article class="summary-card tone-{{ row.risk }}"><p class="eyebrow">{{ row.id }} · 영향 {{ row.impact }} · 위험 {{ row.risk }}</p><h3>{{ row.title | inline_code }}</h3><p>{{ row.reason | inline_code }}</p><p class="evidence-refs">근거: {{ row.evidenceRefs | evidence_refs(evidenceIndex) }}</p></article>
+    {% endfor %}
+  </div>
+</section>
+
+<section data-report-section="quality-and-tests" data-report-field="projectAnalysis.qualityCoverage">
+  <h2>품질과 테스트 상태</h2>
+  {{ render_narrative(narrative.qualityExplanation, "projectAnalysis.userNarrative.qualityExplanation", evidenceIndex) }}
+  <table><thead><tr><th>영역</th><th>상태</th><th>설명</th><th>근거</th></tr></thead><tbody>{% for row in project.qualityCoverage %}<tr><td>{{ row.area | inline_code }}</td><td><span class="status status-{{ row.status }}">{{ row.status }}</span></td><td>{{ row.summary | inline_code }}</td><td>{{ row.evidenceRefs | evidence_refs(evidenceIndex) }}</td></tr>{% endfor %}</tbody></table>
+</section>
+
+<section data-report-section="feature-map" data-report-field="projectAnalysis.featureIndex">
+  <h2>기능 지도</h2>
+  <div class="summary-grid">{% for row in project.featureIndex %}{{ summary_card(row.id ~ " · " ~ (row.name | inline_code), row.description) }}{% endfor %}</div>
+</section>
+
+<section data-report-section="user-actions">
+  <h2>다음 행동</h2>
+  {{ action_list(humanSummary.actions) }}
+  {% if humanSummary.blockers %}<h3>차단 사항</h3><ul>{% for item in humanSummary.blockers %}<li>{{ item | inline_code }}</li>{% endfor %}</ul>{% endif %}
+</section>
+{% endblock %}

package/runtime/templates/reports/html/tasks/release-handoff.template.html

@@ -0,0 +1,36 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="handoff-outcome">
+  <h2>인계 결과</h2>
+  {{ render_narrative(narrative.handoffOutcome, "releaseHandoff.userNarrative.handoffOutcome", evidenceIndex) }}
+  {{ figure(handoffFigure) }}
+</section>
+
+<section data-report-section="user-selection" data-report-field="releaseHandoff.userSelections">
+  <h2>사용자가 선택한 동작</h2>
+  <dl><dt>인계 방식</dt><dd>{{ handoff.userSelections.h1 }}</dd><dt>충돌 확인</dt><dd>{{ handoff.userSelections.h2b }}</dd><dt>PR 본문</dt><dd>{{ handoff.userSelections.h3 }}</dd></dl>
+</section>
+
+<section data-report-section="branch-and-pr" data-report-field="releaseHandoff.featureBranchState">
+  <h2>브랜치와 PR</h2>
+  {{ render_narrative(narrative.branchAndPrExplanation, "releaseHandoff.userNarrative.branchAndPrExplanation", evidenceIndex) }}
+  <p><strong>브랜치:</strong> {{ handoff.featureBranchState.branchName }}</p>
+  <p data-report-field="releaseHandoff.pullRequestOutcome"><strong>PR 결과:</strong> {{ handoff.pullRequestOutcome.kind }}{% if prUrl %} · <a href="{{ prUrl }}" rel="noopener noreferrer">Pull request 열기</a>{% endif %}</p>
+</section>
+
+<section data-report-section="conflicts" data-report-field="releaseHandoff.mergeConflictProbe">
+  <h2>충돌 판정</h2>
+  {{ render_narrative(narrative.conflictExplanation, "releaseHandoff.userNarrative.conflictExplanation", evidenceIndex) }}
+  {{ summary_card(handoff.mergeConflictProbe.kind, "기준 브랜치: " ~ (handoff.mergeConflictProbe.baseBranch | default('not-run'))) }}
+  {% if handoff.mergeConflictProbe.conflictingPaths %}<ul>{% for path in handoff.mergeConflictProbe.conflictingPaths %}<li>{{ path }}</li>{% endfor %}</ul>{% endif %}
+</section>
+
+<section data-report-section="next-action">
+  <h2>다음 행동</h2>
+  {{ render_narrative(narrative.nextAction, "releaseHandoff.userNarrative.nextAction", evidenceIndex) }}
+  <p>{{ handoff.routingRecommendation | inline_code }}</p>
+</section>
+{% endblock %}

package/runtime/templates/reports/html/tasks/requirements-discovery.template.html

@@ -0,0 +1,37 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="request">
+  <h2>요청 이해</h2>
+  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding", evidenceIndex) }}
+  <h3>사용자 요청 원문</h3>
+  <p data-report-field="requirementsDiscovery.requestVerbatim">{{ requirements.requestVerbatim | inline_code }}</p>
+  <h3>시스템 해석</h3>
+  <p data-report-field="requirementsDiscovery.systemInterpretation">{{ requirements.systemInterpretation | inline_code }}</p>
+  <dl data-report-field="requirementsDiscovery.classification">{% for key, value in requirements.classification.items() %}<dt>{{ key }}</dt><dd>{{ value | inline_code }}</dd>{% endfor %}</dl>
+</section>
+
+<section data-report-section="requirements">
+  <h2>확정 요구사항과 미확정 요구사항</h2>
+  {{ render_narrative(narrative.confirmedRequirements, "requirementsDiscovery.userNarrative.confirmedRequirements", evidenceIndex) }}
+  <div class="summary-grid" data-report-field="requirementsDiscovery.confirmedRequirements">{% for row in requirements.confirmedRequirements %}{{ summary_card(row.id ~ " · 확정", row.statement) }}{% endfor %}</div>
+  {{ render_narrative(narrative.unresolvedRequirements, "requirementsDiscovery.userNarrative.unresolvedRequirements", evidenceIndex) }}
+  <div class="summary-grid" data-report-field="requirementsDiscovery.unresolvedRequirements">{% for row in requirements.unresolvedRequirements %}{{ summary_card(row.id ~ " · 결정 필요", row.statement, "important") }}{% else %}<p>미확정 요구사항이 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="routing">
+  <h2>다음 태스크와 의존성</h2>
+  {{ render_narrative(narrative.routingExplanation, "requirementsDiscovery.userNarrative.routingExplanation", evidenceIndex) }}
+  <p><strong>다음 태스크:</strong> {{ requirements.routing.nextTaskType }} · {{ requirements.routing.rationale | inline_code }}</p>
+  {{ figure(routingFigure) }}
+  {% if not requirements.taskDependencies %}<p class="empty-state">이 요구사항 태스크는 다른 태스크에 의존하지 않는 단일 작업입니다.</p>{% endif %}
+</section>
+
+<section data-report-section="decisions">
+  <h2>사용자가 결정할 항목</h2>
+  <div class="summary-grid">{% for row in clarificationItems %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important") }}{% else %}<p>추가 결정이 필요하지 않습니다.</p>{% endfor %}</div>
+  {{ action_list(humanSummary.actions) }}
+</section>
+{% endblock %}

package/runtime/templates/reports/report.js

@@ -249,6 +249,16 @@
     setTimeout(function () { URL.revokeObjectURL(url); }, 0);
   }
 
+  // The output element lives in the footer, many screens below the header
+  // export button, so writing text into it alone reads as "nothing happened".
+  function showOutput(out, text) {
+    if (!out) return;
+    out.textContent = text;
+    out.setAttribute("tabindex", "-1");
+    out.scrollIntoView({ block: "center" });
+    out.focus();
+  }
+
   function exportUserResponse() {
     var runMeta = readRunMeta();
     var entries = collectEntries();
@@ -258,14 +268,14 @@
     try {
       analysisReview = collectAnalysisReview();
     } catch (e) {
-      if (out) out.textContent = e.message || String(e);
+      showOutput(out, e.message || String(e));
       showDismiss(true);
       return "";
     }
     var md = buildUserResponseMarkdown(
       runMeta, entries, isoNowUtc(), approval, analysisReview
     );
-    if (out) out.textContent = md;
+    showOutput(out, md);
     showDismiss(true);
     // Nothing answered yet — show the empty serialisation as feedback but
     // don't download a useless file.
@@ -315,7 +325,10 @@
     if (/Reader Summary|Verdict Card|Clarification Items|Recommended Next Steps|Follow-up Tasks/.test(text)) {
       return "action";
     }
-    if (/Evidence|Cross Verification|Execution Status|Token Usage|Plan Body Verification|Round History/.test(text)) {
+    // "토큰 사용량" is tokenSummary.heading from templates/reports/i18n/ko.json —
+    // the only audit heading the ko dictionary translates away from its English
+    // form. tests/report/test_report_views.py pins the two in sync.
+    if (/Evidence|Cross Verification|Execution Status|Token Usage|토큰 사용량|Plan Body Verification|Round History/.test(text)) {
       return "audit";
     }
     return "detail";
@@ -333,7 +346,11 @@
         current = "action";
         continue;
       }
-      if (/^H[12]$/.test(node.tagName || "")) {
+      // Only h2 opens a reader section. The single h1 is the report title, and
+      // the run-metadata list and table of contents that trail it are document
+      // chrome — classifying them would hide the title in action mode, because
+      // the title text ("… Cross Verification Final Report") reads as audit.
+      if ((node.tagName || "") === "H2") {
         current = readerSectionKind(node.textContent || "");
       }
       node.setAttribute("data-reader-section", current);

package/runtime/templates/reports/settings.template.json

@@ -25,6 +25,10 @@
       "Bash(agy:*)",
       "Bash(claude)",
       "Bash(claude:*)",
+      "Bash(grok)",
+      "Bash(grok:*)",
+      "Bash(kimi)",
+      "Bash(kimi:*)",
       "Bash(docker)",
       "Bash(docker:*)"
     ]

package/runtime/templates/reports/task-brief.template.md

@@ -131,8 +131,8 @@ taskType: "{{FM_TASK_TYPE}}"
 - Should the same task key continue to be used after this run?
 - What is the likely work category for this task right now?
 - Which lifecycle phase should probably happen next after this run?
-- What prior decision or report should Claude compare against?
-- What related tasks should Claude keep in mind but not merge with this task?
+- What prior decision or report should the Okstra lead compare against?
+- What related tasks should the Okstra lead keep in mind but not merge with this task?
 - Which config files and deployment manifests carry the expected state for this task?
 
 ## Phase Boundary
@@ -145,27 +145,27 @@ taskType: "{{FM_TASK_TYPE}}"
 
 ## Available MCP Servers
 
-The MCP servers available to this run are declared in `.okstra/project.json`'s `mcpServers` array and rendered into the Claude lead's launch prompt under `## Available MCP Servers`. They may be invoked **as needed** by Claude lead, Claude worker, and Report writer worker. The lead is responsible for forwarding the rendered list verbatim into the worker prompts (Phase 2) so workers know which tools they are allowed to call.
+The MCP servers available to this run are declared in `.okstra/project.json`'s `mcpServers` array and rendered into the Okstra lead's launch prompt under `## Available MCP Servers`. The lead is responsible for forwarding the rendered list verbatim into worker prompts (Phase 2) so each assignment can determine whether its selected runner exposes the named tools.
 
 To declare servers, add entries shaped `{ "name": "<server>", "description": "...", "tools": ["..."], "notes": "..." }` to that array. If the array is empty or absent, treat MCP as unavailable for this run.
 
 How to invoke (worker-by-worker):
 
-- **Claude lead / Claude worker / Report writer worker**: invoke the MCP tool **directly by its tool name** (e.g. `mcp__<server>__<tool>`) through the host's tool interface. **Do NOT call it via `Bash`** — these names are MCP tools, not shell commands; running them in a shell will always fail with `command not found` regardless of permission settings.
-- **Codex worker / Antigravity worker**: invoke through the external CLI's own MCP transport (e.g. `codex mcp call <server> <tool> <args>` for Codex CLI; the equivalent Antigravity CLI MCP invocation for Antigravity). If the worker's CLI has no matching MCP config, treat the server as unavailable for this run and record `MCP not available in this CLI` in `Missing Information or Assumptions` — do **not** attempt a shell fallback such as `mysql -h ...` or piping a tool name into `bash`.
+- **Native-session assignments**: invoke an MCP tool directly by its tool name (e.g. `mcp__<server>__<tool>`) only when the selected host adapter exposes it. Do not call an MCP tool name through a shell.
+- **CLI-wrapper assignments**: use only the MCP or tool configuration explicitly supported and forwarded by that provider wrapper. If the wrapper has no matching MCP configuration, record `MCP not available in this CLI` in `Missing Information or Assumptions`; do not attempt a shell fallback.
 - All workers: cite the exact server, tool, and SELECT (or `WHERE` filters) used in the result file. Tool-call failures must be logged in the worker's `*-errors.json` (commandKind `mcp_call`) so the lead can decide whether to retry under a different worker.
 
 Usage policy:
 
 - **Allowed phases**: `requirements-discovery`, `error-analysis`, `implementation-planning`, `final-verification`. Use only when local schema/data evidence improves the answer. Always cite the server, table, and the SELECT used as evidence in worker output.
 - **`implementation` phase**: read-only MCP queries are permitted as cross-checks; MCP MUST NOT be used as a write path even if a write tool becomes available — schema/data mutations belong in the codebase migration files reviewed by humans.
-- **External CLI workers (Codex, Antigravity)**: can use these MCP servers ONLY if their CLI's own MCP configuration is set up to mirror the same servers. If not configured, the worker should record `MCP not available in this CLI` in `Missing Information or Assumptions` rather than guessing.
+- **CLI-wrapper workers**: can use these MCP servers only if their provider CLI configuration mirrors the same servers. If not configured, the worker should record `MCP not available in this CLI` in `Missing Information or Assumptions` rather than guessing.
 - **Forbidden**: connecting to non-listed databases, running anything that mutates state (server is read-only — flagged write attempts are a contract violation), persisting query results outside the run's own artifact directories.
 - **Limits**: `maxRows: 1000` per query (server-enforced). For larger scans, page via `WHERE` predicates and document the strategy.
 
 If MCP evidence contradicts a claim sourced from documentation, code, or prior reports, flag the conflict explicitly in the final report and prefer the live MCP evidence unless the brief says otherwise.
 
-## Notes for Main Claude
+## Notes for Okstra Lead
 
 - Which workers should be used?
 - Should all workers receive the same brief or different emphasis?

package/runtime/validators/validate-report-views.py

@@ -23,6 +23,8 @@ per line to stderr.
 from __future__ import annotations
 
 import argparse
+import hashlib
+import json
 import re
 import sys
 from pathlib import Path
@@ -43,6 +45,8 @@ from okstra_ctl.report_views import (  # noqa: E402
     source_digest,
 )
 from okstra_ctl.report_view_artifacts import html_view_path  # noqa: E402
+from okstra_ctl.final_report_paths import final_report_data_path  # noqa: E402
+from okstra_ctl.report_contract import TASK_TYPE_REQUIRED_HUMAN_FIELDS  # noqa: E402
 
 
 _EXTERNAL_URL_RE = re.compile(
@@ -66,11 +70,86 @@ _ANALYSIS_REVIEW_STATUSES = ["accepted", "rejected", "revision-requested"]
 
 
 def _main_body(html_text: str) -> str:
-    start = html_text.find("<main>")
-    end = html_text.find("</main>", start) if start >= 0 else -1
-    if start < 0 or end < 0:
+    match = re.search(r"<main[^>]*>(?P<body>.*?)</main>", html_text, re.DOTALL)
+    if match is None:
         return html_text
-    return html_text[start + len("<main>"): end]
+    return match.group("body")
+
+
+def _sha256(path: Path) -> str:
+    return hashlib.sha256(path.read_bytes()).hexdigest()
+
+
+def _digest_from_run_meta(html_text: str, key: str) -> str:
+    match = re.search(rf'"{re.escape(key)}"\s*:\s*"([0-9a-f]{{64}})"', html_text)
+    return match.group(1) if match else ""
+
+
+def _load_v2_data(report_path: Path) -> tuple[Path, dict] | None:
+    data_path = final_report_data_path(report_path)
+    if not data_path.is_file():
+        return None
+    try:
+        data = json.loads(data_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+    if isinstance(data, dict) and data.get("schemaVersion") == "2.0":
+        return data_path, data
+    return None
+
+
+def _validate_v2(report_path: Path, data_path: Path, data: dict) -> list[str]:
+    html_path = html_view_path(report_path)
+    if not html_path.is_file():
+        return [f"missing html artifact: {html_path}"]
+    html_text = html_path.read_text(encoding="utf-8")
+    main_body = _main_body(html_text)
+    failures: list[str] = []
+
+    for key, path in (
+        ("source-data-sha256", data_path),
+        ("source-md-sha256", report_path),
+    ):
+        recorded = _digest_from_run_meta(html_text, key)
+        expected = _sha256(path)
+        if not recorded:
+            failures.append(f"html missing {key} in run-meta")
+        elif recorded != expected:
+            failures.append(f"stale html: {key} does not match current source")
+
+    task_type = data.get("header", {}).get("taskType", "")
+    if f'data-task-template="{task_type}"' not in html_text:
+        failures.append(f"v2 html task template mismatch for {task_type}")
+    actual_fields = set(re.findall(r'data-report-field="([^"]+)"', main_body))
+    for field in TASK_TYPE_REQUIRED_HUMAN_FIELDS.get(task_type, ()):
+        if field not in actual_fields:
+            failures.append(f"missing human field: {field}")
+
+    if "data-audit-field=" in main_body:
+        failures.append("audit field inside human main")
+    node_ids = set(re.findall(r'data-node-id="([^"]+)"', html_text))
+    fallback_ids = set(re.findall(r'data-fallback-id="([^"]+)"', html_text))
+    if node_ids != fallback_ids:
+        failures.append(
+            f"visualization ID mismatch: svg={sorted(node_ids)}, fallback={sorted(fallback_ids)}"
+        )
+
+    data_ids = []
+    for row in data.get("clarificationItems", []):
+        if not isinstance(row, dict):
+            continue
+        response_id = row.get("id")
+        if isinstance(response_id, str) and re.fullmatch(r"C-\d+", response_id):
+            data_ids.append(response_id)
+    data_ids.sort()
+    html_ids = sorted(set(_RESPONSE_ID_ATTR_RE.findall(html_text)))
+    if data_ids != html_ids:
+        failures.append(
+            f"Response ID mismatch: data.json has {data_ids}, HTML has {html_ids}"
+        )
+    if _EXTERNAL_URL_RE.search(html_text):
+        failures.append("html contains external URL in script/link/img — must be self-contained")
+    return failures
 
 
 def _no_form_sections(html_body: str) -> list[str]:
@@ -128,6 +207,9 @@ def validate(report_path: Path) -> list[str]:
         return [f"final-report not found: {report_path}"]
 
     md = report_path.read_text(encoding="utf-8")
+    v2 = _load_v2_data(report_path)
+    if v2 is not None:
+        return _validate_v2(report_path, v2[0], v2[1])
     html_path = html_view_path(report_path)
     # §1 헤딩이 있는데 파싱이 실패하면 md_ids 가 빈 []이 되어 "clarification 없음
     # → skip" 으로 흘러 HTML form parity 게이트가 조용히 열린다. fail-closed.