@flintpay/cli 0.6.0 → 0.9.0

package/README.md

@@ -10,7 +10,7 @@ Every command maps to a documented `/v1` route, so anything you can do over HTTP
 npm install -g @flintpay/cli
 ```
 
-On macOS and Linux, run `flint upgrade` (or its alias `flint update`) to update the global package and its platform binary to the latest stable release. On Windows, the command prints the exact npm update to run after closing the CLI.
+On macOS and Linux, run `flint upgrade` (or its alias `flint update`) to update the global package and its platform binary to the latest stable release. On Windows, the command prints the exact npm update to run after closing the CLI. `flint upgrade --check` only reports the current and latest stable versions and whether an update is available.
 
 This package resolves a prebuilt binary for your platform. Node `>=18` is required to run the installer. On macOS and Linux you can install with Homebrew instead:
 
@@ -87,9 +87,9 @@ This streams your sandbox's events to a local server with a real signature, so y
 
 ## Scripting
 
-For bounded commands, `--output json` prints one JSON envelope on stdout and disables terminal input prompts. `flint auth login` still requires approval on the website; use `FLINT_NO_INPUT=1` to prohibit browser login in automation. Streaming commands emit newline-delimited JSON instead. `flint listen --output json` writes one listener, webhook event, delivery result, or checkpoint object per line; use `--max-events` or `--for` to bound it. Diagnostics and progress go to stderr, so stdout stays a clean data stream.
+For bounded commands, `--output json` prints one JSON envelope on stdout and disables terminal input prompts. `flint auth login` still requires approval on the website; `FLINT_NO_INPUT=1` suppresses opening the browser automatically while allowing website approval and polling. Use `FLINT_API_KEY` for unattended automation. Streaming commands emit newline-delimited JSON instead. `flint listen --output json` writes one listener, webhook event, delivery result, or checkpoint object per line; use `--max-events` or `--for` to bound it. Diagnostics and progress go to stderr, so stdout stays a clean data stream.
 
-Exit codes are stable: `0` success, `1` API error, `2` usage error, `3` auth or config, `4` confirmation required, `5` network, `6` `--wait-for` timed out, `70` internal error.
+Exit codes are stable: `0` success, `1` API error, `2` usage error, `3` auth or config, `4` confirmation required, `5` network, `6` `--wait-for` timed out, `70` internal error, including a missing or unsupported platform binary.
 
 In CI, pass the key through `FLINT_API_KEY` instead of the keychain, and set `FLINT_OUTPUT=json` and `FLINT_NO_INPUT=1` to make every command non-interactive.
 
@@ -98,7 +98,8 @@ In CI, pass the key through `FLINT_API_KEY` instead of the keychain, and set `FL
 - Guide: https://developers.withflintpay.com/docs/guides/cli
 - API reference: https://developers.withflintpay.com/docs/api
 - `flint help` for starting points, `flint <command> --help` for any single command
-- `flint schema commands --output json` for the complete machine-readable catalog
+- `flint schema commands customers --output json` for one group's machine-readable commands; omit the group for the complete, large catalog
+- `flint schema input customers create --output json` for the JSON Schema of a command's `--input` body
 
 ## License
 

package/bin/flint.js

@@ -3,6 +3,11 @@
 const { spawn } = require("node:child_process");
 const path = require("node:path");
 
+// Exit codes 1-6 report Flint CLI outcomes such as usage, authentication, and
+// network errors. A broken installation is none of these, so the wrapper uses
+// the CLI's internal software error code instead.
+const EXIT_SOFTWARE = 70;
+
 const platform = process.platform;
 const arch = process.arch === "x64" ? "amd64" : process.arch;
 const supported = new Set([
@@ -15,8 +20,8 @@ const supported = new Set([
 const target = `${platform}-${arch}`;
 
 if (!supported.has(target)) {
-  process.stderr.write(`Flint CLI does not publish a binary for ${platform}/${process.arch}.\n`);
-  process.exit(2);
+  process.stderr.write(`Flint CLI does not publish a binary for ${platform}/${process.arch}. Supported platforms: macOS (arm64, x64), Linux (arm64, x64), and Windows (x64).\n`);
+  process.exit(EXIT_SOFTWARE);
 }
 
 const packagePlatform = platform === "win32" ? "windows" : platform;
@@ -26,11 +31,14 @@ try {
   packagePath = path.dirname(require.resolve(`${packageName}/package.json`));
 } catch {
   process.stderr.write(`The optional platform package ${packageName} is missing. Reinstall @flintpay/cli without omitting optional dependencies.\n`);
-  process.exit(3);
+  process.exit(EXIT_SOFTWARE);
 }
 
 const binary = path.join(packagePath, "bin", platform === "win32" ? "flint.exe" : "flint");
 const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+// Forward signals sent to this process alone, such as an MCP client stopping
+// its server. A terminal Ctrl-C reaches the CLI directly as well, because it
+// shares this process group; the CLI ignores such a duplicate for a moment.
 const signalHandlers = new Map();
 for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
   const handler = () => child.kill(signal);
@@ -44,8 +52,8 @@ function removeSignalHandlers() {
 }
 child.on("error", (error) => {
   removeSignalHandlers();
-  process.stderr.write(`${error.message}\n`);
-  process.exitCode = 5;
+  process.stderr.write(`Could not start the Flint CLI executable from ${packageName}: ${error.message}. Reinstall @flintpay/cli.\n`);
+  process.exitCode = EXIT_SOFTWARE;
 });
 child.on("exit", (code, signal) => {
   removeSignalHandlers();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flintpay/cli",
-  "version": "0.6.0",
+  "version": "0.9.0",
   "description": "Flint Pay command-line interface",
   "mcpName": "com.withflintpay/cli",
   "license": "Apache-2.0",
@@ -16,11 +16,11 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@flintpay/cli-darwin-arm64": "0.6.0",
-    "@flintpay/cli-darwin-amd64": "0.6.0",
-    "@flintpay/cli-linux-arm64": "0.6.0",
-    "@flintpay/cli-linux-amd64": "0.6.0",
-    "@flintpay/cli-windows-amd64": "0.6.0"
+    "@flintpay/cli-darwin-arm64": "0.9.0",
+    "@flintpay/cli-darwin-amd64": "0.9.0",
+    "@flintpay/cli-linux-arm64": "0.9.0",
+    "@flintpay/cli-linux-amd64": "0.9.0",
+    "@flintpay/cli-windows-amd64": "0.9.0"
   },
   "repository": {
     "type": "git",