ingestron 0.17.7 → 1.0.0

package/build/cli/cli/operation-worker.d.ts

@@ -1 +0,0 @@
-export {};

package/build/cli/cli/operation-worker.js

@@ -1,5 +0,0 @@
-/** Keep package-network work off the presentation thread so progress reflects
- * actual pending work. This worker uses the same JSON operations as MCP/Web. */
-import { parentPort, workerData } from "node:worker_threads";
-import { executePluginOperation } from "./plugin-resolution.js";
-parentPort.postMessage(await executePluginOperation(workerData.context, workerData.operation, workerData.args));

package/build/cli/cli/output.d.ts

@@ -1,3 +0,0 @@
-import type { Result } from "@ingestron/core";
-export declare function exitCode(result: Result): number;
-export declare function terminal(result: Result, verbose?: boolean, args?: any): string;

package/build/cli/cli/output.js

@@ -1,226 +0,0 @@
-/** Presentation is deliberately separate from operation results. JSON is the
- * lossless API; terminal output is bounded, plain text and actionable. Never
- * serialise arbitrary plugin data or resolved bindings in the default summary. */
-import { friendlyReference } from "@ingestron/core/adapter";
-import { stringify } from "yaml";
-import { officialPlugins } from "./plugin-resolution.js";
-export function exitCode(result) {
-    if (result.ok)
-        return 0;
-    const codes = result.diagnostics.map((d) => d.code);
-    if (codes.includes("CANCELLED"))
-        return 130;
-    if (codes.includes("NOT_IMPLEMENTED"))
-        return 4;
-    if (codes.some((c) => ["STALE", "OWNER", "CONFLICT"].includes(c)))
-        return 5;
-    if (codes.some((c) => [
-        "INPUT",
-        "BINDING",
-        "CAPABILITY",
-        "PACKAGE",
-        "OPTION",
-        "COMMAND",
-        "SCHEMA",
-    ].includes(c)))
-        return 3;
-    return 2;
-}
-const clean = (value) => String(value).replace(/[\u0000-\u001f\u007f-\u009f]/g, " ");
-// Data product ownership from ODCS contracts; absent with older core versions.
-function dataProductLines(products, quality) {
-    if (!Array.isArray(products) || !products.length)
-        return "";
-    const summary = quality?.summary;
-    const shown = products.slice(0, 20).map((p) => {
-        const owners = Array.isArray(p.owners) ? p.owners.map(clean) : [];
-        return `\n  ${clean(p.contract)}  ${clean(p.status ?? "no status")}  ${owners.length ? `owner ${owners.join(", ")}` : "no owner"}`;
-    });
-    const recorded = products.reduce((n, p) => n + Math.max(0, (p.qualityRules ?? 0) - (p.enforcedQualityRules ?? 0)), 0);
-    return ("\nData products:" +
-        shown.join("") +
-        (products.length > 20 ? `\n  … ${products.length - 20} more` : "") +
-        (summary && summary.rules
-            ? `\nQuality rules: ${summary.rules} (${summary.atLoad} at load, ${summary.afterLoad} after load, ${summary.unsupported} not enforced by the target${summary.documentation ? `, ${summary.documentation} documentation only` : ""}).`
-            : !summary && recorded
-                ? `\n${recorded} quality rule(s) are recorded in contracts but not yet enforced.`
-                : ""));
-}
-// Quality results recorded by connector runtimes before commit; counts only.
-function runQualityLine(flows) {
-    if (!Array.isArray(flows))
-        return "";
-    const rules = flows.flatMap((f) => Array.isArray(f?.quality) ? f.quality : []);
-    if (!rules.length)
-        return "";
-    const warned = rules.filter((r) => r.passed === false);
-    return `\nQuality rules: ${rules.length} checked before commit${warned.length
-        ? `; ${warned.length} warning(s): ${warned
-            .slice(0, 5)
-            .map((r) => clean(r.id))
-            .join(", ")}${warned.length > 5 ? ", …" : ""}`
-        : ", all passed"}.`;
-}
-// Source routes from core (PB-064); absent with older core versions.
-const costLabel = {
-    none: "no extra cost",
-    included: "included in platform pricing",
-    "separately-billed": "billed separately",
-};
-function routeLabel(route) {
-    const r = route?.reference;
-    const via = route?.route === "native"
-        ? `native on ${clean(route.configuration)} via ${(route.standards ?? []).map(clean).join(", ")}`
-        : `portable ${clean(route?.package ?? "connector")} on ${clean(route?.configuration)}`;
-    if (!r)
-        return `${via} [no reference record]`;
-    const stale = Date.now() - new Date(`${r.verified}T00:00:00Z`).getTime() >
-        180 * 86_400_000;
-    return `${via} [${clean(r.maturity)}, ${costLabel[r.cost?.model] ?? clean(r.cost?.model)}${stale ? `, record checked ${clean(r.verified)}` : ""}]`;
-}
-function sourceLines(sources) {
-    if (!Array.isArray(sources) || !sources.length)
-        return "";
-    return ("\nSources:" +
-        sources
-            .slice(0, 20)
-            .map((s) => `\n  ${clean(s.flow)}: ${clean(s.connection)} (${clean(s.kind)}) ${routeLabel(s.selected)}` +
-            (s.alternative
-                ? `\n    Also available: ${routeLabel(s.alternative)}`
-                : ""))
-            .join("") +
-        (sources.length > 20 ? `\n  … ${sources.length - 20} more` : "") +
-        "\nUse --json for every route with documentation, licence, cost and access.");
-}
-function pluginLabel(reference) {
-    for (const [name, entry] of Object.entries(officialPlugins)) {
-        const prefixes = [
-            `${entry.repository}/${entry.path}@`,
-            ...(name === "local" ? [`${entry.repository}@`] : []),
-        ];
-        for (const prefix of prefixes)
-            if (reference.startsWith(prefix)) {
-                const version = reference.slice(prefix.length);
-                if (/^\d+\.\d+\.\d+$/.test(version))
-                    return `${name}@${version}`;
-            }
-    }
-    return friendlyReference(reference);
-}
-function lines(title, items, empty) {
-    if (!items.length)
-        return empty;
-    return `${title} (${items.length})\n${items
-        .slice(0, 20)
-        .map((i) => `  ${clean(i)}`)
-        .join("\n")}${items.length > 20 ? "\n  More results available with --json or --verbose." : ""}`;
-}
-export function terminal(result, verbose = false, args = {}) {
-    if (!result.ok)
-        return result.diagnostics
-            .map((d) => `Error: ${clean(d.message)}${verbose ? ` [${d.code}]` : ""}${d.file ? `\n  File: ${clean(d.file)}${clean(d.pointer ?? "")}` : ""}${d.hint ? `\n  Next: ${clean(d.hint)}` : ""}`)
-            .join("\n");
-    const value = result.result;
-    if (verbose)
-        return `${result.operation.replaceAll("_", " ")}\n${typeof value === "string" ? value : stringify(value).trimEnd()}`;
-    if (value?.apiVersion === "ingestron.change/v1")
-        return (lines("Proposed file changes", value.changes.map((c) => `${c.before === null ? "Create" : "Update"} ${c.path}`), "No file changes needed.") + "\nPreview only; no files changed.");
-    if (value?.applied)
-        return lines("Saved files", value.files, "No file changes needed.");
-    switch (result.operation) {
-        case "plugin_browse":
-            return ((value.length
-                ? "Installed plugins\n\n" +
-                    value
-                        .map((p) => `  ${clean(p.id).padEnd(13)} ${clean(p.name)} [${clean(p.kindLabel)} · ${clean(p.availability)}]\n    ${clean(p.description)}\n    ${clean(p.url)}`)
-                        .join("\n\n")
-                : "No installed plugins match this search.") +
-                "\n\nInstall a provider: ingestron provider install local\nInstall a connector: ingestron connector install github");
-        case "plugin_versions":
-            return (lines(`Versions for ${value.provider}`, value.versions.map((v) => `${v.reference}${v.ambiguous ? "  (conflicting tags; select a commit)" : ""}`), "No stable version tags found.") +
-                "\n\n" +
-                value.evidence +
-                "\nInstall: ingestron plugin install <owner/repository>@<version>");
-        case "packages_install":
-            return `${value.cached ? "Using cached" : "Installed"} ${args.kind ?? "plugin"} ${clean(pluginLabel(args.reference ?? value.reference ?? "package"))}.\nUse --verbose for the exact reference and licence information.`;
-        case "packages_list":
-            return lines("Installed plugins", Object.keys(value.packages).map(pluginLabel), "No plugins installed.\nNext: ingestron provider install local");
-        case "source_list":
-            return lines("Sources", value.map((s) => `${s.id}  ${s.type}${s.format ? "/" + s.format : ""}  ${s.execution}`), "No sources configured.\nNext: ingestron source add <name> --type <type>");
-        case "source_show":
-            return `Source ${clean(value.id)}\n  Type: ${clean(value.type)}${value.format ? ` (${clean(value.format)})` : ""}\n  Execution: ${clean(value.selected.execution)}\n  Environment: ${clean(value.selected.environment)}\n  Provider: ${clean(value.selected.provider ?? "project default")}\nUse --verbose to inspect connection references.`;
-        case "contract_list":
-            return lines("Contracts", value.map((c) => `${c.id}  ${c.status}  ${c.path}`), "No contracts drafted.\nNext: ingestron contract draft <name> --metadata <file>");
-        case "contract_show":
-            return (`Contract ${clean(value.id)} (${clean(value.status)})\n` +
-                lines("Entities", (value.schema ?? []).map((s) => `${s.physicalName ?? s.name}: ${(s.properties ?? []).length} fields`), "No entities.") +
-                "\nUse --verbose to review the complete contract.");
-        case "contract_check":
-            return `Contract valid: ${clean(value.path)}${value.status === "draft" ? "\nStatus: draft; review business requirements before use." : ""}\n${clean(value.evidence)}`;
-        case "contract_validate":
-            return `Contract valid for native table authoring (${value.columns.length} columns).`;
-        case "inspect":
-            return lines("Flows", value.flows.map((f) => `${f.id}  ${f.kind}  ${f.tables.length} tables, ${f.outputs.length} outputs`), "No flows configured.\nNext: ingestron flow add <name> --contract <name> --standard <standard>");
-        case "flow_show":
-            return `Flow ${clean(value.id)}\n  Kind: ${clean(value.kind)}\n  Tables: ${Object.keys(value.tables ?? {})
-                .map(clean)
-                .join(", ") || "none"}\n  Outputs: ${Object.keys(value.publishes ?? {})
-                .map(clean)
-                .join(", ") || "none"}\nUse --verbose to inspect configuration.`;
-        case "validate":
-            return value.mode === "draft"
-                ? `Draft configuration checked (${value.flows} flows).\n${value.pending.length} unresolved inputs. Strict build readiness has not been checked.`
-                : `Project checks passed${value.nodes === undefined ? "" : ` (${value.nodes} planned nodes)`}.\nValidation is local; no platform connection was tested.` +
-                    dataProductLines(value.dataProducts, value.quality) +
-                    sourceLines(value.sources);
-        case "doctor":
-            return `Project ${clean(value.project)} (${clean(value.environment)})\n${value.pending.length} unresolved inputs.\n${clean(value.platformAccess)}\nNext: ${clean(value.next)}`;
-        case "runtime_prepare":
-            return (`Runtime ${clean(value.status)} for ${value.flows.map(clean).join(", ")}.` +
-                (value.result?.flows ?? [])
-                    .map((f) => `\n  ${clean(f.flow)}: Python ${clean(f.pythonVersion ?? "3.12")} (${f.reused ? "reused" : "prepared"})`)
-                    .join("") +
-                `\nUse ingestron run status ${clean(value.id)} --verbose for environment paths and details.`);
-        case "run":
-        case "run_status":
-            return `Run ${clean(value.id)}: ${clean(value.status)} (${clean(value.action)}).\nTarget: ${clean(value.configuration)}; flows: ${value.flows.map(clean).join(", ")}.${runQualityLine(value.result?.flows)}\nUse ingestron run status ${clean(value.id)} to inspect the receipt.`;
-        case "build":
-            return `Built ${value.packages?.length ?? 1} project package(s) into ${clean(value.directory)}.\n${clean(value.evidence)}`;
-        case "generate":
-            return "Generated native assets.\nUse check --output <directory> to verify local output.";
-        case "validate_output":
-            return "Generated output checks passed.\nOwnership and syntax checked locally; no platform connection was tested.";
-        case "environments":
-            return lines("Environments", value.available.map((e) => `${e}${e === value.selected ? " (selected)" : ""}`), "No environments configured.");
-        case "tables":
-            return lines("Flow tables", value.map((f) => `${f.flow}: ${f.tables.join(", ") || "none"}`), "No tables configured.");
-        case "catalogue":
-            return lines(args.kind ?? "Capabilities", value.map((v) => `${v.id}${v.version ? "@" + v.version : ""}${v.description ? "  " + v.description : ""}`), `No ${args.kind ?? "capabilities"} available.\nNext: ingestron plugin list`);
-        case "provider_commands":
-            return lines("Plugin operations", value.commands.map((c) => `${c.name}  ${c.description}`), "No plugin operations available.");
-        case "plugin_command":
-        case "provider_command":
-            return "Plugin operation completed locally.\nUse --json, --verbose or --out to inspect its result.";
-        case "plan":
-            return `Local build plan ready (${value.nodes.length} nodes).\nUse --json or --verbose to inspect the plan.`;
-        case "diff":
-            return `Local differences: ${value.added.length} added, ${value.changed.length} changed, ${value.removed.length} removed.`;
-        case "config_explain":
-            return `Configuration: ${clean(value.path)} (${clean(value.environment)})\nUse --verbose to inspect declared and resolved values.`;
-        case "resolve":
-            return (`Project ${clean(value.project.id)} — resolved build configuration\n` +
-                `Providers: ${Object.keys(value.project.providers?.configurations ?? {})
-                    .map(clean)
-                    .join(", ") || "none"}\n` +
-                `Connections: ${Object.keys(value.project.connections ?? {})
-                    .map(clean)
-                    .join(", ") || "none"}\n` +
-                `Flows: ${value.flows.length}; unresolved inputs: ${value.pending.length}.\n` +
-                "Authored files: ingestron source list; ingestron contract list.\nUse --verbose for resolved configuration and input-file digests.");
-        case "read":
-            return value.content;
-        case "schema":
-            return "Schema available. Use --json for tools or --verbose to inspect it.";
-    }
-    return `${result.operation.replaceAll("_", " ")} completed.\nUse --json for structured data or --verbose for details.`;
-}

