@remnic/core 9.50.2 → 9.51.0

package/dist/{orchestrator-qJ07zI8H.d.ts → orchestrator-BshGam-o.d.ts}

@@ -3,17 +3,17 @@ import { BriefingFollowupGenerator } from './briefing.js';
 import { SmartBuffer } from './buffer.js';
 import { FaithfulnessGateCounters } from './extraction-faithfulness.js';
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions } from './search/port.js';
-import { S as StorageManager } from './storage-BkYN1RIy.js';
+import { S as StorageManager } from './storage-CVfGWqCI.js';
 import { TranscriptManager } from './transcript.js';
 import { HourlySummarizer } from './summarizer.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
-import { M as MaintenanceScheduler } from './maintenance-ClmUVpGI.js';
-import { P as PluginConfig, M as MemoryFile, ag as MemoryActionEvent, Q as QmdSearchResult, R as RecallPlanMode, I as IdentityInjectionMode, be as RecallSectionConfig, aS as MemoryLink, a5 as ExtractionResult, j as BufferTurn, C as CodingContext, o as SourceConnectorProvenance, ar as MemoryIntent, l as MemoryFrontmatter, s as BehaviorLoopPolicyState, bf as BootstrapOptions, bg as BootstrapResult, bh as ConsolidationObservation, aF as DaySummaryResult, a8 as ImportTurn } from './types-u2s9j1uD.js';
+import { M as MaintenanceScheduler } from './maintenance-CKwxpdRx.js';
+import { P as PluginConfig, M as MemoryFile, ag as MemoryActionEvent, Q as QmdSearchResult, R as RecallPlanMode, I as IdentityInjectionMode, be as RecallSectionConfig, aS as MemoryLink, a5 as ExtractionResult, j as BufferTurn, C as CodingContext, o as SourceConnectorProvenance, ar as MemoryIntent, l as MemoryFrontmatter, s as BehaviorLoopPolicyState, bf as BootstrapOptions, bg as BootstrapResult, bh as ConsolidationObservation, aF as DaySummaryResult, a8 as ImportTurn } from './types-CkiDUorT.js';
 import { CompoundingEngine } from './compounding/engine.js';
 import { UtilityRuntimeValues } from './utility-runtime.js';
 import { CompressionGuidelineCoordinator } from './orchestration/compression-guideline-coordinator.js';
-import { S as SemanticConsolidationResult } from './semantic-consolidation-BBDuP9nJ.js';
+import { S as SemanticConsolidationResult } from './semantic-consolidation-DLDKvyy5.js';
 import { EmbeddingFallback } from './embedding-fallback.js';
 import { ExtractionEngine } from './extraction.js';
 import { ObjectiveStateSearchResult } from './objective-state.js';
