@boole-digital/cli 0.2.5 → 0.3.1

package/dist/index.js

@@ -685,6 +685,28 @@ function open(s) {
     });
   });
 }
+async function runRemote(command) {
+  const s = requireSession();
+  const conn = await open(s);
+  try {
+    return await new Promise((resolve2, reject) => {
+      conn.exec(command, (err2, stream) => {
+        if (err2) return reject(new Error(friendly(err2)));
+        let stdout = "";
+        let stderr = "";
+        stream.on("close", (code) => resolve2({ code: code ?? 0, stdout, stderr }));
+        stream.on("data", (d) => {
+          stdout += d.toString();
+        });
+        stream.stderr.on("data", (d) => {
+          stderr += d.toString();
+        });
+      });
+    });
+  } finally {
+    conn.end();
+  }
+}
 async function runRemoteInherit(command) {
   const s = requireSession();
   const conn = await open(s);
@@ -721,6 +743,20 @@ here.
    \`\`\`
 3. Operate the box exactly as that guide says.
 
+## Building anything non-trivial? PLAN FIRST.
+Before you hand-write a strategy, spawn a template, or spelunk the box for *how* to
+do something, ask the harness how to build it:
+\`\`\`
+boole plan "<the user's request, in plain English>"
+\`\`\`
+The harness holds the full picture \u2014 system prompt, tools, the real trading surface \u2014
+that you CANNOT see from the outside. \`boole plan\` returns a concrete implementation
+plan: the exact \`ti.*\` calls + signatures, file paths, and which template/gate to use,
+grounded in what THIS box actually exposes. Follow it, then implement over \`boole ssh\`.
+Do NOT guess API shapes, web-search, or hunt through template files \u2014 planning replaces
+that. (If the box's gateway is older and doesn't support planning, \`boole plan\` will
+say so \u2014 fall back to \`OPERATOR.md\`.)
+
 ## The model
 - The box IS the gateway. You SSH into it with \`boole ssh\` and drive its **harness**.
 - You take the user's request **in plain English** ("buy $100 of BTC") and carry
@@ -765,8 +801,53 @@ function init(opts = {}) {
   log(`  Your agent reads these rules and operates your trading computer through ${c.cyan("boole")}.`);
 }
 
+// src/plan.ts
+async function plan({ request }) {
+  const req = (request || "").trim();
+  if (!req) die('Usage: boole plan "<what you want to build>"');
+  if (req.length > 4e3) die("Request too long (max 4000 chars). Trim it down.");
+  info("Asking your box how to build this \u2014 the harness has the full picture (this can take up to a minute)\u2026");
+  const payload = Buffer.from(JSON.stringify({ request: req })).toString("base64");
+  const MARK = "__BOOLE_HTTP__";
+  const cmd = `printf %s '${payload}' | base64 -d | curl -s --max-time 175 -w '\\n${MARK}%{http_code}' -X POST http://localhost:3000/api/plan -H 'content-type: application/json' -d @-`;
+  const { code, stdout, stderr } = await runRemote(cmd);
+  if (!stdout) die(`Could not reach the planner on your box${code ? ` (exit ${code})` : ""}. ${stderr || ""}`.trim());
+  let body = stdout, http = 0;
+  const mi = stdout.lastIndexOf(MARK);
+  if (mi >= 0) {
+    body = stdout.slice(0, mi).trimEnd();
+    http = parseInt(stdout.slice(mi + MARK.length), 10) || 0;
+  }
+  if (http === 404) {
+    die("This box's gateway doesn't support planning yet (no /api/plan). Update the gateway to a build that includes it, or build directly with `boole ssh`.");
+  }
+  let res;
+  try {
+    res = JSON.parse(body);
+  } catch {
+    die(`Planner returned an unexpected response${http ? ` (HTTP ${http})` : ""}: ${body.slice(0, 300) || stderr || "empty"}`);
+  }
+  if (res?.error) die(`Planner error: ${res.error}`);
+  const planText = String(res?.plan || "").trim();
+  if (!planText) die("Planner returned no plan. Try again in a moment.");
+  if (res?.degraded) {
+    log();
+    warn(c.bold("Your Boole account is out of credit \u2014 this plan came from a fallback model."));
+    log(c.yellow("  Boole does not consider this model capable of this planning task; treat the plan below with caution."));
+    log(c.yellow("  To restore full-quality planning, either:"));
+    log(c.yellow("    \u2022 top up a small amount of credit, or"));
+    log(c.yellow("    \u2022 connect your GPT account for subscription-based usage."));
+    log(c.yellow(`  Do this in the Boole web app under ${c.bold("Usage & model settings")} (/usage).`));
+  }
+  log();
+  log(planText);
+  log();
+  info("Build it over SSH exactly as above \u2014 the paths + calls are the ones your box actually exposes.");
+  if (res?.model) log(c.dim(`  planner model: ${res.model}${res?.degraded ? " (fallback)" : ""}`));
+}
+
 // src/index.ts
-var VERSION = "0.2.5";
+var VERSION = "0.3.1";
 function parse(argv) {
   const _ = [];
   const flags = {};
@@ -803,6 +884,7 @@ ${c.bold("Getting started")}
   logout                   Sign out and clear the cached session
 
 ${c.bold("Operate the box")}
+  plan "<goal>"            Ask the box's harness how to build something (returns an implementation plan)
   ssh "<command>"          Run a command on the connected box (this is how you operate it)
   logs [name]              Tail a strategy's logs
   balances [--venue <v>]   Equity + open positions
@@ -858,6 +940,9 @@ async function main() {
     case "init":
       init({ dir: _[1], force: !!flags.force });
       break;
+    case "plan":
+      await plan({ request: _.slice(1).join(" ") });
+      break;
     case "ssh": {
       const command = _.slice(1).join(" ");
       if (!command) die('Usage: boole ssh "<command>"');

package/package.json

@@ -1,17 +1,37 @@
 {
   "name": "@boole-digital/cli",
-  "version": "0.2.5",
-  "description": "Boole — install, sign in, and operate your trading computer from the terminal (Claude Code, Codex, Gemini).",
+  "version": "0.3.1",
+  "description": "Boole \u2014 install, sign in, and operate your trading computer from the terminal (Claude Code, Codex, Gemini).",
   "type": "module",
-  "bin": { "boole": "dist/index.js" },
+  "bin": {
+    "boole": "dist/index.js"
+  },
   "main": "dist/index.js",
-  "files": ["dist/index.js", "README.md", "LICENSE"],
+  "files": [
+    "dist/index.js",
+    "README.md",
+    "LICENSE"
+  ],
   "license": "SEE LICENSE IN LICENSE",
-  "engines": { "node": ">=18" },
-  "repository": { "type": "git", "url": "git+https://github.com/Boole-Digital/portara-desktop.git" },
+  "engines": {
+    "node": ">=18"
+  },
+  "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"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "boole",
+    "trading",
+    "cli",
+    "claude-code",
+    "codex",
+    "gemini"
+  ],
   "dependencies": {
     "ssh2": "^1.16.0"
   },