@bridge-ds/mcp 0.9.0 → 0.11.0

package/dist/{chunk-ZVORAO5H.js → chunk-WSNJYGA5.js}

@@ -119,7 +119,7 @@ var STATE_OF = {
   deployed: "ready",
   ready: "ready",
   ignored: "ready",
-  // Vercel skipped the build (nothing changed for this app): the branch alias serves the last one.
+  // Vercel skipped the build: nothing to wait for. BranchPreview.skipped says the branch has no build of its own.
   pending: "building",
   queued: "building",
   in_progress: "building",
@@ -131,13 +131,15 @@ var STATE_OF = {
   canceled: "failed"
 };
 var stateOf = (s) => STATE_OF[(s ?? "").toLowerCase()] ?? "unknown";
+var IGNORED_BUILD = /ignored build step/i;
 var isInspectorUrl = (u) => /^https:\/\/(?:www\.)?vercel\.com\//i.test(u);
 function resolveBranchPreviews(apps, ctx, sources = {}) {
   const seen = /* @__PURE__ */ new Map();
   const at = (app) => seen.get(app) ?? (seen.set(app, {}), seen.get(app));
-  const offer = (app, url, urlSource, state, stateRank) => {
+  const offer = (app, url, urlSource, state, stateRank, skipped) => {
     if (!app) return;
     const s = at(app);
+    if (skipped !== void 0 && (s.skipRank === void 0 || stateRank < s.skipRank)) Object.assign(s, { skipped, skipRank: stateRank });
     if (url && !s.url) Object.assign(s, { url, urlSource });
     if (state !== "unknown" && (s.stateRank === void 0 || stateRank < s.stateRank)) Object.assign(s, { state, stateRank });
   };
@@ -148,7 +150,7 @@ function resolveBranchPreviews(apps, ctx, sources = {}) {
     const project = projectOfLabel(st.context);
     if (!project) continue;
     const url = httpsUrl(st.target_url);
-    offer(appForProject(project, apps), url && !isInspectorUrl(url) ? url : null, "status", stateOf(st.state), 0);
+    offer(appForProject(project, apps), url && !isInspectorUrl(url) ? url : null, "status", stateOf(st.state), 0, IGNORED_BUILD.test(st.description ?? ""));
   }
   for (const d of sources.deployments ?? []) {
     const project = projectOfLabel(d.environment);
@@ -160,17 +162,18 @@ function resolveBranchPreviews(apps, ctx, sources = {}) {
     const state = stateOf(d.state);
     if (state !== "unknown" && (s.stateRank === void 0 || 1 < s.stateRank)) Object.assign(s, { state, stateRank: 1 });
   }
-  for (const p of parseVercelComment(findVercelComment(sources.comments ?? [])?.body) ?? []) offer(appForProject(p.name, apps), p.previewUrl, "vercel-comment", stateOf(p.status), 2);
+  for (const p of parseVercelComment(findVercelComment(sources.comments ?? [])?.body) ?? []) offer(appForProject(p.name, apps), p.previewUrl, "vercel-comment", stateOf(p.status), 2, p.status ? p.status.toUpperCase() === "IGNORED" : void 0);
   const out = [];
   for (const app of Object.keys(PREVIEW_APP_LABELS)) {
     if (!apps[app]) continue;
     const s = seen.get(app) ?? {};
     const url = s.url ?? previewUrl(apps[app], ctx);
     const source = s.url ? s.urlSource : url ? "template" : null;
-    out.push({ app, label: PREVIEW_APP_LABELS[app], url, state: s.state ?? "unknown", source });
+    out.push({ app, label: PREVIEW_APP_LABELS[app], url, state: s.state ?? "unknown", source, ...s.skipped ? { skipped: true } : {} });
   }
   return out;
 }
+var previewLinksOf = (previews) => previews.filter((p) => !!p.url && !p.skipped).map((p) => ({ app: p.app, label: p.label, url: p.url }));
 var previewsSettled = (previews) => previews.every((p) => p.state === "failed" || !!p.url && p.state === "ready");
 
 // ../core/src/teams.ts
@@ -533,6 +536,27 @@ function productForPlace(products, place) {
   }
   return { product: defaultProduct(products), how: "default" };
 }
+function productRepoOf(p, designSystemRepo) {
+  const repo = p?.repo?.trim();
+  if (!repo || !REPO.test(repo)) return null;
+  return repo.toLowerCase() === (designSystemRepo ?? "").trim().toLowerCase() ? null : repo;
+}
+function productRepos(products, designSystemRepo) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const p of products) {
+    const repo = productRepoOf(p, designSystemRepo);
+    if (!repo || seen.has(repo.toLowerCase())) continue;
+    seen.add(repo.toLowerCase());
+    out.push({ product: p, repo });
+  }
+  return out;
+}
+function productOfRepo(products, repo, designSystemRepo) {
+  const r = (repo ?? "").trim().toLowerCase();
+  if (!r) return void 0;
+  return productRepos(products, designSystemRepo).find((x) => x.repo.toLowerCase() === r)?.product;
+}
 var KEY = /^[a-z0-9][a-z0-9-]*$/;
 var REPO = /^[\w.-]+\/[\w.-]+$/;
 var FIELDS = ["key", "name", "repo", "path", "preview", "framework", "default"];
