@lambdacurry/arbor 0.21.56 → 0.21.57

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.57",
   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",
@@ -19672,11 +19672,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",
@@ -19698,7 +19698,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 +19710,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,12 +19746,12 @@ 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",
@@ -20776,10 +20776,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")
     },
@@ -21637,7 +21637,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",

package/package.json

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