@untangle-code/search 0.0.0-stage → 0.1.1

package/dist/bm25.js

@@ -0,0 +1,105 @@
+/**
+ * Deterministisches Okapi BM25 ueber den Kandidatenpool des Abrufkerns.
+ *
+ * WARUM EIGEN UND NICHT AUS DEM SPEICHER: Der `VectorStore` liefert im
+ * spaerlichen Zweig einen Rang, den der Speicher berechnet hat (bei Qdrant
+ * mit seiner eigenen IDF-Statistik ueber die ganze Collection). Dieser Rang
+ * ist ausgezeichnet fuer den ABRUF (Recall), aber er ist nicht in diesem
+ * Prozess nachrechenbar und aendert sich mit dem Speicherstand. Die
+ * Score-Zerlegung soll erklaeren, WARUM ein Treffer rankt — dafuer muss der
+ * lexikalische Anteil hier berechenbar sein. Deshalb:
+ *
+ * - der Speicher liefert KANDIDATEN (dichter und spaerlicher Zweig),
+ * - der lexikalische RANG entsteht in diesem Modul, mit den Statistiken des
+ *   Kandidatenpools.
+ *
+ * Der Preis dieser Entscheidung ist benannt und nicht wegdiskutiert: IDF
+ * ueber den Kandidatenpool ist nicht IDF ueber das ganze Korpus. Bei kleinen
+ * Pools kann ein Wort dadurch seltener aussehen, als es ist. Der Pool ist
+ * `candidateLimit` gross (Default 50, Maximum 200) und damit gross genug fuer
+ * eine stabile Ordnung INNERHALB des Pools — und nur diese Ordnung geht in
+ * die Fusion ein, nicht der absolute Wert. Siehe README „Bekannte Grenzen".
+ *
+ * Konstanten: k1 = 1.2, b = 0.75 — die Standardwerte aus Robertson/Sparck
+ * Jones. Sie sind hier keine „magischen Gewichte", sondern die dokumentierte
+ * Voreinstellung des Verfahrens; abweichende Werte muessten begruendet werden.
+ */
+import { compareCodepoints } from "@untangle-code/domain";
+import { informativeQueryTokens, termFrequencies, tokenizeIdentifiers } from "./tokenize.js";
+/** Saettigungskonstante der Termhaeufigkeit (Standardwert). */
+export const BM25_K1 = 1.2;
+/** Laengennormalisierung (Standardwert). */
+export const BM25_B = 0.75;
+/**
+ * BM25 ueber eine feste Dokumentmenge. Die Statistiken werden EINMAL im
+ * Konstruktor gebildet; danach ist `score()` eine reine Funktion.
+ */
+export class Bm25Ranker {
+    k1;
+    b;
+    documents = [];
+    documentFrequency = new Map();
+    averageLength;
+    constructor(documents, k1 = BM25_K1, b = BM25_B) {
+        this.k1 = k1;
+        this.b = b;
+        let totalLength = 0;
+        for (const document of documents) {
+            const tokens = tokenizeIdentifiers(document.text);
+            const frequencies = termFrequencies(tokens);
+            this.documents.push({ id: document.id, frequencies, length: tokens.length });
+            totalLength += tokens.length;
+            for (const term of frequencies.keys()) {
+                this.documentFrequency.set(term, (this.documentFrequency.get(term) ?? 0) + 1);
+            }
+        }
+        this.averageLength = this.documents.length === 0 ? 1 : totalLength / this.documents.length;
+    }
+    get documentCount() {
+        return this.documents.length;
+    }
+    /**
+     * Inverse Dokumenthaeufigkeit in der geglaetteten Form
+     * `ln(1 + (N - df + 0.5) / (df + 0.5))` — immer positiv, damit ein in jedem
+     * Dokument vorkommender Term den Score nicht negativ macht.
+     */
+    inverseDocumentFrequency(term) {
+        const df = this.documentFrequency.get(term) ?? 0;
+        const n = this.documents.length;
+        return Math.log(1 + (n - df + 0.5) / (df + 0.5));
+    }
+    scoreDocument(queryTerms, document) {
+        let total = 0;
+        for (const term of queryTerms) {
+            const tf = document.frequencies.get(term) ?? 0;
+            if (tf === 0) {
+                continue;
+            }
+            const numerator = tf * (this.k1 + 1);
+            const denominator = tf + this.k1 * (1 - this.b + this.b * (document.length / this.averageLength));
+            total += this.inverseDocumentFrequency(term) * (numerator / denominator);
+        }
+        return total;
+    }
+    /**
+     * Rangliste zu einem Suchtext. Dokumente mit Score 0 (kein Term getroffen)
+     * fallen heraus — sie haben lexikalisch nichts beigetragen und duerfen die
+     * Fusion nicht mit einem Scheinrang beeinflussen.
+     *
+     * Gleichstand wird deterministisch nach Codepoints der ID aufgeloest, nie
+     * nach Einfuegereihenfolge und nie ueber `localeCompare`.
+     */
+    rank(queryText) {
+        const queryTerms = [...termFrequencies(informativeQueryTokens(queryText)).keys()];
+        const scored = [];
+        for (const document of this.documents) {
+            const score = this.scoreDocument(queryTerms, document);
+            if (score > 0) {
+                scored.push({ id: document.id, score });
+            }
+        }
+        scored.sort((a, b) => a.score === b.score ? compareCodepoints(a.id, b.id) : b.score - a.score);
+        return scored.map((entry, index) => ({ id: entry.id, score: entry.score, rank: index + 1 }));
+    }
+}
+//# sourceMappingURL=bm25.js.map

