@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/index/render.js

@@ -0,0 +1,205 @@
+import { compareCodepoints } from "@untangle-code/domain";
+import { line, note } from "../../cli/io.js";
+export function createIndexProgress() {
+    return { plannedFiles: 0, embeddedFiles: 0, storedPoints: 0 };
+}
+/**
+ * Die Kopfzeilen VOR dem ersten Ereignis.
+ *
+ * WP-227: Der Laeufer meldet eine Stufe erst, wenn sie FERTIG ist. Haengt die
+ * erste Stufe — und genau das tut sie, wenn der Einbettungsdienst nicht
+ * antwortet —, dann gibt es ohne diese Zeilen ueberhaupt keine Ausgabe. Der
+ * Nutzer sieht dann nicht einmal, WORAUF gewartet wird. Deshalb steht hier,
+ * was gleich passiert, bevor irgendetwas passiert.
+ */
+export function renderRunHeader(io, input) {
+    note(io, `[  0%] Target: ${input.rootPath}`);
+    note(io, `       Repository ${input.repoId}, Ref ${input.refName}, collection ${input.collection}.`);
+    note(io, `       Embedder ${input.embedder}, deadline ${String(input.timeoutMs)} ms per call ` +
+        "(--timeout). Five stages: check services, discover files, process, " +
+        "build graphs, commit.");
+}
+/** Eine Fortschrittszeile je Ereignis — kurz, und nie auf stdout. */
+export function renderEvent(io, event, verbose, progress = createIndexProgress()) {
+    switch (event.kind) {
+        case "job_queued":
+            note(io, `[  1%] Job ${event.jobId} queued. Stage 1/5: embedding service and collection.`);
+            return;
+        case "infrastructure_ready":
+            note(io, `[ 10%] Ready: ${Object.entries(event.endpoints)
+                .sort(([a], [b]) => compareCodepoints(a, b))
+                .map(([key, value]) => `${key}=${value}`)
+                .join("  ")}`);
+            note(io, "[ 15%] Stage 2/5: discovering files …");
+            return;
+        case "files_discovered":
+            progress.plannedFiles = event.changedFiles;
+            note(io, `[ 20%] Found: ${String(event.totalFiles)} files, including ` +
+                `${String(event.changedFiles)} planned, ${String(event.unchangedFiles)} unchanged, ` +
+                `${String(event.ignoredFiles)} ignoriert.`);
+            note(io, event.changedFiles === 0
+                ? "[ 25%] Stage 3/5: nothing to process; every discovered file is unchanged."
+                : `[ 25%] Stage 3/5: ${String(event.changedFiles)} files to parse, embed and store …`);
+            return;
+        case "file_analyzed":
+            if (verbose) {
+                note(io, `       analysiert  ${event.filePath}  (${String(event.chunkCount)} Chunks, ` +
+                    `${String(event.symbolCount)} symbols, parse=${event.parseQuality})`);
+            }
+            return;
+        case "embedding_batch_completed":
+            progress.embeddedFiles += event.batchSize;
+            note(io, `[${percentOfPipeline(progress)}] Batch ${String(event.batchIndex)}: ` +
+                `${String(event.batchSize)} files embedded ` +
+                `(${String(progress.embeddedFiles)} of ${String(progress.plannedFiles)}), ` +
+                `${String(event.cacheHits)} from cache, ` +
+                `${String(event.truncatedCount)} gekuerzt.`);
+            return;
+        case "points_stored":
+            progress.storedPoints += event.pointCount;
+            note(io, `[${percentOfPipeline(progress)}] Stored: ${String(event.pointCount)} points in ` +
+                `${event.collection} (${String(event.serializedBytes)} Bytes, ` +
+                `${String(progress.storedPoints)} total).`);
+            return;
+        case "checkpoint_saved":
+            if (verbose) {
+                note(io, `       Checkpoint at ${event.stage}: ${String(event.completedFileCount)} files.`);
+            }
+            return;
+        case "graph_updated":
+            note(io, `[ 85%] Stage 4/5 — graph ${event.graph}: ${String(event.nodeCount)} nodes, ` +
+                `${String(event.edgeCount)} edges.`);
+            return;
+        case "job_completed":
+            note(io, `[100%] Finished in ${String(event.durationMs)} ms.`);
+            return;
+        case "job_failed":
+            note(io, `[ !! ] Failed: ${event.errorCode} — ${event.message}`);
+            return;
+        case "job_cancelled":
+            note(io, `[ -- ] Cancelled. Checkpoint saved: ${event.checkpointSaved ? "ja" : "no"}.`);
+            return;
+        default:
+            return;
+    }
+}
+/**
+ * Der Anteil der Verarbeitungsstufe am Ganzen: sie liegt zwischen 25 % und
+ * 80 %. Ohne bekannte Dateizahl bleibt es bei 50 % — eine erfundene
+ * Genauigkeit waere schlimmer als gar keine.
+ */
+function percentOfPipeline(progress) {
+    if (progress.plannedFiles <= 0)
+        return " 50%";
+    const done = Math.min(progress.embeddedFiles, progress.plannedFiles);
+    const percent = 25 + Math.floor((55 * done) / progress.plannedFiles);
+    return `${String(percent).padStart(3, " ")}%`;
+}
+/** Der Bericht als Text. */
+export function renderReport(io, report) {
+    const c = report.counts;
+    line(io, `Outcome:          ${report.outcome}`);
+    line(io, `Repository:        ${report.repoId}`);
+    line(io, `Ref:               ${report.refId}`);
+    line(io, `Generation:        ${report.generationId ?? "(none)"}`);
+    line(io, `Collection:        ${report.collection}`);
+    line(io, `Profile:           ${report.embeddingProfileId}`);
+    line(io, "");
+    line(io, `Files discovered: ${String(c.filesSeen)}`);
+    line(io, `  planned:        ${String(c.filesPlanned)}`);
+    line(io, `  unchanged:      ${String(c.filesUnchanged)}   (not recomputed)`);
+    line(io, `  ignoriert:       ${String(c.filesIgnored)}`);
+    line(io, `Files analyzed:   ${String(c.filesAnalyzed)}`);
+    line(io, `Files removed:    ${String(c.filesRemoved)}`);
+    line(io, `Chunks:            ${String(c.chunks)}`);
+    line(io, `Symbols:          ${String(c.symbols)}`);
+    line(io, `Points stored:    ${String(c.points)}`);
+    line(io, `Embeddings:       ${String(c.embeddingsComputed)} computed, ` +
+        `${String(c.embeddingCacheHits)} from cache, ` +
+        `${String(c.truncated)} gekuerzt`);
+    line(io, analysisCacheLine(c));
+    line(io, `File graph:       ${String(c.fileGraphNodes)} nodes, ${String(c.fileGraphEdges)} edges`);
+    line(io, `Symbol graph:     ${String(c.symbolGraphNodes)} nodes, ${String(c.symbolGraphEdges)} edges`);
+    line(io, "");
+    renderSkips(io, report.skipped.length, report.skippedByReason, report.skippedByStage, report.skippedTruncated);
+    if (report.failure !== undefined) {
+        line(io, "");
+        line(io, `FAILURE ${report.failure.code}: ${report.failure.message}`);
+        line(io, `Retryable: ${report.failure.retryable ? "ja" : "no"}`);
+    }
+}
+/** Der Trockenlauf als Text. */
+export function renderPlan(io, plan, showFiles) {
+    line(io, `Files discovered: ${String(plan.filesSeen)}`);
+    line(io, `  would plan:     ${String(plan.planned.length)}`);
+    line(io, `  unchanged:      ${String(plan.filesUnchanged)}`);
+    line(io, `  ignoriert:       ${String(plan.filesIgnored)}`);
+    line(io, `  entfernt:        ${String(plan.removedFileIds.length)}`);
+    if (plan.previousUnavailable !== undefined) {
+        line(io, "");
+        line(io, `Note: the previous generation could not be read (${plan.previousUnavailable}). ` +
+            "All files are therefore considered planned; this number is an upper bound, " +
+            "not a comparison.");
+    }
+    line(io, "");
+    renderSkips(io, plan.skipped.length, plan.skippedByReason, plan.skippedByStage, plan.skippedTruncated);
+    if (showFiles > 0 && plan.planned.length > 0) {
+        line(io, "");
+        line(io, `Planned work (first ${String(Math.min(showFiles, plan.planned.length))}):`);
+        for (const file of plan.planned.slice(0, showFiles)) {
+            line(io, `  ${file.filePath}`);
+        }
+        if (plan.planned.length > showFiles) {
+            line(io, `  … and ${String(plan.planned.length - showFiles)} weitere.`);
+        }
+    }
+}
+/**
+ * Stufen, die von DATEIEN handeln. Alles andere handelt von Kanten und
+ * Kandidaten — zwei Dinge, die in einer gemeinsamen Zahl nur verwirren:
+ * „9207 uebersprungen" liest sich wie ein kaputter Index, ist aber die
+ * normale Meldung des Symbolgraphen ueber Aufrufe nach ausserhalb.
+ */
+const FILE_STAGES = new Set(["scan", "parse", "chunk", "embed", "store"]);
+function renderSkips(io, listed, byReason, byStage, truncated) {
+    const total = Object.values(byReason).reduce((sum, value) => sum + (value ?? 0), 0);
+    const fileTotal = Object.entries(byStage)
+        .filter(([stage]) => FILE_STAGES.has(stage))
+        .reduce((sum, [, value]) => sum + (value ?? 0), 0);
+    line(io, `Skipped:          ${String(total)}   (each entry includes a reason)`);
+    line(io, `  files:          ${String(fileTotal)}`);
+    line(io, `  graph/search:    ${String(total - fileTotal)}`);
+    line(io, "");
+    line(io, "  by stage:");
+    for (const stage of Object.keys(byStage).sort(compareCodepoints)) {
+        line(io, `    ${stage.padEnd(26)} ${String(byStage[stage] ?? 0)}`);
+    }
+    line(io, "  by reason:");
+    for (const reason of Object.keys(byReason).sort(compareCodepoints)) {
+        line(io, `    ${reason.padEnd(26)} ${String(byReason[reason] ?? 0)}`);
+    }
+    if (truncated > 0) {
+        line(io, `  (${String(truncated)} entries are counted but omitted from the list ` +
+            `listed individually; ${String(listed)} appear in --format=json)`);
+    }
+}
+/**
+ * Die Trefferquote der drei inhaltsadressierten Analyse-Caches (WP-100).
+ *
+ * Sie steht IM BERICHT und nicht nur im Protokoll, weil ein Cache, ueber den
+ * niemand etwas erfaehrt, nicht ueberpruefbar ist: erst die Quote zeigt, ob
+ * der zweite Lauf wirklich gespart hat oder ob nur die Uhr guenstig stand.
+ */
+function analysisCacheLine(c) {
+    const hits = c.parseCacheHits + c.chunkCacheHits + c.metricsCacheHits;
+    const lookups = hits + c.parseCacheMisses + c.chunkCacheMisses + c.metricsCacheMisses;
+    if (lookups === 0) {
+        return "Analysis cache:   off (no cache connected)";
+    }
+    const rate = ((hits / lookups) * 100).toFixed(1);
+    return (`Analysis cache:   ${String(hits)}/${String(lookups)} hits (${rate} %) — ` +
+        `Parse ${String(c.parseCacheHits)}/${String(c.parseCacheHits + c.parseCacheMisses)}, ` +
+        `Chunk ${String(c.chunkCacheHits)}/${String(c.chunkCacheHits + c.chunkCacheMisses)}, ` +
+        `metric ${String(c.metricsCacheHits)}/${String(c.metricsCacheHits + c.metricsCacheMisses)}`);
+}
+//# sourceMappingURL=render.js.map

