@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/init/services.js

@@ -0,0 +1,209 @@
+/**
+ * Probing the two pieces of infrastructure Untangle needs.
+ *
+ * READ-ONLY, ON PURPOSE. `HttpProbePort` can issue a GET and nothing else, so
+ * `init` is structurally incapable of changing a service it finds — which is
+ * what spec.md §3.2 demands of External Infrastructure mode ("Untangle DARF in
+ * diesem Modus keine fremden Prozesse oder Container verändern").
+ *
+ * WHICH URLS ARE PROBED AT ALL IS NOT DECIDED HERE ANY MORE (WP-222). That
+ * rule lives in `cli/vector-store-policy.ts` and is the SAME rule
+ * `untangle doctor` obeys. It used to be written out twice — once here, once
+ * (by omission) in `doctor` — and the two disagreed: `init` refused upstream's
+ * default port 6333 citing spec.md §3.2, while `doctor` fell back onto it,
+ * found the foreign instance living there and reported it as healthy. Two
+ * commands of one tool, two answers to a safety question. One rule, one
+ * file, one answer.
+ *
+ * NOT FINDING EITHER SERVICE IS NOT AN ERROR (WP-125): the configuration is
+ * written regardless, and the command names exactly one next step.
+ */
+import { compareCodepoints } from "@untangle-code/domain";
+import { MANAGED_QDRANT_URL, qdrantProbePlan } from "../../cli/vector-store-policy.js";
+/** Native Ollama probe target (spec.md §3.1). */
+export const DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434";
+/**
+ * Managed Qdrant REST port (spec.md §3.1) — re-exported, NOT redefined. The
+ * value belongs to the shared policy; a second copy here is exactly how the
+ * two commands drifted apart in the first place.
+ */
+export const DEFAULT_QDRANT_URL = MANAGED_QDRANT_URL;
+/**
+ * Reads `/api/tags` into the embedding models it describes.
+ *
+ * The provider reports `capabilities`, `embedding_length` and
+ * `context_length` per model, so the vector width is READ, never guessed and
+ * never obtained by sending the model something to embed. A model that
+ * predates the `capabilities` field is still recognised by the presence of an
+ * `embedding_length`, which only embedding models carry.
+ */
+export function readEmbeddingModels(payload) {
+    if (typeof payload !== "object" || payload === null) {
+        return [];
+    }
+    const models = payload.models;
+    if (!Array.isArray(models)) {
+        return [];
+    }
+    const found = [];
+    for (const raw of models) {
+        if (typeof raw !== "object" || raw === null) {
+            continue;
+        }
+        const name = typeof raw.name === "string" ? raw.name : undefined;
+        if (name === undefined || name.length === 0) {
+            continue;
+        }
+        const capabilities = Array.isArray(raw.capabilities)
+            ? raw.capabilities.filter((item) => typeof item === "string")
+            : [];
+        const details = typeof raw.details === "object" && raw.details !== null ? raw.details : {};
+        const dimensions = positiveInteger(details.embedding_length);
+        const contextLength = positiveInteger(details.context_length);
+        const isEmbedding = capabilities.includes("embedding") || dimensions !== undefined;
+        if (!isEmbedding) {
+            continue;
+        }
+        found.push({
+            name,
+            ...(dimensions === undefined ? {} : { dimensions }),
+            ...(contextLength === undefined ? {} : { contextLength }),
+        });
+    }
+    found.sort((a, b) => compareCodepoints(a.name, b.name));
+    return found;
+}
+/**
+ * Chooses one embedding model out of what the provider actually has.
+ *
+ * The rule, in order: the widest context window first, because a code chunk
+ * that does not fit is a chunk that gets truncated; then the widest vector,
+ * because that is the model with more to say; then codepoint order, so the
+ * decision never depends on the order the provider happened to list its
+ * models in. `preferred` (an explicit user choice) short-circuits all of it.
+ *
+ * Deliberately NOT "whatever the product default is called": on a machine
+ * that has three embedding models and not the default one, silently falling
+ * back to a name that is not installed produces a configuration that fails on
+ * first use.
+ */
+export function chooseEmbeddingModel(models, preferred) {
+    if (models.length === 0) {
+        return undefined;
+    }
+    if (preferred !== undefined) {
+        const exact = models.find((model) => model.name === preferred);
+        if (exact !== undefined) {
+            return { model: exact, reason: "explicitly requested (--embedding-model)" };
+        }
+    }
+    const ranked = [...models].sort((a, b) => {
+        const contextDelta = (b.contextLength ?? 0) - (a.contextLength ?? 0);
+        if (contextDelta !== 0) {
+            return contextDelta;
+        }
+        const dimensionDelta = (b.dimensions ?? 0) - (a.dimensions ?? 0);
+        if (dimensionDelta !== 0) {
+            return dimensionDelta;
+        }
+        return compareCodepoints(a.name, b.name);
+    });
+    const model = ranked[0];
+    return {
+        model,
+        reason: models.length === 1
+            ? "the provider's only reported embedding model"
+            : `largest context window among ${String(models.length)} reported embedding models`,
+    };
+}
+/**
+ * WP-228: Erreichbarkeit heisst NICHT „benutzbar".
+ *
+ * Bis hierher fragte `init` nur `/api/version` und `/api/tags` — zwei
+ * Endpunkte, die der Indexlauf nie anfasst. Auf dem Rechner, an dem das
+ * gemessen wurde, antworteten beide sofort, waehrend `/api/embed` haengte:
+ * die geschriebene Konfiguration versprach einen Dienst, der keinen einzigen
+ * Chunk einbetten konnte. Deshalb wird jetzt der Endpunkt geprueft, den das
+ * Produkt WIRKLICH benutzt — mit kurzer Frist, und ein Fristablauf ist ein
+ * Befund, keine bestandene Pruefung.
+ */
+export async function probeOllama(input) {
+    const { http, limits, ollamaUrl } = input;
+    const notProbed = (detail) => ({
+        outcome: "not-probed",
+        timeoutMs: limits.embedProbeTimeoutMs,
+        detail,
+    });
+    const version = await http.getJson(`${trimSlash(ollamaUrl)}/api/version`, limits.probeTimeoutMs);
+    if (version === null) {
+        return {
+            outcome: "unreachable",
+            url: ollamaUrl,
+            embeddingModels: [],
+            embedProbe: notProbed("the provider was already unreachable"),
+        };
+    }
+    const versionString = readString(version, "version");
+    const tags = await http.getJson(`${trimSlash(ollamaUrl)}/api/tags`, limits.probeTimeoutMs);
+    const embeddingModels = readEmbeddingModels(tags);
+    const choice = chooseEmbeddingModel(embeddingModels, input.preferredModel);
+    const embedProbe = choice === undefined
+        ? notProbed("the provider reports no embedding model")
+        : await runEmbedProbe(http, ollamaUrl, choice.model.name, limits.embedProbeTimeoutMs);
+    return {
+        outcome: "reachable",
+        url: ollamaUrl,
+        ...(versionString === undefined ? {} : { version: versionString }),
+        embeddingModels,
+        ...(choice === undefined ? {} : { chosenModel: choice.model, chosenReason: choice.reason }),
+        embedProbe,
+    };
+}
+/** Ein winziges Probe-Embedding, mit Frist. Wirft nie — es antwortet. */
+async function runEmbedProbe(http, ollamaUrl, model, timeoutMs) {
+    const result = await http.probeEmbedding(trimSlash(ollamaUrl), model, timeoutMs);
+    if (result.ok) {
+        return { outcome: "ok", timeoutMs, dimensions: result.dimensions };
+    }
+    return {
+        outcome: result.timedOut ? "timeout" : "failed",
+        timeoutMs,
+        detail: result.detail,
+    };
+}
+export async function probeQdrant(input) {
+    const { http, limits, qdrantUrls } = input;
+    const probedUrls = [...qdrantUrls];
+    // The skipped list — with its reason — comes from the shared policy, so it
+    // can never claim something other than what the policy actually enforces.
+    const skippedUrls = qdrantProbePlan({}).skipped.filter((candidate) => !probedUrls.includes(candidate.url));
+    for (const url of probedUrls) {
+        const payload = await http.getJson(`${trimSlash(url)}/`, limits.probeTimeoutMs);
+        if (payload === null) {
+            continue;
+        }
+        const version = readString(payload, "version");
+        return {
+            outcome: "reachable",
+            probedUrls,
+            url,
+            ...(version === undefined ? {} : { version }),
+            skippedUrls,
+        };
+    }
+    return { outcome: "unreachable", probedUrls, skippedUrls };
+}
+function trimSlash(value) {
+    return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function readString(payload, key) {
+    if (typeof payload !== "object" || payload === null) {
+        return undefined;
+    }
+    const value = payload[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function positiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=services.js.map

package/dist/commands/init/services.js.map

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

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

@@ -0,0 +1,8 @@
+import { type RawConfigLayer } from "@untangle-code/config";
+import type { FileSystemPort } from "@untangle-code/domain";
+import type { StorageFindingsV1 } from "./types.js";
+/** Explicit selection wins; an explicitly configured Qdrant remains opt-in. */
+export declare function initStorageBackend(explicit: StorageFindingsV1["backend"] | undefined, env: Readonly<Record<string, string | undefined>>, existing?: RawConfigLayer): StorageFindingsV1["backend"];
+/** Inspect a local directory without opening a database or creating files. */
+export declare function inspectInitStorage(fs: FileSystemPort, root: string, explicit: StorageFindingsV1["backend"] | undefined, env: Readonly<Record<string, string | undefined>>, signal?: AbortSignal): Promise<StorageFindingsV1>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/commands/init/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,SAAS,EAClD,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,QAAQ,GAAE,cAAmB,GAC5B,iBAAiB,CAAC,SAAS,CAAC,CAa9B;AAED,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,SAAS,EAClD,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA0C5B"}

package/dist/commands/init/storage.js

@@ -0,0 +1,102 @@
+import path from "node:path";
+import { DEFAULT_STORAGE_CONFIG, buildEnvConfigLayer, mergeConfigLayers, parseConfigText, resolveUserConfigDir, } from "@untangle-code/config";
+import { OperationalError } from "../../cli/exit.js";
+/** Explicit selection wins; an explicitly configured Qdrant remains opt-in. */
+export function initStorageBackend(explicit, env, existing = {}) {
+    const selected = explicit ?? env["UNTANGLE_STORAGE_BACKEND"] ?? existing.storage?.backend;
+    if (selected !== undefined) {
+        if (selected === "lancedb" || selected === "qdrant")
+            return selected;
+        throw new OperationalError(`Unknown storage backend ${JSON.stringify(selected)}.`, "Select --storage=lancedb or --storage=qdrant.");
+    }
+    return existing.qdrant !== undefined ||
+        buildEnvConfigLayer(env).layer.qdrant !== undefined
+        ? "qdrant"
+        : "lancedb";
+}
+/** Inspect a local directory without opening a database or creating files. */
+export async function inspectInitStorage(fs, root, explicit, env, signal) {
+    signal?.throwIfAborted();
+    const { layer: existing, warnings } = await existingStorageConfig(fs, root, env, signal);
+    const backend = initStorageBackend(explicit, env, existing);
+    if (backend === "qdrant") {
+        const mode = env["UNTANGLE_QDRANT_MODE"] ?? existing.qdrant?.mode;
+        const url = env["UNTANGLE_QDRANT_URL"] ?? existing.qdrant?.url;
+        return {
+            backend,
+            ...(mode === "managed" || mode === "external" ? { qdrantMode: mode } : {}),
+            ...(url === undefined ? {} : { qdrantUrl: url }),
+            ...(warnings.length === 0 ? {} : { configurationWarnings: warnings }),
+        };
+    }
+    const localPath = env["UNTANGLE_LANCEDB_PATH"] ?? existing.storage?.path ?? DEFAULT_STORAGE_CONFIG.path;
+    if (!localPath)
+        throw new OperationalError("The local storage path is empty.", "Set UNTANGLE_LANCEDB_PATH.");
+    const directory = path.resolve(root, localPath);
+    signal?.throwIfAborted();
+    try {
+        const entry = await fs.stat(directory);
+        signal?.throwIfAborted();
+        return {
+            backend,
+            path: localPath,
+            directory,
+            directoryStatus: entry === null ? "missing" : entry.kind === "directory" ? "present" : "not-directory",
+            ...(warnings.length === 0 ? {} : { configurationWarnings: warnings }),
+        };
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        return {
+            backend,
+            path: localPath,
+            directory,
+            directoryStatus: "unreadable",
+            detail: error instanceof Error ? error.message : String(error),
+            ...(warnings.length === 0 ? {} : { configurationWarnings: warnings }),
+        };
+    }
+}
+/** Read the same project layer formats/order as config loading, through init's filesystem port. */
+async function existingStorageConfig(fs, root, env, signal) {
+    signal?.throwIfAborted();
+    const json = path.join(root, ".untangle.json");
+    const toml = path.join(root, "untangle.toml");
+    const legacyExists = (await fs.stat(json)) !== null || (await fs.stat(toml)) !== null;
+    const user = path.join(resolveUserConfigDir(env, process.platform), "config.json");
+    const paths = [
+        { path: user, format: "json" },
+        { path: toml, format: "toml" },
+        {
+            path: legacyExists ? json : path.join(root, ".untangle/config.json"),
+            format: "json",
+        },
+        { path: path.join(root, ".untangle.local.json"), format: "json" },
+    ];
+    const layers = [];
+    const warnings = [];
+    let legacyQdrant = false;
+    for (const file of paths) {
+        signal?.throwIfAborted();
+        try {
+            if ((await fs.stat(file.path))?.kind !== "file")
+                continue;
+            const layer = parseConfigText(await fs.readTextFile(file.path), file.format);
+            if (layer.qdrant !== undefined)
+                legacyQdrant = true;
+            layers.push(layer);
+        }
+        catch {
+            signal?.throwIfAborted();
+            warnings.push(`Storage selection could not be inspected in ${file.path}; existing configuration is preserved unless --force is selected.`);
+        }
+    }
+    return {
+        layer: mergeConfigLayers([
+            ...(legacyQdrant ? [{ storage: { backend: "qdrant" } }] : []),
+            ...layers,
+        ]),
+        warnings,
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/commands/init/storage.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * A small, purpose-built TOML emitter.
+ *
+ * WHY NOT A LIBRARY: the point of the file `init` writes is the COMMENTS —
+ * the user must be able to see what was decided and why. Every general TOML
+ * serializer takes a value and drops the prose, because prose is not part of
+ * the value. So the emitter here is a line builder that happens to know how
+ * to spell TOML scalars, not a serializer of an object graph.
+ *
+ * It is deliberately narrow: tables, array-of-tables, scalars and homogeneous
+ * scalar arrays. Anything outside that throws rather than guessing — a config
+ * file that silently loses a value would be worse than no config file at all.
+ */
+export type TomlScalar = string | number | boolean;
+/**
+ * TOML basic-string escaping. `\` and `"` plus the control characters TOML
+ * names explicitly; everything else below U+0020 goes to `\uXXXX` because a
+ * raw control byte in a config file is unreadable and, in some cases,
+ * unparseable.
+ */
+export declare function escapeTomlString(value: string): string;
+/** A key is written bare when it can be, quoted when it must be. */
+export declare function formatTomlKey(key: string): string;
+/**
+ * Formats a number the way TOML distinguishes integers from floats: an
+ * integral value stays integral, a fractional one keeps its decimal point.
+ * Non-finite numbers are rejected — TOML has `inf`/`nan` literals, but a
+ * config value that is either is a bug upstream, not something to serialize.
+ */
+export declare function formatTomlNumber(value: number): string;
+export declare function formatTomlScalar(value: TomlScalar): string;
+/**
+ * A line builder for commented TOML.
+ *
+ * Order is the order of the calls: this class never reorders anything, which
+ * is what lets the caller interleave prose and values so that each decision
+ * sits directly under its justification.
+ */
+export declare class TomlWriter {
+    private readonly lines;
+    /** A `#` comment. An empty string yields a bare `#`, which reads as a spacer. */
+    comment(text: string): this;
+    /** Several comment lines at once; convenience for wrapped prose. */
+    comments(texts: readonly string[]): this;
+    blank(): this;
+    /** A `[table.path]` header. */
+    table(path: readonly string[]): this;
+    /** A `[[table.path]]` array-of-tables header. */
+    arrayTable(path: readonly string[]): this;
+    scalar(key: string, value: TomlScalar): this;
+    /**
+     * A single-line array. Written multi-line once it would be long, because a
+     * 200-column exclude list is not something a human edits.
+     */
+    array(key: string, values: readonly TomlScalar[]): this;
+    /** An empty inline table — the honest way to write "nothing configured here". */
+    emptyInlineTable(key: string): this;
+    /**
+     * The finished document. Always ends in exactly one newline: a trailing
+     * newline is what every line-oriented tool expects, and "exactly one" is
+     * what keeps the idempotency comparison from reporting phantom changes.
+     */
+    render(): string;
+}
+//# sourceMappingURL=toml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../../src/commands/init/toml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAInD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoCtD;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQ1D;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,iFAAiF;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,oEAAoE;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOxC,KAAK,IAAI,IAAI;IAKpB,+BAA+B;IACxB,KAAK,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAK3C,iDAAiD;IAC1C,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAKzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAKnD;;;OAGG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAe9D,iFAAiF;IAC1E,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;OAIG;IACI,MAAM,IAAI,MAAM;CAIxB"}

package/dist/commands/init/toml.js

@@ -0,0 +1,159 @@
+/**
+ * A small, purpose-built TOML emitter.
+ *
+ * WHY NOT A LIBRARY: the point of the file `init` writes is the COMMENTS —
+ * the user must be able to see what was decided and why. Every general TOML
+ * serializer takes a value and drops the prose, because prose is not part of
+ * the value. So the emitter here is a line builder that happens to know how
+ * to spell TOML scalars, not a serializer of an object graph.
+ *
+ * It is deliberately narrow: tables, array-of-tables, scalars and homogeneous
+ * scalar arrays. Anything outside that throws rather than guessing — a config
+ * file that silently loses a value would be worse than no config file at all.
+ */
+const BARE_KEY = /^[A-Za-z0-9_-]+$/;
+/**
+ * TOML basic-string escaping. `\` and `"` plus the control characters TOML
+ * names explicitly; everything else below U+0020 goes to `\uXXXX` because a
+ * raw control byte in a config file is unreadable and, in some cases,
+ * unparseable.
+ */
+export function escapeTomlString(value) {
+    let out = "";
+    for (const char of value) {
+        switch (char) {
+            case "\\":
+                out += "\\\\";
+                break;
+            case '"':
+                out += '\\"';
+                break;
+            case "\b":
+                out += "\\b";
+                break;
+            case "\t":
+                out += "\\t";
+                break;
+            case "\n":
+                out += "\\n";
+                break;
+            case "\f":
+                out += "\\f";
+                break;
+            case "\r":
+                out += "\\r";
+                break;
+            default: {
+                const code = char.codePointAt(0) ?? 0;
+                if (code < 0x20 || code === 0x7f) {
+                    out += `\\u${code.toString(16).padStart(4, "0").toUpperCase()}`;
+                }
+                else {
+                    out += char;
+                }
+            }
+        }
+    }
+    return out;
+}
+/** A key is written bare when it can be, quoted when it must be. */
+export function formatTomlKey(key) {
+    return BARE_KEY.test(key) ? key : `"${escapeTomlString(key)}"`;
+}
+/**
+ * Formats a number the way TOML distinguishes integers from floats: an
+ * integral value stays integral, a fractional one keeps its decimal point.
+ * Non-finite numbers are rejected — TOML has `inf`/`nan` literals, but a
+ * config value that is either is a bug upstream, not something to serialize.
+ */
+export function formatTomlNumber(value) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`cannot serialize non-finite number: ${String(value)}`);
+    }
+    if (Number.isInteger(value)) {
+        return value.toFixed(0);
+    }
+    return String(value);
+}
+export function formatTomlScalar(value) {
+    if (typeof value === "string") {
+        return `"${escapeTomlString(value)}"`;
+    }
+    if (typeof value === "boolean") {
+        return value ? "true" : "false";
+    }
+    return formatTomlNumber(value);
+}
+/**
+ * A line builder for commented TOML.
+ *
+ * Order is the order of the calls: this class never reorders anything, which
+ * is what lets the caller interleave prose and values so that each decision
+ * sits directly under its justification.
+ */
+export class TomlWriter {
+    lines = [];
+    /** A `#` comment. An empty string yields a bare `#`, which reads as a spacer. */
+    comment(text) {
+        this.lines.push(text.length === 0 ? "#" : `# ${text}`);
+        return this;
+    }
+    /** Several comment lines at once; convenience for wrapped prose. */
+    comments(texts) {
+        for (const text of texts) {
+            this.comment(text);
+        }
+        return this;
+    }
+    blank() {
+        this.lines.push("");
+        return this;
+    }
+    /** A `[table.path]` header. */
+    table(path) {
+        this.lines.push(`[${path.map(formatTomlKey).join(".")}]`);
+        return this;
+    }
+    /** A `[[table.path]]` array-of-tables header. */
+    arrayTable(path) {
+        this.lines.push(`[[${path.map(formatTomlKey).join(".")}]]`);
+        return this;
+    }
+    scalar(key, value) {
+        this.lines.push(`${formatTomlKey(key)} = ${formatTomlScalar(value)}`);
+        return this;
+    }
+    /**
+     * A single-line array. Written multi-line once it would be long, because a
+     * 200-column exclude list is not something a human edits.
+     */
+    array(key, values) {
+        const rendered = values.map(formatTomlScalar);
+        const inline = `${formatTomlKey(key)} = [${rendered.join(", ")}]`;
+        if (rendered.length === 0 || inline.length <= 96) {
+            this.lines.push(inline);
+            return this;
+        }
+        this.lines.push(`${formatTomlKey(key)} = [`);
+        for (const item of rendered) {
+            this.lines.push(`  ${item},`);
+        }
+        this.lines.push("]");
+        return this;
+    }
+    /** An empty inline table — the honest way to write "nothing configured here". */
+    emptyInlineTable(key) {
+        this.lines.push(`${formatTomlKey(key)} = {}`);
+        return this;
+    }
+    /**
+     * The finished document. Always ends in exactly one newline: a trailing
+     * newline is what every line-oriented tool expects, and "exactly one" is
+     * what keeps the idempotency comparison from reporting phantom changes.
+     */
+    render() {
+        const body = this.lines.join("\n").replace(/\n+$/u, "");
+        return `${body}\n`;
+    }
+}
+//# sourceMappingURL=toml.js.map

package/dist/commands/init/toml.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Monorepo topology: the level ABOVE the files.
+ *
+ * A project is rarely one thing. It is `packages/*` under a workspace
+ * definition, and it is `frontend`/`backend`/`worker` under a container
+ * composition — two different, equally real decompositions of the same
+ * repository. `@untangle-code/file-graph` already reads both
+ * (`loadWorkspaceTopology`: `pnpm-workspace.yaml`, `package.json#workspaces`,
+ * `tsconfig*.json`, and every composition file), so this module CALLS it and
+ * does not rebuild it.
+ *
+ * What is added here is exactly the part file-graph does not read: the marker
+ * files of the other workspace managers (`lerna.json`, `nx.json`,
+ * `turbo.json`). They are DETECTED, not interpreted into a second package
+ * discovery. When such a marker declares a layout the topology pass did not
+ * find, that is written down as a gap (E4) — a config that quietly claims a
+ * single-package project because nobody read `lerna.json` is exactly the kind
+ * of silent skip the project forbids.
+ */
+import type { FileSystemPort, SkipLedgerEntryV1 } from "@untangle-code/domain";
+import type { InitLimitsV1, TopologyFindingsV1, WorkspaceManagerMarkersV1 } from "./types.js";
+/**
+ * Transient ids for the topology pass. `loadWorkspaceTopology` needs a
+ * workspace id and a generation id to key its skip ledger; `init` persists
+ * neither, so both are fixed constants rather than a clock- or
+ * random-derived value (determinism rule: no `Date.now()`/`Math.random()` in
+ * result data).
+ */
+export declare const INIT_WORKSPACE_ID = "untangle-init";
+export declare const INIT_GENERATION_ID = "untangle-init";
+/** The single repository `init` looks at: the directory it was pointed at. */
+export declare const INIT_REPO_ID = "root";
+export declare const INIT_REF_ID = "root:HEAD";
+/** Marker files of workspace managers, in probe order (codepoint-sorted). */
+export declare const WORKSPACE_MANAGER_MARKERS: readonly ["lerna.json", "nx.json", "turbo.json"];
+export interface TopologyInput {
+    fs: FileSystemPort;
+    /** Absolute, canonical repository root. */
+    repoRoot: string;
+    limits: InitLimitsV1;
+    onSkipEntry: (entry: SkipLedgerEntryV1) => void;
+}
+export declare function detectTopology(input: TopologyInput): Promise<TopologyFindingsV1>;
+/**
+ * Reads the marker files of the workspace managers file-graph does not know.
+ *
+ * `lerna.json` is the only one of the three that declares a package layout in
+ * its own right (`packages: [...]`); `nx.json` and `turbo.json` sit on top of
+ * an existing npm/pnpm/yarn workspace and therefore add nothing to the
+ * package list. So only lerna can produce a real gap, and only when the
+ * topology pass found no packages at all.
+ */
+export declare function detectWorkspaceManagers(fs: FileSystemPort, repoRoot: string, packagesFound: number, onSkipEntry: (entry: SkipLedgerEntryV1) => void): Promise<WorkspaceManagerMarkersV1>;
+//# sourceMappingURL=topology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../../src/commands/init/topology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/E,OAAO,KAAK,EAGV,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,eAAO,MAAM,WAAW,cAAc,CAAC;AAEvC,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,kDAAmD,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,cAAc,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACjD;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuDtF;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC9C,OAAO,CAAC,yBAAyB,CAAC,CAgDpC"}