@boole-digital/cli 0.3.0 → 0.3.1

package/dist/index.js

@@ -743,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
@@ -794,14 +808,24 @@ async function plan({ request }) {
   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 cmd = `printf %s '${payload}' | base64 -d | curl -s --max-time 175 -X POST http://localhost:3000/api/plan -H 'content-type: application/json' -d @-`;
+  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(stdout);
+    res = JSON.parse(body);
   } catch {
-    die(`Planner returned an unexpected response: ${stdout.slice(0, 300) || stderr || "empty"}`);
+    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();
@@ -823,7 +847,7 @@ async function plan({ request }) {
 }
 
 // src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.3.1";
 function parse(argv) {
   const _ = [];
   const flags = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boole-digital/cli",
-  "version": "0.3.0",
+  "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": {