@@ -32,8 +32,8 @@ import { CapabilitySet, GraphConstructionCapabilitySet, MemoryLifecycleCapabilit
 import { BoxBuilder } from './boxes.js';
 import { NamespaceStorageRouter } from './namespaces/storage.js';
 import { ThreadingManager } from './threading.js';
-import { R as ResolvedScopeProfilePlan } from './scope-profiles--vfXPl3X.js';
-import { GraphIndex } from './graph.js';
+import { R as ResolvedScopeProfilePlan } from './scope-profiles-NzGPDXLn.js';
+import { c as GraphIndex } from './graph-444E-DrF.js';
 import { RecallXrayServedBy, RecallXraySnapshot } from './recall-xray.js';
 import { RecallContextComposition } from './recall-context-composition.js';
 import { LiveConnectorsRunSummary } from './live-connectors-runner.js';
@@ -43,9 +43,9 @@ import { NegativeExampleStore } from './negative.js';
 import { SessionObserverState } from './session-observer-state.js';
 import { a as SemanticDedupHit } from './semantic-TddhF0y7.js';
 import { ReplayTurn } from './replay/types.js';
-import { W as WearablesService, M as MeetingsService } from './service-B8DtbpCM.js';
+import { W as WearablesService, M as MeetingsService } from './service-BIgVM7fL.js';
 import { LcmEngine } from './lcm/engine.js';
-import { b as NamespaceKind, N as NamespaceCatalog } from './catalog-D-G7RgXR.js';
+import { b as NamespaceKind, N as NamespaceCatalog } from './catalog-D3B4RDy1.js';
 import { NamespaceSearchHealth } from './namespaces/search.js';
 import { SharedContextManager } from './shared-context/manager.js';
 import { RuntimePolicyValues } from './policy-runtime.js';
@@ -863,10 +863,9 @@ declare class QmdResultResolver {
  * Owns the write-path semantic-analysis subsystem: contradiction detection
  * (QMD similarity search + LLM verification), deferred contradiction
  * auto-resolve (#1645 — retires superseded memories only after the new write's
- * tombstone status is known), and memory link suggestion. Behavior-preserving
- * move from orchestrator.ts — no logic changes; the orchestrator constructs one
- * instance and keeps thin delegating methods so existing call sites (writeMemory
- * fact-write branches) continue to work.
+ * tombstone status is known), and memory link suggestion. The orchestrator
+ * constructs one instance and keeps thin delegating methods so existing call
+ * sites (writeMemory fact-write branches) continue to work.
  *
  * Config, storage, search, namespace resolution, and the extraction engine are
  * accessed through getter callbacks (not captured at construction) so that
@@ -884,6 +883,8 @@ interface ContradictionResult {
     supersededCreated: string;
     supersededTags: string[];
 }
+/** Outcome of the post-write contradiction retirement attempt. */
+type ContradictionResolveOutcome = "not_attempted" | "blocked" | "resolved" | "lost_race" | "supersede_failed" | "supersedes_clear_failed";
 /**
  * Subset of {@link ContradictionResult} used by
  * {@link ContradictionLinkingCoordinator.applyDeferredContradictionResolve}.
@@ -930,7 +931,12 @@ declare class ContradictionLinkingCoordinator {
      * Check if a new memory contradicts an existing one.
      * Uses QMD to find similar memories, then LLM to verify contradiction.
      */
-    checkForContradiction(content: string, category: string, namespaceScope: string): Promise<ContradictionResult | null>;
+    checkForContradiction(content: string, category: string, namespaceScope: string, anchor?: {
+        entityRef?: string;
+        structuredAttributes?: Record<string, string>;
+        attributes?: Record<string, string>;
+        storageSnapshot?: MemoryFile[];
+    }): Promise<ContradictionResult | null>;
     /**
      * #1645: Complete the deferred contradiction auto-resolve after writeMemory
      * returns and the new write's tombstone status is known. Retires the old
@@ -939,7 +945,7 @@ declare class ContradictionLinkingCoordinator {
      * only active copy — deferring here closes the "contradictionAutoResolve
      * supersedes before tombstone status is known" defect class.
      */
-    applyDeferredContradictionResolve(contradiction: ContradictionResolveTarget | null | undefined, storage: StorageManager, newMemoryId: string, postWriteGuard: boolean): Promise<void>;
+    applyDeferredContradictionResolve(contradiction: ContradictionResolveTarget | null | undefined, storage: StorageManager, newMemoryId: string, postWriteGuard: boolean): Promise<ContradictionResolveOutcome>;
     /**
      * Suggest links for a new memory based on similar existing memories.
      */
@@ -1118,6 +1124,22 @@ declare class ExtractionRunCoordinator {
     }): Promise<ExtractionRunResult>;
 }
 
