@lambdacurry/arbor 0.6.6 → 0.7.1

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,27 @@ 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.
+
+8. DURABLE OUTPUT IS AN ARTIFACT, NOT A LONG CONTRIBUTION (AD-201). A contribution is one point in a conversation; an ARTIFACT is a first-class output the room holds and keeps CURRENT — a doc, a table, a diagram, a spec, or an uploaded file. When your point is really a deliverable the team will read or UPDATE later — a table of options, a reference doc, a plan, a rubric — make it an artifact (\`artifact\` create with kind doc/table/diagram/html + \`source\`, or promote a file) instead of pasting it into prose. Text-kind artifacts are LIVING: \`get\` it, then \`edit\` naming the \`baseVersion\` you read — patches apply exact-match and atomically, one version per call, every version attributed. An artifact created FROM a thread is listed on that thread automatically (no link post needed); cite it inline with [label](#art_…) wherever it's relevant. WHY: a thread remembers what was SAID; an artifact holds what is TRUE NOW — a 40-row table pasted into a contribution is frozen the instant it's posted and unreadable the moment it's edited, while the same table as an artifact stays live, diffable, and findable by its content.
 
 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 = {
@@ -16056,7 +16079,7 @@ var ACTIONS = [
   {
     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,7 +16091,7 @@ 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"],
     toolset: "loop",
@@ -16077,7 +16100,7 @@ var ACTIONS = [
   {
     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"),
@@ -16173,10 +16196,10 @@ var ACTIONS = [
   {
     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"],
@@ -16186,11 +16209,14 @@ var ACTIONS = [
   {
     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. The artifact is AUTOMATICALLY listed on its source thread (no link post needed). Reach for this when a thread has produced something worth retaining and citing beyond the conversation — especially a table or doc the team will UPDATE, which beats pasting it into a prose contribution.",
     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()
@@ -16199,6 +16225,36 @@ var ACTIONS = [
     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",
@@ -16227,7 +16283,7 @@ var ACTIONS = [
   {
     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)")
     },
@@ -16414,7 +16470,7 @@ var ACTIONS = [
   {
     name: "thread_get",
     title: "Read a thread",
-    description: "Read the full state of the thread you're working in — objective, every contribution + stamp, and its OPEN REQUESTS. Load this before contributing; if an open request matches what you're about to say, respond (or `stamp` the card it's about) so the request completes. On a LONG thread, page the contributions with contribLimit/contribCursor (follow contributionPage.nextCursor) to bound how much you load at once.",
+    description: "Read the full state of the thread you're working in — objective, every contribution + stamp, its OPEN REQUESTS, and its ARTIFACTS (the durable outputs born from this thread). Load this before contributing; if an open request matches what you're about to say, respond (or `stamp` the card it's about) so the request completes. On a LONG thread, page the contributions with contribLimit/contribCursor (follow contributionPage.nextCursor) to bound how much you load at once.",
     inputSchema: {
       threadId: exports_external.string().describe("the thread id, e.g. thr_…"),
       contribLimit: exports_external.number().int().positive().optional().describe("max contributions to return (AD-151 keyset paging) — omit to load the whole thread; set on a long thread to bound context"),
@@ -16427,7 +16483,7 @@ var ACTIONS = [
   {
     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_…)"),
@@ -16823,7 +16879,7 @@ 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_…")
@@ -16840,15 +16896,23 @@ 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 and is AUTOMATICALLY listed on its sourceThreadId thread — no link post needed). " + "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_…")
@@ -16857,9 +16921,11 @@ var ACTIONS = [
     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",
@@ -16984,6 +17050,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 +17083,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 +17094,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 +17120,6 @@ var GLOBAL_BOOLEAN_FLAGS = new Set([
   "json",
   "quiet",
   "no-quiet",
-  "version",
   "help"
 ]);
 var RESERVED_FLAGS = new Set([
@@ -17634,7 +17723,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.6",
+  "version": "0.7.1",
   "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",