@lambdacurry/arbor 0.24.3 → 0.24.5

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.3",
+  version: "0.24.5",
   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",
@@ -29,7 +29,7 @@ var package_default = {
     access: "public"
   },
   scripts: {
-    arbor: "tsx src/bin.ts",
+    arbor: "vpx src/bin.ts",
     build: "bun build ./src/bin.ts --target=node --outfile=dist/arbor.js",
     test: "vp test run --passWithNoTests",
     typecheck: "tsc -b",
@@ -40,7 +40,6 @@ var package_default = {
     "@arbor/core": "workspace:*",
     "@types/node": "^26.2.0",
     "just-bash": "3.4.2",
-    tsx: "^4.20.6",
     typescript: "^5.8.0",
     "vite-plus": "catalog:",
     zod: "^4.4.3"
@@ -6580,10 +6579,20 @@ var spaces = sqliteTable("spaces", {
   defaultReviewDimensions: text("default_review_dimensions", { mode: "json" }).$type().notNull().default([]),
   stage: text("stage").$type().notNull().default("exploration"),
   systemKind: text("system_kind"),
+  key: text("key"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   orgIdx: index("spaces_org_idx").on(t.orgId),
-  systemKindUq: uniqueIndex("spaces_system_kind_uq").on(t.systemKind)
+  systemKindUq: uniqueIndex("spaces_system_kind_uq").on(t.systemKind),
+  orgKeyUq: uniqueIndex("spaces_org_key_uq").on(t.orgId, t.key)
+}));
+var spaceRetiredKeys = sqliteTable("space_retired_keys", {
+  orgId: text("org_id").notNull().references(() => orgs.id),
+  key: text("key").notNull(),
+  spaceId: text("space_id").notNull().references(() => spaces.id),
+  retiredAt: ts("retired_at").notNull()
+}, (t) => ({
+  orgKeyUq: uniqueIndex("space_retired_keys_org_key_uq").on(t.orgId, t.key)
 }));
 var spaceMemberships = sqliteTable("space_memberships", {
   id: text("id").primaryKey(),
@@ -6713,8 +6722,10 @@ var threads = sqliteTable("threads", {
   waysToHelp: text("ways_to_help", { mode: "json" }).$type().notNull().default([]),
   openQuestions: text("open_questions", { mode: "json" }).$type().notNull().default([]),
   expectedOutput: text("expected_output").notNull().default(""),
+  number: integer2("number"),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
+  spaceNumberUq: uniqueIndex("threads_space_number_uq").on(t.spaceId, t.number),
   topicIdx: index("threads_topic_idx").on(t.topicId),
   spaceIdx: index("threads_space_idx").on(t.spaceId),
   lifecycleTypeIdx: index("threads_lifecycle_type_idx").on(t.lifecycleType),
@@ -8218,6 +8229,36 @@ var ORG_ADMIN_CONTAINMENT_PERMISSIONS = new Set([
   "revoke"
 ]);
 
+// ../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/queries/thread-assignment.ts
+var assigneeColumns = {
+  threadId: threadAssignments.threadId,
+  assignedAt: threadAssignments.createdAt,
+  assignedByProfileId: threadAssignments.assignedByProfileId,
+  id: profiles.id,
+  kind: profiles.kind,
+  displayName: profiles.displayName,
+  color: profiles.color,
+  emoji: profiles.emoji
+};
+var lastActivityExpr = sql`coalesce(
+  (select max(${contributions.createdAt}) from ${contributions}
+    where ${contributions.threadId} = ${threads.id}),
+  ${threads.createdAt}
+)`;
+
 // ../core/src/ops/space.ts
 var GUIDANCE_LIMITS = {
   maxItems: 12,
@@ -8244,6 +8285,7 @@ var OPERATION_LOSS_REASONS = new Set([
 
 // ../core/src/ops/computer-run-retention.ts
 var COMPUTER_RUN_RETENTION_WARNING_MS = 24 * 60 * 60 * 1000;
+var COMPUTER_RUN_SUSPENDED_EXPIRY_MS = 24 * 60 * 60 * 1000;
 
 // ../core/src/ops/computer-run.ts
 var COMPUTER_RUN_START_CHECKPOINT_RESERVATION_STALE_MS = 12 * 60 * 1000;
@@ -8290,20 +8332,6 @@ var COMPUTER_WORKSPACE_RECOVERY_ATTACH_DEADLINE_MS = 31 * 60 * 1000;
 var COMPUTER_WORKSPACE_RECOVERY_HEALTH_DEADLINE_MS = 2 * 60 * 1000;
 var COMPUTER_WORKSPACE_RECOVERY_HEADROOM_MS = 2 * 60 * 1000;
 var COMPUTER_WORKSPACE_RECOVERY_LEASE_MS = COMPUTER_WORKSPACE_RECOVERY_CHECKPOINT_DEADLINE_MS + COMPUTER_WORKSPACE_RECOVERY_ATTACH_DEADLINE_MS + COMPUTER_WORKSPACE_RECOVERY_HEALTH_DEADLINE_MS + COMPUTER_WORKSPACE_RECOVERY_HEADROOM_MS;
-
-// ../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/artifact-git-intent.ts
 var RETRYABLE_REPAIR = new Set([
   "pending_push_unconfirmed",
@@ -8321,22 +8349,6 @@ var EMOJI_RE = new RegExp("^\\p{RGI_Emoji}$", "v");
 var BASE_MS = Date.parse("2026-07-20T15:00:00.000Z");
 // ../core/src/ops/agent-pairing.ts
 var PAIRING_TTL_MS = 15 * 60 * 1000;
-// ../core/src/queries/thread-assignment.ts
-var assigneeColumns = {
-  threadId: threadAssignments.threadId,
-  assignedAt: threadAssignments.createdAt,
-  assignedByProfileId: threadAssignments.assignedByProfileId,
-  id: profiles.id,
-  kind: profiles.kind,
-  displayName: profiles.displayName,
-  color: profiles.color,
-  emoji: profiles.emoji
-};
-var lastActivityExpr = sql`coalesce(
-  (select max(${contributions.createdAt}) from ${contributions}
-    where ${contributions.threadId} = ${threads.id}),
-  ${threads.createdAt}
-)`;
 // ../core/src/ops/package-cache.ts
 var PACKAGE_CACHE_PENDING_TTL_MS = 15 * 60 * 1000;
 var PACKAGE_CACHE_FINAL_TTL_MS = 30 * 24 * 60 * 60 * 1000;
@@ -8510,6 +8522,7 @@ var recallHit = looseObject({
   excerpt: string2(),
   space: spaceRef.nullable(),
   threadId: nullableString,
+  shortId: nullableString.optional(),
   url: nullableString,
   createdAt: timestamp
 });
@@ -8995,6 +9008,7 @@ var orgMember = looseObject({
 });
 var thread3 = looseObject({
   id,
+  shortId: nullableString.optional(),
   title: string2(),
   objective: string2(),
   status: string2().optional(),
@@ -9033,6 +9047,7 @@ var topic2 = looseObject({
 var space3 = looseObject({
   id,
   title: string2(),
+  key: nullableString.optional(),
   purpose: nullableString.optional(),
   stage: string2().optional(),
   url: string2().optional()
@@ -11161,6 +11176,7 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
 // ../actions/src/index.ts
 var ARTIFACT_TYPE_DESCRIPTION = `semantic type (one of: ${ARTIFACT_TYPES.join(", ")})`;
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
+var SPACE_KEY_INPUT = string2().min(1).refine((key) => key.trim().length > 0, "space key cannot be blank");
 var CONTRIBUTION_ADD_LINK_RELS = [
   "cites",
   "contests",
@@ -11747,7 +11763,7 @@ var ACTION_DEFINITIONS = [
     title: "Contribute to a thread",
     description: "Add one additive point to a Thread; use stamp for agreement, respond/mark_as_response for requests, and links for deliberate reply/contest edges. Pass idempotencyKey (CLI: --idempotency-key) for safe retries.",
     inputSchema: {
-      threadId: string2().describe("the thread id, e.g. thr_…"),
+      threadId: string2().describe("the thread id, e.g. thr_…, or its short id, e.g. BUD-34"),
       type: _enum(CONTRIBUTION_TYPES).describe("the contribution type (AD-066 taxonomy)"),
       body: string2().min(1).describe(`the contribution markdown. ${CONTRIBUTION_BODY_GUIDANCE}`),
       idempotencyKey: string2().min(1).max(200).optional().describe("stable key for this ONE logical contribution (≤200 chars), e.g. cron-run/work-item + output slot; safe retries return the original contribution. Reusing it with different content is a conflict."),
@@ -11906,7 +11922,7 @@ var ACTION_DEFINITIONS = [
     title: "Edit a thread's title, objective, or topic",
     description: "Correct a Thread's title or objective, or move it under another Topic of the same Space, patching only supplied fields; use it to make done clear or refile misfiled work instead of archiving and reopening. Status moves stay with `transition_thread`, column order with `--rank`, and the temporary help list with `charter` ways_to_help.",
     inputSchema: {
-      threadId: string2().describe("the thread to edit, thr_…"),
+      threadId: string2().describe("the thread to edit, thr_… or a short id like BUD-34"),
       title: string2().min(1).optional().describe("a new title — the question, outcome, investigation, instance, or standing concern"),
       objective: string2().min(1).optional().describe("a new objective — what this Thread should accomplish; for finite work, what done means"),
       topicId: string2().optional().describe("move the thread under this topic of the same space, top_…"),
@@ -11922,7 +11938,7 @@ var ACTION_DEFINITIONS = [
     description: "Make a Space member (yourself when profileId is omitted) responsible for moving a Thread, or remove that responsibility; assignment is immediate, idempotent, grants no permissions, and creates no Inbox item — a specific owed action is still a `request`. Assignees stay attached through every lifecycle move, so transfer responsibility by assigning the new owner and unassigning the old.",
     inputSchema: {
       verb: _enum(["assign", "unassign"]).describe("add or remove responsibility"),
-      threadId: string2().describe("the thread, thr_…"),
+      threadId: string2().describe("the thread, thr_… or a short id like BUD-34"),
       profileId: string2().optional().describe("the member to (un)assign, prof_…; omit for yourself")
     },
     surfaces: ["mcp", "cli"],
@@ -12023,7 +12039,7 @@ var ACTION_DEFINITIONS = [
     title: "Replace a Thread computer override",
     description: "DESTRUCTIVE REPLACE: Replace this Thread's entire sparse Computer override; omitted fields are cleared from the Thread layer and inherit Topic/Space/organization policy. This is config only and allocates no runtime; an existing Computer cannot switch provider, and repeating the same full layer is idempotent.",
     inputSchema: {
-      threadId: string2().describe("the Thread, thr_…"),
+      threadId: string2().describe("the Thread, thr_… or a short id like BUD-34"),
       backend: _enum(["worker-shell", "container"]).nullable().optional().describe("override execution tier, or null to inherit"),
       containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.4.2, bunx, Node 26.5.1, pnpm 10.33.0, Python 3.13.15 (python/python3), jq, and ripgrep (rg), or null to clear inherited profile"),
       setupScript: string2().nullable().optional().describe("optional strict Bash setup for a fresh base after repositories materialize; install scoped tools in /workspace/.local/bin so exec finds them and snapshots retain them"),
@@ -12039,7 +12055,7 @@ var ACTION_DEFINITIONS = [
     title: "Attach a Thread computer",
     description: "Deprecated by AD-306: computer_run_start(threadId) attaches durable identity itself, so use this only to mint protocol identity with no Run at all. Creates or reuses the Thread's stable Computer identity and an immutable collaborator receipt without starting provider runtime.",
     inputSchema: {
-      threadId: string2().describe("the Thread whose computer you are attaching, thr_…")
+      threadId: string2().describe("the Thread whose computer you are attaching, thr_… or a short id like BUD-34")
     },
     surfaces: ["cli"],
     toolset: "loop",
@@ -12050,7 +12066,7 @@ var ACTION_DEFINITIONS = [
     title: "Open a Thread computer",
     description: "Deprecated by AD-306: start work with computer_run_start(threadId, mode) instead; this alias remains one release and boots the parent Thread Computer, returning a computerSessionId. An optional owned active runId records a successful session attach as Run retention activity. Use it only for a legacy client that still addresses the parent by cms_ id; unsafe recovery is refused and unresolved newer workspace state stays fail-closed.",
     inputSchema: {
-      threadId: string2().describe("the Arbor Thread whose stable computer to open, thr_…"),
+      threadId: string2().describe("the Arbor Thread whose stable computer to open, thr_… or a short id like BUD-34"),
       runId: string2().optional().describe("optional owned active Run; successful open renews its retention deadline"),
       idempotencyKey: string2().trim().min(1).max(200).optional().describe("optional explicit key for ONE distinct logical open; omission reuses the durable profile/Thread/recipe identity; changed options require a distinct intent; retry unchanged after response loss and never mint a new key to bypass unresolved work"),
       vcpus: number2().int().min(1).max(4).optional().describe("optional container vCPU request"),
@@ -12065,7 +12081,7 @@ var ACTION_DEFINITIONS = [
     title: "Replace a Thread computer",
     description: "DESTRUCTIVE RECOVERY: Replace an incompatible active Computer generation from the Thread's effective recipe when Arbor reports structural recipe incompatibility. Preserves the old generation unless the successor restores supported state and passes health.",
     inputSchema: {
-      threadId: string2().describe("the Thread whose active Computer generation is replaced, thr_…"),
+      threadId: string2().describe("the Thread whose active Computer generation is replaced, thr_… or a short id like BUD-34"),
       idempotencyKey: string2().min(1).max(200).describe("stable key for this ONE replacement request; reuse it unchanged for retries"),
       reason: string2().min(1).max(500).describe("concise auditable reason for replacing the active generation")
     },
@@ -12078,7 +12094,7 @@ var ACTION_DEFINITIONS = [
     title: "Start a run",
     description: `Start an isolated write Run or shared/read Run with one idempotencyKey; pending admission returns runStartId for receipt observation while the lifecycle owner continues independently. Save work outside the temporary Computer and finish the Run when done; first use: read the Computer guide at ${AGENT_GUIDE_URLS.computer}.`,
     inputSchema: {
-      threadId: string2().optional().describe("the Thread whose Computer this Run works in, thr_…; the canonical Run-first front door"),
+      threadId: string2().optional().describe("the Thread whose Computer this Run works in, thr_… or a short id like BUD-34; the canonical Run-first front door"),
       computerSessionId: string2().optional().describe("legacy compatibility alternative to threadId: an existing parent computerSessionId, cms_…"),
       mode: _enum(["read", "write"]).describe("write for mutable work; read for shared inspection"),
       execution: _enum(["shared", "isolated"]).optional().describe("write Run placement; defaults to isolated. Use shared only for intentional live collaboration on the Thread Computer"),
@@ -12096,7 +12112,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_suspend",
     title: "Suspend a run",
-    description: "Checkpoint an active WRITE Run for an external wait: save or publish needed work outside the Computer first; shared Runs checkpoint the parent without releasing it, while isolated Runs publish their exact workspace and release the Sandbox; resume with the same runId. Unread terminal output is retained for 30 days; no drain required; active/unknown work or failed preservation blocks release.",
+    description: "Checkpoint an active WRITE Run for an external wait after saving needed work outside the Computer; shared Runs checkpoint the parent, isolated Runs publish their exact workspace and release the Sandbox; resume with the same runId within 24h or an unkept isolated Run ends. Unread terminal output is retained for 30 days; no drain required; active/unknown work or failed preservation blocks release.",
     inputSchema: {
       runId: string2().describe("the active WRITE Run to suspend, run_…")
     },
@@ -12144,7 +12160,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_retention",
     title: "Inspect Run retention",
-    description: "Report the deadline, last meaningful use, Keep flag, and advisory warning for one isolated Run. Expiry is disabled; this read sends no warning and releases nothing.",
+    description: "Report the deadline, last meaningful use, Keep flag, and advisory warning for one isolated Run; a suspended Run is due 24 hours after it suspended. This read sends no warning and releases nothing.",
     inputSchema: {
       runId: string2().describe("the Run to inspect, run_…")
     },
@@ -12155,7 +12171,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_keep",
     title: "Keep Run data",
-    description: "The Run owner or an organization admin can set or clear Keep for a newly created isolated Run, using expectedRevision to guard races. It protects restorable Run data without keeping provider compute alive; expiry remains disabled.",
+    description: "The Run owner or an organization admin can set or clear Keep for a newly created isolated Run, using expectedRevision to guard races. It protects restorable Run data without keeping provider compute alive; Keep stops a suspended Run from ending on its own after 24 hours.",
     inputSchema: {
       runId: string2().describe("the Run to protect, run_…"),
       keep: boolean2().describe("true to retain the Run's restorable data; false to resume the policy"),
@@ -12260,7 +12276,7 @@ var ACTION_DEFINITIONS = [
     title: "Capture public visual evidence",
     description: "Capture a 1280×720 screenshot of one public HTTPS URL as Thread evidence without opening the project runtime. Returns capture metadata plus ready-to-place attachments[].markdown; put that Markdown exactly where the image belongs and bind the matching attachmentIds, while localhost and authenticated pages remain unavailable and the capture does not judge correctness.",
     inputSchema: {
-      threadId: string2().describe("the Arbor Thread that will own the evidence, thr_…"),
+      threadId: string2().describe("the Arbor Thread that will own the evidence, thr_… or a short id like BUD-34"),
       targetUrl: url().refine((value) => value.startsWith("https://"), "targetUrl must use HTTPS").describe("one public HTTPS URL to capture")
     },
     surfaces: ["computer-mcp", "computer-cli"],
@@ -12544,7 +12560,7 @@ var ACTION_DEFINITIONS = [
     title: "Read a Thread computer",
     description: "Inspect a Thread's provider-free durable Computer recipe/materialization state, compatibility, recoverySafety, lineage, recent receipts, Runs, and reprovision outcomes; setup content and credentials stay redacted. This read never contacts execution; use computer_status for live readiness.",
     inputSchema: {
-      threadId: string2().describe("the Thread, thr_…"),
+      threadId: string2().describe("the Thread, thr_… or a short id like BUD-34"),
       lineageLimit: number2().int().min(1).max(100).optional().describe("recent receipts/lineage rows (default 20)")
     },
     surfaces: ["computer-mcp", "cli"],
@@ -12581,7 +12597,7 @@ var ACTION_DEFINITIONS = [
     title: "Set a thread's ways to help",
     description: "Set a thread's READ-ONLY 'ways to help' (AD-038) — a short, curated list of perspectives, skills, or concrete tasks orienting someone on how they could pitch in with THIS thread as it stands (e.g. 'a benchmark on cold-start latency'). It is thread-local and temporary: it is read inside `thread_get`, and it never rolls up into a space/topic orientation surface — a standing statement about what a room wants is the room's standing ways to help (`contributionLanes`, via `set_space_lanes`/`set_topic_lanes`, AD-222). Guidance you READ, NOT an obligation — that's `request`. Replaces the whole list; pass [] to clear.",
     inputSchema: {
-      threadId: string2().describe("the thread, thr_…"),
+      threadId: string2().describe("the thread, thr_… or a short id like BUD-34"),
       waysToHelp: proseList("the full ways-to-help list — replaces the existing one; [] clears it")
     },
     surfaces: ["cli"],
@@ -12593,7 +12609,7 @@ var ACTION_DEFINITIONS = [
     title: "Move a thread's lifecycle",
     description: transitionThreadActionDescription(),
     inputSchema: {
-      threadId: string2().describe("the thread to move, thr_…"),
+      threadId: string2().describe("the thread to move, thr_… or a short id like BUD-34"),
       to: string2().min(1).describe("label key, case-insensitive label name, or bare type (`resolved` still works as a type name)"),
       reason: string2().optional().describe("optional one-line why, recorded on the event"),
       rank: string2().max(THREAD_RANK_MAX).regex(THREAD_RANK_PATTERN).nullable().optional().describe("LexoRank in the destination column; omit to leave unchanged, null to restore recency. Combined with `--to` this is one atomic write — a bad rank moves nothing")
@@ -12679,7 +12695,7 @@ var ACTION_DEFINITIONS = [
     description: "Bind one Artifact to an existing same-Space Thread Live Preview, making the Artifact the durable entry point for that executable surface. Omit --thread-id to clear the binding; this changes no Artifact source/version and does not create or reconfigure a Computer.",
     inputSchema: {
       artifactId: string2().describe("the Artifact, art_…"),
-      threadId: string2().optional().describe("the configured Thread Live Preview to bind, thr_…; omit to clear")
+      threadId: string2().optional().describe("the configured Thread Live Preview to bind, thr_… or a short id like BUD-34; omit to clear")
     },
     surfaces: ["cli"],
     toolset: "artifacts",
@@ -12759,7 +12775,7 @@ var ACTION_DEFINITIONS = [
     title: "Request a contribution or review",
     description: "Request a contribution or review on a Thread: omit aboutContributionId for a contribution answered via respond, or pass it for a review answered only by stamp; explicitly target yourself for a normal Inbox obligation, target other people, or leave it open. Choose completion/deadline and optionally opensAt/opensIn to keep it dormant until scheduled delivery; fulfill a self-target through respond or use cancel_request to retire it.",
     inputSchema: {
-      threadId: string2().describe("the thread the request is in, thr_…"),
+      threadId: string2().describe("the thread the request is in, thr_… or a short id like BUD-34"),
       requestedAction: string2().optional().describe("a one-line 'what you're requesting'"),
       requestedType: _enum(CONTRIBUTION_TYPES).optional().describe("the contribution type you're HOPING for (e.g. evidence, decision) — a soft default on the responder's picker, never a constraint; omit for 'any contribution welcome'. Contribution asks only"),
       aboutContributionId: string2().optional().describe("PASS to request a REVIEW of this contribution (con_…, in the thread; met by a stamp, badges that card). OMIT to request a CONTRIBUTION on the thread (met by a respond)."),
@@ -12920,7 +12936,7 @@ var ACTION_DEFINITIONS = [
     title: "Read a thread",
     description: "Read one Thread as compact current context (distillate, requests, artifacts, recent tail, cursored unchanged checks) — not the durable transcript; pass view=full to read contribution bodies and attachments (including Markdown and authenticated URLs) and page history (contribLimit default 50) or all=true for the complete transcript. Read it before contributing so you can answer open requests correctly.",
     inputSchema: {
-      threadId: string2().describe("the thread id, e.g. thr_…"),
+      threadId: string2().describe("the thread id, e.g. thr_…, or its short id, e.g. BUD-34"),
       view: _enum(["full", "compact"]).optional().describe("MCP/CLI/API default compact = bounded decision-ready context; full = transcript page"),
       cursor: string2().optional().describe("compact reads only: cursor from the previous compact response; if context is unchanged the response collapses to a tiny unchanged envelope"),
       recentLimit: number2().int().min(1).max(20).optional().describe("compact reads only: latest contributions to include (default 6, max 20)"),
@@ -13091,7 +13107,7 @@ var ACTION_DEFINITIONS = [
     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: string2().describe("the contributing thread, thr_…"),
+      threadId: string2().describe("the contributing thread, thr_… or a short id like BUD-34"),
       initiativeId: string2().describe("the goal it serves, ini_…")
     },
     surfaces: ["cli"],
@@ -13103,7 +13119,7 @@ var ACTION_DEFINITIONS = [
     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: string2().describe("the thread to unlink, thr_…"),
+      threadId: string2().describe("the thread to unlink, thr_… or a short id like BUD-34"),
       initiativeId: string2().describe("the goal to unlink it from, ini_…")
     },
     surfaces: ["cli"],
@@ -13128,7 +13144,7 @@ var ACTION_DEFINITIONS = [
     description: "List compact goals attached to one Space, or a Thread's linked goals plus its available pick list. Space lists are compact cards; Thread lists page only the available `all` list and keep `linked` complete; view=summary returns 3 active goals; status pages named lifecycles before the page.",
     inputSchema: {
       spaceId: string2().optional().describe("a Space whose attached goals to list, spc_…"),
-      threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_…"),
+      threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_… or a short id like BUD-34"),
       view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Ignores status. Omit for the attached list."),
       status: union([
         _enum(["active", "paused", "completed", "archived"]),
@@ -13182,6 +13198,7 @@ var ACTION_DEFINITIONS = [
     description: "Create a Space when work needs its own durable collaboration/governance boundary — its own membership, visibility, shared norms, and multiple durable areas; you become its first admin (org owner/admins always can, other members only when enabled), with open/private visibility and optional seeded members. If the work can live under an existing Space with the same people and governance, use a Topic instead.",
     inputSchema: {
       title: string2().min(1).describe("the space title"),
+      key: SPACE_KEY_INPUT.optional().describe("thread short-id prefix (BUD in BUD-34): 1-10 letters/digits, starting with a letter, unique in the org; default: the title's first three letters"),
       purpose: string2().optional().describe("why this boundary exists and what it is around — commonly a Product/System, Program/Function, Portfolio/Network, or Practice/Community — plus its dominant work modes (Build, Operate, Coordinate, Discuss, Share) when that helps; plain prose, not metadata syntax"),
       visibility: _enum(["open", "private"]).optional().describe("open (default) or private (invite-only)"),
       memberProfileIds: array(string2()).optional().describe("org profile ids to seed as members — agents added directly, humans get a pending invite")
@@ -13198,6 +13215,7 @@ var ACTION_DEFINITIONS = [
       spaceId: string2().describe("the space, spc_…"),
       purpose: string2().optional().describe("why this boundary exists and what it is around — commonly a Product/System, Program/Function, Portfolio/Network, or Practice/Community — plus its dominant work modes (Build, Operate, Coordinate, Discuss, Share) when that helps; plain prose, not metadata syntax"),
       title: string2().optional().describe("a new title for the space"),
+      key: SPACE_KEY_INPUT.optional().describe("a new thread short-id prefix (BUD in BUD-34), unique in the org; every thread's short id changes, the old ones stop resolving, and the old key stays reserved to this Space"),
       visibility: _enum(["open", "private"]).optional().describe("open or private (invite-only)"),
       stage: _enum(["exploration", "design", "implementation", "maintenance", "retired"]).optional().describe("set the lifecycle stage; retired archives the Space reversibly and restores with an active stage, but only when no Run is active/suspended and no App is serving"),
       attachWorkflow: string2().optional().describe("add a workflow to this Space's list: a built-in id (`standard`, `queue`, `content`, `experiment`, `funnel`) or a catalog `wfl_…` from `workflow_list`"),
@@ -13408,7 +13426,7 @@ var ACTION_DEFINITIONS = [
     title: "Inspect a thread (superadmin)",
     description: "Platform-operator only: read any thread by id across orgs (its contributions + authors), bypassing the per-org membership boundary for oversight.",
     inputSchema: {
-      threadId: string2().min(1).describe("the thread id, e.g. thr_…")
+      threadId: string2().min(1).describe("the canonical thread id, e.g. thr_… (admin reads are cross-org)")
     },
     surfaces: ["cli"],
     toolset: "admin",
@@ -13429,7 +13447,7 @@ var ACTION_DEFINITIONS = [
     description: "List compact goals attached to one Space, or the linked and available goals for one Thread. Space pages omit relatedThreads; Thread pages keep linked complete and page only the available `all` list; view=summary returns 3 active goals; status pages named lifecycles before the page; it cannot mutate a goal.",
     inputSchema: {
       spaceId: string2().optional().describe("a Space whose attached goals to list, spc_…"),
-      threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_…"),
+      threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_… or a short id like BUD-34"),
       view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Ignores status. Omit for the attached list."),
       status: union([
         _enum(["active", "paused", "completed", "archived"]),
@@ -13461,7 +13479,7 @@ var ACTION_DEFINITIONS = [
       threadIds: array(string2()).optional().describe("create: threads to link at birth"),
       id: string2().optional().describe("update/set_status: the goal, ini_…"),
       status: _enum(["active", "paused", "completed", "archived"]).optional().describe("set_status: the new lifecycle state"),
-      threadId: string2().optional().describe("link_thread/unlink_thread: the thread, thr_…"),
+      threadId: string2().optional().describe("link_thread/unlink_thread: the thread, thr_… or a short id like BUD-34"),
       initiativeId: string2().optional().describe("link/unlink/attach/detach: the goal, ini_…")
     },
     surfaces: ["mcp"],
@@ -13645,7 +13663,7 @@ var ACTION_DEFINITIONS = [
       computerSessionId: string2().optional().describe("create: the attached computer session that produced it, cms_…"),
       sourceContributionIds: array(string2()).optional().describe("create: contributions it distills"),
       artifactId: string2().optional().describe("edit/set_live_preview/set_snapshot: the Artifact, art_…"),
-      threadId: string2().optional().describe("set_live_preview: the configured Thread Live Preview, thr_…; omit to clear the binding"),
+      threadId: string2().optional().describe("set_live_preview: the configured Thread Live Preview, thr_… or a short id like BUD-34; omit to clear the binding"),
       baseVersion: number2().optional().describe("edit: the version you READ (from get/create) — stale base is rejected with the current source"),
       patches: array(object({ old: string2(), new: string2() })).optional().describe("edit: exact-match hunks applied in order, atomically; each old must match exactly once"),
       note: string2().optional().describe("edit: one-line summary of what changed"),
@@ -14320,7 +14338,7 @@ var ACTION_DEFINITIONS = [
       topicId: string2().optional().describe("topic_guidance/topic_lanes: the topic, top_…"),
       guidance: proseList("space_guidance/topic_guidance: full list, replaces; [] clears").optional(),
       contributionLanes: proseList("space_lanes/topic_lanes: full list of ways to help, replaces; [] clears").optional(),
-      threadId: string2().optional().describe("ways_to_help: the thread, thr_…"),
+      threadId: string2().optional().describe("ways_to_help: the thread, thr_… or a short id like BUD-34"),
       waysToHelp: proseList("ways_to_help: full list, replaces; [] clears").optional()
     },
     surfaces: ["mcp"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.24.3",
+  "version": "0.24.5",
   "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",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "scripts": {
-    "arbor": "tsx src/bin.ts",
+    "arbor": "vpx src/bin.ts",
     "build": "bun build ./src/bin.ts --target=node --outfile=dist/arbor.js",
     "test": "vp test run --passWithNoTests",
     "typecheck": "tsc -b",
@@ -38,7 +38,6 @@
     "@arbor/core": "workspace:*",
     "@types/node": "^26.2.0",
     "just-bash": "3.4.2",
-    "tsx": "^4.20.6",
     "typescript": "^5.8.0",
     "vite-plus": "catalog:",
     "zod": "^4.4.3"