+interface GraphRecallExpansionOptions {
+    memoryResults: QmdSearchResult[];
+    recallNamespaces: string[];
+    recallResultLimit: number;
+    asOf?: string;
+    asOfMs?: number;
+    deadlineAtMs?: number | null;
+    includeLowConfidence?: boolean;
+}
+interface GraphRecallExpansionResult {
+    merged: QmdSearchResult[];
+    seedPaths: string[];
+    expandedPaths: GraphRecallExpandedEntry[];
+    seedResults: QmdSearchResult[];
+}
+
 /**
  * Turn-ingestion coordinator — extracted from the orchestrator
  * (issue #1526, seam 20).
@@ -1153,10 +1175,10 @@ interface TurnIngestionOptions extends SourceConnectorProvenance {
  * Owns the graph-expansion subsystem in recall: spreading-activation
  * traversal from seed memories, seed-path resolution relative to
  * per-namespace storage, and the last-graph-recall snapshot persistence.
- * Behavior-preserving move from orchestrator.ts — no logic changes; the
- * orchestrator constructs one instance and keeps thin delegating methods so
- * existing call sites (recallInternal, cold-fallback pipeline) continue to
- * work.
+ * Behavior-preserving move from orchestrator.ts with bounded graph-state
+ * lookups and optional path scoring. The orchestrator constructs one instance
+ * and keeps thin delegating methods so existing call sites (recallInternal,
+ * cold-fallback pipeline) continue to work.
  *
  * Config, storage, graph index, namespace resolution, and QMD result
  * resolution are accessed through getter callbacks (not captured at
@@ -1196,6 +1218,7 @@ declare class GraphRecallCoordinator {
     private readonly resolveColdQmdResultForRecall;
     private readonly storageForAbsoluteQmdResultPath;
     private readonly readQmdResultMemory;
+    private readonly graphPathStateLoader;
     constructor(options: {
         getConfig: () => PluginConfig;
         getStorage: () => StorageManager;
@@ -1217,6 +1240,9 @@ declare class GraphRecallCoordinator {
         memoryResults: QmdSearchResult[];
         recallNamespaces: string[];
         recallResultLimit: number;
+        /** Query-time instant used for graph-path invalidity checks. */
+        asOf?: string;
+        asOfMs?: number;
         deadlineAtMs?: number | null;
         /** Issue #681 — when true, bypass graphTraversalConfidenceFloor. */
         includeLowConfidence?: boolean;
