okstra 0.148.1 → 0.149.0

package/runtime/schemas/final-report-v2.0.schema.json

@@ -515,6 +515,17 @@
       ],
       "additionalProperties": false,
       "properties": {
+        "handoffScope": {
+          "type": "object",
+          "required": ["mode"],
+          "additionalProperties": false,
+          "description": "Which shape of handoff this was. 'whole-task' turns the verified task branch into one PR; 'stage-group' merges a user-selected subset of verified stages into a collector branch and opens the PR from that. Without it a reader cannot tell one report from the other, and in stage-group mode cannot tell which stages shipped — the branch name alone does not say.",
+          "properties": {
+            "mode": { "enum": ["whole-task", "stage-group"] },
+            "stages": { "type": "array", "items": { "type": "integer", "minimum": 1 } },
+            "collectorBranch": { "type": "string" }
+          }
+        },
         "sourceVerificationReport": {
           "type": "object",
           "required": ["path", "verdictTokenQuote"],
@@ -1400,6 +1411,57 @@
       }
     },
 
+    "RequirementsRejectionCriteria": {
+      "type": "object",
+      "required": ["source", "statement"],
+      "additionalProperties": false,
+      "description": "The delivered outcome that would make this work wrong — the reporter's own line, never inferred. It decides classification and routing: work that must not change existing behaviour routes differently from work that may. `source` says where the line came from, because a line the reporter wrote and a line raised as a question carry different authority. 'absent-not-material' is the one case with no statement to quote: the criteria were missing and would not have changed the routing.",
+      "properties": {
+        "source": {
+          "enum": [
+            "brief-desired-outcome",
+            "brief-out-of-scope",
+            "brief-source-material",
+            "clarification-raised",
+            "absent-not-material"
+          ]
+        },
+        "statement": { "type": "string" },
+        "clarificationId": { "type": "string", "pattern": "^C-\\d+$" },
+        "evidenceRefs": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+
+    "RequirementsDomainAlignment": {
+      "type": "object",
+      "required": ["glossaryConsulted", "decisionsConsulted", "terms"],
+      "additionalProperties": false,
+      "description": "The terminology this phase settled before routing. A term that means two things in the brief means two things in every later phase, so each one resolves to a single canonical form here, with the source that decided it.",
+      "properties": {
+        "glossaryConsulted": { "type": "boolean" },
+        "decisionsConsulted": { "type": "boolean" },
+        "terms": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["raw", "canonical", "resolvedBy"],
+            "additionalProperties": false,
+            "properties": {
+              "raw": { "type": "string", "minLength": 1 },
+              "canonical": { "type": "string", "minLength": 1 },
+              "resolvedBy": {
+                "enum": ["glossary", "decision-record", "brief", "clarification"]
+              },
+              "evidenceRefs": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              }
+            }
+          }
+        }
+      }
+    },
+
     "RequirementsDiscovery": {
       "type": "object",
       "required": ["requestVerbatim", "systemInterpretation", "classification", "confirmedRequirements", "unresolvedRequirements", "routing", "taskDependencies", "userNarrative"],
@@ -1407,6 +1469,8 @@
       "properties": {
         "requestVerbatim": { "type": "string", "minLength": 1 },
         "systemInterpretation": { "type": "string", "minLength": 1 },
+        "rejectionCriteria": { "$ref": "#/$defs/RequirementsRejectionCriteria" },
+        "domainAlignment": { "$ref": "#/$defs/RequirementsDomainAlignment" },
         "classification": {
           "type": "object",
           "required": ["requestKind", "scope", "complexity"],
@@ -1984,6 +2048,158 @@
       }
     },
 
+    "ProjectLanguage": {
+      "type": "object",
+      "required": ["name", "version", "versionSource"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "versionSource": { "$ref": "#/$defs/ProjectVersionSource" },
+        "fileCount": { "type": "integer", "minimum": 0 },
+        "lineCount": { "type": "integer", "minimum": 0 },
+        "currentCodeEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CurrentCodeEvidence" }
+        }
+      }
+    },
+
+    "ProjectVersionSource": {
+      "enum": [
+        "manifest-range",
+        "lockfile-pinned",
+        "container-image",
+        "runtime-config",
+        "declared-doc"
+      ],
+      "description": "Where the version was read, which decides how much it can be trusted. 'manifest-range' — a range in a manifest (`^1.17.0`), so the installed version is not this one. 'lockfile-pinned' — the exact version a lockfile resolves to. 'container-image' — the tag an image is built from. 'runtime-config' — a value the running service reports or a config fixes. 'declared-doc' — prose in a document, with nothing enforcing it. A range and a pin must never be recorded the same way: a mismatch between them is a real compatibility risk."
+    },
+
+    "ProjectFramework": {
+      "type": "object",
+      "required": ["name", "version", "versionSource", "role"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "versionSource": { "$ref": "#/$defs/ProjectVersionSource" },
+        "role": { "type": "string", "minLength": 1 },
+        "currentCodeEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CurrentCodeEvidence" }
+        }
+      }
+    },
+
+    "ProjectTool": {
+      "type": "object",
+      "required": ["kind", "name"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "enum": [
+            "packageManager",
+            "build",
+            "test",
+            "lint",
+            "typecheck",
+            "format",
+            "ci",
+            "container"
+          ]
+        },
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string" },
+        "versionSource": { "$ref": "#/$defs/ProjectVersionSource" },
+        "command": { "type": "string" },
+        "currentCodeEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CurrentCodeEvidence" }
+        }
+      }
+    },
+
+    "ProjectTechStack": {
+      "type": "object",
+      "required": ["languages"],
+      "additionalProperties": false,
+      "description": "What the project is written in and built with. Record only what a file states — a language with no version in any manifest, lockfile or image is still recorded, with the version left to the source that does declare it.",
+      "properties": {
+        "languages": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/ProjectLanguage" }
+        },
+        "frameworks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProjectFramework" }
+        },
+        "toolchain": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProjectTool" }
+        }
+      }
+    },
+
+    "ProjectInternalInterface": {
+      "type": "object",
+      "required": ["id", "name", "kind", "ownerComponentId", "signature"],
+      "additionalProperties": false,
+      "description": "A seam inside the project that other components call across. `kind` is what the seam is, not where its file sits: a `port` is the abstraction a domain declares, an `adapter` the implementation that satisfies one.",
+      "properties": {
+        "id": { "type": "string", "pattern": "^II-[0-9]{3}$" },
+        "name": { "type": "string", "minLength": 1 },
+        "kind": {
+          "enum": ["port", "adapter", "service-api", "module-export", "event"]
+        },
+        "ownerComponentId": { "type": "string", "minLength": 1 },
+        "signature": { "type": "string", "minLength": 1 },
+        "consumers": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "currentCodeEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CurrentCodeEvidence" }
+        }
+      }
+    },
+
+    "ProjectWorkflowStep": {
+      "type": "object",
+      "required": ["order", "action", "componentId"],
+      "additionalProperties": false,
+      "properties": {
+        "order": { "type": "integer", "minimum": 1 },
+        "action": { "type": "string", "minLength": 1 },
+        "componentId": { "type": "string", "minLength": 1 },
+        "externalSystem": { "type": "string" },
+        "currentCodeEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CurrentCodeEvidence" }
+        }
+      }
+    },
+
+    "ProjectWorkflow": {
+      "type": "object",
+      "required": ["id", "name", "trigger", "steps"],
+      "additionalProperties": false,
+      "description": "One run of work through the system, start to finish — what sets it off and which component does what, in order. This is the only block that says how the parts are used rather than how they are arranged.",
+      "properties": {
+        "id": { "type": "string", "pattern": "^PW-[0-9]{3}$" },
+        "name": { "type": "string", "minLength": 1 },
+        "trigger": { "type": "string", "minLength": 1 },
+        "outcome": { "type": "string" },
+        "steps": {
+          "type": "array",
+          "minItems": 2,
+          "items": { "$ref": "#/$defs/ProjectWorkflowStep" }
+        }
+      }
+    },
+
     "ProjectHotspot": {
       "type": "object",
       "required": ["id", "title", "impact", "risk", "reason", "evidenceRefs"],
@@ -2005,7 +2221,10 @@
       "properties": {
         "id": { "type": "string", "pattern": "^PQ-[0-9]{3}$" },
         "area": { "type": "string", "minLength": 1 },
-        "status": { "enum": ["covered", "partial", "gap", "risk"] },
+        "status": {
+          "enum": ["covered", "partial", "gap", "risk"],
+          "description": "How far the area's tests actually protect it. 'covered' — tests exercise the area and a regression fails them. 'partial' — tests exist but leave part of the area unexercised. 'gap' — no test exercises the area. 'risk' — tests exist and run, but passing them does not prove the area works (they skip, assert nothing, or gate on a condition that is never met). 'risk' is not a weaker 'gap': it is the more dangerous state, because the suite reports success."
+        },
         "summary": { "type": "string", "minLength": 1 },
         "evidenceRefs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
       }
@@ -2035,6 +2254,15 @@
           "type": "array",
           "items": { "$ref": "#/$defs/ProjectDependency" }
         },
