@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/init/command.js

@@ -0,0 +1,198 @@
+/**
+ * `untangle init` as the CLI shell sees it.
+ *
+ * This is the ONLY file of the command that knows about argv, exit codes and
+ * a terminal. Everything else (`run.ts` and below) is a library over ports,
+ * which is why the whole detection pipeline is testable without a process,
+ * without a network and without `node:fs`.
+ */
+import path from "node:path";
+import { boolFlag, enumFlag, stringFlag } from "../../cli/args.js";
+import { EXIT, UsageError } from "../../cli/exit.js";
+import { line, note, processIo } from "../../cli/io.js";
+import { formatTextReport } from "./report.js";
+import { CONFIG_FILE_NAME, runInit } from "./run.js";
+import { createWizardTerminal } from "./wizard-terminal.js";
+import { runInitWizard } from "./wizard.js";
+const FLAGS = {
+    interactive: {
+        kind: "boolean",
+        describe: "Guided terminal setup. --no-interactive keeps the scriptable config-only workflow.",
+        defaultLabel: "automatic only on an interactive terminal, text output and online mode",
+    },
+    root: {
+        kind: "string",
+        placeholder: "PATH",
+        describe: `Project directory where ${CONFIG_FILE_NAME} is written.`,
+        defaultLabel: "current directory",
+    },
+    force: {
+        kind: "boolean",
+        describe: `Overwrite an existing ${CONFIG_FILE_NAME}.`,
+    },
+    "dry-run": {
+        kind: "boolean",
+        describe: "Preview what would be created. Writes nothing.",
+    },
+    offline: {
+        kind: "boolean",
+        describe: "No network probes; local LanceDB setup remains available.",
+    },
+    storage: {
+        kind: "string",
+        placeholder: "lancedb|qdrant",
+        describe: "Search storage backend. LanceDB keeps the index in the project without a service; Qdrant is an explicit opt-in.",
+        defaultLabel: "lancedb for new projects; existing explicit backend is preserved",
+    },
+    "embedding-model": {
+        kind: "string",
+        placeholder: "NAME",
+        describe: "Select a specific embedding model instead of automatic discovery.",
+        defaultLabel: "largest context window",
+    },
+    vision: {
+        kind: "string",
+        placeholder: "PATH",
+        describe: "Vision for local document inspection; path relative to the project directory.",
+    },
+    spec: {
+        kind: "string",
+        placeholder: "PATH",
+        describe: "Specification for local document inspection; path relative to the project directory.",
+    },
+    "feature-map": {
+        kind: "string",
+        placeholder: "PATH",
+        describe: "Declared feature map for local evidence inspection; relative to the project directory.",
+        defaultLabel: "untangle.features.json",
+    },
+    format: {
+        kind: "string",
+        placeholder: "text|json",
+        describe: "Output format. `json` contains all findings, including the skip ledger.",
+        defaultLabel: "text",
+    },
+};
+/** argv → options. Rejects the ambiguous call rather than picking a winner. */
+export function initOptionsFrom(args, cwd) {
+    if (args.positionals.length > 1) {
+        throw new UsageError(`init accepts at most one path; received ${String(args.positionals.length)}.`, "untangle init [PATH]");
+    }
+    const positional = args.positionals[0];
+    const flagRoot = stringFlag(args, "root");
+    if (positional !== undefined && flagRoot !== undefined) {
+        throw new UsageError("Specify the path as either an argument or --root, not both.", "untangle init /path/to/project");
+    }
+    const preferredModel = stringFlag(args, "embedding-model");
+    const visionPath = stringFlag(args, "vision");
+    const specPath = stringFlag(args, "spec");
+    const featureManifestPath = stringFlag(args, "feature-map");
+    const storageBackend = args.flags["storage"] === undefined
+        ? undefined
+        : enumFlag(args, "storage", ["lancedb", "qdrant"], "lancedb");
+    return {
+        root: path.resolve(cwd, flagRoot ?? positional ?? "."),
+        force: boolFlag(args, "force"),
+        dryRun: boolFlag(args, "dry-run"),
+        offline: boolFlag(args, "offline"),
+        ...(storageBackend === undefined ? {} : { storageBackend }),
+        ...(preferredModel === undefined ? {} : { preferredModel }),
+        ...(visionPath === undefined ? {} : { visionPath }),
+        ...(specPath === undefined ? {} : { specPath }),
+        ...(featureManifestPath === undefined ? {} : { featureManifestPath }),
+    };
+}
+export function createInitCommand(deps = {}) {
+    return {
+        spec: {
+            name: "init",
+            implementedBy: "commands/init/index.js",
+            summary: "Discover a project and write a commented untangle.toml",
+            usage: "untangle init [PATH] [--interactive|--no-interactive] [--storage=lancedb|qdrant] [--vision=PATH] [--spec=PATH] [--feature-map=PATH] [--force] [--dry-run] [--offline]",
+            details: [
+                "On a terminal, guided setup previews configuration, optional local search/analyzer installation and a local feature/code map. No file, download or service is changed before the final selection. Preparing recipes and executing the displayed setup are separate choices. Prompts stay on stderr. Escape and Ctrl-C cancel; raw terminal mode is restored before external tools run.",
+                "Pipes, agents, --format=json, --dry-run, --offline and --no-interactive retain config-only behavior. Explicit --interactive requires a terminal and cannot be combined with JSON or dry-run. Explicit offline interactive setup may prepare local files but cannot download or start tools.",
+                `Discovers project languages weighted by lines, identifying parsed and search-only languages; monorepo topology across workspace packages and container services; an available embedding provider with its reported model, vector width and context window; an available vector store; and .gitignore rules plus defaults.`,
+                `Writes a ${CONFIG_FILE_NAME} with comments explaining each value's evidence. Omitted values come from product defaults; the file includes only decisions made by init.`,
+                "New projects use embedded LanceDB at .untangle/index/lancedb. No Docker or Qdrant probe is needed. Select --storage=qdrant for an owned or explicitly configured server. Missing Ollama is not an error; local offline indexing remains available.",
+                "Vision and specification are inspected locally through filenames, readability, hashes and document references. --vision and --spec select sources relative to the project directory. The review draft confirms neither features nor ownership and does not claim semantic conformance.",
+                "A supplied --feature-map, or untangle.features.json when present, makes declared features, code/test evidence, ownership declarations and feature complexity visible. No tests are executed and semantic conformance is not independently proven. Noninteractive init writes no visual map; confirmed guided setup may save a separate HTML/JSON snapshot. No ownership or implementation is confirmed automatically.",
+                "Spec-driven setup can inspect detected local Spec Kit or OpenSpec artifacts when no explicit feature manifest was chosen. Only final confirmation saves a source-bound proposed manifest under .untangle/sdd/ and uses it for this setup's feature report/map. Existing declarations are preserved. No framework commands or tests run; imported features remain planned/proposed without invented owners. The same connector is available through `untangle product connect [auto|spec-kit|openspec]`.",
+                "Discovery reads service information with GET and probes /api/embed with a small POST. Noninteractive init does not start or modify foreign services. A foreign vector store's usual default port is deliberately not probed (spec.md §3.2); set UNTANGLE_QDRANT_URL to select it explicitly. Only a confirmed interactive tool selection can install/start prepared owned services.",
+                "A second identical run changes nothing. If an existing file differs, init displays line-by-line differences and preserves it unless --force is explicit.",
+            ],
+            flags: FLAGS,
+            examples: [
+                "untangle init",
+                "untangle init --interactive",
+                "untangle init --no-interactive --offline",
+                "untangle init /path/to/another/project --dry-run",
+                "untangle init --offline --force",
+                "untangle init --format=json",
+                "untangle init /path/to/project --vision=docs/vision.md --spec=docs/requirements.md",
+            ],
+            exitCodes: [
+                [EXIT.ok, `${CONFIG_FILE_NAME} written or already current.`],
+                [
+                    EXIT.operational,
+                    "An existing file differs and was preserved (use --force), or the generated configuration would be invalid.",
+                ],
+                [EXIT.usage, "Invalid arguments."],
+            ],
+        },
+        async run(ctx, args) {
+            const format = enumFlag(args, "format", ["text", "json"], "text");
+            const options = initOptionsFrom(args, ctx.cwd);
+            const explicit = args.flags["interactive"];
+            if (explicit === true && (format === "json" || options.dryRun))
+                throw new UsageError("--interactive cannot be combined with --format=json or --dry-run.", "Use --no-interactive for a machine-readable or write-free preview.");
+            const automatic = explicit === undefined &&
+                ctx.io === processIo &&
+                process.stdin.isTTY === true &&
+                process.stderr.isTTY === true &&
+                !ctx.env["CI"] &&
+                format === "text" &&
+                !options.dryRun &&
+                !options.offline;
+            const { wizard, ...ports } = deps;
+            const initDeps = {
+                env: ctx.env,
+                signal: ctx.signal,
+                ...ports,
+            };
+            let result;
+            if (explicit === true || automatic) {
+                if (wizard?.terminal === undefined &&
+                    (process.stdin.isTTY !== true || process.stderr.isTTY !== true))
+                    throw new UsageError("--interactive requires a terminal on stdin and stderr.", "Use `untangle init --no-interactive` in a pipe or coding agent.");
+                const terminal = wizard?.terminal ??
+                    createWizardTerminal({ write: (text) => ctx.io.err(text), signal: ctx.signal });
+                if (!terminal.interactive ||
+                    (wizard?.terminal === undefined && process.stderr.isTTY !== true))
+                    throw new UsageError("--interactive requires a terminal on stdin and stderr.", "Use `untangle init --no-interactive` in a pipe or coding agent.");
+                const completed = await runInitWizard(ctx, options, initDeps, { ...wizard, terminal });
+                if (completed.result === null)
+                    return completed.exitCode;
+                result = completed.result;
+                if (completed.exitCode !== result.exitCode)
+                    return completed.exitCode;
+            }
+            else
+                result = await runInit(options, initDeps);
+            if (format === "json") {
+                line(ctx.io, JSON.stringify(result, null, 2));
+                return result.exitCode;
+            }
+            // The path goes to stdout — it is the payload of this command, the one
+            // thing a script would pipe. Everything else is diagnosis (cli/io.ts).
+            line(ctx.io, result.configPath);
+            for (const reportLine of formatTextReport(result)) {
+                note(ctx.io, reportLine);
+            }
+            return result.exitCode;
+        },
+    };
+}
+/** The command with production ports. */
+export const initCommand = createInitCommand();
+//# sourceMappingURL=command.js.map

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

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

