@remnic/core 10.0.75 → 10.0.77

package/dist/orchestration/extraction-queue-snapshot-sharing.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Bounded-queue retention for automatic extraction snapshots (#3324
+ * follow-up).
+ *
+ * The coordinator's queue keeps every accepted task's own snapshot (that is
+ * the #3324 contract: per-entry captured scope and settlement), but nothing
+ * requires each queued snapshot to RETAIN its own turn objects. Automatic
+ * triggers hand out prefix-extended snapshots of the same buffer (the buffer
+ * clears only when extraction runs), so consecutive queued snapshots overlap
+ * almost entirely while their drain is slow. Retaining one deep copy per
+ * snapshot grows quadratic overhead (demonstrated: scaling exponent 1.89 on
+ * main, 36× the unique content at 1000 turns for one session).
+ *
+ * This registry makes the OVERLAP shared without changing ANY task's
+ * semantics: a queued snapshot is stored as a chain node
+ * `{ base, tail }` whose turns are verified element-wise equivalent to the
+ * base chain at admit time. Each task materializes its own fresh array at
+ * run time — identical values, same windows, same chunking, same clear
+ * matching, same settlements. Sharing is data-structure only.
+ *
+ * Safety properties:
+ * - Equivalence is CONSUMER-equivalence, not `bufferTurnsEqual` alone: the
+ *   five fields `bufferTurnsEqual` ignores (extractionContextOnly, parts,
+ *   rawContent, sourceFormat, importProvenance) are compared strictly
+ *   (objects by reference identity), so an aliased segment is
+ *   indistinguishable from a private copy to every downstream reader.
+ * - Turn objects are immutable by audit: no code path writes a BufferTurn
+ *   field or a parts array in place (all writes go to freshly constructed
+ *   objects: `copyBufferTurn`, the replay `pinned` spread). Audited across
+ *   the extraction call graph.
+ * - Distinct scope pins can never share: pins are turn fields covered by
+ *   `bufferTurnsEqual`, and the scope-class bucket is a lookup heuristic
+ *   only — a wrong pairing fails the element-wise check and simply does not
+ *   share.
+ * - Replay, bulk import, force flush, fail-closed callers, and claim-backed
+ *   execution contexts are excluded (they are not automatic snapshots of the
+ *   live buffer).
+ */
+import type { BufferTurn } from "../types.js";
+/** Option surface of `queueBufferedExtraction` relevant to eligibility. */
+export interface AutomaticSharingOptions {
+    /** Claim-backed backlog tasks own a different buffer view: never share. */
+    execution?: unknown;
+    /** Automatic trigger paths set this; forced replay/import do not. */
+    preemptable?: boolean;
+    failOnExtractionFailure?: boolean;
+    forceExtractionAttempt?: boolean;
+    /** Fail-closed front flush: never share. */
+    preemptRunning?: boolean;
+}
+export declare function automaticSnapshotSharingEligible(options: AutomaticSharingOptions): boolean;
+/** Consumer-visible equivalence: `bufferTurnsEqual` PLUS the fields it ignores. */
+export declare function turnRepresentationEquivalent(left: BufferTurn, right: BufferTurn): boolean;
+/** One queued automatic snapshot: `base` chain plus this trigger's own new turns. */
+export interface SnapshotChain {
+    readonly key: string;
+    readonly scopeClass: string;
+    readonly base: SnapshotChain | undefined;
+    /** Total turns retained by the base chain. */
+    readonly baseLength: number;
+    /** This trigger's non-shared suffix (fresh reference slots, disjoint across the chain). */
+    readonly tail: readonly BufferTurn[];
+    /** Total turns this snapshot represents. */
+    readonly total: number;
+    /** Outstanding tasks holding this node; the node leaves the registry when it reaches 0. */
+    holders: number;
+}
+export interface SnapshotSharingStats {
+    /** Distinct content chains registered (not task count — see queuedHolders). */
+    queuedNodes: number;
+    /** Σ per-node window lengths over registered nodes. Sibling nodes sharing
+     * a base chain count that base once per node (per-task window basis). */
+    queuedTotalRefs: number;
+    /** Distinct turn references REACHABLE from queued nodes, counting
+     * released ancestors reached through `base` exactly once (visited-set). */
+    queuedTailRefs: number;
+    /** Longest base chain reachable from a queued node (must stay bounded). */
+    queuedReachableDepth: number;
+    /** Outstanding tasks holding nodes (per-task, not per-node). */
+    queuedHolders: number;
+    /** What retention would be WITHOUT sharing: Σ per-node window length ×
+     * holders (each outstanding task would carry its own full window). */
+    unsharedEquivalentRefs: number;
+}
+/**
+ * Element-wise consumer-equivalence of the chain's turns against a snapshot
+ * prefix. Cost is O(chain.total) compares per admit — required to prove the
+ * shared prefix is consumer-equivalent to the incoming snapshot — so a chain
+ * build is O(depth^2) compares in total (measured, acknowledged in the PR).
+ */
+export declare function chainPrefixEquivalent(chain: SnapshotChain, turns: readonly BufferTurn[]): boolean;
+/** Fresh array with exactly this snapshot's turns, in order. Run-time only. */
+export declare function materializeChain(chain: SnapshotChain): BufferTurn[];
+export declare class ExtractionSnapshotSharingRegistry {
+    private readonly buckets;
+    /**
+     * Admit one automatic snapshot for `bufferKey`: chain it onto the newest
+     * queued same-scope snapshot when that is a verified prefix-extension,
+     * otherwise start a fresh chain. The caller's array is never mutated.
+     */
+    admit(bufferKey: string, turns: readonly BufferTurn[]): SnapshotChain;
+    /** Release one holder of a node when its task exits (or on enqueue
+     * refusal). CONTRACT: called EXACTLY ONCE per admit, by the task that
+     * admitted it — the registry has no task identity, so a second call by the
+     * same task would steal another holder's count. The only production caller
+     * (queueBufferedExtraction) enforces this structurally: the closure-finally
+     * and the enqueue-refusal branch are mutually exclusive. Defensively, a
+     * release past zero is a no-op. */
+    release(node: SnapshotChain): void;
+    /** Proof seam: what the queue retains right now. */
+    stats(): SnapshotSharingStats;
+}
+//# sourceMappingURL=extraction-queue-snapshot-sharing.d.ts.map

package/dist/orchestration/extraction-queue-snapshot-sharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-queue-snapshot-sharing.d.ts","sourceRoot":"","sources":["../../src/orchestration/extraction-queue-snapshot-sharing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAQ1F;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CASzF;AAgBD,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB;6EACyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB;+EAC2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB;0EACsE;IACtE,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAWjG;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,EAAE,CAMnE;AAED,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa;IAwCrE;;;;;;uCAMmC;IACnC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAWlC,oDAAoD;IACpD,KAAK,IAAI,oBAAoB;CA6B9B"}

package/dist/orchestration/turn-ingestion.d.ts

@@ -27,6 +27,7 @@ import { SessionObserverState } from "../session-observer-state.js";
 import { TranscriptManager } from "../transcript.js";
 import type { BufferTurn, PluginConfig, SourceConnectorProvenance } from "../types.js";
 import { type ExtractionTaskExecutionContext } from "./extraction-task-queueing.js";
+import { ExtractionSnapshotSharingRegistry } from "./extraction-queue-snapshot-sharing.js";
 import { type ResolvedScopeProfilePlan } from "../namespaces/scope-profiles.js";
 import { type BulkImportBatchIngestResult } from "../orchestrator.js";
 /**
@@ -102,6 +103,8 @@ export interface TurnIngestionOptions extends SourceConnectorProvenance {
 export declare class TurnIngestionCoordinator {
     private readonly deps;
     private readonly drain;
+    /** Queued automatic-snapshot chains: bounded-queue retention via structural sharing. */
+    readonly snapshotSharing: ExtractionSnapshotSharingRegistry;
     constructor(deps: TurnIngestionDeps);
     processTurn(role: "user" | "assistant", content: string, sessionKey?: string, options?: TurnIngestionOptions): Promise<void>;
     ingestReplayBatch(turns: ReplayTurn[], options?: {

package/dist/orchestration/turn-ingestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-ingestion.d.ts","sourceRoot":"","sources":["../../src/orchestration/turn-ingestion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn-ingestion.d.ts","sourceRoot":"","sources":["../../src/orchestration/turn-ingestion.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator.js

@@ -4,9 +4,9 @@ import {
   graphPathRelativeToStorage,
   mergeGraphExpandedResults,
   qmdStartupCollectionChecksWithTimeout
-} from "./chunk-VYOAYFDV.js";
+} from "./chunk-I4W2ADBP.js";
 import "./chunk-B36ACJG7.js";
-import "./chunk-PLGBPFEO.js";
+import "./chunk-TWHVCSLX.js";
 import {
   formatCompressionGuidelinesForRecall
 } from "./chunk-5PHOU5QI.js";
@@ -122,7 +122,7 @@ import "./chunk-7G5NTS7F.js";
 import "./chunk-HB5TNQMM.js";
 import "./chunk-4NZQ7IID.js";
 import "./chunk-3I4FUAVJ.js";
-import "./chunk-SY4AFWUZ.js";
+import "./chunk-MAURCRPQ.js";
 import "./chunk-MMACM5G2.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
@@ -238,7 +238,7 @@ import "./chunk-43HUVDTD.js";
 import "./chunk-4RA3C3EV.js";
 import "./chunk-B32WYRXX.js";
 import "./chunk-3NF4QUNZ.js";
-import "./chunk-E22CQZ3H.js";
+import "./chunk-EYIBIGIU.js";
 import "./chunk-V7IZKJI3.js";
 import "./chunk-TB6CBZ5V.js";
 import "./chunk-XW2T4QAW.js";
@@ -252,27 +252,27 @@ import "./chunk-2TGIKMMZ.js";
 import "./chunk-SDESKFKT.js";
 import "./chunk-3HSRWJTC.js";
 import "./chunk-FETPTCQZ.js";
-import "./chunk-SZBZOUHR.js";
-import "./chunk-VEWTHVX2.js";
+import "./chunk-D26XMQP5.js";
+import "./chunk-5HVEYVNQ.js";
 import "./chunk-SRT6SHVZ.js";
-import "./chunk-VEQVXNWR.js";
+import "./chunk-TX627XOF.js";
 import "./chunk-TE6S7KDF.js";
 import "./chunk-EIB4FJVR.js";
 import "./chunk-MZUQVWVC.js";
 import "./chunk-A5KNZSNA.js";
 import "./chunk-HUSTM6PU.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-IBQ7LGUJ.js";
+import "./chunk-FQU65RJX.js";
 import "./chunk-SYDPJUFR.js";
-import "./chunk-ZG57BEUS.js";
+import "./chunk-LXDERMOU.js";
 import "./chunk-233S3MXC.js";
-import "./chunk-N6GEGRCT.js";
-import "./chunk-3GGCMRO7.js";
-import "./chunk-VPEMGBTI.js";
+import "./chunk-4NDDRYBY.js";
+import "./chunk-MUZWS6KB.js";
+import "./chunk-D3USVQIV.js";
 import "./chunk-7T4TOGMS.js";
 import "./chunk-7YQ6ESEA.js";
 import "./chunk-ZXF3O7P4.js";
-import "./chunk-RXGFITWS.js";
+import "./chunk-NUBOY2LQ.js";
 import "./chunk-PQM3B54K.js";
 import "./chunk-K36RMINQ.js";
 import "./chunk-2RUTN7PR.js";
@@ -287,14 +287,14 @@ import "./chunk-KNZDGZSY.js";
 import "./chunk-DEGE32C3.js";
 import "./chunk-AB3A7EFH.js";
 import "./chunk-KIUVEMBI.js";
-import "./chunk-KAED7IBB.js";
+import "./chunk-6L62IDS6.js";
 import "./chunk-2BPPGNAQ.js";
 import "./chunk-DJSJ4ULL.js";
-import "./chunk-FP2AT4WL.js";
+import "./chunk-G3PBNYDH.js";
 import {
   hasIdentityRecoveryIntent,
   resolveEffectiveIdentityInjectionMode
-} from "./chunk-R24RYSQX.js";
+} from "./chunk-2JRLKDHV.js";
 import "./chunk-W4F3C7N7.js";
 import "./chunk-MPC7TYTZ.js";
 import "./chunk-2R7OCBRR.js";
@@ -592,7 +592,7 @@ import "./chunk-ESG6ITGP.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-C5LWPYS3.js";
-import "./chunk-IPHIIRDN.js";
+import "./chunk-CYTTY4M2.js";
 import "./chunk-F5GVIPC7.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-NGHDW6UU.js";

package/dist/recall-navigation-operations.js

@@ -1,5 +1,5 @@
-import "./chunk-N6GEGRCT.js";
-import "./chunk-R24RYSQX.js";
+import "./chunk-4NDDRYBY.js";
+import "./chunk-2JRLKDHV.js";
 import "./chunk-W4F3C7N7.js";
 import "./chunk-MPC7TYTZ.js";
 import "./chunk-2R7OCBRR.js";
@@ -256,7 +256,7 @@ import "./chunk-ESG6ITGP.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-C5LWPYS3.js";
-import "./chunk-IPHIIRDN.js";
+import "./chunk-CYTTY4M2.js";
 import "./chunk-F5GVIPC7.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-NGHDW6UU.js";

package/dist/recall-navigation.js

@@ -1,6 +1,6 @@
 import {
   runRecallNavigation
-} from "./chunk-R24RYSQX.js";
+} from "./chunk-2JRLKDHV.js";
 import "./chunk-W4F3C7N7.js";
 import "./chunk-MPC7TYTZ.js";
 import "./chunk-2R7OCBRR.js";
