@lambdacurry/arbor 0.6.5 → 0.7.0

package/dist/arbor.js

@@ -1345,6 +1345,7 @@ var profiles = sqliteTable("profiles", {
   color: text("color").$type(),
   emoji: text("emoji"),
   description: text("description"),
+  notificationPrefs: text("notification_prefs", { mode: "json" }).$type(),
   createdAt: ts("created_at").notNull()
 }, (t) => ({ orgIdx: index("profiles_org_idx").on(t.orgId) }));
 var clients = sqliteTable("clients", {
@@ -1560,12 +1561,28 @@ var artifacts = sqliteTable("artifacts", {
   supersedes: text("supersedes", { mode: "json" }).$type(),
   supersededBy: text("superseded_by", { mode: "json" }).$type(),
   reviewAfter: ts("review_after"),
-  createdAt: ts("created_at").notNull()
+  createdAt: ts("created_at").notNull(),
+  kind: text("kind").$type().notNull().default("file"),
+  source: text("source"),
+  version: integer("version").notNull().default(0),
+  editPolicy: text("edit_policy").$type().notNull().default("members")
 }, (t) => ({
   statusIdx: index("artifacts_status_idx").on(t.status),
   tierIdx: index("artifacts_tier_idx").on(t.retrievalTier),
   ownerIdx: index("artifacts_owner_idx").on(t.ownerProfileId)
 }));
+var artifactVersions = sqliteTable("artifact_versions", {
+  id: text("id").primaryKey(),
+  artifactId: text("artifact_id").notNull().references(() => artifacts.id),
+  version: integer("version").notNull(),
+  source: text("source").notNull(),
+  editorProfileId: text("editor_profile_id").notNull().references(() => profiles.id),
+  executionContextId: text("execution_context_id").references(() => executionContexts.id),
+  note: text("note"),
+  createdAt: ts("created_at").notNull()
+}, (t) => ({
+  artifactVersionUq: uniqueIndex("artifact_versions_artifact_version_uq").on(t.artifactId, t.version)
+}));
 var requests = sqliteTable("requests", {
   id: text("id").primaryKey(),
   threadId: text("thread_id").notNull().references(() => threads.id),
@@ -1624,9 +1641,11 @@ var notifications = sqliteTable("notifications", {
   groupKey: text("group_key"),
   actors: text("actors", { mode: "json" }).$type().notNull().default([]),
   readAt: ts("read_at"),
+  emailedAt: ts("emailed_at"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   recipientIdx: index("notifications_recipient_idx").on(t.recipientProfileId, t.readAt),
+  emailIdx: index("notifications_emailed_idx").on(t.emailedAt),
   groupIdx: uniqueIndex("notifications_group_key_uniq").on(t.groupKey)
 }));
 var notificationCursors = sqliteTable("notification_cursors", {
@@ -1729,6 +1748,7 @@ var INDEX_ON = new Set([
   "contribution.added",
   "contribution.edited",
   "artifact.created",
+  "artifact.edited",
   "review.added",
   "thread.created",
   "topic.created"
@@ -16012,24 +16032,25 @@ config(en_default());
 // ../actions/src/index.ts
 var ORIENTATION = `Arbor is your team's deliberation room and shared memory — people and agents settle typed work here, and Arbor remembers what's decided. To work well:
 
-1. RECALL FIRST. 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. WHY: a room where everyone re-derives is just a chat log.
-2. CONTRIBUTE typed points — ONE point per contribution, 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 — there's no separate links field). WHY: one typed point is reviewable on its own.
+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. 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. 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.
+2. CONTRIBUTE typed points — ONE point per contribution, 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: one typed point is reviewable on its own, and 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).
-4. REVIEW honestly; promote the standout, sparingly. \`stamp\` to vouch or push back with a one-line why (you can't stamp your own work — request a review via \`request\`). PROMOTE a contribution/artifact only when it's the standout the org should find FIRST (the \uD83C\uDF96️). WHY: promotion is curation, not applause — and it's about an OUTPUT, never a whole thread (a thread RESOLVES; it is never "promoted").
+4. REVIEW honestly; promote the standout, sparingly. \`stamp\` to vouch or push back with a one-line why (you can't stamp your own work — request a review via \`request\`). PROMOTE a contribution/artifact only when it's the standout the org should find FIRST (the \uD83C\uDF96️). One deliberate exception (AD-200): in a STANDING thread, periodically promoting a distilling synthesis IS the job — it's how an open-forever lane compresses for newcomers and recall, not applause inflation; promoting your own synthesis there is fine (only stamps bar self-review). WHY: promotion is curation, not applause — and it's about an OUTPUT, never a whole thread (a thread RESOLVES; it is never "promoted").
 5. EDIT, don't repost. \`edit\` your own contribution to sharpen it; the record stays audited. A genuinely different point is a NEW contribution.
-6. FIT STRUCTURE TO THE WORK — one thread settles one objective, one topic holds one area — and CLOSE it when done. Before adding to a thread, ask whether your point serves ITS objective or starts a new one: a genuinely new question deserves its own thread (check \`tree\`, name it by its objective, make the first contribution); a distinct area that's accumulating threads deserves its own topic. When a thread reaches its conclusion, \`transition_thread --to resolved\`; opened in the wrong place → \`--to archived\` and reopen where it belongs. WHY: structure should mirror the work so each thread settles one findable question — a thread crammed with many objectives is as unreadable as a litter of one-off topics, and open threads no one closes bury the live ones.
+6. FIT STRUCTURE TO THE WORK — one thread settles one objective, one topic holds one area — and CLOSE it when done. Before adding to a thread, ask whether your point serves ITS objective or starts a new one: a genuinely new question deserves its own thread (check \`tree\`, name it by its objective, make the first contribution); a distinct area that's accumulating threads deserves its own topic. When a thread reaches its conclusion, \`transition_thread --to resolved\`; opened in the wrong place → \`--to archived\` and reopen where it belongs. A thread DESIGNED to stay open — a journal, ops log, or standing lane — is \`--to standing\` (AD-200): it is never owed a conclusion, and its distillation is PROMOTION (\uD83C\uDF96️ a synthesis), not closure; "close it when done" applies to deliberations, not standing lanes. CLOSING IS MEMBER WORK: any member of the space can resolve a thread whose objective is met — you do not need its author's permission, and you do not need to be the one who did the work. Asking a human to perform the close is not deference; it is an open thread with extra steps. If the objective is met, close it and say why. WHY: structure should mirror the work so each thread settles one findable question — a thread crammed with many objectives is as unreadable as a litter of one-off topics, and open threads no one closes bury the live ones.
+7. ACT, THEN REPORT — escalate by exception (AD-197). Before routing a decision to a human, do the CHEAP CHECK that would let you act yourself — the registry lookup, the live-state read, the policy check; the blocker is usually fictional. Then: recoverable + conclusive evidence → act and say why. Recoverable but uncertain → state your intent WITH a deadline ("resolving Thursday unless someone objects") and act at the deadline. Irreversible, outward-facing, or a genuine taste/priority call → escalate; that's what humans are for. Reversibility is the test you can always answer in the moment — a wrong resolve costs one click to undo (\`resolved\` → \`active\`), while waiting costs days. WHY: a room where every met condition waits for a human keystroke makes the human the bottleneck and the agents decorative at exactly the moments they're most useful.
 
 Run \`arbor help\` (or read the MCP tool list) for the exact command/flags — those stay generated from the live action surface, so they're always current.`;
 function forward(operation) {
   return (ex, input) => ex.call(operation, input);
 }
-function dispatch(map2) {
+function dispatch(map2, reshape) {
   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);
+    return ex.call(op, reshape && verb ? reshape(verb, rest) : rest);
   };
 }
 var PAGINATION_INPUT = {
@@ -16050,13 +16071,13 @@ var ACTIONS = [
       includeHistorical: exports_external.boolean().optional().describe("include superseded/archived knowledge (default false)")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("knowledge.recall")
   },
   {
     name: "contribute",
     title: "Contribute to a thread",
-    description: "Add your own typed contribution (proposal/critique/question/evidence/…) — ONE point per contribution, on the record. RECALL FIRST (recalling beats re-deriving), and put references IN THE BODY: URLs and inline [label](#con_…) refs become typed reference edges + smart pills automatically.",
+    description: "Add your own typed contribution (proposal/critique/question/evidence/…) — ONE point per contribution, on the record. RECALL FIRST (recalling beats re-deriving), and put references IN THE BODY: URLs and inline [label](#con_…) refs become typed reference edges + smart pills automatically. Body refs are CITATIONS (AD-196) — they never change where your contribution sits in the thread, so cite freely. To thread your contribution UNDER a specific one (a reply), pass links: [{rel: 'inReplyTo', targetId}] — that deliberate edge is what nests it.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
       type: exports_external.enum(CONTRIBUTION_TYPES).describe("the contribution type (AD-066 taxonomy)"),
@@ -16068,23 +16089,23 @@ var ACTIONS = [
         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.")
+      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) — a DELIBERATE edge: inReplyTo/contests nests your contribution under the target (AD-196); body refs never do. External refs go IN THE BODY as URLs.")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("contribution.add")
   },
   {
     name: "edit",
     title: "Edit your contribution",
-    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.",
+    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 DELIBERATE links (reply edges, fulfills) are fixed — body-borne prose refs follow the edited body: a [label](#con_…) you edit in gains its citation edge, one you edit out drops it (AD-196). 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"),
       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",
+    toolset: "loop",
     run: forward("contribution.update")
   },
   {
@@ -16103,7 +16124,7 @@ var ACTIONS = [
       })).optional().describe("inline @-mentions in the note; person mentions notify")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("review.add")
   },
   {
@@ -16116,7 +16137,7 @@ var ACTIONS = [
       emoji: exports_external.string().min(1)
     },
     surfaces: ["mcp", "cli"],
-    tier: "extended",
+    toolset: "loop",
     run: forward("reaction.toggle")
   },
   {
@@ -16129,7 +16150,7 @@ var ACTIONS = [
       purpose: exports_external.string().optional().describe("one line on what belongs here")
     },
     surfaces: ["mcp", "cli"],
-    tier: "extended",
+    toolset: "structure",
     run: forward("topic.create")
   },
   {
@@ -16141,7 +16162,7 @@ var ACTIONS = [
       guidance: exports_external.array(exports_external.string()).describe("the full guidance list — replaces the existing one; [] clears it")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("topic.update")
   },
   {
@@ -16155,7 +16176,7 @@ var ACTIONS = [
       objective: exports_external.string().min(1).describe("what settled/done looks like for this thread")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("thread.create")
   },
   {
@@ -16167,38 +16188,71 @@ var ACTIONS = [
       waysToHelp: exports_external.array(exports_external.string()).describe("the full ways-to-help list — replaces the existing one; [] clears it")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("thread.update")
   },
   {
     name: "transition_thread",
     title: "Move a thread's lifecycle",
-    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",
+    description: "Move a thread along its lifecycle (AD-068/159/200): `resolved` = the deliberation reached its conclusion; `archived` = retired / wrong place (both recoverable to `active`); `stuck`/`needs-review` flag an open thread; `standing` = DESIGNED to stay open (a journal, ops log, or standing lane — never owed a conclusion; distill with promotions instead of closing). 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"),
+      to: exports_external.string().describe("target status: active|needs-review|stuck|standing|resolved|archived"),
       reason: exports_external.string().optional().describe("optional one-line why, recorded on the event")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("thread.transition")
   },
   {
     name: "create_artifact",
     title: "Create an artifact",
-    description: "Promote durable output — a decision, summary, plan, or research brief — into a first-class artifact you own. Reach for this when a thread has produced something worth retaining and citing beyond the conversation; its retrieval tier follows its status.",
+    description: "Promote durable output — a decision, summary, plan, or research brief — into a first-class artifact you own. Text kinds (doc/table/diagram/html) are living documents: pass `source` (born at v1, editable in place via edit_artifact); kind=file passes a contentRef instead. Reach for this when a thread has produced something worth retaining and citing beyond the conversation.",
     inputSchema: {
-      type: exports_external.string().describe("artifact type, e.g. decision|summary|plan|markdown|concept|research-brief"),
+      type: exports_external.string().describe("semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
+      kind: exports_external.enum(["doc", "table", "diagram", "html", "file"]).optional().describe("structural kind (default file). doc/table/diagram/html are editable, versioned text"),
       title: exports_external.string().min(1),
-      contentRef: exports_external.string().min(1).describe("where the content lives, e.g. inline://… or a URL"),
+      source: exports_external.string().optional().describe("text kinds: the initial content (v1)"),
+      contentRef: exports_external.string().optional().describe("kind=file: where the content lives, e.g. inline://… or a URL"),
+      editPolicy: exports_external.enum(["owner", "members", "anyone"]).optional().describe("who may edit (default members)"),
       summary: exports_external.string().optional(),
       sourceThreadId: exports_external.string().optional(),
       sourceContributionIds: exports_external.array(exports_external.string()).optional()
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "artifacts",
     run: forward("artifact.create")
   },
+  {
+    name: "get_artifact",
+    title: "Read an artifact",
+    description: "Read an artifact: current source + version + history (who edited, via what). READ BEFORE YOU EDIT — the version you read is the baseVersion your edit must name. Pass --version to read an old snapshot.",
+    inputSchema: {
+      artifactId: exports_external.string().describe("the artifact, art_…"),
+      version: exports_external.number().optional().describe("read this old snapshot instead of the current")
+    },
+    surfaces: ["cli"],
+    toolset: "artifacts",
+    run: forward("artifact.get")
+  },
+  {
+    name: "edit_artifact",
+    title: "Edit a text artifact",
+    description: `Edit a text-backed artifact (doc/table/diagram/html) in place. Read it first (get_artifact) and pass baseVersion = the version you read. Either --source (full replace) or --patches '[{"old":…,"new":…}]' (exact-match hunks, applied in order, ATOMIC — all land or none; one call mints ONE version, so batch related row-edits into one call). A stale baseVersion returns ok:false with the current source — reconcile and retry; a failed patch names the culprit index.`,
+    inputSchema: {
+      artifactId: exports_external.string().describe("the artifact, art_…"),
+      baseVersion: exports_external.number().describe("the version you READ (get_artifact) — stale is rejected"),
+      source: exports_external.string().optional().describe("full replace: the complete new content"),
+      patches: exports_external.array(exports_external.object({ old: exports_external.string(), new: exports_external.string() })).optional().describe("exact-match hunks applied in order; each old must match exactly once"),
+      note: exports_external.string().optional().describe("one-line summary of what changed")
+    },
+    surfaces: ["cli"],
+    toolset: "artifacts",
+    run: (ex, input) => ex.call("artifact.edit", {
+      ...input,
+      verb: Array.isArray(input.patches) ? "patch" : "replace"
+    })
+  },
   {
     name: "transition_artifact",
     title: "Transition an artifact's lifecycle",
@@ -16209,7 +16263,7 @@ var ACTIONS = [
       reason: exports_external.string().optional()
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "artifacts",
     run: forward("artifact.transition")
   },
   {
@@ -16221,18 +16275,18 @@ var ACTIONS = [
       sourceContributionId: exports_external.string().describe("the contribution it's produced by, con_… (must share the attachment's thread)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "artifacts",
     run: forward("attachment.promote")
   },
   {
     name: "promote_contribution",
     title: "Promote a contribution to a \uD83C\uDF96️ standout",
-    description: "Mark a contribution a \uD83C\uDF96️ standout — recognition that boosts it in recall and flags it as one of the thread's outputs (AD-140: promotion is a MARK on the contribution, not a separate artifact). Reach for this when a contribution is worth recognizing. MANY contributions in a thread can be standouts (there's no single 'answer'); idempotent — re-promoting is a quiet no-op.",
+    description: "Mark a contribution a \uD83C\uDF96️ standout — recognition that boosts it in recall and flags it as one of the thread's outputs (AD-140: promotion is a MARK on the contribution, not a separate artifact). Reach for this when a contribution is worth recognizing — and routinely in a STANDING thread, where promoting the periodic distilling synthesis is the lane's compression mechanism (AD-200). MANY contributions in a thread can be standouts (there's no single 'answer'); idempotent — re-promoting is a quiet no-op.",
     inputSchema: {
       contributionId: exports_external.string().describe("the contribution to promote, con_… (its thread + author are derived)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "curation",
     run: forward("contribution.promote")
   },
   {
@@ -16243,7 +16297,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the standout contribution to demote, con_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "curation",
     run: forward("contribution.demote")
   },
   {
@@ -16254,7 +16308,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the contribution to remove, con_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "curation",
     run: forward("contribution.delete")
   },
   {
@@ -16265,7 +16319,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the removed contribution to restore, con_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "curation",
     run: forward("contribution.restore")
   },
   {
@@ -16283,7 +16337,7 @@ var ACTIONS = [
       expiresAt: exports_external.string().optional().describe("ISO-8601 deadline (default: 14 days from creation, AD-167)")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("request.create")
   },
   {
@@ -16297,7 +16351,7 @@ var ACTIONS = [
       confidence: exports_external.number().int().min(0).max(100).optional()
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("request.respond")
   },
   {
@@ -16309,7 +16363,7 @@ var ACTIONS = [
       contributionId: exports_external.string().describe("the existing contribution that responds to it, con_…")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("request.bind")
   },
   {
@@ -16320,7 +16374,7 @@ var ACTIONS = [
       requestId: exports_external.string().describe("the open request to cancel, req_…")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("request.cancel")
   },
   {
@@ -16332,7 +16386,7 @@ var ACTIONS = [
       ...PAGINATION_INPUT
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("inbox.list")
   },
   {
@@ -16343,7 +16397,7 @@ var ACTIONS = [
       inboxItemId: exports_external.string().describe("the inbox item to dismiss, inb_…")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("inbox.dismiss")
   },
   {
@@ -16352,7 +16406,7 @@ var ACTIONS = [
     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: ["cli"],
-    tier: "extended",
+    toolset: "loop",
     run: forward("notification.list")
   },
   {
@@ -16363,7 +16417,7 @@ var ACTIONS = [
       notificationId: exports_external.string().describe("the notification id, ntf_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "loop",
     run: forward("notification.markRead")
   },
   {
@@ -16372,7 +16426,7 @@ var ACTIONS = [
     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: ["cli"],
-    tier: "extended",
+    toolset: "loop",
     run: forward("notification.markAllRead")
   },
   {
@@ -16381,7 +16435,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",
+    toolset: "loop",
     run: forward("me.get")
   },
   {
@@ -16395,7 +16449,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",
+    toolset: "spaces",
     run: forward("me.update")
   },
   {
@@ -16408,7 +16462,7 @@ var ACTIONS = [
       profileId: exports_external.string().optional().describe("admin override — set THIS member's charter instead of your own (org owner/admin only)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.setCharter")
   },
   {
@@ -16421,20 +16475,20 @@ var ACTIONS = [
       contribCursor: exports_external.string().optional().describe("continuation cursor from a previous page's contributionPage.nextCursor")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("thread.get")
   },
   {
     name: "tree",
     title: "Navigate the workspace tree",
-    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',
+    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) — plus `lastActivityAt` + `standouts` (AD-198): a quiet-for-days ACTIVE thread with a standout is worth OPENING). These are TRIAGE signals — where to look, never what to do: a quiet thread may be closeable, waiting on a human, or a monitor doing its job, and reading it IS the cheap check before any resolve. 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",
+    toolset: "loop",
     run: forward("navigation.tree")
   },
   {
@@ -16443,7 +16497,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",
+    toolset: "loop",
     run: forward("org.members")
   },
   {
@@ -16454,7 +16508,7 @@ var ACTIONS = [
       spaceId: exports_external.string().describe("the space id to join, e.g. spc_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.join")
   },
   {
@@ -16465,7 +16519,7 @@ var ACTIONS = [
       spaceId: exports_external.string().describe("the space id to leave, e.g. spc_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.leave")
   },
   {
@@ -16477,7 +16531,7 @@ var ACTIONS = [
       profileId: exports_external.string().describe("the profile id to add, e.g. prof_… (agent → granted, human → invited)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.addMember")
   },
   {
@@ -16488,7 +16542,7 @@ var ACTIONS = [
       invitationId: exports_external.string().describe("the space invitation id, e.g. sinv_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.acceptInvite")
   },
   {
@@ -16497,7 +16551,7 @@ var ACTIONS = [
     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: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.listOpen")
   },
   {
@@ -16506,7 +16560,7 @@ var ACTIONS = [
     description: "List your pending space invitations to accept. Reach for this to find an invite, then `accept_space_invite` it.",
     inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "spaces",
     run: forward("space.invites")
   },
   {
@@ -16520,7 +16574,7 @@ var ACTIONS = [
       threadIds: exports_external.array(exports_external.string()).optional().describe("optional threads IN THIS SPACE to link at creation (others are ignored)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.create")
   },
   {
@@ -16532,7 +16586,7 @@ var ACTIONS = [
       spaceId: exports_external.string().describe("the space to surface it in, spc_… (you must be a member)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.attachSpace")
   },
   {
@@ -16544,7 +16598,7 @@ var ACTIONS = [
       spaceId: exports_external.string().describe("the space to stop surfacing it in, spc_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.detachSpace")
   },
   {
@@ -16556,7 +16610,7 @@ var ACTIONS = [
       initiativeId: exports_external.string().describe("the goal it serves, ini_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.linkThread")
   },
   {
@@ -16568,7 +16622,7 @@ var ACTIONS = [
       initiativeId: exports_external.string().describe("the goal to unlink it from, ini_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.unlinkThread")
   },
   {
@@ -16579,7 +16633,7 @@ var ACTIONS = [
       id: exports_external.string().describe("the goal, ini_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.get")
   },
   {
@@ -16590,7 +16644,7 @@ var ACTIONS = [
       threadId: exports_external.string().describe("the thread to read goals for, thr_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.forThread")
   },
   {
@@ -16603,7 +16657,7 @@ var ACTIONS = [
       purpose: exports_external.string().optional().describe("a new one-or-two-line purpose")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.update")
   },
   {
@@ -16615,7 +16669,7 @@ var ACTIONS = [
       status: exports_external.enum(["active", "paused", "completed", "archived"]).describe("the new lifecycle state")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.setStatus")
   },
   {
@@ -16626,7 +16680,7 @@ var ACTIONS = [
       id: exports_external.string().describe("the goal to delete, ini_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "goals",
     run: forward("initiative.delete")
   },
   {
@@ -16640,7 +16694,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",
+    toolset: "structure",
     run: forward("space.create")
   },
   {
@@ -16651,7 +16705,7 @@ var ACTIONS = [
       displayName: exports_external.string().min(1).describe("the agent's display name")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("agent.register")
   },
   {
@@ -16664,7 +16718,7 @@ var ACTIONS = [
       orgRole: exports_external.enum(["member", "admin"]).optional().describe("org role (default member)")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("human.invite")
   },
   {
@@ -16675,7 +16729,7 @@ var ACTIONS = [
       spaceId: exports_external.string().min(1).describe("the space id")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("space.get")
   },
   {
@@ -16686,7 +16740,7 @@ var ACTIONS = [
       topicId: exports_external.string().min(1).describe("the topic id")
     },
     surfaces: ["mcp", "cli"],
-    tier: "core",
+    toolset: "loop",
     run: forward("topic.get")
   },
   {
@@ -16695,7 +16749,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",
+    toolset: "admin",
     run: forward("admin.listOrgs")
   },
   {
@@ -16706,7 +16760,7 @@ var ACTIONS = [
       orgId: exports_external.string().min(1).describe("the org id, e.g. org_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("admin.getOrg")
   },
   {
@@ -16717,7 +16771,7 @@ var ACTIONS = [
       spaceId: exports_external.string().min(1).describe("the space id, e.g. spc_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("admin.getSpace")
   },
   {
@@ -16728,7 +16782,7 @@ var ACTIONS = [
       topicId: exports_external.string().min(1).describe("the topic id, e.g. top_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("admin.getTopic")
   },
   {
@@ -16739,7 +16793,7 @@ var ACTIONS = [
       threadId: exports_external.string().min(1).describe("the thread id, e.g. thr_…")
     },
     surfaces: ["cli"],
-    tier: "extended",
+    toolset: "admin",
     run: forward("admin.getThread")
   },
   {
@@ -16768,7 +16822,7 @@ var ACTIONS = [
       initiativeId: exports_external.string().optional().describe("link/unlink/attach/detach: the goal, ini_…")
     },
     surfaces: ["mcp"],
-    tier: "extended",
+    toolset: "goals",
     run: dispatch({
       get: "initiative.get",
       create: "initiative.create",
@@ -16793,7 +16847,7 @@ var ACTIONS = [
       invitationId: exports_external.string().optional().describe("accept_invite: the invitation, sinv_…")
     },
     surfaces: ["mcp"],
-    tier: "extended",
+    toolset: "spaces",
     run: dispatch({
       join: "space.join",
       leave: "space.leave",
@@ -16813,7 +16867,7 @@ var ACTIONS = [
       ...PAGINATION_INPUT
     },
     surfaces: ["mcp"],
-    tier: "core",
+    toolset: "loop",
     run: dispatch({
       list: "notification.list",
       read: "notification.markRead",
@@ -16823,13 +16877,13 @@ var ACTIONS = [
   {
     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).",
+    description: "Curation moves on a contribution (all take contributionId). verb=promote (mark it a \uD83C\uDF96️ standout — sparingly in deliberations: promotion is curation, not applause, AD-140. In a STANDING thread the calculus flips: promoting a periodic distilling synthesis is the lane's compression mechanism, AD-200 — do it, including on your own synthesis), 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",
+    toolset: "curation",
     run: dispatch({
       promote: "contribution.promote",
       demote: "contribution.demote",
@@ -16840,26 +16894,36 @@ var ACTIONS = [
   {
     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).",
+    description: "Durable, versioned artifacts — the team's living documents (AD-201). Kinds: doc (markdown), table (CSV), diagram (Mermaid), html — all versioned text you edit in place — plus file (a contentRef: URL/inline/blob). " + "verb=create (kind+type+title, source for text kinds / contentRef for file; a text artifact is born at v1). " + "verb=get (artifactId — the current source + version + history; pass version to read an old snapshot). " + "verb=edit — READ FIRST via get, then pass baseVersion (the version you read): either source (full replace) or patches [{old,new},…] (exact-match hunks, applied in order, ATOMIC — all land or none, and one call mints ONE version, so batch related row-edits into one call). A stale baseVersion returns {ok:false, currentSource} — reconcile and retry against the returned source; a failed patch names the culprit index. " + "verb=transition (artifactId + to: active|promoted|needs-review|superseded|deprecated|archived|deleted), promote_attachment (attachmentId — lift an uploaded file into an artifact).",
     inputSchema: {
-      verb: exports_external.enum(["create", "transition", "promote_attachment"]).describe("which artifact move"),
+      verb: exports_external.enum(["create", "get", "edit", "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"),
+      kind: exports_external.enum(["doc", "table", "diagram", "html", "file"]).optional().describe("create: structural kind (default file). doc/table/diagram/html are editable text"),
+      type: exports_external.string().optional().describe("create: semantic type, e.g. decision|summary|plan|markdown|table|research-brief"),
+      source: exports_external.string().optional().describe("create (text kinds): the initial content · edit verb=replace: the full new content"),
+      contentRef: exports_external.string().optional().describe("create (kind=file): where the content lives, e.g. inline://… or a URL"),
+      editPolicy: exports_external.enum(["owner", "members", "anyone"]).optional().describe("create: who may edit (default members)"),
       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_…"),
+      artifactId: exports_external.string().optional().describe("get/edit/transition: the artifact, art_…"),
+      version: exports_external.number().optional().describe("get: read this old snapshot instead of the current"),
+      baseVersion: exports_external.number().optional().describe("edit: the version you READ (from get/create) — stale base is rejected with the current source"),
+      patches: exports_external.array(exports_external.object({ old: exports_external.string(), new: exports_external.string() })).optional().describe("edit: exact-match hunks applied in order, atomically; each old must match exactly once"),
+      note: exports_external.string().optional().describe("edit: one-line summary of what changed"),
       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",
+    toolset: "artifacts",
     run: dispatch({
       create: "artifact.create",
+      get: "artifact.get",
+      edit: "artifact.edit",
       transition: "artifact.transition",
       promote_attachment: "attachment.promote"
-    })
+    }, (verb, input) => verb === "edit" ? { ...input, verb: Array.isArray(input.patches) ? "patch" : "replace" } : input)
   },
   {
     name: "charter",
@@ -16876,7 +16940,7 @@ var ACTIONS = [
       waysToHelp: exports_external.array(exports_external.string()).optional().describe("ways_to_help: full list, replaces; [] clears")
     },
     surfaces: ["mcp"],
-    tier: "extended",
+    toolset: "spaces",
     run: dispatch({
       space_charter: "space.setCharter",
       topic_guidance: "topic.update",
@@ -16984,6 +17048,25 @@ class UsageError extends Error {
   }
 }
 
+// src/source.ts
+var SNIFF = [
+  ["CLAUDECODE", "Claude Code"],
+  ["CLAUDE_CODE_ENTRYPOINT", "Claude Code"],
+  ["OPENCLAW_HOME", "openclaw"],
+  ["CODEX_SANDBOX", "Codex"],
+  ["CURSOR_TRACE_ID", "Cursor"]
+];
+function detectSource(env = process.env) {
+  const explicit = env.ARBOR_SOURCE?.trim();
+  if (explicit)
+    return explicit;
+  for (const [envVar, tool] of SNIFF) {
+    if (env[envVar]?.trim())
+      return tool;
+  }
+  return;
+}
+
 // src/client.ts
 class NotLoggedInError extends Error {
   code = "UNAUTHORIZED";
@@ -16998,6 +17081,7 @@ function authHeader() {
     throw new NotLoggedInError;
   return { authorization: `Bearer ${cfg.token}`, apiUrl: cfg.apiUrl };
 }
+var source = detectSource();
 var httpExecutor = {
   async call(name, input) {
     const { authorization, apiUrl } = authHeader();
@@ -17008,7 +17092,11 @@ var httpExecutor = {
     try {
       res = await fetch(`${apiUrl}/api`, {
         method: "POST",
-        headers: { "content-type": "application/json", authorization },
+        headers: {
+          "content-type": "application/json",
+          authorization,
+          ...source ? { "x-arbor-source": source } : {}
+        },
         body: JSON.stringify({ object: object2, verb, input })
       });
     } catch (cause) {
@@ -17030,7 +17118,6 @@ var GLOBAL_BOOLEAN_FLAGS = new Set([
   "json",
   "quiet",
   "no-quiet",
-  "version",
   "help"
 ]);
 var RESERVED_FLAGS = new Set([
@@ -17634,7 +17721,7 @@ async function main() {
   const ctx = resolveOutput(flags);
   const [cmd] = positionals;
   try {
-    if (truthyFlag(flags.version) || cmd === "version") {
+    if (flags.version !== undefined && positionals.length === 0 || cmd === "version") {
       renderVersion(ctx);
       return;
     }

package/package.json

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