package/dist/commands/init/config-draft.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Turning findings into a configuration.
+ *
+ * The shape written to disk is `UntangleConfigV1` from
+ * `@untangle-code/config` — not a private CLI dialect — and it is checked with
+ * that package's own validator before a byte reaches the file system. A first
+ * command that writes a configuration the rest of the product then rejects is
+ * a first command that has failed.
+ *
+ * WHICH SECTIONS GET WRITTEN: only the ones `init` actually DECIDED something
+ * about. Everything else is left to the product defaults, because a file that
+ * restates two hundred defaults verbatim tells the reader nothing about what
+ * was chosen. `defaultsFor` records the values that stay defaulted so the
+ * renderer can name them in prose instead.
+ */
+import type { RawConfigLayer } from "@untangle-code/config";
+import type { ProjectFindingsV1 } from "./types.js";
+export interface ConfigDraftV1 {
+    /** Exactly what `init` decided — the layer that ends up in the file. */
+    layer: RawConfigLayer;
+    /** Validator warnings over the layer merged onto the product defaults. */
+    warnings: string[];
+    /** Validator errors. Non-empty means the file is NOT written. */
+    errors: string[];
+}
+/**
+ * Derives a project id from a directory name.
+ *
+ * Lowercase, non-alphanumerics collapsed to `-`, trimmed. A name that reduces
+ * to nothing (a directory called `...`) falls back to `project`, because an
+ * empty id would fail validation and an id derived from something random
+ * would not be reproducible.
+ */
+export declare function deriveProjectId(directoryName: string): string;
+export declare function buildConfigDraft(findings: ProjectFindingsV1): ConfigDraftV1;
+/** `untangle_<projectId>_` — keeps two projects on one instance from colliding. */
+export declare function collectionPrefixFor(findings: ProjectFindingsV1): string;
+/**
+ * The single next step.
+ *
+ * EXACTLY ONE, in a fixed priority order, because a first command that ends
+ * in a list of five things is a first command the user closes. The order is
+ * "what blocks the next command first": no embedding provider blocks
+ * indexing; no model blocks it too; no vector store blocks it; otherwise
+ * nothing blocks it and the step is to index.
+ */
+export declare function nextStepFor(findings: ProjectFindingsV1): string;
+//# sourceMappingURL=config-draft.d.ts.map

