@leroylabs/cli 0.1.7 → 0.1.9

package/LICENSE

@@ -0,0 +1,20 @@
+Leroy Labs CLI Proprietary License
+
+Copyright © 2026 Leroy Labs. All rights reserved.
+
+Leroy Labs grants you a limited, revocable, non-exclusive,
+non-transferable, non-sublicensable license to install and use an unmodified
+copy of this package solely to access the Leroy service in accordance with the
+Leroy Terms at https://getleroy.com/legal.
+
+Except for that limited license, Leroy Labs retains all right, title, and
+interest in and to this package, including its source code, interfaces,
+documentation, trademarks, and related intellectual property. You may not
+copy, modify, create derivative works from, distribute, publish, sublicense,
+sell, lease, reverse engineer, decompile, disassemble, or otherwise make this
+package or its source code available to any third party, except to the extent
+such restriction is prohibited by applicable law.
+
+This package may include third-party components governed by their respective
+license terms. Nothing in this license grants rights to Leroy Labs trademarks
+or branding.

package/README.md

@@ -55,23 +55,31 @@ which matches the one-minute tape cadence; use `--interval SECONDS` to choose a
 different polling interval. Each refresh is an authenticated evaluation request
 and may count toward the account's lookup allowance.
 
-## Match strength
+## Evidence Strength
 
 Leroy selects the strongest available evidence tier and does not pool lower
 tiers into it:
 
-- `5/5`: exact ticker setup
-- `4/5`: same setup on other tickers
-- `3/5`: same 41-sensor state
-- `2/5`: same side with strategy and market context
-- `1/5`: same side baseline
+- `5/5`: Exact Setup
+- `4/5`: Cross-Ticker Setup
+- `3/5`: Signal Pattern
+- `2/5`: Contextual Analogue
+- `1/5`: Direction-Only Baseline
+- `0/5`: No Comparable Evidence
 
