@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/flow/render.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Die Darstellung des Symbolgraphen — reine Funktionen, kein I/O.
+ *
+ * DIE ZUSAGE DIESER DATEI, in einem Satz: KEINE KANTE OHNE IHRE
+ * AUFLOESUNGSART UND IHRE CONFIDENCE.
+ *
+ * Der Symbolgraph unterscheidet vier Auspraegungen (`exact`, `heuristic`,
+ * `ambiguous`, `unresolved`) und traegt zu jeder eine Confidence mit Basis und
+ * Signalen. Diese Unterschiede sind der eigentliche Wert des Graphen: ein
+ * Aufrufpfad, der ueber eine geratene Namensgleichheit fuehrt, ist eine ANDERE
+ * Aussage als einer ueber einen aufgeloesten Import. Wer beide gleich
+ * darstellt, hat die Information weggeworfen, fuer die der Graph gebaut wurde.
+ *
+ * Deshalb gilt hier zusaetzlich: EINE MEHRDEUTIGE KANTE ZEIGT ALLE
+ * KANDIDATEN, mit ihrem Gewicht. Es wird keiner ausgewaehlt — auch nicht
+ * „der wahrscheinlichste".
+ */
+import type { SkipLedgerEntryV1, SymbolEdgeV1, SymbolNodeV1 } from "@untangle-code/domain";
+import type { AllCallPathsResultV1, CallPathV1, EntryPointSetV1, ImpactResultV1, ShortestCallPathResultV1, SymbolGraphIndex } from "@untangle-code/symbol-graph";
+/** Kurzform einer Kanten-Confidence: Wert, Basis, Signale. */
+export declare function describeConfidence(edge: SymbolEdgeV1): string;
+/**
+ * Eine Kante in einer Zeile — und, wenn sie mehrdeutig oder unaufgeloest ist,
+ * in mehreren.
+ */
+export declare function describeEdge(edge: SymbolEdgeV1, indent: string): string[];
+/** Ein Aufrufpfad: Knoten, Kanten, und was den Pfad schwaecht. */
+export declare function renderPath(index: SymbolGraphIndex, path: CallPathV1, title: string): string[];
+/**
+ * Der kuerzeste Pfad — oder der benannte Grund, warum es keinen gibt.
+ *
+ * `wallTimeEnforced` ist kein Zierrat: das Zeitbudget der Suche wird nur
+ * geprueft, wenn ihr eine Zeitquelle mitgegeben wurde. Ohne sie steht in
+ * `limits.maxWallTimeMs` eine Zahl, an die sich nichts haelt — und eine
+ * Budgetzeile, die eine nicht durchgesetzte Grenze wie eine durchgesetzte
+ * ausgibt, ist genau die stille Unwahrheit, die E4 verbietet.
+ */
+export declare function renderShortest(index: SymbolGraphIndex, result: ShortestCallPathResultV1, wallTimeEnforced?: boolean): string[];
+/** Alle Pfade bis Tiefe N — samt der verworfenen, die nie stumm verschwinden. */
+export declare function renderAllPaths(index: SymbolGraphIndex, result: AllCallPathsResultV1): string[];
+/** Einstiegspunkte — als das, was sie sind: Heuristik mit Belegen. */
+export declare function renderEntryPoints(set: EntryPointSetV1, limit: number): string[];
+/** Impact: wer ist betroffen, wie sicher ist das, und was fehlt trotzdem. */
+export declare function renderImpact(index: SymbolGraphIndex, result: ImpactResultV1, limit: number): string[];
+/** Was ein Symbol ruft und wer es ruft — jede Kante mit Art und Confidence. */
+export declare function renderSymbolOverview(index: SymbolGraphIndex, node: SymbolNodeV1): string[];
+/** Ledger-Eintraege: jede Auslassung mit Grund (E4). */
+export declare function renderLedgerEntries(entries: readonly SkipLedgerEntryV1[], indent: string): string[];
+/** Kennzahlen des Symbolgraphen, als Kopfzeile jeder Ausgabe. */
+export declare function renderSymbolGraphHeader(index: SymbolGraphIndex, generationId: string, ledgerInShard: boolean): string[];
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/flow/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/commands/flow/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3F,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAIrC,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAK7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCzE;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,wBAAwB,EAChC,gBAAgB,UAAO,GACtB,MAAM,EAAE,CAsBV;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAyB9F;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B/E;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAuCV;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CA8B1F;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CASV;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,OAAO,GACrB,MAAM,EAAE,CAmBV"}