@@ -722,7 +746,8 @@ function defineConfig(input) {
         }
       } : {},
       ...g.rights ? { rights: normalizeRights(g.rights) } : {},
-      ...g.soloOwnerCanApproveBoth === true ? { soloOwnerCanApproveBoth: true } : {}
+      ...g.soloOwnerCanApproveBoth === true ? { soloOwnerCanApproveBoth: true } : {},
+      ...g.leadsPublishTier1 === false ? { leadsPublishTier1: false } : {}
     },
     products: input.products?.length ? input.products.map((p) => ({ ...p })) : DEFAULT_PRODUCTS.map((p) => ({ ...p })),
     changes: input.changes === "direct" ? "direct" : DEFAULT_CHANGES_MODE,
@@ -850,6 +875,7 @@ function loadConfig(source) {
       }
       problems.push(...rightsProblems(gov.rights));
       if (gov.soloOwnerCanApproveBoth !== void 0 && typeof gov.soloOwnerCanApproveBoth !== "boolean") problems.push('"governance.soloOwnerCanApproveBoth" must be true or false');
+      if (gov.leadsPublishTier1 !== void 0 && typeof gov.leadsPublishTier1 !== "boolean") problems.push('"governance.leadsPublishTier1" must be true or false');
     }
   }
   problems.push(...visualImpactProblems(d.visualImpact));
@@ -1071,164 +1097,6 @@ function parseContrastChecks(text) {
   return out;
 }
 