@@ -2320,7 +2346,7 @@ declare class Orchestrator {
     private buildQueryAwarePrefilter;
     private searchScopedMemoryCandidates;
     private fetchQmdMemoryResultsWithArtifactTopUp;
-    private expandResultsViaGraph;
+    expandResultsViaGraph(options: GraphRecallExpansionOptions): Promise<GraphRecallExpansionResult>;
     private recordLastGraphRecallSnapshot;
     private recordLastIntentSnapshot;
     private recordLastQmdRecallSnapshot;

package/dist/orchestrator.d.ts

@@ -3,13 +3,13 @@ import './briefing.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
 import './search/port.js';
-import './storage-BkYN1RIy.js';
+import './storage-CVfGWqCI.js';
 import './transcript.js';
 import './summarizer.js';
 import './local-llm.js';
 import './fallback-llm.js';
-import './maintenance-ClmUVpGI.js';
-export { B as BulkImportBatchIngestResult, a as BulkImportBatchPartialFailureError, b as COMPACTION_SIGNAL_MAX_AGE_MS, D as DaySummaryGatherOptions, E as ExtractionRunResult, c as GraphRecallRankedResult, e as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, f as QueryAwarePrefilter, R as RecallInvocationOptions, g as RecallModeDecision, h as appendMemoryToGraphContext, i as applyQueryAwareCandidateFilter, j as blendGraphExpandedRecallScore, k as buildCompressionGuidelinesMarkdown, l as buildMemoryPathById, m as computeArtifactCandidateFetchLimit, n as computeArtifactRecallLimit, o as computeQmdHybridFetchLimit, d as defaultWorkspaceDir, p as deriveTopicsFromExtraction, q as filterHourlySummaryMarkdownForLocalDay, r as filterRecallCandidates, t as formatDateInTimeZone, u as graphPathRelativeToStorage, v as hasIdentityRecoveryIntent, w as isArtifactMemoryPath, x as lifecycleRecallScoreAdjustment, y as mapRecallSourceToXrayServedBy, z as mergeArtifactRecallCandidates, A as mergeGraphExpandedResults, F as normalizeIanaTimeZone, H as parseFiniteDate, J as parseGraphRecallRankedResults, K as parseMemoryIntentSnapshot, L as parseQmdRecallResults, M as qmdStartupCollectionCheckWithTimeout, N as raceRecallAbort, S as resolveEffectiveIdentityInjectionMode, U as resolveEffectiveRecallMode, V as resolvePersistedMemoryRelativePath, W as resolveRecallModeDecision, X as resolveRecallModeDecisionAsync, Y as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, Z as shouldFilterLifecycleRecallCandidate, _ as splitTurnsBySourceValidAt, $ as summarizeGraphShadowComparison, a0 as targetSourceValidAtSortMs, a1 as throwIfRecallAborted, a2 as tokenizeRecallQuery, a3 as utcDateKeysForLocalDay } from './orchestrator-qJ07zI8H.js';
+import './maintenance-CKwxpdRx.js';
+export { B as BulkImportBatchIngestResult, a as BulkImportBatchPartialFailureError, b as COMPACTION_SIGNAL_MAX_AGE_MS, D as DaySummaryGatherOptions, E as ExtractionRunResult, c as GraphRecallRankedResult, e as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, f as QueryAwarePrefilter, R as RecallInvocationOptions, g as RecallModeDecision, h as appendMemoryToGraphContext, i as applyQueryAwareCandidateFilter, j as blendGraphExpandedRecallScore, k as buildCompressionGuidelinesMarkdown, l as buildMemoryPathById, m as computeArtifactCandidateFetchLimit, n as computeArtifactRecallLimit, o as computeQmdHybridFetchLimit, d as defaultWorkspaceDir, p as deriveTopicsFromExtraction, q as filterHourlySummaryMarkdownForLocalDay, r as filterRecallCandidates, t as formatDateInTimeZone, u as graphPathRelativeToStorage, v as hasIdentityRecoveryIntent, w as isArtifactMemoryPath, x as lifecycleRecallScoreAdjustment, y as mapRecallSourceToXrayServedBy, z as mergeArtifactRecallCandidates, A as mergeGraphExpandedResults, F as normalizeIanaTimeZone, H as parseFiniteDate, J as parseGraphRecallRankedResults, K as parseMemoryIntentSnapshot, L as parseQmdRecallResults, M as qmdStartupCollectionCheckWithTimeout, N as raceRecallAbort, S as resolveEffectiveIdentityInjectionMode, U as resolveEffectiveRecallMode, V as resolvePersistedMemoryRelativePath, W as resolveRecallModeDecision, X as resolveRecallModeDecisionAsync, Y as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, Z as shouldFilterLifecycleRecallCandidate, _ as splitTurnsBySourceValidAt, $ as summarizeGraphShadowComparison, a0 as targetSourceValidAtSortMs, a1 as throwIfRecallAborted, a2 as tokenizeRecallQuery, a3 as utcDateKeysForLocalDay } from './orchestrator-BshGam-o.js';
 export { formatCompressionGuidelinesForRecall } from './orchestration/compression-guideline-coordinator.js';
 import './live-connectors-runner.js';
 import './model-registry.js';
@@ -21,12 +21,12 @@ import './embedding-fallback.js';
 import './semantic-TddhF0y7.js';
 import './capabilities.js';
 import './replay/types.js';
-import './types-u2s9j1uD.js';
-import './service-B8DtbpCM.js';
+import './types-CkiDUorT.js';
+import './service-BIgVM7fL.js';
 import './lcm/engine.js';
-import './semantic-consolidation-BBDuP9nJ.js';
-import './catalog-D-G7RgXR.js';
-import './scope-profiles--vfXPl3X.js';
+import './semantic-consolidation-DLDKvyy5.js';
+import './catalog-D3B4RDy1.js';
+import './scope-profiles-NzGPDXLn.js';
 import './namespaces/search.js';
 import './shared-context/manager.js';
 import './compounding/engine.js';
@@ -37,6 +37,8 @@ import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './contradiction-config.js';
+import './graph-path-scoring-config.js';
 import './types-continuity.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
@@ -76,7 +78,7 @@ import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './graph.js';
+import './graph-444E-DrF.js';
 import './recall-context-composition.js';
 import './framework-CNDn2164.js';
 import './memory-provenance.js';