@graphrefly/graphrefly 0.37.0 → 0.38.0

package/dist/index-Bub6x_D4.d.cts

@@ -0,0 +1,427 @@
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-C3IMAGpT.cjs';
+import { G as Graph } from './graph-CHsVwf9S.cjs';
+import { B as BaseAuditRecord } from './imperative-audit-ahAE65a9.cjs';
+
+/**
+ * Memory patterns (roadmap §4.3) — public-face Phase-4 primitives audited under
+ * `archive/docs/SESSION-public-face-blocks-review.md` (Wave A, locked 2026-04-25).
+ *
+ * Five primitives:
+ * - {@link decay} — pure exponential-decay utility.
+ * - {@link lightCollection} — Map + LRU eviction + audit log; non-Graph bundle.
+ * - {@link collection} / {@link CollectionGraph} — scored memory store with live
+ *   decay-ranking via reactive timer dep.
+ * - {@link vectorIndex} / {@link VectorIndexGraph} — reactive vector store with
+ *   optional HNSW backend, retention, and reactive {@link VectorIndexGraph.searchNode}.
+ * - {@link knowledgeGraph} / {@link KnowledgeGraph} — entities + typed edges with
+ *   symmetric adjacency indexes and reactive {@link KnowledgeGraph.relatedNode}.
+ *
+ * **No imperative reads.** Per the API-style policy locked 2026-04-25, public-face
+ * primitives expose reactive reads only — `itemNode` / `hasNode` / `searchNode` /
+ * `relatedNode`. One-shot snapshots use `node.cache` after `awaitSettled`, or
+ * `firstValueFrom(node)`.
+ *
+ * **Audit logs.** Every imperative mutation (`upsert / remove / clear / link /
+ * unlink / rescore / reindex`) is wrapped via {@link lightMutation} and appends a
+ * typed record to a public `events` log on the bundle / graph.
+ *
+ * @module
+ */
+
+/**
+ * Exponential decay with floor: `score = max(minScore, baseScore * exp(-ratePerSecond * ageSeconds))`.
+ *
+ * Tolerant fallbacks (deliberate for use inside reactive derived fns):
+ * - non-finite `baseScore` → `minScore`
+ * - non-positive `ageSeconds` (incl. clock skew) → `max(minScore, baseScore)` (no decay)
+ * - non-positive `ratePerSecond` → `max(minScore, baseScore)` (no decay; rate=0 disables)
+ *
+ * Underflow boundary: `Math.exp(-745) === 0`. For very long ages × rates the
+ * result clamps to `minScore`; if you need slow decay over years, choose a
+ * smaller `ratePerSecond` rather than relying on graceful underflow.
+ *
+ * Half-life conversion: `ratePerSecond = Math.LN2 / halfLifeSeconds`.
+ *
+ * @category memory
+ */
+declare function decay(baseScore: number, ageSeconds: number, ratePerSecond: number, minScore?: number): number;
+/**
+ * Cosine similarity over `(a, b)`. When lengths differ, the shorter is
+ * implicitly zero-padded to the longer length. Returns `0` if either vector
+ * has zero norm. Public utility — used by {@link VectorIndexGraph.searchNode}
+ * and exposed for downstream consumers (e.g. `patterns/ai/memory/`) that need
+ * the same scoring at the boundary.
+ *
+ * **Numeric guards.** Returns `0` for non-finite results (overflow producing
+ * `Infinity`/`NaN` from very-large vectors, or `NaN` propagating from any
+ * `NaN`/`Infinity` component). Without this guard, downstream sort
+ * comparators would order NaN-scored rows arbitrarily.
+ *
+ * **Depth.** This is a per-call computation; no internal caching. For very
+ * large indexes (>10k) consider precomputing norms or using HNSW.
+ *
+ * @category memory
+ */
+declare function cosineSimilarity(a: readonly number[], b: readonly number[]): number;
+/** Public alias for the `Node | value` shape accepted by reactive read factories. */
+type NodeOrValue<T> = T | Node<T>;
+type LightCollectionEntry<T> = {
+    readonly id: string;
+    readonly value: T;
+    readonly createdAtNs: number;
+    readonly lastAccessNs: number;
+};
+type LightCollectionOptions = {
+    name?: string;
+    maxSize?: number;
+};
+interface LightCollectionAuditRecord extends BaseAuditRecord {
+    readonly action: "upsert" | "remove" | "clear";
+    readonly id?: string;
+}
+type LightCollectionBundle<T> = {
+    readonly entries: Node<ReadonlyMap<string, LightCollectionEntry<T>>>;
+    readonly events: ReactiveLogBundle<LightCollectionAuditRecord>;
+    upsert: (id: string, value: T) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    itemNode: (id: NodeOrValue<string>) => Node<LightCollectionEntry<T> | undefined>;
+    hasNode: (id: NodeOrValue<string>) => Node<boolean>;
+};
+/**
+ * Reactive Map of {@link LightCollectionEntry} with native LRU eviction by
+ * `maxSize`. Backed by `reactiveMap` so iteration order, snapshot delivery,
+ * and copy-on-write semantics match the rest of the data-structure tier.
+ *
+ * **No-Graph composition.** `bundle.entries` is a detached `state()` — mount
+ * manually with `parent.add(bundle.entries)` for `describe()` / `lens.flow`
+ * coverage.
+ *
+ * **`createdAtNs` preservation.** Re-upserting an existing id keeps the
+ * original `createdAtNs`; only `lastAccessNs` advances. Eviction is purely
+ * LRU-by-`lastAccessNs` (newest wins) via `reactiveMap`'s native `maxSize`.
+ *
+ * **No imperative reads.** Per the no-imperative-reads policy: subscribe to
+ * `entries` for the live snapshot, or use `itemNode(id)` / `hasNode(id)` for
+ * single-key reactive reads. For one-shot snapshots use `firstValueFrom` or
+ * `node.cache` after `awaitSettled`.
+ *
+ * **Audit log freeze contract.** Mutations are wrapped via `lightMutation`,
+ * which deep-freezes args at entry by default (per the Audit 2 framework).
+ * That means the `value` you pass to `upsert(id, value)` is frozen by the
+ * time it lands in `LightCollectionEntry.value`. If you store mutable
+ * payloads and need them mutable post-upsert, opt out via `lightMutation`'s
+ * `freeze: false` (currently internal — not exposed on the bundle; if you
+ * hit this, file in `docs/optimizations.md`).
+ *
+ * **Audit no-op records.** Mutations record an audit entry even when the
+ * impl was a no-op (`remove(id)` for a missing id, `clear()` on empty store).
+ * The framework records attempts, not state changes — this is intentional
+ * (see `_internal/imperative-audit.ts` rationale). Audit consumers that
+ * reconstruct state by replaying records can ignore no-op redundant entries
+ * without losing correctness.
+ *
+ * @category memory
+ */
+declare function lightCollection<T>(opts?: LightCollectionOptions): LightCollectionBundle<T>;
+type CollectionEntry<T> = LightCollectionEntry<T> & {
+    readonly baseScore: number;
+};
+type RankedCollectionEntry<T> = CollectionEntry<T> & {
+    readonly score: number;
+};
+type CollectionScoreFn<T> = (value: T) => number;
+type CollectionOptions<T> = {
+    maxSize?: number;
+    /**
+     * Produces a base score at insert/update time. Static fn or a reactive
+     * `Node<(value: T) => number>` — when supplied as a Node, `ranked` re-derives
+     * whenever the score fn changes, but `baseScore` on each entry is only
+     * recomputed via {@link CollectionGraph.rescore}. Default `() => 1`.
+     */
+    score?: CollectionScoreFn<T> | Node<CollectionScoreFn<T>>;
+    /**
+     * Exponential decay rate per second. `0` disables decay (default). When
+     * positive, `ranked` becomes fully reactive on time via a `fromTimer` source
+     * (cadence auto-derived from `decayRate` unless overridden via
+     * `refreshIntervalMs`). Half-life: `ratePerSecond = Math.LN2 / halfLifeSeconds`.
+     */
+    decayRate?: number;
+    /** Minimum score floor after decay. Default `0`. */
+    minScore?: number;
+    /**
+     * Override for the `ranked` refresh tick cadence (milliseconds). When
+     * unset and `decayRate > 0`, defaults to `1000 * Math.LN2 / (10 * decayRate)`
+     * — roughly one tick per 10% of the half-life (~10% staleness budget).
+     */
+    refreshIntervalMs?: number;
+};
+interface CollectionAuditRecord extends BaseAuditRecord {
+    readonly action: "upsert" | "remove" | "clear" | "rescore";
+    readonly id?: string;
+}
+type CollectionGraph<T> = Graph & {
+    readonly events: ReactiveLogBundle<CollectionAuditRecord>;
+    readonly items: Node<ReadonlyMap<string, CollectionEntry<T>>>;
+    readonly ranked: Node<readonly RankedCollectionEntry<T>[]>;
+    readonly size: Node<number>;
+    upsert: (id: string, value: T, opts?: {
+        score?: number;
+    }) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    /**
+     * Recompute every entry's `baseScore` via the latest score fn. O(N). Useful
+     * when a reactive `score` Node has emitted a new fn and the caller wants
+     * existing entries re-scored without an explicit re-upsert.
+     */
+    rescore: () => void;
+    itemNode: (id: NodeOrValue<string>) => Node<CollectionEntry<T> | undefined>;
+};
+/**
+ * Scored memory store with live decay-aware ranking.
+ *
+ * Topology (mounted on the returned graph):
+ *  - `items` — `reactiveMap<id, CollectionEntry<T>>` (with `retention` configured
+ *    for score-based eviction when `maxSize` is set).
+ *  - `ranked` — `Node<readonly RankedCollectionEntry<T>[]>`, sorted by live
+ *    decayed score. **Lazy** — does NOT compute until subscribed (no internal
+ *    keepalive). Use `keepalive(coll.ranked)` for eager activation.
+ *  - `size` — `Node<number>`, count of entries.
+ *  - `_refreshTick` — `fromTimer`-driven `monotonicNs()` source, mounted only
+ *    when `decayRate > 0`. Drives `ranked`'s time-dependent re-derivation.
+ *  - `_seq` — sequence cursor for the audit log.
+ *  - `events` — bounded reactive log of every mutation.
+ *
+ * **Time as a reactive dep.** When `decayRate > 0`, `ranked`'s deps are
+ * `[items, refreshTick]` — the tick payload IS `monotonicNs()`, so the fn is
+ * pure of deps and dry-run-reproducible with a mocked clock.
+ *
+ * **Lazy timer.** With no subscriber to `ranked`, the timer source does not
+ * fire — the activation chain is downstream-driven. To keep the timer warm
+ * without consuming results, register `graph.addDisposer(keepalive(coll.ranked))`.
+ *
+ * **Eviction at write-time.** Score-based retention runs on every successful
+ * `upsert / remove / clear` (it is mutation-driven, not tick-driven). The
+ * retention scorer reads `monotonicNs()` to compute decayed scores at eviction
+ * time — this is a deliberate impurity vs. `ReactiveMapRetention.score`'s
+ * "pure of `(key, value)`" docstring: write-time is the right moment to evict
+ * stale-by-decay entries.
+ *
+ * **No imperative reads.** Subscribe to `items` / `ranked` for live snapshots,
+ * or use `itemNode(id)` for single-key reactive reads.
+ *
+ * **`rescore` ordering caveat.** `rescore()` reads `items.entries.cache`
+ * (the post-emission snapshot) and writes via `setMany`. When called
+ * stand-alone it sees the latest committed state. When wrapped inside a
+ * user-level `batch(() => { coll.upsert(...); coll.rescore(); })`, the
+ * `cache` snapshot reflects state BEFORE the batch — so a just-staged
+ * upsert is invisible to the rescore scan. If you need rescore to include
+ * the staged upsert, either call `rescore()` after the batch settles or
+ * pass the new `baseScore` directly via `upsert(id, value, { score })`.
+ *
+ * **Audit no-op records.** Like `lightCollection`, mutations record audit
+ * entries even when the impl was a no-op (e.g., `rescore()` on an empty
+ * store). Intentional — the framework records attempts.
+ *
+ * @category memory
+ */
+declare function collection<T>(name: string, opts?: CollectionOptions<T>): CollectionGraph<T>;
+type VectorBackend = "flat" | "hnsw";
+type VectorRecord<TMeta> = {
+    readonly id: string;
+    readonly vector: readonly number[];
+    readonly meta?: TMeta;
+    /** Wall-clock-monotonic timestamp at last upsert; used for the default LRU retention. */
+    readonly upsertedAtNs: number;
+};
+type VectorSearchResult<TMeta> = {
+    readonly id: string;
+    readonly score: number;
+    readonly meta?: TMeta;
+};
+type HnswAdapter<TMeta> = {
+    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    search: (query: readonly number[], k: number) => ReadonlyArray<VectorSearchResult<TMeta>>;
+    /** Optional adapter teardown. Called from `graph.destroy()` via `addDisposer`. */
+    dispose?: () => void;
+};
+type VectorIndexOptions<TMeta> = {
+    name?: string;
+    backend?: VectorBackend;
+    dimension?: number;
+    /**
+     * Strict-dimension default. When `true` (default) AND `dimension` is unset,
+     * mixed-length upserts throw `RangeError`. Set `false` to opt into the
+     * lenient zero-padding behavior of {@link VectorIndexGraph.searchNode}.
+     */
+    strictDimension?: boolean;
+    /** Optional dependency seam for HNSW. */
+    hnswFactory?: () => HnswAdapter<TMeta>;
+    /** Maximum live entries (LRU-by-upsert-time when set; user-overridable via `retentionScore`). */
+    maxSize?: number;
+    /** Custom retention scorer. Higher score = kept. Defaults to `r => r.upsertedAtNs`. */
+    retentionScore?: (record: VectorRecord<TMeta>) => number;
+};
+interface VectorIndexAuditRecord extends BaseAuditRecord {
+    readonly action: "upsert" | "remove" | "clear" | "reindex" | "evict";
+    readonly id?: string;
+}
+type VectorIndexGraph<TMeta> = Graph & {
+    readonly backend: VectorBackend;
+    readonly events: ReactiveLogBundle<VectorIndexAuditRecord>;
+    readonly entries: Node<ReadonlyMap<string, VectorRecord<TMeta>>>;
+    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    /** Re-push every live entry into the optional HNSW adapter. No-op for `flat`. */
+    reindex: () => void;
+    /**
+     * Reactive top-K search. Re-derives whenever entries / query / k change.
+     * Lazy. Use `firstValueFrom(searchNode(...))` for one-shot reads.
+     */
+    searchNode: (query: Node<readonly number[]>, k?: NodeOrValue<number>) => Node<readonly VectorSearchResult<TMeta>[]>;
+};
+/**
+ * Reactive vector store with optional HNSW backend.
+ *
+ * **Storage on `reactiveMap`.** `entries` is a `reactiveMap<id, VectorRecord<TMeta>>`
+ * with optional score-based retention (`maxSize` + LRU-by-`upsertedAtNs` by
+ * default; user can supply a custom `retentionScore`). On retention eviction,
+ * the HNSW adapter (if configured) is also notified via `adapter.remove(id)`.
+ *
+ * **Reactive search.** `searchNode(queryNode, k)` returns a `Node<readonly
+ * VectorSearchResult<TMeta>[]>` that re-derives on entries / query / k change.
+ * Lazy — only computes when subscribed. Imperative `search()` is intentionally
+ * not exposed (no-imperative-reads policy). Use `firstValueFrom(searchNode(...))`
+ * for one-shot reads.
+ *
+ * **Strict dimension.** Default `strictDimension: true` — if `dimension` is
+ * unset and an upsert produces a vector of a different length than the first
+ * upserted, throws `RangeError`. Pass `strictDimension: false` to opt into
+ * the lenient zero-padding fallback (the previous default).
+ *
+ * **Adapter lifecycle.** When the HNSW adapter exposes a `dispose()` method,
+ * it is bound to the graph's teardown via `addDisposer`. When retention
+ * evicts an entry, `adapter.remove(id)` is invoked synchronously inside the
+ * retention `onArchive` callback.
+ *
+ * **Cosine zero-pad.** The flat backend uses cosine similarity over the
+ * pairwise max-length zero-pad. Mixing dimensions silently degrades scores
+ * unless strict mode catches it at upsert time. For embedding-model vectors,
+ * L2-normalize at the source — `vectorIndex` does not normalize.
+ *
+ * @category memory
+ */
+declare function vectorIndex<TMeta>(opts?: VectorIndexOptions<TMeta>): VectorIndexGraph<TMeta>;
+type KnowledgeEdge<TRelation extends string = string> = {
+    readonly from: string;
+    readonly to: string;
+    readonly relation: TRelation;
+    readonly weight: number;
+};
+type KnowledgeGraphOptions = {
+    /** Cap on entity count (LRU-by-upsert-time when set). */
+    entitiesMaxSize?: number;
+    /** Cap on edge count (LRU-by-upsert-time when set). */
+    edgesMaxSize?: number;
+    /**
+     * Orphan-entity garbage collection. `"keep"` (default) leaves entities
+     * untouched when their last edge is unlinked; `"remove"` deletes the
+     * entity post-`unlink` if no edges reference it.
+     */
+    orphanGC?: "keep" | "remove";
+};
+interface KnowledgeGraphAuditRecord extends BaseAuditRecord {
+    readonly action: "upsertEntity" | "removeEntity" | "link" | "unlink" | "orphanRemove";
+    readonly id?: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly relation?: string;
+    /** Edge weight at the time of the `link`. Omitted for non-edge actions. */
+    readonly weight?: number;
+}
+type KnowledgeGraph<TEntity, TRelation extends string = string> = Graph & {
+    readonly events: ReactiveLogBundle<KnowledgeGraphAuditRecord>;
+    readonly entities: Node<ReadonlyMap<string, TEntity>>;
+    readonly edges: Node<ReadonlyMap<string, KnowledgeEdge<TRelation>>>;
+    readonly adjacencyOut: Node<ReadonlyMap<string, readonly KnowledgeEdge<TRelation>[]>>;
+    readonly adjacencyIn: Node<ReadonlyMap<string, readonly KnowledgeEdge<TRelation>[]>>;
+    readonly entityCount: Node<number>;
+    readonly edgeCount: Node<number>;
+    upsertEntity: (id: string, value: TEntity) => void;
+    removeEntity: (id: string) => void;
+    link: (from: string, to: string, relation: TRelation, weight?: number) => void;
+    unlink: (from: string, to: string, relation?: TRelation) => void;
+    relatedNode: (id: NodeOrValue<string>, relation?: NodeOrValue<TRelation>) => Node<readonly KnowledgeEdge<TRelation>[]>;
+};
+/**
+ * Reactive knowledge graph: entities + typed edges + symmetric adjacency.
+ *
+ * Topology (mounted on the returned graph):
+ *  - `entities` — `reactiveMap<id, TEntity>` (optional `entitiesMaxSize` LRU).
+ *  - `edges` — `reactiveMap<tripleKey, KnowledgeEdge<TRelation>>` keyed by
+ *    `${from}${to}${relation}` (optional `edgesMaxSize` LRU).
+ *    Entity IDs / relations must NOT contain ``.
+ *  - `adjacencyOut` — `Node<ReadonlyMap<from, readonly edge[]>>`. **Full O(E)
+ *    rebuild on every `link` / `unlink` mutation.** (Prior JSDoc claim of
+ *    "O(E) build" referred to a single rebuild — the per-mutation cost is
+ *    O(E), not O(1) amortized. For very large graphs with frequent edge
+ *    churn, consider batching via `reactiveMap.setMany`.)
+ *  - `adjacencyIn` — `Node<ReadonlyMap<to, readonly edge[]>>`. Same O(E) per
+ *    mutation rebuild characteristic.
+ *  - `entityCount` / `edgeCount` — observability deriveds.
+ *  - `events` — bounded reactive audit log.
+ *
+ * **`link()` semantics.** Calling `link(a, b, rel, w)` twice with different
+ * weights replaces the weight on the existing edge (keyed by the triple).
+ * `unlink` then `link` re-creates the edge (and bumps `lastUpsertNs` for
+ * retention purposes).
+ *
+ * **Edge weight convention.** Higher weight = stronger relation. Default `1`.
+ *
+ * **Orphan GC.** `orphanGC: "remove"` deletes an entity from `entities` after
+ * an `unlink` that empties its adjacency on both sides. Default `"keep"`.
+ *
+ * **No imperative reads.** Use `relatedNode(id, relation?)` for reactive reads.
+ *
+ * @category memory
+ */
+declare function knowledgeGraph<TEntity, TRelation extends string = string>(name: string, opts?: KnowledgeGraphOptions): KnowledgeGraph<TEntity, TRelation>;
+
+type index_CollectionAuditRecord = CollectionAuditRecord;
+type index_CollectionEntry<T> = CollectionEntry<T>;
+type index_CollectionGraph<T> = CollectionGraph<T>;
+type index_CollectionOptions<T> = CollectionOptions<T>;
+type index_CollectionScoreFn<T> = CollectionScoreFn<T>;
+type index_HnswAdapter<TMeta> = HnswAdapter<TMeta>;
+type index_KnowledgeEdge<TRelation extends string = string> = KnowledgeEdge<TRelation>;
+type index_KnowledgeGraph<TEntity, TRelation extends string = string> = KnowledgeGraph<TEntity, TRelation>;
+type index_KnowledgeGraphAuditRecord = KnowledgeGraphAuditRecord;
+type index_KnowledgeGraphOptions = KnowledgeGraphOptions;
+type index_LightCollectionAuditRecord = LightCollectionAuditRecord;
+type index_LightCollectionBundle<T> = LightCollectionBundle<T>;
+type index_LightCollectionEntry<T> = LightCollectionEntry<T>;
+type index_LightCollectionOptions = LightCollectionOptions;
+type index_NodeOrValue<T> = NodeOrValue<T>;
+type index_RankedCollectionEntry<T> = RankedCollectionEntry<T>;
+type index_VectorBackend = VectorBackend;
+type index_VectorIndexAuditRecord = VectorIndexAuditRecord;
+type index_VectorIndexGraph<TMeta> = VectorIndexGraph<TMeta>;
+type index_VectorIndexOptions<TMeta> = VectorIndexOptions<TMeta>;
+type index_VectorRecord<TMeta> = VectorRecord<TMeta>;
+type index_VectorSearchResult<TMeta> = VectorSearchResult<TMeta>;
+declare const index_collection: typeof collection;
+declare const index_cosineSimilarity: typeof cosineSimilarity;
+declare const index_decay: typeof decay;
+declare const index_knowledgeGraph: typeof knowledgeGraph;
+declare const index_lightCollection: typeof lightCollection;
+declare const index_vectorIndex: typeof vectorIndex;
+declare namespace index {
+  export { type index_CollectionAuditRecord as CollectionAuditRecord, type index_CollectionEntry as CollectionEntry, type index_CollectionGraph as CollectionGraph, type index_CollectionOptions as CollectionOptions, type index_CollectionScoreFn as CollectionScoreFn, type index_HnswAdapter as HnswAdapter, type index_KnowledgeEdge as KnowledgeEdge, type index_KnowledgeGraph as KnowledgeGraph, type index_KnowledgeGraphAuditRecord as KnowledgeGraphAuditRecord, type index_KnowledgeGraphOptions as KnowledgeGraphOptions, type index_LightCollectionAuditRecord as LightCollectionAuditRecord, type index_LightCollectionBundle as LightCollectionBundle, type index_LightCollectionEntry as LightCollectionEntry, type index_LightCollectionOptions as LightCollectionOptions, type index_NodeOrValue as NodeOrValue, type index_RankedCollectionEntry as RankedCollectionEntry, type index_VectorBackend as VectorBackend, type index_VectorIndexAuditRecord as VectorIndexAuditRecord, type index_VectorIndexGraph as VectorIndexGraph, type index_VectorIndexOptions as VectorIndexOptions, type index_VectorRecord as VectorRecord, type index_VectorSearchResult as VectorSearchResult, index_collection as collection, index_cosineSimilarity as cosineSimilarity, index_decay as decay, index_knowledgeGraph as knowledgeGraph, index_lightCollection as lightCollection, index_vectorIndex as vectorIndex };
+}
+
+export { type CollectionAuditRecord as C, type HnswAdapter as H, type KnowledgeGraph as K, type LightCollectionBundle as L, type NodeOrValue as N, type RankedCollectionEntry as R, type VectorSearchResult as V, type VectorIndexGraph as a, type CollectionEntry as b, type CollectionGraph as c, type CollectionOptions as d, type CollectionScoreFn as e, type KnowledgeEdge as f, type KnowledgeGraphAuditRecord as g, type KnowledgeGraphOptions as h, index as i, type LightCollectionAuditRecord as j, type LightCollectionEntry as k, type LightCollectionOptions as l, type VectorBackend as m, type VectorIndexAuditRecord as n, type VectorIndexOptions as o, type VectorRecord as p, collection as q, cosineSimilarity as r, decay as s, knowledgeGraph as t, lightCollection as u, vectorIndex as v };