package/dist/bm25.js.map

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

package/dist/deadline.d.ts

@@ -0,0 +1,4 @@
+import { type PortCallOptions } from "@untangle-code/domain";
+/** Bound hybrid branches and propagate outer cancellation even if an adapter hangs. */
+export declare function withSearchBranchDeadline<T>(branch: "dense" | "sparse" | "symbol", timeoutMs: number | undefined, retrieve: (options: PortCallOptions) => Promise<T>, options?: PortCallOptions, storeFailureCode?: "QDRANT_UNAVAILABLE" | "LANCEDB_UNAVAILABLE"): Promise<T>;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,uFAAuF;AACvF,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,EACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,EAClD,OAAO,CAAC,EAAE,eAAe,EACzB,gBAAgB,GAAE,oBAAoB,GAAG,qBAA4C,GACpF,OAAO,CAAC,CAAC,CAAC,CAiDZ"}

package/dist/deadline.js

@@ -0,0 +1,54 @@
+import { UntangleError } from "@untangle-code/domain";
+/** Bound hybrid branches and propagate outer cancellation even if an adapter hangs. */
+export async function withSearchBranchDeadline(branch, timeoutMs, retrieve, options, storeFailureCode = "QDRANT_UNAVAILABLE") {
+    options?.signal?.throwIfAborted();
+    const controller = new AbortController();
+    let timeoutError;
+    let timer;
+    let onAbort;
+    const interrupted = new Promise((_, reject) => {
+        onAbort = () => {
+            const reason = options?.signal?.reason;
+            reject(reason);
+            controller.abort(reason);
+        };
+        options?.signal?.addEventListener("abort", onAbort, { once: true });
+        if (timeoutMs !== undefined) {
+            timer = setTimeout(() => {
+                timeoutError = new UntangleError(branch === "dense" ? "EMBEDDING_UNAVAILABLE" : storeFailureCode, `retrieval branch "${branch}" exceeded its ${String(timeoutMs)}ms deadline`, {
+                    operation: "search_branch",
+                    retryable: true,
+                    context: { branch, timeoutMs, timedOut: true },
+                });
+                // Reject before notifying the adapter: an adapter's JOB_CANCELLED is
+                // caused by this local deadline and must not cancel successful peers.
+                reject(timeoutError);
+                controller.abort(timeoutError);
+            }, timeoutMs);
+        }
+    });
+    try {
+        // Promise.race installs handlers on both promises, including a late
+        // adapter rejection after a deadline. It cannot become unhandled.
+        return await Promise.race([
+            Promise.resolve().then(() => {
+                controller.signal.throwIfAborted();
+                return retrieve({ ...options, signal: controller.signal });
+            }),
+            interrupted,
+        ]);
+    }
+    catch (error) {
+        options?.signal?.throwIfAborted();
+        if (timeoutError !== undefined)
+            throw timeoutError;
+        throw error;
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (onAbort !== undefined)
+            options?.signal?.removeEventListener("abort", onAbort);
+    }
+}
+//# sourceMappingURL=deadline.js.map