package/dist/commands/flow/render.js

@@ -0,0 +1,220 @@
+import { compareCodepoints } from "@untangle-code/domain";
+import { describeSymbol } from "./select.js";
+/** Kurzform einer Kanten-Confidence: Wert, Basis, Signale. */
+export function describeConfidence(edge) {
+    return (`Confidence ${edge.confidence.value.toFixed(3)} (${edge.confidence.basis}` +
+        `${edge.confidence.signals.length === 0 ? "" : `; ${edge.confidence.signals.join(", ")}`})`);
+}
+/**
+ * Eine Kante in einer Zeile — und, wenn sie mehrdeutig oder unaufgeloest ist,
+ * in mehreren.
+ */
+export function describeEdge(edge, indent) {
+    const lines = [];
+    const qualifier = edge.toQualifier === undefined ? "" : `${edge.toQualifier}.`;
+    lines.push(`${indent}${edge.kind} "${qualifier}${edge.toName}"  [${edge.resolution}]  ${describeConfidence(edge)}` +
+        (edge.crossRepo ? "  >> crosses a repository boundary" : ""));
+    if (edge.resolution === "exact" || edge.resolution === "heuristic") {
+        const target = edge.target;
+        if (target !== undefined) {
+            lines.push(`${indent}  -> ${target.qualifiedName}  ${target.filePath}`);
+        }
+    }
+    if (edge.resolution === "ambiguous") {
+        const candidates = [...(edge.candidates ?? [])].sort((left, right) => right.weight - left.weight || compareCodepoints(left.symbolId, right.symbolId));
+        lines.push(`${indent}  AMBIGUOUS: ${String(candidates.length)} candidates; none selected:`);
+        for (const candidate of candidates) {
+            lines.push(`${indent}    ${candidate.weight.toFixed(3)}  ${candidate.qualifiedName}  ${candidate.filePath}`);
+        }
+    }
+    if (edge.resolution === "unresolved") {
+        lines.push(`${indent}  UNRESOLVED: ${edge.unresolvedReason ?? "no reason given"} — ${edge.unresolvedDetail ?? ""}`.trimEnd());
+    }
+    for (const site of edge.sites) {
+        lines.push(`${indent}  Location: ${site.filePath}:${String(site.range.startLine)}`);
+    }
+    if (edge.sites.length === 0 && edge.sitesMissingReason !== undefined) {
+        lines.push(`${indent}  no source location: ${edge.sitesMissingReason}`);
+    }
+    return lines;
+}
+/** Ein Aufrufpfad: Knoten, Kanten, und was den Pfad schwaecht. */
+export function renderPath(index, path, title) {
+    const lines = [];
+    lines.push(`${title}  Depth ${String(path.depth)}  Confidence ${path.confidence.toFixed(3)}  ` +
+        `weakest resolution: ${path.weakestResolution}` +
+        (path.containsAmbiguous ? "  INCLUDES AMBIGUOUS EDGES" : ""));
+    for (let i = 0; i < path.symbolIds.length; i++) {
+        const node = index.node(path.symbolIds[i]);
+        lines.push(`  ${node === null ? path.symbolIds[i] : describeSymbol(node)}`);
+        const edgeId = path.edgeIds[i];
+        if (edgeId === undefined)
+            continue;
+        const edge = index.edge(edgeId);
+        if (edge === null) {
+            lines.push(`    (edge ${edgeId} missing from snapshot)`);
+            continue;
+        }
+        lines.push(...describeEdge(edge, "    "));
+    }
+    return lines;
+}
+/**
+ * Der kuerzeste Pfad — oder der benannte Grund, warum es keinen gibt.
+ *
+ * `wallTimeEnforced` ist kein Zierrat: das Zeitbudget der Suche wird nur
+ * geprueft, wenn ihr eine Zeitquelle mitgegeben wurde. Ohne sie steht in
+ * `limits.maxWallTimeMs` eine Zahl, an die sich nichts haelt — und eine
+ * Budgetzeile, die eine nicht durchgesetzte Grenze wie eine durchgesetzte
+ * ausgibt, ist genau die stille Unwahrheit, die E4 verbietet.
+ */
+export function renderShortest(index, result, wallTimeEnforced = true) {
+    const lines = ["SHORTEST CALL PATH"];
+    if (result.path === null) {
+        lines.push(`  NO PATH: ${result.missReason ?? "no reason given"}` +
+            (result.missDetail === undefined ? "" : ` — ${result.missDetail}`));
+    }
+    else {
+        lines.push(...renderPath(index, result.path, "  Path"));
+    }
+    if (result.truncated) {
+        lines.push(`  TRUNCATED: ${result.truncationReason ?? "unknown"}; the search was incomplete.`);
+    }
+    lines.push(`  Budgets: maxDepth=${String(result.limits.maxDepth)} maxNodes=${String(result.limits.maxNodes)} ` +
+        `maxEdges=${String(result.limits.maxEdges)} maxWallTimeMs=${String(result.limits.maxWallTimeMs)}` +
+        (wallTimeEnforced
+            ? ""
+            : " (maxWallTimeMs is not enforced: the search deliberately receives no " +
+                "clock, so repeated runs over the same index produce identical output)"));
+    return lines;
+}
+/** Alle Pfade bis Tiefe N — samt der verworfenen, die nie stumm verschwinden. */
+export function renderAllPaths(index, result) {
+    const lines = [`ALL CALL PATHS UP TO DEPTH ${String(result.maxDepth)}`];
+    if (result.paths.length === 0) {
+        lines.push(`  NO PATH: ${result.missReason ?? "no reason given"}` +
+            (result.missDetail === undefined ? "" : ` — ${result.missDetail}`));
+    }
+    for (let i = 0; i < result.paths.length; i++) {
+        lines.push(...renderPath(index, result.paths[i], `  Path ${String(i + 1)}`));
+    }
+    if (result.pathLimitReached) {
+        const count = result.droppedPathCountExact
+            ? String(result.droppedPathCount)
+            : `at least ${String(result.droppedPathCount)}`;
+        lines.push(`  PATH LIMIT REACHED: ${count} additional paths were discarded ` +
+            "(increase the limit with --limit).");
+    }
+    if (result.truncated) {
+        lines.push(`  TRUNCATED: ${result.truncationReason ?? "unknown"}.`);
+    }
+    lines.push(...renderLedgerEntries(result.skipped, "  "));
+    return lines;
+}
+/** Einstiegspunkte — als das, was sie sind: Heuristik mit Belegen. */
+export function renderEntryPoints(set, limit) {
+    const lines = [
+        `ENTRY POINTS (${String(set.entryPoints.length)}) — heuristic, not a measurement`,
+    ];
+    const sorted = [...set.entryPoints].sort((left, right) => right.confidence.value - left.confidence.value ||
+        compareCodepoints(left.filePath, right.filePath) ||
+        compareCodepoints(left.symbolId, right.symbolId));
+    for (const entry of sorted.slice(0, limit)) {
+        lines.push(`  ${entry.confidence.value.toFixed(3)}  ${entry.qualifiedName}  ${entry.filePath}  ` +
+            `[${entry.kinds.join(", ")}]`);
+        for (const signal of entry.signals) {
+            lines.push(`      ${signal.kind} (+${signal.weight.toFixed(2)}): ${signal.reason}`);
+        }
+    }
+    if (sorted.length > limit) {
+        lines.push(`  … ${String(sorted.length - limit)} more (increase --limit).`);
+    }
+    const kinds = Object.keys(set.countsByKind).sort(compareCodepoints);
+    lines.push(`  by kind: ${kinds.map((kind) => `${kind} ${String(set.countsByKind[kind] ?? 0)}`).join(", ")}`);
+    return lines;
+}
+/** Impact: wer ist betroffen, wie sicher ist das, und was fehlt trotzdem. */
+export function renderImpact(index, result, limit) {
+    const lines = [
+        `AFFECTED SYMBOLS (${String(result.affected.length)}) — confidence threshold ${result.minConfidence.toFixed(3)}`,
+    ];
+    const sorted = [...result.affected].sort((left, right) => right.confidence - left.confidence ||
+        left.minDepth - right.minDepth ||
+        compareCodepoints(left.symbolId, right.symbolId));
+    for (const affected of sorted.slice(0, limit)) {
+        lines.push(`  ${affected.confidence.toFixed(3)}  ${affected.qualifiedName}  ${affected.filePath}  ` +
+            `Depth ${String(affected.depth)} (shortest path ${String(affected.minDepth)})  ` +
+            `weakest resolution: ${affected.weakestResolution}` +
+            (affected.throughAmbiguous ? "  VIA AMBIGUOUS EDGE" : ""));
+        for (const edgeId of affected.viaEdgeIds) {
+            const edge = index.edge(edgeId);
+            if (edge === null) {
+                lines.push(`      (edge ${edgeId} missing from snapshot)`);
+                continue;
+            }
+            lines.push(...describeEdge(edge, "      "));
+        }
+    }
+    if (sorted.length > limit) {
+        lines.push(`  … ${String(sorted.length - limit)} more (increase --limit).`);
+    }
+    lines.push(`  Ambiguous edges involved: ${result.containsAmbiguousEdges ? `yes (${String(result.ambiguousEdgeIds.length)})` : "no"}`);
+    if (result.traversal.truncated) {
+        lines.push(`  TRUNCATED: ${result.traversal.truncationReason ?? "unknown"}; the result is incomplete.`);
+    }
+    lines.push(...renderLedgerEntries(result.skipped, "  "));
+    return lines;
+}
+/** Was ein Symbol ruft und wer es ruft — jede Kante mit Art und Confidence. */
+export function renderSymbolOverview(index, node) {
+    const lines = [];
+    lines.push(`Symbol  ${describeSymbol(node)}`);
+    lines.push(`  Repository ${node.repoId}  Lines ${String(node.startLine)}-${String(node.endLine)}  ` +
+        `incoming ${String(index.inDegree(node.id))}, outgoing ${String(index.outDegree(node.id))}`);
+    lines.push("");
+    const outgoing = index.outgoingEdges(node.id);
+    lines.push(`CALLEES (${String(outgoing.length)} edges, including unresolved edges)`);
+    if (outgoing.length === 0)
+        lines.push("  (none)");
+    for (const edge of outgoing) {
+        lines.push(...describeEdge(edge, "  "));
+    }
+    lines.push("");
+    const callers = index.callers(node.id);
+    lines.push(`CALLERS (${String(callers.length)} bindings)`);
+    if (callers.length === 0) {
+        lines.push("  (no callers in the index; this may be an entry point, see --entry-points)");
+    }
+    for (const binding of callers) {
+        const caller = index.node(binding.symbolId);
+        lines.push(`  ${binding.weight.toFixed(3)}  [${binding.resolution}${binding.ambiguous ? ", ambiguous" : ""}]  ` +
+            `${caller === null ? binding.symbolId : describeSymbol(caller)}`);
+    }
+    return lines;
+}
+/** Ledger-Eintraege: jede Auslassung mit Grund (E4). */
+export function renderLedgerEntries(entries, indent) {
+    if (entries.length === 0)
+        return [];
+    const lines = [`${indent}SKIPPED (${String(entries.length)}):`];
+    for (const entry of entries) {
+        lines.push(`${indent}  ${entry.subjectId ?? entry.path ?? "(no item)"}  ${entry.reason}: ${entry.detail}`);
+    }
+    return lines;
+}
+/** Kennzahlen des Symbolgraphen, als Kopfzeile jeder Ausgabe. */
+export function renderSymbolGraphHeader(index, generationId, ledgerInShard) {
+    const metrics = index.graph.metrics;
+    const lines = [];
+    lines.push(`Symbol graph  Generation ${generationId}`);
+    lines.push(`  ${String(metrics.nodeCount)} symbols, ${String(metrics.edgeCount)} edges from ${String(metrics.fileCount)} files`);
+    lines.push(`  Resolution: exact ${(metrics.exactEdgeRate * 100).toFixed(1)} %, ` +
+        `ambiguous ${(metrics.ambiguousEdgeRate * 100).toFixed(1)} %, ` +
+        `unresolved ${(metrics.unresolvedEdgeRate * 100).toFixed(1)} %`);
+    if (!ledgerInShard) {
+        lines.push("  Note: the stored shard has no skip ledger; skipped " +
+            "graph-build items appear in the `untangle index` report.");
+    }
+    return lines;
+}
+//# sourceMappingURL=render.js.map

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

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

