okstra 0.146.0 → 0.147.0

package/runtime/templates/reports/final-report-v2.template.md

@@ -0,0 +1,66 @@
+---
+title: {{ frontmatter.title | yaml_scalar }}
+id: {{ frontmatter.id | yaml_scalar }}
+tags: {{ frontmatter.tags | yaml_inline_list }}
+status: {{ frontmatter.status | yaml_scalar }}
+aliases: {{ frontmatter.aliases | yaml_inline_list }}
+date: {{ frontmatter.date | yaml_scalar }}
+task-id: {{ frontmatter.taskId | yaml_scalar }}
+task-group: {{ frontmatter.taskGroup | yaml_scalar }}
+project-id: {{ frontmatter.projectId | yaml_scalar }}
+task-type: {{ frontmatter.taskType | yaml_scalar }}
+worker-id: {{ frontmatter.workerId | yaml_scalar }}
+approved: {{ "true" if frontmatter.approved else "false" }}
+implementation-option: {{ frontmatter.implementationOption | default("") | yaml_scalar }}
+schema-version: {{ schemaVersion | yaml_scalar }}
+---
+
+# {{ frontmatter.title }}
+
+- Task Key: `{{ header.taskKey }}`
+- Created At: `{{ header.createdAt }}`
+- Task Type: `{{ header.taskType }}`
+- Report Owner: `{{ header.reportOwner }}`
+- Report Author: `{{ header.reportAuthor }}`
+- Lead Model: `{{ header.leadModel | model_detail }}`
+- Okstra Version: `{{ header.okstraVersion }}`
+
+## AI Handoff Summary
+
+- Verdict: `{{ finalVerdict.verdictToken }}`
+- Direction: `{{ finalVerdict.direction }}`
+- Rationale IDs: {{ finalVerdict.rationaleRowIds | join(", ") }}
+- Blocking IDs: {{ aiBlockingIds | join(", ") if aiBlockingIds else "none" }}
+- Next step: {{ finalVerdict.nextStep }}
+
+### Decision Context
+
+{{ aiDecisionContext | json_block }}
+
+### Next Task Contract
+
+{{ aiRoutingContract | json_block }}
+
+## Clarification and User Decisions
+
+{{ clarificationItems | json_block }}
+
+## Evidence Ledger
+
+{{ aiEvidenceLedger | json_block }}
+
+## Task Deliverable: {{ aiTaskDeliverableTitle }}
+
+{{ aiTaskDeliverable | json_block }}
+
+## Cross Verification Audit
+
+{{ crossVerification | json_block }}
+
+## Execution Audit
+
+{{ executionStatus | json_block }}
+
+## Token and Cost Audit
+
+{{ tokenUsage | json_block }}

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

