@bytevion/cli 0.5.0 → 0.5.1

package/dist/commands/compare.js

@@ -41,6 +41,42 @@ const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : Number(v)
 const usd = (v) => `$${num(v).toFixed(6)}`;
 const tokensOf = (m) => num(m?.tokens_in) + num(m?.tokens_out);
 const pad = (s, n) => s.padEnd(n);
+const QUALITY_PASS = new Set(['quality_held', 'quality_improved', 'passed_verification']);
+// The gateway scores each lane's quality in isolation; a soft "failed_verification" means
+// an automated claim check was inconclusive, not that the answer is wrong or worse than
+// direct. Render it as unverified rather than a scary raw state.
+const qualityLabel = (s) => {
+    switch (s) {
+        case 'quality_held':
+        case 'quality_improved':
+        case 'passed_verification':
+            return 'held';
+        case 'failed_verification':
+            return 'unverified (auto-check inconclusive)';
+        case 'review':
+            return 'needs review';
+        case 'failed_guard':
+            return 'failed — output unusable';
+        case 'not_measured':
+            return 'not measured';
+        default:
+            return s;
+    }
+};
+const verdictLine = (dominance, quality, savingsPct, latencySaved) => {
+    const cheaper = savingsPct > 0;
+    const faster = latencySaved > 0;
+    const held = QUALITY_PASS.has(quality);
+    if (dominance === 'dominant')
+        return ui.theme.ok('Byte wins — cheaper, faster, quality held');
+    if (dominance === 'regressed')
+        return ui.theme.bad('Regressed — direct was the better choice here');
+    if (cheaper || faster) {
+        const wins = [cheaper ? `${savingsPct.toFixed(0)}% cheaper` : '', faster ? `${Math.abs(latencySaved)}ms faster` : ''].filter(Boolean).join(', ');
+        return ui.theme.ok(`Byte wins — ${wins}`) + (held ? '' : ui.theme.muted(' · quality unverified'));
+    }
+    return ui.theme.muted('Neutral — no clear difference');
+};
 class Compare extends base_1.BaseCommand {
     static description = 'Prove the win: run a prompt direct vs through Byte and compare cost, latency, and quality.';
     static examples = [
@@ -94,9 +130,8 @@ class Compare extends base_1.BaseCommand {
         const sign = latencySaved >= 0 ? '−' : '+';
         this.log(`  Savings    ${usd(savings)} (${savingsPct.toFixed(1)}%)`);
         this.log(`  Latency    ${sign}${Math.abs(latencySaved)} ms`);
-        this.log(`  Quality    ${quality}`);
-        const verdict = dominance === 'dominant' ? ui.theme.ok('Byte wins (dominant)') : ui.theme.warn(dominance);
-        this.log(`  Verdict    ${verdict}`);
+        this.log(`  Quality    ${qualityLabel(quality)}`);
+        this.log(`  Verdict    ${verdictLine(dominance, quality, savingsPct, latencySaved)}`);
         this.log('');
         return { direct, byte, summary };
     }

package/dist/lib/home.js

@@ -68,7 +68,13 @@ async function loadHomeData(api, byteKey, fallbackId) {
         providers: conns.length || undefined,
         models: models || undefined,
         byteKey,
-        gateway: health ? (health.status === 'ok' || health.ok ? 'healthy' : 'down') : 'unknown',
+        // The control plane reports a ready gateway as status:"ready" (and mirrors it in
+        // health.gateway). Accept "ready"/"ok"/ok so a healthy gateway is never shown as down.
+        gateway: health
+            ? health.status === 'ready' || health.status === 'ok' || health.gateway === 'ready' || health.gateway === 'ok' || health.ok
+                ? 'healthy'
+                : 'down'
+            : 'unknown',
         savingsSeries: series.map((p) => num(p.savings_usd)),
         savedTotal: series.reduce((a, p) => a + num(p.savings_usd), 0),
         tokensTotal: series.reduce((a, p) => a + num(p.tokens_in) + num(p.tokens_out), 0),

package/oclif.manifest.json

@@ -1620,23 +1620,14 @@
         "test.js"
       ]
     },
-    "opt:preset": {
+    "providers:add": {
       "aliases": [],
-      "args": {
-        "preset": {
-          "description": "Mode to apply",
-          "name": "preset",
-          "options": [
-            "maximum",
-            "max_savings",
-            "balanced",
-            "lowest_latency",
-            "reliability_first"
-          ],
-          "required": true
-        }
-      },
-      "description": "Apply an optimization mode for the whole org (maximum, balanced, max_savings, lowest_latency, reliability_first).",
+      "args": {},
+      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
+      "examples": [
+        "<%= config.bin %> providers add --provider deepseek --api-key sk-...",
+        "<%= config.bin %> providers add --provider custom --provider-base-url https://api.example.com/v1 --api-key ..."
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1660,11 +1651,53 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Provider preset id (openai, deepseek, anthropic, …)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "Upstream provider API key",
+          "env": "BYTE_PROVIDER_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider-base-url": {
+          "description": "Custom base URL (for --provider custom or to override)",
+          "name": "provider-base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mode": {
+          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
+          "name": "mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "description": "Label for this connection",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-fetch": {
+          "description": "Skip auto-importing the model list",
+          "name": "no-fetch",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:preset",
+      "id": "providers:add",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1674,34 +1707,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "preset.js"
+        "providers",
+        "add.js"
       ]
     },
-    "opt:set": {
+    "providers:compare": {
       "aliases": [],
       "args": {
-        "flag": {
-          "description": "Optimization field name",
-          "name": "flag",
-          "required": true
-        },
-        "value": {
-          "description": "on or off",
-          "name": "value",
-          "options": [
-            "on",
-            "off",
-            "true",
-            "false"
-          ],
-          "required": true
+        "alias": {
+          "description": "Model byte alias (omit when using --all)",
+          "name": "alias",
+          "required": false
         }
       },
-      "description": "Toggle a single optimization layer on or off. See field names with `byte opt show --json`.",
+      "description": "Enable (or disable) direct-vs-Byte comparison on imported models. Run with --all so `byte compare` works out of the box.",
       "examples": [
-        "<%= config.bin %> opt set compression_enabled off",
-        "<%= config.bin %> opt set response_cache_enabled on"
+        "<%= config.bin %> providers compare --all",
+        "<%= config.bin %> providers compare byte-2-deepseek-v4-flash",
+        "<%= config.bin %> providers compare byte-2-deepseek-v4-flash --off"
       ],
       "flags": {
         "json": {
@@ -1726,11 +1749,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "all": {
+          "description": "Apply to every priced model in the org",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "off": {
+          "description": "Disable comparison instead of enabling it",
+          "name": "off",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:set",
+      "id": "providers:compare",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1740,14 +1775,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "set.js"
+        "providers",
+        "compare.js"
       ]
     },
-    "opt:show": {
+    "providers:list": {
       "aliases": [],
       "args": {},
-      "description": "Show the current optimization mode and every layer running on your requests.",
+      "description": "List upstream provider connections for the current org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1775,7 +1810,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:show",
+      "id": "providers:list",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1785,18 +1820,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "show.js"
+        "providers",
+        "list.js"
       ]
     },
-    "providers:add": {
+    "providers:rotate": {
       "aliases": [],
-      "args": {},
-      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
-      "examples": [
-        "<%= config.bin %> providers add --provider deepseek --api-key sk-...",
-        "<%= config.bin %> providers add --provider custom --provider-base-url https://api.example.com/v1 --api-key ..."
-      ],
+      "args": {
+        "id": {
+          "description": "Connection id (see `byte providers list`)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1821,52 +1858,18 @@
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Provider preset id (openai, deepseek, anthropic, …)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "api-key": {
-          "description": "Upstream provider API key",
+          "description": "New upstream provider API key",
           "env": "BYTE_PROVIDER_KEY",
           "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider-base-url": {
-          "description": "Custom base URL (for --provider custom or to override)",
-          "name": "provider-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "mode": {
-          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
-          "name": "mode",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "label": {
-          "description": "Label for this connection",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-fetch": {
-          "description": "Skip auto-importing the model list",
-          "name": "no-fetch",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:add",
+      "id": "providers:rotate",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1877,24 +1880,19 @@
         "dist",
         "commands",
         "providers",
-        "add.js"
+        "rotate.js"
       ]
     },
-    "providers:compare": {
+    "providers:test": {
       "aliases": [],
       "args": {
-        "alias": {
-          "description": "Model byte alias (omit when using --all)",
-          "name": "alias",
-          "required": false
+        "id": {
+          "description": "Connection id (see `byte providers list`)",
+          "name": "id",
+          "required": true
         }
       },
-      "description": "Enable (or disable) direct-vs-Byte comparison on imported models. Run with --all so `byte compare` works out of the box.",
-      "examples": [
-        "<%= config.bin %> providers compare --all",
-        "<%= config.bin %> providers compare byte-2-deepseek-v4-flash",
-        "<%= config.bin %> providers compare byte-2-deepseek-v4-flash --off"
-      ],
+      "description": "Verify a provider connection by re-fetching its model list.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1918,23 +1916,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "all": {
-          "description": "Apply to every priced model in the org",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "off": {
-          "description": "Disable comparison instead of enabling it",
-          "name": "off",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:compare",
+      "id": "providers:test",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1945,13 +1931,26 @@
         "dist",
         "commands",
         "providers",
-        "compare.js"
+        "test.js"
       ]
     },
-    "providers:list": {
+    "opt:preset": {
       "aliases": [],
-      "args": {},
-      "description": "List upstream provider connections for the current org.",
+      "args": {
+        "preset": {
+          "description": "Mode to apply",
+          "name": "preset",
+          "options": [
+            "maximum",
+            "max_savings",
+            "balanced",
+            "lowest_latency",
+            "reliability_first"
+          ],
+          "required": true
+        }
+      },
+      "description": "Apply an optimization mode for the whole org (maximum, balanced, max_savings, lowest_latency, reliability_first).",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1979,7 +1978,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "opt:preset",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1989,20 +1988,35 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "list.js"
+        "opt",
+        "preset.js"
       ]
     },
-    "providers:rotate": {
+    "opt:set": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
+        "flag": {
+          "description": "Optimization field name",
+          "name": "flag",
+          "required": true
+        },
+        "value": {
+          "description": "on or off",
+          "name": "value",
+          "options": [
+            "on",
+            "off",
+            "true",
+            "false"
+          ],
           "required": true
         }
       },
-      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
+      "description": "Toggle a single optimization layer on or off. See field names with `byte opt show --json`.",
+      "examples": [
+        "<%= config.bin %> opt set compression_enabled off",
+        "<%= config.bin %> opt set response_cache_enabled on"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2026,19 +2040,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "api-key": {
-          "description": "New upstream provider API key",
-          "env": "BYTE_PROVIDER_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:rotate",
+      "id": "opt:set",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -2048,20 +2054,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "rotate.js"
+        "opt",
+        "set.js"
       ]
     },
-    "providers:test": {
+    "opt:show": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Verify a provider connection by re-fetching its model list.",
+      "args": {},
+      "description": "Show the current optimization mode and every layer running on your requests.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -2089,7 +2089,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:test",
+      "id": "opt:show",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -2099,8 +2099,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "test.js"
+        "opt",
+        "show.js"
       ]
     },
     "sessions": {
@@ -2200,5 +2200,5 @@
       ]
     }
   },
-  "version": "0.5.0"
+  "version": "0.5.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytevion/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Byte — control your LLM optimization gateway from the terminal.",
   "author": "Byte",
   "license": "UNLICENSED",