Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

docs(grok): drop the last three copies of the PostCompact-mints-an-id claim

Xavi Guardiabf747906e90c
diff --git a/src/core/grok-hook-session.ts b/src/core/grok-hook-session.ts
index 9131b04c9..5c26d4e9c 100644
--- a/src/core/grok-hook-session.ts
+++ b/src/core/grok-hook-session.ts
@@ -17,8 +17,8 @@ export interface GrokHookSessionDeps {
/**
* Decode the two Grok hook dialects and decide the session-map transition once for both shells.
- * Grok 1.0.13 gives PostCompact a newly minted session id, so that event retires the prior id;
- * SessionEnd retires the id carried by the event itself.
+ * SessionEnd is the only event that retires an id, and it retires the one the event itself carries.
+ * Measured on grok 1.0.13: compaction does NOT mint a new id (see the note in the body).
*/
export function planGrokHookSession(
payload: Record<string, unknown>,
diff --git a/src/main/index.ts b/src/main/index.ts
index 94b47c36c..d2c1f4202 100644
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -2717,9 +2717,11 @@ app.whenReady().then(async () => {
// `updates.jsonl`, which holds no readable conversation, so this path deliberately ignores
// the advertised value and derives the session directory instead. Core
// owns the node/session/directory transition (`applyGrokHookSession`) so desktop and Server
- // Edition cannot implement different event branches — including the one thing only it does:
- // PostCompact mints a NEW session id, so the PRIOR id is retired there and not only on
- // SessionEnd. Written inline, that transition existed in two copies and neither knew it.
+ // Edition cannot implement different event branches. Written inline, that transition existed
+ // in two copies and neither knew it. (An earlier version of this comment claimed PostCompact
+ // mints a NEW session id and retires the prior one. Measured on 1.0.13: it does not —
+ // `pre_compact` and `post_compact` carry the SAME id — and the branch that acted on the
+ // belief is gone. SessionEnd is the only event that retires an id.)
//
// What stays HERE is what needs a shell to exist: the per-shell context tail and the phone
// mirror. `plan` carries the decoded event/session/cwd, so the dialect is still decoded in
diff --git a/src/server/agent-status.ts b/src/server/agent-status.ts
index ffde928e1..75d767dd6 100644
--- a/src/server/agent-status.ts
+++ b/src/server/agent-status.ts
@@ -208,9 +208,11 @@ export function wireAgentStatus(
// `updates.jsonl`, which holds no readable conversation, so this path deliberately ignores
// the advertised value and derives the session directory instead. Core
// owns the node/session/directory transition (`applyGrokHookSession`) so desktop and Server
- // Edition cannot implement different event branches — including the one thing only it does:
- // PostCompact mints a NEW session id, so the PRIOR id is retired there and not only on
- // SessionEnd. Written inline, that transition existed in two copies and neither knew it.
+ // Edition cannot implement different event branches. Written inline, that transition existed
+ // in two copies and neither knew it. (An earlier version of this comment claimed PostCompact
+ // mints a NEW session id and retires the prior one. Measured on 1.0.13: it does not —
+ // `pre_compact` and `post_compact` carry the SAME id — and the branch that acted on the
+ // belief is gone. SessionEnd is the only event that retires an id.)
//
// What stays HERE is what needs a shell to exist: the per-shell context tail and the phone
// mirror. `plan` carries the decoded event/session/cwd, so the dialect is still decoded in