@linktr.ee/arbor-mcp 0.6.0 → 0.8.0

package/dist/index.js

@@ -6178,6 +6178,7 @@ function coerceEntry(raw) {
     notWhen: asStringArray(r.notWhen),
     disambiguateFrom: asDisambiguations(r.disambiguateFrom),
     guideline: typeof r.guideline === "string" ? r.guideline : null,
+    implementation: typeof r.implementation === "string" ? r.implementation : null,
     decisions: asStringArray(r.decisions)
   };
 }
@@ -6291,7 +6292,7 @@ var listComponentsTool = {
 // 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 (name, id, description) PLUS its intention overlay \u2014 lifecycle status (shipped | in-progress | design-only | deprecated | researched-not-shipped), when to use it, when NOT to (and what to use instead), and what it is commonly confused with. Intention comes from Arbor's source of truth, so a design-only component absent from the live design data still resolves. 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 TOOL_DESCRIPTION4 = "Get a single Arbor component's metadata by name (case-insensitive) or id (name, id, description) PLUS its intention overlay \u2014 lifecycle status (shipped | in-progress | design-only | deprecated | researched-not-shipped), when to use it, when NOT to (and what to use instead), what it is commonly confused with, and repo paths to its guideline and (when present) agent implementation guidance. Intention comes from Arbor's source of truth, so a design-only component absent from the live design data still resolves. 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"),
@@ -6313,6 +6314,7 @@ var intentionSchema = external_exports.object({
   notWhen: external_exports.array(external_exports.string()).describe("When NOT to reach for it, ideally naming the better alternative"),
   disambiguateFrom: external_exports.array(disambiguationSchema).describe("Things this is commonly confused with"),
   guideline: external_exports.string().nullable().describe("Repo-relative path to the long-form guideline, when one exists"),
+  implementation: external_exports.string().nullable().describe("Repo-relative path to the agent-facing implementation guidance (code-correctness + a11y rules), when one exists"),
   decisions: external_exports.array(external_exports.string()).describe("Decision-log ids (DL-NN) that explain this intention")
 });
 var outputSchema4 = external_exports.object({
@@ -6337,6 +6339,7 @@ async function resolveIntention(lookupName, load) {
     notWhen: match.notWhen,
     disambiguateFrom: match.disambiguateFrom.map((d) => ({ component: d.component, distinction: d.distinction })),
     guideline: match.guideline,
+    implementation: match.implementation,
     decisions: match.decisions
   };
   return { intention, intentionSource: "remote" };
@@ -6418,11 +6421,367 @@ var getComponentTool = {
   handler: handleGetComponent
 };
 
+// src/lib/decisions.ts
+var DECISION_LOG_ARTIFACT = "decision-log.json";
+var decisionSectionSchema = external_exports.object({ heading: external_exports.string(), body: external_exports.string() });
+var decisionEntrySchema = external_exports.object({
+  id: external_exports.string(),
+  number: external_exports.number(),
+  title: external_exports.string(),
+  date: external_exports.string(),
+  status: external_exports.string(),
+  tags: external_exports.array(external_exports.string()),
+  sections: external_exports.array(decisionSectionSchema).describe("Ordered sections (Context, Decision, \u2026, plus any non-standard headings)")
+});
+function coerceEntries(data) {
+  const raw = data ?? {};
+  if (!Array.isArray(raw.entries)) return [];
+  const entries = [];
+  for (const item of raw.entries) {
+    const parsed = decisionEntrySchema.safeParse(item);
+    if (parsed.success) entries.push(parsed.data);
+  }
+  return entries;
+}
+async function loadDecisionEntries(load = loadPublishedJson) {
+  const res = await load(DECISION_LOG_ARTIFACT);
+  if (!res.ok) return { ok: false, reason: res.reason };
+  const raw = res.data;
+  if (raw.degraded === true || !Array.isArray(raw.entries)) {
+    return { ok: false, reason: typeof raw.reason === "string" ? raw.reason : "degraded" };
+  }
+  return {
+    ok: true,
+    entries: coerceEntries(res.data),
+    generatedAt: typeof raw.generatedAt === "string" ? raw.generatedAt : null
+  };
+}
+function decisionSearchBlob(e) {
+  return [e.title, e.tags.join(" "), ...e.sections.map((s) => `${s.heading} ${s.body}`)].join("\n").toLowerCase();
+}
+
+// src/lib/research.ts
+var RESEARCH_ARTIFACT = "research-corpus.json";
+var RESEARCH_AREAS = ["component-research", "principle", "guideline"];
+var AREA_SET = new Set(RESEARCH_AREAS);
+function asStringArray2(v) {
+  return Array.isArray(v) ? v.filter((s) => typeof s === "string") : [];
+}
+function coerceEntry2(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  const path = typeof r.path === "string" ? r.path : "";
+  const area = typeof r.area === "string" ? r.area : "";
+  if (!path || !AREA_SET.has(area)) return null;
+  return {
+    path,
+    area,
+    title: typeof r.title === "string" ? r.title : path,
+    tags: asStringArray2(r.tags),
+    sourceUrls: asStringArray2(r.sourceUrls),
+    crawledAt: typeof r.crawledAt === "string" ? r.crawledAt : null,
+    excerpt: typeof r.excerpt === "string" ? r.excerpt : ""
+  };
+}
+async function loadResearch(load = loadPublishedJson) {
+  const res = await load(RESEARCH_ARTIFACT);
+  if (!res.ok) return { ok: false, reason: res.reason };
+  const data = res.data;
+  if (data.degraded === true || !Array.isArray(data.entries)) {
+    return { ok: false, reason: "degraded" };
+  }
+  const entries = [];
+  for (const raw of data.entries) {
+    const entry = coerceEntry2(raw);
+    if (entry) entries.push(entry);
+  }
+  return { ok: true, entries, generatedAt: typeof data.generatedAt === "string" ? data.generatedAt : null };
+}
+
+// src/lib/judge.ts
+var MAX_PRECEDENTS = 4;
+var MAX_CROSS_SYSTEM = 3;
+var GUIDANCE = `Write the recommendation as four corners \u2014 Recommendation / Why / Risk it removes / Simplest path (what NOT to build) \u2014 citing ONLY what is in this pack: the component intention, the decision precedents, and the cross-system research entries (cite an entry's sourceUrls for the external-DS side of the "Why"). Verify each precedent or research entry actually addresses the question before citing it; presence in the pack is not proof it is on-topic. If nothing addresses it, abstain: recommend escalating to design review rather than synthesizing a precedent. Mark confidence "grounded" only when a precedent directly addresses the question and sources are fresh; "qualified" when evidence is related, intention-only, or stale; "abstain" when nothing addresses it. Default to recommending less.`;
+var CROSS_SYSTEM_NOTE_UNAVAILABLE = "Cross-system research could not be loaded on this surface. The in-repo design-system-judgment skill reads docs/design-system/research/** and guidelines/** directly; over MCP, cite Arbor precedent only and treat the cross-system corner as unavailable.";
+var CROSS_SYSTEM_NOTE_AVAILABLE = `Cross-system evidence from Arbor's research corpus \u2014 cite an entry's sourceUrls (external-DS docs) for the "Why" cross-system corner. Verify each is on-topic; an empty list means the corpus was searched and nothing matched the question.`;
+var STOPWORDS = /* @__PURE__ */ new Set([
+  "should",
+  "could",
+  "would",
+  "what",
+  "which",
+  "when",
+  "where",
+  "does",
+  "with",
+  "this",
+  "that",
+  "have",
+  "from",
+  "into",
+  "about",
+  "need",
+  "want",
+  "make",
+  "using",
+  "there",
+  "their",
+  "them",
+  "they",
+  "will",
+  "just",
+  "also",
+  "than",
+  "then",
+  "some",
+  "such",
+  "only",
+  "more",
+  "most",
+  "over",
+  "component",
+  "arbor"
+]);
+function buildTerms(question, componentName) {
+  const out = /* @__PURE__ */ new Set();
+  const push = (s) => {
+    const t = s.toLowerCase().trim();
+    if (t.length >= 4 && !STOPWORDS.has(t)) out.add(t);
+  };
+  for (const tok of question.split(/[^a-zA-Z0-9]+/)) push(tok);
+  if (componentName) for (const tok of componentName.split(/[^a-zA-Z0-9]+/)) push(tok);
+  return [...out];
+}
+function toPrecedent(e, relevance) {
+  return {
+    id: e.id,
+    title: e.title,
+    date: e.date,
+    status: e.status,
+    tags: e.tags,
+    relevance,
+    sections: e.sections.map((s) => ({ heading: s.heading, body: s.body }))
+  };
+}
+var AREA_RANK = { "component-research": 0, principle: 1, guideline: 2 };
+function matchResearch(entries, terms, max) {
+  if (!terms.length) return [];
+  return entries.map((e) => {
+    const haystack = `${e.title}
+${e.tags.join(" ")}
+${e.path}
+${e.excerpt}`.toLowerCase();
+    const score = terms.reduce((n, t) => haystack.includes(t) ? n + 1 : n, 0);
+    return { e, score };
+  }).filter((x) => x.score > 0).sort(
+    (a, b) => b.score - a.score || (AREA_RANK[a.e.area] ?? 9) - (AREA_RANK[b.e.area] ?? 9) || a.e.path.localeCompare(b.e.path)
+  ).slice(0, max).map(({ e }) => ({ path: e.path, title: e.title, excerpt: e.excerpt, sourceUrls: e.sourceUrls }));
+}
+async function judge(input, deps = {}) {
+  const loadInt = deps.loadIntentions ?? (() => loadIntentions());
+  const loadDec = deps.loadDecisions ?? (() => loadDecisionEntries());
+  const loadRes = deps.loadResearch ?? (() => loadResearch());
+  const maxPrecedents = deps.maxPrecedents ?? MAX_PRECEDENTS;
+  const maxCrossSystem = deps.maxCrossSystem ?? MAX_CROSS_SYSTEM;
+  const question = input.question;
+  const componentName = input.component?.trim() || null;
+  const terms = buildTerms(question, componentName);
+  const intRes = await loadInt();
+  let component = null;
+  let componentSource;
+  let intentionsGeneratedAt = null;
+  let linkedDecisionIds = [];
+  if (!intRes.ok) {
+    componentSource = "unavailable";
+  } else {
+    intentionsGeneratedAt = intRes.generatedAt;
+    const match = componentName ? intRes.byKey.get(normalizeComponentKey(componentName)) : void 0;
+    if (match) {
+      component = {
+        name: match.name,
+        status: match.status,
+        shippedVersion: match.shippedVersion,
+        useWhen: match.useWhen,
+        notWhen: match.notWhen,
+        disambiguateFrom: match.disambiguateFrom.map((d) => ({ component: d.component, distinction: d.distinction })),
+        guideline: match.guideline,
+        implementation: match.implementation
+      };
+      linkedDecisionIds = match.decisions;
+      componentSource = "matched";
+    } else {
+      componentSource = "absent";
+    }
+  }
+  const decRes = await loadDec();
+  const decisionLogAvailable = decRes.ok;
+  let decisionLogGeneratedAt = null;
+  let decisionLogStale = true;
+  const precedents = [];
+  const sources = [];
+  if (intRes.ok) sources.push("component-intentions.json");
+  if (decRes.ok) {
+    decisionLogGeneratedAt = decRes.generatedAt;
+    decisionLogStale = decRes.generatedAt ? freshness(decRes.generatedAt, { now: deps.now }).stale : true;
+    sources.push("decision-log.json");
+    const byId = /* @__PURE__ */ new Map();
+    for (const e of decRes.entries) byId.set(e.id.toUpperCase(), e);
+    const seen = /* @__PURE__ */ new Set();
+    for (const rawId of linkedDecisionIds) {
+      const e = byId.get(rawId.toUpperCase());
+      if (e && !seen.has(e.id)) {
+        seen.add(e.id);
+        precedents.push(toPrecedent(e, "component"));
+      }
+    }
+    if (terms.length) {
+      const matches = decRes.entries.filter((e) => !seen.has(e.id)).filter((e) => {
+        const blob = decisionSearchBlob(e);
+        return terms.some((t) => blob.includes(t));
+      }).sort((a, b) => b.number - a.number);
+      for (const e of matches) {
+        if (precedents.length >= maxPrecedents) break;
+        seen.add(e.id);
+        precedents.push(toPrecedent(e, "keyword"));
+      }
+    }
+    if (precedents.length > maxPrecedents) precedents.length = maxPrecedents;
+    for (const p of precedents) sources.push(`DL: ${p.id}`);
+  }
+  const resRes = await loadRes();
+  let crossSystem;
+  if (resRes.ok) {
+    const entries = matchResearch(resRes.entries, terms, maxCrossSystem);
+    crossSystem = { available: true, note: CROSS_SYSTEM_NOTE_AVAILABLE, entries };
+    sources.push("research-corpus.json");
+    for (const e of entries) sources.push(`research: ${e.path}`);
+  } else {
+    crossSystem = { available: false, note: CROSS_SYSTEM_NOTE_UNAVAILABLE, entries: [] };
+  }
+  const hasComponentPrecedent = precedents.some((p) => p.relevance === "component");
+  const deprecatedWithAlt = component?.status === "deprecated" && component.disambiguateFrom.length > 0;
+  const unresolvedLinks = linkedDecisionIds.length > 0 && !hasComponentPrecedent;
+  let evidence;
+  let evidenceReason;
+  if (!component && precedents.length === 0) {
+    evidence = "none";
+    evidenceReason = componentSource === "unavailable" || !decisionLogAvailable ? "Grounding sources were unavailable \u2014 could not determine precedent. Do not assume none exists." : "No matching component intention and no decision precedent \u2014 nothing to ground a recommendation on.";
+  } else if (hasComponentPrecedent || deprecatedWithAlt) {
+    evidence = "direct";
+    if (hasComponentPrecedent) {
+      const ids = precedents.filter((p) => p.relevance === "component").map((p) => p.id).join(", ");
+      evidenceReason = `Decision precedent linked directly to ${component?.name ?? "the component"} (${ids}).`;
+      if (decisionLogStale) evidenceReason += " Note: the decision-log snapshot is stale \u2014 qualify accordingly.";
+    } else {
+      evidenceReason = `${component?.name} is deprecated with a named replacement in its intention.`;
+    }
+  } else if (unresolvedLinks) {
+    evidence = "none";
+    const where = decisionLogAvailable ? "they are absent from the current decision-log snapshot" : "the decision log is unavailable";
+    const kw = precedents.length ? ` ${precedents.length} keyword-matched precedent(s) are present but secondary \u2014 verify each is on-topic.` : "";
+    evidenceReason = `${component?.name ?? "The component"} is governed by linked decision(s) ${linkedDecisionIds.join(", ")}, but ${where} \u2014 treat as degraded; do not assume no precedent exists.${kw}`;
+  } else {
+    evidence = "related";
+    evidenceReason = component ? `Component intention matched (status: ${component.status}) but no decision is linked to it${precedents.length ? `; ${precedents.length} keyword-matched precedent(s) may or may not be on-topic` : ""}.` : `${precedents.length} keyword-matched precedent(s) found; verify each is on-topic.`;
+  }
+  return {
+    question,
+    component,
+    componentSource,
+    precedents,
+    evidence,
+    evidenceReason,
+    crossSystem,
+    freshness: {
+      decisionLog: { generatedAt: decisionLogGeneratedAt, stale: decisionLogStale, available: decisionLogAvailable },
+      intentions: { generatedAt: intentionsGeneratedAt, available: intRes.ok }
+    },
+    sources,
+    guidance: GUIDANCE
+  };
+}
+
+// src/tools/judge.ts
+var TOOL_NAME5 = "arbor_judge";
+var TOOL_TITLE5 = "Make a grounded Arbor design-system judgment";
+var TOOL_DESCRIPTION5 = `Make a grounded design-system judgment call for Arbor. Given a decision or question (and optionally the component it concerns), this assembles the grounding in ONE call \u2014 the component's intention (status, when-to-use/not, disambiguation), the decision-log precedents linked to it, and keyword-matched decisions \u2014 and reports how much grounding exists (direct | related | none) plus a cite-or-abstain instruction. It does NOT write the recommendation; it returns real precedent so you can crystallize a Dieter-Rams answer (Recommendation / Why / Risk it removes / Simplest path) citing only what's in the pack, or abstain when nothing addresses the question. Read-only. Cross-system research is not on this surface yet (v1.x) \u2014 cite Arbor precedent only. Use for "should we\u2026", "which component\u2026", "is X overkill", "is there precedent for\u2026".`;
+var inputSchema5 = external_exports.object({
+  question: external_exports.string().trim().min(1).max(500).describe('The design-system decision or question, e.g. "Should FileUpload also render the selected-file list?"'),
+  component: external_exports.string().trim().min(1).max(100).optional().describe('The Arbor component the question concerns, if any (case-insensitive), e.g. "FileUpload" or "file-upload"')
+}).strict();
+var precedentSchema = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  date: external_exports.string(),
+  status: external_exports.string(),
+  tags: external_exports.array(external_exports.string()),
+  relevance: external_exports.enum(["component", "keyword"]).describe("'component' = linked via the component's intention.decisions[]; 'keyword' = matched the question"),
+  sections: external_exports.array(external_exports.object({ heading: external_exports.string(), body: external_exports.string() }))
+});
+var componentSchema = external_exports.object({
+  name: external_exports.string(),
+  status: external_exports.enum(["shipped", "in-progress", "design-only", "deprecated", "researched-not-shipped"]),
+  shippedVersion: external_exports.string().nullable(),
+  useWhen: external_exports.array(external_exports.string()),
+  notWhen: external_exports.array(external_exports.string()),
+  disambiguateFrom: external_exports.array(external_exports.object({ component: external_exports.string(), distinction: external_exports.string() })),
+  guideline: external_exports.string().nullable(),
+  implementation: external_exports.string().nullable()
+});
+var outputSchema5 = external_exports.object({
+  question: external_exports.string(),
+  component: componentSchema.nullable().describe("The matched component intention, or null"),
+  componentSource: external_exports.enum(["matched", "absent", "unavailable"]),
+  precedents: external_exports.array(precedentSchema).describe("Real decision-log entries actually retrieved \u2014 the only DLs safe to cite"),
+  evidence: external_exports.enum(["direct", "related", "none"]).describe(
+    `How much grounding is available (NOT the final answer confidence \u2014 verify each precedent is on-topic). 'none' also covers degraded/unavailable sources, including a component whose linked decisions couldn't be loaded \u2014 it never means "no precedent exists".`
+  ),
+  evidenceReason: external_exports.string(),
+  crossSystem: external_exports.object({
+    available: external_exports.boolean(),
+    note: external_exports.string(),
+    entries: external_exports.array(external_exports.object({ path: external_exports.string(), title: external_exports.string(), excerpt: external_exports.string(), sourceUrls: external_exports.array(external_exports.string()) })).describe(
+      'Cross-system research entries to cite for the "Why" corner \u2014 each carries external-DS sourceUrls; empty when the corpus is unavailable or nothing matched'
+    )
+  }),
+  freshness: external_exports.object({
+    decisionLog: external_exports.object({ generatedAt: external_exports.string().nullable(), stale: external_exports.boolean(), available: external_exports.boolean() }),
+    intentions: external_exports.object({ generatedAt: external_exports.string().nullable(), available: external_exports.boolean() })
+  }),
+  sources: external_exports.array(external_exports.string()).describe("What was actually read \u2014 the audit trail for cite-or-abstain"),
+  guidance: external_exports.string().describe("How to turn this pack into a recommendation (or abstain)")
+});
+var annotations5 = {
+  readOnlyHint: true,
+  idempotentHint: true,
+  openWorldHint: true,
+  destructiveHint: false
+};
+function summarize(pack) {
+  const head = pack.evidence === "none" ? "No direct grounding" : pack.evidence === "direct" ? "Direct precedent available" : "Related evidence only";
+  const comp = pack.component ? ` ${pack.component.name} (${pack.component.status}).` : "";
+  const dls = pack.precedents.length ? ` Precedents: ${pack.precedents.map((p) => p.id).join(", ")}.` : "";
+  const stale = pack.freshness.decisionLog.stale && pack.freshness.decisionLog.available ? " \u26A0 decision-log snapshot is stale." : "";
+  return `${head} for: "${pack.question}".${comp}${dls} ${pack.evidenceReason}${stale}
+
+${pack.guidance}`;
+}
+async function handleJudge(args, deps = {}) {
+  const pack = await judge({ question: args.question, component: args.component }, deps);
+  const out = pack;
+  return { content: [{ type: "text", text: summarize(pack) }], structuredContent: out };
+}
+var judgeTool = {
+  name: TOOL_NAME5,
+  config: { title: TOOL_TITLE5, description: TOOL_DESCRIPTION5, inputSchema: inputSchema5, outputSchema: outputSchema5, annotations: annotations5 },
+  handler: handleJudge
+};
+
 // 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 from Supernova (id, name, semver, created date, read-only flag, draft / latest-released markers) via the Arbor federation proxy, plus the committed release manifest (npm release \u2194 Supernova version). 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 TOOL_NAME6 = "arbor_list_versions";
+var TOOL_TITLE6 = "List Arbor design system versions";
+var TOOL_DESCRIPTION6 = "List the version history of the Arbor design system from Supernova (id, name, semver, created date, read-only flag, draft / latest-released markers) via the Arbor federation proxy, plus the committed release manifest (npm release \u2194 Supernova version). Read-only metadata. Does NOT return token values (use the compiled CSS / registry) and does NOT change anything.";
+var inputSchema6 = external_exports.object({}).strict();
 var versionSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
@@ -6439,7 +6798,7 @@ var manifestReleaseSchema = external_exports.object({
   supernovaVersionId: external_exports.string().nullable().describe("The frozen Supernova version id this release was cut as (null until the cutter + stamper run \u2014 later phases)"),
   supernovaStatus: external_exports.string().nullable()
 });
-var outputSchema5 = external_exports.object({
+var outputSchema6 = external_exports.object({
   source: external_exports.enum(["remote", "unavailable"]).describe("'remote' = Supernova versions fetched; 'unavailable' = proxy fetch failed"),
   total: external_exports.number().describe("Number of Supernova versions returned"),
   versions: external_exports.array(versionSchema).describe("Supernova versions, in the order returned"),
@@ -6451,7 +6810,7 @@ var outputSchema5 = external_exports.object({
   }).describe("The committed release manifest (releases.json) mapping npm releases \u2194 Supernova versions"),
   detail: external_exports.string().nullable().describe("Degraded reason when source is unavailable")
 });
-var annotations5 = { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false };
+var annotations6 = { readOnlyHint: true, idempotentHint: true, openWorldHint: true, destructiveHint: false };
 var SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
 function extractList(data) {
   const wrapped = data?.result?.designSystemVersions;
@@ -6542,19 +6901,18 @@ async function handleListVersions(_args, deps = {}) {
   return { content: [{ type: "text", text: `${versionsLine} ${manifestLine}` }], structuredContent: out };
 }
 var listVersionsTool = {
-  name: TOOL_NAME5,
-  config: { title: TOOL_TITLE5, description: TOOL_DESCRIPTION5, inputSchema: inputSchema5, outputSchema: outputSchema5, annotations: annotations5 },
+  name: TOOL_NAME6,
+  config: { title: TOOL_TITLE6, description: TOOL_DESCRIPTION6, inputSchema: inputSchema6, outputSchema: outputSchema6, annotations: annotations6 },
   handler: handleListVersions
 };
 
 // src/tools/lookup-decision.ts
-var ARTIFACT2 = "decision-log.json";
 var CHARACTER_LIMIT = 25e3;
 var DEFAULT_LIMIT = 5;
-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({
+var TOOL_NAME7 = "arbor_lookup_decision";
+var TOOL_TITLE7 = "Look up an Arbor decision-log entry";
+var TOOL_DESCRIPTION7 = '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 inputSchema7 = 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)"),
@@ -6562,17 +6920,7 @@ var inputSchema6 = external_exports.object({
   offset: external_exports.number().int().min(0).default(0).describe("Entries to skip, for pagination"),
   response_format: external_exports.enum(["markdown", "json"]).default("markdown").describe("Rendering of the text content: 'markdown' (human) or 'json' (machine)")
 }).strict();
-var sectionSchema = external_exports.object({ heading: external_exports.string(), body: external_exports.string() });
-var decisionEntrySchema = external_exports.object({
-  id: external_exports.string(),
-  number: external_exports.number(),
-  title: external_exports.string(),
-  date: external_exports.string(),
-  status: external_exports.string(),
-  tags: external_exports.array(external_exports.string()),
-  sections: external_exports.array(sectionSchema).describe("Ordered sections (Context, Decision, \u2026, plus any non-standard headings)")
-});
-var outputSchema6 = external_exports.object({
+var outputSchema7 = 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(),
@@ -6583,25 +6931,12 @@ var outputSchema6 = 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 annotations6 = {
+var annotations7 = {
   readOnlyHint: true,
   idempotentHint: true,
   openWorldHint: true,
   destructiveHint: false
 };
-function asEntries(data) {
-  const raw = data ?? {};
-  if (!Array.isArray(raw.entries)) return [];
-  const entries = [];
-  for (const item of raw.entries) {
-    const parsed = decisionEntrySchema.safeParse(item);
-    if (parsed.success) entries.push(parsed.data);
-  }
-  return entries;
-}
-function searchBlob(e) {
-  return [e.title, e.tags.join(" "), ...e.sections.map((s) => `${s.heading} ${s.body}`)].join("\n").toLowerCase();
-}
 function renderEntry(e) {
   const lines = [
     `## ${e.id}: ${e.title}`,
@@ -6636,14 +6971,10 @@ async function handleLookupDecision(args, deps = {}) {
   const load = deps.load ?? ((f) => loadPublishedJson(f));
   const charLimit = deps.charLimit ?? CHARACTER_LIMIT;
   const { id, tag, query, limit = DEFAULT_LIMIT, offset = 0, response_format = "markdown" } = args;
-  const result = await load(ARTIFACT2);
-  if (!result.ok) return unavailable(offset, result.reason);
-  const raw = result.data;
-  if (raw.degraded === true || !Array.isArray(raw.entries)) {
-    return unavailable(offset, typeof raw.reason === "string" ? raw.reason : "degraded");
-  }
-  const all = asEntries(result.data);
-  const generatedAt = typeof raw.generatedAt === "string" ? raw.generatedAt : null;
+  const res = await loadDecisionEntries(load);
+  if (!res.ok) return unavailable(offset, res.reason);
+  const all = res.entries;
+  const generatedAt = res.generatedAt;
   const stale = generatedAt ? freshness(generatedAt, { now: deps.now }).stale : true;
   let matches;
   if (id !== void 0) {
@@ -6654,7 +6985,7 @@ async function handleLookupDecision(args, deps = {}) {
     const queryLc = query?.toLowerCase();
     matches = all.filter((e) => {
       if (tagLc && !e.tags.some((t) => t.toLowerCase() === tagLc)) return false;
-      if (queryLc && !searchBlob(e).includes(queryLc)) return false;
+      if (queryLc && !decisionSearchBlob(e).includes(queryLc)) return false;
       return true;
     });
   }
@@ -6699,13 +7030,13 @@ ${included.map(renderEntry).join("\n\n---\n\n")}${note}`;
   };
 }
 var lookupDecisionTool = {
-  name: TOOL_NAME6,
+  name: TOOL_NAME7,
   config: {
-    title: TOOL_TITLE6,
-    description: TOOL_DESCRIPTION6,
-    inputSchema: inputSchema6,
-    outputSchema: outputSchema6,
-    annotations: annotations6
+    title: TOOL_TITLE7,
+    description: TOOL_DESCRIPTION7,
+    inputSchema: inputSchema7,
+    outputSchema: outputSchema7,
+    annotations: annotations7
   },
   handler: handleLookupDecision
 };
@@ -6932,6 +7263,22 @@ var compositions_default = [
     name: "NotificationBadge",
     code: "<NotificationBadge count={3} />"
   },
+  // ── IndicatorBadge ──
+  {
+    group: "IndicatorBadge",
+    name: "IndicatorBadge (count)",
+    code: "<IndicatorBadge count={5} />"
+  },
+  {
+    group: "IndicatorBadge",
+    name: "IndicatorBadge (dot)",
+    code: '<IndicatorBadge dot aria-label="Unread" />'
+  },
+  {
+    group: "IndicatorBadge",
+    name: "IndicatorBadge (custom color)",
+    code: '<IndicatorBadge count={5} color="#7B61FF" />'
+  },
   // ── Button ──
   {
     group: "Button",
@@ -6965,6 +7312,31 @@ var compositions_default = [
   <Button variant="secondary">Cancel</Button>
   <Button>Save changes</Button>
 </div>`
+  },
+  // ── ButtonGroup ──
+  {
+    group: "ButtonGroup",
+    name: "ButtonGroup (confirm / cancel)",
+    code: `<ButtonGroup aria-label="Save changes">
+  <Button variant="secondary">Cancel</Button>
+  <Button>Save changes</Button>
+</ButtonGroup>`
+  },
+  {
+    group: "ButtonGroup",
+    name: "ButtonGroup (stacked)",
+    code: `<ButtonGroup stacked aria-label="Start trial or decide later">
+  <Button variant="accent">Start 7-day free trial</Button>
+  <Button variant="ghost">Decide later</Button>
+</ButtonGroup>`
+  },
+  {
+    group: "ButtonGroup",
+    name: "ButtonGroup (auto width)",
+    code: `<ButtonGroup fullWidth={false} aria-label="Discard or update">
+  <Button variant="ghost">Discard changes</Button>
+  <Button>Update everywhere</Button>
+</ButtonGroup>`
   },
   // ── CardSelect ──
   {
@@ -7118,6 +7490,88 @@ var compositions_default = [
     <DropdownMenuItem className="text-danger">Delete</DropdownMenuItem>
   </DropdownMenuContent>
 </DropdownMenu>`
+  },
+  // ── Menu ──
+  {
+    group: "Menu",
+    name: "Menu",
+    code: `<Menu>
+  <MenuTrigger asChild>
+    <Button variant="outline">Options</Button>
+  </MenuTrigger>
+  <MenuContent>
+    <MenuSectionHeading>Actions</MenuSectionHeading>
+    <MenuItem>Edit</MenuItem>
+    <MenuItem>Duplicate</MenuItem>
+    <MenuItem>Share</MenuItem>
+    <MenuDivider />
+    <MenuItem destructive>Delete</MenuItem>
+  </MenuContent>
+</Menu>`
+  },
+  // ── MenuItem ──
+  // Maps figma-mappings `MenuItem` (Menu Item node 9417-8883, type=default).
+  {
+    group: "MenuItem",
+    name: "MenuItem",
+    code: `<Menu>
+  <MenuTrigger asChild>
+    <Button variant="outline">Options</Button>
+  </MenuTrigger>
+  <MenuContent>
+    <MenuItem>Edit</MenuItem>
+    <MenuItem description="Manage who can access">Sharing</MenuItem>
+    <MenuItem destructive>Delete</MenuItem>
+  </MenuContent>
+</Menu>`
+  },
+  // ── MenuCheckboxItem ──
+  // Maps figma-mappings `MenuCheckboxItem` (Menu Item node 9417-8883, type=checkbox).
+  {
+    group: "MenuCheckboxItem",
+    name: "MenuCheckboxItem",
+    code: `<Menu>
+  <MenuTrigger asChild>
+    <Button variant="outline">View options</Button>
+  </MenuTrigger>
+  <MenuContent>
+    <MenuCheckboxItem checked>Show analytics</MenuCheckboxItem>
+    <MenuCheckboxItem>Show archived</MenuCheckboxItem>
+  </MenuContent>
+</Menu>`
+  },
+  // ── MenuRadioItem ──
+  // Maps figma-mappings `MenuRadioItem` (Menu Item node 9417-8883, type=radio).
+  {
+    group: "MenuRadioItem",
+    name: "MenuRadioItem",
+    code: `<Menu>
+  <MenuTrigger asChild>
+    <Button variant="outline">Density</Button>
+  </MenuTrigger>
+  <MenuContent>
+    <MenuRadioGroup value="comfortable">
+      <MenuRadioItem value="comfortable">Comfortable</MenuRadioItem>
+      <MenuRadioItem value="compact">Compact</MenuRadioItem>
+    </MenuRadioGroup>
+  </MenuContent>
+</Menu>`
+  },
+  // ── MenuSectionHeading ──
+  // Maps figma-mappings `MenuSectionHeading` (node 12345-33298).
+  {
+    group: "MenuSectionHeading",
+    name: "MenuSectionHeading",
+    code: `<Menu>
+  <MenuTrigger asChild>
+    <Button variant="outline">Account</Button>
+  </MenuTrigger>
+  <MenuContent>
+    <MenuSectionHeading>Signed in as Jordan</MenuSectionHeading>
+    <MenuItem>Profile</MenuItem>
+    <MenuItem>Billing</MenuItem>
+  </MenuContent>
+</Menu>`
   },
   // ── Elevation ──
   {
@@ -7179,6 +7633,20 @@ var compositions_default = [
     <FieldLabel>Link title</FieldLabel>
     <FieldInput placeholder="My website" />
   </FieldControl>
+</FieldRoot>`
+  },
+  // ── TextArea (Field.Textarea) — DNG-763 ──
+  // The Figma "Text Area" component maps to the code Field compound rendered
+  // with FieldTextarea; the figma-mappings `TextArea` key needs a composition
+  // group of the same name so the MCP/Playroom coverage gate resolves it.
+  {
+    group: "TextArea",
+    name: "Text Area",
+    code: `<FieldRoot>
+  <FieldControl>
+    <FieldLabel>Bio</FieldLabel>
+    <FieldTextarea placeholder="Tell us about yourself" />
+  </FieldControl>
 </FieldRoot>`
   },
   // ── Fieldset ──
@@ -7195,6 +7663,12 @@ var compositions_default = [
   </RadioGroup>
 </Fieldset>`
   },
+  // ── FileUpload ──
+  {
+    group: "FileUpload",
+    name: "FileUpload",
+    code: '<div className="w-full max-w-md"><FileUpload label="Select files to upload" supportingText="PDF, PNG, or JPG \u2014 up to 100MB each" /></div>'
+  },
   // ── HeaderBar ──
   // Maps to figma-mappings `HeaderBar` (node 5223-5837). Title + back-button
   // is the canonical small variant; HeaderBar.stories.tsx covers the full
@@ -7250,6 +7724,21 @@ var compositions_default = [
   <NativeSelectOption value="us">United States</NativeSelectOption>
   <NativeSelectOption value="uk">United Kingdom</NativeSelectOption>
 </NativeSelect>`
+  },
+  // ── OneTimePasswordField ──
+  {
+    group: "OneTimePasswordField",
+    name: "One-time password field",
+    code: `<OneTimePasswordField maxLength={6}>
+  <OneTimePasswordFieldGroup>
+    <OneTimePasswordFieldSlot index={0} />
+    <OneTimePasswordFieldSlot index={1} />
+    <OneTimePasswordFieldSlot index={2} />
+    <OneTimePasswordFieldSlot index={3} />
+    <OneTimePasswordFieldSlot index={4} />
+    <OneTimePasswordFieldSlot index={5} />
+  </OneTimePasswordFieldGroup>
+</OneTimePasswordField>`
   },
   // ── Popover ──
   {
@@ -7962,14 +8451,14 @@ function extractSlug(payload) {
 }
 
 // src/tools/open-in-playroom.ts
-var TOOL_NAME7 = "arbor_open_in_playroom";
+var TOOL_NAME8 = "arbor_open_in_playroom";
 var DEPRECATED_TOOL_ALIAS = "arbor.open_in_playroom";
-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({
+var TOOL_TITLE8 = "Open in Playroom";
+var TOOL_DESCRIPTION8 = `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 inputSchema8 = 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 outputSchema7 = external_exports.object({
+var outputSchema8 = 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)"),
@@ -7980,7 +8469,7 @@ var outputSchema7 = 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 annotations7 = {
+var annotations8 = {
   readOnlyHint: false,
   idempotentHint: true,
   openWorldHint: true,
@@ -8081,14 +8570,14 @@ async function handleOpenInPlayroom(args) {
   };
 }
 var openInPlayroomTool = {
-  name: TOOL_NAME7,
+  name: TOOL_NAME8,
   aliases: [DEPRECATED_TOOL_ALIAS],
   config: {
-    title: TOOL_TITLE7,
-    description: TOOL_DESCRIPTION7,
-    inputSchema: inputSchema7,
-    outputSchema: outputSchema7,
-    annotations: annotations7
+    title: TOOL_TITLE8,
+    description: TOOL_DESCRIPTION8,
+    inputSchema: inputSchema8,
+    outputSchema: outputSchema8,
+    annotations: annotations8
   },
   handler: handleOpenInPlayroom
 };
@@ -8124,6 +8613,7 @@ var ARBOR_TOOLS = [
   checkSyncHealthTool,
   checkUxWritingTool,
   lookupDecisionTool,
+  judgeTool,
   listVersionsTool,
   listComponentsTool,
   getComponentTool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/arbor-mcp",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "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",