@legioncodeinc/nectar 0.0.1

package/dist/hive-graph/search-types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Types for the PRD-012a `searchHiveGraph` engine.
+ *
+ * The engine reads `hive_graph_versions` through an injected {@link StorageQuery}
+ * and optionally embeds the query through {@link EmbedClient}. CLI (012b) and the
+ * HTTP handler (PRD-008b) both delegate to the same function signature.
+ */
+import type { Tenancy } from "./model.js";
+/** Org/workspace partition + soft `project_id` filter (decision #3). */
+export type QueryScope = Tenancy;
+/** One row of a Deep Lake query result. */
+export type StorageRow = Record<string, unknown>;
+/**
+ * The read seam the engine uses. Org/workspace ride the transport headers;
+ * `project_id` is filtered in SQL via {@link QueryScope.projectId}.
+ */
+export interface StorageQuery {
+    query(sql: string, scope: QueryScope): Promise<readonly StorageRow[]>;
+}
+/**
+ * Embeds a single query string to a 768-dim vector, or `null` on every failure
+ * mode (disabled, unreachable, timeout, wrong-dim). Mirrors honeycomb's
+ * `EmbedClient` contract consumed by recall's semantic arm.
+ */
+export interface EmbedClient {
+    embed(text: string): Promise<number[] | null>;
+}
+/** One ranked hive-graph search hit (latest described version per nectar). */
+export interface HiveGraphHit {
+    readonly source: "nectar";
+    readonly id: string;
+    readonly path: string;
+    readonly title: string;
+    readonly body: string;
+    readonly concepts: string;
+    readonly content_hash: string;
+}
+export interface HiveGraphSearchDeps {
+    readonly storage: StorageQuery;
+    /** When absent, search runs lexical-only and returns `degraded: true`. */
+    readonly embed?: EmbedClient;
+    /**
+     * The active embedding provider's model id (PRD-018i / NEC-018 AC-018i.3). When
+     * set, the semantic arm excludes rows whose non-null `embed_model` disagrees
+     * with it (a cross-space cosine comparison is meaningless) and reports the
+     * mismatched nectars through {@link onReembedNeeded}. Rows with a null
+     * `embed_model` (pre-provenance rows) are treated as compatible.
+     */
+    readonly activeEmbedModel?: string;
+    /** Sink for nectars whose stored embedding disagrees with the active model, to be re-embedded (AC-018i.3). */
+    readonly onReembedNeeded?: (nectars: readonly string[]) => void;
+    /**
+     * The recall RRF multiplier loaded from `~/.honeycomb/nectar.json`'s
+     * `nectar_rrf_multiplier` knob (PRD-018k / NEC-041 AC-018k.7). This is the
+     * config SURFACE the knob plugs into: the value is accepted and exposed here,
+     * but this standalone two-arm engine deliberately applies NO cross-arm class
+     * weighting (PRD-012a; see the recall review's spec-conformance note), so the
+     * multiplier does not yet alter fusion. It reaches the recall path so a future
+     * cross-table fusion arm can weight nectar hits without a new plumbing change.
+     */
+    readonly rrfMultiplier?: number;
+}
+export type HiveGraphSearchArmState = "ok" | "missing-table" | "error" | "not-run";
+export type HiveGraphSearchArmName = "semantic" | "lexical";
+export interface HiveGraphSearchArmStatus {
+    readonly status: HiveGraphSearchArmState;
+    readonly rows: number;
+    readonly reason?: string;
+}
+export type HiveGraphSearchReason = "ok" | "empty-query" | "semantic-unavailable" | "no-matches" | "missing-table" | "backend-error";
+export interface HiveGraphSearchResult {
+    readonly hits: readonly HiveGraphHit[];
+    readonly sources: readonly ("nectar")[];
+    readonly degraded: boolean;
+    readonly reason?: HiveGraphSearchReason;
+    readonly errorSources?: readonly HiveGraphSearchArmName[];
+    readonly arms?: {
+        readonly semantic: HiveGraphSearchArmStatus;
+        readonly lexical: HiveGraphSearchArmStatus;
+    };
+}
+//# sourceMappingURL=search-types.d.ts.map