@@ -257,7 +257,7 @@ import "./chunk-ESG6ITGP.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-C5LWPYS3.js";
-import "./chunk-IPHIIRDN.js";
+import "./chunk-CYTTY4M2.js";
 import "./chunk-F5GVIPC7.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-NGHDW6UU.js";

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-PLGBPFEO.js";
+} from "../chunk-TWHVCSLX.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-VEWTHVX2.js";
-import "../chunk-ZG57BEUS.js";
+} from "../chunk-5HVEYVNQ.js";
+import "../chunk-LXDERMOU.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,7 +56,7 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-R24RYSQX.js";
+} from "../chunk-2JRLKDHV.js";
 import "../chunk-W4F3C7N7.js";
 import "../chunk-MPC7TYTZ.js";
 import "../chunk-2R7OCBRR.js";
@@ -344,7 +344,7 @@ import "../chunk-ESG6ITGP.js";
 import "../chunk-PCXDUHQH.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-C5LWPYS3.js";
-import "../chunk-IPHIIRDN.js";
+import "../chunk-CYTTY4M2.js";
 import "../chunk-F5GVIPC7.js";
 import "../chunk-X4OZMANG.js";
 import "../chunk-NGHDW6UU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "10.0.75",
+  "version": "10.0.77",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3386,7 +3386,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^10.0.75"
+    "@remnic/coding-graph": "^10.0.77"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-observe-helpers.test.ts

@@ -1,4 +1,6 @@
 import assert from "node:assert/strict";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 /**
  * PendingObserveExtractionTracker settle hygiene — issue: `track`'s settle
  * callback only removed the pending entry when the extraction SUCCEEDED or
@@ -70,3 +72,157 @@ test("a wait overlapping a failing extraction still surfaces the error", async (
   reject(new Error("extraction failed"));
   await waiter;
 });
+
+/**
+ * Controller retention — issue: `track` copied every prior controller of the
+ * key into a fresh Set per tracked extraction, and never-settling promise
+ * chains keep every generation reachable, so overlapping stalled tracks grew
+ * quadratically (HeapRepro: ~543MB at 6000 tracks; measured 212.8MB at 4000
+ * pre-fix vs 4.2MB with the shared per-key set). The fix reuses one Set per
+ * key; `abortTracked` iterates a snapshot so a reentrant `track` fired from
+ * an abort listener keeps prior semantics (not aborted by the in-flight
+ * pass, iteration terminates).
+ */
+function stalled(): Promise<void> {
+  const { promise } = Promise.withResolvers<void>();
+  return promise;
+}
+
+function rejectingAfter(controller: AbortController): Promise<void> {
+  const { promise, reject } = Promise.withResolvers<void>();
+  controller.signal.addEventListener("abort", () => reject(controller.signal.reason), { once: true });
+  return promise;
+}
+
+// Runs the retention loop in one short-lived child process with --expose-gc,
+// so CI exercises it without exposing gc to the whole test tree. The
+// assertion keeps a wide margin (4.2MB measured post-fix vs 212.8MB pre-fix
+// at the same track count), not a fixed runner heap limit.
+function drain(stream: NodeJS.ReadableStream): Promise<string> {
+  return new Promise((resolve) => {
+    const chunks: string[] = [];
+    stream.on("data", (chunk) => chunks.push(String(chunk)));
+    stream.on("end", () => resolve(chunks.join("")));
+  });
+}
+
+async function retainedHeapInChild(): Promise<number> {
+  const trackerSource = fileURLToPath(new URL("./access-observe-helpers.js", import.meta.url));
+  const child = spawn(
+    process.execPath,
+    [
+      "--expose-gc",
+      "--input-type=module",
+      "--import",
+      "tsx",
+      "-e",
+      `import { pathToFileURL } from "node:url";
+const { PendingObserveExtractionTracker } = await import(pathToFileURL(process.argv.at(-1)));
+gc();
+const before = process.memoryUsage().heapUsed;
+const tracker = new PendingObserveExtractionTracker();
+const key = tracker.key("session-a", "alice", "default");
+for (let i = 0; i < 4000; i++) tracker.track(key, new Promise(() => {}), new AbortController());
+gc();
+console.log(JSON.stringify(process.memoryUsage().heapUsed - before));`,
+      trackerSource,
+    ],
+    { cwd: fileURLToPath(new URL("..", import.meta.url)), stdio: ["ignore", "pipe", "pipe"] },
+  );
+  const [stdout, stderr, code] = await Promise.all([
+    drain(child.stdout),
+    drain(child.stderr),
+    new Promise<number | null>((resolve) => child.on("close", resolve)),
+  ]);
+  assert.equal(code, 0, `retention child failed (${code}): ${stderr.slice(0, 400)}`);
+  const lastLine = stdout.trim().split("\n").at(-1);
+  assert.ok(lastLine !== undefined, `retention child printed no output: ${stderr.slice(0, 400)}`);
+  return JSON.parse(lastLine);
+}
+
+test("retained heap stays bounded across overlapping stalled tracks", { timeout: 15000 }, async () => {
+  const retained = await retainedHeapInChild();
+  assert.ok(
+    retained < 32 * 1024 * 1024,
+    `retained ${(retained / 1048576).toFixed(1)}MB for 4000 tracks; quadratic controller-set copies keep dead generations alive`,
+  );
+});
+
+test("cancel still aborts every distinct controller across overlapping tracks", () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const key = tracker.key("session-a", "alice", "default");
+  const controllers = Array.from({ length: 50 }, () => new AbortController());
+  for (const controller of controllers) {
+    tracker.track(key, stalled(), controller);
+  }
+  tracker.cancel("session-a", "alice", "default");
+  for (const controller of controllers) {
+    assert.ok(controller.signal.aborted, "every tracked controller must be aborted");
+  }
+});
+
+test("a controller admitted by a reentrant track during cancel is not aborted by that pass", () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const key = tracker.key("session-a", "alice", "default");
+  const first = new AbortController();
+  const reentrant = new AbortController();
+  first.signal.addEventListener(
+    "abort",
+    () => {
+      tracker.track(key, stalled(), reentrant);
+    },
+    { once: true },
+  );
+  tracker.track(key, stalled(), first);
+  tracker.cancel("session-a", "alice", "default");
+  assert.ok(first.signal.aborted);
+  assert.equal(reentrant.signal.aborted, false, "prior behavior: the in-flight abort pass must not abort later admissions");
+});
+
+test("each key aborts and cleans up in isolation", { timeout: 2000 }, async () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const keyA = tracker.key("session-a", "alice", "default");
+  const keyB = tracker.key("session-b", "bob", "default");
+  const controllerA = new AbortController();
+  const controllerB = new AbortController();
+  tracker.track(keyA, rejectingAfter(controllerA), controllerA);
+  tracker.track(keyB, stalled(), controllerB);
+  tracker.cancel("session-a", "alice", "default");
+  assert.ok(controllerA.signal.aborted);
+  assert.equal(controllerB.signal.aborted, false);
+  await settle();
+  await tracker.wait("session-a", "alice", "default");
+});
+
+test("an aborted chain entry settles once every generation settles and cleans up", { timeout: 2000 }, async () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const key = tracker.key("session-a", "alice", "default");
+  const first = new AbortController();
+  tracker.track(key, rejectingAfter(first), first);
+  const second = new AbortController();
+  const { promise: secondExtraction, resolve } = Promise.withResolvers<void>();
+  tracker.track(key, secondExtraction, second);
+  first.abort(preemptedExtractionError());
+  resolve();
+  await settle();
+  await tracker.wait("session-a", "alice", "default");
+});
+
+test("wait surfaces a chained non-preempted rejection", async () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const key = tracker.key("session-a", "alice", "default");
+  tracker.track(key, Promise.resolve(), new AbortController());
+  tracker.track(key, Promise.reject(new Error("extraction failed")), new AbortController());
+  await assert.rejects(tracker.wait("session-a", "alice", "default"), /extraction failed/);
+});
+
+test("a wait overlapping a preempted rejection returns without throwing", { timeout: 2000 }, async () => {
+  const tracker = new PendingObserveExtractionTracker();
+  const key = tracker.key("session-a", "alice", "default");
+  const controller = new AbortController();
+  tracker.track(key, rejectingAfter(controller), controller);
+  const waiter = tracker.wait("session-a", "alice", "default");
+  await Promise.resolve();
+  controller.abort(preemptedExtractionError());
+  await waiter;
+});

package/src/access-observe-helpers.ts

@@ -142,11 +142,9 @@ export class PendingObserveExtractionTracker {
           if (rejected) throw rejected.reason;
         })
       : extraction;
-    const entry = {
-      promise,
-      running: previous?.running ?? extraction,
-      controllers: new Set(previous ? [...previous.controllers, controller] : [controller]),
-    };
+    const controllers = previous?.controllers ?? new Set<AbortController>();
+    controllers.add(controller);
+    const entry = { promise, running: previous?.running ?? extraction, controllers };
     this.entries.set(key, entry);
     // Any settle (success OR rejection — preemption is just one rejection
     // kind) ends the pending entry; leaving a settled failure tracked wedged
@@ -201,7 +199,9 @@ export class PendingObserveExtractionTracker {
         (principal !== undefined && entryPrincipal !== (principal ?? "")) ||
         (namespace !== undefined && entryNamespace !== (namespace ?? ""))
       ) continue;
-      for (const controller of entry.controllers) controller.abort(reason);
+      // Snapshot: an abort listener may track() synchronously; iterating the
+      // shared live set would abort that new admission or never terminate.
+      for (const controller of [...entry.controllers]) controller.abort(reason);
     }
   }