@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/init/report.js

@@ -0,0 +1,163 @@
+/**
+ * The terminal report of `untangle init`.
+ *
+ * Separate from the file it writes, and deliberately shorter: the file is the
+ * record, the report is the answer to "what just happened and what do I do
+ * now". It ends in exactly one next step — never a list — because a first
+ * command that hands back five errands is a first command nobody finishes.
+ *
+ * Wall-clock time is allowed in a report (it is not result data), and is
+ * still not used here: there is nothing about `init` whose duration a user
+ * needs to be told.
+ */
+import { formatCount, formatShare, productContextWarnings } from "./render.js";
+/** Human report. One line per array element, no trailing newline. */
+export function formatTextReport(result) {
+    const { findings } = result;
+    const lines = [];
+    lines.push(`untangle init — ${findings.root}`);
+    lines.push("");
+    const languages = findings.languages;
+    if (languages.entries.length === 0) {
+        lines.push("Languages       no analyzable files found");
+    }
+    else {
+        const top = languages.entries
+            .slice(0, 5)
+            .map((entry) => `${entry.languageId} ${formatShare(entry.lineShare)}`)
+            .join(", ");
+        lines.push(`Languages       ${top}`);
+        lines.push(`                ${formatCount(languages.totalFiles)} files, ${formatCount(languages.totalLines)} lines; ${formatShare(languages.parsedLineShare)} with a parser`);
+        const withoutParser = languages.entries.filter((entry) => !entry.hasParserAdapter && entry.lineShare >= 0.05);
+        if (withoutParser.length > 0) {
+            lines.push(`                no parser (text search only): ${withoutParser.map((entry) => entry.languageId).join(", ")}`);
+        }
+    }
+    const topology = findings.topology;
+    lines.push(`Topology        ${formatCount(topology.packages.length)} packages, ${formatCount(topology.services.length)} Container-Dienste${topology.isMonorepo ? "; monorepo" : "; single project"}`);
+    if (topology.workspaceGlobs.length > 0) {
+        lines.push(`                Globs: ${topology.workspaceGlobs.join(", ")}`);
+    }
+    if (topology.packages.length > 0) {
+        lines.push(`                ${topology.packages.map((pkg) => pkg.name).join(", ")}`);
+    }
+    if (topology.services.length > 0) {
+        lines.push(`                Services: ${topology.services.map((service) => service.name).join(", ")}`);
+    }
+    for (const uncovered of topology.managers.uncoveredByTopology) {
+        lines.push(`                GAP: ${uncovered} declares packages that were not found`);
+    }
+    const productContext = findings.productContext;
+    if (productContext !== undefined) {
+        const readable = productContext.sources.filter((source) => source.selected && source.status === "readable").length;
+        lines.push(`Produktkontext  ${formatCount(readable)} selected sources readable; ${productContext.status}; ${formatCount(productContext.reviewDraft.questions.length)} open questions in the review draft`);
+        for (const warning of productContextWarnings(findings)) {
+            lines.push(`WARNING         ${warning}`);
+        }
+    }
+    const ollama = findings.ollama;
+    if (findings.featureAlignment !== undefined) {
+        const alignment = findings.featureAlignment;
+        lines.push(`Feature evidence ${alignment.status}; ${formatCount(alignment.features.length)} declared features; semantic conformance ${alignment.semanticConformance}`);
+        for (const feature of alignment.features) {
+            lines.push(`                ${feature.id.replace(/[\r\n]/gu, " ")}: ${feature.status}; ownership ${feature.ownership.map((owner) => `${owner.id.replace(/[\r\n]/gu, " ")}:${owner.status}`).join(", ") || "none"}; test evidence ${feature.testEvidence.status}`);
+            for (const hint of feature.agentHints) {
+                lines.push(`HINT            ${hint.code}: ${hint.message.replace(/[\r\n]/gu, " ")}`);
+            }
+        }
+        for (const limitation of alignment.limitations) {
+            lines.push(`LIMIT           ${limitation.replace(/[\r\n]/gu, " ")}`);
+        }
+    }
+    lines.push(ollama.outcome === "reachable"
+        ? `Embeddings      ${ollama.url} erreichbar${ollama.chosenModel === undefined ? "; no embedding model" : ` — ${ollama.chosenModel.name} (${ollama.chosenModel.dimensions === undefined ? "?" : formatCount(ollama.chosenModel.dimensions)} dimensions)`}`
+        : `Embeddings      ${ollama.url} unreachable; this is not an error`);
+    // WP-228: Die Zeile darueber sagt nur, dass /api/tags geantwortet hat.
+    // Diese hier sagt, ob der Dienst das kann, wofuer er gebraucht wird.
+    lines.push(`                ${describeEmbedProbe(ollama)}`);
+    if (findings.storage?.backend === "lancedb") {
+        lines.push(`Vector store    LanceDB at ${findings.storage.directory}; directory ${findings.storage.directoryStatus}`);
+        lines.push("                Local storage only; no database opened, Docker or Qdrant probed.");
+    }
+    else {
+        const qdrant = findings.qdrant;
+        lines.push(qdrant.outcome === "reachable"
+            ? `Vector store    ${qdrant.url ?? "?"} reachable`
+            : `Vector store    unreachable (${qdrant.probedUrls.join(", ")}); this is not an error`);
+        for (const skipped of qdrant.skippedUrls) {
+            lines.push(`                not checked: ${skipped.url}`);
+        }
+    }
+    const ignore = findings.ignore;
+    lines.push(ignore.gitignorePresent
+        ? `Ignore rules    .gitignore with ${formatCount(ignore.gitignoreRuleCount)} rules + ${formatCount(ignore.defaultExcludes.length)} defaults${ignore.additionalExcludes.length > 0 ? `, ${formatCount(ignore.additionalExcludes.length)} imported (${ignore.additionalExcludes.join(", ")})` : ""}`
+        : `Ignore rules    no .gitignore; ${formatCount(ignore.defaultExcludes.length)} defaults`);
+    if (findings.skipped.entries.length > 0) {
+        lines.push(`Skipped         ${formatCount(findings.skipped.entries.length)} entries with reasons (--format json shows all)`);
+    }
+    lines.push("");
+    lines.push(...formatOutcome(result));
+    for (const warning of result.configWarnings) {
+        lines.push(`WARNING         ${warning}`);
+    }
+    for (const error of result.configErrors) {
+        lines.push(`ERROR           ${error}`);
+    }
+    lines.push("");
+    lines.push(result.nextStep);
+    return lines;
+}
+/**
+ * Der Satz zum Probe-Embedding (WP-228).
+ *
+ * Er nennt IMMER, was geprueft wurde — auch im Erfolgsfall. Eine Zeile, die
+ * nur bei Problemen erscheint, liest sich in ihrer Abwesenheit wie „geprueft
+ * und in Ordnung", und genau das war der Befund.
+ */
+export function describeEmbedProbe(ollama) {
+    const probe = ollama.embedProbe;
+    switch (probe.outcome) {
+        case "ok":
+            return `/api/embed checked: responds${probe.dimensions === undefined ? "" : ` (${formatCount(probe.dimensions)} dimensions)`}; the service is usable`;
+        case "timeout":
+            return `/api/embed NO RESPONSE within ${formatCount(probe.timeoutMs)} ms; reachable does not mean usable here; use \`--embedder=offline\``;
+        case "failed":
+            return `/api/embed failed (${probe.detail ?? "no details"}); use \`--embedder=offline\``;
+        default:
+            return `/api/embed not checked (${probe.detail ?? "no details"})`;
+    }
+}
+function formatOutcome(result) {
+    switch (result.outcome) {
+        case "created":
+            return [`Written         ${result.configPath}`];
+        case "overwritten":
+            return [`Overwritten     ${result.configPath} (--force)`];
+        case "unchanged":
+            return [`Unchanged       ${result.configPath}; a second identical run changes nothing.`];
+        case "would-create":
+            return [`--dry-run       ${result.configPath} would be created (nothing written).`];
+        case "would-be-unchanged":
+            return [`--dry-run       ${result.configPath} is already current (nothing written).`];
+        case "would-overwrite":
+        case "differs":
+            return [
+                result.outcome === "differs"
+                    ? `Difference      ${result.configPath} differs. Nothing written; use --force to overwrite.`
+                    : `--dry-run       ${result.configPath} would change (nothing written).`,
+                ...formatChanges(result),
+            ];
+        default:
+            return [];
+    }
+}
+/** At most 40 changed lines; more than that is a rewrite, not a diff. */
+function formatChanges(result) {
+    const shown = result.changes.slice(0, 40);
+    const lines = shown.map((change) => `  ${change.kind === "added" ? "+" : "-"} ${change.line}`);
+    if (result.changes.length > shown.length) {
+        lines.push(`  … ${formatCount(result.changes.length - shown.length)} additional lines`);
+    }
+    return lines;
+}
+//# sourceMappingURL=report.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * `untangle init` — the command a user runs first.
+ *
+ * It reads a project, decides, writes one commented file, and names one next
+ * step. It asks nothing. Everything it cannot determine becomes a documented
+ * finding, never a prompt and never an abort: an absent embedding provider,
+ * an absent vector store, an unreadable manifest are all things a
+ * configuration can be written AROUND (WP-125).
+ *
+ * WRITE SAFETY: the file goes to a temporary sibling and is renamed into
+ * place, so an interrupted run can never leave half a configuration behind.
+ * An existing file is replaced only with `--force`; the run that declines to
+ * replace it says exactly which lines would have differed.
+ *
+ * This module is free of argv and of output formatting — `command.ts` binds
+ * it to the CLI shell. That split is what lets the whole command be tested
+ * against an in-memory file system and a probe that answers nothing.
+ */
+import type { FileSystemPort, ParserRegistry } from "@untangle-code/domain";
+import type { HttpProbePort, InitLimitsV1, InitOutcome, InitResultV1 } from "./types.js";
+/** The file `init` writes. */
+export declare const CONFIG_FILE_NAME = "untangle.toml";
+/** Suffix of the temporary sibling used for the atomic write. */
+export declare const TEMP_SUFFIX = ".untangle-init-tmp";
+/** Ports and overrides. Every one of them has a real default; tests replace them. */
+export interface InitDepsV1 {
+    fs?: FileSystemPort;
+    http?: HttpProbePort;
+    parserRegistry?: ParserRegistry;
+    env?: Readonly<Record<string, string | undefined>>;
+    limits?: Partial<InitLimitsV1>;
+    signal?: AbortSignal;
+}
+export interface InitOptionsV1 {
+    /** Absolute directory to initialise. */
+    root: string;
+    force: boolean;
+    dryRun: boolean;
+    /** Skip every network probe; the infrastructure counts as absent. */
+    offline: boolean;
+    /** Explicit selection; otherwise environment and existing configuration apply. */
+    storageBackend?: "lancedb" | "qdrant";
+    preferredModel?: string;
+    /** Product intent sources, relative to the chosen project root. */
+    visionPath?: string;
+    specPath?: string;
+    featureManifestPath?: string;
+}
+/** The command proper. Returns a result; never writes to a terminal. */
+export declare function runInit(options: InitOptionsV1, deps?: InitDepsV1): Promise<InitResultV1>;
+/**
+ * The whole decision table of idempotency, in one place.
+ *
+ * `--dry-run` never writes and never fails: it reports. Without `--force` an
+ * existing, differing file is left alone — the second run "meldet, was sich
+ * geaendert hat" instead of quietly rewriting a file the user may well have
+ * edited on purpose.
+ */
+export declare function decideOutcome(existing: string | null, rendered: string, options: Pick<InitOptionsV1, "force" | "dryRun">): InitOutcome;
+/**
+ * Which vector-store URLs get probed.
+ *
+ * WP-222: this no longer decides anything — it asks
+ * `cli/vector-store-policy.ts`, the one place that knows which store Untangle
+ * may use, and which `untangle doctor` obeys through `wireStorage`. An
+ * explicitly configured `UNTANGLE_QDRANT_URL` comes first ("this one is
+ * mine"), the managed default follows, and upstream's default port is
+ * skipped WITH ITS REASON rather than silently absent (E4).
+ */
+export declare function qdrantProbeList(env: Readonly<Record<string, string | undefined>>): string[];
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/init/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAC;AAoB/F,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,iEAAiE;AACjE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wEAAwE;AACxE,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CA6DvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,CAAC,GAC/C,WAAW,CAWb;AA0GD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,EAAE,CAE3F"}