package/dist/commands/flow/select.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Von einem getippten Symbolnamen zum Knoten des Symbolgraphen.
+ *
+ * DIE REGEL DIESES MODULS IST DIESELBE WIE DIE DES SYMBOLGRAPHEN SELBST: bei
+ * mehreren Kandidaten wird KEINER heimlich gewaehlt. `untangle flow` zeigt
+ * dann alle und verlangt eine Entscheidung. Ein Werkzeug, das hier raet,
+ * beantwortet eine andere Frage als die gestellte — und sagt es nicht.
+ *
+ * Erlaubte Schreibweisen, von der staerksten zur schwaechsten:
+ *   `sym_ab12…`          die Symbol-ID
+ *   `Klasse.methode`     der qualifizierte Name
+ *   `pfad/datei.ts:name` Name in einer bestimmten Datei
+ *   `name`               der blosse Name
+ */
+import type { SymbolNodeV1 } from "@untangle-code/domain";
+export type SymbolSelectionV1 = {
+    status: "found";
+    node: SymbolNodeV1;
+    matchedBy: "symbol_id" | "qualified_name" | "file_and_name" | "name";
+} | {
+    status: "ambiguous";
+    candidates: SymbolNodeV1[];
+    matchedBy: string;
+} | {
+    status: "absent";
+    near: SymbolNodeV1[];
+};
+/** Beschreibt einen Kandidaten so, dass der Nutzer ihn eindeutig nachtippen kann. */
+export declare function describeSymbol(node: SymbolNodeV1): string;
+export declare function selectSymbolNode(nodes: readonly SymbolNodeV1[], query: string): SymbolSelectionV1;
+//# sourceMappingURL=select.d.ts.map

