@remnic/core 9.69.56 → 9.69.58

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

@@ -0,0 +1,76 @@
+import type { ContradictionResolveOutcome } from "./contradiction-linking-coordinator.js";
+import type { GraphEdge } from "../graph.js";
+import type { GraphConstructionCapabilitySet } from "../capabilities.js";
+import type { SemanticDedupHit } from "../dedup/semantic.js";
+import type { EmbeddingFallback } from "../embedding-fallback.js";
+import type { FaithfulnessGateCounters } from "../extraction-faithfulness.js";
+import type { JudgeVerdict } from "../extraction-judge.js";
+import type { StorageManager } from "../index.js";
+import type { LocalLlmClient } from "../local-llm.js";
+import type { NamespaceStorageRouter } from "../namespaces/storage.js";
+import type { RouteRule, RoutingEngineOptions } from "../routing/engine.js";
+import type { SearchBackend } from "../search/port.js";
+import type { ThreadingManager } from "../threading.js";
+import type { MemoryFile, MemoryLink, PluginConfig } from "../types.js";
+import type { DependencyPropagationDeliveryPort } from "./dependency-propagation-delivery.js";
+export interface ExtractionPersistDeps {
+    config: PluginConfig;
+    getStorageRouter: () => NamespaceStorageRouter;
+    getThreading: () => ThreadingManager;
+    getDependencyPropagationDelivery: () => DependencyPropagationDeliveryPort;
+    getLocalLlm: () => LocalLlmClient;
+    getQmd: () => SearchBackend;
+    getJudgeVerdictCache: () => Map<string, JudgeVerdict>;
+    getJudgeDeferCounts: () => Map<string, number>;
+    getFaithfulnessCounters: () => FaithfulnessGateCounters;
+    getEmbeddingFallback: () => EmbeddingFallback;
+    setLastPersistExtractionDeferredCount: (value: number) => void;
+    setLastPersistExtractionPendingReviewIds: (ids: string[]) => void;
+    addContentHashDedup: (targetStorage: StorageManager, content: string) => Promise<void>;
+    hasContentHashDedup: (targetStorage: StorageManager, content: string) => Promise<boolean>;
+    backfillTemporalBoundsOnDedupHit: (targetStorage: StorageManager, dedupContent: string, bounds: {
+        invalidAt?: string;
+        validFrom?: string;
+        observedAt?: string;
+        eventTimeSource?: "extracted" | "assumed";
+    }, entityRef?: string, sourceConnector?: string) => Promise<void>;
+    saveContentHashIndexes: () => Promise<void>;
+    artifactTypeForCategory: (category: string) => "decision" | "constraint" | "todo" | "definition" | "commitment" | "correction" | "fact";
+    loadRoutingRules: () => Promise<RouteRule[]>;
+    routeEngineOptions: () => RoutingEngineOptions;
+    semanticDedupLookup: (content: string, limit: number, targetStorage: StorageManager) => Promise<SemanticDedupHit[]>;
+    checkForContradiction: (content: string, category: string, namespaceScope: string, anchor?: {
+        entityRef?: string;
+        structuredAttributes?: Record<string, string>;
+        storageSnapshot?: MemoryFile[];
+    }) => Promise<{
+        supersededId: string;
+        confidence: number;
+        reason: string;
+        supersededPath: string;
+        supersededCreated: string;
+        supersededTags: string[];
+    } | null>;
+    applyDeferredContradictionResolve: (contradiction: {
+        supersededId: string;
+        reason: string;
+        supersededPath: string;
+        supersededCreated: string;
+        supersededTags: string[];
+    } | null | undefined, storage: StorageManager, newMemoryId: string, postWriteGuard: boolean) => Promise<ContradictionResolveOutcome>;
+    suggestLinksForMemory: (content: string, category: string, namespaceScope: string) => Promise<MemoryLink[]>;
+    storageDirNamespace: (storageDir: string) => string;
+    indexPersistedMemory: (storage: StorageManager, memoryId: string) => Promise<void>;
+    buildGraphEdge: (storage: StorageManager, memoryRelPath: string, entityRef: string | undefined, memoryId: string, factContent: string, allMemsForGraph: MemoryFile[] | null | undefined, memoryPathById: Map<string, string>, threadIdForEdge: string | undefined, threadEpisodeIdsForGraph: string[] | undefined, fallbackCausalPredecessor: string | undefined, graphCaps?: GraphConstructionCapabilitySet) => Promise<GraphEdge[] | void>;
+    /**
+     * #2807 (finding 4): invalidate the in-process GraphIndex edge cache for
+     * a storage dir. Called after a merged-target graph rewrite rolls back —
+     * the rollback repairs the JSONL files, but the warm cache served by
+     * `loadEdgesCached()` would otherwise keep the rolled-back edges for the
+     * full TTL. Optional so existing partial deps keep compiling; production
+     * wiring always supplies it.
+     */
+    invalidateGraphEdgeCache?: (storage: StorageManager) => void;
+    updateTemporalTagIndexes: (storage: StorageManager, persistedIds: string[]) => Promise<void>;
+}
+//# sourceMappingURL=extraction-persist-deps.d.ts.map

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

