@linktr.ee/arbor-mcp 0.7.0 → 0.8.0

package/dist/index.js

@@ -6421,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(),
@@ -6442,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"),
@@ -6454,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;
@@ -6545,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)"),
@@ -6565,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(),
@@ -6586,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}`,
@@ -6639,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) {
@@ -6657,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;
     });
   }
@@ -6702,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
 };
@@ -7162,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 ──
   {
@@ -7223,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 ──
@@ -7300,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 ──
   {
@@ -8012,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)"),
@@ -8030,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,
@@ -8131,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
 };
@@ -8174,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.7.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",