package/build/cli/cli/plugin-browser.d.ts

@@ -1,14 +0,0 @@
-interface Browser {
-    select(message: string, options: {
-        value: string;
-        label: string;
-        hint?: string;
-    }[]): Promise<string>;
-    search(): Promise<string>;
-    details(text: string): void;
-}
-/** Read-only navigation of installed plugin metadata. */
-export declare function browsePlugins(ui: Browser, query?: string, initialKind?: string, filters?: {
-    engine?: string;
-}, root?: string): Promise<void>;
-export {};

package/build/cli/cli/plugin-browser.js

@@ -1,74 +0,0 @@
-import { browseProviders, pluginKindLabel } from "@ingestron/core/adapter";
-/** Read-only navigation of installed plugin metadata. */
-export async function browsePlugins(ui, query = "", initialKind, filters = {}, root = process.cwd()) {
-    browseProviders(root, query, initialKind, filters); // Validate filters even when catalogue is empty.
-    let kind = initialKind;
-    let listing = !!query || !!kind;
-    let page = 0;
-    for (;;) {
-        if (!listing) {
-            const choice = await ui.select("Browse plugins", [
-                { value: "all", label: "Browse all plugins" },
-                { value: "search", label: "Search plugins" },
-                ...["provider", "model-pack", "activity-pack", "report-pack"].map((value) => ({ value, label: pluginKindLabel(value) })),
-                {
-                    value: "connector",
-                    label: "Connectors",
-                    hint: "Installed connector packages",
-                },
-                { value: "exit", label: "Finish browsing" },
-            ]);
-            if (choice === "exit")
-                return;
-            kind = ["all", "search"].includes(choice) ? undefined : choice;
-            query = choice === "search" ? await ui.search() : "";
-            listing = true;
-            page = 0;
-        }
-        const plugins = browseProviders(root, query, kind, filters);
-        const visible = plugins.slice(page * 25, (page + 1) * 25);
-        const selected = await ui.select(plugins.length
-            ? `Select a plugin (${plugins.length} results, page ${page + 1})`
-            : "No plugins match; change category or search", [
-            ...visible.map((p) => ({
-                value: p.reference,
-                label: `${p.name} [${p.kindLabel}]`,
-                hint: `${p.availability} · ${p.description}`,
-            })),
-            ...(page > 0 ? [{ value: ":previous", label: "Previous page" }] : []),
-            ...((page + 1) * 25 < plugins.length
-                ? [{ value: ":next", label: "Next page" }]
-                : []),
-            { value: ":search", label: "Search this category" },
-            { value: ":back", label: "Change category / browse all" },
-            { value: ":exit", label: "Finish browsing" },
-        ]);
-        if (selected === ":next") {
-            page++;
-            continue;
-        }
-        if (selected === ":previous") {
-            page--;
-            continue;
-        }
-        if (selected === ":exit")
-            return;
-        if (selected === ":back") {
-            listing = false;
-            continue;
-        }
-        if (selected === ":search") {
-            query = await ui.search();
-            page = 0;
-            continue;
-        }
-        const plugin = plugins.find((p) => p.reference === selected);
-        ui.details(`${plugin.name} (${plugin.id})\n${plugin.kindLabel} · ${plugin.availability}\n\n${plugin.description}\n${plugin.evidence}\n\nLicence: ${plugin.licence}\nDocumentation: ${plugin.documentation}\nSource and package documentation: ${plugin.url}\n\nExact-version licences/notices and provenance are saved to .ingestron/plugin-info/ during installation. Engine compatibility is package-specific; installed metadata is not runtime verification.`);
-        const action = await ui.select("Next step", [
-            { value: "back", label: "Back to results" },
-            { value: "exit", label: "Finish browsing" },
-        ]);
-        if (action === "exit")
-            return;
-    }
-}