+        "techStack": { "$ref": "#/$defs/ProjectTechStack" },
+        "internalInterfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProjectInternalInterface" }
+        },
+        "workflows": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProjectWorkflow" }
+        },
         "entryPoints": {
           "type": "array",
           "items": { "$ref": "#/$defs/ProjectEntryPoint" }

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

@@ -534,6 +534,14 @@ Carried-forward plan items retain their prior verdicts verbatim; each such item
 
 {{ t("releaseHandoff.auditNote") }}
 
+{% if releaseHandoff.handoffScope %}
+### 5.6.0 Handoff Scope
+
+- Mode: `{{ releaseHandoff.handoffScope.mode | mdcell }}`
+{% if releaseHandoff.handoffScope.stages %}- Stages: {{ releaseHandoff.handoffScope.stages | join(', ') | mdcell }}
+{% endif %}{% if releaseHandoff.handoffScope.collectorBranch %}- Collector branch: `{{ releaseHandoff.handoffScope.collectorBranch | mdcell }}`
+{% endif %}
+{% endif %}
 ### 5.6.1 Source Verification Report
 
 - Path (project-relative): `{{ releaseHandoff.sourceVerificationReport.path }}`
@@ -921,6 +929,30 @@ Single scan of every agreed check that this run did NOT confirm — requirement
 
 {{ t("analysis.projectIntro") }}
 
+{% if projectAnalysis.techStack %}
+### 5.10.0 Tech Stack
+
+| Language | Version | Version source | Files | Lines |
+|----------|---------|----------------|-------|-------|
+{% for row in projectAnalysis.techStack.languages -%}
+| {{ row.name | mdcell }} | {{ row.version | mdcell }} | {{ row.versionSource | mdcell }} | {{ row.fileCount | default('--') | mdcell }} | {{ row.lineCount | default('--') | mdcell }} |
+{% endfor %}
+{% if projectAnalysis.techStack.frameworks %}
+| Framework | Version | Version source | Role |
+|-----------|---------|----------------|------|
+{% for row in projectAnalysis.techStack.frameworks -%}
+| {{ row.name | mdcell }} | {{ row.version | mdcell }} | {{ row.versionSource | mdcell }} | {{ row.role | mdcell }} |
+{% endfor %}
+{% endif %}
+{% if projectAnalysis.techStack.toolchain %}
+| Tool kind | Name | Version | Command |
+|-----------|------|---------|---------|
+{% for row in projectAnalysis.techStack.toolchain -%}
+| {{ row.kind | mdcell }} | {{ row.name | mdcell }} | {{ row.version | default('--') | mdcell }} | {{ row.command | default('--') | mdcell }} |
+{% endfor %}
+{% endif %}
+{% endif %}
+
 ### 5.10.1 Components
 
 | ID | Name | Responsibility | Paths | Current code evidence |
@@ -957,6 +989,29 @@ Single scan of every agreed check that this run did NOT confirm — requirement
 | {{ row.name | mdcell }} | {{ row.adapter | mdcell }} | {{ row.direction | mdcell }} | {% for evidence in row.currentCodeEvidence %}`{{ evidence.path | mdcell }}:{{ evidence.line | mdcell }}` — {{ evidence.claim | mdcell }}{% if not loop.last %}<br>{% endif %}{% endfor %} |
 {% endfor %}
 
+{% if projectAnalysis.internalInterfaces %}
+### 5.10.3b Internal Interfaces
+
+| ID | Name | Kind | Owner | Signature | Consumers | Current code evidence |
+|----|------|------|-------|-----------|-----------|-----------------------|
+{% for row in projectAnalysis.internalInterfaces -%}
+| {{ row.id | mdcell }} | {{ row.name | mdcell }} | {{ row.kind | mdcell }} | {{ row.ownerComponentId | mdcell }} | `{{ row.signature | mdcell }}` | {{ row.consumers | default([]) | join(', ') | mdcell }} | {% for evidence in row.currentCodeEvidence %}`{{ evidence.path | mdcell }}:{{ evidence.line | mdcell }}`{% if not loop.last %}<br>{% endif %}{% endfor %} |
+{% endfor %}
+{% endif %}
+{% if projectAnalysis.workflows %}
+### 5.10.3c Workflows
+
+{% for flow in projectAnalysis.workflows -%}
+**{{ flow.id | mdcell }} — {{ flow.name | mdcell }}** (trigger: {{ flow.trigger | mdcell }}{% if flow.outcome %}; outcome: {{ flow.outcome | mdcell }}{% endif %})
+
+| Step | Action | Component | External system |
+|------|--------|-----------|-----------------|
+{% for step in flow.steps -%}
+| {{ step.order | mdcell }} | {{ step.action | mdcell }} | {{ step.componentId | mdcell }} | {{ step.externalSystem | default('--') | mdcell }} |
+{% endfor %}
+{% endfor %}
+{% endif %}
+
 ### 5.10.4 Feature Index
 
 | ID | Name | Description | Representative entry point | Related components | Current code evidence |

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

@@ -3,16 +3,23 @@
 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, main { width: min(1120px, calc(100% - 2rem)); margin-inline: auto; }
 .human-report-header { padding: 3rem 0 1.5rem; }
 .human-report-header h1 { max-width: 30ch; font-size: clamp(1.5rem, 3vw, 2.25rem); line-height: 1.15; margin: .25rem 0 .75rem; }
+.report-meta { display: flex; flex-wrap: wrap; gap: .3rem 1.6rem; margin: 0 0 1.1rem; font-size: .88rem; }
+.report-meta div { display: flex; gap: .45rem; }
+.report-meta dt { color: GrayText; }
+.report-meta dd { margin: 0; }
 .lede { max-width: 70ch; font-size: clamp(1.05rem, 2vw, 1.35rem); line-height: 1.4; margin: 0 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; }
+/* One card per row. Fitting three across left each body about sixteen
+   characters wide — a third of what reads comfortably — and turned every card
+   into a narrow vertical strip. These carry paragraphs, not labels. */
+.summary-grid { display: grid; grid-template-columns: 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; }
@@ -26,12 +33,46 @@ svg .edge-arrow-head { fill: GrayText; }
 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; }
