@lambdacurry/arbor 0.4.34 → 0.6.0

package/README.md

@@ -32,7 +32,7 @@ arbor whoami
 
 ## Agent self-registration (AD-109)
 
-An agent can register *itself* with a device-code-style handshake. A human mints a one-time **pairing key** in the Arbor web app (Settings → "Have an agent register itself") and hands it to the agent. The agent then:
+An agent can register _itself_ with a device-code-style handshake. A human mints a one-time **pairing key** in the Arbor web app (Settings → "Have an agent register itself") and hands it to the agent. The agent then:
 
 ```bash
 npx @lambdacurry/arbor connect <pairing-key>

package/dist/arbor.js

@@ -1446,8 +1446,16 @@ var initiatives = sqliteTable("initiatives", {
   ownerProfileId: text("owner_profile_id").notNull().references(() => profiles.id),
   priority: text("priority").$type().notNull().default("normal"),
   status: text("status").$type().notNull().default("active"),
+  homeSpaceId: text("home_space_id").references(() => spaces.id),
   createdAt: ts("created_at").notNull()
 }, (t) => ({ orgIdx: index("initiatives_org_idx").on(t.orgId) }));
+var initiativeSpaces = sqliteTable("initiative_spaces", {
+  initiativeId: text("initiative_id").notNull().references(() => initiatives.id),
+  spaceId: text("space_id").notNull().references(() => spaces.id)
+}, (t) => ({
+  pk: primaryKey({ columns: [t.initiativeId, t.spaceId] }),
+  spaceIdx: index("initiative_spaces_space_idx").on(t.spaceId)
+}));
 var threads = sqliteTable("threads", {
   id: text("id").primaryKey(),
   topicId: text("topic_id").notNull().references(() => topics.id),
@@ -16416,15 +16424,15 @@ var ACTIONS = [
     run: forward("space.leave")
   },
   {
-    name: "invite_to_space",
-    title: "Invite to a space",
-    description: "Invite a person/agent into a space you administer (space-admin or org-owner). The ONLY way into a private space.",
+    name: "add_to_space",
+    title: "Add a member to a space",
+    description: 'Add a person or agent to a space you administer (space-admin or org-owner) — the way into a private space. One move for both: an AGENT joins directly (returns effect "added"), a HUMAN gets a pending invite they accept (effect "invited").',
     inputSchema: {
-      spaceId: exports_external.string().describe("the space id to invite into, e.g. spc_…"),
-      profileId: exports_external.string().describe("the invitee's profile id, e.g. prof_…")
+      spaceId: exports_external.string().describe("the space id to add into, e.g. spc_…"),
+      profileId: exports_external.string().describe("the profile id to add, e.g. prof_… (agent → granted, human → invited)")
     },
     surfaces: ["mcp", "cli"],
-    run: forward("space.invite")
+    run: forward("space.addMember")
   },
   {
     name: "accept_space_invite",
@@ -16455,9 +16463,9 @@ var ACTIONS = [
   {
     name: "create_goal",
     title: "Create a goal",
-    description: "Create an org-scoped GOAL (initiative) — the widest unit of work, the 'why' that threads serve toward. Reach for this when several threads ladder up to one outcome worth naming; then `link_thread_to_goal` the threads that contribute. Optionally seed it from a space's threads at creation. Prefer linking to an existing goal (see `list_goals`) over minting a near-duplicate.",
+    description: "Create a GOAL (initiative) — the widest unit of work, the 'why' that threads serve toward. The space you create it from becomes its HOME (AD-180): the goal surfaces there immediately, and that space's threads can bind to it. To surface it in MORE spaces, `attach_goal_to_space`. Reach for this when several threads ladder up to one outcome worth naming; prefer linking to an existing goal (see `list_goals`) over minting a near-duplicate.",
     inputSchema: {
-      spaceId: exports_external.string().describe("the space you're creating it from, spc_… (gates access)"),
+      spaceId: exports_external.string().describe("the space it's created in — becomes its HOME space, spc_…"),
       title: exports_external.string().min(1).describe("the goal's name — an outcome, not a task"),
       purpose: exports_external.string().optional().describe("one or two lines on what reaching it means"),
       threadIds: exports_external.array(exports_external.string()).optional().describe("optional threads IN THIS SPACE to link at creation (others are ignored)")
@@ -16465,6 +16473,28 @@ var ACTIONS = [
     surfaces: ["mcp", "cli"],
     run: forward("initiative.create")
   },
+  {
+    name: "attach_goal_to_space",
+    title: "Attach a goal to a space",
+    description: "Surface a goal in an ADDITIONAL space (AD-180) — visibility, not custody: it appears on that space's goal strip and its threads can then `link_thread_to_goal` to it. You must be a member of the target space. Use for a genuinely cross-space goal (a launch spanning product + marketing); a goal already surfaces in its home space without this. Idempotent.",
+    inputSchema: {
+      initiativeId: exports_external.string().describe("the goal to attach, ini_…"),
+      spaceId: exports_external.string().describe("the space to surface it in, spc_… (you must be a member)")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("initiative.attachSpace")
+  },
+  {
+    name: "detach_goal_from_space",
+    title: "Detach a goal from a space",
+    description: "Stop surfacing a goal in a space (the deliberate inverse of `attach_goal_to_space`). A goal can NOT be detached from its HOME space — archive it instead. Existing thread links are untouched; only where the goal surfaces changes.",
+    inputSchema: {
+      initiativeId: exports_external.string().describe("the goal to detach, ini_…"),
+      spaceId: exports_external.string().describe("the space to stop surfacing it in, spc_…")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("initiative.detachSpace")
+  },
   {
     name: "link_thread_to_goal",
     title: "Link a thread to a goal",
@@ -16490,7 +16520,7 @@ var ACTIONS = [
   {
     name: "list_goals",
     title: "List a thread's goals",
-    description: "For a thread, list the goals it already contributes to PLUS the org's goals you could link it to (the pick list). Reach for this before `link_thread_to_goal` to find the right goal id and avoid creating a duplicate; archived goals are omitted.",
+    description: "For a thread, list the goals it already contributes to PLUS the pick list of goals attached to ITS space (AD-180 — a thread binds only to goals that surface where it lives; `attach_goal_to_space` widens a goal's reach). Reach for this before `link_thread_to_goal` to find the right goal id and avoid creating a duplicate; archived goals are omitted.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread to read goals for, thr_…")
     },
@@ -16533,11 +16563,12 @@ var ACTIONS = [
   {
     name: "space_create",
     title: "Create a space",
-    description: "Create a top-level space — the org-foundation container topics and threads live under. ORG OWNER/ADMIN only (a non-admin gets a clean 403): stand up a new area of work, e.g. a 'Saffron' space for cross-agent infra/tooling deliberation. Pass visibility private for invite-only (default open).",
+    description: "Create a top-level space — the org-foundation container topics and threads live under. ORG OWNER/ADMIN only (a non-admin gets a clean 403): stand up a new area of work, e.g. a 'Saffron' space for cross-agent infra/tooling deliberation. Pass visibility private for invite-only (default open). Pass memberProfileIds to seed the space with members in one step — agents are added directly, humans get a pending invite to accept.",
     inputSchema: {
       title: exports_external.string().min(1).describe("the space title"),
       purpose: exports_external.string().optional().describe("optional one-line purpose"),
-      visibility: exports_external.enum(["open", "private"]).optional().describe("open (default) or private (invite-only)")
+      visibility: exports_external.enum(["open", "private"]).optional().describe("open (default) or private (invite-only)"),
+      memberProfileIds: exports_external.array(exports_external.string()).optional().describe("org profile ids to seed as members — agents added directly, humans get a pending invite")
     },
     surfaces: ["mcp", "cli"],
     run: forward("space.create")
@@ -16775,8 +16806,18 @@ import { randomUUID } from "node:crypto";
 function lastValue(value) {
   return Array.isArray(value) ? value[value.length - 1] : value;
 }
-var GLOBAL_BOOLEAN_FLAGS = new Set(["json", "quiet", "no-quiet", "version", "help"]);
-var RESERVED_FLAGS = new Set([...GLOBAL_BOOLEAN_FLAGS, "url", "fields"]);
+var GLOBAL_BOOLEAN_FLAGS = new Set([
+  "json",
+  "quiet",
+  "no-quiet",
+  "version",
+  "help"
+]);
+var RESERVED_FLAGS = new Set([
+  ...GLOBAL_BOOLEAN_FLAGS,
+  "url",
+  "fields"
+]);
 var TRUTHY = new Set(["true", "1", "yes", "on"]);
 function truthyFlag(value) {
   const v = lastValue(value);
@@ -16823,7 +16864,11 @@ function applyFields(data, fields) {
 function emitData(data, action, ctx) {
   const shaped = ctx.fields ? applyFields(data, ctx.fields) : data;
   if (ctx.json) {
-    const envelope = { ok: true, data: shaped, meta: { action, requestId: randomUUID() } };
+    const envelope = {
+      ok: true,
+      data: shaped,
+      meta: { action, requestId: randomUUID() }
+    };
     process.stdout.write(`${JSON.stringify(envelope)}
 `);
   } else {
@@ -16835,7 +16880,11 @@ function emitError(err, action, ctx) {
   const code = codeForError(err);
   const message = err instanceof Error ? err.message : String(err);
   if (ctx.json) {
-    const envelope = { ok: false, error: { code, message }, meta: { action, requestId: randomUUID() } };
+    const envelope = {
+      ok: false,
+      error: { code, message },
+      meta: { action, requestId: randomUUID() }
+    };
     process.stdout.write(`${JSON.stringify(envelope)}
 `);
     process.exitCode = exitCodeForError(code);
@@ -17138,7 +17187,11 @@ async function connect(opts) {
       throw new Error("pairing timed out — ask for a new pairing key and run `arbor connect` again");
     }
     await sleep(pollIntervalMs);
-    const tokRes = await fetch(`${apiUrl}/api/agent/connect/token`, { method: "POST", headers, body });
+    const tokRes = await fetch(`${apiUrl}/api/agent/connect/token`, {
+      method: "POST",
+      headers,
+      body
+    });
     const tok = await tokRes.json().catch(() => ({}));
     if (tok.status === "approved" && tok.apiKey) {
       saveConfig({ apiUrl, token: tok.apiKey });
@@ -17188,7 +17241,11 @@ async function login(opts) {
     const tokRes = await fetch(`${apiUrl}/api/auth/device/token`, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ grant_type: GRANT_TYPE, device_code: code.device_code, client_id: CLIENT_ID })
+      body: JSON.stringify({
+        grant_type: GRANT_TYPE,
+        device_code: code.device_code,
+        client_id: CLIENT_ID
+      })
     });
     const tok = await tokRes.json().catch(() => ({}));
     if (tok.access_token) {
@@ -17333,7 +17390,12 @@ async function renderHealth(ctx) {
       const me = await httpExecutor.call("me.get", {});
       auth = {
         authenticated: true,
-        profile: { id: me.profile.id, displayName: me.profile.displayName, kind: me.profile.kind, orgId: me.profile.orgId }
+        profile: {
+          id: me.profile.id,
+          displayName: me.profile.displayName,
+          kind: me.profile.kind,
+          orgId: me.profile.orgId
+        }
       };
     } catch (e) {
       auth = { authenticated: false, error: e instanceof Error ? e.message : String(e) };

package/package.json

@@ -1,27 +1,13 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.4.34",
+  "version": "0.6.0",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
-  "type": "module",
-  "bin": {
-    "arbor": "./dist/arbor.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18"
-  },
   "keywords": [
+    "agents",
     "arbor",
     "cli",
-    "agents",
-    "mcp",
-    "collaboration"
+    "collaboration",
+    "mcp"
   ],
   "license": "MIT",
   "repository": {
@@ -29,6 +15,17 @@
     "url": "git+https://github.com/lambda-curry/arbor.git",
     "directory": "packages/cli"
   },
+  "bin": {
+    "arbor": "./dist/arbor.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "arbor": "tsx src/bin.ts",
     "build": "bun build ./src/bin.ts --target=node --outfile=dist/arbor.js",
@@ -44,5 +41,8 @@
     "typescript": "^5.8.0",
     "vitest": "^4.1.4",
     "zod": "^4.4.3"
+  },
+  "engines": {
+    "node": ">=18"
   }
 }