package/dist/commands/init/run.js

@@ -0,0 +1,253 @@
+/**
+ * `untangle init` — the command a user runs first.
+ *
+ * It reads a project, decides, writes one commented file, and names one next
+ * step. It asks nothing. Everything it cannot determine becomes a documented
+ * finding, never a prompt and never an abort: an absent embedding provider,
+ * an absent vector store, an unreadable manifest are all things a
+ * configuration can be written AROUND (WP-125).
+ *
+ * WRITE SAFETY: the file goes to a temporary sibling and is renamed into
+ * place, so an interrupted run can never leave half a configuration behind.
+ * An existing file is replaced only with `--force`; the run that declines to
+ * replace it says exactly which lines would have differed.
+ *
+ * This module is free of argv and of output formatting — `command.ts` binds
+ * it to the CLI shell. That split is what lets the whole command be tested
+ * against an in-memory file system and a probe that answers nothing.
+ */
+import path from "node:path";
+import { analyzeProductAlignment } from "@untangle-code/core";
+import { summarizeSkipReasons } from "@untangle-code/domain";
+import { createParserRegistry } from "@untangle-code/parser-registry";
+import { NodeFileSystem } from "@untangle-code/scanner/node-fs";
+import { OperationalError } from "../../cli/exit.js";
+import { qdrantProbePlan } from "../../cli/vector-store-policy.js";
+import { buildConfigDraft, deriveProjectId, nextStepFor } from "./config-draft.js";
+import { diffLines, toLines } from "./diff.js";
+import { nodeHttpProbe, offlineProbe } from "./http-probe.js";
+import { detectIgnoreRules } from "./ignore-rules.js";
+import { buildLanguageCensus } from "./languages.js";
+import { assessProductContext } from "./product-context.js";
+import { renderUntangleToml } from "./render.js";
+import { DEFAULT_OLLAMA_URL, probeOllama, probeQdrant } from "./services.js";
+import { inspectInitStorage } from "./storage.js";
+import { detectTopology } from "./topology.js";
+import { DEFAULT_INIT_LIMITS } from "./types.js";
+/** The file `init` writes. */
+export const CONFIG_FILE_NAME = "untangle.toml";
+/** Suffix of the temporary sibling used for the atomic write. */
+export const TEMP_SUFFIX = ".untangle-init-tmp";
+/** The command proper. Returns a result; never writes to a terminal. */
+export async function runInit(options, deps = {}) {
+    deps.signal?.throwIfAborted();
+    const fs = deps.fs ?? new NodeFileSystem();
+    const http = deps.http ?? (options.offline ? offlineProbe() : nodeHttpProbe());
+    const parserRegistry = deps.parserRegistry ?? createParserRegistry();
+    const env = deps.env ?? process.env;
+    const limits = { ...DEFAULT_INIT_LIMITS, ...deps.limits };
+    const root = await canonicalRoot(fs, options.root);
+    const storage = await inspectInitStorage(fs, root, options.storageBackend, env, deps.signal);
+    const findings = await collectFindings({
+        fs,
+        http,
+        parserRegistry,
+        env,
+        limits,
+        root,
+        storage,
+        ...(options.preferredModel === undefined ? {} : { preferredModel: options.preferredModel }),
+        ...(options.visionPath === undefined ? {} : { visionPath: options.visionPath }),
+        ...(options.specPath === undefined ? {} : { specPath: options.specPath }),
+        ...(options.featureManifestPath === undefined
+            ? {}
+            : { featureManifestPath: options.featureManifestPath }),
+        ...(deps.signal === undefined ? {} : { signal: deps.signal }),
+    });
+    deps.signal?.throwIfAborted();
+    const draft = buildConfigDraft(findings);
+    const nextStep = nextStepFor(findings);
+    const rendered = renderUntangleToml({ findings, draft, limits, nextStep });
+    const configPath = path.join(root, CONFIG_FILE_NAME);
+    const base = {
+        configPath,
+        findings,
+        rendered,
+        nextStep,
+        configWarnings: draft.warnings,
+        configErrors: draft.errors,
+    };
+    if (draft.errors.length > 0) {
+        // A configuration the rest of the product would reject is not written at
+        // all. Reporting it and stopping is the only honest outcome.
+        return { ...base, outcome: "differs", changes: [], exitCode: 1 };
+    }
+    const existing = await readOptionalText(fs, configPath);
+    deps.signal?.throwIfAborted();
+    const outcome = decideOutcome(existing, rendered, options);
+    const changes = existing === null || existing === rendered
+        ? []
+        : diffLines(toLines(existing), toLines(rendered));
+    if (outcome === "created" || outcome === "overwritten") {
+        await writeAtomically(fs, configPath, rendered, deps.signal);
+    }
+    return { ...base, outcome, changes, exitCode: outcome === "differs" ? 1 : 0 };
+}
+/**
+ * The whole decision table of idempotency, in one place.
+ *
+ * `--dry-run` never writes and never fails: it reports. Without `--force` an
+ * existing, differing file is left alone — the second run "meldet, was sich
+ * geaendert hat" instead of quietly rewriting a file the user may well have
+ * edited on purpose.
+ */
+export function decideOutcome(existing, rendered, options) {
+    if (existing === null) {
+        return options.dryRun ? "would-create" : "created";
+    }
+    if (existing === rendered) {
+        return options.dryRun ? "would-be-unchanged" : "unchanged";
+    }
+    if (options.dryRun) {
+        return "would-overwrite";
+    }
+    return options.force ? "overwritten" : "differs";
+}
+async function collectFindings(input) {
+    const { fs, http, parserRegistry, env, limits, root } = input;
+    const skipEntries = [];
+    const onSkipEntry = (entry) => {
+        skipEntries.push(entry);
+    };
+    // Ignore rules first: their result narrows the scan that follows.
+    const ignore = await detectIgnoreRules({ fs, repoRoot: root });
+    const files = [];
+    const languages = await buildLanguageCensus({
+        fs,
+        parserRegistry,
+        repoRoot: root,
+        limits,
+        additionalExcludes: ignore.additionalExcludes,
+        selfManagedPaths: [CONFIG_FILE_NAME, `${CONFIG_FILE_NAME}${TEMP_SUFFIX}`],
+        onSkipEntry,
+        onDiscoveredFile: (file) => files.push(file),
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+    });
+    const topology = await detectTopology({ fs, repoRoot: root, limits, onSkipEntry });
+    const productContext = await assessProductContext({
+        fs,
+        root,
+        files,
+        inventoryTruncated: languages.truncated,
+        ...(input.visionPath === undefined ? {} : { visionPath: input.visionPath }),
+        ...(input.specPath === undefined ? {} : { specPath: input.specPath }),
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+    });
+    const featureAlignment = await analyzeProductAlignment({
+        fs,
+        root,
+        files,
+        inventoryTruncated: languages.truncated,
+        inventoryExcluded: languages.excluded.reduce((sum, entry) => sum + entry.count, 0),
+        inventoryScope: {
+            additionalDefaultExcludes: ignore.additionalExcludes,
+            maxFileSizeBytes: limits.maxFileSizeBytes,
+            maxFilesScanned: limits.maxFilesScanned,
+            concurrency: limits.concurrency,
+        },
+        parserRegistry,
+        ...(input.featureManifestPath === undefined ? {} : { manifestPath: input.featureManifestPath }),
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+    });
+    const probeInput = {
+        http,
+        limits,
+        ollamaUrl: env["UNTANGLE_OLLAMA_URL"] ?? env["UNTANGLE_EMBEDDINGS_URL"] ?? DEFAULT_OLLAMA_URL,
+        qdrantUrls: qdrantProbeList({
+            ...env,
+            ...(input.storage.qdrantUrl === undefined
+                ? {}
+                : { UNTANGLE_QDRANT_URL: input.storage.qdrantUrl }),
+        }),
+        ...(input.preferredModel === undefined ? {} : { preferredModel: input.preferredModel }),
+    };
+    const ollama = await probeOllama(probeInput);
+    const qdrant = input.storage.backend === "qdrant"
+        ? await probeQdrant(probeInput)
+        : { outcome: "not-probed", probedUrls: [], skippedUrls: [] };
+    return {
+        schemaVersion: 1,
+        root,
+        projectId: deriveProjectId(path.basename(root)),
+        languages,
+        topology,
+        productContext,
+        featureAlignment,
+        ignore,
+        ollama,
+        qdrant,
+        storage: input.storage,
+        skipped: {
+            schemaVersion: 1,
+            generationId: "untangle-init",
+            entries: skipEntries,
+            countsByReason: summarizeSkipReasons(skipEntries),
+        },
+    };
+}
+/**
+ * Which vector-store URLs get probed.
+ *
+ * WP-222: this no longer decides anything — it asks
+ * `cli/vector-store-policy.ts`, the one place that knows which store Untangle
+ * may use, and which `untangle doctor` obeys through `wireStorage`. An
+ * explicitly configured `UNTANGLE_QDRANT_URL` comes first ("this one is
+ * mine"), the managed default follows, and upstream's default port is
+ * skipped WITH ITS REASON rather than silently absent (E4).
+ */
+export function qdrantProbeList(env) {
+    return qdrantProbePlan(env).probe;
+}
+async function canonicalRoot(fs, candidate) {
+    const stat = await fs.stat(candidate);
+    if (stat === null) {
+        throw new OperationalError(`Directory "${candidate}" does not exist.`, "Create it or select an existing directory with --root.");
+    }
+    if (stat.kind !== "directory") {
+        throw new OperationalError(`"${candidate}" is not a directory.`, "init requires a project's root directory.");
+    }
+    try {
+        return await fs.realPath(candidate);
+    }
+    catch {
+        return candidate;
+    }
+}
+async function readOptionalText(fs, filePath) {
+    const stat = await fs.stat(filePath);
+    if (stat === null || stat.kind !== "file") {
+        return null;
+    }
+    return fs.readTextFile(filePath);
+}
+/**
+ * Temp file plus rename. `rename` is atomic within a directory on every
+ * platform Untangle supports, so a reader sees either the old file or the new
+ * one — never a truncated one.
+ */
+async function writeAtomically(fs, filePath, text, signal) {
+    const temporary = `${filePath}${TEMP_SUFFIX}`;
+    signal?.throwIfAborted();
+    const callOptions = signal === undefined ? undefined : { signal };
+    try {
+        await fs.writeFile(temporary, new TextEncoder().encode(text), callOptions);
+        signal?.throwIfAborted();
+        await fs.rename(temporary, filePath, callOptions);
+    }
+    catch (error) {
+        await fs.remove(temporary).catch(() => undefined);
+        signal?.throwIfAborted();
+        throw new OperationalError(`Writing "${filePath}" failed: ${error instanceof Error ? error.message : String(error)}`, `Check write permissions for "${path.dirname(filePath)}".`, { cause: error });
+    }
+}
+//# sourceMappingURL=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/init/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUjD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AA4BhD,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAsB,EACtB,OAAmB,EAAE;IAErB,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,cAAc,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/E,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,oBAAoB,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,MAAM,GAAiB,EAAE,GAAG,mBAAmB,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAExE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,EAAE;QACF,IAAI;QACJ,cAAc;QACd,GAAG;QACH,MAAM;QACN,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;KAC9D,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG;QACX,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,cAAc,EAAE,KAAK,CAAC,QAAQ;QAC9B,YAAY,EAAE,KAAK,CAAC,MAAM;KAC3B,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,yEAAyE;QACzE,6DAA6D;QAC7D,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,OAAO,GACX,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,QAAQ;QACxC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QACvD,MAAM,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAuB,EACvB,QAAgB,EAChB,OAAgD;IAEhD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAiBD,KAAK,UAAU,eAAe,CAAC,KAAmB;IAChD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9D,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,KAAwB,EAAQ,EAAE;QACrD,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,kEAAkE;IAClE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC;QAC1C,EAAE;QACF,cAAc;QACd,QAAQ,EAAE,IAAI;QACd,MAAM;QACN,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,GAAG,gBAAgB,GAAG,WAAW,EAAE,CAAC;QACzE,WAAW;QACX,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAChE,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACnF,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;QAChD,EAAE;QACF,IAAI;QACJ,KAAK;QACL,kBAAkB,EAAE,SAAS,CAAC,SAAS;QACvC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAChE,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,MAAM,uBAAuB,CAAC;QACrD,EAAE;QACF,IAAI;QACJ,KAAK;QACL,kBAAkB,EAAE,SAAS,CAAC,SAAS;QACvC,iBAAiB,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAClF,cAAc,EAAE;YACd,yBAAyB,EAAE,MAAM,CAAC,kBAAkB;YACpD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;QACD,cAAc;QACd,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/F,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAChE,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QACjB,IAAI;QACJ,MAAM;QACN,SAAS,EAAE,GAAG,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,yBAAyB,CAAC,IAAI,kBAAkB;QAC7F,UAAU,EAAE,eAAe,CAAC;YAC1B,GAAG,GAAG;YACN,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;SACtD,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC;KACxF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,MAAM,GACV,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC;QAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,YAAqB,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAE1E,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI;QACJ,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,SAAS;QACT,QAAQ;QACR,cAAc;QACd,gBAAgB;QAChB,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE;YACP,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,WAAW;YACpB,cAAc,EAAE,oBAAoB,CAAC,WAAW,CAAC;SAClD;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,GAAiD;IAC/E,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,EAAkB,EAAE,SAAiB;IAChE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,gBAAgB,CACxB,cAAc,SAAS,mBAAmB,EAC1C,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC9B,MAAM,IAAI,gBAAgB,CACxB,IAAI,SAAS,uBAAuB,EACpC,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,EAAkB,EAAE,QAAgB;IAClE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAC5B,EAAkB,EAClB,QAAgB,EAChB,IAAY,EACZ,MAAoB;IAEpB,MAAM,SAAS,GAAG,GAAG,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC9C,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3E,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CACxB,YAAY,QAAQ,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACzF,gCAAgC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAC1D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * 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 type { EmbeddingModelInfoV1, HttpProbePort, InitLimitsV1, OllamaFindingsV1, QdrantFindingsV1 } from "./types.js";
+/** Native Ollama probe target (spec.md §3.1). */
+export declare 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 declare const DEFAULT_QDRANT_URL = "http://127.0.0.1:16333";
+/**
+ * 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 declare function readEmbeddingModels(payload: unknown): EmbeddingModelInfoV1[];
+export interface ModelChoiceV1 {
+    model: EmbeddingModelInfoV1;
+    reason: string;
+}
+/**
+ * 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 declare function chooseEmbeddingModel(models: readonly EmbeddingModelInfoV1[], preferred?: string): ModelChoiceV1 | undefined;
+export interface ProbeInput {
+    http: HttpProbePort;
+    limits: InitLimitsV1;
+    /** `UNTANGLE_OLLAMA_URL` when set. */
+    ollamaUrl: string;
+    /** `UNTANGLE_QDRANT_URL` when set — probed BEFORE the managed default. */
+    qdrantUrls: readonly string[];
+    /** Model name from `--embedding-model`, when given. */
+    preferredModel?: string;
+}
+/**
+ * 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 declare function probeOllama(input: ProbeInput): Promise<OllamaFindingsV1>;
+export declare function probeQdrant(input: ProbeInput): Promise<QdrantFindingsV1>;
+//# sourceMappingURL=services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/commands/init/services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AAarD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAmC5E;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,oBAAoB,EAAE,EACvC,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,GAAG,SAAS,CA6B3B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmC9E;AAoBD,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwB9E"}