@untangle-code/search 0.0.0-stage → 0.1.0

package/dist/format.js

@@ -0,0 +1,172 @@
+/** Formatiert eine Zahl mit fester Stellenzahl — stabil ueber Plattformen. */
+function fixed(value, digits = 4) {
+    return value.toFixed(digits);
+}
+function formatComponent(component) {
+    const sign = component.contribution < 0 ? "-" : "+";
+    const evidence = component.evidence === undefined ? "" : `  [${component.evidence}]`;
+    return `      ${sign} ${component.kind} = ${fixed(Math.abs(component.contribution))} (raw ${fixed(component.rawValue)} x weight ${fixed(component.weight)})${evidence}`;
+}
+/** Kompakte, aber vollstaendige Textdarstellung einer begrenzten Graphfacette. */
+export function formatSearchGraphRelationsAsText(label, value) {
+    const lines = value.relations.map((relation) => {
+        const arrow = relation.direction === "incoming" ? "<-" : "->";
+        const symbol = relation.symbol === undefined ? "" : ` symbol=${relation.symbol.id}`;
+        return (`      ${label} ${arrow} ${relation.repoId}@${relation.refId} ` +
+            `${relation.path} file=${relation.fileId}${symbol} ` +
+            `edge=${relation.edgeId} kind=${relation.edgeKind} crossRepository=${String(relation.crossRepository)}`);
+    });
+    for (const omission of value.omissions) {
+        lines.push(`      ${label} omitted ${omission.reason} x${String(omission.count)}: ${omission.detail}`);
+    }
+    return lines;
+}
+/** Eine Trefferzeile plus Score-Zerlegung im Textformat. */
+export function formatHitAsText(hit) {
+    const lines = [];
+    const symbol = hit.symbolName === undefined ? "" : ` ${hit.symbolKind ?? "symbol"} ${hit.symbolName}`;
+    lines.push(`${String(hit.rank).padStart(3, " ")}. ${fixed(hit.score.final)}  ${hit.repoLabel}@${hit.refName} ${hit.filePath}:${hit.range.startLine}-${hit.range.endLine}${symbol}`);
+    if (hit.complexity?.cognitive !== undefined) {
+        lines.push(`      complexity: cognitive ${hit.complexity.cognitive}`);
+    }
+    if (hit.findability !== undefined) {
+        lines.push(`      findability: ${fixed(hit.findability.score, 2)} (heuristic${hit.findability.primaryCause === undefined ? "" : `, ${hit.findability.primaryCause}`})`);
+    }
+    lines.push("      why:");
+    for (const component of hit.score.components) {
+        lines.push(formatComponent(component));
+    }
+    if (hit.score.clamped) {
+        lines.push(`      clamped: ${hit.score.clampReason ?? ""}`);
+    }
+    if (hit.relatedFragments.length > 0) {
+        lines.push(`      related fragments: ${hit.relatedFragments.map((fragment) => `${fragment.chunkKind}@${fragment.startLine}`).join(", ")}`);
+    }
+    if (hit.graphContext !== undefined) {
+        lines.push(...formatSearchGraphRelationsAsText("context", hit.graphContext));
+    }
+    if (hit.linkedSymbols !== undefined) {
+        lines.push(...formatSearchGraphRelationsAsText("linked", hit.linkedSymbols));
+    }
+    if (hit.contentOmittedReason !== undefined) {
+        lines.push(`      content omitted: ${hit.contentOmittedReason}`);
+    }
+    if (hit.content !== undefined) {
+        for (const line of hit.content.split("\n")) {
+            lines.push(`      | ${line}`);
+        }
+    }
+    return lines.join("\n");
+}
+/** Formatiert eine ganze Ergebnismenge. */
+export function formatSearchResultSet(set, format) {
+    if (format === "json") {
+        return JSON.stringify(set, null, 2);
+    }
+    if (format === "jsonl") {
+        const header = {
+            kind: "header",
+            queryFingerprint: set.queryFingerprint,
+            ...(set.indexFreshness === undefined ? {} : { indexFreshness: set.indexFreshness }),
+            query: set.query,
+            profileSeparation: set.profileSeparation,
+            totalHits: set.totalHits,
+            warnings: set.warnings,
+            skipped: set.skipped,
+        };
+        const lines = [JSON.stringify(header)];
+        for (const group of set.groups) {
+            for (const hit of group.hits) {
+                lines.push(JSON.stringify({ kind: "hit", embeddingProfileId: group.embeddingProfileId, hit }));
+            }
+        }
+        return lines.join("\n");
+    }
+    const lines = [];
+    lines.push(`query: ${set.query.text}`);
+    lines.push(`fingerprint: ${set.queryFingerprint}`);
+    if (set.profileSeparation) {
+        lines.push(`NOTE: ${set.groups.length} embedding profiles — scores are comparable only within a group (spec.md §13.4)`);
+    }
+    for (const group of set.groups) {
+        lines.push("");
+        lines.push(`profile ${group.embeddingProfileId} (repos: ${group.repoIds.join(", ")})`);
+        for (const caveat of group.caveats) {
+            lines.push(`  caveat: ${caveat}`);
+        }
+        // Das Verdikt kommt aus der Entscheidung, nie aus der Listenlaenge. Ein
+        // blosses „(no hits)" waere bei einer Ablehnung eine Tatsachenbehauptung
+        // ueber den Code: es GAB Kandidaten, die Policy hat sie verworfen.
+        const verdict = group.relevanceDecision;
+        if (verdict?.status === "rejected") {
+            lines.push(`  (relevance policy ${verdict.calibrationId ?? "unknown"} judged the evidence ` +
+                `insufficient: ${verdict.basis}; abstention=${verdict.abstention})`);
+        }
+        if (group.hits.length === 0 && verdict?.status !== "rejected") {
+            lines.push("  (no hits)");
+        }
+        for (const hit of group.hits) {
+            lines.push(formatHitAsText(hit));
+        }
+    }
+    if (set.warnings.length > 0) {
+        lines.push("");
+        lines.push("warnings:");
+        for (const warning of set.warnings) {
+            lines.push(`  ${warning.code}: ${warning.message}`);
+        }
+    }
+    if (set.skipped.length > 0) {
+        lines.push("");
+        lines.push(`skipped (${set.skipped.length}) — nothing is dropped silently:`);
+        for (const entry of set.skipped) {
+            lines.push(`  ${entry.reason} ${entry.subjectKind} ${entry.subjectId ?? entry.path ?? ""}: ${entry.detail}`);
+        }
+    }
+    return lines.join("\n");
+}
+/** Formatiert grep-Treffer. */
+export function formatGrepResultSet(set, format) {
+    if (format === "json") {
+        return JSON.stringify(set, null, 2);
+    }
+    if (format === "jsonl") {
+        const header = {
+            kind: "header",
+            pattern: set.pattern,
+            ...(set.indexFreshness === undefined ? {} : { indexFreshness: set.indexFreshness }),
+            isRegex: set.isRegex,
+            totalMatches: set.totalMatches,
+            truncated: set.truncated,
+            ...(set.truncationReason === undefined ? {} : { truncationReason: set.truncationReason }),
+            scannedChunks: set.scannedChunks,
+            warnings: set.warnings,
+            skipped: set.skipped,
+        };
+        return [header, ...set.matches.map((match) => ({ kind: "match", match }))]
+            .map((entry) => JSON.stringify(entry))
+            .join("\n");
+    }
+    const lines = [];
+    for (const match of set.matches) {
+        for (const context of match.before) {
+            lines.push(`${match.filePath}-${context.line}- ${context.text}`);
+        }
+        lines.push(`${match.filePath}:${match.line}:${match.column}: ${match.lineText}`);
+        for (const context of match.after) {
+            lines.push(`${match.filePath}-${context.line}- ${context.text}`);
+        }
+        if (match.before.length > 0 || match.after.length > 0) {
+            lines.push("--");
+        }
+    }
+    lines.push(`${set.totalMatches} match(es) in ${set.scannedChunks} scanned chunk(s)${set.truncated ? ` — TRUNCATED (${set.truncationReason ?? "unknown"})` : ""}`);
+    if (set.skipped.length > 0) {
+        lines.push(`skipped (${set.skipped.length}):`);
+        for (const entry of set.skipped) {
+            lines.push(`  ${entry.reason} ${entry.subjectId ?? entry.path ?? ""}: ${entry.detail}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/fusion.d.ts

@@ -0,0 +1,47 @@
+/** Glaettungskonstante der RRF-Formel (siehe Modulkommentar). */
+export declare const RRF_K = 60;
+/** Voreingestellte Zweiggewichte (siehe Modulkommentar). */
+export declare const DEFAULT_BRANCH_WEIGHTS: {
+    readonly dense: 1;
+    readonly lexical: 1;
+    readonly symbol: 0.5;
+};
+export type FusionBranch = keyof typeof DEFAULT_BRANCH_WEIGHTS;
+/** Eine Rangliste eines Zweigs: IDs, bester zuerst. */
+export interface FusionInput {
+    branch: FusionBranch;
+    /** IDs in Rangfolge; Position 0 ist Rang 1. */
+    rankedIds: readonly string[];
+}
+export interface FusionResult {
+    id: string;
+    /** Roher RRF-Wert. */
+    rrf: number;
+    /** Auf [0, 1] normalisierter RRF-Wert (siehe {@link maximumRrf}). */
+    normalized: number;
+    /** Beitragende Zweige mit ihrem 1-basierten Rang. */
+    ranks: Partial<Record<FusionBranch, number>>;
+    /** Wirksame Gewichte der beteiligten Zweige (fuer die Score-Evidenz). */
+    weights?: Partial<Record<FusionBranch, number>>;
+}
+export type BranchWeights = Record<FusionBranch, number>;
+/**
+ * Der groesstmoegliche RRF-Wert: jeder beteiligte Zweig auf Rang 1.
+ *
+ * Damit wird auf [0, 1] normalisiert, OHNE durch den Maximalwert der aktuellen
+ * Trefferliste zu teilen. Das ist der Unterschied zwischen „dieser Treffer ist
+ * gut" und „dieser Treffer war der beste, den wir hatten": eine Normalisierung
+ * am Listenmaximum gaebe dem besten Treffer immer 1.0, auch wenn er schlecht
+ * ist — und die Findability-Diagnose (vision.md §1d) braucht genau diesen
+ * Unterschied.
+ */
+export declare function maximumRrf(branches: readonly FusionBranch[], weights: BranchWeights): number;
+/**
+ * Fusioniert die Ranglisten. Ein Kandidat, der in einem Zweig nicht vorkommt,
+ * bekommt von diesem Zweig schlicht keinen Beitrag — er wird nicht bestraft.
+ *
+ * Die Ausgabe ist absteigend nach RRF sortiert, bei Gleichstand nach
+ * Codepoints der ID (deterministisch).
+ */
+export declare function fuseRankings(inputs: readonly FusionInput[], weights?: BranchWeights): FusionResult[];
+//# sourceMappingURL=fusion.d.ts.map

package/dist/fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../src/fusion.ts"],"names":[],"mappings":"AAgCA,iEAAiE;AACjE,eAAO,MAAM,KAAK,KAAK,CAAC;AAExB,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAE/D,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAG5F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,GAAE,aAA6C,GACrD,YAAY,EAAE,CA8BhB"}

package/dist/fusion.js

@@ -0,0 +1,84 @@
+/**
+ * Fusion der drei Ranglisten (spec.md §13.2 Schritt 6, §13.4).
+ *
+ * Verfahren: gewichtete Reciprocal Rank Fusion.
+ *
+ *     rrf(d) = Σ_zweig  w_zweig / (k + rang_zweig(d))
+ *
+ * WARUM RRF UND NICHT EINE SCORE-SUMME: Cosine-Aehnlichkeit, BM25 und eine
+ * Namensuebereinstimmung leben in drei verschiedenen Wertebereichen. Sie zu
+ * addieren hiesse, sie stillschweigend gleich zu skalieren. RRF benutzt nur
+ * die RANGFOLGE jedes Zweigs und ist damit gegen die Skala jedes einzelnen
+ * Zweigs unempfindlich — dieselbe Eigenschaft, wegen der spec.md §13.4 RRF
+ * als einziges Fusionsverfahren fuer v1 festlegt.
+ *
+ * WARUM k = 60: der Wert aus der RRF-Originalarbeit (Cormack, Clarke,
+ * Buettcher 2009), seither die uebliche Voreinstellung — unter anderem in
+ * Qdrants eigener RRF-Implementierung, gegen die dieser Abrufkern austauschbar
+ * bleiben soll. Grosses k daempft den Vorsprung der ersten Plaetze, kleines k
+ * ueberhoeht ihn; 60 ist der dokumentierte Mittelweg, nicht ein geratener.
+ *
+ * WARUM DIE ZWEIGGEWICHTE SO GEWAEHLT SIND:
+ * - dicht 1.0 und lexikalisch 1.0 — die beiden Abrufzweige sind gleichwertig;
+ *   welcher besser ist, haengt an der Anfrage (Absichtsfrage vs. Bezeichner),
+ *   und genau deshalb werden beide gefragt;
+ * - Symbolname 0.5 — der Zweig ist eine PRAEZISIONS-, keine Abrufquelle. Ein
+ *   exakter Namenstreffer wird zusaetzlich als `exact_symbol_boost` belohnt
+ *   (spec.md §13.3). Mit vollem Gewicht in der Fusion UND vollem Boost
+ *   wuerde derselbe Beleg doppelt zaehlen; das halbe Gewicht ist der
+ *   ausdrueckliche Abschlag dafuer.
+ */
+import { compareCodepoints } from "@untangle-code/domain";
+/** Glaettungskonstante der RRF-Formel (siehe Modulkommentar). */
+export const RRF_K = 60;
+/** Voreingestellte Zweiggewichte (siehe Modulkommentar). */
+export const DEFAULT_BRANCH_WEIGHTS = {
+    dense: 1,
+    lexical: 1,
+    symbol: 0.5,
+};
+/**
+ * Der groesstmoegliche RRF-Wert: jeder beteiligte Zweig auf Rang 1.
+ *
+ * Damit wird auf [0, 1] normalisiert, OHNE durch den Maximalwert der aktuellen
+ * Trefferliste zu teilen. Das ist der Unterschied zwischen „dieser Treffer ist
+ * gut" und „dieser Treffer war der beste, den wir hatten": eine Normalisierung
+ * am Listenmaximum gaebe dem besten Treffer immer 1.0, auch wenn er schlecht
+ * ist — und die Findability-Diagnose (vision.md §1d) braucht genau diesen
+ * Unterschied.
+ */
+export function maximumRrf(branches, weights) {
+    const uniqueBranches = [...new Set(branches)];
+    return uniqueBranches.reduce((sum, branch) => sum + weights[branch] / (RRF_K + 1), 0);
+}
+/**
+ * Fusioniert die Ranglisten. Ein Kandidat, der in einem Zweig nicht vorkommt,
+ * bekommt von diesem Zweig schlicht keinen Beitrag — er wird nicht bestraft.
+ *
+ * Die Ausgabe ist absteigend nach RRF sortiert, bei Gleichstand nach
+ * Codepoints der ID (deterministisch).
+ */
+export function fuseRankings(inputs, weights = { ...DEFAULT_BRANCH_WEIGHTS }) {
+    const accumulator = new Map();
+    for (const input of inputs) {
+        const weight = weights[input.branch];
+        input.rankedIds.forEach((id, index) => {
+            const rank = index + 1;
+            const entry = accumulator.get(id) ?? { rrf: 0, ranks: {} };
+            entry.rrf += weight / (RRF_K + rank);
+            entry.ranks[input.branch] = rank;
+            accumulator.set(id, entry);
+        });
+    }
+    const maximum = maximumRrf(inputs.map((input) => input.branch), weights);
+    const results = [...accumulator.entries()].map(([id, entry]) => ({
+        id,
+        rrf: entry.rrf,
+        normalized: maximum === 0 ? 0 : entry.rrf / maximum,
+        ranks: entry.ranks,
+        weights: Object.fromEntries([...new Set(inputs.map((input) => input.branch))].map((branch) => [branch, weights[branch]])),
+    }));
+    results.sort((a, b) => (a.rrf === b.rrf ? compareCodepoints(a.id, b.id) : b.rrf - a.rrf));
+    return results;
+}
+//# sourceMappingURL=fusion.js.map

package/dist/fusion.js.map

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

package/dist/glob.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Deterministischer Glob-Abgleich fuer Pfad-Ein- und -Ausschluss
+ * (Nutzerwunsch A4: „Pfad-Ein-/Ausschluss" wie ein grep-Werkzeug).
+ *
+ * Warum eine eigene, kleine Implementierung statt einer Bibliothek: der
+ * Abgleich muss auf „/"-normalisierten, repo-relativen Pfaden arbeiten
+ * (spec.md §5.2), darf keine Dateisystemzugriffe machen (wir globben ueber
+ * INDIZIERTE Pfade, nicht ueber die Platte) und muss auf jeder Maschine
+ * dieselbe Antwort geben. Die unterstuetzte Teilmenge ist bewusst klein und
+ * hier vollstaendig dokumentiert:
+ *
+ * | Muster   | Bedeutung |
+ * |---|---|
+ * | `?`      | genau ein Zeichen, aber nie `/` |
+ * | `*`      | beliebig viele Zeichen, aber nie `/` |
+ * | `**`     | beliebig viele Zeichen inklusive `/` |
+ * | `[abc]`  | eine Zeichenklasse, `[!abc]`/`[^abc]` negiert |
+ * | sonst    | Literal |
+ *
+ * Ein Muster ohne `/` wird zusaetzlich gegen den BASENAMEN geprueft, damit
+ * `*.ts` das tut, was jeder erwartet, ohne dass der Nutzer `**\/*.ts`
+ * schreiben muss. Diese Bequemlichkeit ist eine bewusste Entscheidung und in
+ * der README als solche vermerkt.
+ */
+/** Wandelt ein Glob-Muster in einen verankerten regulaeren Ausdruck. */
+export declare function globToRegExp(pattern: string): RegExp;
+/**
+ * Prueft eine Musterliste, BEVOR sie benutzt wird.
+ *
+ * Warum vorab und nicht erst beim Abgleich: der Abgleich laeuft je Kandidat,
+ * tief in der Auswertung. Ein Fehler dort trifft eine Stelle, die ihn nur noch
+ * als „dieses Ziel hat nicht geantwortet" deuten kann. Vorab geprueft, ist er
+ * das, was er ist: eine abgelehnte Anfrage mit benanntem Muster.
+ */
+export declare function assertValidGlobPatterns(patterns: readonly string[], label: string): void;
+/** Kanonisiert einen Pfad fuer den Abgleich: Backslashes zu `/`, kein `./`. */
+export declare function normalizeGlobPath(path: string): string;
+/** True, wenn `path` auf `pattern` passt (siehe Modulkommentar). */
+export declare function matchesGlob(path: string, pattern: string): boolean;
+/** True, wenn `path` auf mindestens eines der Muster passt. */
+export declare function matchesAnyGlob(path: string, patterns: readonly string[]): boolean;
+/**
+ * Entscheidet ueber Ein-/Ausschluss eines Pfades.
+ *
+ * - leere Einschlussliste heisst „alles einschliessen" (wie in SearchFiltersV1
+ *   dokumentiert: eine leere Liste ist kein Filter);
+ * - Ausschluss gewinnt immer gegen Einschluss.
+ */
+export declare function isPathSelected(path: string, include: readonly string[], exclude: readonly string[]): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0DpD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASxF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYlE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAQT"}

package/dist/glob.js

@@ -0,0 +1,144 @@
+/**
+ * Deterministischer Glob-Abgleich fuer Pfad-Ein- und -Ausschluss
+ * (Nutzerwunsch A4: „Pfad-Ein-/Ausschluss" wie ein grep-Werkzeug).
+ *
+ * Warum eine eigene, kleine Implementierung statt einer Bibliothek: der
+ * Abgleich muss auf „/"-normalisierten, repo-relativen Pfaden arbeiten
+ * (spec.md §5.2), darf keine Dateisystemzugriffe machen (wir globben ueber
+ * INDIZIERTE Pfade, nicht ueber die Platte) und muss auf jeder Maschine
+ * dieselbe Antwort geben. Die unterstuetzte Teilmenge ist bewusst klein und
+ * hier vollstaendig dokumentiert:
+ *
+ * | Muster   | Bedeutung |
+ * |---|---|
+ * | `?`      | genau ein Zeichen, aber nie `/` |
+ * | `*`      | beliebig viele Zeichen, aber nie `/` |
+ * | `**`     | beliebig viele Zeichen inklusive `/` |
+ * | `[abc]`  | eine Zeichenklasse, `[!abc]`/`[^abc]` negiert |
+ * | sonst    | Literal |
+ *
+ * Ein Muster ohne `/` wird zusaetzlich gegen den BASENAMEN geprueft, damit
+ * `*.ts` das tut, was jeder erwartet, ohne dass der Nutzer `**\/*.ts`
+ * schreiben muss. Diese Bequemlichkeit ist eine bewusste Entscheidung und in
+ * der README als solche vermerkt.
+ */
+/** Wandelt ein Glob-Muster in einen verankerten regulaeren Ausdruck. */
+export function globToRegExp(pattern) {
+    let source = "^";
+    let index = 0;
+    while (index < pattern.length) {
+        const char = pattern[index];
+        if (char === "*") {
+            const isDouble = pattern[index + 1] === "*";
+            if (isDouble) {
+                // `a/**/b` soll auch `a/b` treffen: der Schraegstrich hinter `**`
+                // wird optional mitgeschluckt.
+                if (pattern[index + 2] === "/") {
+                    source += "(?:.*/)?";
+                    index += 3;
+                    continue;
+                }
+                source += ".*";
+                index += 2;
+                continue;
+            }
+            source += "[^/]*";
+            index += 1;
+            continue;
+        }
+        if (char === "?") {
+            source += "[^/]";
+            index += 1;
+            continue;
+        }
+        if (char === "[") {
+            const close = pattern.indexOf("]", index + 1);
+            if (close === -1) {
+                // Unpaarige Klammer ist ein Literal, kein Fehler — ein Suchmuster
+                // darf nicht daran scheitern, dass jemand `[` im Pfad meint.
+                source += "\\[";
+                index += 1;
+                continue;
+            }
+            const body = pattern.slice(index + 1, close);
+            const negated = body.startsWith("!") || body.startsWith("^");
+            const content = negated ? body.slice(1) : body;
+            source += `[${negated ? "^" : ""}${content.replace(/[\\\]]/g, "\\$&")}]`;
+            index = close + 1;
+            continue;
+        }
+        source += char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        index += 1;
+    }
+    source += "$";
+    try {
+        return new RegExp(source, "u");
+    }
+    catch (error) {
+        // Ein fehlerhaftes Muster ist ein EINGABEFEHLER des Nutzers. Ohne diesen
+        // Rahmen wandert der rohe `SyntaxError` durch den Abgleich bis in ein
+        // catch, das ihn als Speicherausfall verbucht — der Nutzer bekaeme dann
+        // „Provider nicht verfuegbar" fuer sein eigenes Zeichenklassenmuster.
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`glob pattern "${pattern}" is not a valid pattern: ${message}`);
+    }
+}
+/**
+ * Prueft eine Musterliste, BEVOR sie benutzt wird.
+ *
+ * Warum vorab und nicht erst beim Abgleich: der Abgleich laeuft je Kandidat,
+ * tief in der Auswertung. Ein Fehler dort trifft eine Stelle, die ihn nur noch
+ * als „dieses Ziel hat nicht geantwortet" deuten kann. Vorab geprueft, ist er
+ * das, was er ist: eine abgelehnte Anfrage mit benanntem Muster.
+ */
+export function assertValidGlobPatterns(patterns, label) {
+    for (const pattern of patterns) {
+        try {
+            globToRegExp(normalizeGlobPath(pattern));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`search query field "${label}" contains an invalid pattern: ${message}`);
+        }
+    }
+}
+/** Kanonisiert einen Pfad fuer den Abgleich: Backslashes zu `/`, kein `./`. */
+export function normalizeGlobPath(path) {
+    const slashed = path.replace(/\\/g, "/");
+    return slashed.startsWith("./") ? slashed.slice(2) : slashed;
+}
+/** True, wenn `path` auf `pattern` passt (siehe Modulkommentar). */
+export function matchesGlob(path, pattern) {
+    const normalizedPath = normalizeGlobPath(path);
+    const normalizedPattern = normalizeGlobPath(pattern);
+    const expression = globToRegExp(normalizedPattern);
+    if (expression.test(normalizedPath)) {
+        return true;
+    }
+    if (!normalizedPattern.includes("/")) {
+        const basename = normalizedPath.slice(normalizedPath.lastIndexOf("/") + 1);
+        return expression.test(basename);
+    }
+    return false;
+}
+/** True, wenn `path` auf mindestens eines der Muster passt. */
+export function matchesAnyGlob(path, patterns) {
+    return patterns.some((pattern) => matchesGlob(path, pattern));
+}
+/**
+ * Entscheidet ueber Ein-/Ausschluss eines Pfades.
+ *
+ * - leere Einschlussliste heisst „alles einschliessen" (wie in SearchFiltersV1
+ *   dokumentiert: eine leere Liste ist kein Filter);
+ * - Ausschluss gewinnt immer gegen Einschluss.
+ */
+export function isPathSelected(path, include, exclude) {
+    if (exclude.length > 0 && matchesAnyGlob(path, exclude)) {
+        return false;
+    }
+    if (include.length === 0) {
+        return true;
+    }
+    return matchesAnyGlob(path, include);
+}
+//# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAW,CAAC;QACtC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACb,kEAAkE;gBAClE,+BAA+B;gBAC/B,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC/B,MAAM,IAAI,UAAU,CAAC;oBACrB,KAAK,IAAI,CAAC,CAAC;oBACX,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,IAAI,CAAC;gBACf,KAAK,IAAI,CAAC,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,IAAI,OAAO,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,MAAM,CAAC;YACjB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,kEAAkE;gBAClE,6DAA6D;gBAC7D,MAAM,IAAI,KAAK,CAAC;gBAChB,KAAK,IAAI,CAAC,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/C,MAAM,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;YACzE,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACtD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAG,CAAC;IACd,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,sEAAsE;QACtE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA2B,EAAE,KAAa;IAChF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,kCAAkC,OAAO,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe;IACvD,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACnD,IAAI,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAA2B;IACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAA0B,EAC1B,OAA0B;IAE1B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/grep.d.ts

@@ -0,0 +1,76 @@
+/**
+ * grep-artige Suche ueber den indexierten Inhalt (Nutzerwunsch A4).
+ *
+ * „Beides — semantisch UND grep-artig — unter einer Oberflaeche" heisst hier
+ * woertlich: derselbe Port, dieselben Filter, dieselbe Provenienz je Treffer,
+ * derselbe Skip-Ledger. Der Unterschied ist nur, WAS gefragt wird — ein
+ * Zeichenmuster statt einer Bedeutung.
+ *
+ * WICHTIG FUER DIE INTERPRETATION DER ERGEBNISSE: Gesucht wird im INDEX, nicht
+ * auf der Platte. Was nicht indexiert ist (uebersprungene Datei, Chunk ohne
+ * gespeicherten Inhalt), kann hier nicht gefunden werden. Genau deshalb traegt
+ * `GrepResultSetV1` den Skip-Ledger und die Zahl der durchsuchten Chunks mit —
+ * „keine Treffer" und „nichts durchsucht" duerfen nicht gleich aussehen (E4).
+ *
+ * Zeilennummern sind ECHTE Dateizeilen: der Chunk kennt seine `start_line`,
+ * und die Zeilenzaehlung setzt darauf auf. Kontextzeilen kommen aus demselben
+ * Chunk; reicht der Kontext ueber die Chunkgrenze hinaus, endet er dort. Das
+ * ist eine bewusste Grenze (siehe README „Bekannte Grenzen") — die
+ * Nachbarzeilen liegen in einem anderen Punkt und muessten einzeln nachgeladen
+ * werden.
+ */
+import type { PortCallOptions, VectorStore } from "@untangle-code/domain";
+import type { GrepMatchV1, GrepRequestV1, GrepResultSetV1 } from "./types.js";
+/** Voreinstellungen der Budgets — jede Ueberschreitung ist ein benannter Abbruchgrund. */
+export declare const GREP_DEFAULTS: {
+    readonly maxMatches: 200;
+    readonly maxMatchesPerFile: 50;
+    readonly maxScannedChunks: 5000;
+    /** Seitengroesse des Scroll-Laufs ueber die Collection. */
+    readonly scrollPageSize: 256;
+};
+/**
+ * Wie viele glob-ausgeschlossene Chunks EINZELN im Ledger stehen.
+ *
+ * Jeder ausgeschlossene Chunk gehoert in den Ledger (E4) — bei einem Budget
+ * von 5000 gescannten Chunks waere eine Liste mit 5000 Eintraegen aber selbst
+ * ein Problem fuer den Leser. Also: die ersten `GREP_GLOB_LEDGER_DETAIL_LIMIT`
+ * einzeln, danach EIN Sammeleintrag mit der vollstaendigen Zahl. Verschwiegen
+ * wird nichts; die Zahl stimmt in jedem Fall.
+ */
+export declare const GREP_GLOB_LEDGER_DETAIL_LIMIT = 50;
+/**
+ * Der Geltungsbereich, in dem grep ueberhaupt suchen darf.
+ *
+ * Dieselbe Begruendung wie bei `SearchScopeV1` in `filter.ts`: ohne Workspace
+ * laeuft eine Mustersuche ueber die Chunks JEDES Workspaces, der zufaellig in
+ * derselben Collection liegt, und meldet fremden Code als eigenen.
+ */
+export interface GrepScopeV1 {
+    /** Workspace, falls die Anfrage selbst keinen nennt. */
+    workspaceId?: string;
+    /** Repositories der durchsuchten Collections; leer heisst „nicht deklariert". */
+    repoIds?: readonly string[];
+}
+/** Maskiert einen Literaltext, damit er als regulaerer Ausdruck sich selbst bedeutet. */
+export declare function escapeRegExpLiteral(text: string): string;
+/**
+ * Baut den Suchausdruck.
+ *
+ * `wholeWord` verwendet bewusst Lookarounds ueber Bezeichnerzeichen statt
+ * `\b`: `\b` kennt nur ASCII-Wortzeichen, und ein Bezeichner mit Umlaut oder
+ * `$` waere damit an der falschen Stelle „ganzes Wort".
+ */
+export declare function buildGrepRegExp(request: GrepRequestV1): RegExp;
+/**
+ * Durchsucht die angegebenen Collections mit einem Muster.
+ *
+ * Der Ablauf ist bewusst ein Scroll und kein `hybridQuery`: eine Regex-Suche
+ * hat kein Ranking-Signal, sie hat einen VOLLSTAENDIGKEITSANSPRUCH. Also wird
+ * gefiltert und durchlaufen, bis das Budget greift — und wenn es greift, steht
+ * das im Ergebnis.
+ */
+export declare function grepIndexedChunks(store: VectorStore, collections: readonly string[], request: GrepRequestV1, options?: PortCallOptions, scope?: GrepScopeV1): Promise<GrepResultSetV1>;
+/** Sortiert grep-Treffer deterministisch. */
+export declare function sortGrepMatches<T extends GrepMatchV1>(matches: readonly T[], sort: "path" | "matches-desc"): T[];
+//# sourceMappingURL=grep.d.ts.map

package/dist/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../src/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAGV,eAAe,EAGf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EAAqB,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjG,0FAA0F;AAC1F,eAAO,MAAM,aAAa;;;;IAIxB,2DAA2D;;CAEnD,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqB9D;AAiLD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,eAAe,EACzB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,eAAe,CAAC,CA4R1B;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EACnD,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,IAAI,EAAE,MAAM,GAAG,cAAc,GAC5B,CAAC,EAAE,CAgCL"}