package/dist/{index-C-pFD_FV.d.ts → index-BwOsJfLJ.d.ts}

@@ -1,6 +1,6 @@
-import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-BDdngW56.js';
+import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-D-tRiNhg.js';
 import { a as Node } from './node-fSc-hCv8.js';
-import { G as Graph } from './graph-YQXDndFy.js';
+import { G as Graph } from './graph-BjW1taJl.js';
 
 /**
  * MeasurementAdapter implementations (roadmap §7.1 — pluggable backends).

package/dist/{index-CRycrNfn.d.ts → index-Byp771zP.d.ts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-fSc-hCv8.js';
-import { a as GraphOptions, G as Graph } from './graph-YQXDndFy.js';
+import { a as GraphOptions, G as Graph } from './graph-BjW1taJl.js';
 
 /**
  * Domain templates (roadmap §8.2).

package/dist/{index-e1m3ZHgc.d.cts → index-C-3UXnHT.d.cts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-fSc-hCv8.cjs';
-import { a as GraphOptions, G as Graph } from './graph-CaNXUc3c.cjs';
+import { a as GraphOptions, G as Graph } from './graph-CHsVwf9S.cjs';
 
 /**
  * Domain templates (roadmap §8.2).

package/dist/{index-DTYIRT_v.d.cts → index-C56XZiDe.d.cts}

@@ -1,7 +1,7 @@
 import { a as Node } from './node-fSc-hCv8.cjs';
 import { R as ReactiveMapBundle } from './reactive-map-DmgeADH8.cjs';
-import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-CaNXUc3c.cjs';
-import { w as watchTopologyTree } from './topology-tree-BkhmMg2a.cjs';
+import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-CHsVwf9S.cjs';
+import { w as watchTopologyTree } from './topology-tree-jrZue3ao.cjs';
 
 /** Aggregate topology stats emitted by {@link LensGraph.stats}. */
 interface TopologyStats {

package/dist/{index-D11pGlaI.d.cts → index-CAV-3RpJ.d.cts}

@@ -1,9 +1,9 @@
 import { T as ToObservableOptions, t as toObservable } from './observable-Cqty11jG.cjs';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, b as GraphPersistSnapshot } from './graph-CaNXUc3c.cjs';