package/dist/commands/init/config-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-draft.d.ts","sourceRoot":"","sources":["../../../src/commands/init/config-draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,KAAK,EAAE,cAAc,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CA0D3E;AA4CD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEvE;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAiC/D"}

package/dist/commands/init/config-draft.js

@@ -0,0 +1,201 @@
+/**
+ * Turning findings into a configuration.
+ *
+ * The shape written to disk is `UntangleConfigV1` from
+ * `@untangle-code/config` — not a private CLI dialect — and it is checked with
+ * that package's own validator before a byte reaches the file system. A first
+ * command that writes a configuration the rest of the product then rejects is
+ * a first command that has failed.
+ *
+ * WHICH SECTIONS GET WRITTEN: only the ones `init` actually DECIDED something
+ * about. Everything else is left to the product defaults, because a file that
+ * restates two hundred defaults verbatim tells the reader nothing about what
+ * was chosen. `defaultsFor` records the values that stay defaulted so the
+ * renderer can name them in prose instead.
+ */
+import { DEFAULT_EMBEDDING_CONFIG, DEFAULT_INDEX_CONFIG, PRODUCT_DEFAULT_CONFIG, mergeConfigLayers, validateEffectiveConfig, } from "@untangle-code/config";
+import { sha256Hex, sortByCodepoints } from "@untangle-code/domain";
+/**
+ * Derives a project id from a directory name.
+ *
+ * Lowercase, non-alphanumerics collapsed to `-`, trimmed. A name that reduces
+ * to nothing (a directory called `...`) falls back to `project`, because an
+ * empty id would fail validation and an id derived from something random
+ * would not be reproducible.
+ */
+export function deriveProjectId(directoryName) {
+    const slug = directoryName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, "-")
+        .replace(/^-+|-+$/gu, "");
+    return slug.length === 0 ? "project" : slug;
+}
+export function buildConfigDraft(findings) {
+    const contextArtifacts = productContextArtifacts(findings);
+    const layer = {
+        schemaVersion: 1,
+        projectId: findings.projectId,
+        repositories: [
+            {
+                id: findings.projectId,
+                // Relative to this configuration file — spec.md §4.3 allows exactly
+                // that, and a relative path keeps the file portable between checkouts.
+                path: ".",
+                label: findings.projectId,
+                exclude: sortByCodepoints([
+                    ...findings.ignore.defaultExcludes,
+                    ...findings.ignore.additionalExcludes,
+                ]),
+            },
+        ],
+        ...(findings.storage?.backend === "lancedb"
+            ? {
+                storage: {
+                    backend: "lancedb",
+                    ...(findings.storage.path === undefined ? {} : { path: findings.storage.path }),
+                },
+            }
+            : { storage: { backend: "qdrant" }, qdrant: buildQdrantSection(findings) }),
+        embeddings: buildEmbeddingSection(findings),
+        index: {
+            // The only index knob `init` moves: a project whose sources are wider
+            // than the default ceiling would otherwise lose them silently.
+            maxFileSizeMb: DEFAULT_INDEX_CONFIG.maxFileSizeMb,
+            watch: DEFAULT_INDEX_CONFIG.watch,
+        },
+        graph: {
+            // Both levels of the topology feed the graph; a single-package project
+            // gets the same setting, it simply has less to draw.
+            enabled: true,
+        },
+        telemetry: { enabled: false },
+        ...(contextArtifacts.length === 0 ? {} : { contextArtifacts }),
+    };
+    const merged = mergeConfigLayers([PRODUCT_DEFAULT_CONFIG, layer]);
+    const validation = validateEffectiveConfig(merged);
+    return {
+        layer,
+        warnings: [
+            ...validation.warnings.map((issue) => `${issue.path}: ${issue.message}`),
+            ...(findings.storage?.configurationWarnings ?? []),
+            ...(findings.storage?.directoryStatus === "not-directory" ||
+                findings.storage?.directoryStatus === "unreadable"
+                ? [
+                    `Local storage ${findings.storage.directory}: ${findings.storage.directoryStatus}${findings.storage.detail === undefined ? "" : ` (${findings.storage.detail})`}. Indexing cannot use this path.`,
+                ]
+                : []),
+        ],
+        errors: validation.errors.map((issue) => `${issue.path}: ${issue.message} [${issue.code}]`),
+    };
+}
+function productContextArtifacts(findings) {
+    const descriptions = {
+        vision: "Provisional vision",
+        specification: "Provisional specification",
+        product: "Provisional product description",
+    };
+    return (findings.productContext?.sources ?? [])
+        .filter((source) => source.selected && source.status === "readable")
+        .map((source) => ({
+        name: `product-${source.role}-${sha256Hex(source.path).slice(0, 12)}`,
+        path: `./${source.path}`,
+        description: `${descriptions[source.role]}; local document inspection, features and ownership remain unconfirmed.`,
+        type: "markdown",
+    }));
+}
+/**
+ * Qdrant: `external` only when an endpoint actually answered. Otherwise
+ * `managed` with no URL — the mode that says "start your own instance", which
+ * is the correct answer both when nothing is running and when the only thing
+ * running is somebody else's (spec.md §3.2).
+ */
+function buildQdrantSection(findings) {
+    if (findings.storage?.qdrantMode !== undefined) {
+        return {
+            mode: findings.storage.qdrantMode,
+            ...(findings.storage.qdrantUrl === undefined ? {} : { url: findings.storage.qdrantUrl }),
+            collectionPrefix: collectionPrefixFor(findings),
+        };
+    }
+    if (findings.qdrant.outcome === "reachable" && findings.qdrant.url !== undefined) {
+        return {
+            mode: "external",
+            url: findings.qdrant.url,
+            collectionPrefix: collectionPrefixFor(findings),
+        };
+    }
+    return { mode: "managed", collectionPrefix: collectionPrefixFor(findings) };
+}
+/** `untangle_<projectId>_` — keeps two projects on one instance from colliding. */
+export function collectionPrefixFor(findings) {
+    return `untangle_${findings.projectId.replace(/-/gu, "_")}_`;
+}
+/**
+ * Embeddings: when a provider answered, the model AND its vector width and
+ * context window are taken from what the provider reported about itself. When
+ * none answered, the product default profile stands and `mode` stays `auto`,
+ * so the next run can still discover a provider without the user editing
+ * anything.
+ */
+function buildEmbeddingSection(findings) {
+    const chosen = findings.ollama.chosenModel;
+    if (findings.ollama.outcome !== "reachable" || chosen === undefined) {
+        return {
+            provider: "ollama",
+            mode: "auto",
+            model: DEFAULT_EMBEDDING_CONFIG.model,
+            dimensions: DEFAULT_EMBEDDING_CONFIG.dimensions,
+            contextLength: DEFAULT_EMBEDDING_CONFIG.contextLength,
+        };
+    }
+    return {
+        provider: "ollama",
+        mode: "external",
+        url: findings.ollama.url,
+        model: chosen.name,
+        dimensions: chosen.dimensions ?? DEFAULT_EMBEDDING_CONFIG.dimensions,
+        contextLength: chosen.contextLength ?? DEFAULT_EMBEDDING_CONFIG.contextLength,
+    };
+}
+/**
+ * The single next step.
+ *
+ * EXACTLY ONE, in a fixed priority order, because a first command that ends
+ * in a list of five things is a first command the user closes. The order is
+ * "what blocks the next command first": no embedding provider blocks
+ * indexing; no model blocks it too; no vector store blocks it; otherwise
+ * nothing blocks it and the step is to index.
+ */
+export function nextStepFor(findings) {
+    if (findings.storage?.backend === "lancedb") {
+        if (findings.storage.directoryStatus === "not-directory" ||
+            findings.storage.directoryStatus === "unreadable")
+            return `Local storage path ${JSON.stringify(findings.storage.directory)} is ${findings.storage.directoryStatus}. Next step: choose an accessible directory with UNTANGLE_LANCEDB_PATH and rerun \`untangle init\`.`;
+        if (findings.ollama.outcome !== "reachable" || findings.ollama.chosenModel === undefined)
+            return "Local LanceDB storage needs no service. Next step: `untangle index --embedder=offline` (local vectors without semantic embeddings).";
+    }
+    if (findings.ollama.outcome !== "reachable") {
+        return `No embedding provider at ${findings.ollama.url}. Next step: start \`ollama serve\` and rerun \`untangle init\`.`;
+    }
+    if (findings.ollama.chosenModel === undefined) {
+        return `${findings.ollama.url} is running but reports no embedding model. Next step: \`ollama pull ${DEFAULT_EMBEDDING_CONFIG.model}\`.`;
+    }
+    if (findings.storage?.backend !== "lancedb" && findings.qdrant.outcome !== "reachable") {
+        if (findings.storage?.qdrantMode === "external")
+            return `The selected Qdrant server ${JSON.stringify(findings.storage.qdrantUrl)} is unreachable. Next step: check that server's URL and availability, then rerun \`untangle doctor\`.`;
+        return "No vector store is reachable. Next step: start an owned instance with `docker run -d --name untangle-qdrant -p 16333:6333 -v untangle-qdrant-data:/qdrant/storage qdrant/qdrant`, then run `untangle index`.";
+    }
+    // WP-228: Der Anbieter laeuft, das Modell ist da, der Speicher steht — und
+    // trotzdem kann nicht indiziert werden, weil der Endpunkt, den der
+    // Indexlauf benutzt, nicht antwortet. Das ist ein eigener Fall und
+    // verdient einen eigenen naechsten Schritt; „alles vorhanden" waere hier
+    // schlicht falsch.
+    if (findings.ollama.embedProbe.outcome === "timeout") {
+        return `${findings.ollama.url} responds on /api/tags, but /api/embed did not respond within ${String(findings.ollama.embedProbe.timeoutMs)} ms, so embeddings are unavailable. Next step: \`untangle index --embedder=offline\` (local vectors without semantics).`;
+    }
+    if (findings.ollama.embedProbe.outcome === "failed") {
+        return `${findings.ollama.url} is running, but /api/embed failed (${findings.ollama.embedProbe.detail ?? "no details"}). Next step: \`untangle index --embedder=offline\` (local vectors without semantics).`;
+    }
+    return "Everything is available. Next step: `untangle index`.";
+}
+//# sourceMappingURL=config-draft.js.map

