@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/watch/runtime.js

@@ -0,0 +1,149 @@
+/**
+ * Die Laufzeitkanten des Waechters: Uhr, Zufall, Ignorierregeln, Ausgabe.
+ *
+ * Alles hier ist bewusst DUENN. Es ist der Kompositionswurzel-Anteil des
+ * CLI — die Stelle, an der die reinen Pakete an echte Uhr, echten Zufall und
+ * echte Dateien angeschlossen werden. Kein Paket unterhalb davon liest
+ * jemals selbst die Uhr oder `node:fs` (siehe die Port-Dokumentation in
+ * `packages/domain/src/ports.ts`).
+ */
+import { createHash, randomBytes, randomUUID } from "node:crypto";
+import { createWriteStream, readFileSync } from "node:fs";
+import path from "node:path";
+import { createIgnoreEngine } from "@untangle-code/scanner";
+/**
+ * Wanduhrzeit fuer Protokollzeitstempel und die Buchfuehrung der Lock-Lease.
+ * Ergebnisdaten (Metriken, Deltas) enthalten NIE eine Uhrzeit — dort waere
+ * sie ein Determinismusbruch; hier ist sie genau der Zweck.
+ */
+export class SystemClock {
+    nowEpochMs() {
+        // Die EINZIGE echte Uhrzeitablesung des Waechters, und zwar mit Absicht
+        // an genau dieser Stelle: `SystemClock` IST die Umsetzung des
+        // `Clock`-Ports. Jede andere Datei dieses Kommandos liest die Zeit nur
+        // ueber den Port (`deps.clock`), damit ein Test sie durch eine feste Uhr
+        // ersetzen kann. Dieselbe Ausnahme, dieselbe Begruendung wie in
+        // `packages/storage-local/src/real-time.ts` und `@untangle-code/testkit`.
+        // eslint-disable-next-line no-restricted-syntax -- siehe Begruendung darueber.
+        return Date.now();
+    }
+    nowIso() {
+        return new Date(this.nowEpochMs()).toISOString();
+    }
+}
+/**
+ * Kryptografischer Zufall fuer Lock-Datensatz-Ids. Ebenfalls kein Bestandteil
+ * von Ergebnisdaten — `FileLockProvider` braucht eine eindeutige Kennung je
+ * Lease, sonst koennte ein zweiter Prozess eine fremde Lease erneuern.
+ */
+export class CryptoRandom {
+    nextFloat() {
+        const buffer = randomBytes(6).readUIntBE(0, 6);
+        return buffer / 2 ** 48;
+    }
+    nextInt(maxExclusive) {
+        if (!Number.isInteger(maxExclusive) || maxExclusive <= 0) {
+            throw new RangeError(`nextInt requires a positive integer; received ${maxExclusive}`);
+        }
+        return Math.floor(this.nextFloat() * maxExclusive);
+    }
+    bytes(length) {
+        return new Uint8Array(randomBytes(length));
+    }
+    uuid() {
+        return randomUUID();
+    }
+}
+/**
+ * Ignorierregeln fuer den Watcher.
+ *
+ * `RepoWatcher`/`reconcileTree` kennen absichtlich keine
+ * `.gitignore`-Schichtung (siehe deren Modul-Doku: "a caller wiring a real
+ * indexing pipeline is expected to pass an `ignore` backed by scanner's own
+ * `IgnoreEngine`") — genau das passiert hier.
+ *
+ * DER EIGENE ZUSTANDSORDNER IST IMMER AUSGESCHLOSSEN. `.untangle/` steht zwar
+ * in der `.gitignore` DIESES Repositories, aber darauf darf sich der Waechter
+ * nicht verlassen: wird ein Unterverzeichnis ohne eigene `.gitignore` als
+ * `--root` beobachtet, legt der Waechter dort seinen Lock ab, sieht die
+ * Lock-Datei als Aenderung, erneuert die Lease, sieht die naechste Aenderung —
+ * eine Rueckkopplung auf sich selbst. Der Ausschluss ist deshalb fest
+ * verdrahtet und nicht ueber eine Regeldatei erschlagen.
+ *
+ * BEKANNTE GRENZE, ausdruecklich benannt statt verschwiegen: der Watcher
+ * ruft das Praedikat mit einem Pfad auf, OHNE zu sagen, ob es ein
+ * Verzeichnis ist (der `stat` folgt erst danach). Das Praedikat fragt die
+ * `IgnoreEngine` deshalb in beiden Lesarten und ignoriert, sobald eine der
+ * beiden ignoriert. Ausserdem wird nur die `.gitignore` der Baumwurzel als
+ * Schicht gelegt, keine verschachtelten — der Scanner leistet das im
+ * Indexlauf, der Waechter hier nicht.
+ */
+/** Der Zustandsordner des Waechters, relativ zum beobachteten Baum. */
+export const STATE_DIR_NAME = ".untangle";
+export function createIgnorePredicate(rootPath) {
+    const engine = createIgnoreEngine();
+    const rootGitignore = readFileIfPresent(path.join(rootPath, ".gitignore"));
+    if (rootGitignore !== null)
+        engine.pushGitignoreLayer("", rootGitignore);
+    const rootUntangleignore = readFileIfPresent(path.join(rootPath, ".untangleignore"));
+    if (rootUntangleignore !== null)
+        engine.pushUntangleIgnoreLayer("", rootUntangleignore);
+    const cache = new Map();
+    return (relativePath) => {
+        const cached = cache.get(relativePath);
+        if (cached !== undefined)
+            return cached;
+        const decision = relativePath === STATE_DIR_NAME ||
+            relativePath.startsWith(`${STATE_DIR_NAME}/`) ||
+            engine.decide(relativePath, false).ignored ||
+            engine.decide(relativePath, true).ignored;
+        cache.set(relativePath, decision);
+        return decision;
+    };
+}
+function readFileIfPresent(absolutePath) {
+    try {
+        return readFileSync(absolutePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export function createStreamSink(options) {
+    let file = null;
+    if (options.outPath !== null) {
+        file = createWriteStream(options.outPath, { flags: "a", encoding: "utf8" });
+    }
+    return {
+        write(line) {
+            options.stdout(`${line}\n`);
+            file?.write(`${stripAnsi(line)}\n`);
+        },
+        async close() {
+            const stream = file;
+            if (stream === null)
+                return;
+            await new Promise((resolve) => {
+                stream.end(() => {
+                    resolve();
+                });
+            });
+        },
+    };
+}
+/**
+ * Entfernt ANSI-Steuerzeichen fuer die Mitschrift. Eine Logdatei voller
+ * Farbcodes ist keine Mitschrift.
+ */
+export function stripAnsi(text) {
+    // Es GEHT hier um ein Steuerzeichen: die Regel warnt vor einem versehentlich
+    // in ein Muster geratenen Steuerzeichen, und genau dieses soll entfernt
+    // werden.
+    // eslint-disable-next-line no-control-regex -- siehe Begruendung darueber.
+    return text.replace(/\u001B\[[0-9;]*m/g, "");
+}
+/** SHA-256-Hex, fuer die kurze Kennung des gemessenen Standes. */
+export function shortDigest(input) {
+    return createHash("sha256").update(input, "utf8").digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/commands/watch/runtime.js.map

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

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

@@ -0,0 +1,3 @@
+import type { Command } from "../cli/command.js";
+export declare const watchCommand: Command;
+//# sourceMappingURL=watch-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch-command.d.ts","sourceRoot":"","sources":["../../src/commands/watch-command.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAuIjE,eAAO,MAAM,YAAY,EAAE,OA0I1B,CAAC"}

package/dist/commands/watch-command.js

@@ -0,0 +1,273 @@
+/**
+ * `watch` als Unterbefehl des CLI-Rahmens (WP-124) — die Naht zwischen dem
+ * Befehlsvertrag aus `src/cli/command.ts` und dem Komplexitaetswaechter aus
+ * `src/commands/watch/` (WP-128).
+ *
+ * WARUM DIESE DATEI HIER LIEGT UND NICHT IN `commands/watch/`: der Waechter
+ * ist bewusst frei von Abhaengigkeiten auf den Rahmen — er baut und laeuft
+ * fuer sich allein (`tsconfig.watch.json`, `dist/commands/watch/cli.js`).
+ * Die Abhaengigkeit zeigt deshalb in genau eine Richtung: dieser Adapter
+ * kennt beide Seiten, der Waechter kennt den Rahmen nicht.
+ *
+ * WAS DIESE DATEI ERSETZT: `commands/unavailable.ts` fuehrte `watch` bisher
+ * als noch nicht gebaute Faehigkeit. Das stimmt nicht mehr; einen fertigen
+ * Befehl weiter als unverfuegbar auszuweisen waere dieselbe Unwahrheit wie
+ * eine vorgetaeuschte Faehigkeit, nur in die andere Richtung.
+ */
+import { hostname } from "node:os";
+import path from "node:path";
+import { enumFlag, integerFlag, stringFlag } from "../cli/args.js";
+import { EXIT, UsageError } from "../cli/exit.js";
+import { runIndexWatch } from "./index-watch.js";
+import { parseWatchArgs } from "./watch/options.js";
+import { runWatch } from "./watch/run.js";
+import { CryptoRandom, SystemClock } from "./watch/runtime.js";
+const FLAGS = {
+    index: {
+        kind: "boolean",
+        describe: "Keep the search index current: check freshness and update changes serially",
+        defaultLabel: "off; otherwise complexity stream",
+    },
+    repo: {
+        kind: "string",
+        placeholder: "ID",
+        describe: "--index: configured repository; required when several are configured",
+    },
+    ref: {
+        kind: "string",
+        placeholder: "NAME",
+        describe: "--index: checked-out ref; otherwise the current branch",
+    },
+    embedder: {
+        kind: "string",
+        placeholder: "auto|offline",
+        describe: "--index: current index profile, otherwise service; offline explicitly uses local vectors",
+        defaultLabel: "auto",
+    },
+    root: {
+        kind: "string",
+        placeholder: "PATH",
+        describe: "Tree to watch",
+        defaultLabel: "current directory",
+    },
+    "repo-id": {
+        kind: "string",
+        placeholder: "ID",
+        describe: "Repository identity for the ref lock",
+        defaultLabel: "directory name",
+    },
+    "ref-id": {
+        kind: "string",
+        placeholder: "ID",
+        describe: "Ref identity for the ref lock",
+        defaultLabel: "<repo-id>:working-tree",
+    },
+    format: {
+        kind: "string",
+        placeholder: "text|json",
+        describe: "Stream output format; json writes one JSON line per event",
+        defaultLabel: "text",
+    },
+    out: {
+        kind: "string",
+        placeholder: "FILE",
+        describe: "Also save the stream, always without control characters",
+    },
+    color: {
+        kind: "boolean",
+        describe: "Terminal colors (--no-color disables them)",
+        defaultLabel: "enabled when stdout is a terminal",
+    },
+    debounce: {
+        kind: "number",
+        placeholder: "MS",
+        describe: "Debounce quiet period",
+        defaultLabel: "200",
+    },
+    reconcile: {
+        kind: "number",
+        placeholder: "MS",
+        describe: "Reconciliation interval; --index: freshness-check interval",
+        defaultLabel: "30000",
+    },
+    "max-file-bytes": {
+        kind: "number",
+        placeholder: "N",
+        describe: "Maximum file size; larger files enter the ledger with a reason",
+        defaultLabel: "5242880",
+    },
+    scopes: {
+        kind: "number",
+        placeholder: "N",
+        describe: "Maximum contribution locations reported per change",
+        defaultLabel: "5",
+    },
+    "exit-after": {
+        kind: "number",
+        placeholder: "N",
+        describe: "Stop cleanly after N changes; --index: after N updates",
+        defaultLabel: "on signal only",
+    },
+    "baseline-only": {
+        kind: "boolean",
+        describe: "Baseline only; --index: check freshness once and update if needed",
+        defaultLabel: "off",
+    },
+};
+/**
+ * Setzt die zerlegten Flags in die kanonische Aufrufform des Waechters
+ * zurueck und laesst dessen EIGENEN Parser darueber laufen.
+ *
+ * Das sieht nach einem Umweg aus und ist genau deshalb richtig: Vorgaben,
+ * Wertebereiche und Fehlermeldungen des Waechters stehen damit an EINER
+ * Stelle (`watch/options.ts`) und koennen zwischen dem Rahmenaufruf
+ * (`untangle watch`) und dem Direktaufruf (`dist/commands/watch/cli.js`)
+ * nicht auseinanderlaufen. Eine zweite, hier nachgebaute Vorgabenliste waere
+ * die klassische Stelle, an der ein Werkzeug je nach Aufrufweg etwas anderes
+ * tut.
+ */
+function toWatchArgv(args) {
+    const argv = [];
+    const push = (name, value) => {
+        if (value === undefined)
+            return;
+        argv.push(`--${name}`, String(value));
+    };
+    push("root", args.flags["root"]);
+    push("repo-id", args.flags["repo-id"]);
+    push("ref-id", args.flags["ref-id"]);
+    push("format", args.flags["format"]);
+    push("out", args.flags["out"]);
+    push("debounce", args.flags["debounce"]);
+    push("reconcile", args.flags["reconcile"]);
+    push("max-file-bytes", args.flags["max-file-bytes"]);
+    push("scopes", args.flags["scopes"]);
+    push("exit-after", args.flags["exit-after"]);
+    if (args.flags["color"] === false)
+        argv.push("--no-color");
+    if (args.flags["baseline-only"] === true)
+        argv.push("--baseline-only");
+    return argv;
+}
+export const watchCommand = {
+    spec: {
+        name: "watch",
+        implementedBy: "commands/watch-command.js",
+        summary: "Complexity monitoring: metric deltas for every change",
+        usage: "untangle watch [--index] [--root=<PATH>] [--format=json] [--out=<FILE>]",
+        details: [
+            "--index selects search-index mode: at startup and each --reconcile interval, " +
+                "source hashes and the index contract are checked. Stale, incompatible or missing indexes are " +
+                "updated serially. --repo is required with multiple repositories; a ref that is not checked out " +
+                "is never updated. --format=json emits index status as JSONL; index reports go to stderr.",
+            "Watches a tree and reports each metric's delta for every change, " +
+                "structural, semantic, cyclomatic, cognitive, including direction: did the " +
+                'change reduce or increase complexity? "cognitive 34 -> 21 ' +
+                '(-13, reduced)" describes the change rather than only a raw number.',
+            "The three scope metrics aggregate by metrics_scope_id without " +
+                "double-counting, using execution_unit scope (spec.md §16.10). The " +
+                "semantic load sums the file's chunks and therefore uses " +
+                "file_chunks scope. Each number identifies its measurement scope.",
+            "A file that could not be analyzed appears in the same stream, " +
+                "with a reason and details. Silently omitted files could make " +
+                "a partial result appear complete; " +
+                "silence does not prove that nothing changed.",
+            "Reduced means complexity decreased. It does not prove that " +
+                "the change improved the code; vision.md §1b requires " +
+                "an unchanged symbol interface, unchanged tests and unchanged " +
+                "dependency edges, which this command does not measure.",
+            "SIGINT/SIGTERM stops cleanly: watcher stopped, stream closed, " +
+                "the ref lock released. The final event reports whether the lock was " +
+                "actually released, based on an inspection.",
+        ],
+        flags: FLAGS,
+        examples: [
+            "untangle watch",
+            "untangle watch --format=json --out=complexity.jsonl",
+            "untangle watch --root=packages/search --scopes=3",
+            "untangle watch --baseline-only",
+            "untangle watch --index --reconcile=30000",
+            "untangle watch --index --repo=backend --embedder=offline --format=json",
+        ],
+        exitCodes: [
+            [EXIT.ok, "Stopped cleanly."],
+            [EXIT.operational, "Operational error; for example, another run holds the ref lock."],
+            [EXIT.usage, "Invalid arguments."],
+            [EXIT.environment, "--index: indexing or environment is not ready."],
+            [EXIT.cancelled, "--index: cancelled cleanly by a signal."],
+        ],
+    },
+    async run(ctx, args) {
+        if (args.positionals.length > 0) {
+            throw new UsageError(`"untangle watch" does not accept positional arguments; received "${args.positionals[0] ?? ""}".`, "Specify the watched tree with --root.");
+        }
+        if (args.flags["index"] === true) {
+            for (const name of ["repo-id", "ref-id", "debounce", "max-file-bytes", "scopes", "color"]) {
+                if (args.flags[name] !== undefined)
+                    throw new UsageError(`--${name} applies to the complexity watcher, not --index.`, "Use --repo/--ref to select the index and --reconcile for the check interval.");
+            }
+            const intervalMs = integerFlag(args, "reconcile", 30_000);
+            const maxRefreshes = args.flags["exit-after"] === undefined ? null : integerFlag(args, "exit-after", 1);
+            if (intervalMs === 0 || intervalMs > 2_147_483_647 || maxRefreshes === 0) {
+                throw new UsageError("--reconcile and --exit-after must be positive integers; --reconcile is limited to 2147483647 ms.", "Example: untangle watch --index --reconcile=30000.");
+            }
+            const repo = stringFlag(args, "repo");
+            const ref = stringFlag(args, "ref");
+            const out = stringFlag(args, "out");
+            return runIndexWatch(ctx, {
+                root: path.resolve(ctx.cwd, stringFlag(args, "root") ?? "."),
+                ...(repo === undefined ? {} : { repo }),
+                ...(ref === undefined ? {} : { ref }),
+                embedder: enumFlag(args, "embedder", ["auto", "offline"], "auto"),
+                intervalMs,
+                format: enumFlag(args, "format", ["text", "json"], "text"),
+                outPath: out === undefined ? null : path.resolve(ctx.cwd, out),
+                once: args.flags["baseline-only"] === true,
+                maxRefreshes,
+            });
+        }
+        if (["repo", "ref", "embedder"].some((name) => args.flags[name] !== undefined)) {
+            throw new UsageError("--repo, --ref and --embedder require --index.", "The complexity watcher uses --repo-id and --ref-id.");
+        }
+        const parsed = parseWatchArgs(toWatchArgv(args), {
+            cwd: ctx.cwd,
+            isTty: process.stdout.isTTY === true,
+            noColorEnv: ctx.env["NO_COLOR"],
+        });
+        if (!parsed.ok) {
+            throw new UsageError(parsed.message, 'See "untangle watch --help" for supported options.');
+        }
+        const exitCode = await runWatch(parsed.options, {
+            clock: new SystemClock(),
+            random: new CryptoRandom(),
+            stdout: (chunk) => {
+                ctx.io.out(chunk);
+            },
+            stderr: (chunk) => {
+                ctx.io.err(chunk);
+            },
+            host: hostname(),
+            /**
+             * Der Rahmen faengt SIGINT/SIGTERM bereits ab und bricht `ctx.signal`
+             * ab; der Waechter haengt sich deshalb an DIESES Signal statt einen
+             * zweiten Griff auf denselben Prozess zu legen. Die zurueckgegebene
+             * Abmeldung loest den Zuhoerer, sobald der Abbau laeuft.
+             */
+            installSignalHandler: (handler) => {
+                if (ctx.signal.aborted) {
+                    handler("SIGINT");
+                    return () => undefined;
+                }
+                const onAbort = () => {
+                    handler("SIGINT");
+                };
+                ctx.signal.addEventListener("abort", onAbort, { once: true });
+                return () => {
+                    ctx.signal.removeEventListener("abort", onAbort);
+                };
+            },
+        });
+        return exitCode === 0 ? EXIT.ok : EXIT.operational;
+    },
+};
+//# sourceMappingURL=watch-command.js.map

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

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

package/dist/entry-point.d.ts

@@ -0,0 +1,11 @@
+/**
+ * True when the module identified by `moduleUrl` is the entry point named by
+ * `entryPath` (normally `process.argv[1]`).
+ *
+ * BOTH sides are canonicalized, not just `entryPath`. The module URL is
+ * usually already resolved, but "usually" is not a guarantee worth betting the
+ * program's existence on — and on macOS the `/var` → `/private/var` alias
+ * makes the two differ even without a symlink in the picture.
+ */
+export declare function isEntryPoint(moduleUrl: string, entryPath: string | undefined): boolean;
+//# sourceMappingURL=entry-point.d.ts.map

package/dist/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../src/entry-point.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CActF"}

package/dist/entry-point.js

@@ -0,0 +1,65 @@
+/**
+ * "Is this module the program, or did something import it?"
+ *
+ * The obvious answer — compare `import.meta.url` with
+ * `pathToFileURL(process.argv[1])` — is wrong in exactly the situation this
+ * package is built for. `npm install --global` does not copy the binary into
+ * the global bin directory; on POSIX it creates a SYMLINK there. Node's ESM
+ * loader resolves symlinks, so `import.meta.url` is the real path inside the
+ * package while `argv[1]` is the symlink in `…/bin`. The two never match, the
+ * guard says "imported", and the installed `untangle` prints nothing and exits
+ * 0 — a tool that silently does nothing, which is the worst possible outcome
+ * of a one-line installation.
+ *
+ * So both sides are canonicalized before they are compared. A path that
+ * cannot be resolved (deleted between spawn and check, `node --eval`, a
+ * platform quirk) falls back to the unresolved comparison rather than
+ * throwing: failing to start over a `realpath` error would trade one silent
+ * failure for a louder one.
+ */
+import { realpathSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+/**
+ * True when the module identified by `moduleUrl` is the entry point named by
+ * `entryPath` (normally `process.argv[1]`).
+ *
+ * BOTH sides are canonicalized, not just `entryPath`. The module URL is
+ * usually already resolved, but "usually" is not a guarantee worth betting the
+ * program's existence on — and on macOS the `/var` → `/private/var` alias
+ * makes the two differ even without a symlink in the picture.
+ */
+export function isEntryPoint(moduleUrl, entryPath) {
+    if (entryPath === undefined || entryPath === "") {
+        return false;
+    }
+    if (moduleUrl === pathToFileURL(entryPath).href) {
+        return true;
+    }
+    const canonicalModule = canonical(safeFileUrlToPath(moduleUrl));
+    const canonicalEntry = canonical(entryPath);
+    return (canonicalModule !== undefined &&
+        canonicalEntry !== undefined &&
+        canonicalModule === canonicalEntry);
+}
+function safeFileUrlToPath(moduleUrl) {
+    try {
+        return fileURLToPath(moduleUrl);
+    }
+    catch {
+        // Not a file: URL at all (data:, node:, an http import). Then this module
+        // is certainly not a file on disk that argv[1] could name.
+        return undefined;
+    }
+}
+function canonical(path) {
+    if (path === undefined) {
+        return undefined;
+    }
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=entry-point.js.map

package/dist/entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../src/entry-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,SAA6B;IAC3E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,eAAe,GAAG,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,CACL,eAAe,KAAK,SAAS;QAC7B,cAAc,KAAK,SAAS;QAC5B,eAAe,KAAK,cAAc,CACnC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,2DAA2D;QAC3D,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * `untangle` — der Einstiegspunkt (WP-124).
+ *
+ * Dieses Modul tut vier Dinge und sonst nichts:
+ *   1. es waehlt den Unterbefehl,
+ *   2. es zerlegt die Argumente gegen dessen Spezifikation,
+ *   3. es reicht ein Abbruchsignal durch (SIGINT/SIGTERM),
+ *   4. es uebersetzt Fehler in Exit-Codes und Meldungen auf stderr.
+ *
+ * NUTZDATEN GEHEN NACH STDOUT, ALLES ANDERE NACH STDERR — auch die
+ * Hilfetexte zu Fehlern. Das ist die Regel, die `untangle query
+ * --format=jsonl | jq` benutzbar haelt.
+ */
+import { type Command } from "./cli/command.js";
+import { type Io } from "./cli/io.js";
+/** Version des Binaers. Bewusst hier und nicht aus package.json gelesen: der
+ * gebaute `dist/` liegt eine Ebene tiefer als das Manifest, und ein Lesefehler
+ * beim Start waere ein absurder Grund, an `--version` zu scheitern. */
+export { CLI_VERSION } from "./cli/version.js";
+/**
+ * Die Reihenfolge ist die des Nutzerwegs, nicht das Alphabet: einrichten,
+ * indizieren, suchen, messen, verstehen, beobachten, diagnostizieren,
+ * erweitern.
+ */
+export declare const COMMANDS: readonly Command[];
+export interface RunOptions {
+    readonly io?: Io;
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Der ganze Ablauf als Funktion — testbar, ohne einen Prozess zu starten.
+ * `main()` unten ist nur die duenne Huelle darum.
+ */
+export declare function run(argv: readonly string[], options?: RunOptions): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAA2B,KAAK,OAAO,EAAuB,MAAM,kBAAkB,CAAC;AAE9F,OAAO,EAAyB,KAAK,EAAE,EAAE,MAAM,aAAa,CAAC;AAyB7D;;uEAEuE;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAatC,CAAC;AAwEF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IACjB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD5F"}