package/dist/commands/index/render.js.map

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

package/dist/commands/index/target.d.ts

@@ -0,0 +1,34 @@
+import type { EffectiveUntangleConfigV1 } from "@untangle-code/config";
+/** Der Ref, der gemeint ist, wenn kein Git-Zweig lesbar ist. */
+export declare const WORKING_TREE_REF = "working-tree";
+export interface ResolvedTarget {
+    repoId: string;
+    refId: string;
+    refName: string;
+    repoLabel: string;
+    rootPath: string;
+    /** True, wenn das Repository nicht aus der Konfiguration stammt. */
+    synthesized: boolean;
+    /**
+     * `include`/`exclude` des gewaehlten Repositories (spec.md §4.3).
+     *
+     * SIE MUESSEN WEITERGEREICHT WERDEN. Werden sie es nicht, indiziert der Lauf
+     * stumm mehr, als die Konfiguration erlaubt — inklusive des eigenen
+     * Zustandsverzeichnisses `.untangle`, dessen Zwischenspeicherdateien sich
+     * bei jedem Lauf aendern und den naechsten Lauf jedes Mal Arbeit vortaeuschen
+     * lassen. Genau das ist beim ersten Bau dieses Befehls passiert.
+     */
+    include: readonly string[] | undefined;
+    exclude: readonly string[] | undefined;
+}
+export declare function resolveTarget(input: {
+    config: EffectiveUntangleConfigV1;
+    cwd: string;
+    rootFlag: string | undefined;
+    repoFlag: string | undefined;
+    refFlag: string | undefined;
+    configBaseDir: string;
+}): ResolvedTarget;
+/** Zweigname aus `.git/HEAD`, sonst {@link WORKING_TREE_REF}. */
+export declare function detectRefName(rootPath: string): string;
+//# sourceMappingURL=target.d.ts.map

package/dist/commands/index/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../src/commands/index/target.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAKvE,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;;OAQG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,MAAM,EAAE,yBAAyB,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,CA2DjB;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAetD"}

package/dist/commands/index/target.js

@@ -0,0 +1,97 @@
+/**
+ * Welches Repository und welcher Ref indiziert werden.
+ *
+ * ZWEI FAELLE, UND BEIDE MUESSEN EHRLICH SEIN:
+ *
+ * 1. Die Konfiguration nennt Repositories (spec.md §4.3). Dann wird genau
+ *    eines davon gewaehlt — das mit `--repo` benannte, oder das einzige. Bei
+ *    mehreren ohne Angabe wird NICHT geraten, sondern gefragt: ein falsch
+ *    geratenes Repository indiziert stumm das falsche Projekt.
+ * 2. Die Konfiguration nennt keine (der haeufigste Fall beim ersten Aufruf).
+ *    Dann ist das Zielverzeichnis selbst das Repository. Das steht in der
+ *    Ausgabe, damit niemand glaubt, es sei konfiguriert worden.
+ *
+ * DER REFNAME wird aus `.git/HEAD` gelesen, wenn es ihn gibt. Steht dort ein
+ * losgeloester Commit oder gibt es kein Git, heisst der Ref
+ * `"working-tree"` — ein Name, der sagt, was er ist, statt „main" zu
+ * behaupten und damit zwei verschiedene Staende unter derselben Identitaet
+ * abzulegen.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { buildRefId, buildRepoId, compareCodepoints } from "@untangle-code/domain";
+import { UsageError } from "../../cli/exit.js";
+/** Der Ref, der gemeint ist, wenn kein Git-Zweig lesbar ist. */
+export const WORKING_TREE_REF = "working-tree";
+export function resolveTarget(input) {
+    const repositories = input.config.repositories ?? [];
+    if (repositories.length === 0) {
+        const rootPath = path.resolve(input.cwd, input.rootFlag ?? ".");
+        const refName = input.refFlag ?? detectRefName(rootPath);
+        const repoId = buildRepoId({ canonicalPath: rootPath });
+        return {
+            repoId,
+            refId: buildRefId(repoId, refName),
+            refName,
+            repoLabel: path.basename(rootPath),
+            rootPath,
+            synthesized: true,
+            include: undefined,
+            // Ohne Konfiguration gilt wenigstens die eine Regel, die immer stimmt:
+            // das eigene Zustandsverzeichnis ist kein Quelltext.
+            exclude: [".untangle"],
+        };
+    }
+    const chosen = input.repoFlag === undefined
+        ? repositories.length === 1
+            ? repositories[0]
+            : undefined
+        : repositories.find((repo) => repo.id === input.repoFlag);
+    if (chosen === undefined) {
+        const names = repositories.map((repo) => repo.id).sort(compareCodepoints);
+        throw new UsageError(input.repoFlag === undefined
+            ? `The configuration contains ${String(repositories.length)} repositories; which should be indexed?`
+            : `The configuration has no repository "${input.repoFlag}".`, `Select one with --repo=<id>. Known IDs: ${names.join(", ")}.`);
+    }
+    const rootPath = path.resolve(input.configBaseDir, chosen.path);
+    const refName = input.refFlag ?? chosen.ref ?? detectRefName(rootPath);
+    const repoId = buildRepoId({
+        ...(chosen.id === "" ? {} : { explicitId: chosen.id }),
+        canonicalPath: rootPath,
+    });
+    return {
+        repoId,
+        refId: buildRefId(repoId, refName),
+        refName,
+        repoLabel: chosen.label ?? chosen.id,
+        rootPath,
+        synthesized: false,
+        include: chosen.include,
+        exclude: chosen.exclude === undefined
+            ? [".untangle"]
+            : chosen.exclude.includes(".untangle")
+                ? chosen.exclude
+                : [...chosen.exclude, ".untangle"],
+    };
+}
+/** Zweigname aus `.git/HEAD`, sonst {@link WORKING_TREE_REF}. */
+export function detectRefName(rootPath) {
+    try {
+        let gitDir = path.join(rootPath, ".git");
+        try {
+            const pointer = /^gitdir:\s*(.+)$/u.exec(readFileSync(gitDir, "utf8").trim());
+            if (pointer?.[1] !== undefined)
+                gitDir = path.resolve(rootPath, pointer[1]);
+        }
+        catch {
+            /* A normal checkout has a .git directory. */
+        }
+        const head = readFileSync(path.join(gitDir, "HEAD"), "utf8").trim();
+        const match = /^ref:\s*refs\/heads\/(.+)$/u.exec(head);
+        return match?.[1] ?? WORKING_TREE_REF;
+    }
+    catch {
+        return WORKING_TREE_REF;
+    }
+}
+//# sourceMappingURL=target.js.map

package/dist/commands/index/target.js.map

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

package/dist/commands/index-watch.d.ts

@@ -0,0 +1,30 @@
+import type { IndexFreshnessV1 } from "@untangle-code/domain";
+import type { CommandContext } from "../cli/command.js";
+export interface IndexWatchOptions {
+    root: string;
+    repo?: string;
+    ref?: string;
+    embedder: "auto" | "offline";
+    intervalMs: number;
+    format: "text" | "json";
+    outPath: string | null;
+    once: boolean;
+    maxRefreshes: number | null;
+}
+export interface IndexWatchObservation {
+    workspaceId: string;
+    repoId: string;
+    refId: string;
+    freshness: IndexFreshnessV1;
+    /** Bound to exactly the repository/ref that was inspected. */
+    refresh(): Promise<void>;
+}
+export interface IndexWatchDependencies {
+    inspect(ctx: CommandContext, options: IndexWatchOptions): Promise<IndexWatchObservation>;
+    wait(intervalMs: number, signal: AbortSignal): Promise<void>;
+}
+/** One serialized loop: re-read configuration and hash sources, then refresh if necessary. */
+export declare function runIndexWatch(ctx: CommandContext, options: IndexWatchOptions, deps?: IndexWatchDependencies): Promise<number>;
+/** Uses the same registry, scanner freshness check and refresh composition as query --refresh. */
+export declare function inspectIndexWatch(ctx: CommandContext, options: IndexWatchOptions): Promise<IndexWatchObservation>;
+//# sourceMappingURL=index-watch.d.ts.map