@@ -0,0 +1 @@
+{"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-promotion.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Auto-promotion gating helpers for the extraction-persist pipeline
+ * (extracted from extraction-persist.ts to keep that file under the
+ * structural line-count ceiling; issue #1909 / seam 16).
+ *
+ * Pure decision helpers that answer "may this fact be auto-promoted?" for
+ * both scope-profile targets and the server-shared namespace. Behavior is a
+ * verbatim move from the closures that previously lived inside
+ * `persistExtraction`; `this.deps.*` state is threaded in as explicit
+ * parameters so the functions stay free of coordinator instance state.
+ */
+import { StorageManager } from "../index.js";
+import { type MemorySubject } from "../types.js";
+import type { MemoryFile, PluginConfig } from "../types.js";
+import type { ResolvedScopeProfilePlan } from "../namespaces/scope-profiles.js";
+import { type MergedTargetPromotionPayload } from "./semantic-merge-promotion-payload.js";
+export declare const confidenceTierOrder: readonly ["explicit", "implied", "inferred", "speculative"];
+export declare function profileAutoPromotionAllows(scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined, category: string, confidence: number): boolean;
+export declare function sharedAutoPromotionAllows(config: PluginConfig, scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined, category: string, confidence: number): boolean;
+export declare function shouldPromoteToShared(config: PluginConfig, scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined, profileAllowsSharedWrites: boolean, storageDirNamespace: (storageDir: string) => string, targetStorage: StorageManager, category: string, confidence: number): boolean;
+/**
+ * Read the active-copy corpus across BOTH storage tiers (hot + cold).
+ *
+ * #2016 cold-tier finding: the authoritative content-hash rebuild unions the
+ * hot and cold tiers, so `hasFactContentHash()` can report a hit for a
+ * fact/procedure whose only active copy was demoted to `cold/`. A promotion or
+ * dedup confirmation scan that reads `readAllMemories()` (hot) alone misses
+ * that copy, so it either writes a duplicate hot copy or skips a needed
+ * temporal backfill. Scanning both tiers keeps the confirmation coherent with
+ * the hash index. Cold reads are folded in only when the cold tier is
+ * non-empty so hot-only namespaces incur no extra allocation.
+ */
+export declare function readActiveMemoriesBothTiers(storage: StorageManager): Promise<MemoryFile[]>;
+/**
+ * PR #2016: after `writeSealedMemory` has made a fact `.md` durable with its
+ * fact-hash flush deferred (#1909 batching), a throw in the fallible post-write
+ * work (contradiction resolve, indexing, shared promotion, artifact write)
+ * would strand the deferred parent hash — the shared fact-hash index on disk
+ * would be missing the parent until the next corpus rebuild, letting a peer
+ * re-extract a duplicate. Flush the batch save before the error propagates so
+ * the durable-hash invariant holds on every path. No-op when dedup is off
+ * (`deferred=false` → the write already flushed and the batch saver is a no-op).
+ * Best-effort: a flush failure is logged and never masks the original error.
+ */
+export declare function flushDeferredFactHashOnFailure(saveContentHashIndexes: () => Promise<void>, deferred: boolean): Promise<void>;
+/**
+ * Merged-target promotion scope gate (PR #2771 finding A). A committed
+ * record stamped `toolScoped: true` must keep its promoted copy withheld
+ * from the shared namespace even when the merged body no longer matches
+ * the content heuristics that earned the target its marker at write time —
+ * the merge judge composes new text, and without the incoming connector
+ * the heuristic returns false outright. The committed marker is
+ * authoritative; the heuristics only ever ADD withholding. Not a
+ * parsed-config surface: the field is the frontmatter literal `true` or
+ * absent.
+ */
+export declare function promotionWithholdsToolScope(options: {
+    toolScoped?: true;
+    content: string;
+    sourceConnector?: string;
+    procedureSteps?: ReadonlyArray<{
+        toolCall?: {
+            kind?: string;
+        };
+    }>;
+}): boolean;
+/**
+ * Subject guard (issue #2372), extracted verbatim from the coordinator
+ * closure: the ONE gate shared by every extraction-side promotion path so
+ * behavior matches the spaces surface (§27).
+ */
+export declare function makeSubjectGuardAllows(config: PluginConfig): (subject: MemorySubject | undefined, target: string, label: string) => boolean;
+/**
+ * Finding C (issue #2330 review): a successful semantic merge mutates only
+ * the source namespace, but the create path's promotion step owns the
+ * shared/profile copies linked back by `sourceMemoryId`. Merging a target
+ * that already has promoted copies would leave those copies serving the
+ * pre-merge body while the source serves the merged claims, so such a
+ * target must bypass the merge and let the normal write run.
+ *
+ * Finding E (final round) + round N+12 (B): the scan covers ALL resolved
+ * layers — NEVER filtered by today's `autoPromote.targets` selection, by
+ * current write authorization, or by today's `promotionTargets` list. A copy
+ * created while a layer was listed stays linked by `sourceMemoryId` after
+ * the operator removes that layer from the promotion selection while it
+ * remains resolvable through readOrder/layers; detection scans history while
+ * policy governs writes (the authorization-change lesson applied to
+ * selection). An unreadable promotion namespace is treated as "copies may
+ * exist": the conservative create path runs rather than risk
+ * cross-namespace divergence.
+ */
+export declare function promotionScanNamespaces(config: PluginConfig, scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined): string[];
+export interface BatchPromotedCopyProbe {
+    check: (sourceStorage: StorageManager, targetMemoryId: string) => Promise<boolean>;
+    /**
+     * Finding F (final round): drop the cached scans after this batch itself
+     * promoted a copy, so a later fact merging into the same target still sees
+     * the copy the batch just wrote.
+     */
+    invalidate: () => void;
+}
+/**
+ * Finding F (capacity regression): the guard scans every promotion
+ * namespace's full hot+cold corpus, and a multi-fact extraction calls it
+ * once per judge-approved fact — O(facts × namespaces × corpus). The probe
+ * scans each namespace ONCE per batch and reuses the result. The uncached
+ * per-call helper below shares this single implementation.
+ */
+export declare function createBatchPromotedCopyProbe(config: PluginConfig, getStorageRouter: () => {
+    storageFor: (namespace: string) => Promise<StorageManager>;
+}, scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined): BatchPromotedCopyProbe;
+export declare function mergeTargetHasPromotedCopies(args: {
+    config: PluginConfig;
+    getStorageRouter: () => {
+        storageFor: (namespace: string) => Promise<StorageManager>;
+    };
+    scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined;
+    sourceStorage: StorageManager;
+    targetMemoryId: string;
+}): Promise<boolean>;
+/**
+ * Round N+10 (A): run the merged target's promotion and its stale-copy
+ * reconciliation as ONE step so reconciliation cannot be skipped on a
+ * no-promotion exit. `promoteMemoryToShared` returns undefined when this
+ * merge's min(incoming, target) downgrade dropped the committed record below
+ * the profile/shared promotion minimum, and `buildMergedTargetPromotionPayload`
+ * returns null for a degraded merge — in both cases no replacement copy is
+ * written, yet a concurrent writer may have published the PRE-merge body
+ * after the caller's initial probe. Reconciliation still runs: with no
+ * promoted body supplied, {@link retireStaleMergedTargetPromotionCopies}
+ * re-reads the committed record and retires copies predating it, superseding
+ * them onto the committed target itself ("none is warranted" below the
+ * threshold). Promotion failures stay fail-open — the merge stands.
+ *
+ * Round N+15 (A): the payload is a CACHE of the committed record as of the
+ * builder's read. Between that read and this promotion another writer can
+ * merge the same target again (or a lifecycle operation can retire it), so
+ * the record is re-read and the cache confirmed against the committed
+ * revision AND body immediately before promoting. On any advance — or an
+ * unreadable record, which can never confirm the cache — the promotion AND
+ * its reconciliation are abandoned: the newer writer's copy stands, a cached
+ * body never becomes canonical, and the next merge retries both.
+ */
+export declare function promoteAndReconcileMergedTarget(args: {
+    promote: (payload: MergedTargetPromotionPayload) => Promise<string | undefined>;
+    config: PluginConfig;
+    getStorageRouter: () => {
+        storageFor: (namespace: string) => Promise<StorageManager>;
+    };
+    scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined;
+    sourceStorage: StorageManager;
+    sourceMemoryId: string;
+    /** Null = payload builder refused (degraded merge / target replaced mid-flight). */
+    mergedPromotion: MergedTargetPromotionPayload | null;
+    /** #2807 (finding 1): the builder's post-commit reread FAILED — the payload is unknown, not refused. Skips the destructive reconciliation. */
+    mergedPromotionReadFailed?: boolean;
+    normalize: (content: string) => string;
+    onReconciled?: () => void;
+}): Promise<void>;
+/**
+ * Round N+7 (B) + P1-A (#2330 round N+8) + round N+10 (A): reconcile a
+ * merged target's promoted copies after the merged-body promotion lands.
+ * The pre-mutation probe that guards the merge can race a concurrent writer
+ * that is promoting the same target: the probe reports no copies, the other
+ * writer publishes the PRE-merge body, and the merged-target promotion then
+ * adds the current body — promotion dedups by content, so both copies stay
+ * active across namespaces. Detection: an ACTIVE memory in any resolved
+ * promotion namespace (never the source's own) whose `sourceMemoryId` names
+ * this target and whose normalized body differs from the canonical body.
+ * Round N+10 (A) extended this to the NO-promotion path:
+ * `promotedContent` may be omitted and `promotedMemoryId` may be omitted
+ * (below-threshold downgrade or degraded merge) — stale copies then
+ * supersede onto the committed source target itself, leaving exactly one
+ * current copy or none if none is warranted. Round N+13 (A): an
+ * unreadable, missing, or empty canonical body ABORTS the reconciliation —
+ * no copy is ever retired off a body that was never confirmed. Round N+15
+ * (A): the canonical body is ALWAYS the re-read committed record, never the
+ * promotion's cached payload — a writer committing a newer merge between
+ * this writer's promotion and its reconciliation would otherwise have its
+ * current copy superseded off the older cached body; when the re-read has
+ * moved past the promoted body, this promotion's own copies are stale too
+ * and supersede onto the SOURCE target. Replace, not add: each stale copy
+ * is superseded with `supersededBy` pointing at the current copy (or the
+ * source target). Best-effort and fail-open per namespace — a failed
+ * retirement is logged and leaves the pre-fix state, which the next merge
+ * retries. Returns the number of stale copies retired.
+ */
+export declare function retireStaleMergedTargetPromotionCopies(args: {
+    config: PluginConfig;
+    getStorageRouter: () => {
+        storageFor: (namespace: string) => Promise<StorageManager>;
+    };
+    scopeProfileWritePlan: ResolvedScopeProfilePlan | null | undefined;
+    sourceStorage: StorageManager;
+    sourceMemoryId: string;
+    /** The body the merged-target promotion wrote (raw committed record content). Omit on the no-promotion path. The canonical body is always re-read from the committed record; this only selects the supersession target. */
+    promotedContent?: string;
+    /** The id of the promoted copy just written (supersession target while it still carries the canonical body). Omit when no replacement promotion ran — stale copies supersede onto the source target. */
+    promotedMemoryId?: string;
+    /** The caller's canonical content form (normalizeStoredHashSource). */
+    normalize: (content: string) => string;
+}): Promise<number>;
+//# sourceMappingURL=extraction-persist-promotion.d.ts.map

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

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

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

@@ -0,0 +1,19 @@
+import { type ExtractionSourceContext } from "./extraction-origin-context.js";
+import { type StorageManager } from "../index.js";
+import { type GraphConstructionCapabilitySet, type MemoryLifecycleCapabilitySet } from "../capabilities.js";
+import type { ResolvedScopeProfilePlan } from "../namespaces/scope-profiles.js";
+import type { ExtractionResult } from "../types.js";
+import type { ExtractionPersistDeps } from "./extraction-persist-deps.js";
+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, 
+    /** 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>;
+    }>;
+}
+//# sourceMappingURL=extraction-persist.d.ts.map

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

@@ -0,0 +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;AAwD5B,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;AAe1E,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;IACvD,yFAAyF;IACzF,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;CA+zF5E"}

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

@@ -0,0 +1,103 @@
+/**
+ * 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
+ * triggers:
+ *   - queue state (`extractionQueue` + `queueProcessing`)
+ *   - the scheduling trigger (start the drain when the first task lands and
+ *     the processor is idle)
+ *   - the serial drain loop itself (`processQueue`)
+ *   - failure classification (`logExtractionQueueFailure`) — issue #549:
+ *     AbortError from session transitions logs at debug, real failures at
+ *     error
+ *   - the idle wait (`waitForIdle`) used by bootstrap and tests
+ *
+ * Does NOT own the WHAT — `runExtraction`, the dedupe fingerprint check,
+ * the deadline timer, and the buffer-clear policy remain on the
+ * orchestrator (they need the full extraction dependency surface). The
+ * 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.
+ */
+/**
+ * Coordinates the background serial extraction queue. Owns the in-flight
+ * guard + queue array that previously lived as private orchestrator fields.
+ */
+export declare class ExtractionQueueCoordinator {
+    /**
+     * Background serial 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. */
+    private processing;
+    private accepting;
+    /** Current queue depth (idle-wait + test seam). */
+    get length(): number;
+    /** Whether the serial drain loop is currently running (idle-wait + test seam). */
+    get isProcessing(): boolean;
+    /**
+     * Enqueue a task and start the serial processor if it is idle. This is
+     * the production entry point — the orchestrator's `queueBufferedExtraction`
+     * builds each task closure and hands it here.
+     */
+    enqueue(task: () => Promise<void>): boolean;
+    /** Stop new producers from entering the queue. */
+    stopAccepting(): void;
+    /** Resume producer acceptance after an orchestrator re-initializes. */
+    resumeAccepting(): void;
+    /** 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.
+     */
+    processQueue(): Promise<void>;
+    /**
+     * Classify + log a failure from either the per-task catch inside
+     * `processQueue()` 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
+     * queued task to avoid duplicate extraction — it is intentional
+     * cancellation, not a failure.  Downgrading the log to debug
+     * prevents spurious `error`-level lines that routinely appear
+     * right next to a successful `persisted: N facts, M entities` log
+     * and that confuse operators into thinking extraction is broken.
+     * Genuine extraction failures (network, parse, I/O) still log at
+     * `error`.
+     *
+     * Source differentiates the two call sites so the log message
+     * names the right layer (`task` vs `processor`).
+     */
+    logExtractionQueueFailure(err: unknown, source: "task" | "processor"): void;
+    /**
+     * Wait until the extraction queue is fully drained (no tasks queued, no
+     * drain in flight) or `timeoutMs` elapses. Used by bootstrap (after a
+     * dry-run import) and by tests that need to assert extraction settled.
+     * Returns false on timeout, true once idle.
+     */
+    waitForIdle(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Push a raw task WITHOUT auto-starting the processor, matching the
+     * pre-extraction `this.extractionQueue.push(...)` used by the
+     * characterization tests that drive the drain manually via `processQueue`.
+     */
+    pushRaw(task: () => Promise<void>): void;
+    /** Remove + return the front task (test seam for the flush deadline tests). */
+    shift(): (() => Promise<void>) | 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
+     * assert a queued task's deadline expires while it waits.
+     */
+    setProcessingForTest(value: boolean): void;
+}
+//# sourceMappingURL=extraction-queue-coordinator.d.ts.map

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

@@ -0,0 +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;IAEzB,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,GAAG,OAAO;IAa3C,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"}

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

@@ -0,0 +1,123 @@
+import type { BufferTurn, ExtractionFailureClass, ExtractionResult, MetaState } from "../types.js";
+import type { StorageManager } from "../index.js";
+export declare function combineExtractionAbortSignals(primary: AbortSignal | undefined, deadlineController: AbortController | undefined): AbortSignal | undefined;
+export declare function deriveTopicsFromExtraction(result: ExtractionResult): string[];
+/** Bounded cap on persisted per-fingerprint retry-state entries (per namespace meta). */
+export declare const EXTRACTION_RETRY_STATE_MAX_ENTRIES = 500;
+export interface ExtractionRetryStateEntry {
+    attempts: number;
+    nextEligibleAtMs: number;
+    firstFailedAtMs: number;
+    lastFailureClass: ExtractionFailureClass;
+}
+export interface ExtractionResilienceStatus {
+    breaker: {
+        state: "closed" | "open" | "half_open";
+        openUntilMs: number;
+        consecutiveFailures: number;
+        lastReason: string;
+    };
+    backoffFingerprintCount: number;
+}
+/**
+ * Pure backoff scheduler. Returns the absolute ms timestamp at which a
+ * fingerprint that has failed `attempts` times becomes eligible again:
+ * exponential via the configured schedule, clamped to `maxBackoffMs`, with
+ * ±`jitterRatio` multiplicative jitter. `rng` is injectable for deterministic
+ * tests. Never returns a timestamp before `now`.
+ */
+export declare function computeExtractionRetryNextEligibleMs(attempts: number, scheduleMs: readonly number[], maxBackoffMs: number, jitterRatio: number, now: number, rng?: () => number): number;
+/**
+ * Cap the persisted retry-state array to the newest `maxEntries` by
+ * firstFailedAt. Guards invalid caps so they cannot turn `slice(-maxEntries)`
+ * into an unbounded copy (AGENTS.md rule 17).
+ */
+export declare function capExtractionRetryStateEntries<T extends {
+    firstFailedAt: string;
+}>(entries: readonly T[], maxEntries: number): T[];
+/**
+ * Derive a single `sourceConnector` from a batch of turns.
+ * Returns the connector ONLY when ALL turns carry the same connector.
+ * Mixed tagged/untagged batches return undefined — extraction facts are
+ * persisted at batch level, so attributing them to the single tagged
+ * connector would falsely label facts from untagged turns.
+ * Conflicting connectors (different values) also return undefined.
+ */
+export declare function deriveSourceConnector(turns: readonly BufferTurn[]): string | undefined;
+export declare function runExtractionPostPersistBestEffort(runDeadlineAware: (operation: () => Promise<unknown>, phase: string, clearTimerOnError?: boolean, options?: {
+    ignoreAbort?: boolean;
+    ignoreDeadline?: boolean;
+}) => Promise<unknown>, stage: string, operation: () => Promise<unknown>, options?: {
+    ignoreAbort?: boolean;
+    ignoreDeadline?: boolean;
+    propagateErrors?: boolean;
+}): Promise<void>;
+/**
+ * Applies deferred-judge retention only to live, non-shadow extraction runs.
+ * Replay/import paths must not synthesize live-buffer entries after persistence.
+ */
+export interface ExtractionDeferRetentionOptions {
+    clearBufferAfterExtraction: boolean;
+    extractionJudgeShadow: boolean;
+    getDeferredCount: () => number;
+    normalizedTurns: BufferTurn[];
+    bufferKey: string;
+    retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;
+}
+export declare function runExtractionDeferRetention(runPostPersistBestEffort: (stage: string, operation: () => Promise<unknown>, options?: {
+    ignoreAbort?: boolean;
+}) => Promise<void>, options: ExtractionDeferRetentionOptions): Promise<void>;
+export interface ExtractionPostPersistOptions {
+    result: ExtractionResult;
+    storage: StorageManager;
+    meta?: MetaState;
+    extractionFingerprint?: string;
+    shouldPersistProcessedFingerprint: boolean;
+    recordProcessedExtractionFingerprint: (storage: StorageManager, fingerprint: string, meta: MetaState) => Promise<void>;
+    runDeadlineAware: (operation: () => Promise<unknown>, phase: string, clearTimerOnError?: boolean, options?: {
+        ignoreAbort?: boolean;
+        ignoreDeadline?: boolean;
+    }) => Promise<unknown>;
+    isDeadlineError: (error: unknown) => boolean;
+    createDeadlineError: (stage: string) => Error;
+    deadlineMs?: number;
+    clearBufferAfterExtraction: boolean;
+    runPostPersistBestEffort: (stage: string, operation: () => Promise<unknown>, options?: {
+        ignoreAbort?: boolean;
+        ignoreDeadline?: boolean;
+        propagateErrors?: boolean;
+    }) => Promise<void>;
+    extractionJudgeShadow: boolean;
+    getDeferredCount: () => number;
+    normalizedTurns: BufferTurn[];
+    bufferKey: string;
+    retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;
+    clearBuffer: (options?: {
+        ignoreAbort?: boolean;
+    }) => Promise<void>;
+    failOnExtractionFailure: boolean;
+}
+export interface ExtractionPostPersistResult {
+    meta?: MetaState;
+    metadataFailed: boolean;
+}
+export declare function runExtractionPostPersist(options: ExtractionPostPersistOptions): Promise<ExtractionPostPersistResult>;
+/**
+ * Record a processed fingerprint when applicable and advance the extraction
+ * liveness watermark only for a provider-backed empty success. Fingerprinted
+ * imports treat the metadata save as load-bearing dedupe state; normal live
+ * runs treat the stamp as diagnostic and fail open. Deadline errors always
+ * propagate.
+ */
+export declare function commitEmptySuccessExtraction(args: {
+    storage: StorageManager;
+    meta: MetaState | null;
+    extractionFingerprint: string | null;
+    shouldPersistProcessedFingerprint: boolean;
+    hasExtractionFailure: boolean;
+    extractionSkippedReason: ExtractionResult["extractionSkippedReason"];
+    recordProcessedExtractionFingerprint: (storage: StorageManager, fingerprint: string, meta: MetaState) => Promise<unknown>;
+    runDeadlineAware: <T>(operation: () => Promise<T>, phase: string, clearTimerOnError?: boolean) => Promise<T>;
+    isDeadlineError: (error: unknown) => boolean;
+}): Promise<void>;
+//# sourceMappingURL=extraction-run-helpers.d.ts.map

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

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