switchroom 0.19.31 → 0.19.33

package/telegram-plugin/dist/gateway/gateway.js

@@ -44732,7 +44732,7 @@ async function handleVoiceMessage(ctx, deps) {
 }
 
 // gateway/status-pin-store.ts
-var SNAPSHOT_VERSIONS = new Set([1, 2, 3, 4]);
+var SNAPSHOT_VERSION = 4;
 function isPinRow(x) {
   if (x == null || typeof x !== "object")
     return false;
@@ -44757,12 +44757,12 @@ function loadStatusPins(path, fs2) {
   if (parsed == null || typeof parsed !== "object")
     return [];
   const env = parsed;
-  if (typeof env.v !== "number" || !SNAPSHOT_VERSIONS.has(env.v) || !Array.isArray(env.pins))
+  if (!Number.isInteger(env.v) || env.v < 1 || !Array.isArray(env.pins))
     return [];
   return env.pins.filter(isPinRow);
 }
 function persistStatusPins(path, fs2, snapshot, log = (l) => process.stderr.write(l)) {
-  const env = { v: 4, pins: [...snapshot] };
+  const env = { v: SNAPSHOT_VERSION, pins: [...snapshot] };
   const tmp = path + ".tmp";
   try {
     fs2.writeFileSync(tmp, JSON.stringify(env));
@@ -71213,6 +71213,9 @@ function projectTranscriptLine(line) {
     if (op === "dequeue") {
       return [{ kind: "dequeue" }];
     }
+    if (op === "remove") {
+      return [{ kind: "queue_remove", rawContent: obj.content ?? "" }];
+    }
     return [];
   }
   if (type === "assistant") {
@@ -79814,6 +79817,195 @@ function decideFallbackTeardownNotice2(input) {
 }
 
 // gateway/stream-render.ts
+var PARKED_TURN_START_MAX = 16;
+var PARKED_TURN_START_TTL_MS = 30 * 60000;
+var parkedTurnStarts = [];
+function pruneParkedTurnStarts(now) {
+  for (let i = parkedTurnStarts.length - 1;i >= 0; i--) {
+    if (now - parkedTurnStarts[i].parkedAt > PARKED_TURN_START_TTL_MS) {
+      const [dropped] = parkedTurnStarts.splice(i, 1);
+      process.stderr.write(`telegram gateway: parked-turn-start expired chat=${dropped.chatId ?? "-"} ` + `msg=${dropped.messageId ?? "-"} age_ms=${now - dropped.parkedAt}
+`);
+    }
+  }
+}
+function parkTurnStart(env, now) {
+  parkedTurnStarts.push({ ...env, parkedAt: now });
+  while (parkedTurnStarts.length > PARKED_TURN_START_MAX) {
+    const [dropped] = parkedTurnStarts.splice(0, 1);
+    process.stderr.write(`telegram gateway: parked-turn-start evicted (cap ${PARKED_TURN_START_MAX}) ` + `chat=${dropped.chatId ?? "-"} msg=${dropped.messageId ?? "-"}
+`);
+  }
+}
+function takeParkedTurnStart() {
+  return parkedTurnStarts.pop() ?? null;
+}
+function discardParkedTurnStart(rawContent) {
+  for (let i = parkedTurnStarts.length - 1;i >= 0; i--) {
+    if (parkedTurnStarts[i].rawContent === rawContent) {
+      parkedTurnStarts.splice(i, 1);
+      return true;
+    }
+  }
+  return false;
+}
+function beginTurn(deps, ev) {
+  const {
+    HANDBACK_PRETURN_ENABLED,
+    STATE_DIR,
+    clearActivitySummary,
+    extractUserPromptPreview,
+    getCurrentTurn,
+    getPendingPtyPartial,
+    handbackPreturnSignal,
+    handlePtyPartial,
+    isDmChatId,
+    makeNarrativeGate,
+    pendingCrossTurnGate,
+    preambleSuppressor,
+    promoteQueuedStatus,
+    rememberRecentTurn,
+    scheduleEarlyLivenessOpen,
+    setCurrentTurn,
+    setPendingPtyPartial,
+    startTurnTypingLoop,
+    statusKey,
+    turnsDb,
+    typingWrapper
+  } = deps;
+  typingWrapper.drainAll();
+  if (ev.chatId) {
+    const enqThreadId = ev.threadId != null ? Number(ev.threadId) : undefined;
+    clearPending2(statusKey(ev.chatId, enqThreadId), "handback");
+  }
+  if (ev.chatId) {
+    const prior = getCurrentTurn();
+    if (prior?.answerStream != null) {
+      prior.answerStream.forceNewMessage();
+      prior.answerStream.stop();
+      prior.answerStream = null;
+    }
+    if (prior?.orphanedReplyTimeoutId != null) {
+      clearTimeout(prior.orphanedReplyTimeoutId);
+      prior.orphanedReplyTimeoutId = null;
+    }
+    prior?.narrativeGate?.teardown();
+    if (prior != null && prior.endedAt == null) {
+      clearActivitySummary(prior);
+      process.stderr.write(`telegram gateway: ${formatTurnLifecycle("clear", "superseded", prior, Date.now())}
+`);
+    }
+    const startedAt = Date.now();
+    const enqThreadIdNum = ev.threadId != null ? Number(ev.threadId) : undefined;
+    const turnId = deriveTurnId(ev.chatId, enqThreadIdNum ?? null, ev.messageId) ?? `${chatKey(ev.chatId, enqThreadIdNum ?? null)}#synthetic-${startedAt}`;
+    const xTurnGateKey = turnId;
+    const consumedCrossTurnGate = pendingCrossTurnGate.get(xTurnGateKey);
+    if (consumedCrossTurnGate != null)
+      pendingCrossTurnGate.delete(xTurnGateKey);
+    const next = {
+      sessionChatId: ev.chatId,
+      sessionThreadId: enqThreadIdNum,
+      sourceMessageId: parseSourceMessageId(ev.messageId),
+      startedAt,
+      gatewayReceiveAt: startedAt,
+      role: deriveTurnRole(ev.rawContent),
+      ...consumedCrossTurnGate != null ? { crossTurnGate: consumedCrossTurnGate } : {},
+      replyCalled: false,
+      finalAnswerDelivered: false,
+      finalAnswerSubstantive: false,
+      finalAnswerEverDelivered: false,
+      answerDelivered: false,
+      flushedAnswerText: null,
+      endedAt: null,
+      firstPingAt: null,
+      firstPingWasSubstantive: false,
+      silentAnchorMessageId: null,
+      silentAnchorText: "",
+      capturedText: [],
+      capturedBlockMeta: [],
+      orphanedReplyTimeoutId: null,
+      answerReadyFlushTimeoutId: null,
+      liveness: new LivenessTracker(startedAt),
+      turnId,
+      registryKey: null,
+      noReplyDrainTimer: null,
+      lastAssistantMsgId: null,
+      lastAssistantDone: false,
+      toolCallCount: 0,
+      labeledToolCount: 0,
+      totalTokens: 0,
+      seenUsageMessageIds: new Set,
+      activityMessageId: null,
+      activityInFlight: null,
+      activityPendingRender: null,
+      activityLastSentRender: null,
+      activityEverOpened: false,
+      activityDrainFailures: 0,
+      mirrorLines: [],
+      narrativeGate: undefined,
+      lastReplyText: "",
+      foregroundSubAgents: new Map,
+      answerStream: null,
+      isDm: isDmChatId(ev.chatId),
+      emissionAuthority: new EmissionAuthority(statusKey(ev.chatId, enqThreadIdNum))
+    };
+    next.narrativeGate = makeNarrativeGate(next);
+    if (HANDBACK_PRETURN_ENABLED) {
+      const handbackAdoption = handbackPreturnSignal.tryAdopt(turnId);
+      if (handbackAdoption != null) {
+        if (handbackAdoption.activityMessageId != null) {
+          next.activityMessageId = handbackAdoption.activityMessageId;
+          next.activityEverOpened = true;
+        }
+        process.stderr.write(`telegram gateway: handback pre-turn adopted turnId=${turnId} ` + `key=${handbackAdoption.statusKey} card=${handbackAdoption.activityMessageId ?? "none"}
+`);
+      }
+    }
+    startTurnTypingLoop(ev.chatId, enqThreadIdNum ?? null);
+    setCurrentTurn(next, statusKey(ev.chatId, enqThreadIdNum));
+    scheduleEarlyLivenessOpen(next);
+    process.stderr.write(`telegram gateway: ${formatTurnLifecycle("set", "enqueue", next, startedAt)}
+`);
+    rememberRecentTurn(next);
+    promoteQueuedStatus(ev.chatId, enqThreadIdNum);
+    shadowEmit({
+      kind: "turnStart",
+      key: statusKey(ev.chatId, ev.threadId != null ? Number(ev.threadId) : undefined),
+      at: startedAt
+    });
+    preambleSuppressor.reset();
+    clearSilentEndState2(statusKey(ev.chatId, ev.threadId != null ? Number(ev.threadId) : null));
+    if (turnsDb != null) {
+      const evThreadIdNum = ev.threadId != null ? Number(ev.threadId) : null;
+      const turnKey3 = chatKeyWithSuffix(ev.chatId, evThreadIdNum, String(startedAt));
+      next.registryKey = turnKey3;
+      const userPromptPreview = extractUserPromptPreview(ev.rawContent);
+      try {
+        recordTurnStart(turnsDb, {
+          turnKey: turnKey3,
+          chatId: String(ev.chatId),
+          threadId: ev.threadId != null ? String(ev.threadId) : null,
+          lastUserMsgId: ev.messageId != null ? String(ev.messageId) : null,
+          userPromptPreview
+        });
+      } catch (err) {
+        process.stderr.write(`telegram gateway: recordTurnStart failed turnKey=${turnKey3}: ${err.message}
+`);
+      }
+      writeTurnActiveMarker(STATE_DIR, {
+        turnKey: turnKey3,
+        chatId: String(ev.chatId),
+        threadId: ev.threadId != null ? String(ev.threadId) : null,
+        startedAt
+      });
+    }
+    const pending = getPendingPtyPartial();
+    if (pending != null) {
+      setPendingPtyPartial(null);
+      handlePtyPartial(pending);
+    }
+  }
+}
 function handleSessionEvent(deps, ev) {
   const {
     ANSWER_LANE,
@@ -79910,140 +80102,47 @@ function handleSessionEvent(deps, ev) {
   }
   switch (ev.kind) {
     case "enqueue": {
-      typingWrapper.drainAll();
-      if (ev.chatId) {
-        const enqThreadId = ev.threadId != null ? Number(ev.threadId) : undefined;
-        clearPending2(statusKey(ev.chatId, enqThreadId), "handback");
-      }
+      const enqThreadIdNum = ev.threadId != null ? Number(ev.threadId) : undefined;
+      const now = Date.now();
       if (ev.chatId) {
-        const prior = getCurrentTurn();
-        if (prior?.answerStream != null) {
-          prior.answerStream.forceNewMessage();
-          prior.answerStream.stop();
-          prior.answerStream = null;
-        }
-        if (prior?.orphanedReplyTimeoutId != null) {
-          clearTimeout(prior.orphanedReplyTimeoutId);
-          prior.orphanedReplyTimeoutId = null;
-        }
-        prior?.narrativeGate?.teardown();
-        const startedAt = Date.now();
-        const enqThreadIdNum = ev.threadId != null ? Number(ev.threadId) : undefined;
-        const turnId = deriveTurnId(ev.chatId, enqThreadIdNum ?? null, ev.messageId) ?? `${chatKey(ev.chatId, enqThreadIdNum ?? null)}#synthetic-${startedAt}`;
-        const xTurnGateKey = turnId;
-        const consumedCrossTurnGate = pendingCrossTurnGate.get(xTurnGateKey);
-        if (consumedCrossTurnGate != null)
-          pendingCrossTurnGate.delete(xTurnGateKey);
-        const next = {
-          sessionChatId: ev.chatId,
-          sessionThreadId: enqThreadIdNum,
-          sourceMessageId: parseSourceMessageId(ev.messageId),
-          startedAt,
-          gatewayReceiveAt: startedAt,
-          role: deriveTurnRole(ev.rawContent),
-          ...consumedCrossTurnGate != null ? { crossTurnGate: consumedCrossTurnGate } : {},
-          replyCalled: false,
-          finalAnswerDelivered: false,
-          finalAnswerSubstantive: false,
-          finalAnswerEverDelivered: false,
-          answerDelivered: false,
-          flushedAnswerText: null,
-          endedAt: null,
-          firstPingAt: null,
-          firstPingWasSubstantive: false,
-          silentAnchorMessageId: null,
-          silentAnchorText: "",
-          capturedText: [],
-          capturedBlockMeta: [],
-          orphanedReplyTimeoutId: null,
-          answerReadyFlushTimeoutId: null,
-          liveness: new LivenessTracker(startedAt),
-          turnId,
-          registryKey: null,
-          noReplyDrainTimer: null,
-          lastAssistantMsgId: null,
-          lastAssistantDone: false,
-          toolCallCount: 0,
-          labeledToolCount: 0,
-          totalTokens: 0,
-          seenUsageMessageIds: new Set,
-          activityMessageId: null,
-          activityInFlight: null,
-          activityPendingRender: null,
-          activityLastSentRender: null,
-          activityEverOpened: false,
-          activityDrainFailures: 0,
-          mirrorLines: [],
-          narrativeGate: undefined,
-          lastReplyText: "",
-          foregroundSubAgents: new Map,
-          answerStream: null,
-          isDm: isDmChatId(ev.chatId),
-          emissionAuthority: new EmissionAuthority(statusKey(ev.chatId, enqThreadIdNum))
-        };
-        next.narrativeGate = makeNarrativeGate(next);
-        if (HANDBACK_PRETURN_ENABLED) {
-          const handbackAdoption = handbackPreturnSignal.tryAdopt(turnId);
-          if (handbackAdoption != null) {
-            if (handbackAdoption.activityMessageId != null) {
-              next.activityMessageId = handbackAdoption.activityMessageId;
-              next.activityEverOpened = true;
-            }
-            process.stderr.write(`telegram gateway: handback pre-turn adopted turnId=${turnId} ` + `key=${handbackAdoption.statusKey} card=${handbackAdoption.activityMessageId ?? "none"}
-`);
-          }
-        }
-        startTurnTypingLoop(ev.chatId, enqThreadIdNum ?? null);
-        setCurrentTurn(next, statusKey(ev.chatId, enqThreadIdNum));
-        scheduleEarlyLivenessOpen(next);
-        process.stderr.write(`telegram gateway: ${formatTurnLifecycle("set", "enqueue", next, startedAt)}
-`);
-        rememberRecentTurn(next);
-        promoteQueuedStatus(ev.chatId, enqThreadIdNum);
         if (DELIVERY_CONFIRM_ENABLED) {
           ackDelivery(deliveryQueue, chatKey(ev.chatId, ev.threadId != null ? Number(ev.threadId) : null), ev.messageId, ev.rawContent);
         }
-        shadowEmit({
-          kind: "turnStart",
-          key: statusKey(ev.chatId, ev.threadId != null ? Number(ev.threadId) : undefined),
-          at: startedAt
-        });
-        preambleSuppressor.reset();
-        clearSilentEndState2(statusKey(ev.chatId, ev.threadId != null ? Number(ev.threadId) : null));
-        if (turnsDb != null) {
-          const evThreadIdNum = ev.threadId != null ? Number(ev.threadId) : null;
-          const turnKey3 = chatKeyWithSuffix(ev.chatId, evThreadIdNum, String(startedAt));
-          next.registryKey = turnKey3;
-          const userPromptPreview = extractUserPromptPreview(ev.rawContent);
-          try {
-            recordTurnStart(turnsDb, {
-              turnKey: turnKey3,
-              chatId: String(ev.chatId),
-              threadId: ev.threadId != null ? String(ev.threadId) : null,
-              lastUserMsgId: ev.messageId != null ? String(ev.messageId) : null,
-              userPromptPreview
-            });
-          } catch (err) {
-            process.stderr.write(`telegram gateway: recordTurnStart failed turnKey=${turnKey3}: ${err.message}
-`);
-          }
-          writeTurnActiveMarker(STATE_DIR, {
-            turnKey: turnKey3,
-            chatId: String(ev.chatId),
-            threadId: ev.threadId != null ? String(ev.threadId) : null,
-            startedAt
-          });
-        }
-        const pending = getPendingPtyPartial();
-        if (pending != null) {
-          setPendingPtyPartial(null);
-          handlePtyPartial(pending);
-        }
       }
+      pruneParkedTurnStarts(now);
+      if (!ev.chatId) {
+        beginTurn(deps, ev);
+        return;
+      }
+      const live = getCurrentTurn();
+      const sessionBusy = live != null && live.endedAt == null;
+      if (!sessionBusy && parkedTurnStarts.length === 0) {
+        beginTurn(deps, ev);
+        return;
+      }
+      parkTurnStart({
+        chatId: ev.chatId,
+        messageId: ev.messageId,
+        threadId: ev.threadId,
+        rawContent: ev.rawContent
+      }, now);
+      process.stderr.write(`telegram gateway: turn-start parked (session busy) chat=${ev.chatId} ` + `thread=${enqThreadIdNum ?? "-"} msg=${ev.messageId ?? "-"} ` + `parked=${parkedTurnStarts.length}
+`);
+      return;
+    }
+    case "dequeue": {
+      pruneParkedTurnStarts(Date.now());
+      const parked = takeParkedTurnStart();
+      if (parked == null)
+        return;
+      beginTurn(deps, parked);
       return;
     }
-    case "dequeue":
+    case "queue_remove": {
+      pruneParkedTurnStarts(Date.now());
+      discardParkedTurnStart(ev.rawContent);
       return;
+    }
     case "model": {
       const turn = getCurrentTurn();
       if (turn != null) {
@@ -84475,12 +84574,12 @@ init_paths();
 var _warnedReads2 = new Set;
 
 // ../src/setup/hindsight-pg-defaults.ts
-var HINDSIGHT_PG_MEM_LIMIT_MIB_FOR_DERIVATION = 8 * 1024;
+var HINDSIGHT_PG_MEM_LIMIT_MIB_FOR_DERIVATION = 16 * 1024;
 var HINDSIGHT_PG_APP_ANON_MIB = 2560;
 var HINDSIGHT_PG_PAGE_CACHE_FLOOR_MIB = 2048;
 var HINDSIGHT_PG_SHARED_BUFFERS_BUDGET_MIB = HINDSIGHT_PG_MEM_LIMIT_MIB_FOR_DERIVATION - HINDSIGHT_PG_APP_ANON_MIB - HINDSIGHT_PG_PAGE_CACHE_FLOOR_MIB;
-var HINDSIGHT_PG_DEFAULT_SHARED_BUFFERS_MIB = 1536;
-var HINDSIGHT_PG_DEFAULT_EFFECTIVE_CACHE_SIZE_MIB = 4096;
+var HINDSIGHT_PG_DEFAULT_SHARED_BUFFERS_MIB = 3072;
+var HINDSIGHT_PG_DEFAULT_EFFECTIVE_CACHE_SIZE_MIB = 7168;
 function pgMib(mib) {
   return `${mib}MB`;
 }
@@ -84655,7 +84754,17 @@ var HINDSIGHT_HEALTHCHECK_CMD = `python3 -c '${HINDSIGHT_HEALTHCHECK_PY}'`;
 var DOCKER_PROBE_TIMEOUT_MS = 60 * 1000;
 
 // ../src/memory/hindsight.ts
-var DEFAULT_RETAIN_MISSION = `Extract durable facts that will still be true and useful weeks from now: user preferences and standing rules, ongoing projects and recurring commitments, technical and architectural decisions with their rationale, and people/tool relationships. A preference revealed by a request is durable \u2014 record the preference (what the user likes, wants, or always does), not the request itself.
+var DEFAULT_RETAIN_MISSION = `Extract durable facts that will still be true and useful weeks from now, once this session is forgotten.
+` + `
+` + `DURABILITY GATE. Emit a candidate ONLY if it is one of these five classes:
+` + `- PREFERENCE \u2014 what the user likes, wants, or always does; a standing rule or correction.
+` + `- DECISION \u2014 a settled choice that changes how future work is done, including a choice NOT to do something. A decision about the mechanics of the CURRENT task (which worker to dispatch, which branch to rebase, which PR to merge now, what to do next) is process narration, not a durable decision \u2014 drop it unless it establishes a standing rule or permanently changes a system.
+` + `- FINDING \u2014 a root cause, a measurement, or verified behaviour of a system. Include the number.
+` + `- OUTCOME \u2014 a completed result that changed the world: what shipped, what a thing turned out to be. Not the act of shipping it.
+` + `- RELATIONSHIP \u2014 who a person is, what a project or tool is, and how they connect.
+` + `If a candidate fits none of the five, it is not a memory. Drop it; do not reword it into one.
+` + `
+` + `A preference revealed by a request is durable \u2014 record the preference (what the user likes, wants, or always does), not the request itself.
 ` + `
 ` + `A TOOL RESULT IS NOT A FACT. Before extracting, ask: is the subject of this
 ` + `candidate a file path, a command/process/agent/session id, a temp directory, or
@@ -84672,6 +84781,9 @@ var DEFAULT_RETAIN_MISSION = `Extract durable facts that will still be true and
 ` + `- Anything mentioning a path under /tmp, a scratchpad directory, or a .tmp file.
 ` + `- Agent tool-use traces or narration of what the assistant did (e.g. "the
 ` + `  assistant used X to query Y", "ran a search", "sent the message").
+` + `- The act of delegating, dispatching, spawning, launching, steering or merging
+` + `  work \u2014 including when it succeeded. "X was dispatched and completed" is the
+` + `  session describing itself. Record only what the work LEARNED or CHANGED.
 ` + `- In-flight workflow/process narration (a sub-task started, paused, or is still
 ` + `  running) \u2014 retain the outcome only once the task completes or a decision is made.
 ` + `- Operation, request, batch, agent, command or session IDs, UUIDs, hashes, or error codes.
@@ -84694,8 +84806,12 @@ var DEFAULT_RETAIN_MISSION = `Extract durable facts that will still be true and
 ` + `  the fact is explicitly dated, in which case record it as a dated observation.
 ` + `- Greetings, acknowledgements, and routine operational chatter.
 ` + `
+` + `Write each fact so it stands alone: name the thing, the number, and the date. A
+` + `sentence that only makes sense while reading this transcript is not durable.
+` + `
 ` + `If a candidate fact matches an exclusion, drop it rather than rewording it. If
-` + "nothing durable remains, return an empty facts list.";
+` + `nothing durable remains, return an empty facts list.
+`;
 var SUPERSEDED_RETAIN_MISSIONS = [
   "Extract technical decisions, architectural choices, user preferences, project context, and people/tool relationships. Ignore routine greetings and transient operational details.",
   "Extract user preferences, ongoing projects, recurring commitments, " + "important context, and durable facts that should help across future " + "conversations. Skip one-off chatter and temporary task noise.",
@@ -84742,7 +84858,96 @@ var SUPERSEDED_RETAIN_MISSIONS = [
 ` + `- Greetings, acknowledgements, and routine operational chatter.
 ` + `
 ` + `If a candidate fact matches an exclusion, drop it rather than rewording it. If
-` + "nothing durable remains, return an empty facts list."
+` + "nothing durable remains, return an empty facts list.",
+  `Extract durable facts that will still be true and useful weeks from now: user preferences and standing rules, ongoing projects and recurring commitments, technical and architectural decisions with their rationale, and people/tool relationships. A preference revealed by a request is durable \u2014 record the preference (what the user likes, wants, or always does), not the request itself.
+` + `
+` + `A TOOL RESULT IS NOT A FACT. Before extracting, ask: is the subject of this
+` + `candidate a file path, a command/process/agent/session id, a temp directory, or
+` + `the location where some output was written? If yes, drop it \u2014 it is transcript
+` + `exhaust, not memory.
+` + `
+` + `NEVER extract:
+` + `- Tool results verbatim or paraphrased. Concretely, never produce a fact whose
+` + `  text resembles any of these: "File created successfully at /path/to/file",
+` + `  "A background command with ID bctz4yskm is running, and its output will be
+` + `  written to /tmp/...", "Async agent a745598ba84e71df1 was launched successfully
+` + `  and is running in the background", "User executed a Bash command to sleep for
+` + `  200 seconds", "The assistant used grep to locate 'truncateSync' in src/foo.ts".
+` + `- Anything mentioning a path under /tmp, a scratchpad directory, or a .tmp file.
+` + `- Agent tool-use traces or narration of what the assistant did (e.g. "the
+` + `  assistant used X to query Y", "ran a search", "sent the message").
+` + `- In-flight workflow/process narration (a sub-task started, paused, or is still
+` + `  running) \u2014 retain the outcome only once the task completes or a decision is made.
+` + `- Operation, request, batch, agent, command or session IDs, UUIDs, hashes, or error codes.
+` + `- Slash commands the user typed and their effects (e.g. "User issued /clear to
+` + `  reset assistant state").
+` + `- Hindsight's own errors, retries, backlogs, or internal state \u2014 the memory
+` + `  system's self-reports are not memories.
+` + `- Restatements of the user's current request or the task in progress.
+` + `- Volatile state written as a timeless assertion. A version, count, size,
+` + `  backlog, status, or any "X is running Y" / "X is at Y" / "X is currently Y"
+` + `  claim is true only at the instant it was said. Concretely, never produce a
+` + `  fact whose text resembles any of these: "Switchroom fleet is running image
+` + `  version v0.18.19", "The switchroom repo is at /path/to/fleet, version
+` + `  v0.19.5", "Bank overlord has 43155 pending consolidations", "The build is
+` + `  currently green". If the claim is worth keeping, put the date INSIDE the
+` + `  fact text ("As of 2026-07-19 the fleet was running v0.18.19"); if you
+` + `  cannot date it, drop it. An undated one is recalled forever as though it
+` + `  were still true, which is worse than not remembering it at all.
+` + `- Transient state (unread counts, build status, what is running right now) unless
+` + `  the fact is explicitly dated, in which case record it as a dated observation.
+` + `- Greetings, acknowledgements, and routine operational chatter.
+` + `
+` + `If a candidate fact matches an exclusion, drop it rather than rewording it. If
+` + "nothing durable remains, return an empty facts list.",
+  `Extract durable facts that will still be true and useful weeks from now, once this session is forgotten.
+` + `
+` + `DURABILITY GATE. Emit a candidate ONLY if it is one of these five classes:
+` + `- PREFERENCE \u2014 what the user likes, wants, or always does; a standing rule or correction.
+` + `- DECISION \u2014 a settled choice that changes how future work is done, including a choice NOT to do something. A decision about the mechanics of the CURRENT task (which worker to dispatch, which branch to rebase, which PR to merge now, what to do next) is process narration, not a durable decision \u2014 drop it unless it establishes a standing rule or permanently changes a system.
+` + `- FINDING \u2014 a root cause, a measurement, or verified behaviour of a system. Include the number.
+` + `- OUTCOME \u2014 a completed result that changed the world: what shipped, what a thing turned out to be. Not the act of shipping it.
+` + `- RELATIONSHIP \u2014 who a person is, what a project or tool is, and how they connect.
+` + `If a candidate fits none of the five, it is not a memory. Drop it; do not reword it into one.
+` + `
+` + `A preference revealed by a request is durable \u2014 record the preference (what the user likes, wants, or always does), not the request itself.
+` + `
+` + `A TOOL RESULT IS NOT A FACT. Before extracting, ask: is the subject of this
+` + `candidate a file path, a command/process/agent/session id, a temp directory, or
+` + `the location where some output was written? If yes, drop it \u2014 it is transcript
+` + `exhaust, not memory.
+` + `
+` + `NEVER extract:
+` + `- Tool results verbatim or paraphrased. Concretely, never produce a fact whose
+` + `  text resembles any of these: "File created successfully at /path/to/file",
+` + `  "A background command with ID bctz4yskm is running, and its output will be
+` + `  written to /tmp/...", "Async agent a745598ba84e71df1 was launched successfully
+` + `  and is running in the background", "User executed a Bash command to sleep for
+` + `  200 seconds", "The assistant used grep to locate 'truncateSync' in src/foo.ts".
+` + `- Anything mentioning a path under /tmp, a scratchpad directory, or a .tmp file.
+` + `- Agent tool-use traces or narration of what the assistant did (e.g. "the
+` + `  assistant used X to query Y", "ran a search", "sent the message").
+` + `- The act of delegating, dispatching, spawning, launching, steering or merging
+` + `  work \u2014 including when it succeeded. "X was dispatched and completed" is the
+` + `  session describing itself. Record only what the work LEARNED or CHANGED.
+` + `- In-flight workflow/process narration (a sub-task started, paused, or is still
+` + `  running) \u2014 retain the outcome only once the task completes or a decision is made.
+` + `- Operation, request, batch, agent, command or session IDs, UUIDs, hashes, or error codes.
+` + `- Slash commands the user typed and their effects (e.g. "User issued /clear to
+` + `  reset assistant state").
+` + `- Hindsight's own errors, retries, backlogs, or internal state \u2014 the memory
+` + `  system's self-reports are not memories.
+` + `- Restatements of the user's current request or the task in progress.
+` + `- Transient state (unread counts, build status, what is running right now) unless
+` + `  the fact is explicitly dated, in which case record it as a dated observation.
+` + `- Greetings, acknowledgements, and routine operational chatter.
+` + `
+` + `Write each fact so it stands alone: name the thing, the number, and the date. A
+` + `sentence that only makes sense while reading this transcript is not durable.
+` + `
+` + `If a candidate fact matches an exclusion, drop it rather than rewording it. If
+` + `nothing durable remains, return an empty facts list.
+`
 ];
 var DEFAULT_OBSERVATIONS_MISSION = `Synthesise durable, standing knowledge about the people, projects, and systems this agent works with: preferences and standing rules, roles and relationships, skills and recurring patterns, technical and operational decisions with their rationale, and the state of long-running work once it lands.
 ` + `
@@ -86424,7 +86629,7 @@ function shouldSweepChatAtBoot(chatId) {
 
 // gateway/stale-pin-sweep-store.ts
 var SWEEP_MAX_ATTEMPTS = 8;
-var SWEEP_ENVELOPE_VERSIONS = new Set([1]);
+var SWEEP_ENVELOPE_VERSION = 1;
 function sweepTargetKey(chatId, threadId) {
   return `${chatId}:${threadId ?? "-"}`;
 }
@@ -86452,13 +86657,13 @@ function loadSweepCursors(path2, fs2) {
   if (parsed == null || typeof parsed !== "object")
     return [];
   const env = parsed;
-  if (typeof env.v !== "number" || !SWEEP_ENVELOPE_VERSIONS.has(env.v) || !Array.isArray(env.cursors)) {
+  if (!Number.isInteger(env.v) || env.v < 1 || !Array.isArray(env.cursors)) {
     return [];
   }
   return env.cursors.filter(isCursorRow);
 }
 function persistSweepCursors(path2, fs2, cursors, log = (l) => process.stderr.write(l)) {
-  const env = { v: 1, cursors: [...cursors] };
+  const env = { v: SWEEP_ENVELOPE_VERSION, cursors: [...cursors] };
   try {
     fs2.writeFileSync(path2, JSON.stringify(env));
   } catch (err) {
@@ -86879,11 +87084,13 @@ function createStalePinSweeper(deps) {
   const repinUnpinLoop = async (target, kind, cursor) => {
     const gate = gateFor(kind);
     let popped = 0;
+    let issued = 0;
     let consecutiveFloods = 0;
     let lastRetryAfter = null;
     let noProgressAtSameRetryAfter = 0;
     let lastObservedTop = null;
     let unverifiedPop = false;
+    const out = (r) => ({ ...r, issued });
     const creditPop = () => {
       popped++;
       cursor.popped++;
@@ -86892,29 +87099,29 @@ function createStalePinSweeper(deps) {
     };
     for (let i = 0;i < gate.maxPopsPerChatPerSweep; i++) {
       if (circuitOpen) {
-        return { status: "aborted-circuit-breaker", popped, detail: "breaker open" };
+        return out({ status: "aborted-circuit-breaker", popped, detail: "breaker open" });
       }
       const observed = await readTopVerified(target.chatId);
       if (observed == null) {
-        return { status: "incomplete", popped, detail: "pin-stack read unverifiable" };
+        return out({ status: "incomplete", popped, detail: "pin-stack read unverifiable" });
       }
       if (unverifiedPop) {
         if (observed.top != null && observed.top === lastObservedTop) {
-          return {
+          return out({
             status: "incomplete",
             popped,
             detail: `no progress: message ${observed.top} still on top after a repin+unpin`
-          };
+          });
         }
         creditPop();
         unverifiedPop = false;
       }
       if (observed.top == null) {
-        return { status: "drained", popped };
+        return out({ status: "drained", popped });
       }
       lastObservedTop = observed.top;
       if (!await awaitWriteSlot(kind)) {
-        return { status: "deferred-budget", popped, detail: "per-minute pin-op budget spent" };
+        return out({ status: "deferred-budget", popped, detail: "per-minute pin-op budget spent" });
       }
       try {
         await deps.pinSilent(target.chatId, observed.top);
@@ -86922,10 +87129,10 @@ function createStalePinSweeper(deps) {
         const d = classify(err);
         if (d.kind === "breaker") {
           circuitOpen = true;
-          return { status: "aborted-circuit-breaker", popped, detail: d.detail };
+          return out({ status: "aborted-circuit-breaker", popped, detail: d.detail });
         }
         if (d.kind === "rights")
-          return { status: "skipped-no-rights", popped };
+          return out({ status: "skipped-no-rights", popped });
         if (d.kind === "flood") {
           consecutiveFloods++;
           if (lastRetryAfter === d.seconds)
@@ -86934,19 +87141,19 @@ function createStalePinSweeper(deps) {
             noProgressAtSameRetryAfter = 1;
           lastRetryAfter = d.seconds;
           if (consecutiveFloods >= MAX_CONSECUTIVE_FLOOD_WAITS || noProgressAtSameRetryAfter >= MAX_IDENTICAL_RETRY_AFTER_NO_PROGRESS) {
-            return {
+            return out({
               status: "deferred-flood",
               popped,
               detail: `flood: ${consecutiveFloods} consecutive 429s, retry_after=${d.seconds}s`
-            };
+            });
           }
           await deps.sleep(d.seconds * 1000 * Math.pow(FLOOD_BACKOFF_FACTOR, consecutiveFloods - 1));
           continue;
         }
-        return { status: "error", popped, detail: d.detail };
+        return out({ status: "error", popped, detail: d.detail });
       }
       if (!await awaitWriteSlot(kind)) {
-        return { status: "deferred-budget", popped, detail: "per-minute pin-op budget spent" };
+        return out({ status: "deferred-budget", popped, detail: "per-minute pin-op budget spent" });
       }
       try {
         await deps.unpin(target.chatId, observed.top);
@@ -86954,12 +87161,12 @@ function createStalePinSweeper(deps) {
         const d = classify(err);
         if (d.kind === "breaker") {
           circuitOpen = true;
-          return { status: "aborted-circuit-breaker", popped, detail: d.detail };
+          return out({ status: "aborted-circuit-breaker", popped, detail: d.detail });
         }
         if (d.kind === "rights")
-          return { status: "skipped-no-rights", popped };
+          return out({ status: "skipped-no-rights", popped });
         if (isNothingToUnpinError(err))
-          return { status: "drained", popped };
+          return out({ status: "drained", popped });
         if (d.kind === "flood") {
           consecutiveFloods++;
           if (lastRetryAfter === d.seconds)
@@ -86968,30 +87175,31 @@ function createStalePinSweeper(deps) {
             noProgressAtSameRetryAfter = 1;
           lastRetryAfter = d.seconds;
           if (consecutiveFloods >= MAX_CONSECUTIVE_FLOOD_WAITS || noProgressAtSameRetryAfter >= MAX_IDENTICAL_RETRY_AFTER_NO_PROGRESS) {
-            return {
+            return out({
               status: "deferred-flood",
               popped,
               detail: `flood: ${consecutiveFloods} consecutive 429s, retry_after=${d.seconds}s`
-            };
+            });
           }
           await deps.sleep(d.seconds * 1000 * Math.pow(FLOOD_BACKOFF_FACTOR, consecutiveFloods - 1));
           continue;
         }
-        return { status: "error", popped, detail: d.detail };
+        return out({ status: "error", popped, detail: d.detail });
       }
       consecutiveFloods = 0;
+      issued++;
       unverifiedPop = true;
     }
     const finalRead = await readTopVerified(target.chatId);
     if (unverifiedPop && finalRead != null && finalRead.top !== lastObservedTop)
       creditPop();
     if (finalRead != null && finalRead.top == null)
-      return { status: "drained", popped };
-    return {
+      return out({ status: "drained", popped });
+    return out({
       status: "deferred-budget",
       popped,
       detail: `hit the ${gate.maxPopsPerChatPerSweep}-pop cap for this chat; yielding to next boot`
-    };
+    });
   };
   const targetedUnpinDrain = async (target, kind, cursor, ids) => {
     const alreadyDone = new Set(cursor.doneIds ?? []);
@@ -87088,10 +87296,21 @@ function createStalePinSweeper(deps) {
   const forumTopicDrain = async (target, cursor) => {
     const threadId = target.threadId;
     if (threadId == null) {
-      return { status: "skipped-nothing-recorded", popped: 0, detail: "no message_thread_id" };
+      return {
+        status: "skipped-nothing-recorded",
+        popped: 0,
+        issued: 0,
+        detail: "no message_thread_id"
+      };
     }
+    const before = await readTopVerified(target.chatId);
     if (!await awaitWriteSlot("forum-topic")) {
-      return { status: "deferred-budget", popped: 0, detail: "per-minute pin-op budget spent" };
+      return {
+        status: "deferred-budget",
+        popped: 0,
+        issued: 0,
+        detail: "per-minute pin-op budget spent"
+      };
     }
     try {
       await deps.unpinAllForumTopicMessages(target.chatId, threadId);
@@ -87099,39 +87318,59 @@ function createStalePinSweeper(deps) {
       const d = classify(err);
       if (d.kind === "breaker") {
         circuitOpen = true;
-        return { status: "aborted-circuit-breaker", popped: 0, detail: d.detail };
+        return { status: "aborted-circuit-breaker", popped: 0, issued: 0, detail: d.detail };
       }
       if (d.kind === "rights")
-        return { status: "skipped-no-rights", popped: 0 };
+        return { status: "skipped-no-rights", popped: 0, issued: 0 };
       if (d.kind === "flood") {
         return {
           status: "deferred-flood",
           popped: 0,
+          issued: 0,
           detail: `unpinAllForumTopicMessages pegged at retry_after=${d.seconds}s; not looping`
         };
       }
-      return { status: "error", popped: 0, detail: d.detail };
+      return { status: "error", popped: 0, issued: 0, detail: d.detail };
     }
-    cursor.popped++;
-    cursor.updatedAt = deps.now();
-    commit(cursor);
     const observed = await readTopVerified(target.chatId);
-    if (observed != null && observed.top == null)
-      return { status: "drained", popped: 1 };
-    return { status: "drained", popped: 1, detail: "topic drained; chat-wide stack may hold other topics" };
+    const topMoved = before != null && observed != null && observed.top !== before.top ? 1 : 0;
+    if (topMoved > 0) {
+      cursor.popped += topMoved;
+      cursor.updatedAt = deps.now();
+      commit(cursor);
+    }
+    if (observed != null && observed.top == null) {
+      return { status: "drained", popped: topMoved, issued: 1 };
+    }
+    return {
+      status: "drained",
+      popped: topMoved,
+      issued: 1,
+      detail: "topic drained; chat-wide stack may hold other topics"
+    };
   };
   const sweepOnce = async (target) => {
     if (!deps.eligible())
-      return { status: "skipped-not-eligible", popped: 0 };
+      return { status: "skipped-not-eligible", popped: 0, issued: 0 };
     if (circuitOpen) {
-      return { status: "aborted-circuit-breaker", popped: 0, detail: "breaker already open" };
+      return {
+        status: "aborted-circuit-breaker",
+        popped: 0,
+        issued: 0,
+        detail: "breaker already open"
+      };
     }
     const kind = classifyChatForSweep(target);
     const cursor = loadCursor(target, kind);
     if (cursor.done)
-      return { status: "already-drained", popped: 0 };
+      return { status: "already-drained", popped: 0, issued: 0 };
     if (cursor.attempts >= SWEEP_MAX_ATTEMPTS) {
-      return { status: "forfeited", popped: 0, detail: `${cursor.attempts} attempts exhausted` };
+      return {
+        status: "forfeited",
+        popped: 0,
+        issued: 0,
+        detail: `${cursor.attempts} attempts exhausted`
+      };
     }
     if (kind !== "dm") {
       let allowed = false;
@@ -87145,7 +87384,7 @@ function createStalePinSweeper(deps) {
         cursor.lastStatus = "skipped-no-rights";
         cursor.updatedAt = deps.now();
         commit(cursor);
-        return { status: "skipped-no-rights", popped: 0 };
+        return { status: "skipped-no-rights", popped: 0, issued: 0 };
       }
     }
     cursor.attempts++;
@@ -87174,7 +87413,7 @@ function createStalePinSweeper(deps) {
         } : await targetedUnpinDrain(target, kind, cursor, ids);
       }
     } catch (err) {
-      result = { status: "error", popped: 0, detail: err.message };
+      result = { status: "error", popped: 0, issued: 0, detail: err.message };
     }
     if (result.status === "drained" || result.status === "skipped-nothing-recorded") {
       cursor.done = true;
@@ -87207,10 +87446,12 @@ function createStalePinSweeper(deps) {
     const running = inFlight.get(key);
     if (running != null)
       return running;
-    if (!deps.eligible())
-      return Promise.resolve({ status: "skipped-not-eligible", popped: 0 });
-    if (attempted.has(key))
-      return Promise.resolve({ status: "already-attempted", popped: 0 });
+    if (!deps.eligible()) {
+      return Promise.resolve({ status: "skipped-not-eligible", popped: 0, issued: 0 });
+    }
+    if (attempted.has(key)) {
+      return Promise.resolve({ status: "already-attempted", popped: 0, issued: 0 });
+    }
     attempted.add(key);
     const p = sweepOnce(target).finally(() => inFlight.delete(key));
     inFlight.set(key, p);
@@ -90115,7 +90356,7 @@ function createCapturedResumeDispatcher(ports) {
 
 // gateway/status-pin-store.ts
 var BOOT_UNPIN_MAX_ATTEMPTS = 5;
-var SNAPSHOT_VERSIONS2 = new Set([1, 2, 3, 4]);
+var SNAPSHOT_VERSION2 = 4;
 function isPinRow2(x) {
   if (x == null || typeof x !== "object")
     return false;
@@ -90140,12 +90381,12 @@ function loadStatusPins2(path3, fs3) {
   if (parsed == null || typeof parsed !== "object")
     return [];
   const env = parsed;
-  if (typeof env.v !== "number" || !SNAPSHOT_VERSIONS2.has(env.v) || !Array.isArray(env.pins))
+  if (!Number.isInteger(env.v) || env.v < 1 || !Array.isArray(env.pins))
     return [];
   return env.pins.filter(isPinRow2);
 }
 function persistStatusPins2(path3, fs3, snapshot, log = (l) => process.stderr.write(l)) {
-  const env = { v: 4, pins: [...snapshot] };
+  const env = { v: SNAPSHOT_VERSION2, pins: [...snapshot] };
   const tmp = path3 + ".tmp";
   try {
     fs3.writeFileSync(tmp, JSON.stringify(env));
@@ -96446,6 +96687,12 @@ function parseAuditLine(line) {
     entry.m = o.m;
   if (typeof o.prior_pin === "string")
     entry.prior_pin = o.prior_pin;
+  if (Array.isArray(o.prior_pin_observed) && o.prior_pin_observed.every((v) => typeof v === "string")) {
+    entry.prior_pin_observed = o.prior_pin_observed;
+  }
+  if (typeof o.prior_pin_source === "string") {
+    entry.prior_pin_source = o.prior_pin_source;
+  }
   return entry;
 }
 function filterEntries(entries, filters) {
@@ -99070,10 +99317,10 @@ function startOutboxSweep(deps) {
 }
 
 // ../src/build-info.ts
-var VERSION2 = "0.19.31";
-var COMMIT_SHA = "d24ee3cc";
-var COMMIT_DATE = "2026-07-28T23:06:42Z";
-var LATEST_PR = 3961;
+var VERSION2 = "0.19.33";
+var COMMIT_SHA = "4ccbde6b";
+var COMMIT_DATE = "2026-07-29T02:39:39Z";
+var LATEST_PR = 3973;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts