@bridge-ds/mcp 0.3.3 → 0.4.0

package/dist/explorations.d.ts

@@ -11,6 +11,8 @@ export interface StartExplorationInput {
     /** Where it is started from (the MCP tool says mcp, the CLI says cli), and the AI agent behind it when known. */
     source?: ExplorationSource | undefined;
     agent?: string | undefined;
+    /** The product it is tried in (key or name, bridge.config.json "products"). Default: the product of the current folder or repo. */
+    product?: string | undefined;
     dryRun?: boolean | undefined;
 }
 /**
@@ -20,6 +22,7 @@ export interface StartExplorationInput {
  */
 export declare function startExploration(ctx: BridgeContext, a: StartExplorationInput): Promise<{
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;
@@ -46,6 +49,7 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     }[];
     next: string;
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;
@@ -60,6 +64,7 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     commit: string;
     next: string;
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;

package/dist/index.js

@@ -3,8 +3,8 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-7HYTZVRW.js";
-import "./chunk-K3HY24MZ.js";
+} from "./chunk-NYFH322K.js";
+import "./chunk-7DBLDJIL.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.d.ts

@@ -11,6 +11,8 @@ export * as brand from './brand.js';
 export * as requests from './requests.js';
 export * as explorations from './explorations.js';
 export * as drafts from './drafts.js';
+export * as branches from './branches.js';
+export * as studio from './studio.js';
 export { DOCS_DRAFT_MODEL, anthropicReplyText, anthropicRequest, formatDocsJson, mergeDocsDraft, missingProse, parseDocsReply } from '@bridge-ds/core';
 export interface ServeOptions extends ContextOptions {
 }

package/dist/lib.js

@@ -8,6 +8,7 @@ import {
   anthropicReplyText,
   anthropicRequest,
   auditSnippet,
+  branches_exports,
   brand_exports,
   core,
   createServer,
@@ -22,13 +23,14 @@ import {
   optionsFromArgv,
   parseDocsReply,
   requests_exports,
-  serveStdio
-} from "./chunk-7HYTZVRW.js";
+  serveStdio,
+  studio_exports
+} from "./chunk-NYFH322K.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-K3HY24MZ.js";
+} from "./chunk-7DBLDJIL.js";
 export {
   BridgeContext,
   CONFIG_FILE,
@@ -40,6 +42,7 @@ export {
   anthropicReplyText,
   anthropicRequest,
   auditSnippet,
+  branches_exports as branches,
   brand_exports as brand,
   core,
   createServer,
@@ -56,5 +59,6 @@ export {
   parseDocsReply,
   requests_exports as requests,
   serveStdio,
+  studio_exports as studio,
   toConfigJson
 };

package/dist/ops.d.ts

@@ -1,7 +1,7 @@
 import { type ScaffoldInput } from './components.js';
-import type { BridgeContext } from './context.js';
 import { type BridgeConfig, type GitHubClient } from '@bridge-ds/core';
 import { type Combo, type PairInput, type TokenEdit, type TokenSet } from './core-adapter.js';
+import { BridgeContext } from './context.js';
 /** Accepts `color.text.muted`, `--color-text-muted` or `var(--color-text-muted)`. */
 export declare function normalizeTokenPath(set: TokenSet, input: string): string;
 export declare function getConfig(ctx: BridgeContext): Promise<{
@@ -274,7 +274,75 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     summary?: string;
     dryRun?: boolean;
     branch?: string | undefined;
+    pr?: number | string | undefined;
+    jira?: string | undefined;
+    product?: string | undefined;
 }): Promise<{
+    status: string;
+    pr: number;
+    message: string;
+} | {
+    hint: string;
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    why: string;
+    newErrors: import("@bridge-ds/core").LayerIssue[];
+    message?: undefined;
+} | {
+    files: string[];
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
+} | {
+    commit: string;
+    url: string;
+    said: string;
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
+} | {
     status: string;
     message: string;
 } | {
@@ -501,6 +569,7 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     url: string;
     labels: string[];
     draft: boolean;
+    product: string;
     files: string[];
     prBody: string;
     title: string;

package/dist/requests.d.ts

@@ -68,6 +68,8 @@ export interface CreateRequestInput {
     source?: RequestSource | undefined;
     /** Exploration branch to implement it on (`explore/<slug>`), instead of a pull request to main. */
     exploration?: string | undefined;
+    /** The product it is for (key or name, bridge.config.json "products"). Default: the product of the current folder or repo. */
+    product?: string | undefined;
     dryRun?: boolean | undefined;
 }
 export declare function createRequest(ctx: BridgeContext, a: CreateRequestInput): Promise<{

package/dist/{src-V653Z7JC.js → src-2YRRAUUM.js}

@@ -1,13 +1,17 @@
 import {
+  FIGMA_REFERENCE_STORY,
   LayeredTokenSet,
   comboKey,
   diffLayered,
   git,
   listFilesAt,
   loadConfig,
+  parseComponentSpecs,
+  planReferences,
+  referenceImagePath,
   selectTokenFiles,
   showFile
-} from "./chunk-K3HY24MZ.js";
+} from "./chunk-7DBLDJIL.js";
 
 // ../visual/src/run.ts
 import { existsSync as existsSync3 } from "node:fs";
@@ -123,148 +127,6 @@ function impactedModules(index, input) {
   return { modules, globalHits };
 }
 
-// ../core/src/component-spec.ts
-var COMPONENT_SPECS_VERSION = 1;
-var variantKeyOf = (props) => Object.keys(props).sort().map((k) => `${k}=${props[k]}`).join(", ") || "Default";
-function parseComponentSpecs(text) {
-  let data;
-  try {
-    data = JSON.parse(text);
-  } catch {
-    throw new Error("component-specs.json is not valid JSON.");
-  }
-  const f = data;
-  if (!f || typeof f !== "object" || !Array.isArray(f.components)) throw new Error('component-specs.json has no "components" list.');
-  if (f.version !== COMPONENT_SPECS_VERSION) throw new Error(`component-specs.json is version ${String(f.version)}; this tool reads version ${COMPONENT_SPECS_VERSION}.`);
-  return f;
-}
-
-// ../core/src/fidelity-references.ts
-var FIGMA_REFERENCES_DIR = "figma-references";
-var FIGMA_REFERENCES_MANIFEST = `${FIGMA_REFERENCES_DIR}/manifest.json`;
-var FIGMA_REFERENCE_STORY = "internal-figma-reference--variant";
-var FIGMA_FILL_WIDTH_TOKEN = "size.80";
-var STATE_PSEUDO = {
-  default: "rest",
-  rest: "rest",
-  enabled: "rest",
-  hover: "hover",
-  hovered: "hover",
-  pressed: "active",
-  active: "active",
-  focus: "focus-visible",
-  focused: "focus-visible",
-  "focus visible": "focus-visible",
-  disabled: "disabled"
-};
-var iconName = (component) => component.replace(/^Icon\//, "");
-var exportName = (name) => name.replace(/[^A-Za-z0-9]+/g, "");
-function planReference(spec, variant, file) {
-  if (spec.view === "popup") return { ok: false, reason: "drawn open in Figma; the code image shows it closed" };
-  const props = { ...spec.fixed ?? {} };
-  let pseudo;
-  for (const axis of spec.axes) {
-    const value = variant.props[axis.name];
-    if (value === void 0) return { ok: false, reason: `the variant has no ${axis.name} value` };
-    if (axis.prop) {
-      props[axis.prop] = value === "true" ? true : value === "false" ? false : value;
-      continue;
-    }
-    if (axis.name === "Checked") {
-      props.checked = value === "true";
-      if (value === "mixed") props.indeterminate = true;
-      continue;
-    }
-    if (axis.name.toLowerCase() !== "state") return { ok: false, reason: `${axis.name} has no matching option in code` };
-    const s = STATE_PSEUDO[value.toLowerCase()];
-    if (!s) return { ok: false, reason: `the ${value} state has no code equivalent to render` };
-    if (s === "disabled") props.disabled = true;
-    else if (s !== "rest") pseudo = s;
-  }
-  const root = spec.parts.find((p) => !p.parent);
-  if (!root) return { ok: false, reason: "the spec has no root layer" };
-  const children = (id) => spec.parts.filter((p) => p.parent === id);
-  const textOf = (part) => {
-    const swapTo = variant.slots?.[part.id] ?? part.swap?.default;
-    if (part.swap && swapTo) {
-      const slot = file?.slots?.find((s) => s.name === swapTo);
-      if (!slot) return { reason: `${swapTo} is not in the specs` };
-      if (slot.kind !== "text" || !slot.text) return { reason: `Figma shows a placeholder (${swapTo}) that code has no example of` };
-      return slot.text.default;
-    }
-    const prop = spec.properties.find((p) => p.name === part.text && p.type === "TEXT");
-    return typeof prop?.default === "string" ? prop.default : part.name;
-  };
-  let text;
-  const icons = {};
-  for (const prop of spec.properties) {
-    if (prop.type === "TEXT") {
-      const hidden = spec.properties.some((b) => b.type === "BOOLEAN" && b.prop === prop.prop && b.default === false);
-      if (hidden && prop.prop) continue;
-      if (prop.prop === "children") text = String(prop.default);
-      else if (prop.prop) props[prop.prop] = String(prop.default);
-      continue;
-    }
-    const iconPart = spec.parts.find((p) => p.kind === "icon" && p.visible === prop.name);
-    if (prop.default === true && !iconPart && prop.prop && props[prop.prop] === void 0 && spec.example?.p?.[prop.prop] === void 0) props[prop.prop] = true;
-  }
-  for (const part of spec.parts) {
-    if (part.kind !== "icon" || !part.swap) continue;
-    const shown = part.visible ? spec.properties.find((p) => p.name === part.visible)?.default === true : true;
-    if (!shown) continue;
-    if (!part.swap.prop) return { ok: false, reason: `the ${part.name} icon has no matching option in code` };
-    icons[part.swap.prop] = iconName(variant.slots?.[part.id] ?? part.swap.default);
-  }
-  let parts;
-  const loose = spec.properties.filter((p) => p.type === "TEXT" && !p.prop);
-  const frames = children(root.id).filter((p) => p.kind === "frame");
-  const compound = text === void 0 && frames.length > 0 && frames.every((f) => spec.parts.some((p) => p.parent === f.id && p.kind === "text" && (p.swap || p.text === f.name)));
-  if (compound) {
-    parts = [];
-    for (const f of frames) {
-      const t = spec.parts.find((p) => p.parent === f.id && p.kind === "text");
-      const value = textOf(t);
-      if (typeof value !== "string") return { ok: false, reason: value.reason };
-      parts.push({ component: `${exportName(spec.name)}${exportName(f.name)}`, text: value });
-    }
-  }
-  for (const p of loose) {
-    if (p.name === "Value") continue;
-    const part = spec.parts.find((x) => x.text === p.name);
-    if (compound && part && part.parent !== root.id) continue;
-    if (part && /placeholder$/.test(part.id)) {
-      props.placeholder = String(p.default);
-      continue;
-    }
-    return { ok: false, reason: `the ${p.name} text has no matching option in code` };
-  }
-  const example = spec.example;
-  const exampleChildren = example?.children?.length ? example.children : void 0;
-  return {
-    ok: true,
-    render: {
-      component: exportName(spec.view || spec.fixed || example ? example?.c ?? spec.component ?? spec.name : spec.name),
-      props: { ...example?.p ?? {}, ...props },
-      ...exampleChildren ? { children: exampleChildren } : {},
-      ...text !== void 0 && !exampleChildren ? { text } : {},
-      ...parts && !exampleChildren ? { parts } : {},
-      ...Object.keys(icons).length ? { icons } : {},
-      ...pseudo ? { pseudo } : {},
-      ...root.fill ? { width: FIGMA_FILL_WIDTH_TOKEN } : {}
-    }
-  };
-}
-function referenceImagePath(component, key) {
-  const slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  const file = key.split(",").map((kv) => slug(kv)).filter(Boolean).join("__");
-  return `${slug(component)}/${file || "default"}.png`;
-}
-function planReferences(file) {
-  return file.components.flatMap(
-    (spec) => spec.variants.map((v) => ({ component: spec.name, specHash: spec.hash, key: variantKeyOf(v.props), plan: planReference(spec, v, file) }))
-  );
-}
-
 // ../visual/src/capture.ts
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
@@ -722,9 +584,9 @@ function selectImpact(input) {
     app
   };
 }
-function storyId(title, exportName2) {
+function storyId(title, exportName) {
   const sanitize = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
-  const startCase = exportName2.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+  const startCase = exportName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
   return `${sanitize(title)}--${sanitize(startCase)}`;
 }
 function storiesFromSource(files) {

package/dist/studio.d.ts

@@ -0,0 +1,107 @@
+import type { BridgeContext } from './context.js';
+/**
+ * Save a component's guidance (docs.json) the way the Library edit mode does: merged into the docs on the branch,
+ * cleaned, validated (a summary, no empty items, no em dash), then either one new branch sent for review (Tier 1,
+ * patch changeset, the Jira key first in its name) or one commit on an open branch (`pr`).
+ */
+export declare function saveDocs(ctx: BridgeContext, a: {
+    component: string;
+    docs: Record<string, unknown>;
+    pr?: number | string | undefined;
+    title?: string | undefined;
+    notes?: string | undefined;
+    jira?: string | undefined;
+    product?: string | undefined;
+    dryRun?: boolean | undefined;
+}): Promise<{
+    status: "dry-run";
+    pr: number;
+    path: string;
+    content: string;
+    commit?: undefined;
+    said?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    status: "committed" | "unchanged";
+    pr: number;
+    path: string;
+    commit: string | null;
+    said: string;
+    content?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    status: "unchanged";
+    path: string;
+    said: string;
+    pr?: undefined;
+    content?: undefined;
+    commit?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    said?: string | undefined;
+    status: "preview" | "dry-run";
+    path: string;
+    content: string;
+    product: string;
+    pr?: undefined;
+    commit?: undefined;
+    url?: undefined;
+    title?: undefined;
+} | {
+    status: "sent-for-review";
+    pr: number;
+    url: string;
+    title: string;
+    path: string;
+    product: string;
+    said: string;
+    content?: undefined;
+    commit?: undefined;
+}>;
+/** The settings a designer reads in Studio Settings, safe to show: roles, who ships, the owner override, protection, products, previews. */
+export declare function getSettings(ctx: BridgeContext): Promise<{
+    repo: string | null;
+    main: string;
+    roles: {
+        teamsNotRead?: string[] | undefined;
+        designApproval: string[];
+        techApproval: string[];
+        ship: string;
+    };
+    ownerOverride: {
+        on: boolean;
+        who: string[];
+        reason: string;
+    };
+    protection: string;
+    products: {
+        key: string;
+        name: string;
+        default: boolean;
+    }[];
+    previews: string[];
+    visualImpact: import("@bridge-ds/core").VisualImpactMode;
+    note: string;
+}>;
+/** Which components are in Figma (Studio's "In Figma" column), and whether code images exist for the fidelity check. */
+export declare function figmaCoverage(ctx: BridgeContext, a?: {
+    component?: string | undefined;
+}): Promise<{
+    components: never[];
+    summary: string;
+    fidelity?: undefined;
+} | {
+    summary: string;
+    components: {
+        why?: string | undefined;
+        name: string;
+        inFigma: string;
+    }[];
+    fidelity: string;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "type": "module",
   "description": "Bridge MCP server: lets Claude (Claude Code, Claude Desktop or any MCP client) read, check and propose changes to a DTCG design system repo through pull requests.",
   "license": "MIT",
@@ -54,8 +54,8 @@
     "build:package": "node ../../scripts/build-packages.mjs mcp"
   },
   "dependencies": {
-    "@bridge-ds/core": "^0.6.0",
-    "@bridge-ds/visual": "^0.3.0",
+    "@bridge-ds/core": "^0.7.0",
+    "@bridge-ds/visual": "^0.3.1",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"