+/* Korean takes a line break between any two syllables, so an auto-layout
+   column squeezed by a prose neighbour stacked "일부만 검증" one character per
+   line. keep-all wraps at word boundaries instead, and the floor keeps the
+   id / status / kind columns from collapsing to a single glyph. anywhere is
+   the release valve: a path too long for its column breaks rather than
+   widening the table until the right-hand columns run off the page. */
+th, td { text-align: left; vertical-align: top; border-bottom: 1px solid color-mix(in srgb, CanvasText 18%, transparent); padding: .55rem; min-width: 6em; word-break: keep-all; overflow-wrap: anywhere; }
 .visualization-fallback { margin-top: .8rem; }
-.status { display: inline-block; border-radius: 999px; padding: .1rem .5rem; background: color-mix(in srgb, GrayText 15%, Canvas); }
+/* A hint, not a cap — auto layout still widens it when a value needs more.
+   Without it a two-column table split the width evenly and gave a stack of
+   short labels as much room as the prose beside it. */
+.row-key { width: 11em; }
+.row-key dl { margin: 0; }
+.row-key div + div { margin-top: .2rem; }
+/* Name and value share a line so a labelled stack costs no extra height;
+   the name is dimmed because the value is what the reader came for. */
+.row-key dt { display: inline; color: GrayText; }
+.row-key dt::after { content: " "; }
+.row-key dd { display: inline; margin: 0; }
+/* The legend for a vocabulary whose members are judgements. A cell fits the
+   label; the claim behind it has to live somewhere the reader can reach. */
+.enum-legend { margin: .8rem 0 0; font-size: .9rem; }
+.enum-legend dt { display: inline; font-weight: 600; }
+.enum-legend dt::after { content: " — "; }
+.enum-legend dd { display: inline; margin: 0; color: GrayText; }
+.enum-legend dd::after { content: ""; display: block; margin-bottom: .3rem; }
+/* Each entry is two blocks of prose and a citation. As table rows they shared
+   the width three ways and every one of them wrapped into a narrow ribbon. */
+.ledger { list-style: none; margin: 1rem 0 0; padding: 0; }
+.ledger-item { padding: 1rem 0; border-top: 1px solid color-mix(in srgb, CanvasText 14%, transparent); }
+.ledger-item:first-child { border-top: 0; padding-top: 0; }
+.ledger-item p { margin: 0 0 .4rem; }
+.ledger-item p:last-child { margin-bottom: 0; }
+.ledger-key { display: flex; flex-wrap: wrap; gap: .6rem; font-weight: 600; }
+.ledger-kind { font-weight: 400; color: GrayText; }
+.ledger-text { max-width: 78ch; }
+.ledger-source { font-size: .9rem; color: GrayText; }
+.ledger-source > span:first-child::after { content: ":"; }
+.status { display: inline-block; white-space: nowrap; 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; max-height: 14em; overflow: auto; }
 fieldset, label { display: block; margin: .7rem 0; }
