@lambdacurry/arbor 0.6.2 → 0.6.3

package/dist/arbor.js

@@ -16022,6 +16022,15 @@ Run \`arbor help\` (or read the MCP tool list) for the exact command/flags — t
 function forward(operation) {
   return (ex, input) => ex.call(operation, input);
 }
+function dispatch(map2) {
+  return (ex, input) => {
+    const { verb, ...rest } = input;
+    const op = verb ? map2[verb] : undefined;
+    if (!op)
+      return Promise.reject(new Error(`unknown verb "${verb ?? ""}" — expected one of: ${Object.keys(map2).join(" | ")}`));
+    return ex.call(op, rest);
+  };
+}
 var PAGINATION_INPUT = {
   limit: exports_external.number().int().min(1).optional().describe("max items to return — enables pagination"),
   cursor: exports_external.string().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)")
@@ -16040,6 +16049,7 @@ var ACTIONS = [
       includeHistorical: exports_external.boolean().optional().describe("include superseded/archived knowledge (default false)")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("knowledge.recall")
   },
   {
@@ -16060,6 +16070,7 @@ var ACTIONS = [
       links: exports_external.array(exports_external.object({ rel: exports_external.enum(CONTRIBUTION_LINK_RELS), targetId: exports_external.string() })).optional().describe("internal typed links: { rel, targetId } (same-space). External refs go IN THE BODY as URLs.")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("contribution.add")
   },
   {
@@ -16072,12 +16083,13 @@ var ACTIONS = [
       summary: exports_external.string().max(300).optional().describe("optional ≤300-char gist — omit to leave unchanged, empty string to clear")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("contribution.update")
   },
   {
     name: "stamp",
     title: "Stamp (review) a contribution",
-    description: "Vouch for or push back on someone else's contribution — neutral (omit facet+polarity) or signed (a facet + ▲/▽). Use this to register quality judgment with a 'why'; you cannot stamp your own, and re-stamping updates yours in place. A STAMP is also how you respond to a review request (AD-130): if `inbox`/a thread's open request tells you to stamp a contribution, do it here. The note is a MARKDOWN body (AD-143) — be as substantive as the review needs; you can @-mention people and reference other work with [[con_…]].",
+    description: "Vouch for or push back on someone ELSE's contribution — neutral, or a facet + ▲/▽ — with a why (markdown note; you can't stamp your own; re-stamping updates yours in place). A stamp is also HOW you answer a review request (AD-130)",
     inputSchema: {
       contributionId: exports_external.string().describe("the contribution id, e.g. con_…"),
       facetKey: exports_external.enum(STAMP_FACETS).optional().describe("quality|impact|fit|originality (omit for a neutral stamp)"),
@@ -16090,6 +16102,7 @@ var ACTIONS = [
       })).optional().describe("inline @-mentions in the note; person mentions notify")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("review.add")
   },
   {
@@ -16102,6 +16115,7 @@ var ACTIONS = [
       emoji: exports_external.string().min(1)
     },
     surfaces: ["mcp", "cli"],
+    tier: "extended",
     run: forward("reaction.toggle")
   },
   {
@@ -16114,6 +16128,7 @@ var ACTIONS = [
       purpose: exports_external.string().optional().describe("one line on what belongs here")
     },
     surfaces: ["mcp", "cli"],
+    tier: "extended",
     run: forward("topic.create")
   },
   {
@@ -16124,7 +16139,8 @@ var ACTIONS = [
       topicId: exports_external.string().describe("the topic, top_…"),
       guidance: exports_external.array(exports_external.string()).describe("the full guidance list — replaces the existing one; [] clears it")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("topic.update")
   },
   {
@@ -16138,6 +16154,7 @@ var ACTIONS = [
       objective: exports_external.string().min(1).describe("what settled/done looks like for this thread")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("thread.create")
   },
   {
@@ -16148,19 +16165,21 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the thread, thr_…"),
       waysToHelp: exports_external.array(exports_external.string()).describe("the full ways-to-help list — replaces the existing one; [] clears it")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("thread.update")
   },
   {
     name: "transition_thread",
     title: "Move a thread's lifecycle",
-    description: "Move a thread along its deliberate lifecycle (AD-068/159). The two CLOSED states are about the WORK, not curation: `resolved` = the deliberation reached its conclusion (done) — use this to close a thread you've settled; `archived` = retire/shelve it (e.g. opened in the wrong place — archive it, then open a fresh one where it belongs). Both drop out of normal recall and stay recoverable to `active`. You can also flag it `stuck`/`needs-review` while it's open. NOTE: a standout OUTPUT gets promoted (a \uD83C\uDF96️ contribution/artifact via `promote_contribution`) — the THREAD just resolves; don't look for a 'promote thread'. Illegal jumps are rejected.",
+    description: "Move a thread along its lifecycle (AD-068/159): `resolved` = the deliberation reached its conclusion; `archived` = retired / wrong place (both recoverable to `active`); `stuck`/`needs-review` flag an open thread. Threads RESOLVE — standout outputs get promoted via `curation`; there is no promote-thread. Illegal jumps are rejected",
     inputSchema: {
       threadId: exports_external.string().describe("the thread to move, thr_…"),
       to: exports_external.string().describe("target status: active|needs-review|stuck|resolved|archived"),
       reason: exports_external.string().optional().describe("optional one-line why, recorded on the event")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("thread.transition")
   },
   {
@@ -16175,7 +16194,8 @@ var ACTIONS = [
       sourceThreadId: exports_external.string().optional(),
       sourceContributionIds: exports_external.array(exports_external.string()).optional()
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("artifact.create")
   },
   {
@@ -16187,7 +16207,8 @@ var ACTIONS = [
       to: exports_external.string().describe("target status: active|promoted|needs-review|superseded|deprecated|archived|deleted"),
       reason: exports_external.string().optional()
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("artifact.transition")
   },
   {
@@ -16198,7 +16219,8 @@ var ACTIONS = [
       attachmentId: exports_external.string().describe("the uploaded attachment, att_…"),
       sourceContributionId: exports_external.string().describe("the contribution it's produced by, con_… (must share the attachment's thread)")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("attachment.promote")
   },
   {
@@ -16208,7 +16230,8 @@ var ACTIONS = [
     inputSchema: {
       contributionId: exports_external.string().describe("the contribution to promote, con_… (its thread + author are derived)")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("contribution.promote")
   },
   {
@@ -16218,7 +16241,8 @@ var ACTIONS = [
     inputSchema: {
       contributionId: exports_external.string().describe("the standout contribution to demote, con_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("contribution.demote")
   },
   {
@@ -16228,7 +16252,8 @@ var ACTIONS = [
     inputSchema: {
       contributionId: exports_external.string().describe("the contribution to remove, con_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("contribution.delete")
   },
   {
@@ -16238,13 +16263,14 @@ var ACTIONS = [
     inputSchema: {
       contributionId: exports_external.string().describe("the removed contribution to restore, con_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("contribution.restore")
   },
   {
     name: "request",
     title: "Request a contribution or review",
-    description: "Request input on a thread (AD-161). Two kinds, picked by `aboutContributionId`: OMIT it to request a CONTRIBUTION — new input on the thread (evidence, a proposal, a counter-argument, OR a decision/approval you need from someone), met by someone's `respond` contribution. PASS it to request a REVIEW of that specific contribution, met ONLY by a `stamp` on it. So when you want a prose answer or a yes/no decision, raise a CONTRIBUTION request (omit `aboutContributionId`) — do NOT wrap a decision as a review, because a review can only be answered by stamping, not by replying. Either way, name targets (an inbox item each) or leave it open (the thread board); completion is software-computed from their responses (first | quorum(n) | all-targets | deadline | explicit). Every request expires (default 14 days if you omit `expiresAt`), so nothing hangs forever.",
+    description: "Request input on a thread (AD-161). OMIT `aboutContributionId` to ask for a CONTRIBUTION — evidence, a proposal, or a decision you need — answered via `respond`. PASS it to ask for a REVIEW of that contribution — answered ONLY by a `stamp`, so never wrap a decision as a review. Name targets (an inbox item each) or leave it open; completion is software-computed (first | quorum | all-targets | deadline | explicit); every request expires (default 14 days)",
     inputSchema: {
       threadId: exports_external.string().describe("the thread the request is in, thr_…"),
       requestedAction: exports_external.string().optional().describe("a one-line 'what you're requesting'"),
@@ -16255,6 +16281,7 @@ var ACTIONS = [
       expiresAt: exports_external.string().optional().describe("ISO-8601 deadline (default: 14 days from creation, AD-167)")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("request.create")
   },
   {
@@ -16268,6 +16295,7 @@ var ACTIONS = [
       confidence: exports_external.number().int().min(0).max(100).optional()
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("request.respond")
   },
   {
@@ -16279,6 +16307,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the existing contribution that responds to it, con_…")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("request.bind")
   },
   {
@@ -16289,6 +16318,7 @@ var ACTIONS = [
       requestId: exports_external.string().describe("the open request to cancel, req_…")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("request.cancel")
   },
   {
@@ -16300,6 +16330,7 @@ var ACTIONS = [
       ...PAGINATION_INPUT
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("inbox.list")
   },
   {
@@ -16310,6 +16341,7 @@ var ACTIONS = [
       inboxItemId: exports_external.string().describe("the inbox item to dismiss, inb_…")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("inbox.dismiss")
   },
   {
@@ -16317,7 +16349,8 @@ var ACTIONS = [
     title: "List your notifications",
     description: "List the awareness feed of activity involving you — stamps on your work, replies in your threads, @-mentions, and your completed requests — newest first, with an unseen count. Each item carries a triage `class` (AD-182) derived from thread state: `settled-context` (thread resolved — durable context, never live work), `owed-by-me` (an open ask targets you — go to `inbox`, this row is just a pointer), `judgment-available` (your work was engaged in a live thread — an invitation, not an obligation), `closed-loop` (your ask completed), `room-motion` (ambient activity, safely skippable). This is FYI (no response owed); `inbox` remains the only obligation surface.",
     inputSchema: { ...PAGINATION_INPUT },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("notification.list")
   },
   {
@@ -16327,7 +16360,8 @@ var ACTIONS = [
     inputSchema: {
       notificationId: exports_external.string().describe("the notification id, ntf_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("notification.markRead")
   },
   {
@@ -16335,7 +16369,8 @@ var ACTIONS = [
     title: "Mark all notifications read",
     description: "Mark every unread notification in your feed read in one call; returns how many were cleared. Reach for this to zero out your awareness feed after a catch-up.",
     inputSchema: {},
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("notification.markAllRead")
   },
   {
@@ -16344,6 +16379,7 @@ var ACTIONS = [
     description: "Return your own Arbor identity (profile + source client) as resolved from your credential. Reach for this to confirm which profile and org you're acting as before you write.",
     inputSchema: {},
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("me.get")
   },
   {
@@ -16357,6 +16393,7 @@ var ACTIONS = [
       capabilities: exports_external.array(exports_external.string()).optional().describe("free-form skill tags (≤20, each ≤60 chars) for what you can do — e.g. ['market-research','data-viz']; how teammates route work to you. An empty array clears them.")
     },
     surfaces: ["mcp", "cli"],
+    tier: "extended",
     run: forward("me.update")
   },
   {
@@ -16368,7 +16405,8 @@ var ACTIONS = [
       charter: exports_external.string().describe("how they operate in this space; empty string clears it"),
       profileId: exports_external.string().optional().describe("admin override — set THIS member's charter instead of your own (org owner/admin only)")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.setCharter")
   },
   {
@@ -16381,18 +16419,20 @@ var ACTIONS = [
       contribCursor: exports_external.string().optional().describe("continuation cursor from a previous page's contributionPage.nextCursor")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("thread.get")
   },
   {
     name: "tree",
     title: "Navigate the workspace tree",
-    description: "Map the workspace — a GLANCEABLE structure map, not a full dump. By default (depth `topics`) you get your accessible spaces (purpose, governance stage) → their topics, plus a LIGHT roster (who's in each space by name/kind/role). Go DEEPER with the targeted reads, not by inflating the tree: `space_get` for a space's full roster + capabilities + charters, `topic_get` for a topic's threads, `thread_get` for a thread's contributions. Depths: `spaces` (just the spaces — lightest), `topics` (default — spaces + topics + light roster), `threads` (also expands each topic's threads with contribution counts, thread status, and open-request counts — `openRequestsForYou` answers \"does this space need me?\" without opening it, AD-182). Scope with space or topic to map just that subtree.",
+    description: 'Map the workspace — a GLANCEABLE structure map, not a dump. Depths: `spaces` | `topics` (default: spaces → topics + light roster) | `threads` (adds each topic\'s threads with status + open-request counts; `openRequestsForYou` answers "does this space need me?" — AD-182). Scope with space/topic; drill down with space_get/topic_get/thread_get instead of inflating the tree',
     inputSchema: {
       space: exports_external.string().optional().describe("scope to one space id (spc_…)"),
       topic: exports_external.string().optional().describe("scope to one topic id (top_…)"),
       depth: exports_external.enum(["spaces", "topics", "threads"]).optional().describe("how deep to expand: spaces (just spaces) | topics (default: + topics + light roster) | threads (+ each topic's threads). For one topic's threads or one thread's contributions, prefer topic_get / thread_get.")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("navigation.tree")
   },
   {
@@ -16401,6 +16441,7 @@ var ACTIONS = [
     description: "List everyone in your org — humans and agents — with their profile id, identity, role, and self-declared capabilities. Reach for this to find WHO to route work to: the profile id to @-mention in a contribution, or to target a `request` at a specific person (e.g. request a review from Meg). Read-only.",
     inputSchema: {},
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("org.members")
   },
   {
@@ -16410,7 +16451,8 @@ var ACTIONS = [
     inputSchema: {
       spaceId: exports_external.string().describe("the space id to join, e.g. spc_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.join")
   },
   {
@@ -16420,7 +16462,8 @@ var ACTIONS = [
     inputSchema: {
       spaceId: exports_external.string().describe("the space id to leave, e.g. spc_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.leave")
   },
   {
@@ -16431,7 +16474,8 @@ var ACTIONS = [
       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"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.addMember")
   },
   {
@@ -16441,7 +16485,8 @@ var ACTIONS = [
     inputSchema: {
       invitationId: exports_external.string().describe("the space invitation id, e.g. sinv_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.acceptInvite")
   },
   {
@@ -16449,7 +16494,8 @@ var ACTIONS = [
     title: "List open spaces",
     description: "Discover the OPEN spaces in your org you could join. Each is flagged with whether you're already a member; private spaces are never listed.",
     inputSchema: { ...PAGINATION_INPUT },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.listOpen")
   },
   {
@@ -16457,7 +16503,8 @@ var ACTIONS = [
     title: "List my space invitations",
     description: "List your pending space invitations to accept. Reach for this to find an invite, then `accept_space_invite` it.",
     inputSchema: { ...PAGINATION_INPUT },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("space.invites")
   },
   {
@@ -16470,7 +16517,8 @@ var ACTIONS = [
       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)")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.create")
   },
   {
@@ -16481,7 +16529,8 @@ var ACTIONS = [
       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"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.attachSpace")
   },
   {
@@ -16492,7 +16541,8 @@ var ACTIONS = [
       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"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.detachSpace")
   },
   {
@@ -16503,7 +16553,8 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the contributing thread, thr_…"),
       initiativeId: exports_external.string().describe("the goal it serves, ini_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.linkThread")
   },
   {
@@ -16514,7 +16565,8 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the thread to unlink, thr_…"),
       initiativeId: exports_external.string().describe("the goal to unlink it from, ini_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.unlinkThread")
   },
   {
@@ -16524,7 +16576,8 @@ var ACTIONS = [
     inputSchema: {
       threadId: exports_external.string().describe("the thread to read goals for, thr_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.forThread")
   },
   {
@@ -16536,7 +16589,8 @@ var ACTIONS = [
       title: exports_external.string().min(1).optional().describe("a new name — an outcome, not a task"),
       purpose: exports_external.string().optional().describe("a new one-or-two-line purpose")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.update")
   },
   {
@@ -16547,7 +16601,8 @@ var ACTIONS = [
       id: exports_external.string().describe("the goal, ini_…"),
       status: exports_external.enum(["active", "paused", "completed", "archived"]).describe("the new lifecycle state")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.setStatus")
   },
   {
@@ -16557,7 +16612,8 @@ var ACTIONS = [
     inputSchema: {
       id: exports_external.string().describe("the goal to delete, ini_…")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
+    tier: "extended",
     run: forward("initiative.delete")
   },
   {
@@ -16571,6 +16627,7 @@ var ACTIONS = [
       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"],
+    tier: "extended",
     run: forward("space.create")
   },
   {
@@ -16581,6 +16638,7 @@ var ACTIONS = [
       displayName: exports_external.string().min(1).describe("the agent's display name")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("agent.register")
   },
   {
@@ -16593,6 +16651,7 @@ var ACTIONS = [
       orgRole: exports_external.enum(["member", "admin"]).optional().describe("org role (default member)")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("human.invite")
   },
   {
@@ -16603,6 +16662,7 @@ var ACTIONS = [
       spaceId: exports_external.string().min(1).describe("the space id")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("space.get")
   },
   {
@@ -16613,6 +16673,7 @@ var ACTIONS = [
       topicId: exports_external.string().min(1).describe("the topic id")
     },
     surfaces: ["mcp", "cli"],
+    tier: "core",
     run: forward("topic.get")
   },
   {
@@ -16621,6 +16682,7 @@ var ACTIONS = [
     description: "Platform-operator only: list EVERY org on the instance with member + space counts. The entry point for cross-org oversight — start here, then dive into one with `admin org`.",
     inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("admin.listOrgs")
   },
   {
@@ -16631,6 +16693,7 @@ var ACTIONS = [
       orgId: exports_external.string().min(1).describe("the org id, e.g. org_…")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("admin.getOrg")
   },
   {
@@ -16641,6 +16704,7 @@ var ACTIONS = [
       spaceId: exports_external.string().min(1).describe("the space id, e.g. spc_…")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("admin.getSpace")
   },
   {
@@ -16651,6 +16715,7 @@ var ACTIONS = [
       topicId: exports_external.string().min(1).describe("the topic id, e.g. top_…")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("admin.getTopic")
   },
   {
@@ -16661,7 +16726,148 @@ var ACTIONS = [
       threadId: exports_external.string().min(1).describe("the thread id, e.g. thr_…")
     },
     surfaces: ["cli"],
+    tier: "extended",
     run: forward("admin.getThread")
+  },
+  {
+    name: "goal",
+    title: "Work with goals",
+    description: "GOALS (initiatives) — the wide 'why' threads serve toward (AD-146/180). verb=create (spaceId+title, optional purpose/threadIds — the creating space becomes its HOME), list (threadId — the goals that thread's space offers), update (id + title/purpose), set_status (id+status: active|paused|completed|archived — completed = reached, archived = retired from pick lists), delete (id), link_thread/unlink_thread (threadId+initiativeId), attach_space/detach_space (initiativeId+spaceId — surface a goal in MORE spaces).",
+    inputSchema: {
+      verb: exports_external.enum([
+        "create",
+        "list",
+        "update",
+        "set_status",
+        "delete",
+        "link_thread",
+        "unlink_thread",
+        "attach_space",
+        "detach_space"
+      ]).describe("which goal move to make"),
+      spaceId: exports_external.string().optional().describe("create: HOME space · attach/detach_space: the target space, spc_…"),
+      title: exports_external.string().optional().describe("create/update: the goal's name — an outcome, not a task"),
+      purpose: exports_external.string().optional().describe("create/update: one or two lines on what reaching it means"),
+      threadIds: exports_external.array(exports_external.string()).optional().describe("create: threads to link at birth"),
+      id: exports_external.string().optional().describe("update/set_status/delete: the goal, ini_…"),
+      status: exports_external.enum(["active", "paused", "completed", "archived"]).optional().describe("set_status: the new lifecycle state"),
+      threadId: exports_external.string().optional().describe("list/link_thread/unlink_thread: the thread, thr_…"),
+      initiativeId: exports_external.string().optional().describe("link/unlink/attach/detach: the goal, ini_…")
+    },
+    surfaces: ["mcp"],
+    tier: "extended",
+    run: dispatch({
+      create: "initiative.create",
+      list: "initiative.forThread",
+      update: "initiative.update",
+      set_status: "initiative.setStatus",
+      delete: "initiative.delete",
+      link_thread: "initiative.linkThread",
+      unlink_thread: "initiative.unlinkThread",
+      attach_space: "initiative.attachSpace",
+      detach_space: "initiative.detachSpace"
+    })
+  },
+  {
+    name: "membership",
+    title: "Space membership moves",
+    description: "Your space membership, in one tool. verb=join (an open space), leave, add_member (spaceId+profileId — an agent is added directly, a human gets an invite to accept, AD-177), accept_invite (invitationId), my_invites (your pending invites), list_open (spaces anyone in the org may join).",
+    inputSchema: {
+      verb: exports_external.enum(["join", "leave", "add_member", "accept_invite", "my_invites", "list_open"]).describe("which membership move to make"),
+      spaceId: exports_external.string().optional().describe("join/leave/add_member: the space, spc_…"),
+      profileId: exports_external.string().optional().describe("add_member: who to add, prof_…"),
+      invitationId: exports_external.string().optional().describe("accept_invite: the invitation, sinv_…")
+    },
+    surfaces: ["mcp"],
+    tier: "extended",
+    run: dispatch({
+      join: "space.join",
+      leave: "space.leave",
+      add_member: "space.addMember",
+      accept_invite: "space.acceptInvite",
+      my_invites: "space.invites",
+      list_open: "space.listOpen"
+    })
+  },
+  {
+    name: "notification",
+    title: "Your awareness feed",
+    description: "Awareness, never obligation (`inbox` is the only obligation surface). verb=list: activity involving you, newest first, each item carrying a triage `class` (AD-182): settled-context (thread resolved — context, not work) | owed-by-me (an open ask targets you — this row is a POINTER to inbox) | judgment-available (your work engaged in a live thread — an invitation) | closed-loop (your ask completed) | room-motion (safely skippable). verb=read (notificationId) clears one row; verb=read_all clears the feed.",
+    inputSchema: {
+      verb: exports_external.enum(["list", "read", "read_all"]).describe("list the feed, or clear one/all"),
+      notificationId: exports_external.string().optional().describe("read: the notification, ntf_…"),
+      ...PAGINATION_INPUT
+    },
+    surfaces: ["mcp"],
+    tier: "core",
+    run: dispatch({
+      list: "notification.list",
+      read: "notification.markRead",
+      read_all: "notification.markAllRead"
+    })
+  },
+  {
+    name: "curation",
+    title: "Curate the record",
+    description: "Curation moves on a contribution (all take contributionId). verb=promote (mark it a \uD83C\uDF96️ standout — sparingly: promotion is curation, not applause, AD-140), demote (remove the mark), delete (soft-remove), restore (bring a removed one back).",
+    inputSchema: {
+      verb: exports_external.enum(["promote", "demote", "delete", "restore"]).describe("which curation move"),
+      contributionId: exports_external.string().describe("the contribution, con_…")
+    },
+    surfaces: ["mcp"],
+    tier: "extended",
+    run: dispatch({
+      promote: "contribution.promote",
+      demote: "contribution.demote",
+      delete: "contribution.delete",
+      restore: "contribution.restore"
+    })
+  },
+  {
+    name: "artifact",
+    title: "Durable artifacts",
+    description: "Durable, lifecycle-managed artifacts. verb=create (title+contentRef, optional summary/sourceThreadId/sourceContributionIds), transition (artifactId + to: active|promoted|needs-review|superseded|deprecated|archived|deleted — the state machine guards jumps and retrieval tier follows), promote_attachment (attachmentId — lift an uploaded file into an artifact).",
+    inputSchema: {
+      verb: exports_external.enum(["create", "transition", "promote_attachment"]).describe("which artifact move"),
+      title: exports_external.string().optional().describe("create: the artifact's title"),
+      contentRef: exports_external.string().optional().describe("create: where the content lives, e.g. inline://… or a URL"),
+      summary: exports_external.string().optional().describe("create: a short summary"),
+      sourceThreadId: exports_external.string().optional().describe("create: the thread it came from"),
+      sourceContributionIds: exports_external.array(exports_external.string()).optional().describe("create: contributions it distills"),
+      artifactId: exports_external.string().optional().describe("transition: the artifact, art_…"),
+      to: exports_external.string().optional().describe("transition: the target status"),
+      reason: exports_external.string().optional().describe("transition: why"),
+      attachmentId: exports_external.string().optional().describe("promote_attachment: the upload, att_…")
+    },
+    surfaces: ["mcp"],
+    tier: "extended",
+    run: dispatch({
+      create: "artifact.create",
+      transition: "artifact.transition",
+      promote_attachment: "attachment.promote"
+    })
+  },
+  {
+    name: "charter",
+    title: "Set the guidance surfaces",
+    description: "The guidance you WRITE (read back via space_get/topic_get/thread_get). verb=space_charter (spaceId+charter — how YOU operate in this space, AD-152; org admins may pass profileId to bootstrap another member's), topic_guidance (topicId+guidance[] — the topic's soft norms, replaces the list, [] clears), ways_to_help (threadId+waysToHelp[] — a thread's curated pitch-in list; guidance, never obligation — obligations are `request`).",
+    inputSchema: {
+      verb: exports_external.enum(["space_charter", "topic_guidance", "ways_to_help"]).describe("which guidance surface to set"),
+      spaceId: exports_external.string().optional().describe("space_charter: the space, spc_…"),
+      charter: exports_external.string().optional().describe("space_charter: the text; empty string clears"),
+      profileId: exports_external.string().optional().describe("space_charter admin override: whose charter"),
+      topicId: exports_external.string().optional().describe("topic_guidance: the topic, top_…"),
+      guidance: exports_external.array(exports_external.string()).optional().describe("topic_guidance: full list, replaces; [] clears"),
+      threadId: exports_external.string().optional().describe("ways_to_help: the thread, thr_…"),
+      waysToHelp: exports_external.array(exports_external.string()).optional().describe("ways_to_help: full list, replaces; [] clears")
+    },
+    surfaces: ["mcp"],
+    tier: "extended",
+    run: dispatch({
+      space_charter: "space.setCharter",
+      topic_guidance: "topic.update",
+      ways_to_help: "thread.update"
+    })
   }
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "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",