ruvector 0.2.30 → 0.2.31

package/dist/core/embedding-provenance.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Embedding provenance — ADR-210 D0 cross-cutting invariant.
+ *
+ * Every persisted vector store written through the embedding path records
+ * `{ embedderKind, modelId, dimension, normalize, prefixPolicy }`. Inserts
+ * whose provenance does not match the store's recorded provenance are
+ * REFUSED (clear error naming both sides), never coerced. Stores that
+ * predate provenance metadata are treated as legacy hash stores and open
+ * read-only for vector writes until re-embedded (`ruvector hooks reembed`).
+ *
+ * This module is the single source of truth for:
+ *   - the provenance record type + compare/refuse logic (D0),
+ *   - legacy-default derivation for pre-ADR-210 stores (D0),
+ *   - per-model query/passage prefix policies (D4),
+ *   - rollout flag resolution: RUVECTOR_EMBEDDER / RUVECTOR_ONNX /
+ *     RUVECTOR_REEMBED (D5),
+ *   - the once-per-process loud hash-fallback warning (D1).
+ */
+export type PrefixPolicy = 'none' | 'required' | 'query-recommended';
+export type EmbedTextKind = 'query' | 'passage';
+/** Embedder identity classes. `modelId` carries the exact model. */
+export type EmbedderKind = 'onnx-minilm' | 'onnx' | 'hash';
+export interface EmbeddingProvenance {
+    /** Embedder family that produced the vectors. */
+    embedderKind: EmbedderKind | string;
+    /** Exact model id (e.g. 'all-MiniLM-L6-v2'); null for the hash embedder. */
+    modelId: string | null;
+    /** Vector dimension. */
+    dimension: number;
+    /** Whether vectors were L2-normalized at embed time. */
+    normalize: boolean;
+    /** Prefix convention the texts were embedded under (D4). */
+    prefixPolicy: PrefixPolicy;
+}
+export type EmbedderSelection = 'auto' | 'minilm' | 'hash';
+export type ReembedPolicy = 'refuse' | 'warn' | 'auto';
+export interface ModelPrefixSpec {
+    prefixPolicy: PrefixPolicy;
+    queryPrefix: string;
+    passagePrefix: string;
+}
+/** BGE en v1.5 documented query instruction (short query → long passage). */
+export declare const BGE_QUERY_INSTRUCTION = "Represent this sentence for searching relevant passages: ";
+/**
+ * Prefix conventions per model card:
+ * - all-MiniLM-L6-v2 / L12: general semantic search, NO prefixes.
+ * - e5-small-v2: REQUIRES 'query: ' / 'passage: ' (quality degrades without).
+ * - bge-small/base-en-v1.5: query instruction recommended for retrieval;
+ *   passages need no instruction.
+ * - gte-small: no prefixes documented.
+ */
+export declare const MODEL_PREFIXES: Record<string, ModelPrefixSpec>;
+/**
+ * Prefix spec for a model; unknown models get the no-prefix policy.
+ * Own-property lookup only: a hostile model id like '__proto__' or
+ * 'constructor' must resolve to NO_PREFIX, not to a prototype member
+ * (ADR-210 security pass).
+ */
+export declare function getModelPrefixSpec(modelId: string | null | undefined): ModelPrefixSpec;
+/**
+ * Pure prefix application (D4): the exact text handed to the tokenizer for a
+ * query/passage embed of `text` under `modelId`'s registered policy.
+ * MiniLM applies NO prefix on either entry point (acceptance gates 6–7).
+ */
+export declare function prefixText(modelId: string | null | undefined, kind: EmbedTextKind, text: string): string;
+/** Embedder family for an ONNX model id. */
+export declare function embedderKindForModel(modelId: string | null | undefined): EmbedderKind;
+/**
+ * Legacy default for stores that predate provenance metadata: hash-embedded,
+ * un-normalized as far as we can prove, no prefixes. Such stores open
+ * READ-ONLY for vector writes until re-embedded.
+ */
+export declare function legacyHashProvenance(dimension?: number): EmbeddingProvenance;
+/** Human-readable one-liner for error messages. */
+export declare function describeProvenance(p: EmbeddingProvenance): string;
+/** Field names on which two provenance records disagree (empty = match). */
+export declare function compareProvenance(a: EmbeddingProvenance, b: EmbeddingProvenance): string[];
+/** Upper bound accepted for a provenance dimension read from disk. */
+export declare const MAX_PROVENANCE_DIMENSION = 65536;
+/**
+ * Sanitize a provenance record read from DISK (a `.meta.json` sidecar or
+ * `intelligence.json`). On-disk JSON is untrusted input: a malformed or
+ * adversarial record must never crash the caller. Anything that is not a
+ * plausibly-valid record is treated as ABSENT (returns null), which callers
+ * already handle as the no-provenance / legacy path — conservative for a
+ * corrupted stamp (the store degrades to read-only for vector writes rather
+ * than accepting writes under a fabricated identity).
+ */
+export declare function sanitizeProvenance(value: unknown): EmbeddingProvenance | null;
+/** Thrown when an insert's provenance does not match the store's (D0). */
+export declare class ProvenanceMismatchError extends Error {
+    code: string;
+    store: EmbeddingProvenance;
+    active: EmbeddingProvenance;
+    mismatches: string[];
+    constructor(store: EmbeddingProvenance, active: EmbeddingProvenance, mismatches: string[], storeName: string);
+}
+/** Refuse mismatched inserts with an error naming both sides (D0). */
+export declare function assertProvenanceMatch(store: EmbeddingProvenance, active: EmbeddingProvenance, storeName?: string): void;
+/**
+ * Resolve RUVECTOR_EMBEDDER / RUVECTOR_ONNX.
+ * Precedence: RUVECTOR_EMBEDDER wins when both are set; RUVECTOR_ONNX=0 is
+ * shorthand for `hash`, =1 for `minilm`. Unrecognized values fall back to
+ * 'auto' (MiniLM when loadable, loud hash fallback otherwise).
+ */
+export declare function resolveEmbedderSelection(env?: NodeJS.ProcessEnv): EmbedderSelection;
+/**
+ * Resolve RUVECTOR_REEMBED: what happens when opening a store whose
+ * provenance mismatches the active embedder.
+ *   refuse (default) — error;
+ *   warn             — open read-only with a single warning;
+ *   auto             — re-embed in place when source text exists, refuse otherwise.
+ */
+export declare function resolveReembedPolicy(env?: NodeJS.ProcessEnv): ReembedPolicy;
+/**
+ * Emit exactly ONE stderr warning per process the first time the hash
+ * fallback serves an embed that the ONNX embedder was supposed to handle
+ * (acceptance gate 2). Returns true when the warning was emitted by this call.
+ */
+export declare function warnHashFallbackOnce(reason?: string): boolean;
+/** Whether the once-per-process fallback warning has fired. */
+export declare function hashFallbackWarned(): boolean;
+/** Test hook: reset the once-per-process warning latch. */
+export declare function resetHashFallbackWarningForTests(): void;
+declare const _default: {
+    MODEL_PREFIXES: Record<string, ModelPrefixSpec>;
+    BGE_QUERY_INSTRUCTION: string;
+    getModelPrefixSpec: typeof getModelPrefixSpec;
+    prefixText: typeof prefixText;
+    embedderKindForModel: typeof embedderKindForModel;
+    legacyHashProvenance: typeof legacyHashProvenance;
+    describeProvenance: typeof describeProvenance;
+    compareProvenance: typeof compareProvenance;
+    sanitizeProvenance: typeof sanitizeProvenance;
+    MAX_PROVENANCE_DIMENSION: number;
+    ProvenanceMismatchError: typeof ProvenanceMismatchError;
+    assertProvenanceMatch: typeof assertProvenanceMatch;
+    resolveEmbedderSelection: typeof resolveEmbedderSelection;
+    resolveReembedPolicy: typeof resolveReembedPolicy;
+    warnHashFallbackOnce: typeof warnHashFallbackOnce;
+    hashFallbackWarned: typeof hashFallbackWarned;
+    resetHashFallbackWarningForTests: typeof resetHashFallbackWarningForTests;
+};
+export default _default;
+//# sourceMappingURL=embedding-provenance.d.ts.map