-The human-readable output shows `Exact Matches` only for `5/5`. Lower tiers
-show only their own `Comparable Matches` count. Use `--verbose` for the match
-basis, or `--json` for the complete structured response.
+The human-readable output shows a scope-specific observation count according to
+the selected tier; these are observations in that evidence scope, not setup
+matches. Use `--verbose` for the full match basis, or `--json` for the complete
+structured response.
 
 The browser reference is available at [getleroy.com/cli](https://getleroy.com/cli).
 
+## License
+
+Copyright © 2026 Leroy Labs. This package is proprietary software, licensed
+only for use with Leroy under the [Leroy Terms](https://getleroy.com/legal).
+See [LICENSE](./LICENSE) for the package license.
+
 ## Exit codes
 
 - `0`: the request completed and returned a valid Leroy response. This includes

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@leroylabs/cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Command-line access to Leroy market evidence.",
   "homepage": "https://getleroy.com",
+  "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "files": [
     "bin",
     "src",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"

package/src/format.mjs

@@ -25,6 +25,32 @@ function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 
+export function unavailableSymbolGuidance(response) {
+  if (response?.status !== "unavailable") return null;
+  const assumptions = record(response.assumptions);
+  if (assumptions.availability_code !== "symbol_not_covered") return null;
+  const request = record(response.request);
+  const symbol = typeof request.symbol === "string" ? request.symbol : null;
+  if (!symbol) return null;
+  const suggestedSymbol = typeof assumptions.suggested_symbol === "string"
+    ? assumptions.suggested_symbol.toUpperCase()
+    : null;
+  return { symbol, suggestedSymbol };
+}
+
+function formatUnavailableSymbolGuidance(response, colorEnabled) {
+  const guidance = unavailableSymbolGuidance(response);
+  if (!guidance) return null;
+  return [
+    `${style("✕", ["bold", "red"], colorEnabled)}  ${style(`${guidance.symbol} is not currently covered by Leroy.`, ["white"], colorEnabled)}`,
+    ...(guidance.suggestedSymbol ? [
+      "",
+      `   ${style(`Did you mean ${guidance.suggestedSymbol}?`, ["white"], colorEnabled)}`,
+      `   ${color(`Retry: leroy evaluate ${guidance.suggestedSymbol}`, "neutral", colorEnabled)}`,
+    ] : []),
+  ].join("\n");
+}
+
 function finite(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
@@ -105,7 +131,8 @@ function memoryMatchCounts(response) {
   const rowCount = finite(record(selected).row_count) ?? 0;
   return {
     exact: tier.score === 5 ? rowCount : 0,
-    comparable: tier.score > 0 && tier.score < 5 ? rowCount : 0,
+    comparable: tier.score > 1 && tier.score < 5 ? rowCount : 0,
+    baseline: tier.score === 1 ? rowCount : 0,
     tier,
   };
 }
@@ -115,21 +142,67 @@ function matchTier(match) {
   const kind = value.match_kind;
   const scope = typeof value.scope === "string" ? value.scope : null;
   if (scope === "same_ticker_exact" || (kind === "context" && !scope)) {
-    return { score: 5, basis: "Exact ticker setup" };
+    return { score: 5, basis: "Exact Setup" };
   }
   if (scope === "cross_ticker_exact_state" || kind === "cross_ticker_context") {
-    return { score: 4, basis: "Same setup on other tickers" };
+    return { score: 4, basis: "Cross-Ticker Setup" };
   }
   if (scope === "exact_41_sensor_state" || kind === "strategy") {
-    return { score: 3, basis: "Same 41-sensor state" };
+    return { score: 3, basis: "Signal Pattern" };
   }
   if (scope?.startsWith("forward_overlay_") || kind === "forward_overlay_context") {
-    return { score: 2, basis: "Same side with strategy and market context" };
+    return { score: 2, basis: "Contextual Analogue" };
   }
   if (scope === "all_market_memory_observations" || kind === "side") {
-    return { score: 1, basis: "Same side baseline" };
+    return { score: 1, basis: "Direction-Only Baseline" };
   }
-  return { score: 0, basis: null };
+  return { score: 0, basis: "No Comparable Evidence" };
+}
+
+function matchShortLabel(score) {
+  if (score >= 5) return "Exact Setup";
+  if (score === 4) return "Cross-Ticker Setup";
+  if (score === 3) return "Signal Pattern";
+  if (score === 2) return "Contextual Analogue";
+  if (score === 1) return "Direction-Only Baseline";
+  return "No Comparable Evidence";
+}
+
+function matchTone(score) {
+  if (score >= 4) return "green";
+  if (score >= 2) return "yellow";
+  if (score === 1) return "red";
+  return "inactive";
+}
+
+function matchCells(score, colorEnabled) {
+  const active = Math.max(0, Math.min(5, Number(score) || 0));
+  const activeTone = matchTone(active);
+  return Array.from({ length: 5 }, (_, index) => color(
+    index < active ? "●" : "○",
+    index < active ? activeTone : "inactive",
+    colorEnabled,
+  )).join("");
+}
+
+function matchEvidenceLabel(tier, rowCount) {
+  const labels = {
+    5: "exact observations",
+    4: "cross-ticker observations",
+    3: "signal-pattern observations",
+    2: "context observations",
+    1: "baseline observations",
+  };
+  return labels[tier.score] ? `${rowCount} ${labels[tier.score]}` : "No comparable observations";
+}
+
+function matchCountMetric(tier, counts) {
+  if (tier.score === 5) return { label: "Exact Observations", value: countLabel(counts.exact) };
+  if (tier.score === 4) return { label: "Cross-Ticker Sample", value: countLabel(counts.comparable) };
+  if (tier.score === 3) return { label: "Signal Pattern Sample", value: countLabel(counts.comparable) };
+  if (tier.score === 2) return { label: "Context Sample", value: countLabel(counts.comparable) };
+  if (tier.score === 1) return { label: "Baseline Observations", value: countLabel(counts.baseline) };
+  return null;
 }
 
 function memoryStatus(response) {
@@ -167,7 +240,7 @@ function lookupMilliseconds(response) {
 function humanizeStatus(value) {
   const labels = {
     historical_match: "Historical Match",
-    insufficient_context: "Limited Match",
+    insufficient_context: "No Comparable Evidence",
     artifact_unavailable: "Reader Unavailable",
   };
   if (typeof value !== "string" || !value) return "Unavailable";
@@ -176,7 +249,7 @@ function humanizeStatus(value) {
 
 function memorySummary(status, tier) {
   if (status === "historical_match" && tier.score === 5) return "Match Found";
-  if (tier.score > 0) return "Limited Match";
+  if (tier.score > 0) return tier.basis;
   return humanizeStatus(status);
 }
 
@@ -307,7 +380,7 @@ function ratioLabel(value) {
 }
 
 function horizonLabel(horizon) {
-  return `${horizon} Minutes`;
+  return `${horizon} Min`;
 }
 
 function setupLine(label, value, tone, enabled) {
@@ -427,17 +500,10 @@ function gridFrameParts(value) {
 
 function gridMatchColumns(match, colorEnabled) {
   const tier = matchTier(match);
-  const label = tier.score === 5 ? "Exact" : tier.score > 0 ? "Limited" : "No match";
   const rowCount = countLabel(record(match).row_count);
-  const countLabelText = tier.score === 5 ? "exact observations" : "comparable observations";
-  const cells = Array.from({ length: 5 }, (_, index) => color(
-    index < tier.score ? "■" : "□",
-    index < tier.score ? "green" : "neutral",
-    colorEnabled,
-  )).join("");
   return {
-    label: `${cells} ${label}`,
-    comparable: `${rowCount} ${countLabelText}`,
+    label: `${matchCells(tier.score, colorEnabled)} ${matchShortLabel(tier.score)}`,
+    comparable: matchEvidenceLabel(tier, rowCount),
   };
 }
 
@@ -514,7 +580,7 @@ export function buildEvaluationViewModel(response) {
     statusReason: memory.reason,
     match: {
       score: tier.score,
-      label: tier.score === 5 ? "Exact" : tier.score > 0 ? "Limited" : "No match",
+      label: matchShortLabel(tier.score),
       rowCount: countLabel(record(match).row_count),
       basis: tier.basis,
     },
@@ -555,7 +621,7 @@ function formatGridEvaluation(response, { colorEnabled = true } = {}) {
   const topLines = [
     gridColumns(
       { text: `${sideText} EVIDENCE`, tone: sideTone(requestedSide) },
-      { text: "MATCH STRENGTH", tone: "white" },
+      { text: "EVIDENCE STRENGTH", tone: "white" },
       colorEnabled,
     ),
     gridColumns(
@@ -586,6 +652,8 @@ function formatGridEvaluation(response, { colorEnabled = true } = {}) {
 }
 
 export function formatEvaluation(response, { colorEnabled = true, setup = false, verbose = false, compact = false, layout = "ledger" } = {}) {
+  const unavailableSymbol = formatUnavailableSymbolGuidance(response, colorEnabled);
+  if (unavailableSymbol) return unavailableSymbol;
   if (layout === "grid") {
     const { status } = memoryStatus(response);
     return status === "artifact_unavailable"
@@ -672,6 +740,7 @@ export function formatEvaluation(response, { colorEnabled = true, setup = false,
     ...strategyMixLines(counts.counts, strategyTotal, colorEnabled),
     sectionBottom(colorEnabled),
   ];
+  const matchCount = matchCountMetric(matchCounts.tier, matchCounts);
   const outcomeGrid = [
     sectionRule("Outcome", colorEnabled),
     outcomeRow("Timeframe", outcomeRows.map((row) => ({ value: horizonLabel(row.horizon), tone: "white" })), colorEnabled),
@@ -705,10 +774,9 @@ export function formatEvaluation(response, { colorEnabled = true, setup = false,
       "",
       "Market Memory",
       compactMetricLine("Status", memorySummary(status, matchCounts.tier), statusTone, colorEnabled),
-      compactMetricLine("Match Strength", `${matchCounts.tier.score}/5`, matchCounts.tier.score === 5 ? "green" : matchCounts.tier.score > 0 ? "yellow" : "dim", colorEnabled),
-      ...(matchCounts.tier.score === 5 ? [compactMetricLine("Exact Matches", countLabel(matchCounts.exact), "bold", colorEnabled)] : []),
-      ...(matchCounts.tier.score > 0 && matchCounts.tier.score < 5 ? [compactMetricLine("Comparable Matches", countLabel(matchCounts.comparable), "bold", colorEnabled)] : []),
-      ...(verbose && matchCounts.tier.basis ? [compactMetricLine("Match Basis", matchCounts.tier.basis, "dim", colorEnabled)] : []),
+      compactMetricLine("Evidence Strength", `${matchCounts.tier.score}/5`, matchCounts.tier.score === 5 ? "green" : matchCounts.tier.score > 0 ? "yellow" : "dim", colorEnabled),
+      ...(matchCount ? [compactMetricLine(matchCount.label, matchCount.value, "bold", colorEnabled)] : []),
+      ...(verbose && matchCounts.tier.basis ? [compactMetricLine("Evidence Basis", matchCounts.tier.basis, "dim", colorEnabled)] : []),
       compactMetricLine("Window", coverageWindow(response, match), "dim", colorEnabled),
       "",
       "Outcome",
@@ -727,10 +795,9 @@ export function formatEvaluation(response, { colorEnabled = true, setup = false,
     "",
     sectionRule("Market Memory", colorEnabled),
     metricLine("Status", memorySummary(status, matchCounts.tier), statusTone, colorEnabled, 24),
-    metricLine("Match Strength", `${matchCounts.tier.score}/5`, matchCounts.tier.score === 5 ? "green" : matchCounts.tier.score > 0 ? "yellow" : "dim", colorEnabled, 24),
-    ...(matchCounts.tier.score === 5 ? [metricLine("Exact Matches", countLabel(matchCounts.exact), "bold", colorEnabled, 24)] : []),
-    ...(matchCounts.tier.score > 0 && matchCounts.tier.score < 5 ? [metricLine("Comparable Matches", countLabel(matchCounts.comparable), "bold", colorEnabled, 24)] : []),
-    ...(verbose && matchCounts.tier.basis ? [metricLine("Match Basis", matchCounts.tier.basis, "dim", colorEnabled, 24)] : []),
+    metricLine("Evidence Strength", `${matchCounts.tier.score}/5`, matchCounts.tier.score === 5 ? "green" : matchCounts.tier.score > 0 ? "yellow" : "dim", colorEnabled, 24),
+    ...(matchCount ? [metricLine(matchCount.label, matchCount.value, "bold", colorEnabled, 24)] : []),
+    ...(verbose && matchCounts.tier.basis ? [metricLine("Evidence Basis", matchCounts.tier.basis, "dim", colorEnabled, 24)] : []),
     metricLine("Window", coverageWindow(response, match), "dim", colorEnabled, 24),
     sectionBottom(colorEnabled),
     "",

package/src/live-ui.mjs

@@ -1,7 +1,7 @@
 import { stdin as processInput, stdout as processOutput } from "node:process";
 
 import { ansiForeground, LEROY_COLORS } from "./colors.mjs";
-import { buildEvaluationViewModel } from "./format.mjs";
+import { buildEvaluationViewModel, unavailableSymbolGuidance } from "./format.mjs";
 
 const MAX_CARD_WIDTH = 67;
 const MIN_CARD_WIDTH = 64;
@@ -235,7 +235,7 @@ function renderOutcomeTable(outcomes, colorEnabled) {
   const rows = [
     [
       tableValue("Timeframe", "muted", colorEnabled, { bold: true }),
-      ...outcomes.map((outcome) => tableValue(`${outcome.horizon} Minutes`, "white", colorEnabled, { bold: true, hAlign: "right" })),
+      ...outcomes.map((outcome) => tableValue(`${outcome.horizon} Min`, "white", colorEnabled, { bold: true, hAlign: "right" })),
     ],
     [
       tableValue("Avg. Return", "muted", colorEnabled, { bold: true }),
@@ -312,24 +312,30 @@ function bodyLine(content, colorEnabled, layout) {
 }
 
 function renderHistoricalEvidence(view, colorEnabled) {
-  const sampleLabel = view.match.score === 5
-    ? " exact observations"
-    : view.match.score > 0
-      ? " comparable observations"
-      : " observations";
-  const matchLabel = view.match.label === "No match" ? "No Match" : `${view.match.label} Match`;
-  const matchDetails = view.match.score > 0 ? `${view.match.rowCount}${sampleLabel}` : "No comparable observations.";
+  const score = view.match.score;
+  const activeTone = score >= 4 ? "green" : score >= 2 ? "yellow" : score === 1 ? "red" : "inactive";
+  const detailLabels = {
+    5: "exact observations",
+    4: "cross-ticker observations",
+    3: "signal-pattern observations",
+    2: "context observations",
+    1: "baseline observations",
+  };
+  const matchDetails = detailLabels[score]
+    ? `${view.match.rowCount} ${detailLabels[score]}`
+    : "No comparable observations";
   const matchStrength = [
     Array.from({ length: 5 }, (_, index) => tone(
-      strengthCellGlyph(index < view.match.score, colorEnabled),
-      index < view.match.score ? "green" : "neutral",
+      index < score ? "●" : "○",
+      index < score ? activeTone : "inactive",
       colorEnabled,
-    )).join(" "),
-    tone(matchLabel, view.match.score > 0 ? "white" : "muted", colorEnabled, true),
+    )).join(""),
+    tone(`${score}/5`, score > 0 ? "white" : "muted", colorEnabled, true),
   ].join("  ");
   const rows = [
-    [tableValue("Match Strength", "muted", colorEnabled, { bold: true }), { content: matchStrength, hAlign: "left" }],
-    [tableValue("Match Details", "muted", colorEnabled, { bold: true }), tableValue(matchDetails, "neutral", colorEnabled, { bold: true })],
+    [tableValue("Evidence Strength", "muted", colorEnabled, { bold: true }), { content: matchStrength, hAlign: "left" }],
+    [tableValue("Evidence Basis", "muted", colorEnabled, { bold: true }), tableValue(view.match.basis ?? "No Comparable Evidence", "neutral", colorEnabled)],
+    [tableValue("Observations", "muted", colorEnabled, { bold: true }), tableValue(matchDetails, "neutral", colorEnabled, { bold: true })],
     [tableValue("Date Range", "muted", colorEnabled, { bold: true }), tableValue(view.archiveWindow, "neutral", colorEnabled)],
   ];
   return renderTable(rows, tableColumnWidths(rows), colorEnabled, { divider: false });
@@ -366,6 +372,24 @@ export function renderEvidenceView(response, { colorEnabled = true, columns = 80
     ? new Date(updatedAt).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" })
     : "—";
   const liveTone = phase === "error" ? "red" : phase === "checking" ? "yellow" : "green";
+  const unavailableGuidance = unavailableSymbolGuidance(response);
+  if (unavailableGuidance) {
+    const lines = renderLoadingSteps({
+      symbol: unavailableGuidance.symbol,
+      progress,
+      colorEnabled,
+      columns,
+    }).split("\n");
+    lines.push("");
+    lines.push(`${layout.padding}${tone("✕", "red", colorEnabled, true)}  ${tone(`${unavailableGuidance.symbol} is not currently covered by Leroy.`, "white", colorEnabled)}`);
+    if (unavailableGuidance.suggestedSymbol) {
+      lines.push("");
+      lines.push(`${layout.padding}   ${tone(`Did you mean ${unavailableGuidance.suggestedSymbol}?`, "white", colorEnabled)}`);
+      lines.push(`${layout.padding}   ${tone(`Retry: leroy evaluate ${unavailableGuidance.suggestedSymbol}`, "neutral", colorEnabled)}`);
+    }
+    lines.push("", "");
+    return lines.join("\n");
+  }
   if (view.status === "artifact_unavailable") {
     const lines = ["", ""];
     lines.push(`${layout.padding}${tone("!", liveTone, colorEnabled, true)}  ${tone("Market Memory unavailable", "white", colorEnabled)}`);