@lambdacurry/arbor 0.8.8 → 0.8.9

package/dist/arbor.js

@@ -17419,7 +17419,8 @@ function flagsForSchema(inputSchema) {
     };
   });
 }
-function buildInput(inputSchema, flags) {
+function buildInput(inputSchema, flags, command) {
+  const primary = primaryPositionalField(inputSchema);
   const input = {};
   for (const spec of flagsForSchema(inputSchema)) {
     if (spec.kind === "string") {
@@ -17436,8 +17437,10 @@ function buildInput(inputSchema, flags) {
     }
     const raw = flags[spec.flag];
     if (raw === undefined) {
-      if (spec.required)
-        throw new UsageError(`missing required flag: --${spec.flag}`);
+      if (spec.required) {
+        const positional = primary && primary.field === spec.field && command ? ` — or pass it as the argument: arbor ${command} <${primary.field}>` : "";
+        throw new UsageError(`missing required flag: --${spec.flag}${positional}`);
+      }
       continue;
     }
     if (spec.kind !== "boolean" && raw === true) {
@@ -17498,6 +17501,29 @@ function commandWords(action) {
 var CLI_ACTIONS = ACTIONS.filter((a) => a.surfaces.includes("cli"));
 var BY_COMMAND = new Map(CLI_ACTIONS.map((a) => [commandWords(a), a]));
 var MAX_WORDS = Math.max(1, ...CLI_ACTIONS.map((a) => commandWords(a).split(" ").length));
+var KNOWN_MISREACHES = [
+  { tried: "thread list", use: "tree --depth threads", why: "threads are listed by the tree" },
+  { tried: "threads", use: "tree --depth threads", why: "threads are listed by the tree" },
+  { tried: "list threads", use: "tree --depth threads", why: "threads are listed by the tree" },
+  { tried: "spaces", use: "tree", why: "the tree lists spaces" },
+  { tried: "space list", use: "tree", why: "the tree lists spaces" },
+  { tried: "topics", use: "tree --depth topics", why: "topics are a tree depth" },
+  { tried: "search", use: "recall <query>", why: "recall is the search surface" }
+];
+function suggestCommand(positionals) {
+  const typed = positionals.join(" ").toLowerCase();
+  const known = KNOWN_MISREACHES.find((m) => m.tried === typed);
+  if (known)
+    return `use \`arbor ${known.use}\` — ${known.why}`;
+  const head = positionals[0]?.toLowerCase();
+  if (head) {
+    const siblings = CLI_ACTIONS.map(commandWords).filter((c) => c === head || c.startsWith(`${head} `)).sort();
+    if (siblings.length > 0) {
+      return `\`${head}\` commands: ${siblings.slice(0, 8).join(", ")}${siblings.length > 8 ? ", …" : ""}`;
+    }
+  }
+  return "run `arbor help` for the command list";
+}
 function matchCommand(positionals) {
   for (let n = Math.min(MAX_WORDS, positionals.length);n >= 1; n--) {
     const key = positionals.slice(0, n).join(" ");
@@ -17572,8 +17598,10 @@ function commandCatalog() {
 }
 async function runObjectVerb(positionals, flags, ctx) {
   const match = matchCommand(positionals);
-  if (!match)
-    throw new UsageError(`unknown command: ${positionals.join(" ") || "(none)"}`);
+  if (!match) {
+    const typed = positionals.join(" ") || "(none)";
+    throw new UsageError(`unknown command: ${typed} — ${suggestCommand(positionals)}`);
+  }
   const { action, words } = match;
   const extras = positionals.slice(words);
   if (extras.length > 0) {
@@ -17594,7 +17622,7 @@ async function runObjectVerb(positionals, flags, ctx) {
   if (unknown2.length > 0) {
     throw new UsageError(`unknown flag${unknown2.length > 1 ? "s" : ""}: ${unknown2.map((f) => `--${f}`).join(", ")}`);
   }
-  const input = buildInput(action.inputSchema, flags);
+  const input = buildInput(action.inputSchema, flags, commandWords(action));
   if (action.name === "agent_register") {
     advise(`Agent registered. Save its apiKey now — it is shown only once:
 `, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",