@@ -39,9 +80,18 @@ textarea, select { width: 100%; max-width: 60rem; padding: .55rem; font: inherit
 .clarification-lede, .clarification-item p { max-width: 78ch; }
 .clarification-item { padding: 1.2rem 0; border-top: 1px solid color-mix(in srgb, CanvasText 14%, transparent); }
 .clarification-item:first-of-type { border-top: 0; }
-.clarification-expected { color: GrayText; font-size: .9rem; }
+.clarification-expected { padding: .7rem .9rem; border-radius: 10px; background: color-mix(in srgb, CanvasText 6%, Canvas); }
+.clarification-expected dt { font-weight: 600; margin-bottom: .3rem; }
+.clarification-expected dd { margin: 0; }
 .clarification-item label { font-weight: 600; margin-bottom: .3rem; }
 .user-response-hint { flex-basis: 100%; margin: 0; color: GrayText; font-size: .9rem; }
-@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; } }
+button { padding: .5rem 1rem; border-radius: 8px; border: 1px solid color-mix(in srgb, CanvasText 28%, transparent); background: color-mix(in srgb, CanvasText 5%, Canvas); color: CanvasText; font: inherit; cursor: pointer; }
+button:hover { background: color-mix(in srgb, CanvasText 12%, Canvas); }
+button:active { transform: translateY(1px); }
+button:focus-visible { outline: 2px solid Highlight; outline-offset: 2px; }
+button[data-action="export-user-response"] { background: Highlight; border-color: Highlight; color: HighlightText; font-weight: 600; }
+button[data-action="export-user-response"]:hover { background: color-mix(in srgb, Highlight 82%, CanvasText); }
+/* A seven-column table needs 42em of floor, more than a phone can give. */
+@media (max-width: 640px) { section { padding: 1rem; } .visualization { display: none; } th, td { min-width: 4.5em; } }
+@media print { .skip-link, script { display: none !important; } body { color: #000; background: #fff; } section { break-inside: avoid; border-color: #bbb; } .visualization-fallback { display: table; } }
 code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .9em; padding: .1em .3em; border-radius: 4px; background: color-mix(in srgb, CanvasText 8%, Canvas); }

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

@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 {% from "html/macros/forms.html" import clarification_responses %}
-<html lang="{{ 'ko' if humanSummary else 'en' }}" data-task-template="{{ taskType }}">
+<html lang="en" data-task-template="{{ taskType }}">
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
@@ -12,59 +12,38 @@
   <header class="human-report-header">
     <p class="eyebrow">{{ taskType }}</p>
     <h1>{{ taskType }} #{{ runMeta.seq }}</h1>
+    <dl class="report-meta">
+      <div><dt>Task</dt><dd data-report-meta="taskTitle">{{ reportMeta.taskTitle | inline_code }}</dd></div>
+      <div><dt>Task key</dt><dd data-report-meta="taskKey"><code>{{ reportMeta.taskKey }}</code></dd></div>
+      <div><dt>Written</dt><dd data-report-meta="createdAt">{{ reportMeta.createdAt }}</dd></div>
+      {% if reportMeta.elapsed %}<div><dt>Elapsed</dt><dd data-report-meta="elapsed">{{ reportMeta.elapsed }}</dd></div>{% endif %}
+    </dl>
     <p class="lede">{{ humanSummary.headline | inline_code }}</p>
     <p>{{ humanSummary.outcome | inline_code }}</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) }}
     {% if evidenceIndex %}
     <section data-report-section="evidence-ledger">
