From f7f933c6e0a127bd2b56336338512092fec0399d Mon Sep 17 00:00:00 2001
From: David Brailovsky <davidbrai@gmail.com>
Date: Fri, 7 Aug 2026 22:22:34 +0200
Subject: [PATCH] docs(agent): clarify remaining v3 normalization

---
 packages/agent/src/harness/session/jsonl/v3.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/agent/src/harness/session/jsonl/v3.ts b/packages/agent/src/harness/session/jsonl/v3.ts
index aff457d79..9b5a67519 100644
--- a/packages/agent/src/harness/session/jsonl/v3.ts
+++ b/packages/agent/src/harness/session/jsonl/v3.ts
@@ -155,7 +155,9 @@ export function parseJsonlV3Entry(line: string, seq: number): Result<Entry, Json
 					} satisfies CustomMessage,
 				} satisfies MessageEntry;
 			default:
-				// TODO(J4): Decode and normalize the remaining supported coding-agent v3 entry types.
+				// TODO(J4): Normalize v3 compaction and branch_summary entries, preserving details, usage,
+				// and required fromHook provenance, and materialize firstKeptEntryId as retainedTail.
+				// TODO(J4): Decode and normalize the remaining label and session_info entry types.
 				throw new JsonlDecodeError("schema", `has unsupported entry type ${String(value.type)}`);
 		}
 	});