@leroylabs/cli 0.1.3 → 0.1.4

package/README.md

@@ -21,9 +21,9 @@ From the repository root:
 
 ```bash
 npm run leroy -- help
-npm run leroy -- ask buy ABNB
-npm run leroy -- watch buy ABNB
-npm run leroy -- ask buy ABNB --demo
+npm run leroy -- evaluate ABNB
+npm run leroy -- watch ABNB
+npm run leroy -- evaluate ABNB --demo
 ```
 
 The command reads `LEROY_MCP_URL` and `LEROY_API_KEY` when present. Otherwise,
@@ -32,13 +32,16 @@ Leroy config.
 
 The default endpoint is `https://getleroy.com/api/mcp`.
 
-Use `--demo` with `ask` or `watch` to render local randomized evidence without
+`evaluate` and `watch` default to the buy case. Use `--side sell` or
+`--side both` when you need to evaluate a different side.
+
+Use `--demo` with `evaluate` or `watch` to render local randomized evidence without
 an API key or network request. Each demo evaluation generates 41 individual
 strategy cells plus varied market context, match strength, and outcomes so the
 interactive UI can be explored outside market hours.
 
 The CLI supports the authenticated `evaluate_current_setup` MCP tool. In an
-interactive terminal, the default `leroy ask` view renders the evidence card
+interactive terminal, the default `leroy evaluate` view renders the evidence card
 immediately and replaces its loading state with the authenticated result. Use
 `--json` for agent and shell integrations, or `--setup`/`--verbose` when you
 need the deterministic text formatter. A normal request reports current-frame
@@ -46,7 +49,7 @@ freshness, the registered and evaluated strategy counts, exact versus broader
 Market Memory evidence, completed-label counts, and the research-only
 boundary.
 
-Use `leroy watch buy ABNB` in an interactive terminal to keep the evidence view
+Use `leroy watch ABNB` in an interactive terminal to keep the evidence view
 open while the current tape advances. It refreshes once per minute by default,
 which matches the one-minute tape cadence; use `--interval SECONDS` to choose a
 different polling interval. Each refresh is an authenticated evaluation request

package/bin/leroy.mjs

@@ -11,6 +11,19 @@ import { createDemoResponse } from "../src/demo.mjs";
 import { usageError } from "../src/errors.mjs";
 import { formatEvaluation, formatHelp } from "../src/format.mjs";
 import { LiveEvidenceApp, render } from "../src/live-ui.mjs";