package/dist/core/embedding-provenance.d.ts.map

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

package/dist/core/embedding-provenance.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Embedding provenance — ADR-210 D0 cross-cutting invariant.
+ *
+ * Every persisted vector store written through the embedding path records
+ * `{ embedderKind, modelId, dimension, normalize, prefixPolicy }`. Inserts
+ * whose provenance does not match the store's recorded provenance are
+ * REFUSED (clear error naming both sides), never coerced. Stores that
+ * predate provenance metadata are treated as legacy hash stores and open
+ * read-only for vector writes until re-embedded (`ruvector hooks reembed`).
+ *
+ * This module is the single source of truth for:
+ *   - the provenance record type + compare/refuse logic (D0),
+ *   - legacy-default derivation for pre-ADR-210 stores (D0),
+ *   - per-model query/passage prefix policies (D4),
+ *   - rollout flag resolution: RUVECTOR_EMBEDDER / RUVECTOR_ONNX /
+ *     RUVECTOR_REEMBED (D5),
+ *   - the once-per-process loud hash-fallback warning (D1).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProvenanceMismatchError = exports.MAX_PROVENANCE_DIMENSION = exports.MODEL_PREFIXES = exports.BGE_QUERY_INSTRUCTION = void 0;
+exports.getModelPrefixSpec = getModelPrefixSpec;
+exports.prefixText = prefixText;
+exports.embedderKindForModel = embedderKindForModel;
+exports.legacyHashProvenance = legacyHashProvenance;
+exports.describeProvenance = describeProvenance;
+exports.compareProvenance = compareProvenance;
+exports.sanitizeProvenance = sanitizeProvenance;
+exports.assertProvenanceMatch = assertProvenanceMatch;
+exports.resolveEmbedderSelection = resolveEmbedderSelection;
+exports.resolveReembedPolicy = resolveReembedPolicy;
+exports.warnHashFallbackOnce = warnHashFallbackOnce;
+exports.hashFallbackWarned = hashFallbackWarned;
+exports.resetHashFallbackWarningForTests = resetHashFallbackWarningForTests;
+const NO_PREFIX = { prefixPolicy: 'none', queryPrefix: '', passagePrefix: '' };
+/** BGE en v1.5 documented query instruction (short query → long passage). */
+exports.BGE_QUERY_INSTRUCTION = 'Represent this sentence for searching relevant passages: ';
+/**
+ * Prefix conventions per model card:
+ * - all-MiniLM-L6-v2 / L12: general semantic search, NO prefixes.
+ * - e5-small-v2: REQUIRES 'query: ' / 'passage: ' (quality degrades without).
+ * - bge-small/base-en-v1.5: query instruction recommended for retrieval;
+ *   passages need no instruction.
+ * - gte-small: no prefixes documented.
+ */
+exports.MODEL_PREFIXES = {
+    'all-MiniLM-L6-v2': { ...NO_PREFIX },
+    'all-MiniLM-L12-v2': { ...NO_PREFIX },
+    'e5-small-v2': { prefixPolicy: 'required', queryPrefix: 'query: ', passagePrefix: 'passage: ' },
+    'bge-small-en-v1.5': { prefixPolicy: 'query-recommended', queryPrefix: exports.BGE_QUERY_INSTRUCTION, passagePrefix: '' },
+    'bge-base-en-v1.5': { prefixPolicy: 'query-recommended', queryPrefix: exports.BGE_QUERY_INSTRUCTION, passagePrefix: '' },
+    'gte-small': { ...NO_PREFIX },
+};
+/**
+ * Prefix spec for a model; unknown models get the no-prefix policy.
+ * Own-property lookup only: a hostile model id like '__proto__' or
+ * 'constructor' must resolve to NO_PREFIX, not to a prototype member
+ * (ADR-210 security pass).
+ */
+function getModelPrefixSpec(modelId) {
+    if (modelId && Object.prototype.hasOwnProperty.call(exports.MODEL_PREFIXES, modelId)) {
+        return exports.MODEL_PREFIXES[modelId];
+    }
+    return NO_PREFIX;
+}
+/**
+ * Pure prefix application (D4): the exact text handed to the tokenizer for a
+ * query/passage embed of `text` under `modelId`'s registered policy.
+ * MiniLM applies NO prefix on either entry point (acceptance gates 6–7).
+ */
+function prefixText(modelId, kind, text) {
+    const spec = getModelPrefixSpec(modelId);
+    const prefix = kind === 'query' ? spec.queryPrefix : spec.passagePrefix;
+    return prefix ? prefix + text : text;
+}
+/** Embedder family for an ONNX model id. */
+function embedderKindForModel(modelId) {
+    return modelId && modelId.startsWith('all-MiniLM') ? 'onnx-minilm' : 'onnx';
+}
+// ============================================================================
+// D0 — provenance compare / refuse / legacy derivation
+// ============================================================================
+/**
+ * Legacy default for stores that predate provenance metadata: hash-embedded,
+ * un-normalized as far as we can prove, no prefixes. Such stores open
+ * READ-ONLY for vector writes until re-embedded.
+ */
+function legacyHashProvenance(dimension = 256) {
+    return { embedderKind: 'hash', modelId: null, dimension, normalize: false, prefixPolicy: 'none' };
+}
+/** Human-readable one-liner for error messages. */
+function describeProvenance(p) {
+    const model = p.modelId ? `, model=${p.modelId}` : '';
+    return `{ embedder=${p.embedderKind}${model}, dim=${p.dimension}, normalize=${p.normalize}, prefixPolicy=${p.prefixPolicy} }`;
+}
+/** Field names on which two provenance records disagree (empty = match). */
+function compareProvenance(a, b) {
+    const mismatches = [];
+    if (a.embedderKind !== b.embedderKind)
+        mismatches.push('embedderKind');
+    if ((a.modelId ?? null) !== (b.modelId ?? null))
+        mismatches.push('modelId');
+    if (a.dimension !== b.dimension)
+        mismatches.push('dimension');
+    if (!!a.normalize !== !!b.normalize)
+        mismatches.push('normalize');
+    if (a.prefixPolicy !== b.prefixPolicy)
+        mismatches.push('prefixPolicy');
+    return mismatches;
+}
+/** Upper bound accepted for a provenance dimension read from disk. */
+exports.MAX_PROVENANCE_DIMENSION = 65536;
+const VALID_PREFIX_POLICIES = ['none', 'required', 'query-recommended'];
+/**
+ * Sanitize a provenance record read from DISK (a `.meta.json` sidecar or
+ * `intelligence.json`). On-disk JSON is untrusted input: a malformed or
+ * adversarial record must never crash the caller. Anything that is not a
+ * plausibly-valid record is treated as ABSENT (returns null), which callers
+ * already handle as the no-provenance / legacy path — conservative for a
+ * corrupted stamp (the store degrades to read-only for vector writes rather
+ * than accepting writes under a fabricated identity).
+ */
+function sanitizeProvenance(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return null;
+    const v = value;
+    const embedderKind = v.embedderKind;
+    if (typeof embedderKind !== 'string' || embedderKind.length === 0 || embedderKind.length > 64) {
+        return null;
+    }
+    const dimension = v.dimension;
+    if (typeof dimension !== 'number' ||
+        !Number.isInteger(dimension) ||
+        dimension < 1 ||
+        dimension > exports.MAX_PROVENANCE_DIMENSION) {
+        return null;
+    }
+    let modelId = null;
+    if (typeof v.modelId === 'string') {
+        if (v.modelId.length === 0 || v.modelId.length > 256)
+            return null;
+        modelId = v.modelId;
+    }
+    else if (v.modelId !== null && v.modelId !== undefined) {
+        return null;
+    }
+    let prefixPolicy = 'none';
+    if (v.prefixPolicy !== undefined) {
+        if (typeof v.prefixPolicy !== 'string' || !VALID_PREFIX_POLICIES.includes(v.prefixPolicy)) {
+            return null;
+        }
+        prefixPolicy = v.prefixPolicy;
+    }
+    return { embedderKind, modelId, dimension, normalize: !!v.normalize, prefixPolicy };
+}
+/** Thrown when an insert's provenance does not match the store's (D0). */
+class ProvenanceMismatchError extends Error {
+    constructor(store, active, mismatches, storeName) {
+        super(`Embedding-provenance mismatch (ADR-210): refusing vector write to ${storeName}. ` +
+            `Store records ${describeProvenance(store)} but the active embedder is ` +
+            `${describeProvenance(active)} (differs on: ${mismatches.join(', ')}). ` +
+            `Mixed stores are never created — re-embed the store ('ruvector hooks reembed') ` +
+            `or switch the active embedder (RUVECTOR_EMBEDDER=auto|minilm|hash).`);
+        this.code = 'ERR_EMBEDDING_PROVENANCE';
+        this.name = 'ProvenanceMismatchError';
+        this.store = store;
+        this.active = active;
+        this.mismatches = mismatches;
+    }
+}
+exports.ProvenanceMismatchError = ProvenanceMismatchError;
+/** Refuse mismatched inserts with an error naming both sides (D0). */
+function assertProvenanceMatch(store, active, storeName = 'vector store') {
+    const mismatches = compareProvenance(store, active);
+    if (mismatches.length > 0) {
+        throw new ProvenanceMismatchError(store, active, mismatches, storeName);
+    }
+}
+// ============================================================================
+// D5 — rollout flags (env overrides config)
+// ============================================================================
+/**
+ * Resolve RUVECTOR_EMBEDDER / RUVECTOR_ONNX.
+ * Precedence: RUVECTOR_EMBEDDER wins when both are set; RUVECTOR_ONNX=0 is
+ * shorthand for `hash`, =1 for `minilm`. Unrecognized values fall back to
+ * 'auto' (MiniLM when loadable, loud hash fallback otherwise).
+ */
+function resolveEmbedderSelection(env = process.env) {
+    const embedder = (env.RUVECTOR_EMBEDDER || '').trim().toLowerCase();
+    if (embedder === 'auto' || embedder === 'minilm' || embedder === 'hash')
+        return embedder;
+    const onnx = (env.RUVECTOR_ONNX || '').trim();
+    if (onnx === '0')
+        return 'hash';
+    if (onnx === '1')
+        return 'minilm';
+    return 'auto';
+}
+/**
+ * Resolve RUVECTOR_REEMBED: what happens when opening a store whose
+ * provenance mismatches the active embedder.
+ *   refuse (default) — error;
+ *   warn             — open read-only with a single warning;
+ *   auto             — re-embed in place when source text exists, refuse otherwise.
+ */
+function resolveReembedPolicy(env = process.env) {
+    const v = (env.RUVECTOR_REEMBED || '').trim().toLowerCase();
+    if (v === 'refuse' || v === 'warn' || v === 'auto')
+        return v;
+    return 'refuse';
+}
+// ============================================================================
+// D1 — loud (but once-per-process) hash-fallback warning
+// ============================================================================
+let fallbackWarned = false;
+/**
+ * Emit exactly ONE stderr warning per process the first time the hash
+ * fallback serves an embed that the ONNX embedder was supposed to handle
+ * (acceptance gate 2). Returns true when the warning was emitted by this call.
+ */
+function warnHashFallbackOnce(reason) {
+    if (fallbackWarned)
+        return false;
+    fallbackWarned = true;
+    const detail = reason ? ` Reason: ${reason}.` : '';
+    process.stderr.write(`ruvector: ONNX semantic embedder unavailable — using deterministic hash-fallback embeddings ` +
+        `(no semantic signal, reduced search quality).${detail} ` +
+        `Set RUVECTOR_EMBEDDER=hash to silence this or RUVECTOR_EMBEDDER=minilm to hard-require the model. ` +
+        `(warned once per process)\n`);
+    return true;
+}
+/** Whether the once-per-process fallback warning has fired. */
+function hashFallbackWarned() {
+    return fallbackWarned;
+}
+/** Test hook: reset the once-per-process warning latch. */
+function resetHashFallbackWarningForTests() {
+    fallbackWarned = false;
+}
+exports.default = {
+    MODEL_PREFIXES: exports.MODEL_PREFIXES,
+    BGE_QUERY_INSTRUCTION: exports.BGE_QUERY_INSTRUCTION,
+    getModelPrefixSpec,
+    prefixText,
+    embedderKindForModel,
+    legacyHashProvenance,
+    describeProvenance,
+    compareProvenance,
+    sanitizeProvenance,
+    MAX_PROVENANCE_DIMENSION: exports.MAX_PROVENANCE_DIMENSION,
+    ProvenanceMismatchError,
+    assertProvenanceMatch,
+    resolveEmbedderSelection,
+    resolveReembedPolicy,
+    warnHashFallbackOnce,
+    hashFallbackWarned,
+    resetHashFallbackWarningForTests,
+};

