okstra 0.148.1 → 0.150.0

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

@@ -1,57 +1,97 @@
 {% extends "html/base.template.html" %}
-{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card, row_key %}
 {% 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) }}
+  <h2>{{ t('tasks.project-analysis.project-overview') }}</h2>
+  {{ render_narrative(narrative.projectOverview, "projectAnalysis.userNarrative.projectOverview") }}
   <div class="summary-grid">
-    {% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가 " ~ loop.index, reason, "important") }}{% endfor %}
+    {% for reason in humanSummary.whyItMatters %}{{ summary_card("", 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) }}
+  <h2>{{ t('tasks.project-analysis.architecture-and-dependencies') }}</h2>
+  {{ render_narrative(narrative.architectureExplanation, "projectAnalysis.userNarrative.architectureExplanation") }}
+  {{ figure(architectureFigure, anchor_nodes=true) }}
 </section>
 
+<section data-report-section="infrastructure">
+  <h2>{{ t('tasks.project-analysis.infrastructure') }}</h2>
+  {{ figure(infrastructureFigure) }}
+</section>
+
+{% if project.get("techStack") %}
+<section data-report-section="tech-stack" data-report-field="projectAnalysis.techStack">
+  <h2>{{ t('tasks.project-analysis.tech-stack') }}</h2>
+  <h3>{{ t('tasks.project-analysis.language') }}</h3>
+  <table><thead><tr><th>{{ t('tasks.project-analysis.language') }}</th><th>{{ t('tasks.project-analysis.version') }}</th><th>{{ t('tasks.project-analysis.version-source') }}</th><th>{{ t('tasks.project-analysis.files') }}</th><th>{{ t('tasks.project-analysis.lines') }}</th></tr></thead><tbody>{% for row in project.techStack.languages %}<tr><td>{{ row.name | inline_code }}</td><td><code>{{ row.version }}</code></td><td>{{ row.versionSource | enum_label("versionSource") }}</td><td>{{ row.get("fileCount") | default("--") }}</td><td>{{ row.get("lineCount") | default("--") }}</td></tr>{% endfor %}</tbody></table>
+  {% if project.techStack.get("frameworks") %}<h3>{{ t('tasks.project-analysis.framework') }}</h3>
+  <table><thead><tr><th>{{ t('tasks.project-analysis.framework') }}</th><th>{{ t('tasks.project-analysis.role') }}</th><th>{{ t('tasks.project-analysis.evidence') }}</th></tr></thead><tbody>{% for row in project.techStack.frameworks %}<tr>{{ row_key(pairs=[("Name", row.name), ("Version", row.version), ("Version source", row.versionSource | enum_label("versionSource"))]) }}<td>{{ row.role | inline_code }}</td><td>{{ row.get("currentCodeEvidence") | default([]) | code_evidence }}</td></tr>{% endfor %}</tbody></table>{% endif %}
+  {% if project.techStack.get("toolchain") %}<h3>{{ t('tasks.project-analysis.tool') }}</h3>
+  <table><thead><tr><th>{{ t('tasks.project-analysis.tool') }}</th><th>{{ t('tasks.project-analysis.command') }}</th></tr></thead><tbody>{% for row in project.techStack.toolchain %}<tr>{{ row_key(pairs=[("Name", row.name), ("Kind", row.kind | enum_label("toolKind")), ("Version", row.get("version"))]) }}<td>{% if row.get("command") %}<code>{{ row.command }}</code>{% else %}--{% endif %}</td></tr>{% endfor %}</tbody></table>{% endif %}
+</section>
+{% endif %}
+
+{% if project.get("internalInterfaces") %}
+<section data-report-section="internal-interfaces" data-report-field="projectAnalysis.internalInterfaces">
+  <h2>{{ t('tasks.project-analysis.internal-interfaces') }}</h2>
+  <table><thead><tr><th>{{ t('tasks.project-analysis.interface') }}</th><th>{{ t('tasks.project-analysis.signature') }}</th><th>{{ t('tasks.project-analysis.consumers') }}</th><th>{{ t('tasks.project-analysis.evidence') }}</th></tr></thead><tbody>{% for row in project.internalInterfaces %}<tr id="id-{{ row.id }}">{{ row_key(pairs=[("ID", row.id), ("Name", row.name), ("Kind", row.kind | enum_label("interfaceKind")), ("Owner", row.ownerComponentId)]) }}<td><code>{{ row.signature }}</code></td><td>{{ (row.get("consumers") | default([])) | join(", ") | inline_code }}</td><td>{{ row.get("currentCodeEvidence") | default([]) | code_evidence }}</td></tr>{% endfor %}</tbody></table>
+</section>
+{% endif %}
+
+{% if project.get("workflows") %}
+<section data-report-section="workflows" data-report-field="projectAnalysis.workflows">
+  <h2>{{ t('tasks.project-analysis.workflows') }}</h2>
+  {{ figure(workflowFigure) }}
+  {% for flow in project.workflows %}
+  <article class="workflow" id="id-{{ flow.id }}">
+    <p class="eyebrow">{{ flow.id }}</p>
+    <h3>{{ flow.name | inline_code }}</h3>
+    <p><strong>{{ t('tasks.project-analysis.starts-with') }}</strong> — {{ flow.trigger | inline_code }}{% if flow.get("outcome") %} · <strong>{{ t('tasks.project-analysis.result') }}</strong> — {{ flow.outcome | inline_code }}{% endif %}</p>
+    <table><thead><tr><th>{{ t('tasks.project-analysis.order') }}</th><th>{{ t('tasks.project-analysis.action') }}</th><th>{{ t('tasks.project-analysis.component') }}</th><th>{{ t('tasks.project-analysis.external-system') }}</th></tr></thead><tbody>{% for step in flow.steps %}<tr><td>{{ step.order }}</td><td>{{ step.action | inline_code }}</td><td>{{ step.componentId | inline_code }}</td><td>{% if step.get("externalSystem") %}{{ step.externalSystem | inline_code }}{% else %}--{% endif %}</td></tr>{% endfor %}</tbody></table>
+  </article>
+  {% endfor %}
+</section>
+{% endif %}
+
 <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>
+  <h2>{{ t('tasks.project-analysis.system-boundaries') }}</h2>
+  <p class="scan-coverage" data-report-field="projectAnalysis.scanCoverage"><strong>{{ project.scanCoverage.scannedPathCount }}</strong> {{ t('tasks.project-analysis.paths-read') }} <strong>{{ project.scanCoverage.unscannedPathCount }}</strong> left unread — {{ project.scanCoverage.reason | inline_code }}</p>
+  <h3>{{ t('tasks.project-analysis.entry-point') }}</h3>
+  <table data-report-field="projectAnalysis.entryPoints"><thead><tr><th>{{ t('tasks.project-analysis.entry-point') }}</th><th>{{ t('tasks.project-analysis.path') }}</th><th>{{ t('tasks.project-analysis.role') }}</th></tr></thead><tbody>{% for row in project.entryPoints %}<tr>{{ row_key(pairs=[("Symbol", row.symbol), ("Kind", row.kind)]) }}<td><code>{{ row.path }}</code></td><td>{{ row.role | inline_code }}</td></tr>{% endfor %}</tbody></table>
+  <h3>{{ t('tasks.project-analysis.data-stores') }}</h3>
+  <table data-report-field="projectAnalysis.dataStores"><thead><tr><th>{{ t('tasks.project-analysis.store') }}</th><th>{{ t('tasks.project-analysis.reads') }}</th><th>{{ t('tasks.project-analysis.writes') }}</th><th>{{ t('tasks.project-analysis.evidence') }}</th></tr></thead><tbody>{% for row in project.dataStores %}<tr>{{ row_key(pairs=[("Name", row.name), ("Owner", row.ownerComponentId)]) }}<td>{{ row.readBoundary | inline_code }}</td><td>{{ row.writeBoundary | inline_code }}</td><td>{{ row.currentCodeEvidence | code_evidence }}</td></tr>{% endfor %}</tbody></table>
+  <h3>{{ t('tasks.project-analysis.external-system') }}</h3>
+  <table data-report-field="projectAnalysis.externalSystems"><thead><tr><th>{{ t('tasks.project-analysis.external-system') }}</th><th>{{ t('tasks.project-analysis.evidence') }}</th></tr></thead><tbody>{% for row in project.externalSystems %}<tr>{{ row_key(pairs=[("Name", row.name), ("Adapter", row.adapter), ("Direction", row.direction)]) }}<td>{{ row.currentCodeEvidence | code_evidence }}</td></tr>{% endfor %}</tbody></table>
 </section>
 
 <section data-report-section="hotspots" data-report-field="projectAnalysis.rankedHotspots">
-  <h2>우선 검토할 핫스팟</h2>
-  {{ render_narrative(narrative.hotspotExplanation, "projectAnalysis.userNarrative.hotspotExplanation", evidenceIndex) }}
+  <h2>{{ t('tasks.project-analysis.hotspots-to-look-at-first') }}</h2>
+  {{ render_narrative(narrative.hotspotExplanation, "projectAnalysis.userNarrative.hotspotExplanation") }}
   <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>
+    <article class="summary-card tone-{{ row.risk }}" id="id-{{ row.id }}"><p class="eyebrow">{{ row.id }} · Impact {{ row.impact }} · Risk {{ row.risk }}</p><h3>{{ row.title | inline_code }}</h3><p>{{ row.reason | inline_code }}</p><p class="evidence-refs">Evidence: {{ row.evidenceRefs | evidence_refs }}</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>
+  <h2>{{ t('tasks.project-analysis.quality-and-test-coverage') }}</h2>
+  {{ render_narrative(narrative.qualityExplanation, "projectAnalysis.userNarrative.qualityExplanation") }}
+  <table><thead><tr><th>{{ t('tasks.project-analysis.area') }}</th><th>{{ t('tasks.project-analysis.detail') }}</th><th>{{ t('tasks.project-analysis.evidence') }}</th></tr></thead><tbody>{% for row in project.qualityCoverage %}<tr id="id-{{ row.id }}">{{ row_key(pairs=[("ID", row.id), ("Area", row.area)], status_name="Status", status_raw=row.status, status_text=row.status | enum_label("coverage")) }}<td>{{ row.summary | inline_code }}</td><td>{{ row.evidenceRefs | evidence_refs }}</td></tr>{% endfor %}</tbody></table>
+  <dl class="enum-legend">{% for label, hint in "coverage" | enum_legend %}<dt>{{ label }}</dt><dd>{{ hint }}</dd>{% endfor %}</dl>
 </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>
+  <h2>{{ t('tasks.project-analysis.feature-map') }}</h2>
+  <div class="summary-grid">{% for row in project.featureIndex %}{{ summary_card(row.id ~ " · " ~ (row.name | inline_code), row.description, anchor=row.id) }}{% endfor %}</div>
 </section>
 
 <section data-report-section="user-actions">
-  <h2>다음 행동</h2>
+  <h2>{{ t('tasks.project-analysis.what-to-do-next') }}</h2>
   {{ action_list(humanSummary.actions) }}
-  {% if humanSummary.blockers %}<h3>차단 사항</h3><ul>{% for item in humanSummary.blockers %}<li>{{ item | inline_code }}</li>{% endfor %}</ul>{% endif %}
+  {% if humanSummary.blockers %}<h3>{{ t('tasks.project-analysis.blockers') }}</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

@@ -1,36 +1,50 @@
 {% extends "html/base.template.html" %}
-{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card, row_key %}
 {% 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) }}