package/dist/commands/index-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-watch.d.ts","sourceRoot":"","sources":["../../src/commands/index-watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAWxD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB,CAAC;IAC5B,8DAA8D;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AASD,8FAA8F;AAC9F,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,GAAE,sBAA6C,GAClD,OAAO,CAAC,MAAM,CAAC,CA6EjB;AAED,kGAAkG;AAClG,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAqEhC"}

package/dist/commands/index-watch.js

@@ -0,0 +1,138 @@
+import { setTimeout as wait } from "node:timers/promises";
+import { EXIT, EnvironmentError, UsageError } from "../cli/exit.js";
+import { inspectIndexFreshness } from "../cli/index-freshness.js";
+import { refreshWorkspaceIndex } from "../cli/index-refresh.js";
+import { resolveIndexState } from "../cli/index-state.js";
+import { systemClock } from "../cli/system.js";
+import { loadWorkspace, storageIndexScope, wireStorage } from "../cli/workspace.js";
+import { detectRefName, resolveTarget } from "./index/target.js";
+import { createStreamSink } from "./watch/runtime.js";
+const DEFAULT_DEPENDENCIES = {
+    inspect: inspectIndexWatch,
+    wait: async (intervalMs, signal) => {
+        await wait(intervalMs, undefined, { signal });
+    },
+};
+/** One serialized loop: re-read configuration and hash sources, then refresh if necessary. */
+export async function runIndexWatch(ctx, options, deps = DEFAULT_DEPENDENCIES) {
+    const sink = createStreamSink({ stdout: (chunk) => ctx.io.out(chunk), outPath: options.outPath });
+    let refreshes = 0;
+    const emit = (event, observation, message) => {
+        const record = {
+            schemaVersion: 1,
+            kind: "index_watch",
+            event,
+            checkedAt: observation?.freshness.checkedAt ?? systemClock.nowIso(),
+            refreshes,
+            ...(observation === undefined
+                ? {}
+                : {
+                    workspaceId: observation.workspaceId,
+                    repoId: observation.repoId,
+                    refId: observation.refId,
+                    indexFreshness: observation.freshness,
+                }),
+            ...(message === undefined ? {} : { message }),
+        };
+        sink.write(options.format === "json"
+            ? JSON.stringify(record)
+            : `Search index: ${event}${observation === undefined ? "" : ` ${observation.repoId}/${observation.refId}: ${observation.freshness.status}`}${message === undefined ? "" : ` — ${message}`}`);
+    };
+    let observation;
+    try {
+        while (true) {
+            ctx.signal.throwIfAborted();
+            observation = await deps.inspect(ctx, options);
+            ctx.signal.throwIfAborted();
+            emit("checked", observation);
+            if (observation.freshness.status !== "fresh") {
+                emit("refresh_started", observation);
+                await observation.refresh();
+                ctx.signal.throwIfAborted();
+                refreshes++;
+                observation = await deps.inspect(ctx, options);
+                ctx.signal.throwIfAborted();
+                emit("refreshed", observation);
+                if (observation.freshness.status === "unknown" ||
+                    observation.freshness.status === "incompatible") {
+                    throw new EnvironmentError("Could not confirm a compatible search index after the update.", "Check `untangle doctor` and the index report on stderr.");
+                }
+            }
+            if (options.once || (options.maxRefreshes !== null && refreshes >= options.maxRefreshes)) {
+                if (observation.freshness.status !== "fresh") {
+                    throw new EnvironmentError("Sources changed again during indexing; the search index is still stale.", "Keep watch --index running without --baseline-only/--exit-after, or repeat the update.");
+                }
+                emit("stopped", observation, "The requested number of checks/updates has been reached.");
+                return EXIT.ok;
+            }
+            await deps.wait(options.intervalMs, ctx.signal);
+        }
+    }
+    catch (error) {
+        if (ctx.signal.aborted || (error instanceof Error && error.name === "AbortError")) {
+            emit("stopped", observation, "Cancelled; any running indexing job was stopped cleanly.");
+            return EXIT.cancelled;
+        }
+        emit("failed", observation, error instanceof Error ? error.message : String(error));
+        throw error;
+    }
+    finally {
+        await sink.close();
+    }
+}
+/** Uses the same registry, scanner freshness check and refresh composition as query --refresh. */
+export async function inspectIndexWatch(ctx, options) {
+    const view = loadWorkspace({ cwd: options.root, env: ctx.env, strict: true });
+    if (options.repo !== undefined && (view.config.repositories ?? []).length === 0) {
+        throw new UsageError("--repo requires a configured repository.", "Select the project tree with --root.");
+    }
+    const target = resolveTarget({
+        config: view.config,
+        cwd: options.root,
+        rootFlag: options.root,
+        repoFlag: options.repo,
+        refFlag: options.ref,
+        configBaseDir: view.load.sources.configBaseDir,
+    });
+    if (detectRefName(target.rootPath) !== target.refName) {
+        throw new UsageError(`Ref ${target.refName} is not checked out in ${target.rootPath}.`, "Switch to the matching worktree before watching the search index.");
+    }
+    const resolution = await resolveIndexState([target.rootPath], view.workspaceId, {
+        repoIds: [target.repoId],
+        refs: [target.refId],
+        ...storageIndexScope(wireStorage(view, ctx.env)),
+    });
+    ctx.signal.throwIfAborted();
+    if (resolution.kind === "invalid") {
+        throw new EnvironmentError(`The local index state is invalid: ${resolution.diagnostics.map((entry) => `${entry.path}: ${entry.message}`).join("; ")}`, "Rerun the affected indexing job before starting watch --index.");
+    }
+    if (resolution.kind === "ambiguous" && options.embedder === "auto") {
+        throw new UsageError("Current index profiles conflict.", "Select --embedder=offline or repair the index registry.");
+    }
+    const current = resolution.kind === "resolved"
+        ? resolution.current
+        : resolution.kind === "ambiguous"
+            ? resolution.found
+            : [];
+    const states = options.embedder === "offline"
+        ? current.filter((entry) => entry.state.embedder === "offline")
+        : current;
+    const embedder = options.embedder === "offline" ||
+        (resolution.kind === "resolved" && resolution.embedder === "offline")
+        ? "offline"
+        : "auto";
+    const freshness = await inspectIndexFreshness(view, states, { signal: ctx.signal });
+    return {
+        workspaceId: view.workspaceId,
+        repoId: target.repoId,
+        refId: target.refId,
+        freshness,
+        refresh: () => refreshWorkspaceIndex(ctx, {
+            view,
+            ...(target.synthesized ? {} : { repoIds: [target.repoId] }),
+            refIds: [target.refName],
+            embedder,
+        }),
+    };
+}
+//# sourceMappingURL=index-watch.js.map