package/dist/core/index.d.ts

@@ -9,6 +9,7 @@ export * from './attention-fallbacks';
 export * from './agentdb-fast';
 export * from './sona-wrapper';
 export * from './intelligence-engine';
+export * from './embedding-provenance';
 export * from './onnx-embedder';
 export * from './onnx-optimized';
 export * from './parallel-intelligence';

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./attention-fallbacks"), exports);
 __exportStar(require("./agentdb-fast"), exports);
 __exportStar(require("./sona-wrapper"), exports);
 __exportStar(require("./intelligence-engine"), exports);
+__exportStar(require("./embedding-provenance"), exports);
 __exportStar(require("./onnx-embedder"), exports);
 __exportStar(require("./onnx-optimized"), exports);
 __exportStar(require("./parallel-intelligence"), exports);

package/dist/core/intelligence-engine.d.ts

@@ -12,6 +12,8 @@
  */
 import { EpisodeSearchResult } from './agentdb-fast';
 import { SonaConfig, LearnedPattern } from './sona-wrapper';
+import { OnnxEmbedderConfig } from './onnx-embedder';
+import { EmbeddingProvenance } from './embedding-provenance';
 import { ParallelConfig, BatchEpisode } from './parallel-intelligence';
 export interface MemoryEntry {
     id: string;
@@ -50,6 +52,13 @@ export interface LearningStats {
     workerTriggers: number;
     attentionEnabled: boolean;
     onnxEnabled: boolean;
+    /**
+     * Which embedder actually serves embedAsync() right now (ADR-210 D1):
+     * 'onnx-minilm' once the model is loaded, 'hash-fallback' while ONNX is
+     * enabled but not (yet) loaded, 'hash' when ONNX is deliberately disabled
+     * (config or RUVECTOR_EMBEDDER=hash / RUVECTOR_ONNX=0).
+     */
+    embedderKind: 'onnx-minilm' | 'hash-fallback' | 'hash';
     parallelEnabled: boolean;
     parallelWorkers: number;
     parallelBusy: number;
@@ -66,8 +75,15 @@ export interface IntelligenceConfig {
     enableSona?: boolean;
     /** Enable attention mechanisms (default: true if available) */
     enableAttention?: boolean;
-    /** Enable ONNX semantic embeddings (default: false, opt-in for quality) */
+    /**
+     * Enable ONNX semantic embeddings (default: TRUE since ADR-210 D1 — the
+     * model loads lazily; until ready or when it cannot load, the hash
+     * fallback is used and loudly reported). RUVECTOR_EMBEDDER / RUVECTOR_ONNX
+     * environment variables override this config (D5).
+     */
     enableOnnx?: boolean;
+    /** Options forwarded to the ONNX embedder (model id, cache dir, ...). */
+    onnxConfig?: OnnxEmbedderConfig;
     /** SONA configuration */
     sonaConfig?: Partial<SonaConfig>;
     /** Storage path for persistence */
@@ -91,6 +107,10 @@ export declare class IntelligenceEngine {
     private attention;
     private onnxEmbedder;
     private onnxReady;
+    private onnxInitPromise;
+    private onnxInitError;
+    /** RUVECTOR_EMBEDDER=minilm: fail rather than fall back (ADR-210 D5). */
+    private onnxHardRequire;
     private parallel;
     private memories;
     private routingPatterns;
@@ -107,6 +127,14 @@ export declare class IntelligenceEngine {
     private episodeBatchQueue;
     constructor(config?: IntelligenceConfig);
     private initOnnx;
+    /**
+     * Await lazy ONNX initialization. Resolves true once the model is loaded,
+     * false when it could not be (offline / restricted CI) — in which case
+     * stats().embedderKind reports 'hash-fallback' (ADR-210 D1).
+     */
+    awaitOnnx(): Promise<boolean>;
+    /** Why ONNX init failed, or null (ADR-210 D1 observability). */
+    getOnnxInitError(): Error | null;
     private initVectorDb;
     private initParallel;
     /**
@@ -114,9 +142,32 @@ export declare class IntelligenceEngine {
      */
     embed(text: string): number[];
     /**
-     * Async embedding with ONNX support (recommended for semantic quality)
+     * Async embedding with ONNX support (recommended for semantic quality).
+     *
+     * ADR-210 D1: when ONNX is enabled but the model cannot load, the hash
+     * fallback is used and reported (one stderr warning per process, and
+     * stats().embedderKind === 'hash-fallback'). Under RUVECTOR_EMBEDDER=minilm
+     * the failure is an error instead — no fallback (D5).
      */
     embedAsync(text: string): Promise<number[]>;
+    /**
+     * Batch embedding for bulk ingest (ADR-210 D3). When the ONNX model is
+     * loaded, batches of 32+ texts route through the bundled parallel worker
+     * pool (parallel-fp32 — see embedBulk in onnx-embedder.ts for the int8
+     * status note); smaller batches use the single-threaded batch path. On
+     * fallback, semantics match embedAsync exactly: hash per-item with the
+     * loud once-per-process warning, or a hard error under
+     * RUVECTOR_EMBEDDER=minilm (D5). Texts are embedded as passages (D4).
+     *
+     * Callers that start the pool should call shutdownEmbedderPool() when the
+     * bulk work is done so worker threads do not keep the process alive.
+     */
+    embedBatchAsync(texts: string[]): Promise<number[][]>;
+    /**
+     * Shut down the bundled bulk-embed worker pool, releasing its threads
+     * (ADR-210 D3). Safe to call when the pool was never started.
+     */
+    shutdownEmbedderPool(): Promise<void>;
     /**
      * Attention-based embedding using Flash or Multi-head attention
      */
@@ -236,6 +287,12 @@ export declare class IntelligenceEngine {
      * Get comprehensive learning statistics
      */
     getStats(): LearningStats;
+    /**
+     * Embedding provenance of vectors embedAsync() would produce right now
+     * (ADR-210 D0). Hash fallback embeds are 'hash' even while ONNX is enabled
+     * but not ready — provenance records what actually happened, not intent.
+     */
+    getActiveProvenance(): EmbeddingProvenance;
     /**
      * Export all data for persistence
      */
@@ -260,11 +317,15 @@ export declare class IntelligenceEngine {
  */
 export declare function createIntelligenceEngine(config?: IntelligenceConfig): IntelligenceEngine;
 /**
- * Create a high-performance engine with all features enabled
+ * Create a high-performance engine with all features enabled.
+ * Note (ADR-210): with default-on ONNX the embedding space is 384-dim; the
+ * 512-dim setting only applies on the hash path (RUVECTOR_EMBEDDER=hash or
+ * ONNX unavailable). SONA dims follow the engine's actual embeddingDim.
  */
 export declare function createHighPerformanceEngine(): IntelligenceEngine;
 /**
- * Create a lightweight engine for fast startup
+ * Create a lightweight engine for fast startup (hash embedder: no model load,
+ * no download — the deterministic no-model path stays available, ADR-210).
  */
 export declare function createLightweightEngine(): IntelligenceEngine;
 export default IntelligenceEngine;

package/dist/core/intelligence-engine.d.ts.map

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