@fgv/ts-agent-memory 5.1.0-36 → 5.1.0-39

package/dist/packlets/ingest/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/packlets/ingest/orchestrator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport { Hash, Logging, Result, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport {\n  Convert,\n  EntityId,\n  IEdge,\n  IIdentityCodec,\n  IIdentityCodecResult,\n  IMemoryEnvelope,\n  IMemoryRecord,\n  IProvenance,\n  Kind,\n  LinkType,\n  MemoryId,\n  MemoryScopeKey,\n  Tag,\n  isTemporalRecord,\n  isVersionCurrent\n} from '../types';\nimport { IBodyConverterRegistry } from '../converters';\nimport { IMemoryStore } from '../store';\nimport { IVectorIndex, MemoryEmbedder } from '../vector';\nimport { ICycleGuardEdge, assertNoCycles } from './cycleGuard';\nimport {\n  IEntityResolver,\n  IFactExtractor,\n  IMemoryClassifier,\n  IRelationCandidate,\n  IRelationExtractor\n} from './hostStages';\nimport {\n  ICandidateEdge,\n  ICandidateRecord,\n  IEntityResolutionCandidate,\n  IIngestItem,\n  IIngestItemResult,\n  IIngestedRecordResult,\n  IMemoryClassification,\n  IngestDisposition,\n  ResolutionVerdict\n} from './model';\n\n/**\n * The provenance source stamped on every record the ingest pipeline writes.\n * @public\n */\nexport const HOST_INGEST_PROVENANCE_SOURCE: string = 'host-ingest';\n\n/**\n * The link type whose presence on a temporal-kind candidate fires the\n * contradicts→temporal-versioned interlock.\n * @public\n */\nexport const CONTRADICTS_LINK_TYPE: LinkType = 'contradicts' as LinkType;\n\n/**\n * The default stage-4 layer-2 cosine similarity threshold (design note §2). A\n * near-duplicate candidate is surfaced to the {@link IEntityResolver} only when\n * its nearest neighbor scores `>= 0.85`.\n * @public\n */\nexport const DEFAULT_SIMILARITY_THRESHOLD: number = 0.85;\n\n/**\n * The default top-K for stage-4 layer-2 similarity candidate generation.\n * @public\n */\nexport const DEFAULT_SIMILARITY_TOP_K: number = 5;\n\n/**\n * How the write-time cycle guard behaves: `'reject'` (default — a cycle-inducing\n * edge fails the ingest) or `'off'` (no acyclicity constraint, for deployments\n * whose link graphs are legitimately cyclic — e.g. mutual associative links).\n * @public\n */\nexport type CycleGuardMode = 'reject' | 'off';\n\n/**\n * The fgv-owned six-stage ingest orchestrator. Composes the host's staged\n * classify / extract / (optional) resolve / relate machinery around fgv's owned\n * validation boundary, dedup, edge + cycle safety, provenance stamping, and the\n * contradicts→temporal interlock.\n * @public\n */\nexport interface IMemoryIngestOrchestrator {\n  /**\n   * Ingest a SINGLE item end-to-end (the first-class per-turn streaming path).\n   */\n  ingestItem(item: IIngestItem): Promise<Result<IIngestItemResult>>;\n\n  /**\n   * Ingest a batch of items. A convenience loop over {@link\n   * IMemoryIngestOrchestrator.ingestItem | ingestItem} — items are processed in\n   * order and the first failure aborts the batch.\n   */\n  ingestBatch(items: ReadonlyArray<IIngestItem>): Promise<Result<ReadonlyArray<IIngestItemResult>>>;\n}\n\n/**\n * Parameters for {@link MemoryIngestOrchestrator.create}.\n * @public\n */\nexport interface IMemoryIngestOrchestratorCreateParams {\n  /** The store every write bottoms out in (stage 6). */\n  readonly store: IMemoryStore;\n  /** Per-kind body converter registry — the stage-3 typed validation boundary. */\n  readonly registry: IBodyConverterRegistry;\n  /** Per-kind identity codecs (maps a candidate `entityId` to its storage address). */\n  readonly codecs?: ReadonlyMap<Kind, IIdentityCodec>;\n  /** Default identity codec for kinds without an explicit entry. */\n  readonly defaultCodec?: IIdentityCodec;\n  /** Stage 2 — the host's classifier. */\n  readonly classifier: IMemoryClassifier;\n  /** Stage 3 — the host's fact extractor. */\n  readonly extractor: IFactExtractor;\n  /** Stage 5 — the host's relation extractor. */\n  readonly relationExtractor: IRelationExtractor;\n  /**\n   * Stage 4 (optional, OQ-13) — the host's entity resolver. Absent → stage-4\n   * dedup is exact-`{ kind, body }`-hash only (the deterministic-identity path).\n   */\n  readonly entityResolver?: IEntityResolver;\n  /**\n   * Optional vector index for stage-4 layer-2 similarity candidate-gen. Wired\n   * together with {@link IMemoryIngestOrchestratorCreateParams.embed | embed} AND\n   * {@link IMemoryIngestOrchestratorCreateParams.entityResolver | entityResolver};\n   * absent (or either co-requisite absent) → layer-2 is skipped and dedup is\n   * exact-only.\n   */\n  readonly vectorIndex?: IVectorIndex;\n  /** Optional embedder used to embed a candidate for layer-2 similarity search. */\n  readonly embed?: MemoryEmbedder;\n  /**\n   * Stage-4 layer-2 cosine threshold. Defaults to {@link\n   * DEFAULT_SIMILARITY_THRESHOLD} (`0.85`).\n   */\n  readonly similarityThreshold?: number;\n  /**\n   * Stage-4 layer-2 top-K. Defaults to {@link DEFAULT_SIMILARITY_TOP_K} (`5`).\n   */\n  readonly similarityTopK?: number;\n  /** Write-time cycle guard mode. Defaults to `'reject'`. */\n  readonly cycleGuard?: CycleGuardMode;\n  /** Diagnostic logger (defaults to a no-op). */\n  readonly logger?: Logging.ILogger;\n}\n\n/** The fully-wired stage-4 layer-2 dependencies (present only when all three are supplied). */\ninterface ISimilarityWiring {\n  readonly resolver: IEntityResolver;\n  readonly vectorIndex: IVectorIndex;\n  readonly embed: MemoryEmbedder;\n}\n\n/** Internal per-candidate plan threaded through the pipeline. */\ninterface ICandidatePlan {\n  readonly candidate: ICandidateRecord;\n  /** The write target's storage address (re-addressed to the target for merge-into). */\n  readonly writeAddress: IIdentityCodecResult;\n  /** The write target's entity id (re-addressed for merge-into). */\n  readonly writeEntityId: EntityId;\n  /** The reference id used in stage-5 edges (the write target's `idStem`). */\n  readonly refId: MemoryId;\n  /** The resolution verdict; carries the target id on its target-bearing arms. */\n  readonly verdict: ResolutionVerdict;\n  /**\n   * The pre-ingest target record for a `merge-into` write — its existing\n   * `tags` / `links` / `provenance` are UNIONed with the candidate's at stage 6\n   * so a wholesale-replace merge never wipes them.\n   */\n  readonly mergeTarget?: IMemoryRecord<unknown>;\n}\n\n/**\n * Default {@link IMemoryIngestOrchestrator}.\n * @public\n */\nexport class MemoryIngestOrchestrator implements IMemoryIngestOrchestrator {\n  private readonly _store: IMemoryStore;\n  private readonly _registry: IBodyConverterRegistry;\n  private readonly _codecs: ReadonlyMap<Kind, IIdentityCodec>;\n  private readonly _defaultCodec: IIdentityCodec | undefined;\n  private readonly _classifier: IMemoryClassifier;\n  private readonly _extractor: IFactExtractor;\n  private readonly _relationExtractor: IRelationExtractor;\n  private readonly _similarity: ISimilarityWiring | undefined;\n  private readonly _similarityThreshold: number;\n  private readonly _similarityTopK: number;\n  private readonly _cycleGuard: CycleGuardMode;\n  private readonly _logger: Logging.ILogger;\n  private readonly _hasher: Hash.Crc32Normalizer;\n\n  private constructor(params: IMemoryIngestOrchestratorCreateParams) {\n    this._store = params.store;\n    this._registry = params.registry;\n    this._codecs = params.codecs ?? new Map<Kind, IIdentityCodec>();\n    this._defaultCodec = params.defaultCodec;\n    this._classifier = params.classifier;\n    this._extractor = params.extractor;\n    this._relationExtractor = params.relationExtractor;\n    this._similarity =\n      params.entityResolver !== undefined && params.vectorIndex !== undefined && params.embed !== undefined\n        ? { resolver: params.entityResolver, vectorIndex: params.vectorIndex, embed: params.embed }\n        : undefined;\n    this._similarityThreshold = params.similarityThreshold ?? DEFAULT_SIMILARITY_THRESHOLD;\n    this._similarityTopK = params.similarityTopK ?? DEFAULT_SIMILARITY_TOP_K;\n    this._cycleGuard = params.cycleGuard ?? 'reject';\n    this._logger = params.logger ?? new Logging.NoOpLogger();\n    this._hasher = new Hash.Crc32Normalizer();\n  }\n\n  /** Family-convention factory. */\n  public static create(params: IMemoryIngestOrchestratorCreateParams): Result<MemoryIngestOrchestrator> {\n    return succeed(new MemoryIngestOrchestrator(params));\n  }\n\n  /** {@inheritDoc IMemoryIngestOrchestrator.ingestItem} */\n  public async ingestItem(item: IIngestItem): Promise<Result<IIngestItemResult>> {\n    return (await this._classify(item))\n      .thenOnSuccess((classification) => this._extract(item, classification))\n      .thenOnSuccess((candidates) => this._processCandidates(item, candidates));\n  }\n\n  /** {@inheritDoc IMemoryIngestOrchestrator.ingestBatch} */\n  public async ingestBatch(\n    items: ReadonlyArray<IIngestItem>\n  ): Promise<Result<ReadonlyArray<IIngestItemResult>>> {\n    const results: IIngestItemResult[] = [];\n    for (const item of items) {\n      const result: Result<IIngestItemResult> = await this.ingestItem(item);\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      results.push(result.value);\n    }\n    return succeed(results);\n  }\n\n  /** Stage 2 — classify (host), normalizing a rejected promise into a Failure. */\n  private async _classify(item: IIngestItem): Promise<Result<IMemoryClassification>> {\n    return this._capture(() => this._classifier.classify(item), `ingest '${item.id}': classify`);\n  }\n\n  /** Stage 3 — extract (host), normalizing a rejected promise into a Failure. */\n  private async _extract(\n    item: IIngestItem,\n    classification: IMemoryClassification\n  ): Promise<Result<ReadonlyArray<ICandidateRecord>>> {\n    return this._capture(() => this._extractor.extract(item, classification), `ingest '${item.id}': extract`);\n  }\n\n  /**\n   * Stages 3b-6 over the extracted candidates: validate bodies, resolve/dedup\n   * (stage 4), relate + cycle guard (stage 5), and load-with-provenance (stage 6).\n   */\n  private async _processCandidates(\n    item: IIngestItem,\n    candidates: ReadonlyArray<ICandidateRecord>\n  ): Promise<Result<IIngestItemResult>> {\n    // Snapshot the store once; stage-4 resolution and the cycle guard reason over\n    // the pre-ingest state.\n    const snapshotResult: Result<ReadonlyArray<IMemoryRecord<unknown>>> = await this._store.list();\n    if (snapshotResult.isFailure()) {\n      return fail(`ingest '${item.id}': failed to snapshot store: ${snapshotResult.message}`);\n    }\n    const snapshot: ReadonlyArray<IMemoryRecord<unknown>> = snapshotResult.value;\n    const byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>> = MemoryIngestOrchestrator._indexById(snapshot);\n\n    // Stage 3b + 4: validate each body and resolve a verdict/plan.\n    const plans: ICandidatePlan[] = [];\n    for (const candidate of candidates) {\n      const planResult: Result<ICandidatePlan> = await this._planCandidate(item, candidate, snapshot, byId);\n      if (planResult.isFailure()) {\n        return fail(planResult.message);\n      }\n      plans.push(planResult.value);\n    }\n\n    // Stage 5: relate over the writable candidates, validate + cycle-guard.\n    const writablePlans: ICandidatePlan[] = plans.filter((plan) => plan.verdict.verdict !== 'duplicate-of');\n    const edgesResult: Result<ReadonlyArray<ICandidateEdge>> = await this._relate(\n      item,\n      writablePlans,\n      snapshot,\n      byId\n    );\n    if (edgesResult.isFailure()) {\n      return fail(edgesResult.message);\n    }\n    const edges: ReadonlyArray<ICandidateEdge> = edgesResult.value;\n\n    // Stage 6: load-with-provenance, in extraction order.\n    const records: IIngestedRecordResult[] = [];\n    for (const plan of plans) {\n      const outcome: Result<IIngestedRecordResult> = await this._loadCandidate(item, plan, edges);\n      if (outcome.isFailure()) {\n        return fail(outcome.message);\n      }\n      records.push(outcome.value);\n    }\n    return succeed({ item, records });\n  }\n\n  /** Stage 3b + 4 for one candidate: validate body, resolve address, resolve verdict. */\n  private async _planCandidate(\n    item: IIngestItem,\n    candidate: ICandidateRecord,\n    snapshot: ReadonlyArray<IMemoryRecord<unknown>>,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Promise<Result<ICandidatePlan>> {\n    const kind: Kind = candidate.envelope.kind;\n    // Stage 3b: the typed validation boundary — no unchecked host body reaches the store.\n    const bodyResult: Result<string> = this._registry\n      .convert(kind, candidate.body)\n      .withErrorFormat((msg) => `ingest '${item.id}': candidate body for kind '${kind}' is invalid: ${msg}`)\n      .onSuccess(() => MemoryIngestOrchestrator._asStringBody(item, candidate));\n    if (bodyResult.isFailure()) {\n      return fail(bodyResult.message);\n    }\n    const body: string = bodyResult.value;\n\n    const addrResult: Result<IIdentityCodecResult> = this._resolveAddress(candidate.envelope.entityId, kind);\n    if (addrResult.isFailure()) {\n      return fail(`ingest '${item.id}': ${addrResult.message}`);\n    }\n    const addr: IIdentityCodecResult = addrResult.value;\n\n    return (await this._resolveVerdict(candidate, kind, body, addr, snapshot, byId)).onSuccess((verdict) =>\n      this._planFromVerdict(item, candidate, addr, verdict, byId)\n    );\n  }\n\n  /**\n   * Turn a resolved verdict into a candidate plan. A `new` verdict writes under the\n   * candidate's own address. Every TARGET-bearing verdict\n   * (`duplicate-of` / `supersede` / `merge-into`) is validated uniformly: the\n   * target must be a real store record (fgv owns validation — a non-compliant host\n   * resolver never smuggles a bogus id through) AND its kind must equal the\n   * candidate's kind (a cross-kind target would write to the wrong scope). Only\n   * `merge-into` re-addresses the write to the target's entity.\n   */\n  private _planFromVerdict(\n    item: IIngestItem,\n    candidate: ICandidateRecord,\n    addr: IIdentityCodecResult,\n    verdict: ResolutionVerdict,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Result<ICandidatePlan> {\n    if (verdict.verdict === 'new') {\n      return Convert.memoryId.convert(addr.idStem).onSuccess((refId) =>\n        succeed({\n          candidate,\n          writeAddress: addr,\n          writeEntityId: candidate.envelope.entityId,\n          refId,\n          verdict\n        })\n      );\n    }\n    // duplicate-of | supersede | merge-into: the target must exist and share the\n    // candidate's kind.\n    const target: IMemoryRecord<unknown> | undefined = byId.get(verdict.target);\n    if (target === undefined) {\n      return fail(\n        `ingest '${item.id}': ${verdict.verdict} target '${verdict.target}' does not exist in the store`\n      );\n    }\n    if (target.envelope.kind !== candidate.envelope.kind) {\n      return fail(\n        `ingest '${item.id}': ${verdict.verdict} target '${verdict.target}' is kind '${target.envelope.kind}' but the candidate is kind '${candidate.envelope.kind}'`\n      );\n    }\n    if (verdict.verdict === 'merge-into') {\n      // Re-address the write to the target's entity, carrying the target record so\n      // stage 6 can UNION its existing tags/links (never overwrite them).\n      const targetEntityId: EntityId = target.envelope.entityId;\n      return this._resolveAddress(targetEntityId, target.envelope.kind)\n        .withErrorFormat((msg) => `ingest '${item.id}': ${msg}`)\n        .onSuccess((targetAddr) =>\n          Convert.memoryId.convert(targetAddr.idStem).onSuccess((refId) =>\n            succeed({\n              candidate,\n              writeAddress: targetAddr,\n              writeEntityId: targetEntityId,\n              refId,\n              verdict,\n              mergeTarget: target\n            })\n          )\n        );\n    }\n    // duplicate-of | supersede: write under the candidate's own address.\n    return Convert.memoryId.convert(addr.idStem).onSuccess((refId) =>\n      succeed({\n        candidate,\n        writeAddress: addr,\n        writeEntityId: candidate.envelope.entityId,\n        refId,\n        verdict\n      })\n    );\n  }\n\n  /**\n   * Stage 4 — resolve a dedup verdict. Layer 1: an exact `{ kind, body }` match in\n   * the candidate's scope is a `duplicate-of` (design note §1). Layer 2 (only when\n   * a resolver + vector index + embedder are all wired): embed the candidate,\n   * surface over-threshold neighbors, and dispatch to the {@link IEntityResolver}.\n   * Otherwise the verdict is `new` (the exact-only fall-back path).\n   */\n  private async _resolveVerdict(\n    candidate: ICandidateRecord,\n    kind: Kind,\n    body: string,\n    addr: IIdentityCodecResult,\n    snapshot: ReadonlyArray<IMemoryRecord<unknown>>,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Promise<Result<ResolutionVerdict>> {\n    return this._findExactMatch(kind, body, addr.scope, snapshot).thenOnSuccess(async (matchId) => {\n      if (matchId !== undefined) {\n        return succeed({ verdict: 'duplicate-of', target: matchId });\n      }\n      const layer2: ISimilarityWiring | undefined = this._similarity;\n      if (layer2 === undefined) {\n        // No layer-2: exact-only fall-back (the deterministic-identity host path).\n        return succeed({ verdict: 'new' });\n      }\n      return this._resolveViaSimilarity(candidate, addr, body, layer2, byId);\n    });\n  }\n\n  /** Layer-2 similarity candidate-gen + resolver dispatch. */\n  private async _resolveViaSimilarity(\n    candidate: ICandidateRecord,\n    addr: IIdentityCodecResult,\n    body: string,\n    wiring: ISimilarityWiring,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Promise<Result<ResolutionVerdict>> {\n    return MemoryIngestOrchestrator._provisionalRecord(candidate, addr.idStem, body).thenOnSuccess(\n      (provisional) => this._resolveViaSimilarityEmbedded(candidate, addr, wiring, byId, provisional)\n    );\n  }\n\n  /** Layer-2 continuation once the candidate has a provisional record to embed. */\n  private async _resolveViaSimilarityEmbedded(\n    candidate: ICandidateRecord,\n    addr: IIdentityCodecResult,\n    wiring: ISimilarityWiring,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>,\n    provisional: IMemoryRecord<unknown>\n  ): Promise<Result<ResolutionVerdict>> {\n    const embedded: Result<Float32Array> = await this._capture(\n      () => wiring.embed(provisional),\n      `ingest '${candidate.envelope.entityId}': embed candidate`\n    );\n    if (embedded.isFailure()) {\n      return fail(embedded.message);\n    }\n    const queried = await this._capture(\n      () => wiring.vectorIndex.query(embedded.value, this._similarityTopK),\n      `ingest '${candidate.envelope.entityId}': similarity query`\n    );\n    if (queried.isFailure()) {\n      return fail(queried.message);\n    }\n    const similar: IEntityResolutionCandidate[] = [];\n    for (const hit of queried.value) {\n      if (hit.score < this._similarityThreshold || hit.id === addr.idStem) {\n        continue;\n      }\n      const record: IMemoryRecord<unknown> | undefined = byId.get(hit.id);\n      if (record !== undefined) {\n        similar.push({ id: hit.id, record, score: hit.score });\n      }\n    }\n    if (similar.length === 0) {\n      return succeed({ verdict: 'new' });\n    }\n    return this._capture(\n      () => wiring.resolver.resolve(candidate, similar),\n      `ingest '${candidate.envelope.entityId}': resolve`\n    );\n  }\n\n  /**\n   * Find an existing record in `scope` whose `{ kind, body }` hash matches the\n   * candidate's (layer-1 exact dedup). Invalidated temporal versions are excluded\n   * — only a live (non-temporal or current) record deduplicates a candidate.\n   */\n  private _findExactMatch(\n    kind: Kind,\n    body: string,\n    scope: MemoryScopeKey,\n    snapshot: ReadonlyArray<IMemoryRecord<unknown>>\n  ): Result<MemoryId | undefined> {\n    // Same-kind, same-scope, LIVE (non-temporal or current) records are the exact\n    // cohort. `_resolveAddress(...).map(...).orDefault()` collapses an unresolved\n    // codec to a non-matching scope with no explicit failure branch.\n    const cohort: ReadonlyArray<IMemoryRecord<unknown>> = snapshot.filter(\n      (record) =>\n        record.envelope.kind === kind &&\n        !(isTemporalRecord(record) && !isVersionCurrent(record)) &&\n        this._resolveAddress(record.envelope.entityId, record.envelope.kind)\n          .onSuccess((addr) => succeed(addr.scope))\n          .orDefault() === scope\n    );\n    return this._exactKey(kind, body).onSuccess((key) =>\n      mapResults(\n        cohort.map((record) =>\n          MemoryIngestOrchestrator._recordBodyString(record).onSuccess((recordBody) =>\n            this._exactKey(record.envelope.kind, recordBody).onSuccess((recordKey) =>\n              succeed({ id: record.envelope.id, key: recordKey })\n            )\n          )\n        )\n      ).onSuccess((keyed) => succeed(keyed.find((entry) => entry.key === key)?.id))\n    );\n  }\n\n  /**\n   * The body of a persisted record, required to be a string (the store persists\n   * only string bodies). Fails loudly rather than blind-casting an `unknown` body\n   * into the exact-dedup hash — a non-string existing body is a store-integrity\n   * fault, surfaced with context, not a silent miscompute.\n   */\n  private static _recordBodyString(record: IMemoryRecord<unknown>): Result<string> {\n    if (typeof record.body !== 'string') {\n      return fail(\n        `ingest: stored record '${record.envelope.id}' has a non-string body (got ${typeof record.body})`\n      );\n    }\n    return succeed(record.body);\n  }\n\n  /** The stage-4 exact-dedup key over `{ kind, body }` (design note §1). */\n  private _exactKey(kind: Kind, body: string): Result<string> {\n    return this._hasher.computeHash({ kind, body });\n  }\n\n  /** Stage 5 — relate (host), validate edges, and run the write-time cycle guard. */\n  private async _relate(\n    item: IIngestItem,\n    writablePlans: ReadonlyArray<ICandidatePlan>,\n    snapshot: ReadonlyArray<IMemoryRecord<unknown>>,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Promise<Result<ReadonlyArray<ICandidateEdge>>> {\n    const relationCandidates: IRelationCandidate[] = writablePlans.map((plan) => ({\n      candidate: plan.candidate,\n      id: plan.refId\n    }));\n    const proposed: Result<ReadonlyArray<ICandidateEdge>> = await this._capture(\n      () => this._relationExtractor.relate({ item, candidates: relationCandidates }),\n      `ingest '${item.id}': relate`\n    );\n    if (proposed.isFailure()) {\n      return proposed;\n    }\n    const refIds: ReadonlySet<string> = new Set<string>(writablePlans.map((plan) => plan.refId));\n    const validation: Result<true> = this._validateEdges(item, proposed.value, refIds, byId);\n    if (validation.isFailure()) {\n      return fail(validation.message);\n    }\n    if (this._cycleGuard === 'reject') {\n      const guard: Result<true> = assertNoCycles(\n        MemoryIngestOrchestrator._existingEdges(snapshot),\n        proposed.value.map((e) => ({ source: e.source, target: e.edge.target, type: e.edge.type }))\n      );\n      if (guard.isFailure()) {\n        return fail(`ingest '${item.id}': ${guard.message}`);\n      }\n    }\n    return succeed(proposed.value);\n  }\n\n  /**\n   * Validate stage-5 edges: each `source` must be a candidate being written; each\n   * `target` must resolve to a sibling candidate or an existing store record.\n   */\n  private _validateEdges(\n    item: IIngestItem,\n    edges: ReadonlyArray<ICandidateEdge>,\n    refIds: ReadonlySet<string>,\n    byId: ReadonlyMap<MemoryId, IMemoryRecord<unknown>>\n  ): Result<true> {\n    return mapResults(\n      edges.map((edge) => {\n        if (!refIds.has(edge.source)) {\n          return fail(`ingest '${item.id}': edge source '${edge.source}' is not a candidate being written`);\n        }\n        if (!refIds.has(edge.edge.target) && byId.get(edge.edge.target) === undefined) {\n          return fail(\n            `ingest '${item.id}': edge target '${edge.edge.target}' resolves to neither a sibling candidate nor an existing record`\n          );\n        }\n        return succeed(true);\n      })\n    ).onSuccess(() => succeed(true));\n  }\n\n  /** Stage 6 — stamp provenance + edges, admit through the store, record the outcome. */\n  private async _loadCandidate(\n    item: IIngestItem,\n    plan: ICandidatePlan,\n    allEdges: ReadonlyArray<ICandidateEdge>\n  ): Promise<Result<IIngestedRecordResult>> {\n    const myEdges: ReadonlyArray<ICandidateEdge> = allEdges.filter((e) => e.source === plan.refId);\n    if (plan.verdict.verdict === 'duplicate-of') {\n      // No write: the existing target satisfied the candidate. The target id is a\n      // typed field of the narrowed `duplicate-of` verdict — no cast, no guard.\n      return succeed({\n        candidate: plan.candidate,\n        resolution: plan.verdict,\n        disposition: 'deduped',\n        id: plan.verdict.target,\n        edges: myEdges\n      });\n    }\n    return this._buildRecord(item, plan, myEdges).thenOnSuccess(async (record) =>\n      (await this._store.put(record))\n        .withErrorFormat((msg) => `ingest '${item.id}': write failed: ${msg}`)\n        .onSuccess((persisted) => {\n          const disposition: IngestDisposition = plan.verdict.verdict === 'merge-into' ? 'merged' : 'written';\n          const interlock: 'temporal-versioned' | undefined =\n            plan.writeAddress.isVersioned && myEdges.some((e) => e.edge.type === CONTRADICTS_LINK_TYPE)\n              ? 'temporal-versioned'\n              : undefined;\n          return succeed({\n            candidate: plan.candidate,\n            resolution: plan.verdict,\n            disposition,\n            id: persisted.envelope.id,\n            record: persisted,\n            edges: myEdges,\n            ...(interlock !== undefined ? { interlock } : {})\n          });\n        })\n    );\n  }\n\n  /** Build the fully-stamped record to persist (provenance + edges + placeholder txn fields). */\n  private _buildRecord(\n    item: IIngestItem,\n    plan: ICandidatePlan,\n    myEdges: ReadonlyArray<ICandidateEdge>\n  ): Result<IMemoryRecord<unknown>> {\n    const base: Omit<IMemoryEnvelope, 'id' | 'seq' | 'contentHash' | 'created' | 'updated'> =\n      plan.candidate.envelope;\n    // For merge-into the store's `applyUpdate` REPLACES array fields wholesale, so\n    // the persisted envelope must already carry the UNION of the target's existing\n    // tags/links/provenance and the candidate's — otherwise the merge silently\n    // wipes the target's prior links/tags.\n    const target: IMemoryRecord<unknown> | undefined = plan.mergeTarget;\n    const priorLinks: ReadonlyArray<IEdge> = target !== undefined ? target.envelope.links : [];\n    const priorTags: ReadonlyArray<Tag> = target !== undefined ? target.envelope.tags : [];\n    const priorProvenance: IProvenance = target !== undefined ? target.envelope.provenance : { source: '' };\n    return Convert.memoryId.convert(plan.writeAddress.idStem).onSuccess((id) =>\n      // Dedup the combined links by canonical edge key: the target's prior links, the\n      // candidate's own links, and the stage-5 edges (two candidates that resolve\n      // merge-into the SAME target share a `refId` — hence the same `myEdges` — and a\n      // relation extractor may repeat an edge) each appear exactly once.\n      this._dedupEdges([...priorLinks, ...base.links, ...myEdges.map((e) => e.edge)]).onSuccess((links) => {\n        const provenance: IProvenance = {\n          // Preserve the target's provenance extension keys, overlay the candidate's,\n          // then stamp the host-ingest source + derivedFrom (target present only for\n          // merge-into; otherwise the seed is inert).\n          ...(target !== undefined ? priorProvenance : {}),\n          ...base.provenance,\n          source: HOST_INGEST_PROVENANCE_SOURCE,\n          ...(item.sourceId !== undefined ? { derivedFrom: item.sourceId } : {})\n        };\n        const envelope: IMemoryEnvelope = {\n          ...base,\n          id,\n          entityId: plan.writeEntityId,\n          seq: 0,\n          contentHash: '',\n          created: 0,\n          updated: 0,\n          provenance,\n          tags: MemoryIngestOrchestrator._unionTags(priorTags, base.tags),\n          links\n        };\n        return succeed({ envelope, body: plan.candidate.body });\n      })\n    );\n  }\n\n  /** Union two tag lists, de-duplicated, preserving first-occurrence order. */\n  private static _unionTags(prior: ReadonlyArray<Tag>, incoming: ReadonlyArray<Tag>): ReadonlyArray<Tag> {\n    const seen: Set<string> = new Set<string>();\n    const out: Tag[] = [];\n    for (const tag of [...prior, ...incoming]) {\n      if (!seen.has(tag)) {\n        seen.add(tag);\n        out.push(tag);\n      }\n    }\n    return out;\n  }\n\n  /** De-duplicate a link list by canonical edge hash, preserving first-occurrence order. */\n  private _dedupEdges(edges: ReadonlyArray<IEdge>): Result<ReadonlyArray<IEdge>> {\n    const seen: Set<string> = new Set<string>();\n    const deduped: IEdge[] = [];\n    return mapResults(\n      edges.map((edge) =>\n        this._hasher.computeHash(edge).onSuccess((key) => {\n          if (!seen.has(key)) {\n            seen.add(key);\n            deduped.push(edge);\n          }\n          return succeed(key);\n        })\n      )\n    ).onSuccess(() => succeed(deduped));\n  }\n\n  /** Resolve a `(kind, entityId)` to its storage address via the registered codec. */\n  private _resolveAddress(entityId: EntityId, kind: Kind): Result<IIdentityCodecResult> {\n    const codec: IIdentityCodec | undefined = this._codecs.get(kind) ?? this._defaultCodec;\n    if (codec === undefined) {\n      return fail(`no identity codec registered for kind '${kind}'`);\n    }\n    return codec.encode(entityId);\n  }\n\n  /** Run a host hook, normalizing a thrown/rejected hook into a Failure (never throws across the seam). */\n  private async _capture<T>(op: () => Promise<Result<T>>, label: string): Promise<Result<T>> {\n    try {\n      return await op();\n    } catch (err) {\n      const message: string = `${label} threw: ${String(err)}`;\n      this._logger.warn(message);\n      return fail(message);\n    }\n  }\n\n  /** Index a record snapshot by id (last write wins on an id collision across scopes). */\n  private static _indexById(\n    records: ReadonlyArray<IMemoryRecord<unknown>>\n  ): ReadonlyMap<MemoryId, IMemoryRecord<unknown>> {\n    const byId: Map<MemoryId, IMemoryRecord<unknown>> = new Map<MemoryId, IMemoryRecord<unknown>>();\n    for (const record of records) {\n      byId.set(record.envelope.id, record);\n    }\n    return byId;\n  }\n\n  /** Every existing outbound edge in the snapshot, as cycle-guard edges. */\n  private static _existingEdges(\n    records: ReadonlyArray<IMemoryRecord<unknown>>\n  ): ReadonlyArray<ICycleGuardEdge> {\n    const edges: ICycleGuardEdge[] = [];\n    for (const record of records) {\n      for (const edge of record.envelope.links) {\n        edges.push({ source: record.envelope.id, target: edge.target, type: edge.type });\n      }\n    }\n    return edges;\n  }\n\n  /** A provisional record for embedding a candidate (placeholder txn-time fields). */\n  private static _provisionalRecord(\n    candidate: ICandidateRecord,\n    idStem: string,\n    body: string\n  ): Result<IMemoryRecord<unknown>> {\n    return Convert.memoryId.convert(idStem).onSuccess((id) => {\n      const envelope: IMemoryEnvelope = {\n        ...candidate.envelope,\n        id,\n        seq: 0,\n        contentHash: '',\n        created: 0,\n        updated: 0\n      };\n      return succeed({ envelope, body });\n    });\n  }\n\n  /** Require a candidate body to be a string (the store persists only string bodies). */\n  private static _asStringBody(item: IIngestItem, candidate: ICandidateRecord): Result<string> {\n    if (typeof candidate.body !== 'string') {\n      return fail(\n        `ingest '${item.id}': candidate body for kind '${\n          candidate.envelope.kind\n        }' must be a string (got ${typeof candidate.body})`\n      );\n    }\n    return succeed(candidate.body);\n  }\n}\n"]}

package/dist/packlets/retrieve/index.js

@@ -8,5 +8,6 @@ export * from './linkTraversalRetriever';
 export * from './tagRetriever';
 export * from './structuredFilterRetriever';
 export * from './semanticRetriever';
+export * from './temporalRetrievers';
 export * from './hybridRetriever';
 //# sourceMappingURL=index.js.map

package/dist/packlets/retrieve/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/retrieve/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nexport * from './retriever';\nexport * from './recencyRetriever';\nexport * from './linkTraversalRetriever';\nexport * from './tagRetriever';\nexport * from './structuredFilterRetriever';\nexport * from './semanticRetriever';\nexport * from './hybridRetriever';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/retrieve/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nexport * from './retriever';\nexport * from './recencyRetriever';\nexport * from './linkTraversalRetriever';\nexport * from './tagRetriever';\nexport * from './structuredFilterRetriever';\nexport * from './semanticRetriever';\nexport * from './temporalRetrievers';\nexport * from './hybridRetriever';\n"]}

package/dist/packlets/retrieve/temporalRetrievers.js

@@ -0,0 +1,172 @@
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+import { succeed } from '@fgv/ts-utils';
+import { isTemporalRecord, selectCurrentVersion, selectVersionAsOf } from '../types';
+import { guardRetrieverCapabilities, indexedRecordMatchesQuery, limitRecords, recencyCompare } from './retriever';
+/**
+ * The capabilities every temporal retriever exposes: temporal "as-of" queries
+ * are operational (semantic recall and link traversal are not this retriever's
+ * concern).
+ * @public
+ */
+export const TEMPORAL_CAPABILITIES = {
+    supportsSemanticRecall: false,
+    supportsTemporalQuery: true,
+    supportsLinkTraversal: false
+};
+/**
+ * Group the temporal records surviving a query's scope / kind / tag / predicate
+ * pre-filter by entity (`kind` + `entityId`). Non-temporal records are excluded —
+ * the temporal retrievers operate only over versioned entities. The map values
+ * are each entity's versions (unordered).
+ */
+function groupTemporalVersionsByEntity(index, query) {
+    const groups = new Map();
+    for (const entry of index.entries()) {
+        if (!isTemporalRecord(entry.record) || !indexedRecordMatchesQuery(entry, query)) {
+            continue;
+        }
+        const key = `${entry.record.envelope.kind}\0${entry.record.envelope.entityId}`;
+        const existing = groups.get(key);
+        if (existing === undefined) {
+            groups.set(key, [entry.record]);
+        }
+        else {
+            existing.push(entry.record);
+        }
+    }
+    return groups;
+}
+/**
+ * Temporal retriever returning the **current** version of each temporal entity
+ * matching the query (the newest version whose `invalid_at` is null/absent),
+ * recency-ordered and limited. A fully-invalidated (soft-deleted) entity
+ * contributes nothing. Non-temporal records are not this retriever's concern.
+ * @public
+ */
+export class CurrentValidRetriever {
+    constructor(index) {
+        this._index = index;
+    }
+    /** {@inheritDoc IMemoryRetriever.capabilities} */
+    get capabilities() {
+        return TEMPORAL_CAPABILITIES;
+    }
+    /** Family-convention factory. */
+    static create(index) {
+        return succeed(new CurrentValidRetriever(index));
+    }
+    /** {@inheritDoc IMemoryRetriever.retrieve} */
+    retrieve(query) {
+        return Promise.resolve(guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {
+            const selected = [];
+            for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {
+                const current = selectCurrentVersion(versions);
+                if (current !== undefined) {
+                    selected.push(current);
+                }
+            }
+            selected.sort(recencyCompare);
+            return succeed(limitRecords(selected, query.limit));
+        }));
+    }
+}
+/**
+ * Temporal retriever returning, for each temporal entity matching the query, the
+ * version valid at `query.asOf` (epoch ms). `asOf` is this retriever's axis: a
+ * query without it yields an empty success (a no-op contribution to a
+ * {@link HybridRetriever}, not a failure). Results are recency-ordered and
+ * limited.
+ * @public
+ */
+export class AsOfRetriever {
+    constructor(index) {
+        this._index = index;
+    }
+    /** {@inheritDoc IMemoryRetriever.capabilities} */
+    get capabilities() {
+        return TEMPORAL_CAPABILITIES;
+    }
+    /** Family-convention factory. */
+    static create(index) {
+        return succeed(new AsOfRetriever(index));
+    }
+    /** {@inheritDoc IMemoryRetriever.retrieve} */
+    retrieve(query) {
+        return Promise.resolve(guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {
+            if (query.asOf === undefined) {
+                return succeed([]);
+            }
+            const asOf = query.asOf;
+            const selected = [];
+            for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {
+                const valid = selectVersionAsOf(versions, asOf);
+                if (valid !== undefined) {
+                    selected.push(valid);
+                }
+            }
+            selected.sort(recencyCompare);
+            return succeed(limitRecords(selected, query.limit));
+        }));
+    }
+}
+/**
+ * Temporal retriever returning **every** version of each temporal entity matching
+ * the query, ordered ascending by `valid_at` (then `seq` as a stable tiebreak) —
+ * the entity's full history. Limited after ordering.
+ *
+ * @remarks
+ * When the query matches more than one entity, the result is a single
+ * CROSS-entity list globally sorted by `valid_at` — versions of different
+ * entities interleave, NOT grouped per entity — so `limit` truncates that
+ * globally-sorted list. Constrain to one entity (e.g. via `query.scope`) for a
+ * single entity's contiguous history.
+ * @public
+ */
+export class HistoryRetriever {
+    constructor(index) {
+        this._index = index;
+    }
+    /** {@inheritDoc IMemoryRetriever.capabilities} */
+    get capabilities() {
+        return TEMPORAL_CAPABILITIES;
+    }
+    /** Family-convention factory. */
+    static create(index) {
+        return succeed(new HistoryRetriever(index));
+    }
+    /** {@inheritDoc IMemoryRetriever.retrieve} */
+    retrieve(query) {
+        return Promise.resolve(guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {
+            const history = [];
+            for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {
+                history.push(...versions);
+            }
+            history.sort(HistoryRetriever._byValidAtAscending);
+            return succeed(limitRecords(history, query.limit));
+        }));
+    }
+    /** A version's world-truth start: its `valid_at`, defaulting to `created` when absent. */
+    static _startOf(record) {
+        var _a;
+        const temporal = record.envelope.temporal;
+        /* c8 ignore next 3 -- unreachable: HistoryRetriever orders only temporal records (pre-filtered by isTemporalRecord), so `temporal` is always present; the guard keeps the type honest */
+        if (temporal === undefined) {
+            return record.envelope.created;
+        }
+        return (_a = temporal.valid_at) !== null && _a !== void 0 ? _a : record.envelope.created;
+    }
+    /**
+     * Ascending-by-`valid_at` comparator (a version's `valid_at` defaults to its
+     * `created` when absent), with `seq` as a stable ascending tiebreak so
+     * same-instant versions order by write sequence.
+     */
+    static _byValidAtAscending(a, b) {
+        const aStart = HistoryRetriever._startOf(a);
+        const bStart = HistoryRetriever._startOf(b);
+        return aStart !== bStart ? aStart - bStart : a.envelope.seq - b.envelope.seq;
+    }
+}
+//# sourceMappingURL=temporalRetrievers.js.map

