ingestron 0.13.0 → 0.13.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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
+  Node 22.12.0, 22.23.2 and 24.12.0, including installed CLI and MCP workflows.
+- Pin core 0.12.1 so the transitive core package no longer warns on Node 24.
+
 ## 0.13.0 — simpler plugin installation
 
 - CLI and MCP resolve official `github` and `local` names through shared adapter logic.

package/README.md

@@ -10,7 +10,7 @@ the CLI does not install a platform provider or connect to a cloud account.
 
 ## Get started
 
-Use Node 22, Git and pnpm 10.15.0. Build the public source:
+Use Node 22.12 or newer, Git and pnpm 10.15.0. Build the public source:
 
 ```sh
 git clone https://github.com/ingestron/cli.git
@@ -29,13 +29,13 @@ To install this checkout's CLI in your terminal:
 
 ```sh
 pnpm pack --pack-destination build/release
-npm install --global ./build/release/ingestron-0.13.0.tgz
+npm install --global ./build/release/ingestron-0.13.1.tgz
 ingestron --version
 ```
 
 This source release prepares the npm package named `ingestron`; it does not claim
 that the same CLI version is already published on npm. Its core dependency is the
-public, exact version `@ingestron/core@0.12.0`.
+public, exact version `@ingestron/core@0.12.1`.
 
 Follow the [five-minute quickstart](docs/quickstart.md) for a project you can keep.
 

package/THIRD_PARTY_NOTICES.md

@@ -75,7 +75,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-### @ingestron/core@0.12.0
+### @ingestron/core@0.12.1
 
 Declared licence: Apache-2.0
 

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/workflow-commands.js

@@ -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.0",
+  "version": "0.13.2",
   "type": "module",
   "description": "Build repeatable data pipelines from reviewed contracts and versioned standards.",
   "license": "Apache-2.0",
@@ -20,11 +20,11 @@
     "THIRD_PARTY_NOTICES.md"
   ],
   "engines": {
-    "node": ">=22 <23"
+    "node": ">=22.12.0"
   },
   "dependencies": {
     "@clack/prompts": "1.7.0",
-    "@ingestron/core": "0.12.0",
+    "@ingestron/core": "0.12.1",
     "@modelcontextprotocol/sdk": "1.30.0",
     "commander": "15.0.0",
     "yaml": "2.9.0"