-      <h2>근거 대장</h2>
-      <table>
-        <thead><tr><th>ID</th><th>내용</th><th>출처 · 신뢰도</th></tr></thead>
-        <tbody>
-          {% for row_id, row in evidenceIndex | dictsort %}
-          <tr id="ev-{{ row_id }}"><td>{{ row_id }}</td><td>{{ row.text | inline_code }}</td><td>{% if row.codeEvidence %}{{ row.codeEvidence | code_evidence }}{% else %}{{ row.source | inline_code }}{% endif %}</td></tr>
-          {% endfor %}
-        </tbody>
-      </table>
+      <h2>Evidence ledger</h2>
+      <ol class="ledger">
+        {% for row_id, row in evidenceIndex.items() %}
+        <li class="ledger-item" id="id-{{ row_id }}">
+          <p class="ledger-key"><span class="ledger-id">{{ row_id }}</span><span class="ledger-kind">{{ row.kind }}</span></p>
+          <p class="ledger-text">{{ row.text | inline_code }}</p>
+          <p class="ledger-source"><span>Source · confidence</span> {% if row.codeEvidence %}{{ row.codeEvidence | code_evidence }}{% else %}{{ row.source | inline_code }}{% endif %}</p>
+        </li>
+        {% endfor %}
+      </ol>
     </section>
     {% endif %}
   </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 | audit_json }}</pre>
