@lambdacurry/arbor 0.21.56 → 0.21.58

package/dist/arbor.js

@@ -16,7 +16,7 @@ var __export = (target, all) => {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.21.56",
+  version: "0.21.58",
   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",
@@ -18037,6 +18037,12 @@ var MCP_OUTPUT_SCHEMAS = {
     purpose: nullableString.optional()
   }),
   create_thread: exports_external.looseObject({ threadId: id }),
+  thread_update: exports_external.looseObject({
+    id,
+    title: exports_external.string().optional(),
+    objective: exports_external.string().optional(),
+    topicId: exports_external.string().optional()
+  }),
   set_organization_computer: exports_external.looseObject({ config: computerConfigLayer.nullable() }),
   set_space_computer: exports_external.looseObject({ config: computerConfigLayer.nullable() }),
   set_topic_computer: exports_external.looseObject({ config: computerConfigLayer.nullable() }),
@@ -19045,6 +19051,7 @@ var MCP_TOOL_ANNOTATIONS = {
   create_topic: additive,
   topic_update: additive,
   create_thread: additive,
+  thread_update: additive,
   set_organization_computer: destructiveIdempotent,
   set_space_computer: destructiveIdempotent,
   set_topic_computer: destructiveIdempotent,
@@ -19672,11 +19679,11 @@ var ACTION_DEFINITIONS = [
   {
     name: "create_topic",
     title: "Create a topic",
-    description: "Open a durable Topic in a Space only when a sub-area needs multiple Threads; check tree first so structure stays scarce. Read Ways of working (`/ways-of-working.md`), then make the Topic contract clear in purpose, guidance, and lanes: operating role, scope, external or split truth, default Thread recipes, and handoffs.",
+    description: "Create a Topic for a durable sub-area that will hold multiple Threads (check tree first so structure stays scarce); otherwise keep the work in a Thread. Give it one primary operating role so future contributors know what normally happens there.",
     inputSchema: {
       spaceId: exports_external.string().describe("the space to create the topic in, spc_…"),
       title: exports_external.string().min(1).describe("the topic's name — an area of work, not a question"),
-      purpose: exports_external.string().optional().describe("one line on what belongs here")
+      purpose: exports_external.string().optional().describe("what this Topic accomplishes and what belongs here, leading with its primary role — Direction, Delivery, Operations, Intake, Coordination, or Learning; name an external or split source of truth or a handoff boundary only when it materially matters")
     },
     surfaces: ["mcp", "cli"],
     toolset: "structure",
@@ -19689,7 +19696,7 @@ var ACTION_DEFINITIONS = [
     inputSchema: {
       topicId: exports_external.string().describe("the topic to edit, top_…"),
       title: exports_external.string().min(1).optional().describe("a new title — an area of work, not a question"),
-      purpose: exports_external.string().optional().describe("a new one-line purpose — what belongs here")
+      purpose: exports_external.string().optional().describe("a new purpose — what this Topic accomplishes and what belongs here, leading with its primary role (Direction, Delivery, Operations, Intake, Coordination, or Learning); name an external or split source of truth or a handoff boundary only when it materially matters")
     },
     surfaces: ["mcp", "cli"],
     toolset: "spaces",
@@ -19698,7 +19705,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "set_topic_guidance",
     title: "Set a topic's guidance",
-    description: "Set a topic's SOFT guidance — the local how-we-work norms for this topic (culture/quality, AD-063), e.g. 'recall before re-deriving', 'one typed point per contribution'. Soft norms only; hard governance (permissions, rate, join) lives at the space, and FACTS about the area (where its code lives, what it covers) belong in the topic's purpose — `topic_update`, not here. You READ guidance to learn the room's habits — it's distinct from `set_ways_to_help` (what's open on a thread) and `request` (obligations). Replaces the whole list; pass [] to clear. Read Ways of working (`/ways-of-working.md`) before writing so the guidance supports the Topic's operating role and contract.",
+    description: "Set a topic's SOFT guidance — the local how-we-work norms for this topic (culture/quality, AD-063), e.g. 'recall before re-deriving', 'one typed point per contribution'. Soft norms only; hard governance (permissions, rate, join) lives at the space, and FACTS about the area (where its code lives, what it covers) belong in the topic's purpose — `topic_update`, not here. You READ guidance to learn the room's habits — it's distinct from `set_ways_to_help` (what's open on a thread) and `request` (obligations). Replaces the whole list; pass [] to clear.",
     inputSchema: {
       topicId: exports_external.string().describe("the topic, top_…"),
       guidance: proseList("the full guidance list — replaces the existing one; [] clears it")
@@ -19710,7 +19717,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "set_space_guidance",
     title: "Set a space's guidance",
-    description: "Set a SPACE's SOFT guidance — the how-we-work-here norms for the whole space (culture/quality, AD-062/063), e.g. 'recall before re-deriving', 'promote the standout, sparingly'. Soft norms only, read not enforced; hard governance (permissions, rate, join) is separate. Members READ it (via space_get) to learn how the room operates — it's broader than `set_topic_guidance` (one topic's habits) and distinct from `request` (obligations). Replaces the whole list; pass [] to clear. Read Ways of working (`/ways-of-working.md`) before writing so the guidance supports the Space boundary and work modes.",
+    description: "Set a SPACE's SOFT guidance — the how-we-work-here norms for the whole space (culture/quality, AD-062/063), e.g. 'recall before re-deriving', 'promote the standout, sparingly'. Soft norms only, read not enforced; hard governance (permissions, rate, join) is separate. Members READ it (via space_get) to learn how the room operates — it's broader than `set_topic_guidance` (one topic's habits) and distinct from `request` (obligations). Replaces the whole list; pass [] to clear.",
     inputSchema: {
       spaceId: exports_external.string().describe("the space, spc_…"),
       guidance: proseList("the full guidance list — replaces the existing one; [] clears it")
@@ -19746,17 +19753,31 @@ var ACTION_DEFINITIONS = [
   {
     name: "create_thread",
     title: "Open a thread",
-    description: "Open a new deliberation Thread under a Topic when the objective does not fit an existing Thread; name it by the question or outcome to settle, not status. Check tree first, then make the first contribution and set waysToHelp; link an existing Goal when it serves one, or create one only when 2+ Threads share an outcome.",
+    description: "Open a Thread for one focused unit of work that does not fit an existing Thread (check tree first), then make the first contribution and set waysToHelp; link an existing Goal when it serves one, or create one only when 2+ Threads share an outcome. Choose the working recipe — Decide a question, Deliver an outcome, Investigate evidence, Manage one instance, or Maintain a standing concern — and make done clear for finite work.",
     inputSchema: {
       spaceId: exports_external.string().describe("the space, spc_…"),
       topicId: exports_external.string().describe("the topic to file it under, top_…"),
-      title: exports_external.string().min(1).describe("the thread title — the question/objective, not a status"),
-      objective: exports_external.string().min(1).describe("what settled/done looks like for this thread")
+      title: exports_external.string().min(1).describe("name the question, outcome, investigation, instance, or standing concern — not a status"),
+      objective: exports_external.string().min(1).describe("what this Thread should accomplish; for finite work, state what done means")
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
     run: forward("thread.create")
   },
+  {
+    name: "thread_update",
+    title: "Edit a thread's title, objective, or topic",
+    description: "Correct a Thread's title or objective, or move it under another Topic of the same Space, patching only supplied fields; use it to make done clear or refile misfiled work instead of archiving and reopening. Status moves stay with `transition_thread`, and the temporary help list with `charter` ways_to_help.",
+    inputSchema: {
+      threadId: exports_external.string().describe("the thread to edit, thr_…"),
+      title: exports_external.string().min(1).optional().describe("a new title — the question, outcome, investigation, instance, or standing concern"),
+      objective: exports_external.string().min(1).optional().describe("a new objective — what this Thread should accomplish; for finite work, what done means"),
+      topicId: exports_external.string().optional().describe("move the thread under this topic of the same space, top_…")
+    },
+    surfaces: ["mcp", "cli"],
+    toolset: "loop",
+    run: forward("thread.setConfig")
+  },
   {
     name: "set_organization_computer",
     title: "Replace organization computer defaults",
@@ -20216,7 +20237,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "transition_thread",
     title: "Move a thread's lifecycle",
-    description: "Move a Thread among active, needs-review, stuck, standing, resolved, or archived with an optional reason; illegal lifecycle jumps are rejected. Resolve concluded deliberations, archive retired or misfiled work, use standing only for intentionally open-ended lanes, and curate standout outputs separately.",
+    description: "Move a Thread among active, needs-review, stuck, standing, resolved, or archived with an optional reason; illegal lifecycle jumps are rejected. Resolve finite Decide/Deliver/Investigate/Manage work once its outcome is in, archive retired work (refile misfiled work with `thread_update` instead), use standing only for intentionally open-ended concerns, and curate standout outputs separately.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread to move, thr_…"),
       to: exports_external.string().describe("target status: active|needs-review|stuck|standing|resolved|archived"),
@@ -20776,10 +20797,10 @@ var ACTION_DEFINITIONS = [
   {
     name: "space_create",
     title: "Create a space",
-    description: "Create a top-level Space for a new collaboration area — open/private visibility plus optional seeded members (agents join directly, humans get invites); you become its first admin. Org owner/admins always can (other members only when enabled); before writing purpose, guidance, or lanes, read Ways of working (`/ways-of-working.md`) and describe the boundary shape, work modes, governance, and Topic strategy in the normal object fields.",
+    description: "Create a Space when work needs its own durable collaboration/governance boundary — its own membership, visibility, shared norms, and multiple durable areas; you become its first admin (org owner/admins always can, other members only when enabled), with open/private visibility and optional seeded members. If the work can live under an existing Space with the same people and governance, use a Topic instead.",
     inputSchema: {
       title: exports_external.string().min(1).describe("the space title"),
-      purpose: exports_external.string().optional().describe("optional one-line purpose"),
+      purpose: exports_external.string().optional().describe("why this boundary exists and what it is around — commonly a Product/System, Program/Function, Portfolio/Network, or Practice/Community — plus its dominant work modes (Build, Operate, Coordinate, Discuss, Share) when that helps; plain prose, not metadata syntax"),
       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")
     },
@@ -20793,7 +20814,7 @@ var ACTION_DEFINITIONS = [
     description: "Edit a Space's purpose, title, or visibility; org owner/admin or that Space's admin only, and only supplied fields are patched. Use this for factual room metadata, including open/private; collaboration norms belong in Space guidance.",
     inputSchema: {
       spaceId: exports_external.string().describe("the space, spc_…"),
-      purpose: exports_external.string().optional().describe("one-line purpose — what this space is about"),
+      purpose: exports_external.string().optional().describe("why this boundary exists and what it is around — commonly a Product/System, Program/Function, Portfolio/Network, or Practice/Community — plus its dominant work modes (Build, Operate, Coordinate, Discuss, Share) when that helps; plain prose, not metadata syntax"),
       title: exports_external.string().optional().describe("a new title for the space"),
       visibility: exports_external.enum(["open", "private"]).optional().describe("open or private (invite-only)")
     },
@@ -21637,7 +21658,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "charter",
     title: "Set the guidance surfaces",
-    description: "Write collaboration guidance: space_charter for a member's per-Space operating charter, space/topic guidance for shared norms, space/topic lanes for durable contribution lanes, or ways_to_help for one Thread's temporary help list. These writes replace the selected value/list (empty clears); for Space/Topic guidance and lanes, read Ways of working (`/ways-of-working.md`) first so they support that object's operating contract.",
+    description: "Write collaboration guidance: space_charter for a member's per-Space operating charter, space/topic guidance for durable how-we-work-here norms, space/topic lanes for the durable kinds of help welcome there, or ways_to_help for one Thread's temporary needs. Each write replaces the selected value/list (empty clears).",
     inputSchema: {
       verb: exports_external.enum([
         "space_charter",
@@ -22849,7 +22870,12 @@ var KNOWN_MISREACHES = [
   { tried: "topics", use: "tree --depth topics", why: "topics are a tree depth" },
   { tried: "search", use: "recall <query>", why: "recall is the search surface" },
   { tried: "update topic", use: "topic update --topic-id top_…", why: "this command is noun-verb" },
-  { tried: "update space", use: "space update --space-id spc_…", why: "this command is noun-verb" }
+  { tried: "update space", use: "space update --space-id spc_…", why: "this command is noun-verb" },
+  {
+    tried: "update thread",
+    use: "thread update --thread-id thr_…",
+    why: "this command is noun-verb"
+  }
 ];
 function familyHelp(positionals) {
   if (positionals.length !== 1)

package/package.json

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