@vultisig/cli 2.18.6 → 2.18.7

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vultisig/cli
 
+## 2.18.7
+
+### Patch Changes
+
+- [#1033](https://github.com/vultisig/vultisig-sdk/pull/1033) [`f682eda`](https://github.com/vultisig/vultisig-sdk/commit/f682eda5607a8263e90b18d9ff7167eb2e0a7004) Thanks [@neavra](https://github.com/neavra)! - docs(cli): regenerate the README "Exit Codes" table from the `ExitCode` enum (the single source of truth in `src/core/errors.ts`). The shipped table was stale and mislabelled every non-zero code — e.g. it called `2` "invalid usage" and `3` "configuration error" when the CLI actually returns `2` for authentication-required and `3` for a retryable network error, so a script written to the README's codes misclassified every failure. Codes `8`–`11` (ACK_FAILED, DUPLICATE_BROADCAST, and the two `agent ask` turn-outcome codes) were also undocumented. Also corrects the "disable colored output" env var to `NO_COLOR` (the cross-tool standard the CLI honours; `VULTISIG_NO_COLOR` still works). Adds a doc-lint test that fails if the README table drifts from the enum. Docs-only, but the README ships in the npm package, so this is a patch.
+
 ## 2.18.6
 
 ### Patch Changes

package/README.md

@@ -693,13 +693,23 @@ explorer:https://etherscan.io/tx/0x9f8e7d6c...
       "success": true,
       "data": {
         "balances": [
-          { "chain": "Ethereum", "symbol": "ETH", "amount": "1.5", "decimals": 18, "raw_amount": "1500000000000000000" }
+          {
+            "chain": "Ethereum",
+            "symbol": "ETH",
+            "amount": "1.5",
+            "decimals": 18,
+            "raw_amount": "1500000000000000000"
+          }
         ]
       }
     }
   ],
   "transactions": [
-    { "hash": "0x9f8e7d6c...", "chain": "ethereum", "explorerUrl": "https://etherscan.io/tx/0x9f8e7d6c..." }
+    {
+      "hash": "0x9f8e7d6c...",
+      "chain": "ethereum",
+      "explorerUrl": "https://etherscan.io/tx/0x9f8e7d6c..."
+    }
   ]
 }
 ```
@@ -707,7 +717,10 @@ explorer:https://etherscan.io/tx/0x9f8e7d6c...
 On failure, stdout is a single JSON object with both a human `error` string and a stable `code` (the `error` field is unchanged for older parsers):
 
 ```json
-{ "error": "Agent backend unreachable at https://example.invalid", "code": "BACKEND_UNREACHABLE" }
+{
+  "error": "Agent backend unreachable at https://example.invalid",
+  "code": "BACKEND_UNREACHABLE"
+}
 ```
 
 Each entry in `tool_calls` may include `code` when `success` is false (same values as below).
@@ -983,8 +996,18 @@ vultisig balance -o json
 ```json
 {
   "balances": [
-    { "chain": "ethereum", "native": "1.5", "symbol": "ETH", "usdValue": "3750.00" },
-    { "chain": "bitcoin", "native": "0.1", "symbol": "BTC", "usdValue": "6500.00" }
+    {
+      "chain": "ethereum",
+      "native": "1.5",
+      "symbol": "ETH",
+      "usdValue": "3750.00"
+    },
+    {
+      "chain": "bitcoin",
+      "native": "0.1",
+      "symbol": "BTC",
+      "usdValue": "6500.00"
+    }
   ]
 }
 ```
@@ -1061,8 +1084,8 @@ VULTISIG_CONFIG_DIR=/custom/path
 # Override FastVault and relay via a shared base URL
 VULTISIG_SERVER_URL=http://127.0.0.1:8080
 
-# Disable colored output
-VULTISIG_NO_COLOR=1
+# Disable colored output (NO_COLOR is the cross-tool standard; VULTISIG_NO_COLOR also works)
+NO_COLOR=1
 
 # Enable silent mode (suppress spinners and info messages)
 VULTISIG_SILENT=1
@@ -1111,16 +1134,24 @@ Configuration is stored in `~/.vultisig/`:
 
 ## Exit Codes
 
-| Code | Meaning              |
-| ---- | -------------------- |
-| 0    | Success              |
-| 1    | General error        |
-| 2    | Invalid usage        |
-| 3    | Configuration error  |
-| 4    | Authentication error |
-| 5    | Network error        |
-| 6    | Vault error          |
-| 7    | Transaction error    |
+| Code | Meaning                                                                            |
+| ---- | ---------------------------------------------------------------------------------- |
+| 0    | Success                                                                            |
+| 1    | Usage error (bad arguments, unknown command)                                       |
+| 2    | Authentication required                                                            |
+| 3    | Network error (retryable)                                                          |
+| 4    | Invalid input (bad chain, address, amount)                                         |
+| 5    | Resource not found (token, route)                                                  |
+| 6    | External service error (retryable)                                                 |
+| 7    | Unknown/unexpected error                                                           |
+| 8    | Broadcast succeeded but post-broadcast report failed — hash is valid, do NOT retry |
+| 9    | Duplicate broadcast refused (nothing sent) — retry with --force to override        |
+| 10   | agent ask: a fund-safety guardrail blocked the requested action                    |
+| 11   | agent ask: the model refused or asked a clarifying question (no action taken)      |
+
+> These are generated from the `ExitCode` enum in `src/core/errors.ts` (the single source of
+> truth) and are covered by a doc-lint test that fails if this table drifts from the code. Run
+> `vultisig --help` for the same list.
 
 ## Troubleshooting
 

package/dist/index.js

@@ -14450,7 +14450,7 @@ var cachedVersion = null;
 function getVersion() {
   if (cachedVersion) return cachedVersion;
   if (true) {
-    cachedVersion = "2.18.6";
+    cachedVersion = "2.18.7";
     return cachedVersion;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/cli",
-  "version": "2.18.6",
+  "version": "2.18.7",
   "description": "The self-custody MPC wallet CLI for AI coding agents (Claude Code, Cursor, OpenCode). Natural-language agent mode, 36+ chains, DKLS23 threshold signatures. Seedless.",
   "type": "module",
   "bin": {