-    </section>
-    <section data-audit-field="executionStatus">
-      <h2>Execution Status by Agent</h2>
-      <pre>{{ audit.executionStatus | audit_json }}</pre>
-    </section>
-    <section data-audit-field="tokenUsage">
-      <h2>Token Usage</h2>
-      <pre>{{ audit.tokenUsage | audit_json }}</pre>
-    </section>
-    {% if audit.planBodyVerification is defined %}
-    <section data-audit-field="planBodyVerification">
-      <h2>Plan Body Verification</h2>
-      <pre>{{ audit.planBodyVerification | audit_json }}</pre>
-    </section>
-    {% endif %}
-    {% if audit.deliveryEvidence is defined %}
-    <section data-audit-field="deliveryEvidence">
-      <h2>Delivery Evidence</h2>
-      <pre>{{ audit.deliveryEvidence | audit_json }}</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>
-    <p class="user-response-hint">내보내기를 누르면 <code>user-response-{{ runMeta.task_type }}-{{ runMeta.seq }}.md</code> 가 다운로드됩니다. 그 파일을 <code>runs/{{ runMeta.task_type }}/user-responses/</code> 에 넣고 다음 run 을 실행하면 답변이 자동으로 반영됩니다.</p>
+    <button type="button" data-action="export-user-response">Export my answers</button>
+    <button type="button" data-action="copy-user-response">Copy</button>
+    <button type="button" data-action="dismiss-user-response" hidden>Dismiss</button>
+    <p class="user-response-hint">Export downloads <code>user-response-{{ runMeta.task_type }}-{{ runMeta.seq }}.md</code>. Drop that file into <code>runs/{{ runMeta.task_type }}/user-responses/</code> and the next run picks your answers up on its own.</p>
     <pre id="user-response-output" aria-live="polite"></pre>
   </footer>
   <script id="run-meta" type="application/json">{{ {

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

@@ -1,46 +1,46 @@
 {% 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>
+  <h2>Review this analysis</h2>
+  <fieldset><legend>Verdict</legend>
+    <input id="analysis-review-accepted" type="radio" name="analysis-review-status" value="accepted"><label for="analysis-review-accepted">Accept</label>
+    <input id="analysis-review-revision-requested" type="radio" name="analysis-review-status" value="revision-requested"><label for="analysis-review-revision-requested">Request changes</label>
+    <input id="analysis-review-rejected" type="radio" name="analysis-review-status" value="rejected"><label for="analysis-review-rejected">Reject</label>
   </fieldset>
-  <label for="analysis-review-affected-ids">영향받는 ID</label>
+  <label for="analysis-review-affected-ids">Affected ids</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>
+  <label for="analysis-review-reason">Why</label><textarea id="analysis-review-reason" rows="3"></textarea>
+  <label for="analysis-review-evidence">Further evidence</label><textarea id="analysis-review-evidence" rows="3"></textarea>
+  <label for="analysis-review-scope-change">Scope change requested</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>
+  <h2>Approve this plan</h2>
+  <label for="approval-option">Implementation 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 | inline_code }} (권장)</option>{% else %}<option value="{{ name }}">{{ name | inline_code }}</option>{% endif %}
+      {% if name == state.recommended_option %}<option data-recommended="true" selected value="{{ name }}">{{ name | inline_code }} (recommended)</option>{% else %}<option value="{{ name }}">{{ name | inline_code }}</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 %}
+  <input type="checkbox" id="approval-checkbox"{% if state.disabled_reason %} disabled{% endif %}><label for="approval-checkbox">I approve this plan.</label>
+  {% if state.disabled_reason %}<div class="approval-disabled-reason"><p>Approval is held: <strong>{{ state.disabled_reason }}</strong>.</p><p>Answer {{ state.blocker_ids | join(', ') }}, export your answers, then regenerate the report with the clarification resume command.</p></div>{% endif %}
 </section>
 {%- endmacro %}
 
 {% macro clarification_responses(items) -%}
 {% if items %}
-<section class="clarification-responses" aria-label="답변이 필요한 질문">
-  <h2>답변이 필요한 질문 {{ items | length }}개</h2>
-  <p class="clarification-lede">코드만 봐서는 정할 수 없어 남겨 둔 항목입니다. 답을 채운 뒤 맨 아래 <strong>사용자 응답 내보내기</strong>를 누르세요.</p>
+<section class="clarification-responses" aria-label="Questions waiting on you">
+  <h2>{{ items | length }} questions waiting on you</h2>
+  <p class="clarification-lede">The code alone could not settle these. Fill in your answers, then press <strong>Export my answers</strong> at the foot of the page.</p>
   {% for row in items %}
-  <article class="clarification-item" data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
+  <article class="clarification-item" id="id-{{ row.id }}" data-response-id="{{ row.id }}" data-kind="{{ row.kind }}">
     <p class="eyebrow">{{ row.id }} · {{ row.kind }}</p>
     {{ row.statement | paragraphs }}
-    <p class="clarification-expected"><strong>답변 형식</strong> — {{ row.expectedForm | inline_code }}</p>
-    <label for="response-{{ row.id }}">{{ row.id }} 답변</label>
+    <dl class="clarification-expected"><dt>Answer as</dt><dd>{{ row.expectedForm | inline_code }}</dd></dl>
+    <label for="response-{{ row.id }}">Your answer to {{ row.id }}</label>
     <textarea id="response-{{ row.id }}" data-response-id="{{ row.id }}" rows="4">{{ row.userInput | default('') }}</textarea>
   </article>
   {% endfor %}