package/dist/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,uBAAuB,CAAC;AAE5E,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAqC,EACrC,SAA6B,EAC7B,QAAkD,EAClD,OAAyB,EACzB,mBAAiE,oBAAoB;IAErF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,YAAuC,CAAC;IAC5C,IAAI,KAAgD,CAAC;IACrD,IAAI,OAAiC,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACnD,OAAO,GAAG,GAAG,EAAE;YACb,MAAM,MAAM,GAAY,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,CAAC;YACf,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,YAAY,GAAG,IAAI,aAAa,CAC9B,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,EAC/D,qBAAqB,MAAM,kBAAkB,MAAM,CAAC,SAAS,CAAC,aAAa,EAC3E;oBACE,SAAS,EAAE,eAAe;oBAC1B,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC/C,CACF,CAAC;gBACF,qEAAqE;gBACrE,sEAAsE;gBACtE,MAAM,CAAC,YAAY,CAAC,CAAC;gBACrB,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,oEAAoE;QACpE,kEAAkE;QAClE,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1B,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACnC,OAAO,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC,CAAC;YACF,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAClC,IAAI,YAAY,KAAK,SAAS;YAAE,MAAM,YAAY,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/dedupe.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Deduplizierung (spec.md §13.5, architecture.md §18.4).
+ *
+ * Mehrere Fragmente desselben Symbols duerfen nicht alle Top-Plaetze belegen.
+ * Der Dedupe-Schluessel ist woertlich der aus architecture.md §18.4:
+ *
+ *     workspace_id + repo_id + ref_id + metrics_scope_id
+ *
+ * Der Ref gehoert bewusst hinein: derselbe Code in zwei Branches oder zwei
+ * Worktrees sind ZWEI Antworten, nicht eine — wer ueber mehrere Refs sucht,
+ * will beide sehen, jeweils mit ihrer Herkunft (vision.md §1a „Branch- und
+ * Worktree-Bewusstsein").
+ *
+ * Verbunden werden die Bestandteile mit `ID_COMPONENT_SEPARATOR` (U+001F),
+ * derselben Trennzeichenkonvention wie bei allen Untangle-IDs — ein Pfad oder
+ * Name kann so keinen Schluessel „ueberlaufen" lassen.
+ */
+import type { CodeChunkPayloadV1, RelatedFragmentV1 } from "@untangle-code/domain";
+import type { SearchCandidate } from "./payload.js";
+/** Baut den Dedupe-Schluessel eines Chunk-Payloads. */
+export declare function buildDedupeKey(payload: CodeChunkPayloadV1): string;
+/** Ein Kandidat mit seinem Basisscore, wie ihn die Fusion geliefert hat. */
+export interface ScoredCandidate {
+    candidate: SearchCandidate;
+    /** Normalisierter Basisscore aus der Fusion, in [0, 1]. */
+    baseScore: number;
+}
+/** Ergebnis der Deduplizierung einer Gruppe. */
+export interface DedupedCandidate {
+    primary: ScoredCandidate;
+    dedupeKey: string;
+    relatedFragments: RelatedFragmentV1[];
+    /** Die verdraengten Kandidaten — fuer den Skip-Ledger (E4). */
+    absorbed: ScoredCandidate[];
+}
+/**
+ * Fasst Kandidaten mit gleichem Dedupe-Schluessel zusammen.
+ *
+ * Primaer bleibt der bestbewertete; bei Gleichstand entscheidet die
+ * Codepoint-Ordnung der Chunk-ID — nie die Reihenfolge, in der der Speicher
+ * geantwortet hat.
+ *
+ * Die Eingabereihenfolge bleibt fuer die Ausgabe massgeblich: die Gruppen
+ * erscheinen in der Reihenfolge ihres ersten Vorkommens, damit die Rangfolge
+ * der Fusion erhalten bleibt.
+ */
+export declare function dedupeCandidates(scored: readonly ScoredCandidate[]): DedupedCandidate[];
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAIlE;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,eAAe,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,gBAAgB,EAAE,CAuBvF"}

package/dist/dedupe.js

@@ -0,0 +1,58 @@
+import { ID_COMPONENT_SEPARATOR, compareCodepoints } from "@untangle-code/domain";
+/** Baut den Dedupe-Schluessel eines Chunk-Payloads. */
+export function buildDedupeKey(payload) {
+    return [payload.workspace_id, payload.repo_id, payload.ref_id, payload.metrics_scope_id].join(ID_COMPONENT_SEPARATOR);
+}
+/**
+ * Fasst Kandidaten mit gleichem Dedupe-Schluessel zusammen.
+ *
+ * Primaer bleibt der bestbewertete; bei Gleichstand entscheidet die
+ * Codepoint-Ordnung der Chunk-ID — nie die Reihenfolge, in der der Speicher
+ * geantwortet hat.
+ *
+ * Die Eingabereihenfolge bleibt fuer die Ausgabe massgeblich: die Gruppen
+ * erscheinen in der Reihenfolge ihres ersten Vorkommens, damit die Rangfolge
+ * der Fusion erhalten bleibt.
+ */
+export function dedupeCandidates(scored) {
+    const groups = new Map();
+    for (const entry of scored) {
+        const key = buildDedupeKey(entry.candidate.payload);
+        const existing = groups.get(key);
+        if (existing === undefined) {
+            groups.set(key, [entry]);
+        }
+        else {
+            existing.push(entry);
+        }
+    }
+    return [...groups].map(([key, group]) => {
+        const members = [...group].sort(compareScored);
+        const primary = members[0];
+        const absorbed = members.slice(1);
+        return {
+            primary,
+            dedupeKey: key,
+            absorbed,
+            relatedFragments: absorbed.map((member) => toRelatedFragment(member)),
+        };
+    });
+}
+function compareScored(a, b) {
+    if (a.baseScore !== b.baseScore) {
+        return b.baseScore - a.baseScore;
+    }
+    return compareCodepoints(a.candidate.payload.chunk_id, b.candidate.payload.chunk_id);
+}
+function toRelatedFragment(entry) {
+    const { payload } = entry.candidate;
+    return {
+        chunkId: payload.chunk_id,
+        chunkKind: payload.chunk_kind,
+        ...(payload.fragment_index === undefined ? {} : { fragmentIndex: payload.fragment_index }),
+        startLine: payload.start_line,
+        endLine: payload.end_line,
+        score: entry.baseScore,
+    };
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIlF,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAC3F,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAkBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkC;IACjE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAoB,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO;YACL,OAAO;YACP,SAAS,EAAE,GAAG;YACd,QAAQ;YACR,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,CAAkB,EAAE,CAAkB;IAC3D,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,OAAO,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAsB;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1F,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,KAAK,EAAE,KAAK,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC"}

package/dist/diversify.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Diversifizierung (spec.md §13.2 Schritt 10, architecture.md §18.5).
+ *
+ * Ziel ist der Fall „zehn nahezu identische Treffer derselben Datei". Nach der
+ * Deduplizierung ueber `metrics_scope_id` bleiben immer noch mehrere Symbole
+ * derselben Datei uebrig — und wer nach „Funktion X" sucht, will nicht
+ * zehnmal dieselbe Datei sehen, sondern die zehn besten STELLEN.
+ *
+ * Verfahren (bewusst ohne Inhaltsvektoren): Die Liste wird in Rangfolge
+ * durchlaufen; jeder Treffer bekommt eine Strafe, die davon abhaengt, wie oft
+ * seine Datei (und, schwaecher, sein Repository) vorher schon vertreten war:
+ *
+ *     strafe(n) = 1 - 1 / (1 + n)
+ *
+ * mit `n` = Zahl der vorher schon vertretenen Treffer derselben Datei. Der
+ * erste Treffer einer Datei bekommt also 0, der zweite 0.5, der dritte 0.667 —
+ * eine saettigende Kurve, die nie 1 erreicht. Damit verschwindet keine Datei
+ * vollstaendig aus dem Ergebnis; sie wird nur immer teurer.
+ *
+ * Warum keine Content-MMR: dafuer braeuchte es die dichten Vektoren aller
+ * Kandidaten. Der `VectorStore`-Port liefert sie beim Suchen nicht mit
+ * (`hybridQuery` gibt Payload, keine Vektoren), und sie nachzuladen kostet
+ * eine zweite Runde ueber den Speicher. Die datei-/repo-basierte Streuung ist
+ * die Dimension, die architecture.md §18.5 zuerst nennt, und sie kostet nichts.
+ * Der Verzicht auf die Content-Dimension steht in der README unter „Bekannte
+ * Grenzen".
+ */
+import type { CodeChunkPayloadV1 } from "@untangle-code/domain";
+/** Anteil der Datei-Strafe, den ein reiner Repo-Wiederholer bekommt. */
+export declare const REPO_REPETITION_SHARE = 0.25;
+/** Ein Eintrag der Diversifizierung: Gegenstand plus zugeteilte Strafe. */
+export interface DiversificationEntry<T> {
+    item: T;
+    /** Rohwert der `duplicate_penalty` in [0, 1). */
+    penaltyRawValue: number;
+}
+/**
+ * Berechnet die Duplikatsstrafen in Rangfolge.
+ *
+ * Die Funktion sortiert NICHT um — sie bewertet nur. Die Neuordnung passiert
+ * spaeter ueber den fertigen Endscore, damit jede Verschiebung in der
+ * Score-Zerlegung sichtbar ist statt in einem unsichtbaren Sortierschritt.
+ */
+export declare function assignDuplicatePenalties<T>(items: readonly T[], payloadOf: (item: T) => CodeChunkPayloadV1): DiversificationEntry<T>[];
+//# sourceMappingURL=diversify.d.ts.map

package/dist/diversify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diversify.d.ts","sourceRoot":"","sources":["../src/diversify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC;IACR,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,kBAAkB,GACzC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAgB3B"}

package/dist/diversify.js

@@ -0,0 +1,30 @@
+import { ID_COMPONENT_SEPARATOR } from "@untangle-code/domain";
+/** Anteil der Datei-Strafe, den ein reiner Repo-Wiederholer bekommt. */
+export const REPO_REPETITION_SHARE = 0.25;
+function saturatingPenalty(previousOccurrences) {
+    return 1 - 1 / (1 + previousOccurrences);
+}
+/**
+ * Berechnet die Duplikatsstrafen in Rangfolge.
+ *
+ * Die Funktion sortiert NICHT um — sie bewertet nur. Die Neuordnung passiert
+ * spaeter ueber den fertigen Endscore, damit jede Verschiebung in der
+ * Score-Zerlegung sichtbar ist statt in einem unsichtbaren Sortierschritt.
+ */
+export function assignDuplicatePenalties(items, payloadOf) {
+    const fileCounts = new Map();
+    const repoCounts = new Map();
+    return items.map((item) => {
+        const payload = payloadOf(item);
+        const repoKey = [payload.repo_id, payload.ref_id].join(ID_COMPONENT_SEPARATOR);
+        const fileKey = [repoKey, payload.file_id].join(ID_COMPONENT_SEPARATOR);
+        const previousFile = fileCounts.get(fileKey) ?? 0;
+        const previousRepo = repoCounts.get(repoKey) ?? 0;
+        fileCounts.set(fileKey, previousFile + 1);
+        repoCounts.set(repoKey, previousRepo + 1);
+        const filePenalty = saturatingPenalty(previousFile);
+        const repoPenalty = previousFile === 0 ? saturatingPenalty(previousRepo) * REPO_REPETITION_SHARE : 0;
+        return { item, penaltyRawValue: Math.min(1, filePenalty + repoPenalty) };
+    });
+}
+//# sourceMappingURL=diversify.js.map

package/dist/diversify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diversify.js","sourceRoot":"","sources":["../src/diversify.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAS1C,SAAS,iBAAiB,CAAC,mBAA2B;IACpD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAmB,EACnB,SAA0C;IAE1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACxE,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,WAAW,GACf,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Der hybride Abrufkern (spec.md §13.2; architecture.md §18; vision.md §1d).
+ *
+ * ABRUF UND RANGFOLGE SIND ZWEI VERSCHIEDENE DINGE — das ist die zentrale
+ * Bauentscheidung dieses Moduls und der Grund, warum sich der Suchmodus so
+ * einfach einschraenken laesst:
+ *
+ * - ABRUF (Recall) holt Kandidaten aus dem Speicher. Quellen: der dichte
+ *   Zweig (`hybridQuery` mit Query-Embedding), der spaerliche Zweig
+ *   (`hybridQuery` mit spaerlichem Vektor, sofern ein `SparseVectorizer`
+ *   gestellt wurde) und der Symbolzweig (`scroll` mit Filter auf
+ *   `symbol_name`).
+ * - RANGFOLGE entsteht danach IN DIESEM PROZESS: der dichte Rang aus den
+ *   Cosine-Scores des Speichers, der lexikalische Rang aus dem eigenen BM25
+ *   ueber den Kandidatenpool, der Symbolrang aus dem Namensvergleich. Diese
+ *   drei Ranglisten werden per RRF fusioniert (`fusion.ts`).
+ *
+ * Der Suchmodus waehlt Abruf UND Rangfolge: `semantic` fragt nur den
+ * dichten Zweig, `lexical` nur den spaerlichen, `symbol` nur den
+ * Symbolspeicher. Im Hybridmodus laufen die drei Zweige unabhaengig;
+ * ausgefallene Zweige duerfen nutzbare Antworten anderer Zweige nicht
+ * verhindern. Jede solche Teilsuche bleibt als Degradation sichtbar.
+ *
+ * E4 durchgaengig: jeder verworfene Kandidat — Nachfilter, `minScore`,
+ * Dedupe, `limit`, unbrauchbarer Payload, ausgefallenes Ziel — bekommt einen
+ * Eintrag im Skip-Ledger des Ergebnisses. Kein `catch`, das schweigt.
+ */
+import type { SearchConfig } from "@untangle-code/config";
+import type { Clock, LoggerPort, PayloadFilter, PortCallOptions, SearchQueryDefaults, SearchResultSetV1, VectorStore } from "@untangle-code/domain";
+import type { BranchWeights } from "./fusion.js";
+import type { FindabilityLookup, GraphProximityLookup, ProfileTargetV1, SearchGraphEnrichmentPort, SearchPort, SparseVectorizer } from "./port.js";
+import type { RelevancePolicyBindingV1 } from "./relevance.js";
+import type { GrepRequestV1, GrepResultSetV1, SearchQueryExtensionsV1, UntangleSearchRequestV1 } from "./types.js";
+/** Halbwertszeit des Recency-Boosts, wenn keine gesetzt ist. */
+export declare const DEFAULT_RECENCY_HALF_LIFE_DAYS = 30;
+/** Harte Grenze fuer freie Providerwarnungen und Batch-Diagnose-IDs. */
+export declare const SEARCH_GRAPH_DIAGNOSTIC_LIMIT = 32;
+/** Providerwarnungen sind eine eigene Ausgabeachse und deshalb separat gedeckelt. */
+export declare const SEARCH_GRAPH_PROVIDER_WARNING_LIMIT = 16;
+export declare const DEFAULT_SEARCH_BRANCH_TIMEOUT_MS = 10000;
+/** Alles, was der Abrufkern braucht — reine Ports und Daten, keine Adapter. */
+export interface HybridSearchEngineDeps {
+    vectorStore: VectorStore;
+    /** Ein Ziel je Embedding-Profil (spec.md §13.4). */
+    targets: ProfileTargetV1[];
+    /** Vorgaben aus der Konfiguration fuer `normalizeSearchQuery`. */
+    defaults: SearchQueryDefaults;
+    searchConfig?: SearchConfig;
+    /** Nur fuer den Recency-Boost noetig; ohne Clock entfaellt der Bestandteil. */
+    clock?: Clock;
+    logger?: LoggerPort;
+    /** Erzeugt spaerliche Anfragevektoren; siehe {@link SparseVectorizer}. */
+    sparseVectorizer?: SparseVectorizer;
+    /** Repo-Prioritaeten in [0, 1] fuer den `repo_priority_boost`. */
+    repoPriorities?: Record<string, number>;
+    graphProximity?: GraphProximityLookup;
+    /** Post-Ranking-Anreicherung; kennt als Port keine konkreten Graphpakete. */
+    graphEnrichment?: SearchGraphEnrichmentPort;
+    findability?: FindabilityLookup;
+    recencyHalfLifeDays?: number;
+    branchWeights?: BranchWeights;
+    /** Hybrid-only deadline per independent branch; single-mode uses caller cancellation. */
+    branchTimeoutMs?: number;
+    /**
+     * Profilgebundene Abwesenheitsentscheidungen. Eine leere Map behaelt das
+     * bisherige ungefilterte Verhalten. Ist die Map konfiguriert, aber fuer ein
+     * aktives Profil fehlt der Eintrag, bleibt die Trefferliste ebenfalls
+     * unveraendert und die Engine meldet die nicht ausgewertete Policy sichtbar.
+     */
+    relevancePolicies?: Readonly<Record<string, RelevancePolicyBindingV1>>;
+    /** Display-only legacy fallback; never accepted as persisted provenance. */
+    indexGeneration?: string;
+}
+/**
+ * Gibt dem PRAEZISIONSzweig bei einer zeichengleichen Symbolanfrage genug
+ * Basisgewicht, dass ein exakter Treffer selbst unter den erlaubten
+ * Boost-Grenzfaellen vor einem nicht-exakten Treffer bleibt.
+ *
+ * Bei MAX_BOOST_SHARE=0.5 kann ein nicht-exakter Basisscore hoechstens auf
+ * 1.5x steigen und ein exakter durch Strafen hoechstens auf 0.5x fallen. Das
+ * benoetigte Basisverhaeltnis ist daher (1+s)/(1-s)=3. Der kleine vorhandene
+ * Symbolanteil oberhalb dieser Grenze macht die Ungleichung strikt. Der
+ * Boost-Deckel selbst bleibt vollkommen unveraendert.
+ */
+export declare function exactSymbolIntentBranchWeights(weights: BranchWeights, active: {
+    dense: boolean;
+    lexical: boolean;
+    symbol: boolean;
+}): BranchWeights;
+/** Zahl dichter Spitzenplaetze, die einen lexikalischen Spitzenkandidaten bestaetigen. */
+export declare const GERMAN_LEXICAL_CORROBORATION_DEPTH = 10;
+/**
+ * Nur eine als deutsch erkannte Frage mit einem lexikalischen Spitzenreiter,
+ * der NICHT unter den zehn dicht besten Kandidaten vorkommt, verliert im
+ * Hybridmodus den lokalen BM25-Rang. Stimmen beide unabhaengigen Zweige
+ * ueberein, bleibt das nuetzliche lexikalische Signal erhalten.
+ */
+export declare function shouldOmitUncorroboratedGermanLexicalBranch(queryText: string, denseRankedIds: readonly string[], lexicalRankedIds: readonly string[]): boolean;
+/** Normalisiert die Zusatzfelder dieses Pakets (Gegenstueck zu `SearchQueryV1`). */
+export declare function normalizeExtensions(request: UntangleSearchRequestV1): SearchQueryExtensionsV1;
+/**
+ * Die Zusatzangaben, die den Fingerabdruck der Anfrage veraendern MUESSEN.
+ *
+ * Der Fingerabdruck beantwortet „ist das dieselbe Frage?". `mode`,
+ * `pathExcludes`, `complexityBias` und `sort` aendern die Treffermenge bzw.
+ * die Rangfolge — zwei Anfragen, die sich nur darin unterscheiden, sind NICHT
+ * dieselbe Frage. `includeContent` bleibt draussen: es aendert nur die
+ * Darstellung, genau wie `limit` und `candidateLimit` (siehe
+ * `buildSearchQueryFingerprint`).
+ *
+ * Nur ABWEICHUNGEN vom Standard gehen ein. Eine Anfrage ohne
+ * Paket-Erweiterungen behaelt damit exakt den Fingerabdruck, den sie ohne
+ * dieses Feld haette — Findability-Datensaetze aelterer Laeufe bleiben
+ * vergleichbar.
+ */
+export declare function fingerprintRankingOptions(extensions: SearchQueryExtensionsV1): Record<string, unknown> | undefined;
+/**
+ * Die Referenzimplementierung des {@link SearchPort}.
+ *
+ * Sie ist speicher-agnostisch: alles laeuft ueber den `VectorStore`-Port, also
+ * gegen Qdrant genauso wie gegen den In-Memory-Speicher des testkits.
+ */
+export declare class HybridSearchEngine implements SearchPort {
+    private readonly deps;
+    private readonly config;
+    private readonly branchWeights;
+    private readonly branchTimeoutMs;
+    private readonly relevancePolicies;
+    constructor(deps: HybridSearchEngineDeps);
+    search(request: UntangleSearchRequestV1, options?: PortCallOptions): Promise<SearchResultSetV1>;
+    private rankingContextFingerprint;
+    private enrichFinalHits;
+    /**
+     * grep laeuft im selben Geltungsbereich wie `search`: Workspace aus den
+     * Vorgaben, wenn die Anfrage keinen nennt, und nur die Repositories der
+     * verdrahteten Ziele. Sonst faende dieselbe Oberflaeche mit demselben
+     * Aufrufer je nach Werkzeug verschiedene Mengen.
+     */
+    grep(request: GrepRequestV1, options?: PortCallOptions): Promise<GrepResultSetV1>;
+    private searchTarget;
+    /** Uebernimmt Speicherpunkte in den Kandidatenpool; unbrauchbare landen im Ledger. */
+    private collect;
+    /** Pfad-Globs und Findability — die Filter, die der Speicher nicht kennt. */
+    private passesResidualFilters;
+    private buildProximityMap;
+    private buildHit;
+    private indexGenerationOf;
+    /** Persisted candidate provenance; display fallbacks are deliberately excluded. */
+    private rawIndexGenerationOf;
+    private indexContextProvenance;
+    private complexityOf;
+}
+/** Kleiner Bequemlichkeits-Konstruktor. */
+export declare function createHybridSearchEngine(deps: HybridSearchEngineDeps): HybridSearchEngine;
+/** Wiederexport, damit Aufrufer den Filtertyp nicht aus zwei Paketen ziehen muessen. */
+export type { PayloadFilter };
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

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