package/dist/commands/init/config-draft.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Idempotency: what a second run would change.
+ *
+ * `init` compares the RENDERED text against the file on disk rather than
+ * parsing the file back into a config object. That is a deliberate choice and
+ * it buys three things at once:
+ *
+ * - it needs no TOML parser, so there is no second grammar to keep in step
+ *   with the writer;
+ * - it notices changes the user made BY HAND, including in the comments,
+ *   which a value-level comparison would call "identical";
+ * - it is only meaningful because `renderUntangleToml` is pure and carries no
+ *   clock — otherwise every run would differ and the check would be theatre.
+ *
+ * The comparison is a line diff, so the report says which lines would be
+ * added and which lost, not merely "the file differs".
+ */
+import type { ConfigChangeV1 } from "./types.js";
+/** Splits into lines, dropping the single trailing empty element of a final newline. */
+export declare function toLines(text: string): string[];
+/**
+ * Line diff, longest-common-subsequence based.
+ *
+ * The dynamic-programming table is O(n·m); both sides are a configuration
+ * file, so that is a few hundred by a few hundred. Above `LCS_LINE_BUDGET`
+ * the function falls back to a multiset comparison — less precise about
+ * ORDER, but still exact about which lines appear on only one side, and it
+ * cannot be made to allocate gigabytes by a pathological input.
+ */
+export declare function diffLines(before: readonly string[], after: readonly string[]): ConfigChangeV1[];
+/** True when the file on disk already IS what `init` would write. */
+export declare function isUnchanged(existing: string, rendered: string): boolean;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/commands/init/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,EAAE,CAgD/F;AAwBD,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvE"}

