ingestron 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.14.0
+
+- Add the official `files` plugin alias to CLI and MCP, with exact qualified catalogue resolution and unchanged cache-only installation.
+- Keep core pinned to published 0.12.1; existing plugin identities and locks remain unchanged.
+
+## 0.13.2
+
+- Keep official plugin names short in ordinary install/list output; exact references remain in verbose and JSON output.
+- Link help to complete walkthroughs and explain the separate provider-configuration step.
+- Summarise configured resources and show Python preparation/reuse details from the local provider.
+
 ## 0.13.1 — Node.js runtime compatibility
 
 - Require Node 22.12 or newer instead of excluding newer major versions. CI tests

package/build/cli/cli/output.js

@@ -3,6 +3,7 @@
  * 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;
@@ -26,6 +27,21 @@ export function exitCode(result) {
     return 2;
 }
 const clean = (value) => String(value).replace(/[\u0000-\u001f\u007f-\u009f]/g, " ");
+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;
@@ -61,9 +77,9 @@ export function terminal(result, verbose = false, args = {}) {
                 value.evidence +
                 "\nInstall: ingestron plugin install <owner/repository>@<version>");
         case "packages_install":
-            return `${value.cached ? "Using cached" : "Installed"} plugin ${clean(friendlyReference(args.reference ?? value.reference ?? "package"))}.${value.informationFile ? `\nPlugin information and licence evidence: ${clean(value.informationFile)}` : ""}`;
+            return `${value.cached ? "Using cached" : "Installed"} 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(friendlyReference), "No plugins installed.\nNext: ingestron plugin install local");
+            return lines("Installed plugins", Object.keys(value.packages).map(pluginLabel), "No plugins installed.\nNext: ingestron plugin 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":
@@ -93,6 +109,11 @@ export function terminal(result, verbose = false, args = {}) {
         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(", ")}.\nUse ingestron run status ${clean(value.id)} to inspect the receipt.`;
@@ -120,7 +141,15 @@ export function terminal(result, verbose = false, args = {}) {
         case "config_explain":
             return `Configuration: ${clean(value.path)} (${clean(value.environment)})\nUse --verbose to inspect declared and resolved values.`;
         case "resolve":
-            return `Resolved project ${clean(value.project.id)} (${value.flows.length} flows).\n${value.pending.length} unresolved inputs. Use --verbose to inspect configuration.`;
+            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":

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

@@ -1,6 +1,11 @@
 /** 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 files: {
+        readonly repository: "ingestron/connectors";
+        readonly path: "connectors/files/connector.yaml";
+        readonly tagPrefix: "files-";
+    };
     readonly github: {
         readonly repository: "ingestron/connectors";
         readonly path: "connectors/github/connector.yaml";

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

@@ -3,6 +3,11 @@ import { executeAsync, operationSchemas, } from "@ingestron/core";
 import { check, packageLock, Problem } from "@ingestron/core/adapter";
 import { coreVersion } from "../version.js";
 export const officialPlugins = {
+    files: {
+        repository: "ingestron/connectors",
+        path: "connectors/files/connector.yaml",
+        tagPrefix: "files-",
+    },
     github: {
         repository: "ingestron/connectors",
         path: "connectors/github/connector.yaml",
@@ -24,7 +29,7 @@ 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 github, local, or an explicit owner/repository reference.`);
+    check(Object.hasOwn(officialPlugins, name), "PACKAGE", `Unknown official plugin '${name}'. Use files, github, local, or an explicit owner/repository reference.`);
     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 };

package/build/cli/cli/workflow-commands.js

@@ -182,7 +182,7 @@ export function workflowCommands(app, host) {
                 message: "Official plugin name or owner/repository",
                 validate: (value) => /^(github|local|[\w.-]+\/[\w.-]+)$/.test(value ?? "")
                     ? undefined
-                    : "Use github, local or owner/repository",
+                    : "Use files, github, local or owner/repository",
             }));
         }
         check(typeof reference === "string", "INPUT", "Choose a plugin reference");
@@ -372,5 +372,5 @@ export function workflowCommands(app, host) {
         visibleCommands: (command) => command.commands.filter((c) => (command !== app || !hidden.has(c.name())) &&
             (command !== contract || c.name() !== "validate")),
     });
-    app.addHelpText("after", "\nStart: init → plugin install → source import → contract draft → flow add → check → build\nUse --json for automation; --verbose for detailed terminal output.");
+    app.addHelpText("after", "\nStart with a complete walkthrough: https://docs.ingestron.io/docs/start/first-contract\nRun a public GitHub example: https://docs.ingestron.io/docs/tutorials/github-to-parquet\nPlugin installation caches packages; use plugin configure to add a provider to your project.\nUse --json for automation; --verbose for detailed terminal output.");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ingestron",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "type": "module",
   "description": "Build repeatable data pipelines from reviewed contracts and versioned standards.",
   "license": "Apache-2.0",