From 59cc90868d4f26e9429a44302bd57dee6967fed5 Mon Sep 17 00:00:00 2001 From: ework-agent Date: Sun, 6 Sep 2026 19:14:16 +0800 Subject: [PATCH] docs: correct false renumber claim in preflight comment (#387) The kernel has no ref-renumbering mechanism (verified in #387): refs are stable per-session snapshots. The real reason the pipeline must re-run each preflight round is that a successful compress hides its range behind a new block, changing which ranges remain compressible under the same refs. --- src/preflight.ts | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/preflight.ts b/src/preflight.ts index 302892578d..e06d668294 100644 --- a/src/preflight.ts +++ b/src/preflight.ts @@ -271,8 +271,10 @@ export async function preflightCompress(deps: PreflightDeps, messages: CoreMessa failure = ABORTED_FAILURE; break; } - // Re-run the pipeline each round: every successful compress renumbers - // the surviving refs, so the previous round's range refs are stale. + // Re-run the pipeline each round: a successful compress hides its + // range behind a new block, changing the visible view; refs stay + // stable per-session snapshots (#387), but which ranges are + // compressible under them does not. const turn = deps.core.processTurn({ messages, state: deps.session.state,