package/build/cli/cli/plugin-resolution.d.ts

@@ -1,72 +0,0 @@
-/** Official-name convenience at the adapter boundary; core only receives exact references. */
-import { type Context, type OperationName, type Result } from "@ingestron/core";
-export declare const officialPlugins: {
-    readonly adf: {
-        readonly kind: "provider";
-        readonly repository: "ingestron/provider-adf";
-        readonly path: "plugin/provider.yaml";
-        readonly tagPrefix: "";
-    };
-    readonly "azure-blob": {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/azure-blob/connector.yaml";
-        readonly tagPrefix: "azure-blob-";
-    };
-    readonly databricks: {
-        readonly kind: "provider";
-        readonly repository: "ingestron/provider-databricks";
-        readonly path: "plugin/provider.yaml";
-        readonly tagPrefix: "";
-    };
-    readonly files: {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/files/connector.yaml";
-        readonly tagPrefix: "files-";
-    };
-    readonly github: {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/github/connector.yaml";
-        readonly tagPrefix: "github-";
-    };
-    readonly local: {
-        readonly kind: "provider";
-        readonly repository: "ingestron/provider-local";
-        readonly path: "plugin/provider.yaml";
-        readonly tagPrefix: "";
-    };
-    readonly mysql: {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/mysql/connector.yaml";
-        readonly tagPrefix: "mysql-";
-    };
-    readonly oracle: {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/oracle/connector.yaml";
-        readonly tagPrefix: "oracle-";
-    };
-    readonly postgresql: {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/postgresql/connector.yaml";
-        readonly tagPrefix: "postgresql-";
-    };
-    readonly "sql-server": {
-        readonly kind: "connector";
-        readonly repository: "ingestron/connectors";
-        readonly path: "connectors/sql-server/connector.yaml";
-        readonly tagPrefix: "sql-server-";
-    };
-};
-export declare function officialName(reference: string): {
-    name: keyof typeof officialPlugins;
-    version: string;
-} | undefined;
-export declare function catalogueReleases(value: any, name: keyof typeof officialPlugins, host?: string): string[];
-export declare function fetchCatalogue(): Promise<unknown>;
-export declare function resolvePluginArgs(context: Context, operation: OperationName, args: any, catalogue?: typeof fetchCatalogue): Promise<any>;
-export declare function executePluginOperation(context: Context, operation: OperationName, args?: any): Promise<Result>;

