okstra 0.117.0 → 0.119.0

package/docs/project-structure-overview.md

@@ -1,6 +1,6 @@
 # Okstra — 폴더 구조 및 기능 요약
 
-> 현재 저장소 기준의 living map입니다. 빠른 사용법은 [`README.kr.md`](../README.kr.md), 내부 실행 계약은 [`docs/kr/architecture.md`](kr/architecture.md), CLI 세부 옵션은 [`docs/kr/cli.md`](kr/cli.md)를 함께 보세요.
+> 현재 저장소 기준의 living map입니다. 빠른 사용법은 [`README.md`](../README.md), 내부 실행 계약은 [`docs/architecture.md`](architecture.md), 저장 구조는 [`docs/architecture/storage-model.md`](architecture/storage-model.md), CLI 세부 옵션은 [`docs/cli.md`](cli.md)를 함께 보세요.
 
 ---
 
@@ -54,19 +54,21 @@ okstra/
 │   ├── okstra_vendor/               vendored Jinja2 / MarkupSafe + graphify / networkx (okstra-graphify skill)
 │   ├── lib/okstra/                  Bash helpers for okstra.sh
 │   └── lib/okstra-ctl/              Bash control-center subcommands
-├── skills/                          Claude Code skills (10)
+├── skills/                          Claude Code skills (11)
 ├── agents/                          lead SKILL.md + worker agent specs
 ├── prompts/                         launch template, phase profiles, wizard prompt JSON
 ├── schemas/                         JSON schema for final-report data.json
 ├── templates/                       report, setup, PR, project-doc templates/assets
 ├── validators/                      run / brief / schedule / view validators
 ├── tools/build.mjs                  source → runtime sync
+├── tools/docs_publication/          public-manual publication pipeline (build-time only; not shipped)
+├── config/docs-publication.json     publication inventory: every tracked Markdown path + classification
 ├── runtime/                         generated install payload; do not edit directly
 ├── tests/                           pytest unit suite
 ├── tests-e2e/                       Bash end-to-end scenarios
 ├── docs/                            architecture, CLI, plans/specs
 ├── package.json                     npm metadata and published file list