@@ -0,0 +1,38 @@
+* { box-sizing: border-box; }
+:root { color-scheme: light dark; font-family: Inter, ui-sans-serif, system-ui, sans-serif; line-height: 1.55; }
+body { margin: 0; background: Canvas; color: CanvasText; }
+.skip-link { position: absolute; left: -999px; }
+.skip-link:focus { left: 1rem; top: 1rem; z-index: 20; background: Canvas; padding: .6rem; }
+.human-report-header, main, .audit { width: min(1120px, calc(100% - 2rem)); margin-inline: auto; }
+.human-report-header { padding: 3rem 0 1.5rem; }
+.human-report-header h1 { max-width: 22ch; font-size: clamp(2rem, 6vw, 4rem); line-height: 1.05; margin: .25rem 0 1rem; }
+.eyebrow { text-transform: uppercase; letter-spacing: .08em; font-size: .78rem; color: GrayText; }
+main { display: grid; gap: 1rem; padding-bottom: 3rem; }
+section { padding: 1.4rem; border: 1px solid color-mix(in srgb, CanvasText 14%, transparent); border-radius: 16px; background: color-mix(in srgb, Canvas 94%, CanvasText 6%); }
+h2 { margin-top: 0; font-size: 1.45rem; }
+h3 { margin-bottom: .35rem; }
+.summary-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: .8rem; }
+.summary-card { padding: 1rem; border-radius: 12px; background: color-mix(in srgb, Highlight 8%, Canvas); border-left: 4px solid color-mix(in srgb, Highlight 55%, GrayText); }
+.tone-high, .tone-important { border-left-color: #d94b4b; }
+.tone-medium { border-left-color: #d79b25; }
+.evidence-refs { color: GrayText; font-size: .85rem; }
+figure { margin: 1rem 0 0; }
+figcaption { display: flex; flex-wrap: wrap; justify-content: space-between; gap: .5rem; margin-bottom: .7rem; }
+.visualization { overflow-x: auto; border-radius: 12px; background: color-mix(in srgb, CanvasText 4%, Canvas); }
+svg { width: 100%; min-width: 520px; height: auto; }
+svg .edge { stroke: GrayText; stroke-width: 2; }
+svg .node rect { fill: color-mix(in srgb, Highlight 14%, Canvas); stroke: Highlight; }
+svg .node text { fill: CanvasText; font-size: 13px; }
+table { width: 100%; border-collapse: collapse; margin-top: 1rem; font-size: .9rem; }
+th, td { text-align: left; vertical-align: top; border-bottom: 1px solid color-mix(in srgb, CanvasText 18%, transparent); padding: .55rem; }
+.visualization-fallback { margin-top: .8rem; }
+.status { display: inline-block; border-radius: 999px; padding: .1rem .5rem; background: color-mix(in srgb, GrayText 15%, Canvas); }
+.status-gap, .status-risk { background: color-mix(in srgb, #d94b4b 18%, Canvas); }
+.audit { margin-bottom: 3rem; padding: 1rem; border: 1px solid GrayText; border-radius: 12px; }
+.audit pre { overflow: auto; white-space: pre-wrap; }
+.human-report-footer { width: min(1120px, calc(100% - 2rem)); margin: 0 auto 2rem; display: flex; flex-wrap: wrap; gap: .6rem; }
+.human-report-footer pre { flex-basis: 100%; white-space: pre-wrap; }
+fieldset, label { display: block; margin: .7rem 0; }
+textarea, select { width: 100%; max-width: 60rem; padding: .55rem; font: inherit; }
+@media (max-width: 640px) { section { padding: 1rem; } .visualization { display: none; } }
+@media print { .skip-link, .audit, script { display: none !important; } body { color: #000; background: #fff; } section { break-inside: avoid; border-color: #bbb; } .visualization-fallback { display: table; } }

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

@@ -0,0 +1,5 @@
+(function () {
+  "use strict";
+
+  document.documentElement.classList.add("js-enabled");
+})();

package/runtime/templates/reports/html/base.template.html

@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+{% from "html/macros/forms.html" import clarification_responses %}
+<html lang="{{ 'ko' if humanSummary else 'en' }}" data-task-template="{{ taskType }}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>{{ humanSummary.headline }}</title>
+  <style>{{ css | safe }}</style>
+</head>
+<body>
+  <a class="skip-link" href="#main-content">Skip to report content</a>
+  <header class="human-report-header">
+    <p class="eyebrow">{{ taskType }}</p>
+    <h1>{{ humanSummary.headline }}</h1>
+    <p>{{ humanSummary.outcome }}</p>
+    <button type="button" data-action="export-user-response">사용자 응답 내보내기</button>
+  </header>
+  <main id="main-content" data-report-role="human-main">
+    {% block human_content %}{% endblock %}
+    {{ clarification_responses(clarificationItems) }}
+  </main>
+  <details id="audit-details" class="audit" data-report-role="audit">
+    <summary>감사 정보</summary>
+    <section data-audit-field="crossVerification">
+      <h2>Cross Verification</h2>
+      <pre>{{ audit.crossVerification | tojson(indent=2) }}</pre>
+    </section>
+    <section data-audit-field="executionStatus">
+      <h2>Execution Status by Agent</h2>
+      <pre>{{ audit.executionStatus | tojson(indent=2) }}</pre>
+    </section>
+    <section data-audit-field="tokenUsage">
+      <h2>Token Usage</h2>
+      <pre>{{ audit.tokenUsage | tojson(indent=2) }}</pre>
+    </section>
+    {% if audit.planBodyVerification is defined %}
+    <section data-audit-field="planBodyVerification">
+      <h2>Plan Body Verification</h2>
+      <pre>{{ audit.planBodyVerification | tojson(indent=2) }}</pre>
+    </section>
+    {% endif %}
+    {% if audit.deliveryEvidence is defined %}
+    <section data-audit-field="deliveryEvidence">
+      <h2>Delivery Evidence</h2>
+      <pre>{{ audit.deliveryEvidence | tojson(indent=2) }}</pre>
+    </section>
+    {% endif %}
+  </details>
+  <footer class="human-report-footer">
+    <button type="button" data-action="export-user-response">사용자 응답 내보내기</button>
+    <button type="button" data-action="copy-user-response">복사</button>
+    <button type="button" data-action="dismiss-user-response" hidden>닫기</button>
+    <pre id="user-response-output" aria-live="polite"></pre>
+  </footer>
+  <script id="run-meta" type="application/json">{{ {
+    "task-key": runMeta.task_key,
+    "task-type": runMeta.task_type,
+    "seq": runMeta.seq,
+    "source-report": runMeta.source_report,
+    "source-data-sha256": dataSha256,
+    "source-md-sha256": markdownSha256
+  } | tojson }}</script>
+  <script>{{ js | safe }}</script>
+</body>
+</html>

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

@@ -0,0 +1,47 @@
+{% macro analysis_review(selector_ids) -%}
+<section id="analysis-review" data-report-section="analysis-review">
+  <h2>분석 검토</h2>
+  <fieldset><legend>판정</legend>
+    <input id="analysis-review-accepted" type="radio" name="analysis-review-status" value="accepted"><label for="analysis-review-accepted">수락</label>
+    <input id="analysis-review-revision-requested" type="radio" name="analysis-review-status" value="revision-requested"><label for="analysis-review-revision-requested">수정 요청</label>
+    <input id="analysis-review-rejected" type="radio" name="analysis-review-status" value="rejected"><label for="analysis-review-rejected">거절</label>
+  </fieldset>
+  <label for="analysis-review-affected-ids">영향받는 ID</label>
+  <select id="analysis-review-affected-ids" multiple>
+      {% for analysis_id in selector_ids %}<option value="{{ analysis_id }}">{{ analysis_id }}</option>{% endfor %}
+  </select>
+  <label for="analysis-review-reason">이유</label><textarea id="analysis-review-reason" rows="3"></textarea>
+  <label for="analysis-review-evidence">추가 근거</label><textarea id="analysis-review-evidence" rows="3"></textarea>
+  <label for="analysis-review-scope-change">요청 범위 변경</label><textarea id="analysis-review-scope-change" rows="3"></textarea>
+</section>
+{%- endmacro %}
+
+{% macro plan_approval(state) -%}
+<section id="plan-approval" data-report-section="plan-approval">
+  <h2>계획 승인</h2>
+  <label for="approval-option">구현 옵션</label>
+  <select id="approval-option"{% if state.disabled_reason %} disabled{% endif %}>
+      {% for name in state.option_names %}
+      {% if name == state.recommended_option %}<option data-recommended="true" selected value="{{ name }}">{{ name }} (권장)</option>{% else %}<option value="{{ name }}">{{ name }}</option>{% endif %}
+      {% endfor %}
+  </select>
+  <input type="checkbox" id="approval-checkbox"{% if state.disabled_reason %} disabled{% endif %}><label for="approval-checkbox">이 계획을 승인합니다.</label>
+  {% if state.disabled_reason %}<div class="approval-disabled-reason"><p><strong>{{ state.disabled_reason }}</strong>라 아직 승인할 수 없습니다.</p><p>{{ state.blocker_ids | join(', ') }}에 답하고 사용자 응답을 내보낸 뒤 clarification 재개 명령으로 보고서를 다시 생성하세요.</p></div>{% endif %}
+</section>
+{%- endmacro %}
+
+{% macro clarification_responses(items) -%}
+{% if items %}
+<section class="clarification-responses" aria-label="열린 질문에 답하기">
+  <h2>열린 질문에 답하기</h2>
+  <table><thead><tr><th>ID</th><th>질문</th><th>기대 형식</th><th>사용자 응답</th></tr></thead><tbody>
+  {% for row in items %}
+    <tr data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
+      <td>{{ row.id }}</td><td>{{ row.statement }}</td><td>{{ row.expectedForm }}</td>
+      <td><label for="response-{{ row.id }}">{{ row.id }} 사용자 응답</label><textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="3">{{ row.userInput | default('') }}</textarea></td>
+    </tr>
+  {% endfor %}
+  </tbody></table>
+</section>
+{% endif %}
+{%- endmacro %}

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

@@ -0,0 +1,19 @@
+{% macro narrative(value, field_name) -%}
+<div class="narrative" data-report-field="{{ field_name }}">
+  <p>{{ value.text }}</p>
+  <p class="evidence-refs">근거: {{ value.evidenceRefs | join(', ') }}</p>
+</div>
+{%- endmacro %}
+
+{% macro action_list(actions) -%}
+<ol class="action-list">
+  {% for action in actions %}<li>{{ action }}</li>{% endfor %}
+</ol>
+{%- endmacro %}
+
+{% macro summary_card(title, body, tone='neutral') -%}
+<article class="summary-card tone-{{ tone }}">
+  <h3>{{ title }}</h3>
+  <p>{{ body }}</p>
+</article>
+{%- endmacro %}

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

@@ -0,0 +1,17 @@
+{% macro figure(model) -%}
+<figure data-figure-kind="{{ model.kind }}" aria-labelledby="{{ model.figure_id }}-title" aria-describedby="{{ model.figure_id }}-summary">
+  <figcaption>
+    <strong id="{{ model.figure_id }}-title">{{ model.title }}</strong>
+    <span id="{{ model.figure_id }}-summary">{{ model.summary }}</span>
+  </figcaption>
+  <div class="visualization" aria-hidden="true">{{ model.svg | safe }}</div>
+  <table class="visualization-fallback">
+    <thead><tr><th>ID</th><th>이름</th><th>그룹</th><th>상태</th><th>설명</th></tr></thead>
+    <tbody>
+      {% for node in model.nodes %}
+      <tr data-fallback-id="{{ node.id }}"><td>{{ node.id }}</td><td>{{ node.label }}</td><td>{{ node.group }}</td><td>{{ node.status }}</td><td>{{ node.detail }}</td></tr>
+      {% endfor %}
+    </tbody>
+  </table>
+</figure>
+{%- endmacro %}

package/runtime/templates/reports/html/tasks/change-impact-analysis.template.html

@@ -0,0 +1,40 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+{% from "html/macros/forms.html" import analysis_review %}
+
+{% block human_content %}
+<section data-report-section="change-overview">
+  <h2>변경 개요</h2>
+  {{ render_narrative(narrative.changeExplanation, "changeImpactAnalysis.userNarrative.changeExplanation") }}
+  <p>{{ change.changeRequest.summary }}</p>
+</section>
+
+<section data-report-section="affected-and-unaffected">
+  <h2>영향받는 영역과 영향 없는 경계</h2>
+  {{ render_narrative(narrative.impactExplanation, "changeImpactAnalysis.userNarrative.impactExplanation") }}
+  <div data-report-field="changeImpactAnalysis.impactItems"><h3>영향받는 영역</h3>{% for row in change.impactItems %}{{ summary_card(row.id ~ " · " ~ row.target, row.impactKind ~ " / 영향 " ~ row.level ~ " / 신뢰 " ~ row.confidence) }}{% endfor %}</div>
+  <div data-report-field="changeImpactAnalysis.unaffectedBoundaries"><h3>영향 없는 경계</h3>{{ render_narrative(narrative.unaffectedExplanation, "changeImpactAnalysis.userNarrative.unaffectedExplanation") }}<ul>{% for row in change.unaffectedBoundaries %}<li>{{ row.summary }}</li>{% endfor %}</ul></div>
+</section>
+
+<section data-report-section="blast-radius" data-report-field="changeImpactAnalysis.dependencyBlastRadius">
+  <h2>파급 범위</h2>
+  {{ figure(blastRadiusFigure) }}
+</section>
+
+<section data-report-section="test-and-operations">
+  <h2>테스트·운영·호환성</h2>
+  <div data-report-field="changeImpactAnalysis.compatibilityImpact"><h3>호환성</h3><ul>{% for row in change.compatibilityImpact %}<li>{{ row.summary }}</li>{% endfor %}</ul></div>
+  <div data-report-field="changeImpactAnalysis.migrationImpact"><h3>마이그레이션</h3><ul>{% for row in change.migrationImpact %}<li>{{ row.summary }}</li>{% endfor %}</ul></div>
+  <div data-report-field="changeImpactAnalysis.rollbackImpact"><h3>롤백</h3><ul>{% for row in change.rollbackImpact %}<li>{{ row.summary }}</li>{% endfor %}</ul></div>
+  <div data-report-field="changeImpactAnalysis.securityAndPerformanceImpact"><h3>보안과 성능</h3><ul>{% for row in change.securityAndPerformanceImpact %}<li>{{ row.summary }}</li>{% endfor %}</ul></div>
+</section>
+
+<section data-report-section="planning-readiness" data-report-field="changeImpactAnalysis.planningInputs">
+  <h2>계획 준비도</h2>
+  {{ render_narrative(narrative.planningReadiness, "changeImpactAnalysis.userNarrative.planningReadiness") }}
+  <ul>{% for row in change.planningInputs %}<li>{{ row.constraint }}{% if row.unknown %} — 미확정{% endif %}</li>{% endfor %}</ul>
+</section>
+
+{{ analysis_review(analysisReviewIds) }}
+{% endblock %}

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

@@ -0,0 +1,40 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="symptom">
+  <h2>사용자가 겪은 증상</h2>
+  {{ render_narrative(narrative.symptomExplanation, "errorAnalysis.userNarrative.symptomExplanation") }}
+  <blockquote data-report-field="errorAnalysis.symptomVerbatim">{{ error.symptomVerbatim }}</blockquote>
+  <p data-report-field="errorAnalysis.observableFailure">{{ error.observableFailure }}</p>
+</section>
+
+<section data-report-section="reproduction">
+  <h2>재현 상태</h2>
+  <p><span class="status status-{{ error.reproduction.status }}">{{ error.reproduction.status }}</span></p>
+  <ul>{% for item in error.reproduction.evidence %}<li>{{ item }}</li>{% endfor %}</ul>
+  {% if error.reproduction.blockedReason %}<p>{{ error.reproduction.blockedReason }}</p>{% endif %}
+</section>
+
+<section data-report-section="causes">
+  <h2>원인 후보</h2>
+  {{ render_narrative(narrative.causeExplanation, "errorAnalysis.userNarrative.causeExplanation") }}
+  {{ figure(causeFigure) }}
+  <div class="summary-grid">{% for row in error.causeCandidates %}<article class="summary-card tone-{{ row.confidence }}"><p class="eyebrow">{{ row.id }} · 신뢰도 {{ row.confidence }}</p><h3>{{ row.statement }}</h3><p class="evidence-refs">지지 근거: {{ row.supportingEvidence | join(', ') }}</p></article>{% else %}<p>현재 확인된 원인 후보가 없습니다.</p>{% endfor %}</div>
+</section>
+
+<section data-report-section="uncertainty">
+  <h2>아직 확정할 수 없는 부분</h2>
+  {{ render_narrative(narrative.uncertaintyExplanation, "errorAnalysis.userNarrative.uncertaintyExplanation") }}
+  {% for row in error.causeCandidates %}<article class="summary-card"><h3>{{ row.id }}</h3><p data-report-field="errorAnalysis.causeCandidates.confidence"><strong>현재 신뢰도:</strong> {{ row.confidence }}</p><p data-report-field="errorAnalysis.causeCandidates.falsifyingEvidenceChecked"><strong>확인한 반증:</strong> {{ row.falsifyingEvidenceChecked | join(', ') }}</p><p data-report-field="errorAnalysis.causeCandidates.disproveWith"><strong>이 가설을 기각하는 방법:</strong> {{ row.disproveWith }}</p></article>{% endfor %}
+</section>
+
+<section data-report-section="next-diagnostic">
+  <h2>다음 진단 한 가지</h2>
+  {{ render_narrative(narrative.diagnosticGuidance, "errorAnalysis.userNarrative.diagnosticGuidance") }}
+  {{ summary_card("실행", error.nextDiagnostic.action, "important") }}
+  <p><strong>확인 신호:</strong> {{ error.nextDiagnostic.confirmingSignal }}</p>
+  <p><strong>기각 신호:</strong> {{ error.nextDiagnostic.rejectingSignal }}</p>
+</section>
+{% endblock %}

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

@@ -0,0 +1,40 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+{% from "html/macros/forms.html" import analysis_review %}
+
+{% block human_content %}
+<section data-report-section="feature-overview">
+  <h2>기능 개요</h2>
+  {{ render_narrative(narrative.userBehaviorExplanation, "featureAnalysis.userNarrative.userBehaviorExplanation") }}
+  <p><strong>대상:</strong> {{ feature.target.requestedValue }}</p>
+  <ul>{% for row in feature.actors %}<li>{{ row.description }}</li>{% endfor %}</ul>
+</section>
+
+<section data-report-section="behavior-flow" data-report-field="featureAnalysis.flows">
+  <h2>사용자 행동 흐름</h2>
+  {{ render_narrative(narrative.flowExplanation, "featureAnalysis.userNarrative.flowExplanation") }}
+  {{ figure(flowFigure) }}
+  <div class="summary-grid">{% for row in feature.flows %}<article class="summary-card" data-flow-kind="{{ 'alternate' if row.kind == 'alternative' else row.kind }}"><p class="eyebrow">{{ row.id }} · {{ row.kind }}</p><ol>{% for step in row.steps %}<li>{{ step.action }}</li>{% endfor %}</ol></article>{% endfor %}</div>
+</section>
+
+<section data-report-section="rules-and-state">
+  <h2>규칙과 상태 변경</h2>
+  {{ render_narrative(narrative.rulesAndStateExplanation, "featureAnalysis.userNarrative.rulesAndStateExplanation") }}
+  <div data-report-field="featureAnalysis.domainRules"><h3>도메인 규칙</h3>{% for row in feature.domainRules %}{{ summary_card(row.id ~ " · " ~ row.condition, row.outcome) }}{% endfor %}</div>
+  <div data-report-field="featureAnalysis.stateChanges"><h3>상태 변경</h3>{% for row in feature.stateChanges %}{{ summary_card(row.id ~ " · " ~ row.field, row.change) }}{% endfor %}</div>
+</section>
+
+<section data-report-section="external-interactions" data-report-field="featureAnalysis.externalInteractions">
+  <h2>외부 상호작용</h2>
+  {% for row in feature.externalInteractions %}{{ summary_card(row.target, row.input ~ " → " ~ row.output ~ ". 실패 시: " ~ row.failureHandling) }}{% endfor %}
+</section>
+
+<section data-report-section="test-gaps" data-report-field="featureAnalysis.testCoverage">
+  <h2>테스트와 공백</h2>
+  {{ render_narrative(narrative.testGapExplanation, "featureAnalysis.userNarrative.testGapExplanation") }}
+  {% for row in feature.testCoverage %}{{ summary_card(row.id, "테스트: " ~ (row.testPaths | join(', ')) ~ "; 공백: " ~ ((row.gaps | join(', ')) or '없음')) }}{% endfor %}
+</section>
+
+{{ analysis_review(analysisReviewIds) }}
+{% endblock %}

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

@@ -0,0 +1,39 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="verification-verdict">
+  <h2>검증 판정</h2>
+  <p><span class="status status-{{ verdict.verdictToken }}">{{ verdict.verdictToken }}</span></p>
+  {{ render_narrative(narrative.verdictExplanation, "finalVerification.userNarrative.verdictExplanation") }}
+</section>
+
+<section data-report-section="requirement-results" data-report-field="finalVerification.validationEvidence">
+  <h2>요구사항별 결과</h2>
+  {{ render_narrative(narrative.coverageExplanation, "finalVerification.userNarrative.coverageExplanation") }}
+  {{ figure(coverageFigure) }}
+</section>
+
+<section data-report-section="blockers" data-report-field="finalVerification.acceptanceBlockers">
+  <h2>수락 차단 항목</h2>
+  {{ render_narrative(narrative.blockerExplanation, "finalVerification.userNarrative.blockerExplanation") }}
+  <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>
+</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 %}
+</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 %}
+</section>
+{% endblock %}

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

@@ -0,0 +1,47 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/forms.html" import plan_approval %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="planning-goal">
+  <h2>계획 목표</h2>
+  <p>{{ humanSummary.outcome }}</p>
+  <div class="summary-grid">{% for reason in humanSummary.whyItMatters %}{{ summary_card("왜 중요한가", 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>
+</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>
+</section>
+
+<section data-report-section="stage-map" data-report-field="implementationPlanning.stageMap">
+  <h2>단계별 실행 지도</h2>
+  {{ render_narrative(narrative.stageStrategy, "implementationPlanning.userNarrative.stageStrategy") }}
+  {{ 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>
+</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>
+</section>
+
+<section data-report-section="open-decisions">
+  <h2>승인 전 열린 결정</h2>
+  <div class="summary-grid">{% for row in openDecisions %}{{ summary_card(row.id ~ " · " ~ row.kind, row.statement, "important") }}{% else %}<p>승인을 막는 열린 결정이 없습니다.</p>{% endfor %}</div>
+  {{ action_list(humanSummary.actions) }}
+</section>
+
+{{ plan_approval(approval) }}
+{% endblock %}

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

@@ -0,0 +1,40 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="delivered-outcome">
+  <h2>전달된 결과</h2>
+  {{ render_narrative(narrative.deliveredOutcome, "implementation.userNarrative.deliveredOutcome") }}
+  <p>{{ humanSummary.outcome }}</p>
+</section>
+
+<section data-report-section="change-map" data-report-field="implementation.diffSummary">
+  <h2>무엇이 달라졌는가</h2>
+  {{ render_narrative(narrative.changeExplanation, "implementation.userNarrative.changeExplanation") }}
+  {{ 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>
+</section>
+
+<section data-report-section="validation" data-report-field="implementation.validationEvidence">
+  <h2>검증 결과</h2>
+  {{ render_narrative(narrative.validationExplanation, "implementation.userNarrative.validationExplanation") }}
+  <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") }}
+  <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 %}
+</section>
+{% endblock %}

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

@@ -0,0 +1,29 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="opportunities">
+  <h2>발견한 개선 기회</h2>
+  {{ render_narrative(narrative.opportunityOverview, "improvementDiscovery.userNarrative.opportunityOverview") }}
+  <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>
+</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>
+</section>
+
+<section data-report-section="impact-effort">
+  <h2>영향도와 노력도</h2>
+  {{ figure(matrixFigure) }}
+</section>
+
+<section data-report-section="selection">
+  <h2>선택 안내</h2>
+  {{ render_narrative(narrative.selectionGuidance, "improvementDiscovery.userNarrative.selectionGuidance") }}
+  <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>
+</section>
+{% endblock %}

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

@@ -0,0 +1,57 @@
+{% extends "html/base.template.html" %}
+{% from "html/macros/layout.html" import narrative as render_narrative, action_list, summary_card %}
+{% from "html/macros/visualizations.html" import figure %}
+
+{% block human_content %}
+<section data-report-section="project-overview">
+  <h2>프로젝트 개요</h2>
+  {{ render_narrative(narrative.projectOverview, "projectAnalysis.userNarrative.projectOverview") }}
+  <div class="summary-grid">
+    {% 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") }}
+  {{ figure(architectureFigure) }}
+</section>
+
+<section data-report-section="boundaries">
+  <h2>시스템 경계</h2>
+  <div class="summary-grid" data-report-field="projectAnalysis.entryPoints">
+    {% for row in project.entryPoints %}{{ summary_card(row.symbol, row.role) }}{% endfor %}
+  </div>
+  <h3>데이터 저장소</h3>
+  <ul data-report-field="projectAnalysis.dataStores">{% for row in project.dataStores %}<li><strong>{{ row.name }}</strong> — {{ row.readBoundary }} / {{ row.writeBoundary }}</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>
+</section>
+
+<section data-report-section="hotspots" data-report-field="projectAnalysis.rankedHotspots">
+  <h2>우선 검토할 핫스팟</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 }}</h3><p>{{ row.reason }}</p><p class="evidence-refs">근거: {{ row.evidenceRefs | join(', ') }}</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>
+</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>
+</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 %}
+</section>
+{% endblock %}