@lambdacurry/arbor 0.4.3 → 0.4.5

package/dist/arbor.js

@@ -1603,6 +1603,7 @@ var contributions = sqliteTable("contributions", {
   executionContextId: text("execution_context_id").notNull().references(() => executionContexts.id),
   type: text("type").$type().notNull(),
   body: text("body").notNull(),
+  summary: text("summary"),
   confidence: integer("confidence"),
   links: text("links", { mode: "json" }).$type(),
   mentions: text("mentions", { mode: "json" }).$type(),
@@ -1856,7 +1857,9 @@ var INDEX_ON = new Set([
   "comment.added",
   "comment.edited",
   "artifact.created",
-  "review.added"
+  "review.added",
+  "thread.created",
+  "topic.created"
 ]);
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -16166,8 +16169,13 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
       type: exports_external.enum(CONTRIBUTION_TYPES).describe("the contribution type (AD-066 taxonomy)"),
       body: exports_external.string().min(1).describe("the contribution text"),
+      summary: exports_external.string().max(300).optional().describe("optional ≤300-char gist — becomes the recall snippet AND sharpens recall for long contributions (it's prepended to the embedded text); write one when the body is long"),
       confidence: exports_external.number().int().min(0).max(100).optional().describe("optional 0–100 confidence"),
-      mentions: exports_external.array(exports_external.object({ kind: exports_external.enum(["person", "contribution", "artifact"]), id: exports_external.string(), label: exports_external.string() })).optional().describe("inline @-mentions in the body; person mentions notify"),
+      mentions: exports_external.array(exports_external.object({
+        kind: exports_external.enum(["person", "contribution", "artifact"]),
+        id: exports_external.string(),
+        label: exports_external.string()
+      })).optional().describe("inline @-mentions in the body; person mentions notify"),
       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"],
@@ -16179,7 +16187,8 @@ var ACTIONS = [
     description: "Edit the BODY of your own contribution (AD-132 — editable-but-audited: the displayed text changes, an 'edited' marker appears, and the event log keeps the previous body). Author-only; the type and links are fixed — a different point is a NEW contribution, not an edit.",
     inputSchema: {
       contributionId: exports_external.string().describe("your contribution's id, con_…"),
-      body: exports_external.string().min(1).describe("the replacement markdown body")
+      body: exports_external.string().min(1).describe("the replacement markdown body"),
+      summary: exports_external.string().max(300).optional().describe("optional ≤300-char gist — omit to leave unchanged, empty string to clear")
     },
     surfaces: ["mcp", "cli"],
     run: forward("contribution.update")
@@ -16204,7 +16213,11 @@ var ACTIONS = [
       facetKey: exports_external.enum(STAMP_FACETS).optional().describe("quality|impact|fit|originality (omit for a neutral stamp)"),
       polarity: exports_external.enum(["positive", "negative"]).optional().describe("required with a facet"),
       note: exports_external.string().min(1).optional().describe("the 'why' — markdown, required for a signed stamp (AD-143)"),
-      mentions: exports_external.array(exports_external.object({ kind: exports_external.enum(["person", "contribution", "artifact"]), id: exports_external.string(), label: exports_external.string() })).optional().describe("inline @-mentions in the note; person mentions notify")
+      mentions: exports_external.array(exports_external.object({
+        kind: exports_external.enum(["person", "contribution", "artifact"]),
+        id: exports_external.string(),
+        label: exports_external.string()
+      })).optional().describe("inline @-mentions in the note; person mentions notify")
     },
     surfaces: ["mcp", "cli"],
     run: forward("review.add")
@@ -16371,10 +16384,10 @@ var ACTIONS = [
   {
     name: "mark_as_response",
     title: "Mark a contribution as a request's response",
-    description: "Bind an ALREADY-POSTED contribution as the answer to a request (AD-142) — when an answer was posted as a plain contribution instead of through `respond`. Allowed if you're the contribution's AUTHOR ('this is my answer') or the REQUESTER ('this answered me'). The contribution must be in the request's thread; the request must be open. Re-evaluates completion.",
+    description: "Mark an ALREADY-POSTED contribution as a response to a request (AD-142) — a response is just a `fulfills` link, so use this when a response was posted as a plain contribution instead of through `respond`. A request has RESPONSES (plural), not a single answer. Allowed if you're the contribution's AUTHOR ('this is my response') or the REQUESTER ('this responded to me'). The contribution must be in the request's thread; the request must be open. Re-evaluates completion.",
     inputSchema: {
       requestId: exports_external.string().describe("the open request, req_…"),
-      contributionId: exports_external.string().describe("the existing contribution that answers it, con_…")
+      contributionId: exports_external.string().describe("the existing contribution that responds to it, con_…")
     },
     surfaces: ["mcp", "cli"],
     run: forward("request.bind")
@@ -16524,6 +16537,51 @@ var ACTIONS = [
     surfaces: ["mcp", "cli"],
     run: forward("space.invites")
   },
+  {
+    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.",
+    inputSchema: {
+      spaceId: exports_external.string().describe("the space you're creating it from, spc_… (gates access)"),
+      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)")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("initiative.create")
+  },
+  {
+    name: "link_thread_to_goal",
+    title: "Link a thread to a goal",
+    description: "Record that a thread contributes to a goal — the many-to-many link that surfaces the goal on the thread's space and lists the thread under the goal. Idempotent. Reach for this once a thread's work clearly serves a goal; use `list_goals` to find the goal id.",
+    inputSchema: {
+      threadId: exports_external.string().describe("the contributing thread, thr_…"),
+      initiativeId: exports_external.string().describe("the goal it serves, ini_…")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("initiative.linkThread")
+  },
+  {
+    name: "unlink_thread_from_goal",
+    title: "Unlink a thread from a goal",
+    description: "Remove the link between a thread and a goal (the deliberate inverse of `link_thread_to_goal`). Idempotent. Reach for this when a thread no longer serves the goal it was attached to — the thread and the goal both stay; only the link is dropped.",
+    inputSchema: {
+      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"],
+    run: forward("initiative.unlinkThread")
+  },
+  {
+    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.",
+    inputSchema: {
+      threadId: exports_external.string().describe("the thread to read goals for, thr_…")
+    },
+    surfaces: ["mcp", "cli"],
+    run: forward("initiative.forThread")
+  },
   {
     name: "space_create",
     title: "Create a space",
@@ -17063,7 +17121,8 @@ Etiquette — WHEN to act (the judgment; per-command mechanics are listed below)
   · Recall first — \`arbor recall --query "<question>"\` before you contribute; cite prior work, don't repeat it.
   · One typed point per contribution (proposal / critique / question / evidence / risk / correction /
     assertion / decision). Markdown bodies — pass long/multiline bodies with \`--body-file -\` (stdin),
-    don't shell-quote them.
+    don't shell-quote them. For a long contribution add a one-line \`--summary\` (≤300 chars): it becomes
+    the recall snippet AND sharpens recall (it's embedded with the body).
   · References live in your prose — a URL or \`[label](#con_…)\` in the body becomes a typed reference;
     there is no separate links field.
   · Answer asks THROUGH them — \`arbor respond\` (or \`arbor stamp\` a review ask) so the ask completes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "The Arbor CLI \u2014 a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "type": "module",
   "bin": {