package/build/cli/cli/plugin-resolution.js

@@ -1,216 +0,0 @@
-/** Official-name convenience at the adapter boundary; core only receives exact references. */
-import { executeAsync, operationSchemas, } from "@ingestron/core";
-import { check, packageLock, Problem } from "@ingestron/core/adapter";
-import { coreVersion } from "../version.js";
-export const officialPlugins = {
-    adf: {
-        kind: "provider",
-        repository: "ingestron/provider-adf",
-        path: "plugin/provider.yaml",
-        tagPrefix: "",
-    },
-    "azure-blob": {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/azure-blob/connector.yaml",
-        tagPrefix: "azure-blob-",
-    },
-    databricks: {
-        kind: "provider",
-        repository: "ingestron/provider-databricks",
-        path: "plugin/provider.yaml",
-        tagPrefix: "",
-    },
-    files: {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/files/connector.yaml",
-        tagPrefix: "files-",
-    },
-    github: {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/github/connector.yaml",
-        tagPrefix: "github-",
-    },
-    local: {
-        kind: "provider",
-        repository: "ingestron/provider-local",
-        path: "plugin/provider.yaml",
-        tagPrefix: "",
-    },
-    mysql: {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/mysql/connector.yaml",
-        tagPrefix: "mysql-",
-    },
-    oracle: {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/oracle/connector.yaml",
-        tagPrefix: "oracle-",
-    },
-    postgresql: {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/postgresql/connector.yaml",
-        tagPrefix: "postgresql-",
-    },
-    "sql-server": {
-        kind: "connector",
-        repository: "ingestron/connectors",
-        path: "connectors/sql-server/connector.yaml",
-        tagPrefix: "sql-server-",
-    },
-};
-const catalogueUrl = "https://raw.githubusercontent.com/ingestron/connectors/main/catalogue.json";
-const stable = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
-const compare = (a, b) => {
-    const x = a.split(".").map(Number), y = b.split(".").map(Number);
-    return y[0] - x[0] || y[1] - x[1] || y[2] - x[2];
-};
-export function officialName(reference) {
-    if (reference.includes("/"))
-        return undefined;
-    const [name, version, extra] = reference.split("@");
-    check(Object.hasOwn(officialPlugins, name), "PACKAGE", `Unknown official plugin '${name}'. Use ${Object.keys(officialPlugins).join(", ")}, or an explicit owner/repository reference. Check ingestron --version and update the CLI if a documented name is missing.`);
-    check(extra === undefined &&
-        (version === undefined || version === "latest" || stable.test(version)), "PACKAGE", "Use a stable version, @latest, or omit the version for an official plugin");
-    return { name: name, version };
-}
-export function catalogueReleases(value, name, host = coreVersion) {
-    const identity = officialPlugins[name];
-    check(value?.apiVersion === "ingestron.catalogue/v1", "CATALOGUE", "Unsupported official catalogue format");
-    const entry = value.plugins?.[name];
-    check(entry &&
-        entry.repository === identity.repository &&
-        entry.path === identity.path &&
-        entry.tagPrefix === identity.tagPrefix &&
-        Array.isArray(entry.releases) &&
-        entry.releases.length <= 1000, "CATALOGUE", `Invalid official catalogue identity for ${name}`);
-    const seen = new Set();
-    for (const release of entry.releases) {
-        check(stable.test(release.version) &&
-            !seen.has(release.version) &&
-            Array.isArray(release.coreVersions) &&
-            release.coreVersions.length > 0 &&
-            release.coreVersions.every((v) => typeof v === "string" && stable.test(v)), "CATALOGUE", `Invalid qualified release for ${name}`);
-        seen.add(release.version);
-    }
-    return entry.releases
-        .filter((r) => r.coreVersions.includes(host))
-        .map((r) => r.version)
-        .sort(compare);
-}
-export async function fetchCatalogue() {
-    try {
-        const response = await fetch(catalogueUrl, {
-            signal: AbortSignal.timeout(10000),
-            redirect: "error",
-        });
-        check(response.ok && response.body, "CATALOGUE", "Official catalogue is unavailable; retry or install an explicit version");
-        const reader = response.body.getReader();
-        const chunks = [];
-        let size = 0;
-        try {
-            for (;;) {
-                const { value, done } = await reader.read();
-                if (done)
-                    break;
-                size += value.length;
-                check(size <= 262144, "CATALOGUE", "Official catalogue exceeds the size limit");
-                chunks.push(value);
-            }
-        }
-        finally {
-            await reader.cancel();
-        }
-        return JSON.parse(Buffer.concat(chunks).toString("utf8"));
-    }
-    catch (error) {
-        if (error instanceof Problem)
-            throw error;
-        throw new Problem("CATALOGUE", "Cannot read the official catalogue; retry or install an explicit version");
-    }
-}
-export async function resolvePluginArgs(context, operation, args, catalogue = fetchCatalogue) {
-    if (operation !== "packages_install" && operation !== "plugin_versions")
-        return args;
-    const field = operation === "packages_install" ? "reference" : "provider";
-    const alias = officialName(args[field]);
-    if (!alias)
-        return args;
-    const identity = officialPlugins[alias.name];
-    if (operation === "packages_install" && args.kind)
-        check(args.kind === identity.kind, "PACKAGE", `${alias.name} is a ${identity.kind}; use ingestron ${identity.kind} install ${alias.name}`);
-    check(args.tagPrefix === undefined || args.tagPrefix === identity.tagPrefix, "OPTION", "Official plugin tag prefixes cannot be overridden; use an explicit reference for custom tags");
-    if (operation === "plugin_versions")
-        return {
-            ...args,
-            provider: identity.repository,
-            tagPrefix: identity.tagPrefix,
-        };
-    // Check permissions before catalogue network access, just as core does before install.
-    check(context.allowWrite, "PERMISSION", "Package installation requires write access");
-    check(!(args.update && args.frozen), "PACKAGE", "Frozen installation cannot update packages");
-    const base = `${identity.repository}/${identity.path}@`;
-    let version = alias.version;
-    if (version === undefined || version === "latest") {
-        const installed = Object.keys(packageLock(context.root).packages)
-            .filter((r) => r.startsWith(base) && stable.test(r.slice(base.length)))
-            .map((r) => r.slice(base.length))
-            .sort(compare);
-        if (!args.update && installed.length)
-            version = installed[0];
-        else {
-            check(!args.frozen, "PACKAGE", "Frozen installation requires an existing exact lock; install an exact version first");
-            check(context.allowNetwork, "PERMISSION", "Latest plugin resolution requires explicit package-network access");
-            check(!args.fromGit, "OPTION", "Use an exact version with --from-git; latest selects official qualified releases");
-            const versions = catalogueReleases(await catalogue(), alias.name);
-            check(versions.length, "COMPATIBILITY", `No qualified ${alias.name} release supports core ${coreVersion}; update the CLI or select an explicitly compatible version`);
-            version = [...versions, ...installed].sort(compare)[0];
-        }
-    }
-    // Even 'update' must never retarget an existing immutable version lock.
-    return {
-        ...args,
-        reference: `${base}${version}`,
-        tagPrefix: identity.tagPrefix,
-        update: false,
-    };
-}
-export async function executePluginOperation(context, operation, args = {}) {
-    try {
-        if (operation === "packages_install" || operation === "plugin_versions") {
-            const parsed = operationSchemas[operation].safeParse(args);
-            check(parsed.success, "SCHEMA", "Invalid plugin operation arguments");
-            if (operation === "packages_install")
-                check(context.allowWrite, "PERMISSION", "Package installation requires write access");
-            check(context.allowNetwork || parsed.data?.fromGit, "PERMISSION", "Package access requires explicit package-network access");
-            args = await resolvePluginArgs(context, operation, parsed.data);
-        }
-        const result = await executeAsync(context, operation, args);
-        // Keep custom manifest paths in every returned installable reference.
-        if (operation === "plugin_versions" && result.ok) {
-            const identity = Object.values(officialPlugins).find((p) => p.repository === args.provider && p.tagPrefix === args.tagPrefix);
-            if (identity)
-                result.result.versions = result.result.versions.map((v) => ({
-                    ...v,
-                    reference: `${identity.repository}/${identity.path}@${v.version}`,
-                }));
-        }
-        return result;
-    }
-    catch (error) {
-        const e = error instanceof Problem
-            ? error
-            : new Problem("PACKAGE", "Plugin resolution failed; check the reference and catalogue");
-        return {
-            apiVersion: "ingestron.operation/v1",
-            operation,
-            ok: false,
-            diagnostics: [{ code: e.code, message: e.message }],
-        };
-    }
-}

package/build/cli/cli/presentation.d.ts

@@ -1,12 +0,0 @@
-import type { Context, OperationName, Result } from "@ingestron/core";
-export interface Presentation {
-    tty: boolean;
-    plain?: boolean;
-    colour?: boolean;
-    progress?: boolean;
-    json?: boolean;
-}
-export declare function richTerminal(options: Presentation, env?: NodeJS.ProcessEnv): boolean;
-export declare function decorate(text: string, ok: boolean, options: Presentation): string;
-export declare function banner(text: string, options: Presentation): string;
-export declare function backgroundOperation(context: Context, operation: OperationName, args: unknown, label: string, options: Presentation): Promise<Result>;