From 58b86839afe184ab22b4abc98ddd55428b653944 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Thu, 2 Jul 2026 00:29:33 +0800
Subject: [PATCH] docs(compaction): flag missing snapshot coverage with a FIXME

The compaction e2e is the only coverage of runaway compaction; there is
no keyless full-transcript snapshot. Record why in a FIXME on the e2e
module doc: dsh-llm-replay rebuilds one model call per (turn, step) from
assistant/chunk events, but summarize() assembles its stream locally and
appends none, so the interleaved summarization call is unreplayable until
the replay harness can serve it.
---
 examples/coding-agent/tests/compaction.e2e.ts | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/examples/coding-agent/tests/compaction.e2e.ts b/examples/coding-agent/tests/compaction.e2e.ts
index 39483dc848..2b8f278be3 100644
--- a/examples/coding-agent/tests/compaction.e2e.ts
+++ b/examples/coding-agent/tests/compaction.e2e.ts
@@ -18,6 +18,13 @@ import { codingHarness, finalText, SYSTEM_PROMPT, waitForIdle } from './harness.
  * landed in the real session log, the surface actually shrank (a replace node
  * exists and shadowed older nodes), and the agent still produced a final answer
  * after compaction (so the summarized history did not break the conversation).
+ *
+ * FIXME(compaction-snapshot): this key-gated e2e is the ONLY coverage of runaway
+ * compaction — there is no keyless full-transcript snapshot of it. dsh-llm-replay
+ * reconstructs one model call per (turn, step) from `assistant/chunk` events, but
+ * `summarize()` assembles its stream into a local BlockAssembler and appends no
+ * `assistant/chunk`, so the interleaved summarization call is unreplayable. A
+ * snapshot needs replay-harness work to serve that call; deferred as a follow-up.
  */
 
 let workdir: string | undefined