@boole-digital/cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -372,6 +372,22 @@ function onboardingNotice() {
   log(`  Deploy your first trading computer there, then come back and run ${c.cyan("boole connect")}.`);
   log("");
 }
+function operatingBrief() {
+  log("");
+  log(c.bold("How to operate this computer"));
+  log("  Trades and strategies go through the gateway gate \u2014 automatically tracked on your dashboard.");
+  log("");
+  log(`  ${c.dim("# buy $100 of BTC (market)")}`);
+  log(c.cyan("  boole strategy spawn --template order_template.js --name btc-buy \\"));
+  log(c.cyan("    --param EXCHANGE=hyperliquid --param MARKET=BTC --param SIDE=buy \\"));
+  log(c.cyan("    --param ORDER_TYPE=market --param TOTAL_USD=100 --param LIMIT_PRICE=0"));
+  log("");
+  log(`  Sell with ${c.dim("SIDE=sell")}. Other templates: ${c.dim("grid, twap, scale, stop, loop")}.`);
+  log(`  Inspect: ${c.cyan("boole balances")} \xB7 ${c.cyan("boole strategy ls")} \xB7 ${c.cyan("boole logs <name>")} \xB7 ${c.cyan('boole ssh "<read cmd>"')}`);
+  log(`  ${c.yellow("Never")} write files or run pm2 by hand \u2014 always use the gate (that is what keeps tracking correct).`);
+  log(`  Drop the full rules into your coding agent: ${c.cyan("boole init")} ${c.dim("\u2192 CLAUDE.md / AGENTS.md / GEMINI.md")}`);
+  log("");
+}
 function printAgents(droplets) {
   if (!droplets.length) {
     onboardingNotice();
@@ -414,13 +430,27 @@ async function summary() {
   ok(`Logged in as ${c.bold(creds.user.email || creds.user.id)}${creds.user.role ? c.dim(` \xB7 ${creds.user.role}`) : ""}`);
   const api = new BooleApi();
   let droplets = [];
+  let listErr = "";
   try {
     droplets = await api.listDroplets();
   } catch (e) {
-    warn(`Could not list trading computers: ${e.message}`);
-    return;
+    listErr = e?.message || String(e);
   }
   if (!droplets.length) {
+    const sess = loadSession();
+    if (sess?.ip) {
+      log("");
+      ok(`Connected to ${c.bold(sess.agent || sess.ip)} ${c.dim(`(${sess.ip})`)} ${c.dim("\xB7 cached session")}`);
+      if (listErr) log(c.dim(`  (couldn't reach the account API: ${listErr})`));
+      else log(c.dim(`  This account has no computer on file, but \`boole ssh\` + \`boole strategy \u2026\` work against the connected box.`));
+      log(c.dim(`  If you expected a computer here, you may be logged in as a different account than the one that owns it.`));
+      operatingBrief();
+      return;
+    }
+    if (listErr) {
+      warn(`Could not list trading computers: ${listErr}`);
+      return;
+    }
     onboardingNotice();
     return;
   }
@@ -428,17 +458,18 @@ async function summary() {
   log(c.bold(`Trading computers (${droplets.length})`));
   printAgents(droplets);
   const pick = pickAgentId(droplets);
-  if (!pick) return;
-  log("");
-  log(c.bold(`Snapshot \u2014 ${pick.name}`));
-  try {
-    const health = await api.getHealth(pick.id);
-    ok(`online${health.defaultModel ? c.dim(` \xB7 model ${health.defaultModel}`) : ""}`);
-  } catch {
-    warn("trading computer unreachable (tunnel may be waking up \u2014 retry in a moment)");
-    return;
+  if (pick) {
+    log("");
+    log(c.bold(`Snapshot \u2014 ${pick.name}`));
+    try {
+      const health = await api.getHealth(pick.id);
+      ok(`online${health.defaultModel ? c.dim(` \xB7 model ${health.defaultModel}`) : ""}`);
+      await printBalances(api, pick.id, "hyperliquid");
+    } catch {
+      warn("trading computer unreachable (tunnel may be waking up \u2014 retry in a moment)");
+    }
   }
-  await printBalances(api, pick.id, "hyperliquid");
+  operatingBrief();
 }
 async function printBalances(api, id, exchange) {
   try {
@@ -718,80 +749,75 @@ async function strategyDoctor(name) {
 // src/rules.ts
 import { writeFileSync as writeFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "node:fs";
 import { join as join2, resolve } from "node:path";
-var OPERATING_RULES = `# Boole Trading Computer \u2014 Operating Rules (READ FIRST, IN FULL)
-
-You operate a customer's **live** crypto trading computer through the \`boole\` CLI.
-**Real money is at risk.** These are STRICT, NON-NEGOTIABLE rules.
-
-> Why they matter: Boole tracks and controls every strategy by HOW it was created.
-> If you create one any other way \u2014 writing files over SSH, starting processes
-> yourself \u2014 it **silently fails**: it won't register, won't appear on the
-> dashboard, can't be controlled, and may mismanage live positions. There is no
-> error message. When in doubt, STOP and ask the user.
-
-## Boot sequence \u2014 every session, before anything else
-1. \`boole status\` \u2014 confirm you are logged in and a trading computer is connected.
-   If not, STOP and tell the user to run \`boole login\` then \`boole connect\`.
-2. Read this entire file.
-3. \`boole strategy ls\` \u2014 see what is already running.
-
-## The one rule: THINK locally, COMMIT through \`boole\`
-- THINK \u2014 research, analyze data, design, draft code \u2014 freely on this machine. No limits.
-- COMMIT \u2014 anything that changes the trading computer \u2014 ONLY through \`boole\` commands.
-
-## Creating / running a strategy \u2014 the ONLY sanctioned path
-Spawn from a known-good template through the gateway gate:
-
-    boole strategy spawn --template <template.js> --name <name> \\
-      --param KEY=VALUE --param KEY=VALUE ...
-
-- This registers the run and starts it tracked, so it appears on the dashboard.
-- \`--name\`: lowercase letters, digits, "-" or "_" (e.g. btc-grid).
-- \`--param\`: pass raw values (EXCHANGE=hyperliquid, TOTAL_USD=50). The CLI quotes them.
-- Verify: \`boole strategy doctor <name>\` \u2192 should report online and tracked.
-
-### Templates (required params)
+var OPERATING_RULES = `# Boole Trading Computer \u2014 Operating Rules (READ FIRST)
+
+You operate the customer's **live** crypto trading computer by working ON the box
+(over \`boole ssh\`) and using its on-box **harness** \u2014 the gateway's spawn GATE,
+which places and TRACKS every order and strategy on the dashboard. Real money is
+at risk, so be deliberate \u2014 but the user asked you to operate their computer, so
+OPERATE IT. Place the trades they ask for; don't refuse or interrogate over
+routine orders.
+
+## What "the harness" is (and why you go through it)
+The box runs a gateway that exposes a spawn GATE. You place trades and run
+strategies by spawning a known-good TEMPLATE through that gate \u2014 NEVER by writing
+files or starting processes yourself. The gate registers the run, wires up
+tracking, sets STRATEGY_NAME/RUN_ID, and starts it, so it always shows on the
+dashboard with accounting. \`boole strategy spawn\` is simply how you call that
+gate over SSH. Going around it (hand-writing a file, raw \`pm2 start\`) makes the
+order **silently** untracked \u2014 that is the one thing you must never do.
+
+## Boot (every session)
+1. \`boole status\` \u2014 see who you're logged in as.
+2. \`boole ssh "whoami"\` \u2014 if it connects, you HAVE a usable box; proceed. A
+   connected session is enough. Do NOT refuse to work just because \`status\`
+   doesn't list a computer for this account \u2014 that only means the web API has
+   none on file, not that you can't operate the connected box. If \`boole ssh\`
+   fails, tell the user to run \`boole connect\`.
+
+## Placing a trade \u2014 just do it
+"buy/sell $X of <coin>" is one market order. Place it through the gate with
+order_template. Do NOT quiz the user about venue/leverage for a routine order \u2014
+use the defaults and report the fill:
+
+    boole strategy spawn --template order_template.js --name <coin>-buy \\
+      --param EXCHANGE=hyperliquid --param MARKET=<COIN> --param SIDE=buy \\
+      --param ORDER_TYPE=market --param TOTAL_USD=<X> --param LIMIT_PRICE=0
+
+Defaults when unspecified: EXCHANGE=hyperliquid, ORDER_TYPE=market, LIMIT_PRICE=0,
+no leverage. Sell with SIDE=sell. Limit order: ORDER_TYPE=limit + LIMIT_PRICE=<p>.
+Pick a unique --name (if the gate says it exists, add a suffix). After it returns,
+tell the user what filled. Ask FIRST only if genuinely ambiguous (which coin? which
+account has funds?) or clearly risky (size far beyond their balance, leverage they
+didn't request) \u2014 a plain market buy the user requested is NOT one of those.
+
+## Running a strategy \u2014 same gate, different template
+    boole strategy spawn --template <template.js> --name <name> --param KEY=VALUE ...
+
+Templates (required params):
 - order_template.js  \u2014 single order: EXCHANGE, MARKET, SIDE(buy|sell), ORDER_TYPE(market|limit), TOTAL_USD, LIMIT_PRICE(0 for market)
 - grid_template.js   \u2014 grid: EXCHANGE, SYMBOL, LEVELS_PER_SIDE, ORDER_SIZE_USD, LEVERAGE, MAX_EXPOSURE_USD
 - twap_template.js   \u2014 TWAP: EXCHANGE, MARKET, SIDE, TOTAL_USD, DURATION_MIN, SLICES
 - scale_template.js  \u2014 ladder: EXCHANGE, MARKET, SIDE, TOTAL_USD, PRICE_LOW, PRICE_HIGH, LEVELS
 - stop_template.js   \u2014 conditional (no position yet): EXCHANGE, MARKET, SIDE, STOP_KIND(stop_market|stop_limit|tp_market|tp_limit), TOTAL_USD, TRIGGER_PRICE, LIMIT_PRICE(0 for *_market)
-- loop_template.js   \u2014 generic poll loop / price watcher: EXCHANGE, MARKET, POLL_SEC
-
-Example:
-
-    boole strategy spawn --template loop_template.js --name btc-watch \\
-      --param EXCHANGE=hyperliquid --param MARKET=BTC --param POLL_SEC=10
+- loop_template.js   \u2014 poll loop / price watcher: EXCHANGE, MARKET, POLL_SEC
 
-If you omit a required param, the gate returns an error naming it \u2014 fix and retry.
-If the gate says a template is not found, it is not installed on this box \u2014 pick
-another from the list or ask the user.
-Only use a template above. Do NOT hand-roll custom strategy files. If you need
-something no template covers, STOP and ask the user.
+If the gate names a missing param, add it and retry. If it says a template is not
+found, that one isn't installed on this box \u2014 pick another or ask.
 
-## Allowed \u2014 read-only inspection
+## Inspect (read-only) anytime
 - \`boole status\` / \`boole balances [--venue <v>]\` \u2014 identity, equity, positions
-- \`boole strategy ls\` \u2014 running strategies
-- \`boole strategy doctor <name>\` \u2014 health + tracking check
+- \`boole strategy ls\` / \`boole strategy doctor <name>\` \u2014 running strategies + tracking
 - \`boole logs <name>\` \u2014 tail a strategy's logs
-- \`boole ssh "<read-only command>"\` \u2014 inspect only (cat, ls, pm2 list, curl localhost:3000/health)
-
-## Forbidden
-- Do NOT write strategy or interface files over SSH.
-- Do NOT \`pm2 start/restart/stop/delete\` by hand.
-- Do NOT edit gateway files directly.
-- \`boole ssh\` is for READ-ONLY inspection. To change the box, use a \`boole\` verb.
-- If there is no verb for a change you need, STOP and ask. A missing verb is not permission to freelance.
-
-## Safety (real money)
-- Trading is live. Prefer capital preservation. Confirm exchange state before acting.
-- Never print or exfiltrate .env, API keys, or credentials.
-- Never restart the gateway.
-- Ask the user before destructive actions (closing positions, stopping strategies).
-
-## Notes
-- Some gateway internals are intentionally not readable from your account \u2014 by design. Use the \`boole\` verbs; you don't need them.
-- A commit is not done until \`boole strategy doctor\` confirms it. If it did not register, fix it before moving on.
+- \`boole ssh "<read-only cmd>"\` \u2014 cat / ls / pm2 list / curl localhost:3000/health
+
+## The hard lines (protect real money + tracking)
+- Place trades + strategies ONLY through the gate (\`boole strategy spawn\`). NEVER
+  write strategy files over SSH or \`pm2 start\` by hand \u2014 that bypasses tracking and
+  the order won't appear on the dashboard.
+- Never print or exfiltrate .env, keys, or credentials. Never restart the gateway.
+- Ask before genuinely destructive actions (closing positions, stopping a running
+  strategy). A plain market buy the user asked for is NOT destructive \u2014 place it.
 `;
 var FILES = ["CLAUDE.md", "AGENTS.md", "GEMINI.md"];
 function init(opts = {}) {
@@ -818,7 +844,7 @@ function init(opts = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.1";
 function parse(argv) {
   const _ = [];
   const flags = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boole-digital/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Boole — install, sign in, and operate your trading computer from the terminal (Claude Code, Codex, Gemini).",
   "type": "module",
   "bin": { "boole": "dist/index.js" },
@@ -8,7 +8,7 @@
   "files": ["dist/index.js", "README.md", "LICENSE"],
   "license": "SEE LICENSE IN LICENSE",
   "engines": { "node": ">=18" },
-  "repository": { "type": "git", "url": "github:Boole-Digital/portara-desktop" },
+  "repository": { "type": "git", "url": "git+https://github.com/Boole-Digital/portara-desktop.git" },
   "homepage": "https://trade.boole.markets",
   "publishConfig": { "access": "public" },
   "keywords": ["boole", "trading", "cli", "claude-code", "codex", "gemini"],