@linktr.ee/arbor-mcp 0.2.0 → 0.4.0-rc.ef036d0d6.7141

package/README.md

@@ -6,7 +6,10 @@ Claude Desktop, Cursor, Zed, etc.).
 
 ## What it does
 
-Currently registers a single tool:
+Registers a set of read-only Arbor design system tools. The
+component-resolution tool is documented in detail below; the DS-as-data
+metadata tools (component inventory, single-component lookup, version
+history) are described under [DS-as-data tools](#ds-as-data-tools).
 
 ### `arbor_open_in_playroom`
 
@@ -54,6 +57,52 @@ and no `slug`.
 > on the Figma plugin's selection-driven node-ID path. This by-name MCP tool
 > never returns it — its `outputSchema` is `mapped | not_found`.
 
+## DS-as-data tools
+
+Three read-only metadata tools (shipping in a forthcoming release) expose the
+design system as queryable data. They answer "what components / versions exist"
+— **not** token values. (For token values, read the compiled CSS in
+`packages/design-tokens/dist/web/` or the shadcn `registry.json`, which are
+fresher.)
+
+- **`arbor_list_versions`** — design system version history: each entry is
+  `{ id, name, createdAt, readOnly }`.
+- **`arbor_list_components`** — component inventory: `name`, `id`, and a short
+  `description` per component. Returns top-level components only (Figma variant
+  instances are filtered out). Accepts an optional case-insensitive `query`
+  string that filters by name or description.
+- **`arbor_get_component`** — one component's metadata, looked up by `name`
+  (case-insensitive) or `id`. Returns `{ found, component }`.
+
+(A fourth tool, `arbor_get_docs`, is deliberately **not** built yet — deferred
+until a docs page-content route exists.)
+
+### Runtime config + graceful degradation
+
+These tools read the design system's metadata from an internal Lambda
+federation proxy. The proxy **URL is built in** (override with
+`ARBOR_MCP_SUPERNOVA_PROXY_URL`). While the route is access-gated, also set
+`ARBOR_MCP_SUPERNOVA_PROXY_TOKEN` — one shared internal value provisioned by
+the Arbor team (not a per-engineer token, and never bundled in this package).
+If the route is open, the tools work with no configuration at all:
+
+| Variable                          | Purpose                                                  |
+| --------------------------------- | -------------------------------------------------------- |
+| `ARBOR_MCP_SUPERNOVA_PROXY_URL`   | Full proxy URL, including the `/supernova/query` path     |
+| `ARBOR_MCP_SUPERNOVA_PROXY_TOKEN` | Shared inbound bearer token presented to the proxy        |
+
+When either var is unset — or the proxy is unreachable — the tools **degrade
+gracefully**: they return a successful result with `source: "unavailable"` and
+a `detail` string explaining why. They never throw and never crash the server.
+An agent should treat `"unavailable"` as "couldn't reach the data" rather than
+"the design system has no components/versions."
+
+> **Metadata, not token values.** These tools surface Supernova *metadata*
+> (component names, ids, descriptions, version history) only. They deliberately
+> do **not** return token values — those live in the compiled CSS
+> (`packages/design-tokens/dist/web/`) and the shadcn `registry.json`, which are
+> the fresher source of truth.
+
 ## Install
 
 The package is published publicly to npm as `@linktr.ee/arbor-mcp`. The

package/dist/index.js

@@ -1582,8 +1582,8 @@ var require_lz_string = __commonJS({
 var require_hash_code = __commonJS({
   "../../apps/playroom/src/hash-code.js"(exports, module) {
     "use strict";
-    function hashCode2(str2) {
-      var s = String(str2 == null ? "" : str2);
+    function hashCode2(str3) {
+      var s = String(str3 == null ? "" : str3);
       var h = 2166136261;
       for (var i = 0; i < s.length; i++) {
         h ^= s.charCodeAt(i);
@@ -5913,14 +5913,247 @@ var checkUxWritingTool = {
   handler: handleCheckUxWriting
 };
 
+// src/lib/supernova-client.ts
+var CACHE_TTL_MS2 = 5 * 60 * 1e3;
+var DEFAULT_TIMEOUT_MS2 = 9e3;
+var DEFAULT_MAX_CHARS2 = 4e6;
+var DEFAULT_PROXY_URL = "https://on7uu5jns5nmsusrk6gg3suu640clium.lambda-url.us-west-2.on.aws/supernova/query";
+var moduleCache2 = /* @__PURE__ */ new Map();
+function statusReason(status) {
+  if (status === 401) return "unauthorized";
+  if (status === 400) return "bad_request";
+  if (status === 502) return "upstream_error";
+  if (status === 503) return "upstream_unconfigured";
+  return "http_error";
+}
+async function querySupernova(resource, opts = {}) {
+  const {
+    designSystemId,
+    versionId,
+    proxyUrl = process.env.ARBOR_MCP_SUPERNOVA_PROXY_URL ?? "",
+    proxyToken = process.env.ARBOR_MCP_SUPERNOVA_PROXY_TOKEN ?? "",
+    fetchImpl = globalThis.fetch,
+    now = Date.now,
+    cache = moduleCache2,
+    timeoutMs = DEFAULT_TIMEOUT_MS2,
+    maxChars = DEFAULT_MAX_CHARS2
+  } = opts;
+  const url = proxyUrl || DEFAULT_PROXY_URL;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return { ok: false, reason: "not_configured", detail: `proxy URL is not valid: ${url}` };
+  }
+  if (parsed.protocol !== "https:") {
+    return { ok: false, reason: "not_configured", detail: `proxy URL must be https (got ${parsed.protocol})` };
+  }
+  const cacheKey = `${resource}|${designSystemId ?? ""}|${versionId ?? ""}`;
+  const cached = cache.get(cacheKey);
+  if (cached && now() - cached.fetchedAt < CACHE_TTL_MS2) return cached.value;
+  const body = { resource };
+  if (designSystemId) body.designSystemId = designSystemId;
+  if (versionId) body.versionId = versionId;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  let res;
+  let text;
+  try {
+    res = await fetchImpl(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...proxyToken ? { Authorization: `Bearer ${proxyToken}` } : {} },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+      redirect: "error"
+    });
+    text = await res.text();
+  } catch (err) {
+    const e = err;
+    return { ok: false, reason: e && e.name === "AbortError" ? "timeout" : "network", detail: e?.message ?? String(err) };
+  } finally {
+    clearTimeout(timer);
+  }
+  if (!res.ok) {
+    return { ok: false, reason: statusReason(res.status), detail: `HTTP ${res.status} from proxy`, status: res.status };
+  }
+  if (text.length > maxChars) {
+    return { ok: false, reason: "too_large", detail: `${text.length} chars > ${maxChars} cap` };
+  }
+  let envelope;
+  try {
+    envelope = JSON.parse(text);
+  } catch (err) {
+    return { ok: false, reason: "parse_error", detail: err?.message ?? String(err) };
+  }
+  if (envelope.data == null) {
+    return { ok: false, reason: "parse_error", detail: "proxy returned 200 with no data payload" };
+  }
+  const value = {
+    ok: true,
+    data: envelope.data,
+    versionId: typeof envelope.versionId === "string" ? envelope.versionId : null,
+    fetchedAt: typeof envelope.fetchedAt === "string" ? envelope.fetchedAt : null
+  };
+  cache.set(cacheKey, { value, fetchedAt: now() });
+  return value;
+}
+
+// src/tools/list-components.ts
+var TOOL_NAME3 = "arbor_list_components";
+var TOOL_TITLE3 = "List Arbor components";
+var TOOL_DESCRIPTION3 = "List the components in the Arbor design system (name, id, short description) from Supernova via the Arbor federation proxy. Read-only metadata for discovery; returns top-level components, not Figma variants. Does NOT return token values, source code, or props \u2014 use arbor_get_component for one component, the shadcn registry/Storybook for source, arbor_open_in_playroom for a runnable snippet. Does NOT change anything.";
+var inputSchema3 = external_exports.object({ query: external_exports.string().trim().min(1).max(100).optional().describe("Optional case-insensitive name/description filter") }).strict();
+var outputSchema3 = external_exports.object({
+  source: external_exports.enum(["remote", "unavailable"]),
+  total: external_exports.number(),
+  components: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string(), description: external_exports.string().nullable() })),
+  detail: external_exports.string().nullable()
+});
+var annotations3 = { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false };
+function extractComponents(data) {
+  const list = data?.result?.components;
+  if (!Array.isArray(list)) return null;
+  return list.filter((c) => {
+    if (!c || typeof c !== "object") return false;
+    const parent = c.parentComponentPersistentId;
+    return !(typeof parent === "string" && parent.length > 0);
+  }).map((c) => {
+    const meta = c.meta && typeof c.meta === "object" ? c.meta : {};
+    const name = typeof meta.name === "string" && meta.name.length > 0 ? meta.name : "(unnamed)";
+    const desc = typeof meta.description === "string" ? meta.description.trim() : "";
+    return { id: String(c.id ?? ""), name, description: desc.length > 0 ? desc : null };
+  });
+}
+async function handleListComponents(args, deps = {}) {
+  const query = deps.query ?? ((r) => querySupernova(r));
+  const result = await query("components");
+  let out;
+  const extracted = result.ok ? extractComponents(result.data) : null;
+  if (!result.ok) {
+    out = { source: "unavailable", total: 0, components: [], detail: `could not load components (${result.reason})` };
+  } else if (extracted === null) {
+    out = { source: "unavailable", total: 0, components: [], detail: "proxy returned an unrecognized components payload" };
+  } else {
+    let components = extracted;
+    const q = args.query?.toLowerCase();
+    if (q) {
+      components = components.filter(
+        (c) => c.name.toLowerCase().includes(q) || (c.description ? c.description.toLowerCase().includes(q) : false)
+      );
+    }
+    out = { source: "remote", total: components.length, components, detail: null };
+  }
+  const summary = out.source === "unavailable" ? `Could not load components (${out.detail}). Treat as unavailable \u2014 do not assume there are none.` : `${out.total} component${out.total === 1 ? "" : "s"}${args.query ? ` matching "${args.query}"` : ""}.`;
+  return { content: [{ type: "text", text: summary }], structuredContent: out };
+}
+var listComponentsTool = {
+  name: TOOL_NAME3,
+  config: { title: TOOL_TITLE3, description: TOOL_DESCRIPTION3, inputSchema: inputSchema3, outputSchema: outputSchema3, annotations: annotations3 },
+  handler: handleListComponents
+};
+
+// src/tools/get-component.ts
+var TOOL_NAME4 = "arbor_get_component";
+var TOOL_TITLE4 = "Get one Arbor component";
+var TOOL_DESCRIPTION4 = "Get a single Arbor component's metadata by name (case-insensitive) or id from Supernova via the Arbor federation proxy (name, id, description). Read-only; matches top-level components, not Figma variants. Does NOT return token values or rendered source \u2014 use the shadcn registry / Storybook for implementation and arbor_open_in_playroom for a runnable snippet. Does NOT change anything.";
+var inputSchema4 = external_exports.object({
+  name: external_exports.string().trim().min(1).max(100).optional().describe('Component name (case-insensitive), e.g. "Button"'),
+  id: external_exports.string().trim().min(1).max(100).optional().describe("Supernova component id")
+}).strict();
+var outputSchema4 = external_exports.object({
+  source: external_exports.enum(["remote", "unavailable"]),
+  found: external_exports.boolean(),
+  component: external_exports.object({ id: external_exports.string(), name: external_exports.string(), description: external_exports.string().nullable() }).nullable(),
+  detail: external_exports.string().nullable()
+});
+var annotations4 = { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false };
+async function handleGetComponent(args, deps = {}) {
+  const name = args.name?.trim();
+  const id = args.id?.trim();
+  if (!name && !id) {
+    const out2 = { source: "remote", found: false, component: null, detail: "provide name or id" };
+    return {
+      content: [{ type: "text", text: 'Provide a component name or id \u2014 e.g. {"name":"Button"} or {"id":"35988997"}.' }],
+      structuredContent: out2
+    };
+  }
+  const query = deps.query ?? ((r) => querySupernova(r));
+  const result = await query("components");
+  let out;
+  if (!result.ok) {
+    out = { source: "unavailable", found: false, component: null, detail: `could not load components (${result.reason})` };
+  } else {
+    const components = extractComponents(result.data);
+    if (components === null) {
+      out = { source: "unavailable", found: false, component: null, detail: "proxy returned an unrecognized components payload" };
+    } else {
+      const match = id ? components.find((c) => c.id === id) : components.find((c) => c.name.toLowerCase() === name.toLowerCase());
+      out = match ? { source: "remote", found: true, component: match, detail: null } : { source: "remote", found: false, component: null, detail: `no component ${id ? `with id ${id}` : `named "${name}"`}` };
+    }
+  }
+  const summary = out.source === "unavailable" ? `Could not load components (${out.detail}). Treat as unavailable.` : out.found ? `${out.component.name}${out.component.description ? ` \u2014 ${out.component.description}` : " (no description)"}.` : `No Arbor component ${args.id ? `with id ${args.id.trim()}` : `named "${args.name?.trim()}"`} exists.`;
+  return { content: [{ type: "text", text: summary }], structuredContent: out };
+}
+var getComponentTool = {
+  name: TOOL_NAME4,
+  config: { title: TOOL_TITLE4, description: TOOL_DESCRIPTION4, inputSchema: inputSchema4, outputSchema: outputSchema4, annotations: annotations4 },
+  handler: handleGetComponent
+};
+
+// src/tools/list-versions.ts
+var TOOL_NAME5 = "arbor_list_versions";
+var TOOL_TITLE5 = "List Arbor design system versions";
+var TOOL_DESCRIPTION5 = "List the version history of the Arbor design system (id, name, created date, read-only flag) from Supernova via the Arbor federation proxy. Read-only metadata. Does NOT return token values (use the compiled CSS / registry) and does NOT change anything.";
+var inputSchema5 = external_exports.object({}).strict();
+var outputSchema5 = external_exports.object({
+  source: external_exports.enum(["remote", "unavailable"]).describe("'remote' = fetched; 'unavailable' = proxy fetch failed"),
+  total: external_exports.number().describe("Number of versions returned"),
+  versions: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string(), createdAt: external_exports.string().nullable(), readOnly: external_exports.boolean().nullable() })).describe("Versions, in the order Supernova returned them"),
+  detail: external_exports.string().nullable().describe("Degraded reason when source is unavailable")
+});
+var annotations5 = { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false };
+function extractList(data) {
+  const wrapped = data?.result?.designSystemVersions;
+  const list = Array.isArray(wrapped) ? wrapped : Array.isArray(data) ? data : null;
+  if (list === null) return null;
+  return list.filter((x) => !!x && typeof x === "object");
+}
+var str2 = (v) => typeof v === "string" && v.length > 0 ? v : null;
+async function handleListVersions(_args, deps = {}) {
+  const query = deps.query ?? ((r) => querySupernova(r));
+  const result = await query("versions");
+  let out;
+  const list = result.ok ? extractList(result.data) : null;
+  if (!result.ok) {
+    out = { source: "unavailable", total: 0, versions: [], detail: `could not load versions (${result.reason})` };
+  } else if (list === null) {
+    out = { source: "unavailable", total: 0, versions: [], detail: "proxy returned an unrecognized versions payload" };
+  } else {
+    const versions = list.map((v) => ({
+      id: String(v.id ?? ""),
+      name: str2(v.version) ?? str2(v.name) ?? "(unnamed)",
+      createdAt: str2(v.createdAt),
+      readOnly: typeof v.isReadonly === "boolean" ? v.isReadonly : null
+    }));
+    out = { source: "remote", total: versions.length, versions, detail: null };
+  }
+  const summary = out.source === "unavailable" ? `Could not load design system versions (${out.detail}). Treat as unavailable \u2014 do not assume there are none.` : `${out.total} design system version${out.total === 1 ? "" : "s"}: ${out.versions.map((v) => v.name).join(", ") || "(none)"}.`;
+  return { content: [{ type: "text", text: summary }], structuredContent: out };
+}
+var listVersionsTool = {
+  name: TOOL_NAME5,
+  config: { title: TOOL_TITLE5, description: TOOL_DESCRIPTION5, inputSchema: inputSchema5, outputSchema: outputSchema5, annotations: annotations5 },
+  handler: handleListVersions
+};
+
 // src/tools/lookup-decision.ts
 var ARTIFACT2 = "decision-log.json";
 var CHARACTER_LIMIT = 25e3;
 var DEFAULT_LIMIT = 5;
