okstra 0.147.0 → 0.148.0

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

@@ -6,34 +6,34 @@
 <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") }}
+  {{ 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") }}
+  {{ 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") }}
+  {{ 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 }}</p><p><strong>담당:</strong> {{ row.owner }}</p><p><strong>상향 조건:</strong> {{ row.escalationTrigger }}</p></article>{% else %}<p>기록된 잔여 위험이 없습니다.</p>{% endfor %}</div>
+  <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 }} · {{ row.result }}</h3><p>{{ row.performed }}</p><p>{{ row.observed }}</p></article>{% endfor %}{% else %}<p>{{ final.manualUserTest.exemptionReaffirm }}</p>{% endif %}
+  {% 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") }}
-  {% if releaseAllowed %}<p>{{ final.routingRecommendation }}</p>{% else %}<p>현재 판정으로는 release-handoff를 시작할 수 없습니다. 차단 또는 조건을 먼저 해소하세요.</p>{% endif %}
+  {{ 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

@@ -6,35 +6,35 @@
 {% block human_content %}
 <section data-report-section="planning-goal">
   <h2>계획 목표</h2>
-  <p>{{ humanSummary.outcome }}</p>
-  <div class="summary-grid">{% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가", reason, "important") }}{% endfor %}</div>
+  <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") }}
-  <div class="summary-grid" data-report-field="implementationPlanning.optionCandidates">{% for row in planning.optionCandidates %}<article class="summary-card"><h3>{{ row.name }}</h3><p><strong>인터페이스:</strong> {{ row.interfaces }}</p><p><strong>영향 범위:</strong> {{ row.blastRadius }}</p><ul>{% for file in row.fileStructure %}<li>{{ file.action }} <code>{{ file.path }}</code> — {{ file.summary }}</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 }}</td><td>{{ row.complexity }}</td><td>{{ row.risk }}</td><td>{{ row.reversibility }}</td><td>{{ row.testCoverageCost }}</td><td>{{ row.rolloutCost }}</td></tr>{% endfor %}</tbody></table>
+  {{ 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") }}
-  <article class="summary-card tone-important"><h3>{{ planning.recommendedOption.name }}</h3><p>{{ planning.recommendedOption.coreReason }}</p><p>{{ planning.recommendedOption.rationale }}</p><p><strong>선택하지 않은 안:</strong> {{ planning.recommendedOption.rejectedSummary }}</p></article>
+  {{ 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") }}
+  {{ 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 }}</h3><p>{{ row.sliceValue }}</p><p><strong>완료 조건:</strong> {{ row.acceptance }}</p><p><strong>검증:</strong> {{ row.stageValidation }}</p></article>{% endfor %}</div>
+  <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") }}
-  <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 }}</td><td><code>{{ row.commandOrObservation }}</code></td><td>{{ row.expectedOutcome }}</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, row.action, "important") }}{% endfor %}</div>
+  {{ 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">

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

@@ -5,36 +5,36 @@
 {% block human_content %}
 <section data-report-section="delivered-outcome">
   <h2>전달된 결과</h2>
-  {{ render_narrative(narrative.deliveredOutcome, "implementation.userNarrative.deliveredOutcome") }}
-  <p>{{ humanSummary.outcome }}</p>
+  {{ 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") }}
+  {{ 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 }}</td><td>{{ row.coveredBy }}</td><td><span class="status status-{{ row.status }}">{{ row.status }}</span></td></tr>{% endfor %}</tbody></table>
+  <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") }}
+  {{ 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") }}
+  {{ 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 }}</h3><p><strong>환경:</strong> {{ row.environmentSetup }}</p><ol>{% for step in row.steps %}<li>{{ step }}</li>{% endfor %}</ol><p><strong>기대 결과:</strong> {{ row.expectedResult }}</p></article>{% endfor %}{% else %}<p>{{ implementation.manualUserTest.exemptionReason }}</p>{% endif %}
+  {% 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

@@ -5,14 +5,14 @@
 {% block human_content %}
 <section data-report-section="opportunities">
   <h2>발견한 개선 기회</h2>
-  {{ render_narrative(narrative.opportunityOverview, "improvementDiscovery.userNarrative.opportunityOverview") }}
-  <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 }}</td><td>{{ row.evidence | join(', ') }}</td></tr>{% endfor %}</tbody></table>
+  {{ 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") }}
-  <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 }}</h3><p>{{ row.expectedBehaviorAfter }}</p><p><strong>다음 단계:</strong> {{ row.recommendedNextPhase }}</p><p class="evidence-refs">근거: {{ row.evidence | join(', ') }}</p></article>{% else %}<p>선택할 개선 후보가 없습니다.</p>{% endfor %}</div>
+  {{ 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">
@@ -22,8 +22,8 @@
 
 <section data-report-section="selection">
   <h2>선택 안내</h2>
-  {{ render_narrative(narrative.selectionGuidance, "improvementDiscovery.userNarrative.selectionGuidance") }}
+  {{ 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 }}</label></li>{% endfor %}</ul>
+  <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

@@ -5,15 +5,15 @@
 {% block human_content %}
 <section data-report-section="project-overview">
   <h2>프로젝트 개요</h2>
-  {{ render_narrative(narrative.projectOverview, "projectAnalysis.userNarrative.projectOverview") }}
+  {{ render_narrative(narrative.projectOverview, "projectAnalysis.userNarrative.projectOverview", evidenceIndex) }}
   <div class="summary-grid">
-    {% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가", reason, "important") }}{% endfor %}
+    {% 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") }}
+  {{ render_narrative(narrative.architectureExplanation, "projectAnalysis.userNarrative.architectureExplanation", evidenceIndex) }}
   {{ figure(architectureFigure) }}
 </section>
 
@@ -23,35 +23,35 @@
     {% 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 }}</strong> — {{ row.readBoundary }} / {{ row.writeBoundary }}</li>{% endfor %}</ul>
+  <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 }}</strong> — {{ row.adapter }} ({{ row.direction }})</li>{% endfor %}</ul>
+  <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") }}
+  {{ 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 }}</h3><p>{{ row.reason }}</p><p class="evidence-refs">근거: {{ row.evidenceRefs | join(', ') }}</p></article>
+    <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") }}
-  <table><thead><tr><th>영역</th><th>상태</th><th>설명</th><th>근거</th></tr></thead><tbody>{% for row in project.qualityCoverage %}<tr><td>{{ row.area }}</td><td><span class="status status-{{ row.status }}">{{ row.status }}</span></td><td>{{ row.summary }}</td><td>{{ row.evidenceRefs | join(', ') }}</td></tr>{% endfor %}</tbody></table>
+  {{ 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, row.description) }}{% endfor %}</div>
+  <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 }}</li>{% endfor %}</ul>{% endif %}
+  {% 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

@@ -5,7 +5,7 @@
 {% block human_content %}
 <section data-report-section="handoff-outcome">
   <h2>인계 결과</h2>
-  {{ render_narrative(narrative.handoffOutcome, "releaseHandoff.userNarrative.handoffOutcome") }}
+  {{ render_narrative(narrative.handoffOutcome, "releaseHandoff.userNarrative.handoffOutcome", evidenceIndex) }}
   {{ figure(handoffFigure) }}
 </section>
 
@@ -16,21 +16,21 @@
 
 <section data-report-section="branch-and-pr" data-report-field="releaseHandoff.featureBranchState">
   <h2>브랜치와 PR</h2>
-  {{ render_narrative(narrative.branchAndPrExplanation, "releaseHandoff.userNarrative.branchAndPrExplanation") }}
+  {{ 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") }}
+  {{ 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") }}
-  <p>{{ handoff.routingRecommendation }}</p>
+  {{ 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

@@ -5,26 +5,26 @@
 {% block human_content %}
 <section data-report-section="request">
   <h2>요청 이해</h2>
-  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding") }}
+  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding", evidenceIndex) }}
   <h3>사용자 요청 원문</h3>
-  <p data-report-field="requirementsDiscovery.requestVerbatim">{{ requirements.requestVerbatim }}</p>
+  <p data-report-field="requirementsDiscovery.requestVerbatim">{{ requirements.requestVerbatim | inline_code }}</p>
   <h3>시스템 해석</h3>
-  <p data-report-field="requirementsDiscovery.systemInterpretation">{{ requirements.systemInterpretation }}</p>
-  <dl data-report-field="requirementsDiscovery.classification">{% for key, value in requirements.classification.items() %}<dt>{{ key }}</dt><dd>{{ value }}</dd>{% endfor %}</dl>
+  <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") }}
+  {{ 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") }}
+  {{ 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") }}
-  <p><strong>다음 태스크:</strong> {{ requirements.routing.nextTaskType }} · {{ requirements.routing.rationale }}</p>
+  {{ 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>

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-run.py

@@ -51,6 +51,7 @@ from okstra_ctl.conformance import (  # noqa: E402
     validate_conformance_manifest,
 )
 from okstra_ctl.paths import RunRef  # noqa: E402
+from okstra_ctl.lead_runtime import ARTIFACT_ONLY_LEAD_RUNTIMES  # noqa: E402
 from okstra_ctl.build_tools import (  # noqa: E402
     command_invokes_build_tool,
     resolve_build_tool_tokens,
@@ -156,7 +157,7 @@ def _session_accounting(team_state: dict) -> str:
         return value
     return (
         "artifact-only"
-        if team_state.get("leadRuntime") in {"codex", "external"}
+        if team_state.get("leadRuntime") in ARTIFACT_ONLY_LEAD_RUNTIMES
         else "claude-jsonl"
     )
 
@@ -415,20 +416,24 @@ def extract_contract(
         required_worker_roles = []
         failures.append("requiredWorkerRoles is missing from run/task manifest")
 
+    lead_role = (
+        run_contract.get("leadRole")
+        or task_contract.get("leadRole")
+        or "Okstra lead"
+    )
+
     required_agent_status_entries = run_contract.get("requiredAgentStatusEntries")
     if not isinstance(required_agent_status_entries, list):
         required_agent_status_entries = task_contract.get("requiredAgentStatusEntries")
     if not isinstance(required_agent_status_entries, list):
-        required_agent_status_entries = ["Claude lead"] + [
+        required_agent_status_entries = [lead_role] + [
             item.get("role", "")
             for item in required_worker_roles
             if isinstance(item, dict) and item.get("role")
         ]
 
     return {
-        "lead_role": run_contract.get("leadRole")
-        or task_contract.get("leadRole")
-        or "Claude lead",
+        "lead_role": lead_role,
         "lead_agent": run_contract.get("leadAgent")
         or task_contract.get("leadAgent")
         or "claude",
@@ -722,7 +727,7 @@ def validate_team_state(
         dispatch_mode = str(team_state.get("dispatchMode", "")).strip()
         if (
             dispatch_mode in WORKER_DISPATCH_MODES
-            or team_state.get("leadRuntime") in {"codex", "external"}
+            or team_state.get("leadRuntime") in ARTIFACT_ONLY_LEAD_RUNTIMES
         ):
             if dispatch_mode not in WORKER_DISPATCH_MODES:
                 expected = ", ".join(sorted(WORKER_DISPATCH_MODES))

package/runtime/validators/validate_session_conformance.py

@@ -38,6 +38,7 @@ from okstra_ctl.worker_heartbeat import (  # noqa: E402
     HEARTBEAT_LINE_RE,
     max_gap_seconds_after,
 )
+from okstra_ctl.lead_runtime import ARTIFACT_ONLY_LEAD_RUNTIMES  # noqa: E402
 from okstra_ctl.wrapper_status import read_wrapper_status  # noqa: E402
 
 _DISPATCHED_STATUSES = {"completed", "timeout", "error", "in-progress"}
@@ -366,7 +367,7 @@ def _conformance_evidence_source(
             return None, f"unsupported sessionAccounting: `{accounting}`"
 
     legacy_runtime = str(team_state.get("leadRuntime", "") or "claude-code")
-    if legacy_runtime in {"codex", "external"}:
+    if legacy_runtime in ARTIFACT_ONLY_LEAD_RUNTIMES:
         return "artifact-only", None
     return "claude-jsonl", None
 

package/src/cli-registry.mjs

@@ -415,18 +415,18 @@ export const COMMANDS = new Map(
   ]),
 );
 
-const PREAMBLE = `okstra — multi-agent cross-verification orchestrator for Claude Code
+const PREAMBLE = `okstra — host-aware multi-provider cross-verification orchestrator
 
 This CLI is the installer/admin tool. Day-to-day usage happens inside a
-Claude Code session via slash commands (/okstra-setup, /okstra-run, ...).
+supported agent host through installed skills (okstra-setup, okstra-run, ...).
 
 Quick start (CLI):
   1. npx -y okstra@latest install                       # one-time, this machine
   2. cd <your project>
   3. npx -y okstra@latest setup --project-id <id>       # one-time, this project
-  4. open a Claude Code session and run /okstra-run     # start a task
+  4. open Claude Code, Codex, or Antigravity and run okstra-run  # start a task
 
-Inside a Claude Code session you can replace step 3 with /okstra-setup —
+Inside a supported agent host you can replace step 3 with okstra-setup —
 both write the same <PROJECT_ROOT>/.okstra/project.json.
 
 Usage:

package/src/commands/execute/codex-dispatch.mjs

@@ -5,18 +5,15 @@ const USAGE = `okstra codex-dispatch — dispatch CLI-backed workers for a prepa
 
 Usage:
   okstra codex-dispatch --project-root <dir> --run-manifest <path> \\
-    [--workers codex[,antigravity[,report-writer]]] [--dry-run] \\
-    [--idle-timeout-seconds <n>] \\
-    [--enable-codex-report-writer --report-writer-codex-model <model>]
+    [--workers <cli-assigned-worker-ids>] [--dry-run] \\
+    [--idle-timeout-seconds <n>]
 
 This command reads an existing run manifest produced by 'okstra codex-run' and
-dispatches only Codex-side supported workers. When --workers is omitted, the
-command selects the supported subset of the run roster (codex/antigravity, plus
-report-writer only when explicitly opted in). Codex and antigravity use their
-existing wrappers. The report-writer role is available only through explicit
-Codex opt-in because the prepared manifest still records the Claude-side report
-writer model by default. Explicitly requesting unsupported workers such as
-claude fails.
+dispatches only assignments whose persisted runner is 'cli-wrapper'. When
+--workers is omitted, it selects that subset from the run roster. Each worker,
+including report-writer, uses its persisted provider, model, and registered
+wrapper. Native-session assignments remain owned by the current Codex host;
+explicitly requesting one here fails.
 
 Missing worker prompt files are generated automatically from the run manifest
 and active-run-context. Existing prompt files are never overwritten.

package/src/commands/execute/render-bundle.mjs

@@ -2,7 +2,7 @@ import { runPythonModule } from "../../lib/python-helper.mjs";
 import { resolvePaths } from "../../lib/paths.mjs";
 import { resolveRuntime } from "../../lib/runtime-resolver.mjs";
 
-const USAGE = `okstra render-bundle — preview the task bundle without launching claude
+const USAGE = `okstra render-bundle — preview the task bundle without launching a lead
 
 This is a thin shim over \`python3 -m okstra_ctl.run\` that forces
 \`--render-only\`. Use it to preview where prepare_task_bundle() would
@@ -18,7 +18,7 @@ Usage:
     [--analysis-target <text>] [--evidence-inputs <csv>] \\
     [--lead-model <m>] [--claude-model <m>] [--codex-model <m>] \\
     [--antigravity-model <m>] [--report-writer-model <m>] \\
-    [--lead-runtime claude-code|codex] \\
+    [--lead-runtime claude-code|codex|antigravity|external] \\
     [--related-tasks <list>] [--base-ref <ref>] \\
     [--clarification-response <path>] [--work-category <cat>] \\
     [--stage <auto|N>] [--stages <csv>] [--pr-template-path <path>] \\
@@ -26,7 +26,7 @@ Usage:
 
   --stage             implementation / final-verification only
   --stages            release-handoff only: PR stage bundle csv (empty = whole-task)
-  --lead-runtime      lead adapter marker; codex is render-only in this version
+  --lead-runtime      host-native lead adapter marker
   --pr-template-path  release-handoff only
   --fix-cycle         entry phase only: record this re-entry of a done task as a
                       bug-fix cycle (yes opens/continues the cycle)