@lambdacurry/arbor 0.22.3 → 0.22.5

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.3",
+  version: "0.22.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",
@@ -9463,6 +9463,53 @@ function mcpAnnotationsFor(name) {
   return annotations;
 }
 
+// ../actions/src/skill.ts
+var ARBOR_SKILL_NAME = "arbor";
+var ARBOR_SKILL_DESCRIPTION = "Work in Arbor (arborthreads.com), the team's deliberation room and shared memory for people and agents. " + "Use when you need to decide something with teammates or agents, record what was settled, check what you owe (inbox, requests, reviews), " + "recall prior decisions before re-deriving them, post evidence or a proposal to a Thread, keep a durable output as an Artifact, " + "or run software work on a Thread's Computer. Reach Arbor through its MCP tools or the arbor CLI (npx -y @lambdacurry/arbor@latest).";
+var ARBOR_SKILL_FRONTMATTER = {
+  name: ARBOR_SKILL_NAME,
+  description: ARBOR_SKILL_DESCRIPTION,
+  license: "MIT"
+};
+var ORIGIN = "https://arborthreads.com";
+function renderArborSkill(orientation) {
+  const base = ORIGIN;
+  const fm = ARBOR_SKILL_FRONTMATTER;
+  return `---
+name: ${fm.name}
+description: "${fm.description}"
+license: ${fm.license}
+---
+
+# Arbor
+
+Arbor is the team's deliberation room and shared memory: people and agents settle typed work in
+Spaces → Topics → Threads, review each other's contributions, and promote the durable ones into
+Artifacts Arbor keeps current. Use it to decide things with others and to remember what was decided.
+
+## Reaching Arbor
+
+- **MCP** — two servers over one identity. \`${base}/mcp\` is collaboration + durable knowledge
+  (Spaces, Topics, Threads, contributions, requests, reviews, Goals, Artifacts, recall, inbox).
+  \`${base}/computer/mcp\` is Arbor Computer, the software workflow (open, run, verify, package,
+  deploy, operate). If the tools are already connected in this session, use them directly.
+- **CLI** — \`npx -y @lambdacurry/arbor@latest <command>\` (or \`arbor <command>\` when installed). The
+  same actions as MCP; \`arbor help\` lists every command with a when-to-use and an example, and
+  \`arbor <command> --help\` gives that command's flags. Long bodies go in via \`--body-file -\` (stdin).
+  Add \`--json\` for a structured envelope.
+- **Auth** — a personal access token (acts as its human) or an agent key (acts as the agent), sent as
+  a Bearer header to MCP or as \`ARBOR_TOKEN\` / \`arbor auth <token>\` for the CLI. Identity is resolved
+  server-side from the credential; never assert who you are. Not connected yet? \`${base}/connect.md\`
+  walks the setup for each client.
+- **Start** with \`whoami\` (confirm who you are acting as) and \`inbox\` (what you owe). Then follow the
+  etiquette below — it is the same text Arbor sends as MCP \`instructions\` at connect and prints from
+  \`arbor orient\`.
+
+## How to work well in Arbor
+
+${orientation}
+`;
+}
 // ../actions/src/index.ts
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
 var CONTRIBUTION_ADD_LINK_RELS = [
@@ -9491,6 +9538,7 @@ Arbor's MCP is the collaboration and durable-knowledge surface. Configure, autho
 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\` verb=create with kind doc/table/diagram/html + \`source\`, or promote a file) instead of pasting it into prose. Text-kind artifacts are LIVING: \`artifact_get\` it, then \`artifact\` verb=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.`;
+var ARBOR_SKILL_MARKDOWN = renderArborSkill(ORIENTATION);
 var COMPUTER_ORIENTATION = `Long Computer work returns a handle — do not hold one tool call for a full test or build. \`computer_exec\` runs a command; if the result is still running, take \`processId\` and poll \`computer_process_read\`. Do not chain \`pnpm test && pnpm build\` in one exec; split steps or pass \`background:true\`. The CLI waits on the same handle unless \`--no-wait\`.
 
 Arbor Computer is the complete software execution platform attached to Arbor's durable collaboration graph. It configures project environments, executes and verifies work, packages and releases Apps, and preserves reviewable evidence; it does not schedule agents or replace Arbor collaboration.
@@ -10138,7 +10186,7 @@ var ACTION_DEFINITIONS = [
     description: "DESTRUCTIVE REPLACE: Replace the organization's entire sparse Computer-default layer; omitted fields are cleared from this layer and fall back to provider defaults, while lower scopes may override. This is config only and allocates no runtime; repeating the same full layer is idempotent.",
     inputSchema: {
       backend: _enum(["worker-shell", "container"]).nullable().optional().describe("default execution tier, or null to use worker-shell"),
-      containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.3.3, bunx, Node 26.5.1, pnpm 10.33.0, Python 3.13.15 (python/python3), jq, and ripgrep (rg), or null to clear"),
+      containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.4.1, bunx, Node 26.5.1, pnpm 10.33.0, Python 3.13.15 (python/python3), jq, and ripgrep (rg), or null to clear"),
       setupScript: string2().nullable().optional().describe("optional strict Bash setup run after connected repositories materialize, or null to clear"),
       repositories: array(string2()).max(MAX_COMPUTER_REPOSITORIES).nullable().optional().describe("connected GitHub repositories to materialize into a fresh reusable base and allow for later Git calls; [] clears and null inherits")
     },
@@ -10153,7 +10201,7 @@ var ACTION_DEFINITIONS = [
     inputSchema: {
       spaceId: string2().describe("the Space, spc_…"),
       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.3.3, 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"),
+      containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.4.1, 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 run after connected repositories materialize, or null to clear"),
       repositories: array(string2()).max(MAX_COMPUTER_REPOSITORIES).nullable().optional().describe("connected GitHub repositories to materialize into a fresh reusable base and allow for later Git calls; [] clears and null inherits")
     },
@@ -10168,7 +10216,7 @@ var ACTION_DEFINITIONS = [
     inputSchema: {
       topicId: string2().describe("the Topic, top_…"),
       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.3.3, 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"),
+      containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.4.1, 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 run after connected repositories materialize"),
       repositories: array(string2()).max(MAX_COMPUTER_REPOSITORIES).nullable().optional().describe("connected GitHub repositories to materialize into a fresh reusable base and allow for later Git calls; [] clears and null inherits"),
       ...LIVE_PREVIEW_CONFIG_INPUT
@@ -10184,7 +10232,7 @@ var ACTION_DEFINITIONS = [
     inputSchema: {
       threadId: string2().describe("the Thread, thr_…"),
       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.3.3, 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"),
+      containerProfile: string2().nullable().optional().describe("logical container profile; bun-typescript-v1 guarantees Bash, Git, GitHub CLI (gh), Bun 1.4.1, 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 run after connected repositories materialize"),
       repositories: array(string2()).max(MAX_COMPUTER_REPOSITORIES).nullable().optional().describe("connected GitHub repositories to materialize into a fresh reusable base and allow for later Git calls; [] clears and null inherits"),
       ...LIVE_PREVIEW_CONFIG_INPUT
@@ -13665,6 +13713,13 @@ function renderOrient(ctx) {
 ${CLI_NOTE}
 `, "orient", ctx);
 }
+function renderSkill(ctx) {
+  emitDual({
+    name: ARBOR_SKILL_NAME,
+    description: ARBOR_SKILL_DESCRIPTION,
+    markdown: ARBOR_SKILL_MARKDOWN
+  }, ARBOR_SKILL_MARKDOWN, "skill", ctx);
+}
 function renderVersion(ctx) {
   emitDual({ name: package_default.name, version: CLI_VERSION }, `arbor ${CLI_VERSION}
 `, "version", ctx);
@@ -13688,6 +13743,7 @@ Usage: arbor <command> [--flags]
   profile clear-default      intentionally return ordinary commands to legacy config
   profile delete <name>      delete a non-default named profile
   orient                    print how to work well in Arbor (the room etiquette — when + why)
+  skill                     print the Arbor Agent Skill (SKILL.md) to install in any skills-aware host
   whoami                    print who your token resolves to
   logout                    forget the stored token
   version                   print the CLI version
@@ -13875,6 +13931,9 @@ ${CLI_NOTE}
       case "orient":
         renderOrient(ctx);
         return;
+      case "skill":
+        renderSkill(ctx);
+        return;
       case "health":
         await renderHealth(ctx);
         return;

package/package.json

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