@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/query.d.ts

@@ -0,0 +1,114 @@
+/**
+ * `untangle query` — der Befehl, um den es geht.
+ *
+ * Er verdrahtet @untangle-code/search und macht dabei ZWEI Dinge unter EINER
+ * Oberflaeche sichtbar (Nutzerwunsch A4):
+ *
+ *   - die SEMANTISCHE Suche (hybrid aus dichtem Vektor, BM25 und exaktem
+ *     Symbolnamen, fusioniert per RRF), und
+ *   - die GREP-artige Suche (Literal oder regulaerer Ausdruck) mit
+ *     Kontextzeilen, Pfad-Ein-/Ausschluss und Trefferbegrenzung.
+ *
+ * `--explain` ist kein Debug-Anhang, sondern der Kern von vision.md §1d: die
+ * Score-Zerlegung beantwortet „warum steht das oben?" — und damit auch die
+ * Gegenfrage „warum steht der richtige Treffer NICHT oben?".
+ *
+ * WICHTIG UND EHRLICH: Gesucht wird im INDEX, nicht auf der Platte. Solange
+ * `untangle index` fehlt (siehe dort), ist der Index leer. Dieser Befehl
+ * behauptet dann nicht „nichts gefunden", sondern nennt den fehlenden Index
+ * als Grund und endet mit Exit-Code 4.
+ */
+import { type IndexFreshnessV1, type SearchResultSetV1, type SkipLedgerEntryV1 } from "@untangle-code/domain";
+import { type GrepRequestV1, type GrepResultSetV1, type OutputFormat, type UntangleSearchRequestV1 } from "@untangle-code/search";
+import { type ParsedArgs } from "../cli/args.js";
+import type { Command, CommandContext } from "../cli/command.js";
+import { type FoundIndexState, type IndexStateResolution } from "../cli/index-state.js";
+/**
+ * Frist der ganzen Anfrage.
+ *
+ * Includes retrieval and optional graph enrichment. Semantic/hybrid search
+ * also computes a query embedding, which can require loading a service model.
+ * The finite deadline keeps an unresponsive terminal from hanging indefinitely.
+ */
+export declare const DEFAULT_QUERY_TIMEOUT_MS = 60000;
+export declare const queryCommand: Command;
+export declare function addFreshnessWarning(result: Pick<SearchResultSetV1, "warnings">, freshness: IndexFreshnessV1): void;
+/**
+ * Welcher Einbetter durchsucht wird — und woher diese Entscheidung stammt
+ * (WP-229).
+ *
+ * `--embedder=offline` und `--embedder=service` sind ausdrueckliche
+ * Anweisungen und gewinnen immer. `auto` fragt den Indexzustand: er ist die
+ * einzige Quelle, die WEISS, womit gebaut wurde. Was dabei entschieden wird,
+ * steht auf stderr — eine Wahl, die der Nutzer nicht sieht, ist eine Wahl,
+ * die er nicht ueberstimmen kann.
+ */
+export declare function resolveEmbedderChoice(ctx: CommandContext, args: ParsedArgs, resolution: IndexStateResolution): boolean;
+/**
+ * Wo nach dem Indexzustand gesucht wird. Ohne Repo-Filter gilt die bisherige
+ * Reihenfolge: Aufrufswurzel, Konfigurationswurzel, dann alle konfigurierten
+ * Repositories codepoint-sortiert. Mit `--repo` duerfen dagegen nur die
+ * tatsaechlich ausgewaehlten Repository-Wurzeln die Auto-Embedder-Wahl
+ * beeinflussen; ein unbeteiligtes Repository darf keine Ambiguitaet erzeugen.
+ */
+export declare function indexStateRoots(input: {
+    readonly invocationRoot: string;
+    readonly configBaseDir: string;
+    readonly repositories: readonly {
+        readonly id: string;
+        readonly path: string;
+    }[];
+    readonly selectedRepoIds: readonly string[];
+}): readonly string[];
+/**
+ * Resolves an omitted ref scope to the refs for which the selected collection
+ * has local index state. Explicit canonical IDs remain authoritative; an
+ * explicit human ref name expands to every compatible canonical ID carrying
+ * that name (for example `main` in two selected repositories).
+ *
+ * The grep path receives these IDs directly. Semantic search receives the
+ * richer index contexts and derives the same scope inside the engine, where
+ * it can still distinguish an implicit scope for provenance validation. This
+ * is deliberately based on profile/collection-compatible states supplied by
+ * the caller: an old state for another embedding space must not widen a scan.
+ */
+export declare function queryRefIdsFromIndexStates(requestedRefIds: readonly string[], compatibleIndexStates: readonly FoundIndexState[]): string[];
+/**
+ * Auto-routing follows only the generation-checked current pointer of every
+ * selected repo/ref. An explicit embedder selection may intentionally reopen
+ * an older retained profile and therefore receives the complete registry.
+ */
+export declare function queryIndexStatesFromResolution(resolution: Exclude<IndexStateResolution, {
+    readonly kind: "invalid";
+}>, automaticEmbedder: boolean): readonly FoundIndexState[];
+/**
+ * Ziele, die ueberhaupt nicht durchsucht werden konnten.
+ *
+ * DIESE UNTERSCHEIDUNG IST DER KERN VON E4 AN DIESER OBERFLAECHE. Der
+ * Abrufkern degradiert bewusst sichtbar: faellt ein Embedding-Profil aus (weil
+ * Ollama nicht antwortet), meldet er das als Warnung UND als Ledger-Eintrag
+ * und liefert die uebrigen Profile trotzdem. Fuer den Aufrufer sieht das
+ * Ergebnis dann aus wie „null Treffer" — und genau das waere die Luege:
+ * gesucht wurde nichts.
+ *
+ * Gemessen an einem blockierten Ollama gab diese Oberflaeche vor der
+ * Einfuehrung dieser Pruefung „Keine Treffer." mit Exit-Code 0 aus, obwohl im
+ * Ledger `provider_unavailable` stand. Jetzt endet derselbe Fall mit
+ * Exit-Code 4 und der Begruendung aus dem Ledger.
+ *
+ * Erkannt wird der Ausfall an der Kombination, die der Abrufkern EXAKT fuer
+ * diesen Fall schreibt: `subjectKind === "search_candidate"` zusammen mit
+ * `reason === "provider_unavailable"`. Ein wegen Filtern oder Budget
+ * ausgelassenes Ziel traegt stattdessen `excluded_by_configuration` und ist
+ * kein Ausfall.
+ */
+export declare function failedTargets(skipped: readonly SkipLedgerEntryV1[]): readonly SkipLedgerEntryV1[];
+export declare function buildSearchRequest(args: ParsedArgs, workspaceId: string, text: string, refIdsOverride?: readonly string[]): UntangleSearchRequestV1;
+export declare function buildGrepRequest(args: ParsedArgs, workspaceId: string, pattern: string, refIdsOverride?: readonly string[]): GrepRequestV1;
+export declare function renderSearch(ctx: CommandContext, set: SearchResultSetV1, format: OutputFormat, explain: boolean): void;
+export declare function renderGrep(ctx: CommandContext, set: GrepResultSetV1, format: OutputFormat): void;
+export declare function toRuntimeError(outcome: {
+    readonly timedOut: boolean;
+    readonly error: unknown;
+}, qdrantUrl: string, timeoutMs: number, request: Pick<UntangleSearchRequestV1, "mode" | "includeContext" | "includeLinked"> | "grep", useOffline: boolean): Error;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

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