okstra 0.148.1 → 0.149.0

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

@@ -1,29 +1,29 @@
 {% 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="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>
+  <h2>Improvements found</h2>
+  {{ render_narrative(narrative.opportunityOverview, "improvementDiscovery.userNarrative.opportunityOverview") }}
+  <table data-report-field="improvementDiscovery.lensCoverage"><thead><tr><th>Lens</th><th>Detail</th><th>Evidence</th></tr></thead><tbody>{% for row in improvement.lensCoverage %}<tr>{{ row_key(pairs=[("Lens", row.lens), ("Result", row.status | enum_label("lens"))]) }}<td>{{ row.rationale | inline_code }}</td><td>{{ row.evidence | evidence_refs }}</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>
+  <h2>Ranked candidates</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 }}" id="id-{{ row.id }}"><p class="eyebrow">#{{ loop.index }} · {{ row.id }} · Impact {{ row.severity }} · Effort {{ row.effort | enum_label("effort") }}</p><h3>{{ row.title | inline_code }}</h3><p>{{ row.expectedBehaviorAfter | inline_code }}</p><p><strong>Next step:</strong> {{ row.recommendedNextPhase }}</p><p class="evidence-refs">Evidence: {{ row.evidence | evidence_refs }}</p></article>{% else %}<p>There is no improvement candidate to pick.</p>{% endfor %}</div>
 </section>
 
 <section data-report-section="impact-effort">
-  <h2>영향도와 노력도</h2>
+  <h2>Impact and effort</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>
+  <h2>How to choose</h2>
+  {{ render_narrative(narrative.selectionGuidance, "improvementDiscovery.userNarrative.selectionGuidance") }}
+  <p><strong>Selection cap:</strong> at most {{ 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

@@ -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>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>Architecture and dependencies</h2>
+  {{ render_narrative(narrative.architectureExplanation, "projectAnalysis.userNarrative.architectureExplanation") }}
+  {{ figure(architectureFigure, anchor_nodes=true) }}
 </section>
 
+<section data-report-section="infrastructure">
+  <h2>Infrastructure</h2>
+  {{ figure(infrastructureFigure) }}
+</section>
+
+{% if project.get("techStack") %}
+<section data-report-section="tech-stack" data-report-field="projectAnalysis.techStack">
+  <h2>Tech stack</h2>
+  <h3>Language</h3>
+  <table><thead><tr><th>Language</th><th>Version</th><th>Version source</th><th>Files</th><th>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>Framework</h3>
+  <table><thead><tr><th>Framework</th><th>Role</th><th>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>Tool</h3>
+  <table><thead><tr><th>Tool</th><th>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>Internal interfaces</h2>
+  <table><thead><tr><th>Interface</th><th>Signature</th><th>Consumers</th><th>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>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>Starts with</strong> — {{ flow.trigger | inline_code }}{% if flow.get("outcome") %} · <strong>Result</strong> — {{ flow.outcome | inline_code }}{% endif %}</p>
+    <table><thead><tr><th>Order</th><th>Action</th><th>Component</th><th>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>System boundaries</h2>
+  <p class="scan-coverage" data-report-field="projectAnalysis.scanCoverage"><strong>{{ project.scanCoverage.scannedPathCount }}</strong> paths read · <strong>{{ project.scanCoverage.unscannedPathCount }}</strong> left unread — {{ project.scanCoverage.reason | inline_code }}</p>
+  <h3>Entry point</h3>
+  <table data-report-field="projectAnalysis.entryPoints"><thead><tr><th>Entry point</th><th>Path</th><th>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>Data stores</h3>
+  <table data-report-field="projectAnalysis.dataStores"><thead><tr><th>Store</th><th>Reads</th><th>Writes</th><th>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>External system</h3>
+  <table data-report-field="projectAnalysis.externalSystems"><thead><tr><th>External system</th><th>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>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>Quality and test coverage</h2>
+  {{ render_narrative(narrative.qualityExplanation, "projectAnalysis.userNarrative.qualityExplanation") }}
+  <table><thead><tr><th>Area</th><th>Detail</th><th>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>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>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>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>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>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>The behaviour you chose</h2>
+  <dl><dt>Handoff mode</dt><dd>{{ handoff.userSelections.h1 }}</dd><dt>Conflict check</dt><dd>{{ handoff.userSelections.h2b }}</dd><dt>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>Branch and PR</h2>
+  {{ render_narrative(narrative.branchAndPrExplanation, "releaseHandoff.userNarrative.branchAndPrExplanation") }}
+  <p><strong>Branch:</strong> {{ handoff.featureBranchState.branchName }}</p>
+  <p data-report-field="releaseHandoff.pullRequestOutcome"><strong>PR Result:</strong> {{ handoff.pullRequestOutcome.kind }}{% if prUrl %} · <a href="{{ prUrl }}" rel="noopener noreferrer">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>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>Commits delivered</h2>
+  {% if handoff.commitList is mapping %}<p>There are no commits.</p>{% else %}
+  <table><thead><tr><th>Commit</th><th>Subject</th><th>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>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>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>The request as understood</h2>
+  {{ render_narrative(narrative.requestUnderstanding, "requirementsDiscovery.userNarrative.requestUnderstanding") }}
+  <h3>Your request, verbatim</h3>
   <p data-report-field="requirementsDiscovery.requestVerbatim">{{ requirements.requestVerbatim | inline_code }}</p>
-  <h3>시스템 해석</h3>
+  <h3>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>What would prove this wrong</h2>
+  {% if requirements.rejectionCriteria.source == "absent-not-material" %}
+  <p>The requester left no rejection criteria, even if there had been, neither the classification nor the next step would change.</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>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>As the brief put it</th><th>Settled term</th><th>Settled by</th><th>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">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>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>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>Next tasks and dependencies</h2>
+  {{ render_narrative(narrative.routingExplanation, "requirementsDiscovery.userNarrative.routingExplanation") }}
+  <p><strong>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">This requirements task stands alone; nothing else feeds it.</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>Decisions that are yours</h2>
+  <div class="summary-grid">{% for row in clarificationItems %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important") }}{% else %}<p>No further decision is needed.</p>{% endfor %}</div>
   {{ action_list(humanSummary.actions) }}
 </section>
 {% endblock %}

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: