@remnic/core 10.0.65 → 10.0.67

package/dist/orchestration/extraction-persist-deps.d.ts.map

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

package/dist/orchestration/extraction-persist.d.ts

@@ -4,14 +4,20 @@ import { type GraphConstructionCapabilitySet, type MemoryLifecycleCapabilitySet
 import type { ResolvedScopeProfilePlan } from "../namespaces/scope-profiles.js";
 import type { ExtractionResult } from "../types.js";
 import type { ExtractionPersistDeps } from "./extraction-persist-deps.js";
+/** One extraction run's persist outcome: per-run values, no shared side channels (#1526). */
+export interface ExtractionPersistResult {
+    persistedIds: string[];
+    memoryPathById: Map<string, string>;
+    /** Facts the judge deferred — drives this run's buffer retention (#562). */
+    deferredCount: number;
+    /** Persisted pending_review ids, excluded from the thread episode set (#1635). */
+    pendingReviewIds: string[];
+}
 export declare class ExtractionPersistCoordinator {
     private readonly deps;
     constructor(deps: ExtractionPersistDeps);
     private get config();
     private get dependencyPropagationDelivery();
-    persistExtraction(result: ExtractionResult, storage: StorageManager, threadIdForExtraction?: string | null, sourceContext?: ExtractionSourceContext, baseNamespace?: string, scopeProfileWritePlan?: ResolvedScopeProfilePlan | null, sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet): Promise<{
-        persistedIds: string[];
-        memoryPathById: Map<string, string>;
-    }>;
+    persistExtraction(result: ExtractionResult, storage: StorageManager, threadIdForExtraction?: string | null, sourceContext?: ExtractionSourceContext, baseNamespace?: string, scopeProfileWritePlan?: ResolvedScopeProfilePlan | null, sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet): Promise<ExtractionPersistResult>;
 }
 //# sourceMappingURL=extraction-persist.d.ts.map

package/dist/orchestration/extraction-persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-persist.d.ts","sourceRoot":"","sources":["../../src/orchestration/extraction-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAexG,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7F,OAAO,EAUgE,KAAK,8BAA8B,EACxG,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAqD5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAGhF,OAAO,KAAK,EAEV,gBAAgB,EAQjB,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAmB1E,qBAAa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAE9C,OAAO,KAAK,MAAM,GAEjB;IACD,OAAO,KAAK,6BAA6B,GAGxC;IAEK,iBAAiB,CACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,cAAc,EACvB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,EACrC,aAAa,CAAC,EAAE,uBAAuB,EACvC,aAAa,CAAC,EAAE,MAAM,EACtB,qBAAqB,CAAC,EAAE,wBAAwB,GAAG,IAAI,EACvD,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,GAAE,8BAAuF,EAClG,aAAa,GAAE,4BAAmF,GACjG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAkxF5E"}
+{"version":3,"file":"extraction-persist.d.ts","sourceRoot":"","sources":["../../src/orchestration/extraction-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAgBxG,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7F,OAAO,EAUgE,KAAK,8BAA8B,EACxG,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAqD5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAGhF,OAAO,KAAK,EAEV,gBAAgB,EAQjB,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAmB1E,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qBAAa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAE9C,OAAO,KAAK,MAAM,GAEjB;IACD,OAAO,KAAK,6BAA6B,GAGxC;IAEK,iBAAiB,CACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,cAAc,EACvB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,EACrC,aAAa,CAAC,EAAE,uBAAuB,EACvC,aAAa,CAAC,EAAE,MAAM,EACtB,qBAAqB,CAAC,EAAE,wBAAwB,GAAG,IAAI,EACvD,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,GAAE,8BAAuF,EAClG,aAAa,GAAE,4BAAmF,GACjG,OAAO,CAAC,uBAAuB,CAAC;CAkxFpC"}

package/dist/orchestration/extraction-queue-coordinator.d.ts

@@ -1,13 +1,15 @@
 /**
  * Extraction queue coordinator — extracted from the orchestrator (issue #1526).
  *
- * Owns the background serial queue that drains extraction tasks one at a
- * time to avoid races between concurrent flush/heartbeat/bulk-import
+ * Owns the background bounded-parallel queue that drains extraction tasks
+ * while avoiding races between concurrent flush/heartbeat/bulk-import
  * triggers:
- *   - queue state (`extractionQueue` + `queueProcessing`)
+ *   - queue state (`queue` + `processing` + per-task preempt slots)
  *   - the scheduling trigger (start the drain when the first task lands and
- *     the processor is idle)
- *   - the serial drain loop itself (`processQueue`)
+ *     capacity is free)
+ *   - the drain loop itself (`processQueue`): up to `concurrency` tasks run
+ *     at once; tasks sharing an entry `key` (a buffer/session) never run
+ *     concurrently, so the same buffer is never extracted twice in parallel
  *   - failure classification (`logExtractionQueueFailure`) — issue #549:
  *     AbortError from session transitions logs at debug, real failures at
  *     error
@@ -19,41 +21,67 @@
  * orchestrator builds each task closure and hands it to `enqueue`; the
  * coordinator owns only the queue mechanics.
  *
- * Behavior-preserving move from orchestrator.ts. No logic changes — the
- * orchestrator keeps a thin delegating `waitForExtractionIdle` and the
- * `queueBufferedExtraction` builder delegates push+scheduling here.
+ * Preemption is per task: each running task receives an
+ * `ExtractionPreemptHandle` at run time and registers its own abort, so two
+ * concurrent automatic extractions cannot clobber each other's registration
+ * (the previous single-slot `runningPreempt` could only hold one).
+ * `preemptRunning` aborts at most ONE armed task — the requested key's own
+ * running work when it is armed, else the most recently armed task — which
+ * is exactly the single-slot semantics generalized from one worker to N.
  */
+/** Preemption registration for ONE running task. Armed work can be aborted
+ *  by a fail-closed flush; disarmed work (past persist) cannot. */
+export interface ExtractionPreemptHandle {
+    /** Register the task's abort (replacing any previous registration). */
+    arm(abort: () => void): void;
+    /** Remove the task's registration (idempotent). */
+    disarm(): void;
+}
+/** A queued task; the coordinator passes the task's own preempt handle. */
+export type ExtractionQueueTask = (preempt?: ExtractionPreemptHandle) => Promise<void>;
+export interface ExtractionQueueEnqueueOptions {
+    /** Jump the queue and preempt the running automatic work (force flush). */
+    front?: boolean;
+    /** Buffer/session key. Tasks sharing a key never run concurrently. */
+    key?: string;
+}
 /**
- * Coordinates the background serial extraction queue. Owns the in-flight
- * guard + queue array that previously lived as private orchestrator fields.
+ * Coordinates the background bounded-parallel extraction queue. Owns the
+ * queue array, the per-key in-flight guard, and the per-task preempt slots.
  */
 export declare class ExtractionQueueCoordinator {
+    /** Maximum tasks that run at the same time (config `extractionQueueConcurrency`). */
+    private readonly concurrency;
     /**
-     * Background serial queue for extractions (agent_end optimization).
-     * Queue stores tasks that resolve when extraction should run.
+     * Background queue for extractions (agent_end optimization). Queue stores
+     * tasks that resolve when extraction should run.
      */
     private readonly queue;
-    /** Whether the serial drain loop is currently running. */
+    /** Whether the drain loop is currently running. */
     private processing;
     private accepting;
-    private runningPreempt;
+    /** Buffer keys with a task currently running (per-key exclusion). */
+    private readonly activeKeys;
+    /** Preempt slots of the currently running tasks, keyed by slot identity. */
+    private readonly preemptSlots;
+    private preemptSeq;
+    /** Resolves the processor's park while a new task arrives mid-drain. */
+    private wake?;
+    constructor(concurrency?: number);
     /** Current queue depth (idle-wait + test seam). */
     get length(): number;
-    /** Whether the serial drain loop is currently running (idle-wait + test seam). */
+    /** Whether the drain loop is currently running (idle-wait + test seam). */
     get isProcessing(): boolean;
+    /** How many tasks may run at once (test seam + diagnostics). */
+    get maxConcurrency(): number;
     /**
-     * Enqueue a task and start the serial processor if it is idle. This is
+     * Enqueue a task and start the processor when capacity is free. This is
      * the production entry point — the orchestrator's `queueBufferedExtraction`
-     * builds each task closure and hands it here.
+     * builds each task closure and hands it here with its buffer key.
      */
-    enqueue(task: () => Promise<void>, options?: {
-        front?: boolean;
-    }): boolean;
-    /** Automatic extraction registers this so a fail-closed flush can abort it. */
-    beginPreemptable(abort: () => void): void;
-    endPreemptable(): void;
-    preemptRunning(): void;
-    runPreemptable<T>(preemptable: boolean, parent: AbortSignal | undefined, run: (signal: AbortSignal) => Promise<T>): Promise<T>;
+    enqueue(task: ExtractionQueueTask, options?: ExtractionQueueEnqueueOptions): boolean;
+    preemptRunning(preferredKey?: string): void;
+    runPreemptable<T>(preempt: ExtractionPreemptHandle | undefined, preemptable: boolean, parent: AbortSignal | undefined, run: (signal: AbortSignal) => Promise<T>): Promise<T>;
     /** Stop new producers from entering the queue. */
     stopAccepting(): void;
     /** Resume producer acceptance after an orchestrator re-initializes. */
@@ -61,16 +89,20 @@ export declare class ExtractionQueueCoordinator {
     /** Stop new producers and wait for all accepted work to finish. */
     pauseAndDrain(timeoutMs?: number): Promise<boolean>;
     /**
-     * Background serial queue processor.
-     * Processes extractions one at a time to avoid race conditions.
-     * Called automatically when items are queued via `enqueue`; also exposed
-     * for the characterization tests that push raw tasks and assert drain
-     * semantics directly.
+     * Background queue processor. Runs up to `concurrency` tasks at a time,
+     * never two tasks with the same entry key. Called automatically when items
+     * are queued via `enqueue`; also exposed for the characterization tests
+     * that push raw tasks and assert drain semantics directly.
      */
     processQueue(): Promise<void>;
+    /** Take the next queue entry whose key is not already running (FIFO within a key). */
+    private takeRunnable;
+    /** Run one entry with its own preempt slot; failures are classified + logged. */
+    private runEntry;
+    private createPreemptHandle;
     /**
      * Classify + log a failure from either the per-task catch inside
-     * `processQueue()` or the outer `processQueue().catch(...)` in
+     * `runEntry` or the outer `processQueue().catch(...)` in
      * `enqueue()`.  Issue #549: `throwIfRecallAborted`
      * (used throughout `runExtraction`) raises an Error whose `name` is
      * `"AbortError"`.  That path fires when `before_reset` aborts a
@@ -98,9 +130,11 @@ export declare class ExtractionQueueCoordinator {
      * pre-extraction `this.extractionQueue.push(...)` used by the
      * characterization tests that drive the drain manually via `processQueue`.
      */
-    pushRaw(task: () => Promise<void>): void;
+    pushRaw(task: ExtractionQueueTask, options?: {
+        key?: string;
+    }): void;
     /** Remove + return the front task (test seam for the flush deadline tests). */
-    shift(): (() => Promise<void>) | undefined;
+    shift(): ExtractionQueueTask | undefined;
     /**
      * Force the processor-busy flag so `enqueue` does not auto-start the
      * drain — used by the flush deadline test to simulate a busy queue and

package/dist/orchestration/extraction-queue-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-queue-coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestration/extraction-queue-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH;;;GAGG;AACH,qBAAa,0BAA0B;IACrC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,0DAA0D;IAC1D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAA2B;IAEjD,mDAAmD;IACnD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kFAAkF;IAClF,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAkB1E,+EAA+E;IAC/E,gBAAgB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,cAAc,IAAI,IAAI;IAItB,cAAc,IAAI,IAAI;IAKtB,cAAc,CAAC,CAAC,EACd,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC;IAUb,kDAAkD;IAClD,aAAa,IAAI,IAAI;IAIrB,uEAAuE;IACvE,eAAe,IAAI,IAAI;IAIvB,mEAAmE;IAC7D,aAAa,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE;;;;;;OAMG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC;;;;;;;;;;;;;;;;OAgBG;IACH,yBAAyB,CACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GAAG,WAAW,GAC3B,IAAI;IAgBP;;;;;OAKG;IACG,WAAW,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB/D;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIxC,+EAA+E;IAC/E,KAAK,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS;IAI1C;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAG3C"}
+{"version":3,"file":"extraction-queue-coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestration/extraction-queue-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH;mEACmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvF,MAAM,WAAW,6BAA6B;IAC5C,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAYD;;;GAGG;AACH,qBAAa,0BAA0B;IACrC,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAQ;IACzB,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,UAAU,CAAK;IACvB,wEAAwE;IACxE,OAAO,CAAC,IAAI,CAAC,CAAa;gBAEd,WAAW,SAAI;IAI3B,mDAAmD;IACnD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2EAA2E;IAC3E,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,gEAAgE;IAChE,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,6BAA6B,GAAG,OAAO;IAwBpF,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3C,cAAc,CAAC,CAAC,EACd,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC;IAWb,kDAAkD;IAClD,aAAa,IAAI,IAAI;IAIrB,uEAAuE;IACvE,eAAe,IAAI,IAAI;IAIvB,mEAAmE;IAC7D,aAAa,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BnC,sFAAsF;IACtF,OAAO,CAAC,YAAY;IAWpB,iFAAiF;YACnE,QAAQ;IAatB,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;;;;;;;;;;OAgBG;IACH,yBAAyB,CACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GAAG,WAAW,GAC3B,IAAI;IAgBP;;;;;OAKG;IACG,WAAW,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB/D;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKpE,+EAA+E;IAC/E,KAAK,IAAI,mBAAmB,GAAG,SAAS;IAIxC;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAG3C"}

package/dist/orchestration/extraction-run-helpers.d.ts

@@ -62,7 +62,7 @@ export declare function runExtractionPostPersistBestEffort(runDeadlineAware: (op
 export interface ExtractionDeferRetentionOptions {
     clearBufferAfterExtraction: boolean;
     extractionJudgeShadow: boolean;
-    getDeferredCount: () => number;
+    deferredCount: number;
     normalizedTurns: BufferTurn[];
     bufferKey: string;
     retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;
@@ -90,7 +90,8 @@ export interface ExtractionPostPersistOptions {
         propagateErrors?: boolean;
     }) => Promise<void>;
     extractionJudgeShadow: boolean;
-    getDeferredCount: () => number;
+    /** Facts this run's persist deferred to the judge — drives retention (#1523). */
+    deferredCount: number;
     normalizedTurns: BufferTurn[];
     bufferKey: string;
     retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;

package/dist/orchestration/extraction-run-helpers.d.ts.map

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

package/dist/orchestration/extraction-run.d.ts

@@ -40,10 +40,7 @@ export interface ExtractionRunCoordinatorDeps {
     getExtraction: () => Pick<ExtractionEngine, "extract">;
     getStorageRouter: () => Pick<NamespaceStorageRouter, "storageFor">;
     getThreading: () => Pick<ThreadingManager, "processTurn" | "updateThreadTitle">;
-    persistExtraction: (result: ExtractionResult, storage: StorageManager, threadIdForExtraction?: string | null, sourceContext?: ExtractionSourceContext, baseNamespace?: string, scopeProfileWritePlan?: ResolvedScopeProfilePlan | null, sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet) => Promise<{
-        persistedIds: string[];
-        memoryPathById: Map<string, string>;
-    }>;
+    persistExtraction: (result: ExtractionResult, storage: StorageManager, threadIdForExtraction?: string | null, sourceContext?: ExtractionSourceContext, baseNamespace?: string, scopeProfileWritePlan?: ResolvedScopeProfilePlan | null, sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet) => Promise<ExtractionPersistResult>;
     maybeCapturePassiveCorrections: (turns: readonly BufferTurn[], opts: {
         sessionKey: string;
         principal?: string;
@@ -56,7 +53,7 @@ export interface ExtractionRunCoordinatorDeps {
     getCodingContextForSession: (sessionKey: string) => CodingContext | null;
     applyCodingNamespaceOverlay: (sessionKey: string, namespace: string) => string;
     boxBuilderFor: (storage: StorageManager) => Pick<BoxBuilder, "onExtraction">;
-    appendPersistedThreadEpisodes: (threadId: string, ids: string[]) => Promise<void>;
+    appendPersistedThreadEpisodes: (threadId: string, ids: string[], pendingReviewIds: string[]) => Promise<void>;
     maybeScheduleConsolidation: (nonZero: boolean) => void;
     requestQmdMaintenance: () => void;
     runTierMigrationCycle: (storage: StorageManager, trigger: "extraction" | "maintenance" | "manual", options?: {
@@ -64,11 +61,11 @@ export interface ExtractionRunCoordinatorDeps {
         limitOverride?: number;
         force?: boolean;
     }) => Promise<TierMigrationCycleSummary>;
-    getLastPersistExtractionDeferredCount: () => number;
     recordProcessedExtractionFingerprint: (storage: StorageManager, fingerprint: string, preloadedMeta?: Awaited<ReturnType<StorageManager["loadMeta"]>>) => Promise<void>;
 }
 import { capExtractionRetryStateEntries, computeExtractionRetryNextEligibleMs, deriveSourceConnector, deriveTopicsFromExtraction } from "./extraction-run-helpers.js";
 import type { ExtractionResilienceStatus } from "./extraction-run-helpers.js";
+import type { ExtractionPersistResult } from "./extraction-persist.js";
 export { capExtractionRetryStateEntries, computeExtractionRetryNextEligibleMs, deriveSourceConnector, deriveTopicsFromExtraction, };
 export type { ExtractionResilienceStatus };
 /**
@@ -81,7 +78,7 @@ export declare class ExtractionRunCoordinator {
     private readonly recentExtractionFingerprints;
     private readonly extractionRetryState;
     private readonly hydratedRetryNamespaces;
-    private providerBreaker;
+    private readonly providerBreaker;
     constructor(deps: ExtractionRunCoordinatorDeps);
     private get config();
     private latestSourceValidAtFromTurns;
@@ -97,13 +94,6 @@ export declare class ExtractionRunCoordinator {
      *  Cross-process coherence: a fresh coordinator hydrates from the shared
      *  meta.json, so a failure persisted by another process is honored here. */
     private hydrateRetryStateFromMeta;
-    private logBreakerTransition;
-    /** True while the breaker suppresses non-forced attempts. Flips an expired
-     *  `open` breaker to `half_open`, which allows exactly one probe (the next
-     *  non-forced attempt) because the extraction queue is a serial drain. */
-    private isProviderBreakerOpen;
-    private onProviderFailure;
-    private resetProviderBreakerOnSuccess;
     /** Rebuild `meta.extractionRetryState` from the in-memory namespace mirror,
      *  bounded to the newest entries, and prune the mirror to match. */
     private persistRetryStateToMeta;

package/dist/orchestration/extraction-run.d.ts.map

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

package/dist/orchestration/fact-dedup-window.d.ts

@@ -0,0 +1,49 @@
+import { type StorageManager } from "../index.js";
+/**
+ * Fact-dedup commit window (codex P2, #1526): with extractionQueueConcurrency
+ * > 1 (or daemon + external drain workers), two sessions can both pass the
+ * content-hash check at persist time and both write, producing duplicate
+ * active copies — the persist-time checks run well before the write, and
+ * writeMemory mints a fresh id per write. This module serializes the short
+ * "final recheck → write" window per storage dir (in-process chain +
+ * fail-closed cross-process fact-dedup.lock, mirroring the profile/meta lock
+ * shape: bounded, no LLM or corpus-scale work planned inside, throw BEFORE
+ * any read/write when the lock is not acquired). The persist-time check stays
+ * OUTSIDE the window exactly like the consolidation LLM call stays outside
+ * commitConsolidatedProfile.
+ */
+export interface FactDedupProbe {
+    hasContentHashDedup(storage: StorageManager, key: string): Promise<boolean>;
+}
+interface FactDedupMatchOptions {
+    readonly category: string;
+    readonly contentHashDedupKey: string;
+    readonly connector?: string;
+    readonly citationEnabled: boolean;
+    readonly citationTemplate: string;
+}
+/**
+ * Connector-aware duplicate confirm: same final semantics as the persist-time
+ * check — an authoritative index miss is a clean NOT-duplicate, a hash hit or
+ * a non-authoritative/failed lookup must be confirmed against the hot+cold
+ * corpus (same category, active, same normalized content, same connector),
+ * and a corpus-scan failure fails OPEN so an unverifiable state cannot
+ * silently drop content.
+ */
+export declare function confirmActiveFactDuplicate(probe: FactDedupProbe, storage: StorageManager, opts: FactDedupMatchOptions): Promise<boolean>;
+export type FactDedupWindowOutcome<T> = {
+    suppressed: true;
+} | {
+    suppressed: false;
+    result: T;
+};
+/**
+ * Run `write` inside the per-dir fact-dedup window: recheck `recheck` (the
+ * SAME confirm used at persist time, now under the lock) and suppress as a
+ * duplicate when a concurrent session committed the same content first;
+ * otherwise write. Lock contention throws (fail closed) — never an unlocked
+ * write; the extraction retry path retains the accepted turns.
+ */
+export declare function persistUnderFactDedupWindow<T>(storageDir: string, recheck: () => Promise<boolean>, write: () => Promise<T>): Promise<FactDedupWindowOutcome<T>>;
+export {};
+//# sourceMappingURL=fact-dedup-window.d.ts.map

package/dist/orchestration/fact-dedup-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-dedup-window.d.ts","sourceRoot":"","sources":["../../src/orchestration/fact-dedup-window.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAMpE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAiBD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EACjD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAgBpC"}

package/dist/orchestration/maintenance.js

@@ -1,24 +1,24 @@
 import {
   MaintenanceScheduler
-} from "../chunk-HFEGRMFG.js";
-import "../chunk-GROHOWR5.js";
+} from "../chunk-JLGBJ4AX.js";
+import "../chunk-5MGKGEL7.js";
 import "../chunk-666A3MOW.js";
-import "../chunk-7ZTGMEXF.js";
-import "../chunk-5JABRT5G.js";
+import "../chunk-O5ZINWW3.js";
+import "../chunk-GHHQLSSY.js";
 import "../chunk-5KBIOI4G.js";
-import "../chunk-KYSSUY66.js";
-import "../chunk-434E4BTO.js";
-import "../chunk-B7VD36TI.js";
+import "../chunk-U2CAGMUD.js";
+import "../chunk-HH73M65H.js";
+import "../chunk-WHROVQ5Q.js";
 import "../chunk-KJTKLXTH.js";
 import "../chunk-2DQ2XREU.js";
 import "../chunk-J5WI4QRP.js";
 import "../chunk-EWMRFW3F.js";
-import "../chunk-BH7NVSEC.js";
-import "../chunk-5UEGL5BF.js";
+import "../chunk-4SOWMA55.js";
+import "../chunk-CI3MAAIY.js";
 import "../chunk-OGXXGHW6.js";
 import "../chunk-YUTT4ZTI.js";
-import "../chunk-ZPLQ27MY.js";
-import "../chunk-FR7PK7ED.js";
+import "../chunk-5UM4H64E.js";
+import "../chunk-P4TV3TQ2.js";
 import "../chunk-74AY3S7U.js";
 import "../chunk-T6OZW2WR.js";
 import "../chunk-QEDLJDHP.js";
@@ -26,7 +26,7 @@ import "../chunk-U4LUIE6Y.js";
 import "../chunk-5YQXWVCP.js";
 import "../chunk-TBBDFYXW.js";
 import "../chunk-TOTT6S2V.js";
-import "../chunk-XVQVF2TK.js";
+import "../chunk-NHWDTOBN.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-QGVCFVX6.js";
 import "../chunk-IGOW4TJE.js";
@@ -99,7 +99,7 @@ import "../chunk-YCVB7X56.js";
 import "../chunk-PQVCH2AE.js";
 import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
-import "../chunk-SEA56G6S.js";
+import "../chunk-V4XE263I.js";
 import "../chunk-YBA52OKG.js";
 import "../chunk-2D7BTSDW.js";
 import "../chunk-353C5UNV.js";

package/dist/orchestration/provider-breaker.d.ts

@@ -0,0 +1,58 @@
+import type { ExtractionFailureClass } from "../types.js";
+export interface ProviderBreakerConfig {
+    readonly failureThreshold: number;
+    readonly cooldownMs: number;
+    readonly authCooldownMs: number;
+}
+export interface ProbeOwnerToken {
+    readonly __probeOwner: true;
+}
+export interface ProviderBreakerSnapshot {
+    readonly state: "closed" | "open" | "half_open";
+    readonly openUntilMs: number;
+    readonly consecutiveFailures: number;
+    readonly lastReason: string;
+}
+export interface ProbeAcquisition {
+    /** True when the attempt is suppressed (breaker open, or the half-open
+     *  probe is owned by another attempt). */
+    readonly suppressed: boolean;
+    /** True when THIS attempt owns the single half-open probe and must
+     *  terminate it via {@link failure}/{@link success} (with its token), or
+     *  release it via {@link releaseProbe} on any early exit (deadline, abort,
+     *  throw). */
+    readonly probe: boolean;
+    /** Opaque ownership token; only the matching token settles or releases the
+     *  probe, so attempts that bypass the gate (forced extractions) can never
+     *  release another attempt's in-flight probe. */
+    readonly token?: ProbeOwnerToken;
+}
+/**
+ * Provider circuit breaker with single-flight half-open probe OWNERSHIP
+ * (codex P2 on #3311): under extractionQueueConcurrency > 1 several sessions
+ * can pass an expired `open` breaker in the same window, and a wall-clock
+ * reservation either expires under a live long provider attempt (600s
+ * timeouts) or pins the breaker when an attempt dies without settling. So the
+ * probe is OWNED, not timed: exactly one attempt holds it from the
+ * open→half_open flip until its terminal `failure()`/`success()`, and any
+ * early exit releases it explicitly. A released-but-unfinished probe lets the
+ * next attempt re-probe; a retry backoff still throttles that namespace.
+ */
+export declare class ProviderCircuitBreaker {
+    private consecutiveFailures;
+    private openUntilMs;
+    private state;
+    private lastReason;
+    private probeHeld;
+    private probeToken;
+    acquire(now: number): ProbeAcquisition;
+    /** Release an owned probe on an attempt that exits without a terminal
+     *  outcome (deadline, abort, throw). Only the matching owner releases;
+     *  idempotent; state stays half_open so the next attempt re-probes. */
+    releaseProbe(token?: ProbeOwnerToken): void;
+    failure(cls: ExtractionFailureClass, now: number, config: ProviderBreakerConfig, probeToken?: ProbeOwnerToken): void;
+    success(probeToken?: ProbeOwnerToken): void;
+    snapshot(): ProviderBreakerSnapshot;
+    private logTransition;
+}
+//# sourceMappingURL=provider-breaker.d.ts.map

package/dist/orchestration/provider-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-breaker.d.ts","sourceRoot":"","sources":["../../src/orchestration/provider-breaker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B;8CAC0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;kBAGc;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;qDAEiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAoBtC;;2EAEuE;IACvE,YAAY,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI;IAM3C,OAAO,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI;IAqCpH,OAAO,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI;IAmB3C,QAAQ,IAAI,uBAAuB;IASnC,OAAO,CAAC,aAAa;CAStB"}

package/dist/orchestrator.d.ts

@@ -22,6 +22,7 @@ import { RecallSectionCoordinator } from "./orchestration/recall-section-coordin
 import { QmdResultResolver } from "./orchestration/qmd-result-resolver.js";
 import { ContradictionLinkingCoordinator } from "./orchestration/contradiction-linking-coordinator.js";
 import { ExtractionRunCoordinator, type ExtractionRunResult, type ExtractionResilienceStatus } from "./orchestration/extraction-run.js";
+import { type ExtractionPersistResult } from "./orchestration/extraction-persist.js";
 import type { ExtractionSourceContext } from "./orchestration/extraction-origin-context.js";
 import type { GraphRecallExpansionOptions, GraphRecallExpansionResult } from "./orchestration/graph-recall-coordinator.js";
 import { type IngestReplayBatchOptions, type TurnIngestionOptions } from "./orchestration/turn-ingestion.js";
@@ -106,19 +107,6 @@ export declare class Orchestrator {
      * (rule 11) — these hang off the orchestrator instance.
      */
     private faithfulnessCounters;
-    /**
-     * Side-channel: number of facts deferred in the most recent
-     * `persistExtraction` call (issue #562, PR 2). The caller reads this after
-     * `persistExtraction` returns to decide whether to retain buffer turns for
-     * the next extraction pass. Not part of the return signature because many
-     * callers already destructure `persistedIds` by position.
-     */
-    private lastPersistExtractionDeferredCount;
-    /**
-     * Side-channel (#1635): pending_review persisted ids from the last
-     * persistExtraction; runExtraction excludes them from the thread episode set.
-     */
-    private lastPersistExtractionPendingReviewIds;
     private readonly _fastGatewayLlm;
     get fastGatewayLlm(): FallbackLlmClient | null;
     getConsoleFaithfulnessDistribution(): FaithfulnessGateCounters | undefined;
@@ -707,10 +695,7 @@ export declare class Orchestrator {
     requestQmdMaintenanceForTool(reason: string): void;
     persistExtraction(result: ExtractionResult, storage: StorageManager, threadIdForExtraction?: string | null, sourceContext?: ExtractionSourceContext, baseNamespace?: string, scopeProfileWritePlan?: ResolvedScopeProfilePlan | null, 
     /** Verbatim source turn text the facts were extracted from (faithfulness gate #1576). */
-    sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet): Promise<{
-        persistedIds: string[];
-        memoryPathById: Map<string, string>;
-    }>;
+    sourceText?: string, graphCaps?: GraphConstructionCapabilitySet, lifecycleCaps?: MemoryLifecycleCapabilitySet): Promise<ExtractionPersistResult>;
     /**
      * Append persisted ids to the thread episode set, excluding pending_review
      * fact ids (#1635) so they don't re-seed predecessor edges. Fail-open like