@legioncodeinc/nectar 0.0.1

package/dist/embeddings/http.js

@@ -0,0 +1,19 @@
+/**
+ * The injectable HTTP seam shared by both embedding transports (PRD-014).
+ *
+ * A minimal `fetch`-shaped surface so neither the local nomic client nor the
+ * hosted-via-Portkey transport touches the network in a unit test: production
+ * binds `globalThis.fetch`, a test injects a fake that returns a canned
+ * response. The shape is deliberately identical to the sibling chat transport's
+ * `PortkeyFetch` (`src/portkey/transport.ts`) so the Wave-2 integrator can fold
+ * the two onto one shared seam without a signature change.
+ */
+/** Bind the real global `fetch` to the {@link FetchLike} shape (Node >=22 ships it as a built-in). */
+export function defaultFetch() {
+    return globalThis.fetch.bind(globalThis);
+}
+/** The production sleep, backed by a real timer. */
+export function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=http.js.map

package/dist/embeddings/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/embeddings/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,sGAAsG;AACtG,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAyB,CAAC;AACnE,CAAC;AAKD,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/embeddings/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The embeddings-provider module barrel (PRD-014).
+ *
+ * The single import surface for the switch and its providers. The Wave-2
+ * integrator re-exports what it needs from the top-level `src/index.ts` and
+ * wires `resolveEmbedProvider(resolveEmbeddingsConfig())` into the enricher /
+ * brooding / recall seams (PRD-007 / 016 / 012 / 013). See the module report for
+ * the exact wiring and the `src/portkey/headers.ts` duplication to unify.
+ */
+export { type EmbedProvider, type EmbedProviderSelector, type ResolveEmbedProviderDeps, createOffProvider, resolveEmbedProvider, DEFAULT_EMBED_PROVIDER, } from "./provider.js";
+export { type ResolvedEmbeddingsConfig, type EmbeddingsConfigOverrides, resolveEmbeddingsConfig, normalizeSelector, } from "./config.js";
+export { type DimRejection, type DimRejectionSink, guardVector, withDimGuard, stderrDimRejectionSink, } from "./guard.js";
+export { type LocalNomicConfig, type LocalNomicTransport, type LocalNomicHttpDeps, createLocalNomicHttpTransport, createLocalNomicProvider, DEFAULT_LOCAL_EMBED_HOST, DEFAULT_LOCAL_EMBED_PORT, DEFAULT_LOCAL_EMBED_TIMEOUT_MS, } from "./local-nomic.js";
+export { type HostedEmbeddingsConfig, type HostedPortkeyDeps, createHostedPortkeyProvider, parseEmbeddingsResponse, DEFAULT_HOSTED_EMBED_MODEL, DEFAULT_HOSTED_OUTPUT_DIMENSION, DEFAULT_HOSTED_MAX_ATTEMPTS, DEFAULT_HOSTED_RETRY_BACKOFF_MS, DEFAULT_HOSTED_REQUEST_TIMEOUT_MS, HOSTED_RETRYABLE_STATUSES, } from "./hosted-portkey.js";
+export { type FetchLike, type FetchResponseLike, type SleepFn, defaultFetch, defaultSleep, } from "./http.js";
+export { buildPortkeyHeaders, PORTKEY_BASE_URL, PORTKEY_EMBEDDINGS_URL, PORTKEY_API_KEY_HEADER, PORTKEY_CONFIG_HEADER, } from "../portkey/headers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,WAAW,EACX,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/embeddings/index.js