package/dist/hive-graph/search-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-types.d.ts","sourceRoot":"","sources":["../../src/hive-graph/search-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,2CAA2C;AAC3C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAC/C;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8GAA8G;IAC9G,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,GAAG,eAAe,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAC7B,IAAI,GACJ,aAAa,GACb,sBAAsB,GACtB,YAAY,GACZ,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;QAC5C,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;KAC5C,CAAC;CACH"}

package/dist/hive-graph/search-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-types.js.map

package/dist/hive-graph/search-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-types.js","sourceRoot":"","sources":["../../src/hive-graph/search-types.ts"],"names":[],"mappings":""}

package/dist/hive-graph/search.d.ts

@@ -0,0 +1,51 @@
+import type { HiveGraphSearchDeps, HiveGraphSearchResult, QueryScope } from "./search-types.js";
+export type { EmbedClient, HiveGraphHit, HiveGraphSearchDeps, HiveGraphSearchResult, QueryScope, StorageQuery, } from "./search-types.js";
+/** Default result cap when the caller omits `limit` (decision #34). */
+export declare const DEFAULT_RECALL_LIMIT = 20;
+/** Hard ceiling on search hits (fat-finger guard). */
+export declare const MAX_RECALL_LIMIT = 200;
+/** RRF constant `k` (mirrors honeycomb recall). */
+export declare const RRF_K = 60;
+/**
+ * Default recall RRF multiplier when `~/.honeycomb/nectar.json`'s
+ * `nectar_rrf_multiplier` knob is unset (PRD-018k / NEC-041). `1` is neutral:
+ * this standalone two-arm engine applies no cross-arm class weighting
+ * (PRD-012a), so the multiplier is a config surface for a future cross-table
+ * fusion arm, not a value that alters fusion today.
+ */
+export declare const DEFAULT_RRF_MULTIPLIER = 1;
+/** Vector arm over-fetch multiplier (mirrors honeycomb `vector.ts`). */
+export declare const DEFAULT_OVERFETCH_MULTIPLIER = 3;
+/**
+ * Resolve the effective recall RRF multiplier from the search deps (PRD-018k /
+ * NEC-041 AC-018k.7): the loaded `nectar_rrf_multiplier` value when it is a
+ * finite positive number, else {@link DEFAULT_RRF_MULTIPLIER}. This is where the
+ * config knob plugs into the recall path; fusion does not yet weight by it.
+ */
+export declare function resolveRrfMultiplier(deps: Pick<HiveGraphSearchDeps, "rrfMultiplier">): number;
+/** Clamp a caller-supplied limit into `[1, MAX_RECALL_LIMIT]`, defaulting a missing/bad value. */
+export declare function resolveRecallLimit(limit: number | undefined): number;
+/**
+ * Latest described version per nectar (`MAX(seq)`), scoped by tenancy.
+ * Load-bearing shape from `recall-integration.md`.
+ */
+export declare function buildLatestDescribedSubquery(scope: QueryScope): string;
+/**
+ * Guarded lexical arm over `title`, `description`, and `concepts` with the
+ * latest-per-nectar join. Exported for injection-safety tests.
+ */
+export declare function buildHiveGraphLexicalArmSql(term: string, scope: QueryScope, perArmLimit: number): string;
+/** Step 1 of the semantic arm: `<#>` cosine match returning scored nectar ids only. */
+export declare function buildHiveGraphVectorSearchSql(queryVector: readonly number[], scope: QueryScope, perArmLimit: number, overFetchMultiplier?: number): string;
+/** Step 2 of the semantic arm: hydrate matched nectars' display columns. */
+export declare function buildHiveGraphHydrateSql(ids: readonly string[], scope: QueryScope): string;
+/**
+ * Search the hive graph: guarded lexical + optional semantic arms fused by RRF.
+ *
+ * @param query - Search term (trimmed; empty returns the empty/degraded floor).
+ * @param scope - Tenancy + soft project filter applied in SQL.
+ * @param limit - Result cap; defaults to {@link DEFAULT_RECALL_LIMIT}.
+ * @param deps - Storage query seam + optional embed client.
+ */
+export declare function searchHiveGraph(query: string, scope: QueryScope, limit: number | undefined, deps: HiveGraphSearchDeps): Promise<HiveGraphSearchResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/hive-graph/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/hive-graph/search.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAKV,mBAAmB,EAEnB,qBAAqB,EACrB,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,mDAAmD;AACnD,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAO9C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG,MAAM,CAG7F;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKpE;AAeD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAUtE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAgCxG;AAED,uFAAuF;AACvF,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,mBAAmB,SAA+B,GACjD,MAAM,CAyBR;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAoB1F;AAmQD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CA4ChC"}