+import { ansiForeground, LEROY_COLORS } from "../src/colors.mjs";
+
+const ANSI = {
+  reset: "\u001b[0m",
+  bold: "\u001b[1m",
+  white: "\u001b[37m",
+  green: ansiForeground(LEROY_COLORS.green),
+  neutral: ansiForeground(LEROY_COLORS.neutral),
+};
+
+function promptStyle(value, tones, enabled) {
+  return enabled ? `${tones.map((tone) => ANSI[tone]).join("")}${value}${ANSI.reset}` : value;
+}
 
 function print(value = "") {
   output.write(`${value}\n`);
@@ -20,9 +33,15 @@ async function connect(options) {
   const config = await resolvedConfig(options);
   let apiKey = config.apiKey;
   if (!apiKey && input.isTTY) {
-    print("Create or activate an MCP key at https://getleroy.com/mcp.");
+    const colorEnabled = output.isTTY && !options.noColor;
+    print();
+    print(`${promptStyle("▲", ["green"], colorEnabled)} ${promptStyle("Connect Leroy", ["bold", "white"], colorEnabled)}`);
+    print();
+    print(`  ${promptStyle("Create or activate an MCP key at", ["neutral"], colorEnabled)}`);
+    print(`  ${promptStyle("https://getleroy.com/mcp", ["green"], colorEnabled)}`);
+    print();
     const readline = createInterface({ input, output });
-    apiKey = (await readline.question("Paste your lr_live_ key: ")).trim();
+    apiKey = (await readline.question(`  ${promptStyle("›", ["green"], colorEnabled)} Paste your ${promptStyle("lr_live_", ["bold", "white"], colorEnabled)} key: `)).trim();
     readline.close();
   }
   if (!apiKey) {
@@ -37,7 +56,7 @@ async function connect(options) {
   return 0;
 }
 
-async function ask(options) {
+async function evaluate(options) {
   const request = {
     symbol: options.symbol,
     side: options.side,
@@ -80,7 +99,7 @@ async function ask(options) {
 
 async function watch(options) {
   if (!input.isTTY || !output.isTTY) {
-    throw usageError("`leroy watch` requires an interactive terminal. Use `leroy ask` for one-shot output.");
+    throw usageError("`leroy watch` requires an interactive terminal. Use `leroy evaluate` for one-shot output.");
   }
   const request = {
     symbol: options.symbol,
@@ -118,7 +137,7 @@ async function main() {
       return 0;
     }
     if (options.command === "connect") return await connect(options);
-    if (options.command === "ask") return await ask(options);
+    if (options.command === "evaluate") return await evaluate(options);
     if (options.command === "watch") return await watch(options);
     throw usageError("Unknown command: " + options.command + ". Run `leroy help`.");
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leroylabs/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Command-line access to Leroy market evidence.",
   "type": "module",
   "files": [

package/src/args.mjs

@@ -27,6 +27,7 @@ export function parseArgs(argv) {
     intervalSeconds: 60,
   };
   const positional = [];
+  let sideFlagProvided = false;
   for (let index = 0; index < rest.length; index += 1) {
     const value = rest[index];
     if (!value.startsWith("--")) {
@@ -59,7 +60,10 @@ export function parseArgs(argv) {
       continue;
     }
     const next = inline ?? rest[++index];
-    if (flag === "--side") options.side = next;
+    if (flag === "--side") {
+      options.side = next;
+      sideFlagProvided = true;
+    }
     else if (flag === "--horizon") options.horizons = [Number(next)];
     else if (flag === "--endpoint") options.endpoint = next;
     else if (flag === "--api-key") options.apiKey = next;
@@ -69,21 +73,25 @@ export function parseArgs(argv) {
     else if (flag === "--interval") options.intervalSeconds = numberValue(next, flag);
     else throw usageError(`Unknown option: ${flag}`);
   }
-  if (["ask", "watch"].includes(command) && ["buy", "sell", "both"].includes(positional[0]?.toLowerCase())) {
-    if (options.side === "buy") options.side = positional[0].toLowerCase();
+  if (["evaluate", "watch"].includes(command) && ["buy", "sell", "both"].includes(positional[0]?.toLowerCase())) {
+    const positionalSide = positional[0].toLowerCase();
+    if (sideFlagProvided && options.side !== positionalSide) {
+      throw usageError("Specify the side once, using either a positional value or --side.");
+    }
+    if (!sideFlagProvided) options.side = positionalSide;
     positional.shift();
   }
   options.symbol = positional[0] ? positional[0].toUpperCase() : null;
-  if (["ask", "watch"].includes(options.command)) {
+  if (["evaluate", "watch"].includes(options.command)) {
     if (!options.symbol || !/^[A-Z][A-Z0-9.-]{0,11}$/.test(options.symbol)) {
-      throw usageError(`Usage: leroy ${options.command} buy|sell|both SYMBOL`);
+      throw usageError(`Usage: leroy ${options.command} SYMBOL [--side buy|sell|both]`);
     }
     if (!["buy", "sell", "both"].includes(options.side)) throw usageError("--side must be buy, sell, or both.");
     if (!options.horizons.every((horizon) => DEFAULT_HORIZONS.includes(horizon))) throw usageError("--horizon must be 5, 15, 30, or 60.");
     if (options.command === "watch" && options.json) throw usageError("`leroy watch` cannot be combined with --json.");
   }
-  if (options.demo && !["ask", "watch"].includes(options.command)) {
-    throw usageError("`--demo` can only be used with `leroy ask` or `leroy watch`.");
+  if (options.demo && !["evaluate", "watch"].includes(options.command)) {
+    throw usageError("`--demo` can only be used with `leroy evaluate` or `leroy watch`.");
   }
   return options;
 }

package/src/format.mjs

@@ -747,16 +747,17 @@ export function formatHelp() {
     "",
     "Usage:",
     "  leroy connect [--api-key lr_live_...]",
-    "  leroy ask buy|sell|both SYMBOL [--setup] [--verbose] [--demo] [--horizon 5|15|30|60]",
-    "  leroy watch buy|sell|both SYMBOL [--interval SECONDS] [--demo] [--horizon 5|15|30|60]",
+    "  leroy evaluate SYMBOL [--side buy|sell|both] [--setup] [--verbose] [--demo] [--horizon 5|15|30|60]",
+    "  leroy watch SYMBOL [--side buy|sell|both] [--interval SECONDS] [--demo] [--horizon 5|15|30|60]",
+    "  Buy is the default side; use --side sell or --side both to override it.",
     "",
     "Examples:",
-    "  leroy ask buy ABNB",
-    "  leroy ask buy ABNB --setup --verbose",
-    "  leroy ask sell AAPL --horizon 30",
-    "  leroy ask buy ABNB --json",
-    "  leroy ask buy ABNB --demo",
-    "  leroy watch buy ABNB",
+    "  leroy evaluate ABNB",
+    "  leroy evaluate ABNB --setup --verbose",
+    "  leroy evaluate AAPL --side sell --horizon 30",
+    "  leroy evaluate ABNB --json",
+    "  leroy evaluate ABNB --demo",
+    "  leroy watch ABNB",
     "",
     "Read the full CLI reference: https://getleroy.com/cli",
   ].join("\n");

package/src/live-ui.mjs

@@ -389,7 +389,6 @@ function QueryHeader({ view, colors }) {
   },
     React.createElement(Box, { flexDirection: "row", width: "100%", paddingRight: 2, justifyContent: "space-between" },
       React.createElement(Text, { color: colors.white },
-        "ASK ",
         React.createElement(Text, { color: sideTone(view.side, colors), bold: true }, side),
         " · ",
         React.createElement(Text, { color: colors.white, bold: true }, view.symbol),