package/dist/packlets/retrieve/temporalRetrievers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporalRetrievers.js","sourceRoot":"","sources":["../../../src/packlets/retrieve/temporalRetrievers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport { Result, succeed } from '@fgv/ts-utils';\nimport { IMemoryRecord, isTemporalRecord, selectCurrentVersion, selectVersionAsOf } from '../types';\nimport { IMemoryIndex } from '../index';\nimport {\n  IMemoryQuery,\n  IMemoryRetriever,\n  IMemoryRetrieverCapabilities,\n  guardRetrieverCapabilities,\n  indexedRecordMatchesQuery,\n  limitRecords,\n  recencyCompare\n} from './retriever';\n\n/**\n * The capabilities every temporal retriever exposes: temporal \"as-of\" queries\n * are operational (semantic recall and link traversal are not this retriever's\n * concern).\n * @public\n */\nexport const TEMPORAL_CAPABILITIES: IMemoryRetrieverCapabilities = {\n  supportsSemanticRecall: false,\n  supportsTemporalQuery: true,\n  supportsLinkTraversal: false\n};\n\n/**\n * Group the temporal records surviving a query's scope / kind / tag / predicate\n * pre-filter by entity (`kind` + `entityId`). Non-temporal records are excluded —\n * the temporal retrievers operate only over versioned entities. The map values\n * are each entity's versions (unordered).\n */\nfunction groupTemporalVersionsByEntity(\n  index: IMemoryIndex,\n  query: IMemoryQuery\n): Map<string, IMemoryRecord<unknown>[]> {\n  const groups: Map<string, IMemoryRecord<unknown>[]> = new Map<string, IMemoryRecord<unknown>[]>();\n  for (const entry of index.entries()) {\n    if (!isTemporalRecord(entry.record) || !indexedRecordMatchesQuery(entry, query)) {\n      continue;\n    }\n    const key: string = `${entry.record.envelope.kind}\\0${entry.record.envelope.entityId}`;\n    const existing: IMemoryRecord<unknown>[] | undefined = groups.get(key);\n    if (existing === undefined) {\n      groups.set(key, [entry.record]);\n    } else {\n      existing.push(entry.record);\n    }\n  }\n  return groups;\n}\n\n/**\n * Temporal retriever returning the **current** version of each temporal entity\n * matching the query (the newest version whose `invalid_at` is null/absent),\n * recency-ordered and limited. A fully-invalidated (soft-deleted) entity\n * contributes nothing. Non-temporal records are not this retriever's concern.\n * @public\n */\nexport class CurrentValidRetriever implements IMemoryRetriever {\n  private readonly _index: IMemoryIndex;\n\n  private constructor(index: IMemoryIndex) {\n    this._index = index;\n  }\n\n  /** {@inheritDoc IMemoryRetriever.capabilities} */\n  public get capabilities(): IMemoryRetrieverCapabilities {\n    return TEMPORAL_CAPABILITIES;\n  }\n\n  /** Family-convention factory. */\n  public static create(index: IMemoryIndex): Result<CurrentValidRetriever> {\n    return succeed(new CurrentValidRetriever(index));\n  }\n\n  /** {@inheritDoc IMemoryRetriever.retrieve} */\n  public retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>> {\n    return Promise.resolve(\n      guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {\n        const selected: IMemoryRecord<unknown>[] = [];\n        for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {\n          const current: IMemoryRecord<unknown> | undefined = selectCurrentVersion(versions);\n          if (current !== undefined) {\n            selected.push(current);\n          }\n        }\n        selected.sort(recencyCompare);\n        return succeed(limitRecords(selected, query.limit));\n      })\n    );\n  }\n}\n\n/**\n * Temporal retriever returning, for each temporal entity matching the query, the\n * version valid at `query.asOf` (epoch ms). `asOf` is this retriever's axis: a\n * query without it yields an empty success (a no-op contribution to a\n * {@link HybridRetriever}, not a failure). Results are recency-ordered and\n * limited.\n * @public\n */\nexport class AsOfRetriever implements IMemoryRetriever {\n  private readonly _index: IMemoryIndex;\n\n  private constructor(index: IMemoryIndex) {\n    this._index = index;\n  }\n\n  /** {@inheritDoc IMemoryRetriever.capabilities} */\n  public get capabilities(): IMemoryRetrieverCapabilities {\n    return TEMPORAL_CAPABILITIES;\n  }\n\n  /** Family-convention factory. */\n  public static create(index: IMemoryIndex): Result<AsOfRetriever> {\n    return succeed(new AsOfRetriever(index));\n  }\n\n  /** {@inheritDoc IMemoryRetriever.retrieve} */\n  public retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>> {\n    return Promise.resolve(\n      guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {\n        if (query.asOf === undefined) {\n          return succeed([]);\n        }\n        const asOf: number = query.asOf;\n        const selected: IMemoryRecord<unknown>[] = [];\n        for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {\n          const valid: IMemoryRecord<unknown> | undefined = selectVersionAsOf(versions, asOf);\n          if (valid !== undefined) {\n            selected.push(valid);\n          }\n        }\n        selected.sort(recencyCompare);\n        return succeed(limitRecords(selected, query.limit));\n      })\n    );\n  }\n}\n\n/**\n * Temporal retriever returning **every** version of each temporal entity matching\n * the query, ordered ascending by `valid_at` (then `seq` as a stable tiebreak) —\n * the entity's full history. Limited after ordering.\n *\n * @remarks\n * When the query matches more than one entity, the result is a single\n * CROSS-entity list globally sorted by `valid_at` — versions of different\n * entities interleave, NOT grouped per entity — so `limit` truncates that\n * globally-sorted list. Constrain to one entity (e.g. via `query.scope`) for a\n * single entity's contiguous history.\n * @public\n */\nexport class HistoryRetriever implements IMemoryRetriever {\n  private readonly _index: IMemoryIndex;\n\n  private constructor(index: IMemoryIndex) {\n    this._index = index;\n  }\n\n  /** {@inheritDoc IMemoryRetriever.capabilities} */\n  public get capabilities(): IMemoryRetrieverCapabilities {\n    return TEMPORAL_CAPABILITIES;\n  }\n\n  /** Family-convention factory. */\n  public static create(index: IMemoryIndex): Result<HistoryRetriever> {\n    return succeed(new HistoryRetriever(index));\n  }\n\n  /** {@inheritDoc IMemoryRetriever.retrieve} */\n  public retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>> {\n    return Promise.resolve(\n      guardRetrieverCapabilities(query, this.capabilities).onSuccess(() => {\n        const history: IMemoryRecord<unknown>[] = [];\n        for (const versions of groupTemporalVersionsByEntity(this._index, query).values()) {\n          history.push(...versions);\n        }\n        history.sort(HistoryRetriever._byValidAtAscending);\n        return succeed(limitRecords(history, query.limit));\n      })\n    );\n  }\n\n  /** A version's world-truth start: its `valid_at`, defaulting to `created` when absent. */\n  private static _startOf(record: IMemoryRecord<unknown>): number {\n    const temporal: IMemoryRecord<unknown>['envelope']['temporal'] = record.envelope.temporal;\n    /* c8 ignore next 3 -- unreachable: HistoryRetriever orders only temporal records (pre-filtered by isTemporalRecord), so `temporal` is always present; the guard keeps the type honest */\n    if (temporal === undefined) {\n      return record.envelope.created;\n    }\n    return temporal.valid_at ?? record.envelope.created;\n  }\n\n  /**\n   * Ascending-by-`valid_at` comparator (a version's `valid_at` defaults to its\n   * `created` when absent), with `seq` as a stable ascending tiebreak so\n   * same-instant versions order by write sequence.\n   */\n  private static _byValidAtAscending(a: IMemoryRecord<unknown>, b: IMemoryRecord<unknown>): number {\n    const aStart: number = HistoryRetriever._startOf(a);\n    const bStart: number = HistoryRetriever._startOf(b);\n    return aStart !== bStart ? aStart - bStart : a.envelope.seq - b.envelope.seq;\n  }\n}\n"]}