-// ../core/src/scopes.ts
-var has = (segments, ...names) => names.some((n) => segments.includes(n));
-function defaultScopes(path, type, tier) {
-  const s = path.split(".");
-  switch (type) {
-    case "color":
-      if (tier === "primitive" || tier === "brand" && s[0] === "palette") return [];
-      if (has(s, "text")) return ["TEXT_FILL"];
-      if (has(s, "border", "ring", "outline")) return ["STROKE_COLOR"];
-      if (has(s, "bg", "surface", "background")) return ["FRAME_FILL", "SHAPE_FILL"];
-      if (has(s, "shadow")) return ["EFFECT_COLOR"];
-      return ["FRAME_FILL", "SHAPE_FILL", "TEXT_FILL", "STROKE_COLOR"];
-    case "dimension":
-      if (has(s, "radius")) return ["CORNER_RADIUS"];
-      if (has(s, "border", "width", "stroke")) return ["STROKE_FLOAT"];
-      if (has(s, "space", "spacing", "gap")) return ["GAP", "WIDTH_HEIGHT"];
-      if (has(s, "size") && has(s, "font")) return ["FONT_SIZE"];
-      if (has(s, "letter-spacing")) return ["LETTER_SPACING"];
-      return ["WIDTH_HEIGHT", "GAP"];
-    case "fontWeight":
-      return ["FONT_WEIGHT"];
-    case "fontFamily":
-      return ["FONT_FAMILY"];
-    case "number":
-      if (has(s, "line-height", "lineHeight")) return ["LINE_HEIGHT"];
-      if (has(s, "opacity")) return ["OPACITY"];
-      return ["WIDTH_HEIGHT", "GAP"];
-    case "string":
-      return ["TEXT_CONTENT"];
-    default:
-      return [];
-  }
-}
-var sameScopes = (a, b) => {
-  const sa = [...new Set(a)].sort();
-  const sb = [...new Set(b)].sort();
-  return sa.length === sb.length && sa.every((x, i) => x === sb[i]);
-};
-var effectiveScopes = (t) => t.scopes ?? defaultScopes(t.path, t.type, t.tier);
-
-// ../core/src/diff-engine.ts
-var normDesc = (d) => (d ?? "").trim();
-function fieldChanges(a, b) {
-  const out = [];
-  if (a.path !== b.path) out.push({ field: "path", before: a.path, after: b.path });
-  if (a.type !== b.type) out.push({ field: "type", before: a.type, after: b.type });
-  const modes = [.../* @__PURE__ */ new Set([...Object.keys(a.values), ...Object.keys(b.values)])];
-  for (const mode of modes) {
-    if (!valuesEqual(b.type, a.values[mode], b.values[mode])) out.push({ field: "value", mode, before: a.values[mode], after: b.values[mode] });
-  }
-  if (normDesc(a.description) !== normDesc(b.description)) out.push({ field: "description", before: a.description, after: b.description });
-  const sa = effectiveScopes(a);
-  const sb = effectiveScopes(b);
-  if (!sameScopes(sa, sb)) out.push({ field: "scopes", before: sa, after: sb });
-  return out;
-}
-function sameToken(a, b) {
-  if (!a || !b) return a === b;
-  return fieldChanges(a, b).length === 0;
-}
-function sideChange(from, to) {
-  if (!from && !to) return void 0;
-  if (!from) return { kind: "added", fields: [] };
-  if (!to) return { kind: "removed", fields: [] };
-  const fields = fieldChanges(from, to);
-  if (!fields.length) return void 0;
-  return { kind: fields.some((f) => f.field === "path") ? "renamed" : "changed", fields };
-}
-function threeWayDiff(base, figma, head) {
-  const ids = /* @__PURE__ */ new Set([...base?.keys() ?? [], ...figma.keys(), ...head.keys()]);
-  const result = { local: [], remote: [], conflicts: [], unchanged: 0 };
-  for (const id of [...ids].sort()) {
-    const b = base?.get(id);
-    const f = figma.get(id);
-    const h = head.get(id);
-    const local = sideChange(b, f);
-    const remote = sideChange(b, h);
-    if (!local && !remote || f && h && sameToken(f, h) || !f && !h) {
-      result.unchanged++;
-      continue;
-    }
-    const entry = { id, path: (f ?? h ?? b).path, base: b, figma: f, head: h, local, remote, conflict: false };
-    if (local && !remote) {
-      entry.path = (f ?? b).path;
-      result.local.push(entry);
-    } else if (remote && !local) {
-      entry.path = (h ?? b).path;
-      result.remote.push(entry);
-    } else {
-      entry.conflict = true;
-      result.conflicts.push(entry);
-    }
-  }
-  const byPath = (a, b) => a.path.localeCompare(b.path);
-  result.local.sort(byPath);
-  result.remote.sort(byPath);
-  result.conflicts.sort(byPath);
-  return result;
-}
-
-// ../core/src/risk.ts
-var RISK_LABELS = {
-  1: "Tier 1: low risk, one code owner",
-  2: "Tier 2: medium risk, design review then design + tech approval",
-  3: "Tier 3: token change, needs design + tech approval"
-};
-function figmaPushTierLabel(tier, changes) {
-  const waits = changes.some((c) => c.kind === "renamed" || c.kind === "removed");
-  return `Tier ${tier}: token change. From Figma: design-approved, ${waits ? "waits for a developer OK (a token renamed or removed can break product code)" : "ships once the checks pass"}`;
-}
-var figmaPushNextLine = (changes) => changes.some((c) => c.kind === "renamed" || c.kind === "removed") ? "Pushed from Figma, so design-approved. A developer OKs the rename or removal before it merges." : "Pushed from Figma, so design-approved. Bridge merges it once the automatic checks pass; Undo is in History in Bridge Studio.";
-var BUMP_RANK = { patch: 0, minor: 1, major: 2 };
-var LOW = [/\.md$/, /^docs\//, /\.stories\.tsx?$/, /\.docs\.json$/, /\.test\.tsx?$/, /^\.changeset\//];
-var isSummary = (c) => "kind" in c;
-function summarizeTokenChange(c) {
-  if (isSummary(c)) return c;
-  const path = (c.target ?? c.current).path;
-  if (!c.target) return { kind: "removed", path };
-  if (!c.current) return { kind: "added", path };
-  if (c.current.path !== c.target.path) return { kind: "renamed", path };
-  const fields = fieldChanges(c.current, c.target);
-  return { kind: "changed", path, descriptionOnly: fields.length > 0 && fields.every((f) => f.field === "description") };
-}
-function tokenBump(changes) {
-  let bump;
-  for (const c of changes.map(summarizeTokenChange)) {
-    const b = c.kind === "removed" || c.kind === "renamed" ? "major" : c.kind === "changed" && c.descriptionOnly ? "patch" : "minor";
-    if (!bump || BUMP_RANK[b] > BUMP_RANK[bump]) bump = b;
-  }
-  return bump;
-}
-function isGuardrail(path, config) {
-  const list2 = config ? [...config.governance.guardrails, CONFIG_FILE, ...config.contrast ? [config.contrast.path] : []] : DEFAULT_GOVERNANCE.guardrails;
-  return list2.some((g) => g.endsWith("/") ? path.startsWith(g) : path === g) || path.startsWith(".github/") || path.endsWith("/contrast.checks.json") || path === "contrast.checks.json";
-}
-function classifyRisk(input) {
-  const reasons = [];
-  const tokenChanges = (input.tokenChanges ?? []).map(summarizeTokenChange);
-  for (const c of tokenChanges) {
-    if (c.kind === "changed" && c.descriptionOnly) reasons.push({ tier: 1, text: `Token description changed: ${c.path}` });
-    else reasons.push({ tier: 3, text: `Token ${c.kind}: ${c.path}` });
-  }
-  const bump = tokenBump(tokenChanges);
-  const componentsDir = input.config?.components?.dir;
-  for (const f of input.files ?? []) {
-    const p = f.path.replace(/^\/+/, "");
-    if (p.endsWith(".tokens.json")) {
-      if (!input.tokenChanges) reasons.push({ tier: 3, text: `Token file ${f.status ?? "changed"}: ${p}` });
-    } else if (isGuardrail(p, input.config)) reasons.push({ tier: 3, text: `Guardrail file changed: ${p}` });
-    else if (LOW.some((r) => r.test(p))) reasons.push({ tier: 1, text: `Docs, story or test: ${p}` });
-    else if (componentsDir && p.startsWith(`${componentsDir}/`)) reasons.push({ tier: 2, text: `Component source ${f.status ?? "changed"}: ${p}` });
-    else reasons.push({ tier: 2, text: `Source file changed: ${p}` });
-  }
-  reasons.sort((a, b) => b.tier - a.tier);
-  const tier = reasons[0]?.tier ?? 1;
-  return { tier, label: RISK_LABELS[tier], reasons: reasons.map((r) => r.text), bump };
-}
-
 // ../core/src/layered.ts
 var DTCG_TYPES = /* @__PURE__ */ new Set(["color", "dimension", "fontFamily", "fontWeight", "duration", "cubicBezier", "number", "strokeStyle", "border", "transition", "shadow", "gradient", "typography", "fontStyle", "string", "boolean"]);
 var aliasOf = (v) => isAlias(v) ? aliasTarget(v) : null;
@@ -1596,6 +1464,164 @@ function layeredParityIssues(set) {
   return out;
 }
 
+// ../core/src/scopes.ts
+var has = (segments, ...names) => names.some((n) => segments.includes(n));
+function defaultScopes(path, type, tier) {
+  const s = path.split(".");
+  switch (type) {
+    case "color":
+      if (tier === "primitive" || tier === "brand" && s[0] === "palette") return [];
+      if (has(s, "text")) return ["TEXT_FILL"];
+      if (has(s, "border", "ring", "outline")) return ["STROKE_COLOR"];
+      if (has(s, "bg", "surface", "background")) return ["FRAME_FILL", "SHAPE_FILL"];
+      if (has(s, "shadow")) return ["EFFECT_COLOR"];
+      return ["FRAME_FILL", "SHAPE_FILL", "TEXT_FILL", "STROKE_COLOR"];
+    case "dimension":
+      if (has(s, "radius")) return ["CORNER_RADIUS"];
+      if (has(s, "border", "width", "stroke")) return ["STROKE_FLOAT"];
+      if (has(s, "space", "spacing", "gap")) return ["GAP", "WIDTH_HEIGHT"];
+      if (has(s, "size") && has(s, "font")) return ["FONT_SIZE"];
+      if (has(s, "letter-spacing")) return ["LETTER_SPACING"];
+      return ["WIDTH_HEIGHT", "GAP"];
+    case "fontWeight":
+      return ["FONT_WEIGHT"];
+    case "fontFamily":
+      return ["FONT_FAMILY"];
+    case "number":
+      if (has(s, "line-height", "lineHeight")) return ["LINE_HEIGHT"];
+      if (has(s, "opacity")) return ["OPACITY"];
+      return ["WIDTH_HEIGHT", "GAP"];
+    case "string":
+      return ["TEXT_CONTENT"];
+    default:
+      return [];
+  }
+}
+var sameScopes = (a, b) => {
+  const sa = [...new Set(a)].sort();
+  const sb = [...new Set(b)].sort();
+  return sa.length === sb.length && sa.every((x, i) => x === sb[i]);
+};
+var effectiveScopes = (t) => t.scopes ?? defaultScopes(t.path, t.type, t.tier);
+
+// ../core/src/diff-engine.ts
+var normDesc = (d) => (d ?? "").trim();
+function fieldChanges(a, b) {
+  const out = [];
+  if (a.path !== b.path) out.push({ field: "path", before: a.path, after: b.path });
+  if (a.type !== b.type) out.push({ field: "type", before: a.type, after: b.type });
+  const modes = [.../* @__PURE__ */ new Set([...Object.keys(a.values), ...Object.keys(b.values)])];
+  for (const mode of modes) {
+    if (!valuesEqual(b.type, a.values[mode], b.values[mode])) out.push({ field: "value", mode, before: a.values[mode], after: b.values[mode] });
+  }
+  if (normDesc(a.description) !== normDesc(b.description)) out.push({ field: "description", before: a.description, after: b.description });
+  const sa = effectiveScopes(a);
+  const sb = effectiveScopes(b);
+  if (!sameScopes(sa, sb)) out.push({ field: "scopes", before: sa, after: sb });
+  return out;
+}
+function sameToken(a, b) {
+  if (!a || !b) return a === b;
+  return fieldChanges(a, b).length === 0;
+}
+function sideChange(from, to) {
+  if (!from && !to) return void 0;
+  if (!from) return { kind: "added", fields: [] };
+  if (!to) return { kind: "removed", fields: [] };
+  const fields = fieldChanges(from, to);
+  if (!fields.length) return void 0;
+  return { kind: fields.some((f) => f.field === "path") ? "renamed" : "changed", fields };
+}
+function threeWayDiff(base, figma, head) {
+  const ids = /* @__PURE__ */ new Set([...base?.keys() ?? [], ...figma.keys(), ...head.keys()]);
+  const result = { local: [], remote: [], conflicts: [], unchanged: 0 };
+  for (const id of [...ids].sort()) {
+    const b = base?.get(id);
+    const f = figma.get(id);
+    const h = head.get(id);
+    const local = sideChange(b, f);
+    const remote = sideChange(b, h);
+    if (!local && !remote || f && h && sameToken(f, h) || !f && !h) {
+      result.unchanged++;
+      continue;
+    }
+    const entry = { id, path: (f ?? h ?? b).path, base: b, figma: f, head: h, local, remote, conflict: false };
+    if (local && !remote) {
+      entry.path = (f ?? b).path;
+      result.local.push(entry);
+    } else if (remote && !local) {
+      entry.path = (h ?? b).path;
+      result.remote.push(entry);
+    } else {
+      entry.conflict = true;
+      result.conflicts.push(entry);
+    }
+  }
+  const byPath = (a, b) => a.path.localeCompare(b.path);
+  result.local.sort(byPath);
+  result.remote.sort(byPath);
+  result.conflicts.sort(byPath);
+  return result;
+}
+
+// ../core/src/risk.ts
+var RISK_LABELS = {
+  1: "Tier 1: low risk, one code owner",
+  2: "Tier 2: medium risk, design review then design + tech approval",
+  3: "Tier 3: token change, needs design + tech approval"
+};
+function figmaPushTierLabel(tier, changes) {
+  const waits = changes.some((c) => c.kind === "renamed" || c.kind === "removed");
+  return `Tier ${tier}: token change. From Figma: design-approved, ${waits ? "waits for a developer OK (a token renamed or removed can break product code)" : "ships once the checks pass"}`;
+}
+var figmaPushNextLine = (changes) => changes.some((c) => c.kind === "renamed" || c.kind === "removed") ? "Pushed from Figma, so design-approved. A developer OKs the rename or removal before it merges." : "Pushed from Figma, so design-approved. Bridge merges it once the automatic checks pass; Undo is in History in Bridge Studio.";
+var BUMP_RANK = { patch: 0, minor: 1, major: 2 };
+var LOW = [/\.md$/, /^docs\//, /\.stories\.tsx?$/, /\.docs\.json$/, /\.test\.tsx?$/, /^\.changeset\//];
+var isSummary = (c) => "kind" in c;
+function summarizeTokenChange(c) {
+  if (isSummary(c)) return c;
+  const path = (c.target ?? c.current).path;
+  if (!c.target) return { kind: "removed", path };
+  if (!c.current) return { kind: "added", path };
+  if (c.current.path !== c.target.path) return { kind: "renamed", path };
+  const fields = fieldChanges(c.current, c.target);
+  return { kind: "changed", path, descriptionOnly: fields.length > 0 && fields.every((f) => f.field === "description") };
+}
+function tokenBump(changes) {
+  let bump;
+  for (const c of changes.map(summarizeTokenChange)) {
+    const b = c.kind === "removed" || c.kind === "renamed" ? "major" : c.kind === "changed" && c.descriptionOnly ? "patch" : "minor";
+    if (!bump || BUMP_RANK[b] > BUMP_RANK[bump]) bump = b;
+  }
+  return bump;
+}
+function isGuardrail(path, config) {
+  const list2 = config ? [...config.governance.guardrails, CONFIG_FILE, ...config.contrast ? [config.contrast.path] : []] : DEFAULT_GOVERNANCE.guardrails;
+  return list2.some((g) => g.endsWith("/") ? path.startsWith(g) : path === g) || path.startsWith(".github/") || path.endsWith("/contrast.checks.json") || path === "contrast.checks.json";
+}
+function classifyRisk(input) {
+  const reasons = [];
+  const tokenChanges = (input.tokenChanges ?? []).map(summarizeTokenChange);
+  for (const c of tokenChanges) {
+    if (c.kind === "changed" && c.descriptionOnly) reasons.push({ tier: 1, text: `Token description changed: ${c.path}` });
+    else reasons.push({ tier: 3, text: `Token ${c.kind}: ${c.path}` });
+  }
+  const bump = tokenBump(tokenChanges);
+  const componentsDir = input.config?.components?.dir;
+  for (const f of input.files ?? []) {
+    const p = f.path.replace(/^\/+/, "");
+    if (p.endsWith(".tokens.json")) {
+      if (!input.tokenChanges) reasons.push({ tier: 3, text: `Token file ${f.status ?? "changed"}: ${p}` });
+    } else if (isGuardrail(p, input.config)) reasons.push({ tier: 3, text: `Guardrail file changed: ${p}` });
+    else if (LOW.some((r) => r.test(p))) reasons.push({ tier: 1, text: `Docs, story or test: ${p}` });
+    else if (componentsDir && p.startsWith(`${componentsDir}/`)) reasons.push({ tier: 2, text: `Component source ${f.status ?? "changed"}: ${p}` });
+    else reasons.push({ tier: 2, text: `Source file changed: ${p}` });
+  }
+  reasons.sort((a, b) => b.tier - a.tier);
+  const tier = reasons[0]?.tier ?? 1;
+  return { tier, label: RISK_LABELS[tier], reasons: reasons.map((r) => r.text), bump };
+}
+
 // ../core/src/layered-review.ts
 function checkLayeredPair(set, pair, combo) {
   const base = { fg: pair.foreground, bg: pair.background, min: pair.min, modes: comboKey(combo) };
@@ -1830,6 +1856,23 @@ function hashSpec(spec) {
   return specHash(JSON.stringify(rest));
 }
 var variantKeyOf = (props) => Object.keys(props).sort().map((k) => `${k}=${props[k]}`).join(", ") || "Default";
+function matchVariant(spec, props) {
+  if (!spec) return void 0;
+  const key = variantKeyOf(props);
+  const exact = spec.variants.find((v) => variantKeyOf(v.props) === key);
+  if (exact) return exact;
+  const asked = Object.entries(props);
+  const fits = spec.variants.filter((v) => Object.keys(v.props).length > asked.length && asked.every(([k, val]) => v.props[k] === val));
+  if (fits.length <= 1) return fits[0];
+  const atDefault = (name, value) => {
+    const axis = spec.axes?.find((a) => a.name === name);
+    if (axis) return value === axis.default;
+    const v = value.toLowerCase();
+    return v === "false" || v === "default";
+  };
+  const best = fits.filter((v) => Object.entries(v.props).every(([k, val]) => k in props || atDefault(k, val)));
+  return best.length === 1 ? best[0] : void 0;
+}
 function parseComponentSpecs(text) {
   let data;
   try {
@@ -2122,6 +2165,7 @@ export {
   readPreviewComment,
   findPreviewComment,
   resolveBranchPreviews,
+  previewLinksOf,
   previewsSettled,
   expandOwners,
   entryLabel,
@@ -2143,6 +2187,9 @@ export {
   findProduct,
   productOfBranch,
   productForPlace,
+  productRepoOf,
+  productRepos,
+  productOfRepo,
   CONFIG_FILE,
   DEFAULT_OVERRIDE,
   DEFAULT_TOKEN_PATHS,
@@ -2188,6 +2235,7 @@ export {
   coverageSummary,
   hashSpec,
   variantKeyOf,
+  matchVariant,
   parseComponentSpecs,
   figmaCell,
   FIGMA_REFERENCES_BRANCH,

package/dist/context.d.ts

@@ -23,6 +23,13 @@ export interface ContextOptions {
     surface?: 'mcp' | 'cli';
     /** How a person adds a token where Bridge runs, for the rate-limit message. Default: the MCP server's environment. */
     tokenHint?: string;
+    /**
+     * Remote mode run inside a connected product repository (`.bridge/product.json`, product-link.ts): that checkout,
+     * which continuing one of its explorations switches to the branch when safe.
+     */
+    workTree?: string;
+    /** The product key of that repository: new work and a bare reference (#12) default to it. */
+    product?: string;
 }
 /** Whether a request only reads: GET and HEAD, and GraphQL queries (POST /graphql without a mutation). */
 export declare function isReadRequest(url: string, init?: {
@@ -52,6 +59,18 @@ export declare class BridgeContext {
      * branch are refused, new branches need the agent prefix. Local mode uses config.repo or the origin remote.
      */
     github(): Promise<GitHubClient | null>;
+    /**
+     * A client for another repository (a product's own one) with the same token, fetch and hosts. Its default branch
+     * and the protected ones are refused, new branches need `branchPrefix`.
+     */
+    githubFor(repo: string, rules: {
+        protectedBranches: string[];
+        branchPrefix: string;
+    }): GitHubClient;
+    /** The local checkout Bridge may switch branches in: the repo root in local mode, the connected product checkout in remote mode. */
+    get checkout(): string | undefined;
+    /** The product of the connected product repository Bridge runs in (`.bridge/product.json`), if any. */
+    get product(): string | undefined;
     get canWriteRemote(): boolean;
     /** Who reads the messages: 'mcp' (tool names and arguments, the default) or 'cli' (commands and flags). */
     get surface(): 'mcp' | 'cli';