package/dist/commands/init/diff.js

@@ -0,0 +1,109 @@
+/**
+ * Idempotency: what a second run would change.
+ *
+ * `init` compares the RENDERED text against the file on disk rather than
+ * parsing the file back into a config object. That is a deliberate choice and
+ * it buys three things at once:
+ *
+ * - it needs no TOML parser, so there is no second grammar to keep in step
+ *   with the writer;
+ * - it notices changes the user made BY HAND, including in the comments,
+ *   which a value-level comparison would call "identical";
+ * - it is only meaningful because `renderUntangleToml` is pure and carries no
+ *   clock — otherwise every run would differ and the check would be theatre.
+ *
+ * The comparison is a line diff, so the report says which lines would be
+ * added and which lost, not merely "the file differs".
+ */
+/** Above this line count the diff degrades to a set comparison (see `diffLines`). */
+const LCS_LINE_BUDGET = 2_000;
+/** Splits into lines, dropping the single trailing empty element of a final newline. */
+export function toLines(text) {
+    const lines = text.split("\n");
+    if (lines.length > 0 && lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    return lines;
+}
+/**
+ * Line diff, longest-common-subsequence based.
+ *
+ * The dynamic-programming table is O(n·m); both sides are a configuration
+ * file, so that is a few hundred by a few hundred. Above `LCS_LINE_BUDGET`
+ * the function falls back to a multiset comparison — less precise about
+ * ORDER, but still exact about which lines appear on only one side, and it
+ * cannot be made to allocate gigabytes by a pathological input.
+ */
+export function diffLines(before, after) {
+    if (before.length > LCS_LINE_BUDGET || after.length > LCS_LINE_BUDGET) {
+        return multisetDiff(before, after);
+    }
+    const rows = before.length;
+    const columns = after.length;
+    // table[i][j] = length of the LCS of before[i…] and after[j…]
+    const table = Array.from({ length: rows + 1 }, () => new Array(columns + 1).fill(0));
+    for (let i = rows - 1; i >= 0; i -= 1) {
+        const row = table[i];
+        const nextRow = table[i + 1];
+        for (let j = columns - 1; j >= 0; j -= 1) {
+            row[j] =
+                before[i] === after[j]
+                    ? nextRow[j + 1] + 1
+                    : Math.max(nextRow[j], row[j + 1]);
+        }
+    }
+    const changes = [];
+    let i = 0;
+    let j = 0;
+    while (i < rows && j < columns) {
+        if (before[i] === after[j]) {
+            i += 1;
+            j += 1;
+            continue;
+        }
+        const row = table[i];
+        const nextRow = table[i + 1];
+        if (nextRow[j] >= row[j + 1]) {
+            changes.push({ kind: "removed", line: before[i].trimEnd() });
+            i += 1;
+        }
+        else {
+            changes.push({ kind: "added", line: after[j].trimEnd() });
+            j += 1;
+        }
+    }
+    for (; i < rows; i += 1) {
+        changes.push({ kind: "removed", line: before[i].trimEnd() });
+    }
+    for (; j < columns; j += 1) {
+        changes.push({ kind: "added", line: after[j].trimEnd() });
+    }
+    return changes;
+}
+function multisetDiff(before, after) {
+    const counts = new Map();
+    for (const line of before) {
+        counts.set(line, (counts.get(line) ?? 0) + 1);
+    }
+    const changes = [];
+    for (const line of after) {
+        const remaining = counts.get(line) ?? 0;
+        if (remaining > 0) {
+            counts.set(line, remaining - 1);
+        }
+        else {
+            changes.push({ kind: "added", line: line.trimEnd() });
+        }
+    }
+    for (const [line, remaining] of counts) {
+        for (let index = 0; index < remaining; index += 1) {
+            changes.push({ kind: "removed", line: line.trimEnd() });
+        }
+    }
+    return changes;
+}
+/** True when the file on disk already IS what `init` would write. */
+export function isUnchanged(existing, rendered) {
+    return existing === rendered;
+}
+//# sourceMappingURL=diff.js.map

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

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