package/dist/hive-graph/search.js

@@ -0,0 +1,417 @@
+/**
+ * Standalone hive-graph search engine (PRD-012a).
+ *
+ * Runs guarded lexical ILIKE + optional `<#>` vector semantic search over
+ * `hive_graph_versions`, filtered to the latest described version per nectar.
+ * Mirrors honeycomb recall arm mechanics without importing honeycomb (decision #2).
+ */
+import { EMBED_DIMS, isValidEmbedding } from "./model.js";
+import { HIVE_GRAPH_VERSIONS_TABLE } from "./schema.js";
+import { isMissingTableError } from "./deeplake-heal.js";
+import { TransportError } from "./deeplake-transport.js";
+import { sLiteral, sqlFloat4Array, sqlIdent, sqlLike } from "./sql-guards.js";
+/** Default result cap when the caller omits `limit` (decision #34). */
+export const DEFAULT_RECALL_LIMIT = 20;
+/** Hard ceiling on search hits (fat-finger guard). */
+export const MAX_RECALL_LIMIT = 200;
+/** RRF constant `k` (mirrors honeycomb recall). */
+export const RRF_K = 60;
+/**
+ * Default recall RRF multiplier when `~/.honeycomb/nectar.json`'s
+ * `nectar_rrf_multiplier` knob is unset (PRD-018k / NEC-041). `1` is neutral:
+ * this standalone two-arm engine applies no cross-arm class weighting
+ * (PRD-012a), so the multiplier is a config surface for a future cross-table
+ * fusion arm, not a value that alters fusion today.
+ */
+export const DEFAULT_RRF_MULTIPLIER = 1;
+/** Vector arm over-fetch multiplier (mirrors honeycomb `vector.ts`). */
+export const DEFAULT_OVERFETCH_MULTIPLIER = 3;
+const HIVE_GRAPH_VERSIONS = sqlIdent(HIVE_GRAPH_VERSIONS_TABLE.name);
+const SOURCE_NECTAR = "nectar";
+const SEMANTIC_ARM = "semantic";
+const LEXICAL_ARM = "lexical";
+/**
+ * Resolve the effective recall RRF multiplier from the search deps (PRD-018k /
+ * NEC-041 AC-018k.7): the loaded `nectar_rrf_multiplier` value when it is a
+ * finite positive number, else {@link DEFAULT_RRF_MULTIPLIER}. This is where the
+ * config knob plugs into the recall path; fusion does not yet weight by it.
+ */
+export function resolveRrfMultiplier(deps) {
+    const m = deps.rrfMultiplier;
+    return typeof m === "number" && Number.isFinite(m) && m > 0 ? m : DEFAULT_RRF_MULTIPLIER;
+}
+/** Clamp a caller-supplied limit into `[1, MAX_RECALL_LIMIT]`, defaulting a missing/bad value. */
+export function resolveRecallLimit(limit) {
+    if (typeof limit !== "number" || !Number.isFinite(limit))
+        return DEFAULT_RECALL_LIMIT;
+    const truncated = Math.trunc(limit);
+    if (truncated < 1)
+        return DEFAULT_RECALL_LIMIT;
+    return Math.min(truncated, MAX_RECALL_LIMIT);
+}
+function cell(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function tenancyPredicate(scope, prefix = "") {
+    const p = prefix === "" ? "" : `${prefix}.`;
+    return (`${p}${sqlIdent("org_id")} = ${sLiteral(scope.orgId)} AND ` +
+        `${p}${sqlIdent("workspace_id")} = ${sLiteral(scope.workspaceId)} AND ` +
+        `${p}${sqlIdent("project_id")} = ${sLiteral(scope.projectId)}`);
+}
+/**
+ * Latest described version per nectar (`MAX(seq)`), scoped by tenancy.
+ * Load-bearing shape from `recall-integration.md`.
+ */
+export function buildLatestDescribedSubquery(scope) {
+    const nectarCol = sqlIdent("nectar");
+    const seqCol = sqlIdent("seq");
+    const statusCol = sqlIdent("describe_status");
+    return (`SELECT ${nectarCol}, MAX(${seqCol}) AS max_seq ` +
+        `FROM "${HIVE_GRAPH_VERSIONS}" ` +
+        `WHERE ${statusCol} = ${sLiteral("described")} AND ${tenancyPredicate(scope)} ` +
+        `GROUP BY ${nectarCol}`);
+}
+/**
+ * Guarded lexical arm over `title`, `description`, and `concepts` with the
+ * latest-per-nectar join. Exported for injection-safety tests.
+ */
+export function buildHiveGraphLexicalArmSql(term, scope, perArmLimit) {
+    const pattern = `'%${sqlLike(term)}%'`;
+    const latest = buildLatestDescribedSubquery(scope);
+    const perArm = Math.max(1, Math.trunc(perArmLimit));
+    const nectarCol = sqlIdent("nectar");
+    const seqCol = sqlIdent("seq");
+    const pathCol = sqlIdent("path");
+    const titleCol = sqlIdent("title");
+    const descCol = sqlIdent("description");
+    const conceptsCol = sqlIdent("concepts");
+    const hashCol = sqlIdent("content_hash");
+    // NEC-042 item 5 / AC-018l.12: `sqlLike` emits backslash escapes for `%`/`_`/`\`
+    // inside a plain literal, but whether `\%` is honored as a literal is
+    // dialect-dependent WITHOUT an explicit ESCAPE clause. Declaring `ESCAPE '\'`
+    // on every ILIKE pins the backslash as the escape char, so an escaped
+    // metacharacter can never widen the match. Applied to every ILIKE (the WHERE
+    // arm and the ORDER BY ranking) so match and ranking agree.
+    const like = (col) => `${col} ILIKE ${pattern} ESCAPE '\\'`;
+    return (`SELECT ${sLiteral(SOURCE_NECTAR)} AS source, v.${nectarCol} AS id, v.${pathCol} AS path, ` +
+        `v.${titleCol} AS title, v.${descCol} AS body, v.${conceptsCol} AS concepts, v.${hashCol} AS content_hash ` +
+        `FROM "${HIVE_GRAPH_VERSIONS}" v ` +
+        `INNER JOIN (${latest}) latest ON v.${nectarCol} = latest.${nectarCol} AND v.${seqCol} = latest.max_seq ` +
+        `WHERE (${like(`v.${titleCol}`)} OR ${like(`v.${descCol}`)} OR ${like(`v.${conceptsCol}`)}) ` +
+        `AND ${tenancyPredicate(scope, "v")} ` +
+        `ORDER BY CASE ` +
+        `WHEN ${like(`v.${titleCol}`)} THEN 0 ` +
+        `WHEN ${like(`v.${descCol}`)} THEN 1 ` +
+        `WHEN ${like(`v.${conceptsCol}`)} THEN 2 ` +
+        `ELSE 3 END ASC, v.${nectarCol} ASC ` +
+        `LIMIT ${perArm}`);
+}
+/** Step 1 of the semantic arm: `<#>` cosine match returning scored nectar ids only. */
+export function buildHiveGraphVectorSearchSql(queryVector, scope, perArmLimit, overFetchMultiplier = DEFAULT_OVERFETCH_MULTIPLIER) {
+    assertQueryVectorDim(queryVector);
+    const latest = buildLatestDescribedSubquery(scope);
+    const vecLit = sqlFloat4Array(queryVector);
+    const nectarCol = sqlIdent("nectar");
+    const seqCol = sqlIdent("seq");
+    const embCol = sqlIdent("embedding");
+    const fetchLimit = Math.max(1, Math.trunc(perArmLimit)) * Math.max(1, Math.trunc(overFetchMultiplier));
+    // `<#>` between a FLOAT4[] column and a FLOAT4[] literal is cosine
+    // SIMILARITY on this backend, sorted DESC (official pg_deeplake SQL
+    // reference, docs.deeplake.ai "The <#> operator" table), and the live probe
+    // in test/hive-graph-search-live.test.ts confirms the near vector ranks
+    // first under this formula. The corpus's earlier "cosine distance, ascend"
+    // phrasing was wrong (NEC-005); the docs pass corrects it. Mapping
+    // similarity [-1, 1] to score [0, 1] preserves DESC = most similar first.
+    const scoreSql = `((1 + (v.${embCol} <#> ${vecLit})) / 2)`;
+    const embedModelCol = sqlIdent("embed_model");
+    return (`SELECT v.${nectarCol} AS id, ${scoreSql} AS score, v.${embedModelCol} AS embed_model ` +
+        `FROM "${HIVE_GRAPH_VERSIONS}" v ` +
+        `INNER JOIN (${latest}) latest ON v.${nectarCol} = latest.${nectarCol} AND v.${seqCol} = latest.max_seq ` +
+        `WHERE ARRAY_LENGTH(v.${embCol}, 1) > 0 AND ${tenancyPredicate(scope, "v")} ` +
+        `ORDER BY score DESC ` +
+        `LIMIT ${fetchLimit}`);
+}
+/** Step 2 of the semantic arm: hydrate matched nectars' display columns. */
+export function buildHiveGraphHydrateSql(ids, scope) {
+    if (ids.length === 0) {
+        throw new Error("buildHiveGraphHydrateSql requires at least one id");
+    }
+    const latest = buildLatestDescribedSubquery(scope);
+    const inList = ids.map((id) => sLiteral(id)).join(", ");
+    const nectarCol = sqlIdent("nectar");
+    const seqCol = sqlIdent("seq");
+    const pathCol = sqlIdent("path");
+    const titleCol = sqlIdent("title");
+    const descCol = sqlIdent("description");
+    const conceptsCol = sqlIdent("concepts");
+    const hashCol = sqlIdent("content_hash");
+    return (`SELECT ${sLiteral(SOURCE_NECTAR)} AS source, v.${nectarCol} AS id, v.${pathCol} AS path, ` +
+        `v.${titleCol} AS title, v.${descCol} AS body, v.${conceptsCol} AS concepts, v.${hashCol} AS content_hash ` +
+        `FROM "${HIVE_GRAPH_VERSIONS}" v ` +
+        `INNER JOIN (${latest}) latest ON v.${nectarCol} = latest.${nectarCol} AND v.${seqCol} = latest.max_seq ` +
+        `WHERE v.${nectarCol} IN (${inList}) AND ${tenancyPredicate(scope, "v")}`);
+}
+function assertQueryVectorDim(vector) {
+    if (vector.length !== EMBED_DIMS) {
+        throw new Error(`Query vector must be ${EMBED_DIMS}-dim; got ${vector.length}`);
+    }
+    for (const v of vector) {
+        if (!Number.isFinite(v)) {
+            throw new Error(`Query vector must be ${EMBED_DIMS}-dim; got non-finite entry`);
+        }
+    }
+}
+function rowToHit(row) {
+    const id = cell(row.id);
+    if (id === "")
+        return null;
+    const source = cell(row.source);
+    if (source !== SOURCE_NECTAR && source !== "")
+        return null;
+    return {
+        source: SOURCE_NECTAR,
+        id,
+        path: cell(row.path),
+        title: cell(row.title),
+        body: cell(row.body),
+        concepts: cell(row.concepts),
+        content_hash: cell(row.content_hash),
+    };
+}
+function fusionKey(source, id) {
+    return `${source}\0${id}`;
+}
+/** RRF fusion scoped to this engine's two arms (no cross-table arm-class weighting). */
+function fuseHits(arms, limit) {
+    const docs = new Map();
+    for (const arm of arms) {
+        arm.entries.forEach((entry, index) => {
+            const rank = index + 1;
+            const contribution = 1 / (RRF_K + rank);
+            const key = fusionKey(entry.hit.source, entry.hit.id);
+            const existing = docs.get(key);
+            if (existing === undefined) {
+                docs.set(key, { hit: entry.hit, score: contribution });
+            }
+            else {
+                existing.score += contribution;
+            }
+        });
+    }
+    const ordered = [...docs.values()].sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.hit.id < b.hit.id ? -1 : a.hit.id > b.hit.id ? 1 : 0;
+    });
+    const hits = [];
+    for (const doc of ordered) {
+        if (hits.length >= limit)
+            break;
+        hits.push(doc.hit);
+    }
+    const sources = hits.length > 0 ? [SOURCE_NECTAR] : [];
+    return { hits, sources };
+}
+function rowsToRankedArm(rows) {
+    const entries = [];
+    for (const row of rows) {
+        const hit = rowToHit(row);
+        if (hit !== null)
+            entries.push({ hit });
+    }
+    return { entries };
+}
+function armOk(rows) {
+    return { status: "ok", rows: rows.length };
+}
+function armNotRun(reason) {
+    return { status: "not-run", rows: 0, reason };
+}
+function errorReason(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function classifyArmFailure(err) {
+    const reason = errorReason(err);
+    if (err instanceof TransportError && isMissingTableError(err)) {
+        return { status: "missing-table", rows: 0, reason };
+    }
+    if (err instanceof Error && /table does not exist|no such table/i.test(err.message)) {
+        return { status: "missing-table", rows: 0, reason };
+    }
+    return { status: "error", rows: 0, reason };
+}
+function resultReason(hits, semanticStatus, lexicalStatus) {
+    if (semanticStatus.status === "error" || lexicalStatus.status === "error")
+        return "backend-error";
+    if (hits.length > 0 && semanticStatus.status === "not-run")
+        return "semantic-unavailable";
+    if (hits.length > 0)
+        return "ok";
+    if (semanticStatus.status === "missing-table" || lexicalStatus.status === "missing-table")
+        return "missing-table";
+    return "no-matches";
+}
+function errorSources(semanticStatus, lexicalStatus) {
+    const sources = [];
+    if (semanticStatus.status === "error")
+        sources.push(SEMANTIC_ARM);
+    if (lexicalStatus.status === "error")
+        sources.push(LEXICAL_ARM);
+    return sources;
+}
+/** Per-arm fail-soft: missing table or backend error returns a classified status. */
+async function runArmFailSoft(storage, sql, scope, onSuccess) {
+    try {
+        const rows = [...(await storage.query(sql, scope))];
+        onSuccess?.();
+        return { rows, status: armOk(rows) };
+    }
+    catch (err) {
+        return { rows: [], status: classifyArmFailure(err) };
+    }
+}
+async function resolveQueryVector(query, embed) {
+    if (embed === undefined)
+        return null;
+    try {
+        const vec = await embed.embed(query);
+        if (vec === null || !isValidEmbedding(vec))
+            return null;
+        return vec;
+    }
+    catch {
+        return null;
+    }
+}
+function parseScoredIds(rows) {
+    const out = [];
+    for (const row of rows) {
+        const id = cell(row.id);
+        if (id === "")
+            continue;
+        const rawScore = typeof row.score === "number" ? row.score : Number(row.score);
+        const score = Number.isFinite(rawScore) ? Math.min(1, Math.max(0, rawScore)) : 0;
+        const embedModel = typeof row.embed_model === "string" && row.embed_model !== "" ? row.embed_model : null;
+        out.push({ id, score, embedModel });
+    }
+    return out;
+}
+/**
+ * Partition scored rows into ones that may contribute to the vector arm and ones
+ * whose stored embedding model disagrees with the active provider (PRD-018i /
+ * NEC-018 AC-018i.3). A null `embed_model` (pre-provenance row) is treated as
+ * compatible; only a non-null model that differs is a cross-space mismatch.
+ */
+function partitionByEmbedModel(scored, activeEmbedModel) {
+    if (activeEmbedModel === undefined)
+        return { usable: [...scored], mismatched: [] };
+    const usable = [];
+    const mismatched = [];
+    for (const s of scored) {
+        if (s.embedModel !== null && s.embedModel !== activeEmbedModel)
+            mismatched.push(s.id);
+        else
+            usable.push(s);
+    }
+    return { usable, mismatched };
+}
+/**
+ * Semantic arm: vectorSearch (scored ids) then hydrate (second guarded query),
+ * preserving cosine rank order.
+ */
+async function runSemanticArm(storage, scope, queryVector, perArmLimit, activeEmbedModel, onReembedNeeded, onSuccess) {
+    const scoreSql = buildHiveGraphVectorSearchSql(queryVector, scope, perArmLimit);
+    const scoreResult = await runArmFailSoft(storage, scoreSql, scope, onSuccess);
+    if (scoreResult.status.status !== "ok") {
+        return { entries: [], status: scoreResult.status };
+    }
+    const allScored = parseScoredIds(scoreResult.rows);
+    // AC-018i.3: exclude rows whose stored embed_model disagrees with the active
+    // provider, and queue those nectars for re-embedding so the index converges.
+    const { usable: scored, mismatched } = partitionByEmbedModel(allScored, activeEmbedModel);
+    if (mismatched.length > 0 && onReembedNeeded !== undefined) {
+        try {
+            onReembedNeeded(mismatched);
+        }
+        catch {
+            // fail-soft: a faulty re-embed sink never breaks the search path.
+        }
+    }
+    if (scored.length === 0)
+        return { entries: [], status: armOk([]) };
+    const ids = scored.map((s) => s.id).filter((id) => id !== "");
+    if (ids.length === 0)
+        return { entries: [], status: armOk([]) };
+    const hydrateResult = await runArmFailSoft(storage, buildHiveGraphHydrateSql(ids, scope), scope, onSuccess);
+    if (hydrateResult.status.status !== "ok") {
+        return { entries: [], status: hydrateResult.status };
+    }
+    const hitById = new Map();
+    for (const row of hydrateResult.rows) {
+        const hit = rowToHit(row);
+        if (hit !== null)
+            hitById.set(hit.id, hit);
+    }
+    const entries = [];
+    const seen = new Set();
+    for (const s of scored) {
+        if (seen.has(s.id))
+            continue;
+        const hit = hitById.get(s.id);
+        if (hit === undefined)
+            continue;
+        seen.add(s.id);
+        entries.push({ hit });
+    }
+    return { entries, status: { status: "ok", rows: entries.length } };
+}
+/**
+ * Search the hive graph: guarded lexical + optional semantic arms fused by RRF.
+ *
+ * @param query - Search term (trimmed; empty returns the empty/degraded floor).
+ * @param scope - Tenancy + soft project filter applied in SQL.
+ * @param limit - Result cap; defaults to {@link DEFAULT_RECALL_LIMIT}.
+ * @param deps - Storage query seam + optional embed client.
+ */
+export async function searchHiveGraph(query, scope, limit, deps) {
+    const term = query.trim();
+    const resolvedLimit = resolveRecallLimit(limit);
+    if (term === "") {
+        return { hits: [], sources: [], degraded: true };
+    }
+    const queryVector = await resolveQueryVector(term, deps.embed);
+    const semanticRan = queryVector !== null;
+    const queryArm = async (sql) => {
+        const result = await runArmFailSoft(deps.storage, sql, scope);
+        return result;
+    };
+    const [semanticResult, lexicalResult] = await Promise.all([
+        semanticRan && queryVector !== null
+            ? runSemanticArm(deps.storage, scope, queryVector, resolvedLimit, deps.activeEmbedModel, deps.onReembedNeeded)
+            : Promise.resolve({ entries: [], status: armNotRun("query embedding unavailable") }),
+        queryArm(buildHiveGraphLexicalArmSql(term, scope, resolvedLimit)),
+    ]);
+    const arms = [];
+    if (semanticResult.entries.length > 0) {
+        arms.push({ entries: semanticResult.entries });
+    }
+    else if (semanticRan) {
+        arms.push({ entries: [] });
+    }
+    arms.push(rowsToRankedArm(lexicalResult.rows));
+    const { hits, sources } = fuseHits(arms, resolvedLimit);
+    const errors = errorSources(semanticResult.status, lexicalResult.status);
+    const degraded = !semanticRan || errors.length > 0;
+    return {
+        hits,
+        sources,
+        degraded,
+        reason: resultReason(hits, semanticResult.status, lexicalResult.status),
+        errorSources: errors,
+        arms: {
+            semantic: semanticResult.status,
+            lexical: lexicalResult.status,
+        },
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/hive-graph/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/hive-graph/search.ts"],"names":[],"mappings":"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"}