@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/index.js

@@ -0,0 +1,245 @@
+#!/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 { compareCodepoints } from "@untangle-code/domain";
+import { parseArgs } from "./cli/args.js";
+import { renderCommandHelp, wrap } from "./cli/command.js";
+import { CliError, EXIT, UsageError } from "./cli/exit.js";
+import { line, note, processIo } from "./cli/io.js";
+import { CLI_VERSION } from "./cli/version.js";
+import { complexityCommand } from "./commands/complexity.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { extensionsCommand } from "./commands/extensions.js";
+// WP-229: `graph` und `flow` sind GEBAUT und kommen deshalb nicht mehr aus
+// `unavailable.ts` — sie lesen den Graphen zurueck, den `untangle index`
+// ablegt. Siehe `commands/graph/index.ts` und `commands/flow/index.ts`.
+import { flowCommand } from "./commands/flow/index.js";
+import { graphCommand } from "./commands/graph/index.js";
+// WP-218: die VOLLSTAENDIGE init-Implementierung liegt unter
+// `commands/init/`. Bis WP-218 zeigte dieser Import auf einen gleichnamigen
+// Stub `commands/init.ts` daneben — gebaut, getestet, aber nie verdrahtet.
+// `command-wiring.test.ts` laesst diesen Fehler nicht wiederkehren.
+import { indexCommand } from "./commands/index/index.js";
+import { initCommand } from "./commands/init/index.js";
+import { mcpCommand } from "./commands/mcp.js";
+import { productCommand } from "./commands/product.js";
+import { queryCommand } from "./commands/query.js";
+import { scanCommand } from "./commands/scan.js";
+// WP-128: `watch` ist gebaut und wird deshalb NICHT mehr aus
+// `unavailable.ts` bezogen. Siehe `commands/watch-command.ts`.
+import { watchCommand } from "./commands/watch-command.js";
+import { isEntryPoint } from "./entry-point.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 const COMMANDS = [
+    initCommand,
+    indexCommand,
+    queryCommand,
+    complexityCommand,
+    productCommand,
+    scanCommand,
+    graphCommand,
+    flowCommand,
+    mcpCommand,
+    watchCommand,
+    doctorCommand,
+    extensionsCommand,
+];
+const BY_NAME = new Map(COMMANDS.map((command) => [command.spec.name, command]));
+function renderRootHelp() {
+    const lines = [];
+    lines.push("untangle — local code intelligence: search, complexity and graphs.", "");
+    lines.push("USAGE", "  untangle <command> [options]", "  untangle <command> --help", "");
+    lines.push("COMMANDS");
+    const width = Math.max(...COMMANDS.map((command) => command.spec.name.length));
+    for (const command of COMMANDS) {
+        const name = command.spec.name.padEnd(width);
+        lines.push(`  ${name}  ${command.spec.summary}`);
+    }
+    lines.push("");
+    lines.push("GLOBAL OPTIONS");
+    lines.push("  -h, --help     Show this help or help for a command.");
+    lines.push("  -V, --version  Print the version.");
+    lines.push("");
+    lines.push("EXIT-CODES");
+    lines.push("  0  Success.");
+    lines.push("  1  Operational error.");
+    lines.push("  2  Invalid arguments.");
+    lines.push("  3  Capability not yet implemented.");
+    lines.push("  4  Environment not ready (Ollama/Qdrant/index).");
+    lines.push("  5  Quality gate failed.");
+    lines.push("  130 Cancelled.");
+    lines.push("");
+    const pending = COMMANDS.filter((command) => command.spec.notYetBuilt === true).map((command) => command.spec.name);
+    if (pending.length > 0) {
+        lines.push("IMPLEMENTATION STATUS");
+        for (const wrapped of wrap(`The commands ${pending.join(", ")} are registered, but their capabilities are not yet ` +
+            "implemented. They report this explicitly and exit with code 3. " +
+            "Use `untangle <command> --help` to inspect the missing capability.", 76)) {
+            lines.push(`  ${wrapped}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Nennt den aehnlichsten Befehl, wenn sich jemand vertippt hat. */
+function suggest(name) {
+    const candidates = [...BY_NAME.keys()]
+        .map((candidate) => ({ candidate, distance: editDistance(name, candidate) }))
+        .filter((entry) => entry.distance <= 3)
+        .sort((a, b) => a.distance - b.distance || compareCodepoints(a.candidate, b.candidate));
+    return candidates[0]?.candidate;
+}
+function editDistance(a, b) {
+    const rows = [];
+    for (let i = 0; i <= a.length; i++)
+        rows.push(new Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        rows[i][0] = i;
+    for (let j = 0; j <= b.length; j++)
+        rows[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);
+        }
+    }
+    return rows[a.length][b.length];
+}
+/**
+ * Der ganze Ablauf als Funktion — testbar, ohne einen Prozess zu starten.
+ * `main()` unten ist nur die duenne Huelle darum.
+ */
+export async function run(argv, options = {}) {
+    const io = options.io ?? processIo;
+    const ctx = {
+        io,
+        cwd: options.cwd ?? process.cwd(),
+        env: options.env ?? process.env,
+        signal: options.signal ?? new AbortController().signal,
+    };
+    const first = argv[0];
+    if (first === undefined || first === "--help" || first === "-h" || first === "help") {
+        io.out(renderRootHelp());
+        return EXIT.ok;
+    }
+    if (first === "--version" || first === "-V") {
+        line(io, CLI_VERSION);
+        return EXIT.ok;
+    }
+    if (first.startsWith("-")) {
+        return fail(io, new UsageError(`Expected a command, received the option "${first}".`, "Run `untangle --help`; the global options are --help and --version."));
+    }
+    const command = BY_NAME.get(first);
+    if (command === undefined) {
+        const hint = suggest(first);
+        return fail(io, new UsageError(`Unknown command "${first}".`, hint === undefined
+            ? "Run `untangle --help` to list all commands."
+            : `Did you mean \`untangle ${hint}\`? \`untangle --help\` lists all commands.`));
+    }
+    const rest = argv.slice(1);
+    if (rest.includes("--help") || rest.includes("-h")) {
+        io.out(renderCommandHelp(command.spec));
+        return EXIT.ok;
+    }
+    try {
+        const args = parseArgs(rest, command.spec.flags);
+        return await command.run(ctx, args);
+    }
+    catch (error) {
+        return fail(io, error);
+    }
+}
+/**
+ * Ein Fehler wird zu genau drei Zeilen auf stderr: was war, was zu tun ist,
+ * und — nur wenn es eine Ursache gibt — woran es lag.
+ */
+function fail(io, error) {
+    if (error instanceof CliError) {
+        note(io, `Error: ${error.message}`);
+        if (error.nextStep !== undefined) {
+            note(io, `Next step: ${error.nextStep}`);
+        }
+        return error.exitCode;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+        note(io, "Cancelled.");
+        return EXIT.cancelled;
+    }
+    note(io, `Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+    if (error instanceof Error &&
+        error.stack !== undefined &&
+        process.env["UNTANGLE_DEBUG"] === "1") {
+        note(io, error.stack);
+    }
+    note(io, "Next step: set UNTANGLE_DEBUG=1 and repeat the command to include the stack trace.");
+    return EXIT.operational;
+}
+/**
+ * Wartet, bis alles Geschriebene wirklich draussen ist.
+ *
+ * Noetig, weil {@link main} den Prozess ausdruecklich beendet (siehe dort) —
+ * ohne dieses Leeren koennte die letzte Zeile einer Pipe verloren gehen.
+ */
+function flush(stream) {
+    return new Promise((resolve) => {
+        stream.write("", () => {
+            resolve();
+        });
+    });
+}
+/**
+ * Die Prozesshuelle. Nur sie kennt `process`.
+ *
+ * SIE BEENDET DEN PROZESS AUSDRUECKLICH — und das ist eine Entscheidung, kein
+ * Versehen. Ein Adapter darf im Hintergrund noch an einer Anfrage haengen:
+ * der Embedding-Adapter etwa wiederholt einen Zeitueberlauf mit Backoff und
+ * haelt damit die Ereignisschleife ueber Minuten am Leben, obwohl `doctor`
+ * sein Urteil laengst gefaellt und ausgegeben hat (gemessen: Bericht nach
+ * 15 s, Prozessende erst nach ueber 3 min). Ein Diagnosewerkzeug, das nach
+ * dem Bericht noch minutenlang steht, ist kaputt.
+ *
+ * Also: Ergebnis ausgeben, Stroeme leeren, beenden. Verschwiegen wird dabei
+ * nichts — der abgebrochene Test steht als FEHLSCHLAG im Bericht, nicht als
+ * bestanden.
+ */
+async function main() {
+    const controller = new AbortController();
+    const onSignal = () => {
+        controller.abort();
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    const code = await run(process.argv.slice(2), { signal: controller.signal });
+    process.off("SIGINT", onSignal);
+    process.off("SIGTERM", onSignal);
+    await flush(process.stdout);
+    await flush(process.stderr);
+    process.exit(code);
+}
+// Nur ausfuehren, wenn dieses Modul das Programm IST — nicht, wenn ein Test es
+// importiert. Der Vergleich loest Symlinks auf: `npm install --global` legt das
+// Binaer als SYMLINK im globalen bin-Verzeichnis an, und ohne Aufloesung haelte
+// sich das global installierte `untangle` faelschlich fuer importiert und taete
+// schweigend nichts (siehe entry-point.ts).
+if (isEntryPoint(import.meta.url, process.argv[1])) {
+    await main();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/boundaries-schema.d.ts

@@ -0,0 +1,262 @@
+import * as z from "zod/v4";
+/** Every relationship is typed separately from synchronous import/call graph contracts. */
+export declare const frontendBoundaryReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"frontend-boundaries">;
+    root: z.ZodString;
+    status: z.ZodEnum<{
+        complete: "complete";
+        stale: "stale";
+        incomplete: "incomplete";
+    }>;
+    sourceTreeDigest: z.ZodString;
+    freshness: z.ZodObject<{
+        status: z.ZodEnum<{
+            fresh: "fresh";
+            stale: "stale";
+        }>;
+        sourceTreeBefore: z.ZodString;
+        sourceTreeAfter: z.ZodString;
+        changedPaths: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    inventory: z.ZodObject<{
+        files: z.ZodNumber;
+        excluded: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        analyzed: z.ZodNumber;
+        unsupported: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strict>;
+    selection: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        inInventory: z.ZodBoolean;
+        matchingRequests: z.ZodNumber;
+    }, z.core.$strict>>;
+    http: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        kind: z.ZodLiteral<"http-boundaries">;
+        services: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            frontendRoots: z.ZodArray<z.ZodString>;
+            backendRoots: z.ZodArray<z.ZodString>;
+            sameOrigin: z.ZodOptional<z.ZodBoolean>;
+            origins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        endpoints: z.ZodArray<z.ZodObject<{
+            serviceId: z.ZodNullable<z.ZodString>;
+            method: z.ZodString;
+            path: z.ZodString;
+            handler: z.ZodString;
+            provenance: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                contentHash: z.ZodString;
+                range: z.ZodObject<{
+                    startLine: z.ZodNumber;
+                    endLine: z.ZodNumber;
+                    startByte: z.ZodNumber;
+                    endByte: z.ZodNumber;
+                }, z.core.$strict>;
+                kind: z.ZodEnum<{
+                    request: "request";
+                    transport: "transport";
+                    route: "route";
+                    router: "router";
+                    include: "include";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        requests: z.ZodArray<z.ZodObject<{
+            source: z.ZodObject<{
+                path: z.ZodString;
+                contentHash: z.ZodString;
+                range: z.ZodObject<{
+                    startLine: z.ZodNumber;
+                    endLine: z.ZodNumber;
+                    startByte: z.ZodNumber;
+                    endByte: z.ZodNumber;
+                }, z.core.$strict>;
+                kind: z.ZodEnum<{
+                    request: "request";
+                    transport: "transport";
+                    route: "route";
+                    router: "router";
+                    include: "include";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            method: z.ZodNullable<z.ZodString>;
+            path: z.ZodNullable<z.ZodString>;
+            origin: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                resolved: "resolved";
+                ambiguous: "ambiguous";
+                unresolved: "unresolved";
+            }>;
+            reason: z.ZodOptional<z.ZodString>;
+            serviceIds: z.ZodArray<z.ZodString>;
+            targets: z.ZodArray<z.ZodObject<{
+                serviceId: z.ZodNullable<z.ZodString>;
+                method: z.ZodString;
+                path: z.ZodString;
+                handler: z.ZodString;
+                provenance: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    contentHash: z.ZodString;
+                    range: z.ZodObject<{
+                        startLine: z.ZodNumber;
+                        endLine: z.ZodNumber;
+                        startByte: z.ZodNumber;
+                        endByte: z.ZodNumber;
+                    }, z.core.$strict>;
+                    kind: z.ZodEnum<{
+                        request: "request";
+                        transport: "transport";
+                        route: "route";
+                        router: "router";
+                        include: "include";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            provenance: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                contentHash: z.ZodString;
+                range: z.ZodObject<{
+                    startLine: z.ZodNumber;
+                    endLine: z.ZodNumber;
+                    startByte: z.ZodNumber;
+                    endByte: z.ZodNumber;
+                }, z.core.$strict>;
+                kind: z.ZodEnum<{
+                    request: "request";
+                    transport: "transport";
+                    route: "route";
+                    router: "router";
+                    include: "include";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        limitations: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        summary: z.ZodObject<{
+            files: z.ZodNumber;
+            endpoints: z.ZodNumber;
+            requests: z.ZodNumber;
+            resolved: z.ZodNumber;
+            ambiguous: z.ZodNumber;
+            unresolved: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    importContext: z.ZodObject<{
+        kind: z.ZodLiteral<"file-imports-not-function-calls">;
+        edges: z.ZodArray<z.ZodObject<{
+            fromPath: z.ZodString;
+            toPath: z.ZodString;
+            rawSpecifier: z.ZodString;
+            range: z.ZodObject<{
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                startByte: z.ZodNumber;
+                endByte: z.ZodNumber;
+            }, z.core.$strict>;
+            sourceHash: z.ZodString;
+            targetHash: z.ZodString;
+        }, z.core.$strict>>;
+        requestImporters: z.ZodArray<z.ZodObject<{
+            requestPath: z.ZodString;
+            path: z.ZodString;
+            contentHash: z.ZodString;
+            distance: z.ZodNumber;
+            via: z.ZodArray<z.ZodObject<{
+                fromPath: z.ZodString;
+                toPath: z.ZodString;
+                rawSpecifier: z.ZodString;
+                range: z.ZodObject<{
+                    startLine: z.ZodNumber;
+                    endLine: z.ZodNumber;
+                    startByte: z.ZodNumber;
+                    endByte: z.ZodNumber;
+                }, z.core.$strict>;
+                sourceHash: z.ZodString;
+                targetHash: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        unresolved: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        summary: z.ZodObject<{
+            edges: z.ZodNumber;
+            unresolved: z.ZodNumber;
+            requestImporters: z.ZodNumber;
+        }, z.core.$strict>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strict>;
+    features: z.ZodObject<{
+        manifest: z.ZodObject<{
+            path: z.ZodString;
+            status: z.ZodEnum<{
+                invalid: "invalid";
+                unreadable: "unreadable";
+                loaded: "loaded";
+                missing: "missing";
+                not_in_scan: "not_in_scan";
+                changed: "changed";
+            }>;
+            contentHash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        associations: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            matches: z.ZodArray<z.ZodObject<{
+                featureId: z.ZodString;
+                title: z.ZodString;
+                role: z.ZodEnum<{
+                    code: "code";
+                    test: "test";
+                }>;
+                review: z.ZodEnum<{
+                    proposed: "proposed";
+                    confirmed: "confirmed";
+                }>;
+                ownership: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodOptional<z.ZodString>;
+                    status: z.ZodEnum<{
+                        missing: "missing";
+                        confirmed: "confirmed";
+                        declared: "declared";
+                    }>;
+                }, z.core.$strict>>;
+                declaredDependsOn: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        associationCount: z.ZodNumber;
+        dependencySemantics: z.ZodLiteral<"declared_dependencies_unchanged">;
+    }, z.core.$strict>;
+    truncation: z.ZodObject<{
+        truncated: z.ZodBoolean;
+        limit: z.ZodNumber;
+        omittedRequests: z.ZodNumber;
+        omittedEndpoints: z.ZodNumber;
+        omittedIssues: z.ZodNumber;
+        omittedFeatureAssociations: z.ZodNumber;
+    }, z.core.$strict>;
+    issues: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    limitations: z.ZodArray<z.ZodString>;
+    servicesManifest: z.ZodObject<{
+        path: z.ZodString;
+        status: z.ZodEnum<{
+            loaded: "loaded";
+            missing: "missing";
+        }>;
+        contentHash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+//# sourceMappingURL=boundaries-schema.d.ts.map

package/dist/mcp/boundaries-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries-schema.d.ts","sourceRoot":"","sources":["../../src/mcp/boundaries-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AA2D5B,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoI9B,CAAC"}