package/dist/commands/flow/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/commands/flow/select.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,WAAW,GAAG,gBAAgB,GAAG,eAAe,GAAG,MAAM,CAAC;CACtE,GACD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAU/C,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CA6DjG"}

package/dist/commands/flow/select.js

@@ -0,0 +1,62 @@
+import { compareCodepoints } from "@untangle-code/domain";
+function order(left, right) {
+    return (compareCodepoints(left.filePath, right.filePath) ||
+        left.startLine - right.startLine ||
+        compareCodepoints(left.id, right.id));
+}
+/** Beschreibt einen Kandidaten so, dass der Nutzer ihn eindeutig nachtippen kann. */
+export function describeSymbol(node) {
+    return `${node.qualifiedName}  ${node.filePath}:${String(node.startLine)}  [${node.kind}]`;
+}
+export function selectSymbolNode(nodes, query) {
+    const trimmed = query.trim();
+    const byId = nodes.filter((node) => node.id === trimmed);
+    if (byId.length === 1) {
+        return { status: "found", node: byId[0], matchedBy: "symbol_id" };
+    }
+    const byQualified = nodes.filter((node) => node.qualifiedName === trimmed);
+    if (byQualified.length === 1) {
+        return { status: "found", node: byQualified[0], matchedBy: "qualified_name" };
+    }
+    if (byQualified.length > 1) {
+        return {
+            status: "ambiguous",
+            candidates: [...byQualified].sort(order),
+            matchedBy: "qualified_name",
+        };
+    }
+    // `pfad/datei.ts:name` — der Doppelpunkt trennt nur, wenn rechts davon kein
+    // Pfadtrenner mehr steht.
+    const separator = trimmed.lastIndexOf(":");
+    if (separator > 0 && !trimmed.slice(separator + 1).includes("/")) {
+        const filePart = trimmed.slice(0, separator).replaceAll("\\", "/");
+        const namePart = trimmed.slice(separator + 1);
+        const inFile = nodes.filter((node) => (node.name === namePart || node.qualifiedName === namePart) &&
+            (node.filePath === filePart || node.filePath.endsWith(`/${filePart}`)));
+        if (inFile.length === 1) {
+            return { status: "found", node: inFile[0], matchedBy: "file_and_name" };
+        }
+        if (inFile.length > 1) {
+            return {
+                status: "ambiguous",
+                candidates: [...inFile].sort(order),
+                matchedBy: "file_and_name",
+            };
+        }
+    }
+    const byName = nodes.filter((node) => node.name === trimmed);
+    if (byName.length === 1) {
+        return { status: "found", node: byName[0], matchedBy: "name" };
+    }
+    if (byName.length > 1) {
+        return { status: "ambiguous", candidates: [...byName].sort(order), matchedBy: "name" };
+    }
+    const lowered = trimmed.toLowerCase();
+    const near = nodes
+        .filter((node) => node.name.toLowerCase().includes(lowered) ||
+        node.qualifiedName.toLowerCase().includes(lowered))
+        .sort(order)
+        .slice(0, 10);
+    return { status: "absent", near };
+}
+//# sourceMappingURL=select.js.map