-var TOOL_NAME3 = "arbor_lookup_decision";
-var TOOL_TITLE3 = "Look up an Arbor decision-log entry";
-var TOOL_DESCRIPTION3 = 'Look up Arbor decision-log entries \u2014 the record of WHY design-system decisions were made \u2014 by id (e.g. "DL-067"), tag, or keyword. Keyword search spans the title, tags, and every section (context, decision, outcome, rationale, lessons, references, \u2026). Results are newest-first and paginated. Use this for "why did Arbor decide X?" / "what resolved <problem>?". Does NOT return component metadata or token values (those are separate); it is the decision/rationale record only.';
-var inputSchema3 = external_exports.object({
+var TOOL_NAME6 = "arbor_lookup_decision";
+var TOOL_TITLE6 = "Look up an Arbor decision-log entry";
+var TOOL_DESCRIPTION6 = 'Look up Arbor decision-log entries \u2014 the record of WHY design-system decisions were made \u2014 by id (e.g. "DL-067"), tag, or keyword. Keyword search spans the title, tags, and every section (context, decision, outcome, rationale, lessons, references, \u2026). Results are newest-first and paginated. Use this for "why did Arbor decide X?" / "what resolved <problem>?". Does NOT return component metadata or token values (those are separate); it is the decision/rationale record only.';
+var inputSchema6 = external_exports.object({
   id: external_exports.string().optional().describe('A specific decision id, e.g. "DL-067" (a bare "67" also resolves)'),
   tag: external_exports.string().optional().describe('Filter to entries carrying this tag (case-insensitive), e.g. "tokens"'),
   query: external_exports.string().optional().describe("Keyword search across title, tags, and all sections (case-insensitive)"),
@@ -5938,7 +6171,7 @@ var decisionEntrySchema = external_exports.object({
   tags: external_exports.array(external_exports.string()),
   sections: external_exports.array(sectionSchema).describe("Ordered sections (Context, Decision, \u2026, plus any non-standard headings)")
 });
-var outputSchema3 = external_exports.object({
+var outputSchema6 = external_exports.object({
   total: external_exports.number().describe("Total entries matching the filter (before pagination)"),
   count: external_exports.number().describe("Entries actually returned (after pagination + character budget)"),
   offset: external_exports.number(),
@@ -5949,7 +6182,7 @@ var outputSchema3 = external_exports.object({
   stale: external_exports.boolean().describe("True when the snapshot is older than the freshness threshold (or unavailable)"),
   entries: external_exports.array(decisionEntrySchema)
 });
-var annotations3 = {
+var annotations6 = {
   readOnlyHint: true,
   idempotentHint: true,
   openWorldHint: true,
@@ -6065,13 +6298,13 @@ ${included.map(renderEntry).join("\n\n---\n\n")}${note}`;
   };
 }
 var lookupDecisionTool = {
-  name: TOOL_NAME3,
+  name: TOOL_NAME6,
   config: {
-    title: TOOL_TITLE3,
-    description: TOOL_DESCRIPTION3,
-    inputSchema: inputSchema3,
-    outputSchema: outputSchema3,
-    annotations: annotations3
+    title: TOOL_TITLE6,
+    description: TOOL_DESCRIPTION6,
+    inputSchema: inputSchema6,
+    outputSchema: outputSchema6,
+    annotations: annotations6
   },
   handler: handleLookupDecision
 };
@@ -7185,7 +7418,7 @@ var { hashCode } = require_hash_code();
 var MAX_SNIPPET_BYTES = 200 * 1024;
 var SLUG_PATTERN = /^[a-z]{3,11}-[a-z]{3,11}-[a-z]{3,11}-(?:[1-9]|[1-9][0-9])$/;
 var PLAYROOM_BASE_URL = "https://arbor.linktr.ee/playroom/";
-var DEFAULT_TIMEOUT_MS2 = 5e3;
+var DEFAULT_TIMEOUT_MS3 = 5e3;
 function createInMemoryCache() {
   const store = /* @__PURE__ */ new Map();
   return {
@@ -7216,7 +7449,7 @@ function createSlugClient(opts) {
     );
   }
   const cache = opts.cache ?? createInMemoryCache();
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS3;
   const endpointUrl = opts.endpoint.toString();
   const inflight = /* @__PURE__ */ new Map();
   async function performMint(jsx, key, mintOpts) {
@@ -7304,14 +7537,14 @@ function extractSlug(payload) {
 }
 
 // src/tools/open-in-playroom.ts
-var TOOL_NAME4 = "arbor_open_in_playroom";
+var TOOL_NAME7 = "arbor_open_in_playroom";
 var DEPRECATED_TOOL_ALIAS = "arbor.open_in_playroom";
-var TOOL_TITLE4 = "Open in Playroom";
-var TOOL_DESCRIPTION4 = `Given an Arbor component name (PascalCase), return the Playroom URL with the canonical snippet pre-loaded. coverage="mapped" resolves to a canonical snippet (use with high confidence); coverage="not_found" links to the Playroom homepage (surface this to the human rather than following it silently). Does NOT do fuzzy/Figma-name matching \u2014 that is the Figma plugin's selection-driven path.`;
-var inputSchema4 = external_exports.object({
+var TOOL_TITLE7 = "Open in Playroom";
+var TOOL_DESCRIPTION7 = `Given an Arbor component name (PascalCase), return the Playroom URL with the canonical snippet pre-loaded. coverage="mapped" resolves to a canonical snippet (use with high confidence); coverage="not_found" links to the Playroom homepage (surface this to the human rather than following it silently). Does NOT do fuzzy/Figma-name matching \u2014 that is the Figma plugin's selection-driven path.`;
+var inputSchema7 = external_exports.object({
   componentName: external_exports.string().trim().min(1, "componentName is required and must be a non-empty string").describe('Arbor PascalCase component name, e.g. "Button" or "HeaderBar"')
 }).strict();
-var outputSchema4 = external_exports.object({
+var outputSchema7 = external_exports.object({
   coverage: external_exports.enum(["mapped", "not_found"]).describe("mapped = resolved to a canonical snippet; not_found = no match, URL is the Playroom home"),
   url: external_exports.string().describe("Playroom URL \u2014 a ?slug= link, an lz-string #?code= fallback, or the homepage"),
   arborComponentName: external_exports.string().optional().describe("Resolved Arbor component name (mapped only)"),
@@ -7322,7 +7555,7 @@ var outputSchema4 = external_exports.object({
   degraded: external_exports.literal(true).optional().describe("True when slug minting failed and the URL fell back to lz-string"),
   reason: external_exports.enum(["timeout", "http_error", "network", "oversize", "malformed_response", "unconfigured"]).optional().describe("Why the result is degraded")
 });
-var annotations4 = {
+var annotations7 = {
   readOnlyHint: false,
   idempotentHint: true,
   openWorldHint: true,
@@ -7423,14 +7656,14 @@ async function handleOpenInPlayroom(args) {
   };
 }
 var openInPlayroomTool = {
-  name: TOOL_NAME4,
+  name: TOOL_NAME7,
   aliases: [DEPRECATED_TOOL_ALIAS],
   config: {
-    title: TOOL_TITLE4,
-    description: TOOL_DESCRIPTION4,
-    inputSchema: inputSchema4,
-    outputSchema: outputSchema4,
-    annotations: annotations4
+    title: TOOL_TITLE7,
+    description: TOOL_DESCRIPTION7,
+    inputSchema: inputSchema7,
+    outputSchema: outputSchema7,
+    annotations: annotations7
   },
   handler: handleOpenInPlayroom
 };
@@ -7465,7 +7698,10 @@ var ARBOR_TOOLS = [
   openInPlayroomTool,
   checkSyncHealthTool,
   checkUxWritingTool,
-  lookupDecisionTool
+  lookupDecisionTool,
+  listVersionsTool,
+  listComponentsTool,
+  getComponentTool
 ];
 function createArborMcpServer() {
   const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linktr.ee/arbor-mcp",
-  "version": "0.2.0",
-  "description": "Model Context Protocol server exposing Arbor design system tools: Playroom snippets, Figma→code sync health, UX-writing checks, and decision-log lookup.",
+  "version": "0.4.0-rc.ef036d0d6.7141",
+  "description": "Model Context Protocol server exposing Arbor design system tools: Playroom snippets, Figma→code sync health, UX-writing checks, decision-log lookup, and federated component/version metadata.",
   "keywords": [
     "arbor",
     "linktree",