package/dist/commands/index-watch.js.map

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

package/dist/commands/init/command.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `untangle init` as the CLI shell sees it.
+ *
+ * This is the ONLY file of the command that knows about argv, exit codes and
+ * a terminal. Everything else (`run.ts` and below) is a library over ports,
+ * which is why the whole detection pipeline is testable without a process,
+ * without a network and without `node:fs`.
+ */
+import { type ParsedArgs } from "../../cli/args.js";
+import type { Command } from "../../cli/command.js";
+import { type InitDepsV1, type InitOptionsV1 } from "./run.js";
+import { type InitWizardDepsV1 } from "./wizard.js";
+/** argv → options. Rejects the ambiguous call rather than picking a winner. */
+export declare function initOptionsFrom(args: ParsedArgs, cwd: string): InitOptionsV1;
+/**
+ * Builds the command. `deps` exists so a test can hand in an in-memory file
+ * system and a probe that answers nothing; production calls it with none.
+ */
+export interface InitCommandDepsV1 extends InitDepsV1 {
+    wizard?: Partial<InitWizardDepsV1>;
+}
+export declare function createInitCommand(deps?: InitCommandDepsV1): Command;
+/** The command with production ports. */
+export declare const initCommand: Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/commands/init/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/init/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAkD,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,sBAAsB,CAAC;AAKpE,OAAO,EAA6B,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE1F,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiEnE,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAkC5E;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAyGvE;AAED,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,OAA6B,CAAC"}