package/dist/commands/flow/select.js.map

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

package/dist/commands/graph/boundaries-input.d.ts

@@ -0,0 +1,26 @@
+import * as z from "zod/v4";
+export declare const httpServiceBindingSchema: 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>;
+export declare const httpServiceBindingsSchema: 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>>;
+export declare const httpServicesFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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>>;
+}, z.core.$strict>;
+//# sourceMappingURL=boundaries-input.d.ts.map

package/dist/commands/graph/boundaries-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries-input.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/boundaries-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAmC5B,eAAO,MAAM,wBAAwB;;;;;;kBAQ1B,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;;;mBAUlC,CAAC;AAEL,eAAO,MAAM,sBAAsB;;;;;;;;;kBAKxB,CAAC"}

package/dist/commands/graph/boundaries-input.js

@@ -0,0 +1,54 @@
+import * as z from "zod/v4";
+/** Repository-relative roots are selectors, never filesystem escape paths. */
+const rootSelector = z
+    .string()
+    .max(4096)
+    .refine((value) => value === "" ||
+    (!value.startsWith("/") &&
+        !/[:\\*?[\]{}]/u.test(value) &&
+        value.split("/").every((part) => part !== "" && part !== "." && part !== "..") &&
+        !Array.from(value).some((character) => character.charCodeAt(0) < 32)), "Expected a literal repository-relative directory (empty string selects the repository root).");
+const origin = z
+    .string()
+    .max(4096)
+    .refine((value) => {
+    try {
+        const url = new URL(value);
+        return (["http:", "https:"].includes(url.protocol) &&
+            !url.username &&
+            !url.password &&
+            url.pathname === "/" &&
+            !url.search &&
+            !url.hash);
+    }
+    catch {
+        return false;
+    }
+}, "Expected an HTTP(S) origin without credentials, path, query or fragment.");
+export const httpServiceBindingSchema = z
+    .object({
+    id: z.string().trim().min(1).max(256),
+    frontendRoots: z.array(rootSelector).min(1).max(32),
+    backendRoots: z.array(rootSelector).min(1).max(32),
+    sameOrigin: z.boolean().optional(),
+    origins: z.array(origin).max(32).optional(),
+})
+    .strict();
+export const httpServiceBindingsSchema = z
+    .array(httpServiceBindingSchema)
+    .max(100)
+    .superRefine((services, ctx) => {
+    const ids = new Set();
+    services.forEach((service, i) => {
+        if (ids.has(service.id))
+            ctx.addIssue({ code: "custom", path: [i, "id"], message: "Service ids must be unique." });
+        ids.add(service.id);
+    });
+});
+export const httpServicesFileSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    services: httpServiceBindingsSchema,
+})
+    .strict();
+//# sourceMappingURL=boundaries-input.js.map

package/dist/commands/graph/boundaries-input.js.map

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

package/dist/commands/graph/boundaries.d.ts

@@ -0,0 +1,4 @@
+import { type ParsedArgs } from "../../cli/args.js";
+import type { CommandContext } from "../../cli/command.js";
+export declare function runBoundaries(ctx: CommandContext, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=boundaries.d.ts.map

package/dist/commands/graph/boundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/boundaries.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA0F3D,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmF1F"}