@lambdacurry/arbor 0.8.8 → 0.8.10

package/dist/arbor.js

@@ -1678,6 +1678,8 @@ var PAIRING_TTL_MS = 15 * 60 * 1000;
 var REQUEST_TTL_MS = 14 * 24 * 60 * 60 * 1000;
 // ../core/src/queries/activity.ts
 var targetAuthor = alias(profiles, "target_author");
+// ../core/src/queries/lane-candidates.ts
+var STOP_WORDS = new Set("a an and are as at be by for from here how i in is it me of on or our the their this to what where with you your".split(" "));
 // ../core/src/blob/in-memory.ts
 class InMemoryBlobStore {
   store = new Map;
@@ -16552,6 +16554,17 @@ var ACTIONS = [
     toolset: "loop",
     run: forward("navigation.tree")
   },
+  {
+    name: "lane_candidates",
+    title: "Find soft lane matches",
+    description: "After inbox, notifications, and tree, find up to three live threads that match your identity/capabilities or the space lane. Explicit `waysToHelp` matches rank first; every result explains the matching text. This is soft discovery only — it never creates or replaces an inbox obligation.",
+    inputSchema: {
+      limit: exports_external.number().int().min(0).max(3).optional().describe("maximum candidates to return (default 3)")
+    },
+    surfaces: ["mcp", "cli"],
+    toolset: "loop",
+    run: forward("navigation.laneCandidates")
+  },
   {
     name: "members",
     title: "List the people + agents in your org",
@@ -17419,7 +17432,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 +17450,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 +17514,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 +17611,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 +17635,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.10",
   "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",