-├── README.md / README.kr.md         user manuals
+├── README.md                        public user manual
 ├── CHANGES.md / CHANGELOG.md        human-authored and generated changelogs
 └── RELEASING.md                     release process
 ```
@@ -84,9 +86,13 @@ okstra/
 - `bin/`
 - `src/`
 - `runtime/`
-- `docs/`
+- `docs/architecture.md`
+- `docs/architecture/`
+- `docs/cli.md`
+- `docs/container.md`
+- `docs/performance-improvement-plan-v2.md`
+- selected contributor, follow-up, AI, and task-process documentation paths
 - `README.md`
-- `README.kr.md`
 
 So `runtime/` is not the only npm-published content. It is the install payload copied into `~/.okstra`.
 
@@ -142,7 +148,7 @@ Runtime/install asset changes follow this checklist:
 
 `bin/okstra` is a thin dynamic-import router. Every command module exports `run(args) -> Promise<number>` or a named install/uninstall runner.
 
-`src/` is layered: the dispatch table (`src/cli-registry.mjs`) stays at the root, shared infrastructure with no command export lives under `src/lib/`, and command modules are grouped by domain under `src/commands/{lifecycle,execute,inspect,report,memory}/`.
+`src/` is layered: the dispatch table (`src/cli-registry.mjs`) stays at the root, shared infrastructure with no command export lives under `src/lib/`, and command modules are grouped by domain under `src/commands/{lifecycle,execute,inspect,report,memory,pr}/`.
 
 | Command | Module | Role |
 |---|---|---|
@@ -175,6 +181,7 @@ Runtime/install asset changes follow this checklist:
 | `token-usage` | `src/commands/execute/token-usage.mjs` | Wrap installed Python token usage CLI |
 | `spawn-followups`, `error-log` | `src/commands/execute/*.mjs` | Follow-up task bundle creation and run error-log append helpers |
 | `memory` | `src/commands/memory/memory.mjs` | Store/find global conversation memory under `~/.okstra/memory-book` |
+| `pr` | `src/commands/pr/pr.mjs` | `okstra pr <template\|branches\|gen>` — PR body template store under `~/.okstra/template/pr/` (bundled fallback `src/commands/pr/default.md`), base-branch recommendation, and the `gen` JSON bundle (template + `<base>..HEAD` commits + `<base>...HEAD` diffstat) backing the okstra-pr-gen skill. Git-only; no project registration required |
 | `recap` | `src/commands/inspect/recap.mjs` | `okstra recap <assemble\|record>` Node wrapper backing the okstra-inspect `recap` facet |
 | `rollup` | `src/commands/inspect/rollup.mjs` | `okstra rollup` thin shim into `scripts/okstra_ctl/rollup.py` — read-only cross-task roll-up backing the okstra-rollup skill |
 | `container` | `src/commands/inspect/container.mjs` | `bin okstra container` thin shim into `scripts/okstra_ctl/container.py` for the okstra-container-build skill |
@@ -313,7 +320,7 @@ Optional (v1.0 하위호환) 최상위 키:
 
 ### 4.10 `skills/`
 
-9 user-facing skills (the only skills `okstra install` copies):
+11 user-facing skills (the only skills `okstra install` copies). The list SSOT is `USER_SKILL_NAMES` in `src/lib/skill-catalog.mjs`; the Claude plugin manifest and the installer both derive from it:
 
 | Skill | User-invocable | Role |
 |---|---:|---|
@@ -324,6 +331,8 @@ Optional (v1.0 하위호환) 최상위 키:
 | `okstra-rollup` | yes | Cross-task roll-up — aggregate runs/time/errors across a task-group (or whole project) and synthesize a digest from the report files |
 | `okstra-schedule` | yes | Generate task-group schedule |
 | `okstra-container-build` | yes | Non-linear deploy tool — deploy a verified task's code as a docker compose group and watch each container (sub-commands `up` / `status` / `logs` / `stop-watcher` / `down`) |
+| `okstra-graphify` | yes | Knowledge graph over the project's own `.okstra/` memory — final reports, `decisions/*.md`, `glossary.md`; scope restricted to `.okstra/`, output under `.okstra/graph/` (sub-commands `build` / `query` / `path` / `explain` / `mcp` / `wiki`) |
+| `okstra-pr-gen` | yes | Register PR body templates under `~/.okstra/template/pr/` and generate a PR description from a branch diff (drives `okstra pr template` / `branches` / `gen`). **Global skill** — needs a Git repo, not `<PROJECT_ROOT>/.okstra/project.json` |
 | `okstra-manager` | yes | Coordinate cross-project okstra tasks through manager-owned plans, assignments, sync snapshots, status, and child launch context packets |
 | `okstra-setup` | yes | Install/check runtime and register project |
 
@@ -488,11 +497,13 @@ Final report artifacts live under `runs/<task-type>/reports/`. Human responses f
 
 When changing code, keep these docs in sync:
 
-- New Node command: update `bin/okstra` usage, `README*`, this file, and `docs/kr/cli.md`.
+- New Node command: update `bin/okstra` usage, `README.md`, this file, and `docs/cli.md`.
 - New runtime source copied to users: update `tools/build.mjs`, install/uninstall manifests if applicable, and this file.
-- New skill/agent: update `README*`, this file, install/uninstall fallback lists, and `CHANGES.md`.
+- New skill/agent: update `README.md`, this file, install/uninstall fallback lists, and `CHANGES.md`.
 - New report field/section: update schema, template, report-writer worker, validator tests, this file's report model if user-visible.
-- New phase/profile behavior: update `prompts/profiles/*`, `docs/kr/architecture.md`, `docs/kr/cli.md`, and `README*` if user-facing.
+- New phase/profile behavior: update `prompts/profiles/*`, `docs/architecture.md`, `docs/cli.md`, and `README.md` if user-facing.
+
+`README.md`, `docs/cli.md`, `docs/architecture.md`, `docs/architecture/storage-model.md`, `docs/container.md`, and `docs/performance-improvement-plan-v2.md` are `translated` outputs in `config/docs-publication.json` — do **not** hand-edit them. Author the Korean source under the maintainer's Git-ignored `.project-docs/ko-source/`, then run the publication pipeline (`python3 -m tools.docs_publication prepare|validate|apply|record`), which keeps the source/output hashes in `.project-docs/doc-publishing/state.json` in step. Files classified `pending` — including this one, `CHANGES.md`, and `CHANGELOG.md` — are edited directly.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.117.0",
+  "version": "0.119.0",
   "description": "Multi-agent cross-verification orchestrator runtime + Claude Code skills.",
   "license": "MIT",
   "author": "devonshin",
@@ -16,14 +16,18 @@
     "bin/",
     "src/",
     "runtime/",
+    "docs/architecture.md",
+    "docs/architecture/",
+    "docs/cli.md",
+    "docs/container.md",
     "docs/contributor-change-matrix.md",
+    "docs/follow-ups/2026-07-10-final-report-option-3.md",
     "docs/for-ai/",
-    "docs/kr/",
+    "docs/performance-improvement-plan-v2.md",
     "docs/pr-template-usage.md",
     "docs/project-structure-overview.md",
     "docs/task-process/",
-    "README.md",
-    "README.kr.md"
+    "README.md"
   ],
   "engines": {
     "node": ">=18"
@@ -31,9 +35,10 @@
   "scripts": {
     "build": "node tools/build.mjs",
     "prepack": "node tools/build.mjs",
+    "docs:validate": "python3 -m tools.docs_publication validate --repo .",
     "test:js": "node --test tests-js/*.test.mjs",
     "test:py": "python3 -m pytest tests/",
     "test:workflow": "bash validators/validate-workflow.sh",
-    "check": "npm run build && npm run test:js && npm run test:py && npm run test:workflow"
+    "check": "npm run docs:validate && npm run build && npm run test:js && npm run test:py && npm run test:workflow"
   }
 }

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.117.0",
-  "builtAt": "2026-07-14T11:54:12.876Z",
+  "package": "0.119.0",
+  "builtAt": "2026-07-15T11:10:05.274Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/bin/okstra-render-report-views.py

@@ -23,7 +23,6 @@ from __future__ import annotations
 
 import argparse
 import os
-import re
 import sys
 from pathlib import Path
 
@@ -43,7 +42,7 @@ if (SCRIPTS_DIR / "okstra_ctl" / "report_views.py").is_file():
 elif HOME_LIB.is_dir() and str(HOME_LIB) not in sys.path:
     sys.path.insert(0, str(HOME_LIB))
 
-from okstra_ctl.report_views import RunMeta, render_html_view  # noqa: E402
+from okstra_ctl.report_views import infer_run_meta, render_html_view  # noqa: E402
 
 
 _OKSTRA_HOME = Path(os.environ.get("OKSTRA_HOME", str(Path.home() / ".okstra")))
@@ -60,15 +59,6 @@ _TEMPLATES_DIRS = (
     _OKSTRA_HOME / "templates" / "reports",
 )
 
-# task-type itself can contain hyphens (``implementation-planning``,
-# ``final-verification``, ``release-handoff``), so the filename segment
-# between ``final-report-`` and ``-<seq>.md`` is matched greedily; the
-# trailing ``-(?P<seq>\d+)\.md$`` anchor pins seq to the last numeric tail.
-_PATH_RE = re.compile(
-    r"runs/(?P<task_type>[^/]+)/reports/final-report-.+-(?P<seq>\d+)\.md$"
-)
-
-
 def _load_assets() -> tuple[str, str]:
     css_text: str | None = None
     js_text: str | None = None
@@ -87,23 +77,6 @@ def _load_assets() -> tuple[str, str]:
     return css_text, js_text
 
 
-def _infer_from_path(path: Path) -> dict[str, str]:
-    posix = path.as_posix()
-    m = _PATH_RE.search(posix)
-    if m:
-        return {"task_type": m.group("task_type"), "seq": m.group("seq")}
-    return {}
-
-
-def _infer_from_body(text: str) -> dict[str, str]:
-    found: dict[str, str] = {}
-    for label, key in (("Task Key", "task_key"), ("Task Type", "task_type")):
-        m = re.search(rf"^- {label}:\s*(\S.*?)\s*$", text, re.MULTILINE)
-        if m:
-            found[key] = m.group(1)
-    return found
-
-
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(
         description="Render the self-contained HTML view of an okstra final-report."
@@ -119,14 +92,11 @@ def main(argv: list[str] | None = None) -> int:
     if not report_path.is_file():
         parser.error(f"final-report not found: {report_path}")
 
-    inferred = {**_infer_from_path(report_path), **_infer_from_body(report_path.read_text(encoding="utf-8"))}
-    task_key = args.task_key or inferred.get("task_key") or "unknown"
-    task_type = args.task_type or inferred.get("task_type") or "unknown"
-    seq = args.seq or inferred.get("seq") or "000"
-    source_report = args.source_report or report_path.name
-
+    meta = infer_run_meta(
+        report_path, task_key=args.task_key, task_type=args.task_type,
+        seq=args.seq, source_report=args.source_report,
+    )
     css, js = _load_assets()
-    meta = RunMeta(task_key=task_key, task_type=task_type, seq=seq, source_report=source_report)
     html_path = render_html_view(report_path, run_meta=meta, css=css, js=js)
     if html_path is None:
         print("html: skipped (no §1 clarification rows — html view carries no interactive forms for this report)")

package/runtime/prompts/launch.template.md

@@ -85,6 +85,7 @@ Emit one `PROGRESS: <phase-id> <verb-phrase>` line as plain user-facing text at
 - Source path: `{{CLARIFICATION_RESPONSE_RELATIVE_PATH}}`
 - If the source path above is empty, no prior clarification response was attached to this run.
 - If the source path is set, a copy is staged at `{{INSTRUCTION_SET_RELATIVE_PATH}}/clarification-response.md`. Read it before running workers; reconcile each `C-*` row in section 1 (`## 1. Clarification Items`) of the prior report against new evidence and record the outcome in the conditional `## 0. Clarification Response Carried In From Previous Run` section of this run's final report (render that heading only when carry-in is non-empty — the validator fails empty Section 0 stubs).
+- When a `## <C-id>` block carries `- Disposition: reframe`, it is not an answer but a request to re-question — the user is asking you to redefine this item. Do not treat it as answered; reconstruct the question itself in a fresh `## 1` Clarification Item, and never let a `reframe` item satisfy the approval gate.
 
 ### Incremental re-verification (implementation-planning clarification re-runs only)
 

package/runtime/python/okstra_ctl/clarification_items.py

@@ -208,6 +208,54 @@ def parse_clarification_items(report_text: str) -> Optional[list[ClarificationIt
     return _walk_section_1_table(section).items
 
 
+def parse_clarification_rows(report_text: str) -> list[dict]:
+    """§1 행마다 메타(ClarificationItem) + 원문 Statement / Expected form 셀.
+
+    ``parse_clarification_items`` 와 같은 lenient 계약: §1 부재 또는 헤더
+    미인식이면 ``[]``. §1 테이블 셀 추출의 단일 참조점 — 다른 모듈이 §1
+    레이아웃을 다시 훑지 않도록 이 함수로 통일한다.
+    """
+    section = _section_1_slice(report_text)
+    if section is None:
+        return []
+    lines = section.splitlines()
+    header_idx = -1
+    for idx, line in enumerate(lines):
+        if not line.lstrip().startswith("|"):
+            continue
+        cells = [c.lower() for c in _split_pipe_row(line)]
+        if "user input" in cells and any(c.startswith("statement") for c in cells):
+            header_idx = idx
+            break
+    if header_idx < 0:
+        return []
+    header = [c.lower() for c in _split_pipe_row(lines[header_idx])]
+    s_col = next((j for j, h in enumerate(header) if h.startswith("statement")), -1)
+    e_col = next((j for j, h in enumerate(header) if h.startswith("expected form")), -1)
+    rows: list[dict] = []
+    body = False
+    for line in lines[header_idx + 1:]:
+        if not line.lstrip().startswith("|"):
+            if body:
+                break
+            continue
+        if is_separator_row(line):
+            body = True
+            continue
+        if not body:
+            continue
+        cells = _split_pipe_row(line)
+        item = parse_meta_cell(cells[0]) if cells else None
+        if item is None:
+            continue
+        rows.append({
+            "item": item,
+            "statement": cells[s_col] if 0 <= s_col < len(cells) else "",
+            "expected_form": cells[e_col] if 0 <= e_col < len(cells) else "",
+        })
+    return rows
+
+
 UNRESOLVED_STATUSES = {"open", "answered"}
 
 

package/runtime/python/okstra_ctl/recap.py

@@ -1,6 +1,7 @@
-"""Read-side recap for a task: assemble run-to-run phase transitions and
-append a recap Q&A log. Mutates only <task-root>/recap/recap-log.jsonl;
-never touches task-manifest / catalog / timeline.
+"""Read-side recap for a task: assemble run-to-run phase transitions, append a
+recap Q&A log, and write agent-authored notes. Writes only under
+<task-root>/recap/recap-log.jsonl and <task-root>/notes/; never touches
+task-manifest / catalog / timeline.
 """
 from __future__ import annotations
 
@@ -10,9 +11,12 @@ import json
 import sys
 from pathlib import Path
 
+from okstra_ctl.ids import slugify_task_segment
 from okstra_ctl.run_context import dir_flock
 from okstra_ctl.task_target import resolve_task_root, project_rel
 
+NOTE_KINDS = ("verification-evidence", "decision-draft", "analysis-note")
+
 
 def _load_timeline(task_root: Path) -> list[dict]:
     path = task_root / "history" / "timeline.json"
@@ -91,6 +95,56 @@ def append_recap_entry(task_root, project_root, *, kind, mode, question,
     return {"logPath": project_rel(log_path, project_root), "entry": entry}
 
 
+def _note_path(notes_dir: Path, slug: str, date: str) -> Path:
+    # 같은 날 같은 slug 로 노트를 여러 개 남기면 덮어쓰지 않도록 -2, -3 을 붙인다.
+    base = notes_dir / f"{slug}-{date}.md"
+    if not base.exists():
+        return base
+    seq = 2
+    while (candidate := notes_dir / f"{slug}-{date}-{seq}.md").exists():
+        seq += 1
+    return candidate
+
+
+def _note_frontmatter(*, task_key, kind, created_at, purpose, scope_note) -> str:
+    return (
+        "---\n"
+        f"task-key: {task_key}\n"
+        f"kind: {kind}\n"
+        "author: agent\n"
+        f"created-at: {created_at}\n"
+        f"purpose: {purpose}\n"
+        f"scope-note: {scope_note}\n"
+        "---\n\n"
+    )
+
+
+def write_note(task_root, project_root, *, kind, slug, purpose, scope_note,
+               body, now) -> dict:
+    notes_dir = task_root / "notes"
+    notes_dir.mkdir(parents=True, exist_ok=True)
+    created_at = now.date().isoformat()
+    slug_seg = slugify_task_segment(slug)
+    if not slug_seg:
+        raise ValueError("slug must contain at least one alphanumeric character")
+    path = _note_path(notes_dir, slug_seg, created_at)
+    task_key = _task_key(task_root)
+    frontmatter = _note_frontmatter(
+        task_key=task_key, kind=kind, created_at=created_at,
+        purpose=purpose, scope_note=scope_note)
+    path.write_text(frontmatter + body.rstrip("\n") + "\n", encoding="utf-8")
+    note_rel = project_rel(path, project_root)
+    return {
+        "notePath": note_rel,
+        "taskKey": task_key,
+        "kind": kind,
+        "createdAt": created_at,
+        # 노트는 inert — 다음 run 이 자동으로 읽지 않는다. 이 인자를 그대로
+        # `okstra run ...` 에 붙여야만 instruction-set 에 주입된다.
+        "clarificationResponseArg": f"--clarification-response {note_rel}",
+    }
+
+
 def _add_common(sp) -> None:
     # skill 이 쓰는 `<verb> <target> --project-root <root>` 형태를 받으려면
     # 공통 옵션을 부모가 아닌 각 서브파서에 등록해야 한다.
@@ -115,12 +169,35 @@ def main(argv: list[str] | None = None) -> int:
     p_rec.add_argument("--answer", required=True)
     p_rec.add_argument("--citation", action="append", default=[])
 
+    p_note = sub.add_parser(
+        "note", help="write an agent-authored note into <task-root>/notes/")
+    p_note.add_argument("target", help="task root path or task-key")
+    _add_common(p_note)
+    p_note.add_argument("--kind", choices=NOTE_KINDS, required=True)
+    p_note.add_argument("--slug", required=True,
+                        help="short topic slug for the filename")
+    p_note.add_argument("--purpose", required=True,
+                        help="one line — what it is and which run/decision it feeds")
+    p_note.add_argument("--scope-note", required=True, dest="scope_note",
+                        help="one line — what it is NOT (e.g. not a user decision)")
+    body_src = p_note.add_mutually_exclusive_group(required=True)
+    body_src.add_argument("--body", help="inline markdown body")
+    body_src.add_argument("--body-file", dest="body_file",
+                          help="path to a file holding the markdown body")
+
     args = parser.parse_args(argv)
     task_root, project_root = resolve_task_root(
         args.target, args.project_root, args.cwd)
 
     if args.command == "assemble":
         result = assemble_recap(task_root, project_root)
+    elif args.command == "note":
+        body = (Path(args.body_file).read_text(encoding="utf-8")
+                if args.body_file else args.body)
+        result = write_note(
+            task_root, project_root, kind=args.kind, slug=args.slug,
+            purpose=args.purpose, scope_note=args.scope_note, body=body,
+            now=dt.datetime.now(dt.timezone.utc))
     else:
         result = append_recap_entry(
             task_root, project_root, kind=args.kind, mode=args.mode,

package/runtime/python/okstra_ctl/report_views.py

@@ -108,6 +108,46 @@ class RunMeta:
     source_report: str  # relative path of the .md the HTML is derived from
 
 
+# task-type itself can contain hyphens (``implementation-planning``,
+# ``final-verification``, ``release-handoff``), so the filename segment
+# between ``final-report-`` and ``-<seq>.md`` is matched greedily; the
+# trailing ``-(?P<seq>\d+)\.md$`` anchor pins seq to the last numeric tail.
+_REPORT_PATH_RE = re.compile(
+    r"runs/(?P<task_type>[^/]+)/reports/final-report-.+-(?P<seq>\d+)\.md$"
+)
+
+
+def _infer_run_meta_from_path(path: Path) -> dict:
+    m = _REPORT_PATH_RE.search(path.as_posix())
+    return {"task_type": m.group("task_type"), "seq": m.group("seq")} if m else {}
+
+
+def _infer_run_meta_from_body(text: str) -> dict:
+    found: dict[str, str] = {}
+    for label, key in (("Task Key", "task_key"), ("Task Type", "task_type")):
+        m = re.search(rf"^- {label}:\s*(\S.*?)\s*$", text, re.MULTILINE)
+        if m:
+            found[key] = m.group(1)
+    return found
+
+
+def infer_run_meta(report_path: Path, *, task_key: Optional[str] = None,
+                   task_type: Optional[str] = None, seq: Optional[str] = None,
+                   source_report: Optional[str] = None) -> RunMeta:
+    """Derive a ``RunMeta`` from a final-report path/body, honouring any
+    explicit override. Single reference point for BOTH the HTML view render
+    script and the in-session user-response writer, so sidecar match keys
+    (task_type/seq/source-report) never drift between the two paths."""
+    text = report_path.read_text(encoding="utf-8")
+    inferred = {**_infer_run_meta_from_path(report_path), **_infer_run_meta_from_body(text)}
+    return RunMeta(
+        task_key=task_key or inferred.get("task_key") or "unknown",
+        task_type=task_type or inferred.get("task_type") or "unknown",
+        seq=seq or inferred.get("seq") or "000",
+        source_report=source_report or report_path.name,
+    )
+
+
 @dataclass(frozen=True)
 class ReportViewModel:
     run_meta: RunMeta
@@ -924,6 +964,7 @@ class UserResponseEntry:
     kind: str
     value: str
     rationale: Optional[str] = None
+    disposition: str = "answer"
 
 
 @dataclass(frozen=True)
@@ -961,12 +1002,11 @@ def serialize_user_response(
     has_approval = approval is not None and approval.approved
     body_chunks: list[str] = []
     for e in entries:
-        chunk = (
-            f"\n## {e.response_id}\n"
-            f"- Kind: {e.kind}\n"
-            "- Value:\n"
-            f"  > {e.value.strip()}\n"
-        )
+        chunk = f"\n## {e.response_id}\n- Kind: {e.kind}\n"
+        if e.disposition != "answer":
+            chunk += f"- Disposition: {e.disposition}\n"
+        value_lines = e.value.strip().split("\n")
+        chunk += "- Value:\n" + "".join(f"  > {ln}\n" for ln in value_lines)
         if e.rationale:
             chunk += f"- Rationale: {e.rationale.strip()}\n"
         body_chunks.append(chunk)