+  <h2>{{ t('tasks.release-handoff.handoff-outcome') }}</h2>
+  {{ render_narrative(narrative.handoffOutcome, "releaseHandoff.userNarrative.handoffOutcome") }}
   {{ figure(handoffFigure) }}
 </section>
 
+{% if handoff.get("handoffScope") %}
+<section data-report-section="handoff-scope" data-report-field="releaseHandoff.handoffScope">
+  <h2>{{ t('tasks.release-handoff.handoff-scope') }}</h2>
+  <p><strong>{{ handoff.handoffScope.mode | enum_label("handoffMode") }}</strong>{% if handoff.handoffScope.get("stages") %} — stages {{ handoff.handoffScope.stages | join(", ") }}{% endif %}{% if handoff.handoffScope.get("collectorBranch") %} · Collector branch <code>{{ handoff.handoffScope.collectorBranch }}</code>{% endif %}</p>
+</section>
+{% endif %}
+
 <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>
+  <h2>{{ t('tasks.release-handoff.the-behaviour-you-chose') }}</h2>
+  <dl><dt>{{ t('tasks.release-handoff.handoff-mode') }}</dt><dd>{{ handoff.userSelections.h1 }}</dd><dt>{{ t('tasks.release-handoff.conflict-check') }}</dt><dd>{{ handoff.userSelections.h2b }}</dd><dt>{{ t('tasks.release-handoff.pr-body') }}</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>
+  <h2>{{ t('tasks.release-handoff.branch-and-pr') }}</h2>
+  {{ render_narrative(narrative.branchAndPrExplanation, "releaseHandoff.userNarrative.branchAndPrExplanation") }}
+  <p><strong>{{ t('tasks.release-handoff.branch') }}</strong> {{ handoff.featureBranchState.branchName }}</p>
+  <p data-report-field="releaseHandoff.pullRequestOutcome"><strong>{{ t('tasks.release-handoff.pr-result') }}</strong> {{ handoff.pullRequestOutcome.kind }}{% if prUrl %} · <a href="{{ prUrl }}" rel="noopener noreferrer">{{ t('tasks.release-handoff.pull-request-open') }}</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'))) }}
+  <h2>{{ t('tasks.release-handoff.conflict-verdict') }}</h2>
+  {{ render_narrative(narrative.conflictExplanation, "releaseHandoff.userNarrative.conflictExplanation") }}
+  {{ summary_card(handoff.mergeConflictProbe.kind, "Base branch: " ~ (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="delivered-commits" data-report-field="releaseHandoff.commitList">
+  <h2>{{ t('tasks.release-handoff.commits-delivered') }}</h2>
+  {% if handoff.commitList is mapping %}<p>{{ t('tasks.release-handoff.there-are-no-commits') }}</p>{% else %}
+  <table><thead><tr><th>{{ t('tasks.release-handoff.commit') }}</th><th>{{ t('tasks.release-handoff.subject') }}</th><th>{{ t('tasks.release-handoff.files') }}</th></tr></thead><tbody>{% for row in handoff.commitList %}<tr>{{ row_key(pairs=[("SHA", row.shortSha), ("Order", loop.index)]) }}<td>{{ row.subject | inline_code }}</td><td>{% for file in row.files %}<code>{{ file }}</code>{% if not loop.last %} {% endif %}{% endfor %}</td></tr>{% endfor %}</tbody></table>{% endif %}
+  <p data-report-field="releaseHandoff.sourceVerificationReport"><strong>{{ t('tasks.release-handoff.the-verification-report-this-rests-on') }}</strong> — <code>{{ handoff.sourceVerificationReport.path }}</code> · {{ handoff.sourceVerificationReport.verdictTokenQuote | inline_code }}</p>
+</section>
+
 <section data-report-section="next-action">
-  <h2>다음 행동</h2>
-  {{ render_narrative(narrative.nextAction, "releaseHandoff.userNarrative.nextAction", evidenceIndex) }}
+  <h2>{{ t('tasks.release-handoff.what-to-do-next') }}</h2>
+  {{ render_narrative(narrative.nextAction, "releaseHandoff.userNarrative.nextAction") }}
   <p>{{ handoff.routingRecommendation | inline_code }}</p>
 </section>
 {% endblock %}

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

@@ -4,34 +4,54 @@
 
 {% block human_content %}
 <section data-report-section="request">
-  <h2>요청 이해</h2>
-  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding", evidenceIndex) }}
-  <h3>사용자 요청 원문</h3>
+  <h2>{{ t('tasks.requirements-discovery.the-request-as-understood') }}</h2>
+  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding") }}
+  <h3>{{ t('tasks.requirements-discovery.your-request-verbatim') }}</h3>
   <p data-report-field="requirementsDiscovery.requestVerbatim">{{ requirements.requestVerbatim | inline_code }}</p>
-  <h3>시스템 해석</h3>
+  <h3>{{ t('tasks.requirements-discovery.how-the-system-reads-it') }}</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>
 
+{% if requirements.get("rejectionCriteria") %}
+<section data-report-section="rejection-criteria" data-report-field="requirementsDiscovery.rejectionCriteria">
+  <h2>{{ t('tasks.requirements-discovery.what-would-prove-this-wrong') }}</h2>
+  {% if requirements.rejectionCriteria.source == "absent-not-material" %}
+  <p>{{ t('tasks.requirements-discovery.the-requester-left-no-rejection-criteria-eve') }}</p>
+  {% else %}
+  <p>{{ requirements.rejectionCriteria.get("statement") | inline_code }}</p>
+  <p class="evidence-refs">Source: {{ requirements.rejectionCriteria.source | enum_label("rejectionSource") }}{% if requirements.rejectionCriteria.get("clarificationId") %} · {{ requirements.rejectionCriteria.clarificationId | inline_code }}{% endif %}{% if requirements.rejectionCriteria.get("evidenceRefs") %} · {{ requirements.rejectionCriteria.evidenceRefs | evidence_refs }}{% endif %}</p>
+  {% endif %}
+</section>
+{% endif %}
+
+{% if requirements.get("domainAlignment") %}
+<section data-report-section="domain-alignment" data-report-field="requirementsDiscovery.domainAlignment">
+  <h2>{{ t('tasks.requirements-discovery.terms-settled') }}</h2>
+  <p>Glossary {{ "checked" if requirements.domainAlignment.glossaryConsulted else "none" }} · Decision record {{ "checked" if requirements.domainAlignment.decisionsConsulted else "none" }}</p>
+  <table><thead><tr><th>{{ t('tasks.requirements-discovery.as-the-brief-put-it') }}</th><th>{{ t('tasks.requirements-discovery.settled-term') }}</th><th>{{ t('tasks.requirements-discovery.settled-by') }}</th><th>{{ t('tasks.requirements-discovery.evidence') }}</th></tr></thead><tbody>{% for row in requirements.domainAlignment.terms %}<tr><td>{{ row.raw | inline_code }}</td><td>{{ row.canonical | inline_code }}</td><td>{{ row.resolvedBy | enum_label("termSource") }}</td><td>{{ row.get("evidenceRefs") | default([]) | evidence_refs }}</td></tr>{% else %}<tr><td colspan="4">{{ t('tasks.requirements-discovery.no-term-was-ambiguous') }}</td></tr>{% endfor %}</tbody></table>
+</section>
+{% endif %}
+
 <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>
+  <h2>{{ t('tasks.requirements-discovery.settled-and-unsettled-requirements') }}</h2>
+  {{ render_narrative(narrative.confirmedRequirements, "requirementsDiscovery.userNarrative.confirmedRequirements") }}
+  <div class="summary-grid" data-report-field="requirementsDiscovery.confirmedRequirements">{% for row in requirements.confirmedRequirements %}{{ summary_card(row.id ~ " · Settled", row.statement, anchor=row.id) }}{% endfor %}</div>
+  {{ render_narrative(narrative.unresolvedRequirements, "requirementsDiscovery.userNarrative.unresolvedRequirements") }}
+  <div class="summary-grid" data-report-field="requirementsDiscovery.unresolvedRequirements">{% for row in requirements.unresolvedRequirements %}{{ summary_card(row.id ~ " · Decision needed", row.statement, "important") }}{% else %}<p>{{ t('tasks.requirements-discovery.nothing-is-left-unsettled') }}</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>
+  <h2>{{ t('tasks.requirements-discovery.next-tasks-and-dependencies') }}</h2>
+  {{ render_narrative(narrative.routingExplanation, "requirementsDiscovery.userNarrative.routingExplanation") }}
+  <p><strong>{{ t('tasks.requirements-discovery.next-task') }}</strong> {{ requirements.routing.nextTaskType }} · {{ requirements.routing.rationale | inline_code }}</p>
   {{ figure(routingFigure) }}
-  {% if not requirements.taskDependencies %}<p class="empty-state">이 요구사항 태스크는 다른 태스크에 의존하지 않는 단일 작업입니다.</p>{% endif %}
+  {% if not requirements.taskDependencies %}<p class="empty-state">{{ t('tasks.requirements-discovery.this-requirements-task-stands-alone-nothing') }}</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>
+  <h2>{{ t('tasks.requirements-discovery.decisions-that-are-yours') }}</h2>
+  <div class="summary-grid">{% for row in clarificationItems %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important") }}{% else %}<p>{{ t('tasks.requirements-discovery.no-further-decision-is-needed') }}</p>{% endfor %}</div>
   {{ action_list(humanSummary.actions) }}
 </section>
 {% endblock %}

package/runtime/templates/reports/report.js

@@ -331,10 +331,7 @@
     if (/Reader Summary|Verdict Card|Clarification Items|Recommended Next Steps|Follow-up Tasks/.test(text)) {
       return "action";
     }
-    // "토큰 사용량" 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)) {
+    if (/Evidence|Cross Verification|Execution Status|Token Usage|Plan Body Verification|Round History/.test(text)) {
       return "audit";
     }
     return "detail";
@@ -356,7 +353,13 @@
       // 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") {
+      // A section that declares its own kind wins. Heading text is a fallback:
+      // the HTML's headings render in the reader's language, so "Evidence
+      // ledger" reads as audit and "근거 대장" reads as nothing at all.
+      var declared = node.getAttribute && node.getAttribute("data-reader-kind");
+      if (declared) {
+        current = declared;
+      } else if ((node.tagName || "") === "H2") {
         current = readerSectionKind(node.textContent || "");
       }
       node.setAttribute("data-reader-section", current);

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

@@ -227,7 +227,7 @@ def validate(report_path: Path) -> list[str]:
     if not html_path.is_file():
         if (
             not md_ids
-            and plan_approval_context(report_path, md) is None
+            and plan_approval_context(report_path) is None
             and review_ctx is None
         ):
             return []

package/runtime/validators/validate-run.py

@@ -7058,42 +7058,39 @@ def _rerender_report_views_after_autofix(report_path: Path) -> str:
     """Re-render the ``*.html`` sibling against the just-substituted MD.
     Returns a short status note for the autofix message (empty on no-op,
     descriptive on failure).
+
+    Delegates to ``scripts/okstra-render-report-views.py`` rather than calling
+    a renderer directly: that script is the single reference point that routes
+    schema-v2 reports to the data.json-driven task view and schema-v1 reports
+    to the legacy markdown renderer. Rendering here would have to re-derive
+    both the routing and the run-meta, and getting either wrong overwrites a
+    schema-v2 report's HTML — the user's only way to answer its clarifications
+    — with a legacy render that carries no answer controls.
     """
+    import subprocess
+
     if not report_path.is_file():
         return ""
-    try:
-        # Late import — keeps validate-run.py importable in environments
-        # that don't ship report_views (older installs).
-        scripts_dir = Path(__file__).resolve().parent.parent / "scripts"
-        if str(scripts_dir) not in sys.path:
-            sys.path.insert(0, str(scripts_dir))
-        from okstra_ctl.report_views import RunMeta, render_html_view
-        templates_dir = (
-            Path(__file__).resolve().parent.parent / "templates" / "reports"
-        )
-        css = (templates_dir / "report.css").read_text(encoding="utf-8")
-        js = (templates_dir / "report.js").read_text(encoding="utf-8")
-    except Exception as exc:  # noqa: BLE001 — best-effort
-        return f"report-views re-render skipped ({exc})"
-
-    # Infer task-key / task-type / seq from path + body when possible;
-    # fall back to placeholders so the digest comparison (the actual
-    # contract) still works.
-    text = report_path.read_text(encoding="utf-8")
-    task_type_m = re.search(r"^- Task Type:\s*(\S+)", text, re.MULTILINE)
-    task_key_m = re.search(r"^- Task Key:\s*(\S+)", text, re.MULTILINE)
-    seq_m = re.search(r"-(\d+)\.md$", report_path.name)
-    meta = RunMeta(
-        task_key=task_key_m.group(1) if task_key_m else "unknown",
-        task_type=task_type_m.group(1) if task_type_m else "unknown",
-        seq=seq_m.group(1) if seq_m else "000",
-        source_report=report_path.name,
+    renderer = (
+        Path(__file__).resolve().parent.parent
+        / "scripts" / "okstra-render-report-views.py"
     )
+    if not renderer.is_file():
+        return f"report-views re-render skipped (renderer missing under {renderer.parent})"
     try:
-        rendered = render_html_view(report_path, run_meta=meta, css=css, js=js)
-    except Exception as exc:  # noqa: BLE001
-        return f"report-views re-render failed: {exc}"
-    if rendered is None:
+        proc = subprocess.run(
+            [sys.executable, str(renderer), str(report_path)],
+            capture_output=True,
+            text=True,
+            timeout=60,
+        )
+    except subprocess.TimeoutExpired:
+        return "report-views re-render failed: renderer timed out (60s)"
+    if proc.returncode != 0:
+        detail = (proc.stderr or proc.stdout).strip().splitlines()
+        return f"report-views re-render failed: {detail[-1] if detail else 'unknown error'}"
+    emitted = (proc.stdout or "").strip().splitlines()
+    if emitted and emitted[-1].startswith("html: skipped"):
         return "report-views skipped (no §1 clarification rows)"
     return "report-views re-rendered"
 

package/runtime/validators/validate_analysis_report.py

@@ -213,6 +213,42 @@ def _validate_project_semantics(data: dict, errors: list[str]) -> None:
                 f"projectAnalysis.featureIndex `{row.get('id') or '?'}` representative "
                 "entry point must be inside analysisCommon.scope.includedPaths"
             )
+    _validate_component_references(analysis, errors)
+
+
+def _validate_component_references(analysis: dict, errors: list[str]) -> None:
+    """Every componentId a row names has to be a component this report declares.
+
+    The reader clicks these — they render as links to the component's row — so
+    a reference to a component that was never listed is a dead anchor, and one
+    to a component that exists under a different id is worse: it reads as a
+    relationship the analysis never found.
+    """
+    declared = {
+        row.get("id")
+        for row in analysis.get("components") or []
+        if isinstance(row, dict) and row.get("id")
+    }
+    if not declared:
+        return
+
+    def check(component_id: object, where: str) -> None:
+        if isinstance(component_id, str) and component_id and component_id not in declared:
+            errors.append(f"{where} names component `{component_id}`, which is not declared")
+
+    for row in analysis.get("internalInterfaces") or []:
+        if not isinstance(row, dict):
+            continue
+        where = f"projectAnalysis.internalInterfaces `{row.get('id') or '?'}`"
+        check(row.get("ownerComponentId"), where)
+        for consumer in row.get("consumers") or []:
+            check(consumer, where)
+    for row in analysis.get("workflows") or []:
+        if not isinstance(row, dict):
+            continue
+        for step in row.get("steps") or []:
+            if isinstance(step, dict):
+                check(step.get("componentId"), f"projectAnalysis.workflows `{row.get('id') or '?'}`")
 
 
 def _validate_feature_semantics(data: dict, errors: list[str]) -> None:

package/src/cli-registry.mjs

@@ -333,6 +333,17 @@ export const COMMAND_REGISTRY = [
     category: "introspection",
     summary: ["Render slim AI + self-contained HTML views of a final report"],
   },
+  {
+    name: "report-translate",
+    module: "./commands/report/translate.mjs",
+    export: "run",
+    category: "introspection",
+    summary: [
+      "Build and verify the translation sidecar the HTML",
+      "renderer overlays when the report language is not",
+      "English (extract | check).",
+    ],
+  },
   {
     name: "report-finalize",
     module: "./commands/report/finalize.mjs",

package/src/commands/inspect/worker-liveness.mjs

@@ -3,15 +3,17 @@ import { runPythonModule } from "../../lib/python-helper.mjs";
 const USAGE = `okstra worker-liveness — report whether pending workers are still alive
 
 Usage:
-  okstra worker-liveness [--audit <path>]...
-                         [--team-state <path> --worker <worker-id>]...
+  okstra worker-liveness [--team-state <path> --worker <worker-id>]...
                          [--max-idle <seconds>] [--launch-grace <seconds>] [--json]
 
---audit   an in-process worker audit sidecar path; stale past the heartbeat cadence
-          means the worker hung.
---team-state and --worker select a CLI-wrapper assignment. No prompt sibling
-          .log or .status.json past the launch grace means the wrapper never
-          started. The grace begins at workers[].startedAt, not prompt mtime.
+--team-state and --worker select one pending worker. The worker row's
+          livenessMode picks the probe: audit-heartbeat reads the in-process
+          worker audit sidecar path and reports stalled past the heartbeat
+          cadence; wrapper-status reports did-not-launch when no prompt sibling
+          .log or .status.json exists past the launch grace. Both graces begin
+          at workers[].startedAt, never at an artifact mtime — the audit sidecar
+          is reused on re-dispatch, so the previous attempt's last heartbeat is
+          not this dispatch's signal.
 
 Output: JSON { ok, checkedAt, probes[], unhealthy[] }. Exit 1 when any worker is
 stalled or did not launch, so a poll loop can branch on the exit code. Read-only:

package/src/commands/report/translate.mjs

@@ -0,0 +1,31 @@
+import { runInstalledScript } from "../../lib/python-helper.mjs";
+
+const USAGE = `okstra report-translate — build and verify a final-report translation sidecar
+
+A thin spawn shim over \`scripts/okstra-report-translate.py\` (installed at
+\`$HOME/.okstra/bin/okstra-report-translate.py\`).
+
+The final-report data.json is authored in English and stays the SSOT. When the
+resolved report language is not English, Phase 7 dispatches a translator that
+writes a sidecar beside the report; \`render-views\` overlays it so only the
+human HTML is localized.
+
+Usage:
+  okstra report-translate extract <path-to-final-report.data.json>
+      Write <stem>.translation-source.json — every pointer the report holds a
+      translatable string at, paired with its English text. The translator
+      fills in the values, so a sidecar cannot cite a path the report lacks.
+
+  okstra report-translate check <path-to-final-report.i18n.<lang>.json>
+      Resolve every pointer in a filled sidecar against the report it names
+      and report what is still English. Exits non-zero on a pointer that
+      resolves nowhere — the translator's own gate before it returns.
+`;
+
+export async function run(args) {
+  return runInstalledScript({
+    scriptName: "okstra-report-translate.py",
+    args,
+    usage: USAGE,
+  });
+}

package/src/lib/helper-scripts.mjs

@@ -12,6 +12,7 @@ export const HELPER_SCRIPT_NAMES = Object.freeze([
   "okstra-inject-report-index.py",
   "okstra-render-final-report.py",
   "okstra-render-report-views.py",
+  "okstra-report-translate.py",
   "okstra-spawn-followups.py",
   "okstra-token-usage.py",
 ]);