+import { G as Graph, b as GraphPersistSnapshot } from './graph-CHsVwf9S.cjs';
 import { A as Actor } from './node-fSc-hCv8.cjs';
-import { c as CqrsOptions, b as CqrsGraph, a as CqrsEvent } from './index-BECJ8M0T.cjs';
+import { c as CqrsOptions, b as CqrsGraph, a as CqrsEvent } from './index-BqcgiSQg.cjs';
 import { AppendLogStorageTier } from './extra/storage-tiers.cjs';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */

package/dist/{index-D_DThl_J.d.cts → index-CAbHN_rP.d.cts}

@@ -1,4 +1,4 @@
-import { G as Graph } from './graph-CaNXUc3c.cjs';
+import { G as Graph } from './graph-CHsVwf9S.cjs';
 
 /** Zustand-compatible Store API. */
 interface StoreApi<T> {

package/dist/{index-BhLA9feT.d.ts → index-CEVzBWeB.d.ts}

@@ -1,8 +1,8 @@
-import { R as ReactiveLogBundle } from './reactive-log-jirQsxMY.js';
+import { R as ReactiveLogBundle } from './reactive-log-BgWSA1fg.js';
 import { NodeInput } from './extra/sources.js';
 import { AppendLogStorageTier } from './extra/storage-tiers.js';
 import { B as BaseAuditRecord } from './imperative-audit-ahAE65a9.js';
-import { C as CqrsEventMap, a as CqrsEvent, b as CqrsGraph } from './index-DuhOdNyg.js';
+import { C as CqrsEventMap, a as CqrsEvent, b as CqrsGraph } from './index-BFaALJxR.js';
 
 /**
  * Process Manager pattern (Phase 7 — roadmap §4.6, Audit 3 — locked 2026-04-24).

package/dist/{index-Ci358GSC.d.cts → index-CM-i58FY.d.cts}

@@ -1,12 +1,12 @@
 import { i as index$2 } from './index-D_QQ_dTD.cjs';
 import { i as index$3 } from './index-B3D_z0Z6.cjs';
-import { i as index$4 } from './index-D11pGlaI.cjs';
+import { i as index$4 } from './index-CAV-3RpJ.cjs';
 import { i as index$5 } from './index-BFuVcqL8.cjs';
 import { a as Node } from './node-fSc-hCv8.cjs';
 import { i as index$6 } from './index-9xhIaM-w.cjs';
 import { i as index$7 } from './index-CpZKtdMw.cjs';
 import { i as index$8 } from './index-CqSJ25A9.cjs';
-import { i as index$9 } from './index-D_DThl_J.cjs';
+import { i as index$9 } from './index-CAbHN_rP.cjs';
 
 /**
  * Options for creating signals.

package/dist/{index-B9qJmmv3.d.cts → index-CQsqqEVz.d.cts}

@@ -1,4 +1,4 @@
-import { C as CatchOptions, a as ClassifyResult, D as Decision, b as DecisionAction, G as GateController, c as GateOptions, P as PipelineGraph, S as StepRef, T as TerminalCause, d as decisionKeyOf, p as pipelineGraph } from './pipeline-graph-BrrYGjuZ.cjs';
+import { C as CatchOptions, a as ClassifyResult, D as Decision, b as DecisionAction, G as GateController, c as GateOptions, P as PipelineGraph, S as StepRef, T as TerminalCause, d as decisionKeyOf, p as pipelineGraph } from './pipeline-graph-DuHpXSOn.cjs';
 
 /**
  * Orchestration patterns (roadmap §4.1).

package/dist/{index-C0tga1_x.d.ts → index-CijfwEWx.d.ts}

@@ -1,5 +1,5 @@
-import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-D1E1tqHT.js';
-import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-YQXDndFy.js';
+import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-DTDVDzhA.js';
+import { G as Graph, q as GraphNodeFactory, o as GraphDiffResult } from './graph-BjW1taJl.js';
 import { KvStorageTier } from './extra/storage-tiers.js';
 
 /**

package/dist/{index-BwtIbzSV.d.cts → index-Ckil6miL.d.cts}

@@ -1,5 +1,5 @@
-import { G as Graph } from './graph-CaNXUc3c.cjs';
-import { M as MeasurementAdapter } from './reactive-layout-DrGjuwyC.cjs';
+import { G as Graph } from './graph-CHsVwf9S.cjs';
+import { M as MeasurementAdapter } from './reactive-layout-BMLDB4Vd.cjs';
 
 /**
  * Three-pane demo shell (roadmap §7.2).

package/dist/{index-BokynmA4.d.cts → index-CpdnP-0y.d.cts}

@@ -1,5 +1,5 @@
 import { a as Node, N as NodeOptions } from './node-fSc-hCv8.cjs';
-import { a as GraphOptions, G as Graph } from './graph-CaNXUc3c.cjs';
+import { a as GraphOptions, G as Graph } from './graph-CHsVwf9S.cjs';
 
 /**
  * Reduction primitives (roadmap §8.1).