@@ -0,0 +1,17 @@
+/**
+ * The embeddings-provider module barrel (PRD-014).
+ *
+ * The single import surface for the switch and its providers. The Wave-2
+ * integrator re-exports what it needs from the top-level `src/index.ts` and
+ * wires `resolveEmbedProvider(resolveEmbeddingsConfig())` into the enricher /
+ * brooding / recall seams (PRD-007 / 016 / 012 / 013). See the module report for
+ * the exact wiring and the `src/portkey/headers.ts` duplication to unify.
+ */
+export { createOffProvider, resolveEmbedProvider, DEFAULT_EMBED_PROVIDER, } from "./provider.js";
+export { resolveEmbeddingsConfig, normalizeSelector, } from "./config.js";
+export { guardVector, withDimGuard, stderrDimRejectionSink, } from "./guard.js";
+export { createLocalNomicHttpTransport, createLocalNomicProvider, DEFAULT_LOCAL_EMBED_HOST, DEFAULT_LOCAL_EMBED_PORT, DEFAULT_LOCAL_EMBED_TIMEOUT_MS, } from "./local-nomic.js";
+export { createHostedPortkeyProvider, parseEmbeddingsResponse, DEFAULT_HOSTED_EMBED_MODEL, DEFAULT_HOSTED_OUTPUT_DIMENSION, DEFAULT_HOSTED_MAX_ATTEMPTS, DEFAULT_HOSTED_RETRY_BACKOFF_MS, DEFAULT_HOSTED_REQUEST_TIMEOUT_MS, HOSTED_RETRYABLE_STATUSES, } from "./hosted-portkey.js";
+export { defaultFetch, defaultSleep, } from "./http.js";
+export { buildPortkeyHeaders, PORTKEY_BASE_URL, PORTKEY_EMBEDDINGS_URL, PORTKEY_API_KEY_HEADER, PORTKEY_CONFIG_HEADER, } from "../portkey/headers.js";
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAIL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,WAAW,EACX,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,YAAY,EACZ,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/embeddings/local-nomic.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The local nomic embedding provider (PRD-014a — the zero-marginal-cost DEFAULT).
+ *
+ * Talks to the local nomic embed daemon the corpus describes
+ * (`ai/enricher-and-llm-model.md` § Embeddings: "the local nomic path
+ * (`nomic-embed-text-v1.5`, q8 quantization)"). Honeycomb's embed daemon
+ * (`honeycomb/embeddings/src/index.ts`) serves that model over a loopback
+ * request surface (`POST /embed { text } -> { vector }`, `GET /health`) on
+ * `127.0.0.1:3851`. Nectar reaches it over the network through its OWN
+ * client rather than importing the honeycomb runtime in-process (ADR-0002); the
+ * daemon owns the pinned `MODEL_ID` / `MODEL_REVISION` / `MODEL_QUANTIZATION` /
+ * `DOCUMENT_PREFIX` consts (PRD-014a keeps them pinned), so this client only
+ * carries the text and receives the vector.
+ *
+ * ── Fail-soft is the cardinal rule (AC-4) ────────────────────────────────────
+ * A dead daemon (connection refused), a not-yet-warm daemon (503 `model not
+ * ready`), a non-2xx, or a malformed body ALL resolve to `null` for that text —
+ * NEVER a throw into the caller's hot path. A `null` means the caller leaves the
+ * column NULL and recall degrades to BM25 (`ai/enricher-and-llm-model.md`). The
+ * dimension is NOT checked here; the 768-dim guard (`guard.ts`) owns that at the
+ * provider boundary, so a wrong-dim daemon output is discarded there (AC-3).
+ *
+ * The transport is an injectable seam ({@link LocalNomicTransport}) so a unit
+ * test drives the provider without binding a socket or running the ~600 MB model.
+ */
+import { type FetchLike } from "./http.js";
+import type { EmbedProvider } from "./provider.js";
+/**
+ * The pinned local nomic model id (PRD-014a / `ai/enricher-and-llm-model.md`).
+ * The embed daemon owns the model, revision, and quantization; nectar records
+ * this id as `embed_model` provenance on rows the local provider embeds
+ * (PRD-018i / NEC-018).
+ */
+export declare const LOCAL_NOMIC_MODEL_ID: "nomic-embed-text-v1.5";
+/** The local embed daemon's loopback host (matches honeycomb's `EMBED_HOST`). */
+export declare const DEFAULT_LOCAL_EMBED_HOST: "127.0.0.1";
+/** The local embed daemon's loopback port (matches honeycomb's `EMBED_PORT` / `src/config.ts` note). */
+export declare const DEFAULT_LOCAL_EMBED_PORT: 3851;
+/** The per-text request timeout (ms) before the client gives up and returns `null` (fail-soft). */
+export declare const DEFAULT_LOCAL_EMBED_TIMEOUT_MS: 10000;
+/** The resolved local-nomic client config (host/port/timeout). */
+export interface LocalNomicConfig {
+    readonly host: string;
+    readonly port: number;
+    readonly requestTimeoutMs: number;
+}
+/**
+ * The injectable local-daemon transport seam. `embedOne` returns the daemon's
+ * RAW vector for one text, or `null` on ANY failure (dead/not-warm daemon,
+ * non-2xx, malformed body). It never throws. The returned vector is NOT
+ * dimension-checked here — the guard owns that.
+ */
+export interface LocalNomicTransport {
+    embedOne(text: string): Promise<number[] | null>;
+}
+/** Construction deps for {@link createLocalNomicHttpTransport}; the fetch is injectable for tests. */
+export interface LocalNomicHttpDeps {
+    /** The `fetch` implementation; defaults to `globalThis.fetch`. A test injects a fake (no socket). */
+    readonly fetch?: FetchLike;
+}
+/**
+ * Build the REAL local-nomic transport: a loopback HTTP client to the embed
+ * daemon's `POST /embed` (PRD-014a). Every failure path — a network error
+ * (daemon down), a non-2xx (e.g. 503 not-warm), or a malformed body — resolves
+ * to `null` (fail-soft, AC-4), NEVER a throw. Production uses `globalThis.fetch`;
+ * a test injects a fake `fetch` so no socket is bound. An `AbortController`
+ * bounds each call so a hung daemon cannot stall the embed path.
+ */
+export declare function createLocalNomicHttpTransport(config: LocalNomicConfig, deps?: LocalNomicHttpDeps): LocalNomicTransport;
+/**
+ * Build the local nomic {@link EmbedProvider} over an injected transport. The
+ * provider embeds each text through the daemon (order-preserving, 1:1) and maps
+ * ANY per-text failure to `null` — a rejected transport promise is caught here so
+ * the provider's never-throw contract holds even if a future transport rejects
+ * (AC-4). The returned vectors are dimension-guarded by the caller (`guard.ts`).
+ */
+export declare function createLocalNomicProvider(transport: LocalNomicTransport): EmbedProvider;
+//# sourceMappingURL=local-nomic.d.ts.map

package/dist/embeddings/local-nomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-nomic.d.ts","sourceRoot":"","sources":["../../src/embeddings/local-nomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAG,uBAAgC,CAAC;AAErE,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,EAAG,WAAoB,CAAC;AAE7D,wGAAwG;AACxG,eAAO,MAAM,wBAAwB,EAAG,IAAa,CAAC;AAEtD,mGAAmG;AACnG,eAAO,MAAM,8BAA8B,EAAG,KAAe,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,sGAAsG;AACtG,MAAM,WAAW,kBAAkB;IACjC,qGAAqG;IACrG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AA0BD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,gBAAgB,EACxB,IAAI,GAAE,kBAAuB,GAC5B,mBAAmB,CA0BrB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,mBAAmB,GAAG,aAAa,CAetF"}

package/dist/embeddings/local-nomic.js

@@ -0,0 +1,126 @@
+/**
+ * The local nomic embedding provider (PRD-014a — the zero-marginal-cost DEFAULT).
+ *
+ * Talks to the local nomic embed daemon the corpus describes
+ * (`ai/enricher-and-llm-model.md` § Embeddings: "the local nomic path
+ * (`nomic-embed-text-v1.5`, q8 quantization)"). Honeycomb's embed daemon
+ * (`honeycomb/embeddings/src/index.ts`) serves that model over a loopback
+ * request surface (`POST /embed { text } -> { vector }`, `GET /health`) on
+ * `127.0.0.1:3851`. Nectar reaches it over the network through its OWN
+ * client rather than importing the honeycomb runtime in-process (ADR-0002); the
+ * daemon owns the pinned `MODEL_ID` / `MODEL_REVISION` / `MODEL_QUANTIZATION` /
+ * `DOCUMENT_PREFIX` consts (PRD-014a keeps them pinned), so this client only
+ * carries the text and receives the vector.
+ *
+ * ── Fail-soft is the cardinal rule (AC-4) ────────────────────────────────────
+ * A dead daemon (connection refused), a not-yet-warm daemon (503 `model not
+ * ready`), a non-2xx, or a malformed body ALL resolve to `null` for that text —
+ * NEVER a throw into the caller's hot path. A `null` means the caller leaves the
+ * column NULL and recall degrades to BM25 (`ai/enricher-and-llm-model.md`). The
+ * dimension is NOT checked here; the 768-dim guard (`guard.ts`) owns that at the
+ * provider boundary, so a wrong-dim daemon output is discarded there (AC-3).
+ *
+ * The transport is an injectable seam ({@link LocalNomicTransport}) so a unit
+ * test drives the provider without binding a socket or running the ~600 MB model.
+ */
+import { defaultFetch } from "./http.js";
+/**
+ * The pinned local nomic model id (PRD-014a / `ai/enricher-and-llm-model.md`).
+ * The embed daemon owns the model, revision, and quantization; nectar records
+ * this id as `embed_model` provenance on rows the local provider embeds
+ * (PRD-018i / NEC-018).
+ */
+export const LOCAL_NOMIC_MODEL_ID = "nomic-embed-text-v1.5";
+/** The local embed daemon's loopback host (matches honeycomb's `EMBED_HOST`). */
+export const DEFAULT_LOCAL_EMBED_HOST = "127.0.0.1";
+/** The local embed daemon's loopback port (matches honeycomb's `EMBED_PORT` / `src/config.ts` note). */
+export const DEFAULT_LOCAL_EMBED_PORT = 3851;
+/** The per-text request timeout (ms) before the client gives up and returns `null` (fail-soft). */
+export const DEFAULT_LOCAL_EMBED_TIMEOUT_MS = 10_000;
+/** Build the `/embed` URL for the resolved host/port. */
+function embedUrl(config) {
+    return `http://${config.host}:${config.port}/embed`;
+}
+/**
+ * Parse the daemon's `{ vector: number[] }` body defensively. Returns the vector
+ * when the body is the expected shape with a finite-number array, else `null`
+ * (a malformed body fails soft, same as a transport error). Never throws.
+ */
+function parseVector(raw) {
+    let body;
+    try {
+        body = raw.length > 0 ? JSON.parse(raw) : null;
+    }
+    catch {
+        return null;
+    }
+    if (typeof body !== "object" || body === null)
+        return null;
+    const vector = body.vector;
+    if (!Array.isArray(vector))
+        return null;
+    if (!vector.every((n) => typeof n === "number" && Number.isFinite(n)))
+        return null;
+    return vector;
+}
+/**
+ * Build the REAL local-nomic transport: a loopback HTTP client to the embed
+ * daemon's `POST /embed` (PRD-014a). Every failure path — a network error
+ * (daemon down), a non-2xx (e.g. 503 not-warm), or a malformed body — resolves
+ * to `null` (fail-soft, AC-4), NEVER a throw. Production uses `globalThis.fetch`;
+ * a test injects a fake `fetch` so no socket is bound. An `AbortController`
+ * bounds each call so a hung daemon cannot stall the embed path.
+ */
+export function createLocalNomicHttpTransport(config, deps = {}) {
+    const doFetch = deps.fetch ?? defaultFetch();
+    const url = embedUrl(config);
+    return {
+        async embedOne(text) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), config.requestTimeoutMs);
+            try {
+                const res = await doFetch(url, {
+                    method: "POST",
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify({ text }),
+                    signal: controller.signal,
+                });
+                if (!res.ok)
+                    return null;
+                return parseVector(await res.text());
+            }
+            catch {
+                // Dead daemon (ECONNREFUSED), our own abort on `requestTimeoutMs` (a hung/not-warm
+                // daemon), or any other transport fault -> null. Never surface the error (fail-soft):
+                // the caller leaves the column NULL and recall stays lexical (AC-4).
+                return null;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+/**
+ * Build the local nomic {@link EmbedProvider} over an injected transport. The
+ * provider embeds each text through the daemon (order-preserving, 1:1) and maps
+ * ANY per-text failure to `null` — a rejected transport promise is caught here so
+ * the provider's never-throw contract holds even if a future transport rejects
+ * (AC-4). The returned vectors are dimension-guarded by the caller (`guard.ts`).
+ */
+export function createLocalNomicProvider(transport) {
+    return {
+        kind: "local",
+        embed(texts) {
+            return Promise.all(texts.map(async (text) => {
+                try {
+                    return await transport.embedOne(text);
+                }
+                catch {
+                    return null;
+                }
+            }));
+        },
+    };
+}
+//# sourceMappingURL=local-nomic.js.map

package/dist/embeddings/local-nomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-nomic.js","sourceRoot":"","sources":["../../src/embeddings/local-nomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,YAAY,EAAkB,MAAM,WAAW,CAAC;AAGzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAgC,CAAC;AAErE,iFAAiF;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAoB,CAAC;AAE7D,wGAAwG;AACxG,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAa,CAAC;AAEtD,mGAAmG;AACnG,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAe,CAAC;AAyB9D,yDAAyD;AACzD,SAAS,QAAQ,CAAC,MAAwB;IACxC,OAAO,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,QAAQ,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,MAAM,GAAI,IAA6B,CAAC,MAAM,CAAC;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnF,OAAO,MAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAwB,EACxB,OAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,IAAY;YACzB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC5E,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;oBAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,OAAO,IAAI,CAAC;gBACzB,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,mFAAmF;gBACnF,sFAAsF;gBACtF,qEAAqE;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAA8B;IACrE,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,CAAC,KAAwB;YAC5B,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACvB,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/embeddings/provider.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The embedding provider strategy switch (PRD-014a / DECISION #5).
+ *
+ * Nectar's embeddings come from two strategies behind ONE selector:
+ *   - `local`  the local nomic daemon (`nomic-embed-text-v1.5`, q8) — the
+ *              zero-marginal-cost DEFAULT (`local-nomic.ts`).
+ *   - `hosted` the hosted-via-Portkey embeddings transport — an operator opt-in
+ *              (`hosted-portkey.ts`).
+ * plus the disabled state:
+ *   - `off`    no vector is computed; every embed resolves to `null` so the
+ *              caller leaves the column NULL and recall falls back to BM25
+ *              (`ai/enricher-and-llm-model.md` § Embeddings).
+ *
+ * The selector EXTENDS the vault `embeddings.enabled` switch into a three-value
+ * setting rather than adding a parallel enable mechanism (DECISION #5): `off` is
+ * the disabled value, `local`/`hosted` pick the provider. No explicit selection
+ * resolves to `local` ({@link DEFAULT_EMBED_PROVIDER}, AC-1).
+ *
+ * Both computing providers are wrapped by the 768-dim guard (`guard.ts`) at this
+ * boundary, so a vector of the wrong dimension from EITHER provider is discarded
+ * to `null` — the 768-dim contract (`EMBED_DIMS`, `hive-graph/model.ts`) is
+ * never violated in storage (AC-3). The disabled provider needs no guard: it
+ * already returns only nulls.
+ */
+import type { ResolvedEmbeddingsConfig } from "./config.js";
+import { type DimRejectionSink } from "./guard.js";
+import { type FetchLike, type SleepFn } from "./http.js";
+import { type LocalNomicTransport } from "./local-nomic.js";
+/**
+ * The provider selector — the single embeddings switch (DECISION #5). `off`
+ * disables embeddings (NULL column, BM25 fallback); `local` and `hosted` pick
+ * the computing strategy.
+ */
+export type EmbedProviderSelector = "off" | "local" | "hosted";
+/** The default provider when none is explicitly selected: the local nomic daemon (AC-1 / DECISION #5). */
+export declare const DEFAULT_EMBED_PROVIDER: EmbedProviderSelector;
+/**
+ * The strategy contract both computing providers implement. `embed` maps each
+ * input text to a vector OR `null` (1:1, order-preserving): `null` means "no
+ * usable embedding for this text" — disabled, transport failure, or a wrong-dim
+ * vector the guard discarded. `embed` NEVER throws into the caller's hot path
+ * (the fail-soft contract, AC-4); a failure surfaces as nulls.
+ */
+export interface EmbedProvider {
+    /** Which strategy this instance is (used for observability + AC verification). */
+    readonly kind: EmbedProviderSelector;
+    /** Embed a batch; returns one `number[] | null` per input, in input order. Never rejects. */
+    embed(texts: readonly string[]): Promise<(number[] | null)[]>;
+}
+/**
+ * The disabled provider: every text maps to `null` regardless of input. This is
+ * the `off` selector and the fail-soft floor — the caller leaves the embedding
+ * column NULL and recall degrades to BM25 with no error and no quality cliff
+ * (AC-4). Pure + total; never touches the network.
+ */
+export declare function createOffProvider(): EmbedProvider;
+/** Injectable seams for {@link resolveEmbedProvider} so a test drives it without the network. */
+export interface ResolveEmbedProviderDeps {
+    /**
+     * The local nomic transport (test seam). When absent, a real loopback HTTP
+     * transport is built from `config.local`. A test injects a fake so AC-1 can
+     * assert the local path was invoked without a running embed daemon.
+     */
+    readonly localTransport?: LocalNomicTransport;
+    /** The `fetch` for the hosted-via-Portkey transport (test seam); defaults to `globalThis.fetch`. */
+    readonly fetch?: FetchLike;
+    /** The backoff sleep for the hosted transport's bounded retry; a test passes a no-op. */
+    readonly sleep?: SleepFn;
+    /** Where a discarded wrong-dim vector is reported (AC-3); defaults to a no-op. */
+    readonly onDimRejected?: DimRejectionSink;
+}
+/**
+ * Resolve the configured {@link EmbedProvider} (the switch, PRD-014a / 014c). The
+ * selector routes to the strategy; both computing strategies are wrapped by the
+ * 768-dim guard so a wrong-dim vector from either is discarded (AC-3). A test
+ * injects a fake `localTransport` / `fetch` so no unit test touches the network.
+ */
+export declare function resolveEmbedProvider(config: ResolvedEmbeddingsConfig, deps?: ResolveEmbedProviderDeps): EmbedProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/embeddings/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/embeddings/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAA8B,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,EAA2D,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGrH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,0GAA0G;AAC1G,eAAO,MAAM,sBAAsB,EAAE,qBAA+B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,6FAA6F;IAC7F,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;CAC/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAOjD;AAED,iGAAiG;AACjG,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAC9C,oGAAoG;IACpG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,wBAAwB,EAChC,IAAI,GAAE,wBAA6B,GAClC,aAAa,CAsBf"}

package/dist/embeddings/provider.js

@@ -0,0 +1,50 @@
+import { withDimGuard } from "./guard.js";
+import { defaultFetch, defaultSleep } from "./http.js";
+import { createLocalNomicProvider, createLocalNomicHttpTransport } from "./local-nomic.js";
+import { createHostedPortkeyProvider } from "./hosted-portkey.js";
+/** The default provider when none is explicitly selected: the local nomic daemon (AC-1 / DECISION #5). */
+export const DEFAULT_EMBED_PROVIDER = "local";
+/**
+ * The disabled provider: every text maps to `null` regardless of input. This is
+ * the `off` selector and the fail-soft floor — the caller leaves the embedding
+ * column NULL and recall degrades to BM25 with no error and no quality cliff
+ * (AC-4). Pure + total; never touches the network.
+ */
+export function createOffProvider() {
+    return {
+        kind: "off",
+        embed(texts) {
+            return Promise.resolve(texts.map(() => null));
+        },
+    };
+}
+/**
+ * Resolve the configured {@link EmbedProvider} (the switch, PRD-014a / 014c). The
+ * selector routes to the strategy; both computing strategies are wrapped by the
+ * 768-dim guard so a wrong-dim vector from either is discarded (AC-3). A test
+ * injects a fake `localTransport` / `fetch` so no unit test touches the network.
+ */
+export function resolveEmbedProvider(config, deps = {}) {
+    const onDimRejected = deps.onDimRejected;
+    switch (config.selector) {
+        case "off":
+            return createOffProvider();
+        case "local": {
+            const transport = deps.localTransport ?? createLocalNomicHttpTransport(config.local, { fetch: deps.fetch });
+            return withDimGuard(createLocalNomicProvider(transport), onDimRejected);
+        }
+        case "hosted": {
+            const provider = createHostedPortkeyProvider(config.hosted, {
+                fetch: deps.fetch ?? defaultFetch(),
+                sleep: deps.sleep ?? defaultSleep,
+            });
+            return withDimGuard(provider, onDimRejected);
+        }
+        default: {
+            // Exhaustiveness: a new selector variant fails the build here until handled.
+            const unreachable = config.selector;
+            return unreachable;
+        }
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/embeddings/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/embeddings/provider.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,YAAY,EAAyB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAgC,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAA4B,MAAM,kBAAkB,CAAC;AACrH,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AASlE,0GAA0G;AAC1G,MAAM,CAAC,MAAM,sBAAsB,GAA0B,OAAO,CAAC;AAgBrE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,KAAwB;YAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAgC,EAChC,OAAiC,EAAE;IAEnC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,KAAK;YACR,OAAO,iBAAiB,EAAE,CAAC;QAC7B,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,IAAI,6BAA6B,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5G,OAAO,YAAY,CAAC,wBAAwB,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY,EAAE;gBACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY;aAClC,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,6EAA6E;YAC7E,MAAM,WAAW,GAAU,MAAM,CAAC,QAAQ,CAAC;YAC3C,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/enricher/config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Enricher tunables (PRD-016 / decision #34).
+ *
+ * All values are config-overridable via `~/.honeycomb/nectar.json`; these are
+ * the signed-off defaults from `ai/enricher-and-llm-model.md`.
+ */
+/** Default enricher poll interval (30s). */
+export declare const DEFAULT_ENRICHER_POLL_INTERVAL_MS: 30000;
+/** Watcher intake debounce lives in `registration/fs-watch.ts` (500ms). */
+export declare const DEFAULT_WATCHER_DEBOUNCE_MS: 500;
+/** Cosmetic-change inheritance threshold (Jaccard on token multisets). */
+export declare const DEFAULT_REDESCRIBE_THRESHOLD: 0.85;
+/** Consecutive failed cycles before the persistent alert fires. */
+export declare const DEFAULT_PERSISTENT_FAILURE_THRESHOLD: 5;
+/** Default batch size for pending-work selection (non-solo). */
+export declare const DEFAULT_ENRICHER_BATCH_SIZE: 10;
+/** Rough USD estimate for Gemini 2.5 Flash per-token (observability only). */
+export declare const ENRICHER_INPUT_USD_PER_TOKEN: number;
+export declare const ENRICHER_OUTPUT_USD_PER_TOKEN: number;
+export interface EnricherConfig {
+    readonly pollIntervalMs: number;
+    readonly redescribeThreshold: number;
+    readonly persistentFailureThreshold: number;
+    readonly batchSize: number;
+}
+/**
+ * Tunables sourced from the `~/.honeycomb/nectar.json` loader (PRD-018k /
+ * NEC-041), already resolved with env-over-file precedence by
+ * `resolveNectarTunables`. Only the redescribe threshold applies to the
+ * enricher; a value present here is used when no explicit code override
+ * (`partial`) supplies one, and both fall back to the signed-off default.
+ */
+export interface EnricherTunables {
+    readonly redescribeThreshold?: number;
+}
+/**
+ * Resolve the enricher config. Precedence for the redescribe threshold is:
+ * explicit code override (`partial`) > the resolved config-file/env tunable
+ * (`tunables`) > the signed-off {@link DEFAULT_REDESCRIBE_THRESHOLD}. The other
+ * fields default from code as before.
+ */
+export declare function resolveEnricherConfig(partial?: Partial<EnricherConfig>, tunables?: EnricherTunables): EnricherConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/enricher/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/enricher/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,iCAAiC,EAAG,KAAe,CAAC;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,EAAG,GAAY,CAAC;AAExD,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,EAAG,IAAa,CAAC;AAE1D,mEAAmE;AACnE,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAE/D,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,EAAG,EAAW,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,QAAmB,CAAC;AAC7D,eAAO,MAAM,6BAA6B,QAAkB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,EACrC,QAAQ,GAAE,gBAAqB,GAC9B,cAAc,CAQhB"}

package/dist/enricher/config.js

@@ -0,0 +1,34 @@
+/**
+ * Enricher tunables (PRD-016 / decision #34).
+ *
+ * All values are config-overridable via `~/.honeycomb/nectar.json`; these are
+ * the signed-off defaults from `ai/enricher-and-llm-model.md`.
+ */
+/** Default enricher poll interval (30s). */
+export const DEFAULT_ENRICHER_POLL_INTERVAL_MS = 30_000;
+/** Watcher intake debounce lives in `registration/fs-watch.ts` (500ms). */
+export const DEFAULT_WATCHER_DEBOUNCE_MS = 500;
+/** Cosmetic-change inheritance threshold (Jaccard on token multisets). */
+export const DEFAULT_REDESCRIBE_THRESHOLD = 0.85;
+/** Consecutive failed cycles before the persistent alert fires. */
+export const DEFAULT_PERSISTENT_FAILURE_THRESHOLD = 5;
+/** Default batch size for pending-work selection (non-solo). */
+export const DEFAULT_ENRICHER_BATCH_SIZE = 10;
+/** Rough USD estimate for Gemini 2.5 Flash per-token (observability only). */
+export const ENRICHER_INPUT_USD_PER_TOKEN = 0.65 / 1_000_000;
+export const ENRICHER_OUTPUT_USD_PER_TOKEN = 2.4 / 1_000_000;
+/**
+ * Resolve the enricher config. Precedence for the redescribe threshold is:
+ * explicit code override (`partial`) > the resolved config-file/env tunable
+ * (`tunables`) > the signed-off {@link DEFAULT_REDESCRIBE_THRESHOLD}. The other
+ * fields default from code as before.
+ */
+export function resolveEnricherConfig(partial = {}, tunables = {}) {
+    return {
+        pollIntervalMs: partial.pollIntervalMs ?? DEFAULT_ENRICHER_POLL_INTERVAL_MS,
+        redescribeThreshold: partial.redescribeThreshold ?? tunables.redescribeThreshold ?? DEFAULT_REDESCRIBE_THRESHOLD,
+        persistentFailureThreshold: partial.persistentFailureThreshold ?? DEFAULT_PERSISTENT_FAILURE_THRESHOLD,
+        batchSize: partial.batchSize ?? DEFAULT_ENRICHER_BATCH_SIZE,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/enricher/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/enricher/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAe,CAAC;AAEjE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAY,CAAC;AAExD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAa,CAAC;AAE1D,mEAAmE;AACnE,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAU,CAAC;AAE/D,gEAAgE;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAW,CAAC;AAEvD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;AAC7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,GAAG,SAAS,CAAC;AAoB7D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAmC,EAAE,EACrC,WAA6B,EAAE;IAE/B,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,iCAAiC;QAC3E,mBAAmB,EACjB,OAAO,CAAC,mBAAmB,IAAI,QAAQ,CAAC,mBAAmB,IAAI,4BAA4B;QAC7F,0BAA0B,EAAE,OAAO,CAAC,0BAA0B,IAAI,oCAAoC;QACtG,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,2BAA2B;KAC5D,CAAC;AACJ,CAAC"}

package/dist/enricher/content-cache.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Prior-content cache for the cosmetic-change (Jaccard) gate (PRD-018g / NEC-026).
+ *
+ * The gate needs the PRIOR described version's file content to compare against
+ * the new content, but the hive-graph tables store only a `content_hash`, never
+ * the bytes. This bounded in-process cache is the chosen prior-content strategy:
+ * whenever the enricher reads a file's content on the describe path, it records
+ * `{ contentHash, content }` keyed by nectar, so the NEXT observation of that
+ * file can compute Jaccard(priorContent, newContent) without a paid re-describe.
+ *
+ * The cache is per-daemon-process and lost on restart, so the FIRST post-boot
+ * edit of a file cannot inherit (the prior content is unknown) and takes the full
+ * describe path - the honest degradation `cli.ts` already documents for a cold
+ * boot. The `contentHash` stored alongside lets the gate confirm the cached
+ * content actually corresponds to the prior described version before trusting it.
+ */
+export interface PriorContentEntry {
+    readonly contentHash: string;
+    readonly content: string;
+}
+export interface PriorContentCache {
+    get(nectar: string): PriorContentEntry | undefined;
+    set(nectar: string, contentHash: string, content: string): void;
+}
+/** Default cap on cached entries; FIFO eviction keeps memory bounded on a large repo. */
+export declare const DEFAULT_PRIOR_CONTENT_CACHE_MAX = 4096;
+/** Build a bounded FIFO prior-content cache. */
+export declare function createPriorContentCache(maxEntries?: number): PriorContentCache;
+//# sourceMappingURL=content-cache.d.ts.map

package/dist/enricher/content-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-cache.d.ts","sourceRoot":"","sources":["../../src/enricher/content-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjE;AAED,yFAAyF;AACzF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,UAAU,GAAE,MAAwC,GAAG,iBAAiB,CAiB/G"}

package/dist/enricher/content-cache.js

@@ -0,0 +1,24 @@
+/** Default cap on cached entries; FIFO eviction keeps memory bounded on a large repo. */
+export const DEFAULT_PRIOR_CONTENT_CACHE_MAX = 4096;
+/** Build a bounded FIFO prior-content cache. */
+export function createPriorContentCache(maxEntries = DEFAULT_PRIOR_CONTENT_CACHE_MAX) {
+    const cap = Math.max(1, Math.floor(maxEntries));
+    const map = new Map();
+    return {
+        get(nectar) {
+            return map.get(nectar);
+        },
+        set(nectar, contentHash, content) {
+            if (map.has(nectar))
+                map.delete(nectar);
+            map.set(nectar, { contentHash, content });
+            while (map.size > cap) {
+                const oldest = map.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                map.delete(oldest);
+            }
+        },
+    };
+}
+//# sourceMappingURL=content-cache.js.map

package/dist/enricher/content-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-cache.js","sourceRoot":"","sources":["../../src/enricher/content-cache.ts"],"names":[],"mappings":"AA0BA,yFAAyF;AACzF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,gDAAgD;AAChD,MAAM,UAAU,uBAAuB,CAAC,aAAqB,+BAA+B;IAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,OAAO;QACL,GAAG,CAAC,MAAc;YAChB,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,MAAc,EAAE,WAAmB,EAAE,OAAe;YACtD,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1C,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBACvC,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM;gBAChC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}