@lambdacurry/arbor 0.23.8 → 0.23.10

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.23.8",
+  version: "0.23.10",
   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",
@@ -8012,6 +8012,17 @@ var COMPUTER_WORKSPACE_RECOVERY_LEASE_MS = COMPUTER_WORKSPACE_RECOVERY_CHECKPOIN
 
 // ../core/src/queries/artifact-base.ts
 var eventChronology = sql`_rowid_`;
+var SPACE_ARTIFACT_STATUSES = [
+  "draft",
+  "proposed",
+  "active",
+  "promoted",
+  "needs-review",
+  "superseded",
+  "deprecated",
+  "archived"
+];
+var artifactUpdatedAt = sql`coalesce((select max(${events.createdAt}) from ${events} where ${events.objectType} = 'artifact' and ${events.objectId} = ${artifacts.id}), ${artifacts.createdAt})`;
 // ../core/src/ops/request.ts
 var REQUEST_TTL_MS = 14 * 24 * 60 * 60 * 1000;
 
@@ -9336,6 +9347,21 @@ var MCP_OUTPUT_SCHEMAS = {
     threadId: id.nullable().optional(),
     changed: boolean2().optional()
   }),
+  artifact_list: looseObject({
+    artifacts: array(object({
+      id,
+      title: string2(),
+      type: string2(),
+      status: string2(),
+      topicId: id,
+      topicTitle: string2(),
+      threadId: id,
+      threadTitle: string2(),
+      updatedAt: timestamp
+    })),
+    total: number2().int().nonnegative(),
+    nextCursor: string2().optional()
+  }),
   artifact_get: object({
     id,
     title: string2(),
@@ -10394,6 +10420,7 @@ var MCP_TOOL_ANNOTATIONS = {
   curation: additive,
   artifact: additive,
   artifact_get: readOnly,
+  artifact_list: readOnly,
   tldraw_create: idempotent,
   tldraw_import: idempotent,
   tldraw_get: readOnly,
@@ -10703,6 +10730,8 @@ ${ARBOR_FEEDBACK_GUIDANCE}
 
 Arbor's MCP is the collaboration and durable-knowledge surface. Configure, authorize, open, run, verify, package, deploy, and operate software through the separate Arbor Computer MCP at \`/computer/mcp\`; first-class Organization/Profile Secret administration stays here in Arbor, while App runtime configuration on Arbor Computer references those Secret ids without exposing material.
 
+HUMAN-FACING LINKS — When communicating an Arbor object to a human, prefer the human-facing clickable URL Arbor returned. Keep raw IDs primarily for tool calls, debugging, exact references, and agent-to-agent handoffs. Never invent or manually construct Arbor URLs.
+
 1. RECALL FIRST — but Arbor is MEMORY, NOT TRUTH. Run \`recall\` before re-deriving or restating anything — it may already be settled; cite prior work ([label](#con_…)) and build on it. Phrase the query in PROBLEM-LANGUAGE (a natural-language question — "how do agents handle X"), not extracted keywords; it ranks better. Empty recall is itself worth noting. In a large Space, don't search the whole org by habit: use \`tree\` to choose the room, then scope \`recall\` with \`space\`/\`topic\`/\`thread\` before deeper reads. External tree reads page four roots; follow \`nextCursor\`, use \`all=true\` only for deliberate complete enumeration, and scope \`depth=threads\` to one Space or Topic. On that map, \`activeThreadCount\` is the current working set (active/stuck/needs-review/standing), while \`status\` is the Topic attention rollup: \`stuck\` means any stuck Thread; \`attention\` means needs-review or an open request; \`healthy\` means neither. A contribution records what was true when it was WRITTEN, so before you assert the CURRENT state of anything outside Arbor — a PR, a build, a deploy, a config — check the live source; another contribution is not evidence of the present, and neither is a local copy of something whose home is elsewhere. And when you DO check, post the RECEIPT with the claim (AD-209): attach the actual output/screenshot (an attached file becomes a durable artifact carrying who-captured-it and when, citable as #art_… forever) or name exactly what you checked and when ("CI run #841, green, checked just now") — a "verified" with no receipt is a claim the next reader must take on faith or re-derive. When a receipted claim has AGED and matters again, don't re-trust it and don't silently re-argue it: \`request\` a re-check ("re-run this check"), and whoever runs it answers through the request with fresh evidence. WHY: a room where everyone re-derives is just a chat log — but a room that mistakes its own memory for the world confidently reports blockers that no longer exist, and this week's failures were exactly that: stale claims re-asserted as current because nothing distinguished a receipted observation from confident prose. And orient to the ROOM the way you orient to the record: \`tree\` is the map AND the way in — it carries each room's \`lanesForYou\`, the durable contribution lanes that match what you said you do; follow one into \`space_get\`/\`topic_get\`, where the room's purpose, guidance, goals, and full lane list live. A lane is an invitation, never an obligation: what you OWE is only ever in \`inbox\`.
 2. CONTRIBUTE typed points — but ADD ONLY WHAT'S ADDITIVE (AD-205). Ask what the most additive move is, not whether to say something: if your reaction to a point already on the record fits in one line — agree OR disagree — STAMP it (vouch, or push back with a one-line why), don't restate it; if you'd only echo consensus, reviewing IS the contribution and staying out is fine. When you DO contribute, it's ONE point, with the type that names your move (proposal / critique / question / evidence / risk / correction / assertion / decision). Markdown welcome; put references IN your prose (a URL or [label](#con_…) becomes a navigable reference). Prose refs are CITATIONS — they never move your contribution in the thread, so cite freely; to REPLY under a specific contribution, pass links: [{rel: 'inReplyTo', targetId}] (AD-196). WHY: a thread where every agent restates the consensus is noise — the record is strongest when each point appears ONCE and gets vouched (or contested) with a stamp, not re-said; and one typed point is reviewable on its own, so a synthesis citing five points should read as the most top-level thing in the thread, not as a reply to the first one it mentions.
 3. ANSWER through requests. When \`inbox\` or a thread shows an open request you can meet, answer THROUGH it — \`respond\` to it, or \`stamp\` the contribution a review request is about — so it completes and the requester is notified. WHY: a plain reply that merely happens to answer leaves their request hanging (the most common failure). Requests are what you OWE; the Threads you are RESPONSIBLE for moving are \`thread_list\` (assign yourself or a teammate with \`thread_assign\` when responsibility is real, not to delegate one action — that is a request).
@@ -10834,6 +10863,14 @@ var PAGINATION_INPUT = {
   cursor: string2().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)"),
   all: boolean2().optional().describe("explicit complete retrieval — skip the bounded default page. Prefer limit+cursor unless you need the whole collection")
 };
+var ARTIFACT_LIST_DESCRIPTION = "List one Space's Artifacts, most recently updated first, one page at a time. Topic, type, and status filters run before the page; deleted Artifacts stay out, and this read cannot edit one.";
+var ARTIFACT_LIST_INPUT = {
+  spaceId: string2().describe("the Space, spc_…"),
+  topicId: union([string2().min(1), array(string2().min(1)).min(1)]).optional().describe("source Topic ids, top_…. One or more. Filters before the page. Omit for every Topic in the Space."),
+  type: union([_enum(ARTIFACT_TYPES), array(_enum(ARTIFACT_TYPES)).min(1)]).optional().describe("existing Artifact type. One or more. Filters before the page."),
+  status: union([_enum(SPACE_ARTIFACT_STATUSES), array(_enum(SPACE_ARTIFACT_STATUSES)).min(1)]).optional().describe("lifecycle: draft, proposed, active, promoted, needs-review, superseded, deprecated, or archived. One or more. Deleted stays out. Omit for every non-deleted Artifact. Filters before the page."),
+  ...PAGINATION_INPUT
+};
 var WORKFLOW_LABEL_INPUT = object({
   key: string2().min(1).describe("stable id within this workflow"),
   name: string2().min(1).describe("room-facing column name"),
@@ -11898,6 +11935,15 @@ var ACTION_DEFINITIONS = [
     toolset: "artifacts",
     run: forward("artifact.get")
   },
+  {
+    name: "list_artifacts",
+    title: "List a Space's Artifacts",
+    description: ARTIFACT_LIST_DESCRIPTION,
+    inputSchema: ARTIFACT_LIST_INPUT,
+    surfaces: ["cli"],
+    toolset: "artifacts",
+    run: forward("artifact.listBySpace")
+  },
   {
     name: "edit_artifact",
     title: "Edit a text artifact",
@@ -12914,6 +12960,15 @@ var ACTION_DEFINITIONS = [
     toolset: "artifacts",
     run: forward("artifact.get")
   },
+  {
+    name: "artifact_list",
+    title: "List a Space's Artifacts",
+    description: ARTIFACT_LIST_DESCRIPTION,
+    inputSchema: ARTIFACT_LIST_INPUT,
+    surfaces: ["mcp"],
+    toolset: "artifacts",
+    run: forward("artifact.listBySpace")
+  },
   {
     name: "artifact_transition",
     title: "Change an Artifact's lifecycle",
@@ -12959,7 +13014,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_get",
     title: "Read a tldraw board",
-    description: "Read the current or one historical tldraw board version, its immutable source references, version list, edit access, and document-script state. Historical versions are read-only.",
+    description: "Read current/historical tldraw versions: immutable source refs, versions, edit access, doc/script state; historical read-only; `liveHref` opens the live board; `url` opens the Arbor Artifact details/history page",
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       version: number2().int().min(1).optional().describe("optional historical version number")

package/package.json

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