@bridge-ds/cli 0.5.0 → 0.7.0

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { readFile as readFile7, writeFile as writeFile5 } from "node:fs/promises";
-import { isAbsolute, join as join6, relative as relative4, resolve as resolve4 } from "node:path";
+import { isAbsolute, join as join6, relative as relative4, resolve as resolve5 } from "node:path";
 
 // ../core/src/audit/types.ts
 var AUDIT_SCHEMA_VERSION = 1;
@@ -2158,57 +2158,6 @@ function planCssFixes(text, lang, ds) {
   return { edits: edits.map(({ start: _s, end: _e, ...e }) => e), output };
 }
 
-// ../core/src/node/git-local.ts
-import { execFile } from "node:child_process";
-
-// ../core/src/governance.ts
-var DEFAULT_PROTECTED_BRANCHES = ["main", "master"];
-var ProtectedBranchError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ProtectedBranchError";
-  }
-};
-function assertSafeBranch(branch, rules = {}) {
-  const name = branch.replace(/^refs\/heads\//, "").trim();
-  const blocked = /* @__PURE__ */ new Set([...rules.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES, ...rules.base ? [rules.base] : []]);
-  if (!name || blocked.has(name)) {
-    throw new ProtectedBranchError(`Refusing to write to protected branch "${name}". Bridge only creates new branches and pull requests.`);
-  }
-  if (rules.branchPrefix && !name.startsWith(rules.branchPrefix)) {
-    throw new ProtectedBranchError(`Branch "${name}" must start with "${rules.branchPrefix}".`);
-  }
-}
-
-// ../core/src/node/git-local.ts
-function git(root, args, opts = {}) {
-  return new Promise((resolve5, reject) => {
-    const child = execFile("git", args, { cwd: root, env: { ...process.env, ...opts.env }, maxBuffer: 32 * 1024 * 1024 }, (err, stdout, stderr) => {
-      if (err) reject(new Error(`git ${args.join(" ")}: ${stderr || err.message}`.trim()));
-      else resolve5(stdout);
-    });
-    if (opts.input !== void 0) child.stdin.end(opts.input);
-  });
-}
-async function showFile(root, ref, path) {
-  try {
-    return await git(root, ["show", `${ref}:${path}`]);
-  } catch {
-    return null;
-  }
-}
-async function listFilesAt(root, ref) {
-  return (await git(root, ["ls-tree", "-r", "--name-only", ref])).split("\n").filter(Boolean);
-}
-async function originRepo(root) {
-  try {
-    const url = (await git(root, ["remote", "get-url", "origin"])).trim();
-    return /github\.com[:/]([\w.-]+\/[\w.-]+?)(\.git)?$/.exec(url)?.[1];
-  } catch {
-    return void 0;
-  }
-}
-
 // ../core/src/previews.ts
 var PREVIEW_APP_LABELS = { docs: "Docs", storybook: "Storybook", admin: "Admin demo" };
 
@@ -2475,6 +2424,8 @@ function productProblems(raw) {
 
 // ../core/src/config.ts
 var CONFIG_FILE = "bridge.config.json";
+var CHANGES_MODES = ["suggest", "direct"];
+var DEFAULT_CHANGES_MODE = "suggest";
 var DEFAULT_OVERRIDE = { allowed: [], requireReason: true, minReasonLength: 20 };
 var DEFAULT_TOKEN_PATHS = {
   root: "tokens",
@@ -2614,6 +2565,8 @@ function defineConfig(input) {
       ...g.rights ? { rights: normalizeRights(g.rights) } : {}
     },
     products: input.products?.length ? input.products.map((p) => ({ ...p })) : DEFAULT_PRODUCTS.map((p) => ({ ...p })),
+    changes: input.changes === "direct" ? "direct" : DEFAULT_CHANGES_MODE,
+    ...input.storybook?.url ? { storybook: { url: input.storybook.url.trim().replace(/\/+$/, "") } } : {},
     ...input.audit ? { audit: { ...input.audit } } : {},
     ...input.visualImpact ? { visualImpact: { mode: input.visualImpact.mode === "on-demand" ? "on-demand" : "auto" } } : {},
     ...input.integrations ? { integrations: { ...input.integrations } } : {},
@@ -2736,6 +2689,13 @@ function loadConfig(source) {
     }
   }
   problems.push(...visualImpactProblems(d.visualImpact));
+  if (d.changes !== void 0 && !CHANGES_MODES.includes(d.changes)) problems.push(`"changes" must be "suggest" or "direct" (got ${JSON.stringify(d.changes)})`);
+  const sb = d.storybook;
+  if (sb !== void 0) {
+    if (!isObj(sb) || !isStr(sb.url)) problems.push('"storybook" must be { "url" } with the deployed Storybook address');
+    else if (!/^https:\/\/[^\s/]+/.test(sb.url.trim())) problems.push('"storybook.url" must start with https://, for example https://storybook.example.com');
+    else for (const k of Object.keys(sb)) if (k !== "url") problems.push(`"storybook.${k}" is not a known key`);
+  }
   problems.push(...productProblems(d.products));
   const audit2 = d.audit;
   if (audit2 !== void 0) {
@@ -2766,6 +2726,57 @@ function loadConfig(source) {
   return defineConfig(d);
 }
 
+// ../core/src/node/git-local.ts
+import { execFile } from "node:child_process";
+
+// ../core/src/governance.ts
+var DEFAULT_PROTECTED_BRANCHES = ["main", "master"];
+var ProtectedBranchError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ProtectedBranchError";
+  }
+};
+function assertSafeBranch(branch, rules = {}) {
+  const name = branch.replace(/^refs\/heads\//, "").trim();
+  const blocked = /* @__PURE__ */ new Set([...rules.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES, ...rules.base ? [rules.base] : []]);
+  if (!name || blocked.has(name)) {
+    throw new ProtectedBranchError(`Refusing to write to protected branch "${name}". Bridge only creates new branches and pull requests.`);
+  }
+  if (rules.branchPrefix && !name.startsWith(rules.branchPrefix)) {
+    throw new ProtectedBranchError(`Branch "${name}" must start with "${rules.branchPrefix}".`);
+  }
+}
+
+// ../core/src/node/git-local.ts
+function git(root, args, opts = {}) {
+  return new Promise((resolve6, reject) => {
+    const child = execFile("git", args, { cwd: root, env: { ...process.env, ...opts.env }, maxBuffer: 32 * 1024 * 1024 }, (err, stdout, stderr) => {
+      if (err) reject(new Error(`git ${args.join(" ")}: ${stderr || err.message}`.trim()));
+      else resolve6(stdout);
+    });
+    if (opts.input !== void 0) child.stdin.end(opts.input);
+  });
+}
+async function showFile(root, ref, path) {
+  try {
+    return await git(root, ["show", `${ref}:${path}`]);
+  } catch {
+    return null;
+  }
+}
+async function listFilesAt(root, ref) {
+  return (await git(root, ["ls-tree", "-r", "--name-only", ref])).split("\n").filter(Boolean);
+}
+async function originRepo(root) {
+  try {
+    const url = (await git(root, ["remote", "get-url", "origin"])).trim();
+    return /github\.com[:/]([\w.-]+\/[\w.-]+?)(\.git)?$/.exec(url)?.[1];
+  } catch {
+    return void 0;
+  }
+}
+
 // ../core/src/layered-review.ts
 var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 function diffLayered(before, after) {
@@ -2958,93 +2969,6 @@ function parseComponentSpecs(text) {
   return f;
 }
 
-// src/index.ts
-import { fileURLToPath } from "node:url";
-
-// ../visual/src/run.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { mkdir as mkdir3, readFile as readFile3, rm as rm2, unlink, writeFile as writeFile3 } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join as join4, relative as relative3, resolve as resolve2 } from "node:path";
-
-// ../core/src/protection.ts
-var PROTECTION_PARTS = ["review", "checks", "history", "deletion"];
-var protectionRulesetName = (defaultBranch) => `Protect the library (${defaultBranch})`;
-function refPattern(pattern) {
-  const src = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\u0000/g, ".*");
-  return new RegExp(`^${src}$`);
-}
-function rulesetTargetsDefault(ruleset, defaultBranch) {
-  if (ruleset.target && ruleset.target !== "branch") return false;
-  const ref = `refs/heads/${defaultBranch}`;
-  const hit = (p) => p === "~ALL" || p === "~DEFAULT_BRANCH" || p === ref || p === defaultBranch || refPattern(p.startsWith("refs/") ? p : `refs/heads/${p}`).test(ref);
-  const cond = ruleset.conditions?.ref_name;
-  if (!cond) return false;
-  if ((cond.exclude ?? []).some(hit)) return false;
-  return (cond.include ?? []).some(hit);
-}
-var count = (v) => typeof v === "number" ? v : 0;
-function rulesetParts(ruleset) {
-  const parts = /* @__PURE__ */ new Set();
-  if (ruleset.enforcement !== "active") return parts;
-  for (const rule of ruleset.rules ?? []) {
-    if (rule.type === "deletion") parts.add("deletion");
-    if (rule.type === "non_fast_forward") parts.add("history");
-    if (rule.type === "pull_request" && count(rule.parameters?.required_approving_review_count) >= 1) parts.add("review");
-    if (rule.type === "required_status_checks" && Array.isArray(rule.parameters?.required_status_checks) && rule.parameters.required_status_checks.length > 0) parts.add("checks");
-  }
-  return parts;
-}
-function classicParts(p) {
-  const parts = /* @__PURE__ */ new Set();
-  if (count(p.required_pull_request_reviews?.required_approving_review_count) >= 1) parts.add("review");
-  if (((p.required_status_checks?.contexts?.length ?? 0) || (p.required_status_checks?.checks?.length ?? 0)) > 0) parts.add("checks");
-  if (!p.allow_force_pushes?.enabled) parts.add("history");
-  if (!p.allow_deletions?.enabled) parts.add("deletion");
-  return parts;
-}
-var rulesetUrl = (r) => r.html_url ?? r._links?.html?.href;
-function protectionState(rulesets, branchProtection, defaultBranch) {
-  const bridge = rulesets?.find((r) => r.name === protectionRulesetName(defaultBranch));
-  const extra = bridge?.id !== void 0 ? { bridgeRulesetId: bridge.id } : {};
-  const covered = /* @__PURE__ */ new Set();
-  let url;
-  for (const r of rulesets ?? []) {
-    if (!rulesetTargetsDefault(r, defaultBranch)) continue;
-    const parts = rulesetParts(r);
-    if (parts.size && !url) url = rulesetUrl(r);
-    parts.forEach((p) => covered.add(p));
-  }
-  if (branchProtection) classicParts(branchProtection).forEach((p) => covered.add(p));
-  const missing = PROTECTION_PARTS.filter((p) => !covered.has(p));
-  const withUrl = url ? { url } : {};
-  if (!missing.length) return { kind: "protected", missing, ...extra, ...withUrl };
-  const unreadable = rulesets == null || branchProtection === void 0;
-  if (covered.size === 0) return { kind: unreadable ? "unknown" : "unprotected", missing, ...extra };
-  return { kind: "partial", missing, ...extra, ...withUrl };
-}
-var PROTECTION_PART_PHRASE = {
-  review: "changes can skip review",
-  checks: "checks do not have to pass",
-  history: "past changes can be rewritten",
-  deletion: "the library can be deleted"
-};
-var joinAnd = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
-function protectionSentence(state) {
-  switch (state.kind) {
-    case "protected":
-      return "Protected: every change goes through review.";
-    case "unprotected":
-      return "Your library can be changed without review.";
-    case "partial": {
-      const s = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
-      return `Partly protected: ${s}.`;
-    }
-    default:
-      return "Protection status unknown: GitHub did not let this token read it.";
-  }
-}
-
 // ../core/src/github-client.ts
 var GitHubError = class extends Error {
   constructor(status, message, detail, info = {}) {
@@ -3423,10 +3347,16 @@ var GitHubClient = class _GitHubClient {
   async addComment(issueNumber2, body) {
     await this.request("POST", `${this.repoPath}/issues/${issueNumber2}/comments`, { body });
   }
-  /** Comments on an issue or pull request, oldest first (first 100: the sticky preview comment is posted early). */
+  /**
+   * Comments on an issue or pull request, oldest first (first 100: the sticky preview comment is posted early).
+   * `authorAssociation` is GitHub's OWNER, MEMBER, COLLABORATOR, CONTRIBUTOR, NONE... (suggestion approvals read it).
+   */
   async listIssueComments(issueNumber2) {
-    const r = await this.request("GET", `${this.repoPath}/issues/${issueNumber2}/comments?per_page=100`);
-    return r.map((c) => ({ id: c.id, body: c.body ?? "", author: c.user?.login ?? "unknown", updatedAt: c.updated_at }));
+    const r = await this.request(
+      "GET",
+      `${this.repoPath}/issues/${issueNumber2}/comments?per_page=100`
+    );
+    return r.map((c) => ({ id: c.id, body: c.body ?? "", author: c.user?.login ?? "unknown", updatedAt: c.updated_at, createdAt: c.created_at ?? c.updated_at, authorAssociation: c.author_association ?? "NONE" }));
   }
   // --- Issues (component change requests) ---------------------------------------------------
   async createIssue(input) {
@@ -3773,6 +3703,17 @@ var GitHubClient = class _GitHubClient {
     this.assertToken("Updating a branch from main");
     await this.request("PUT", `${this.repoPath}/pulls/${n}/update-branch`, { expected_head_sha: expectedHeadSha });
   }
+  /**
+   * Merges the branch `head` into the branch `base` (GitHub's merges API): a merge commit on `base`, or nothing when
+   * `base` already has every commit of `head`. A conflict throws a GitHubError with status 409. Refuses protected
+   * branches and, with a branch prefix, a `base` without it.
+   */
+  async mergeIntoBranch(base, head, message) {
+    this.assertToken("Merging a branch into another");
+    this.assertWritableBranch(base);
+    const r = await this.request("POST", `${this.repoPath}/merges`, { base, head, commit_message: message });
+    return r?.sha ? { status: "merged", sha: r.sha } : { status: "up-to-date", sha: null };
+  }
   /** Posts a comment on an issue or pull request and returns its id and link. */
   async createIssueComment(n, body) {
     this.assertToken("Commenting");
@@ -3905,6 +3846,148 @@ function toIssue(r) {
   };
 }
 
+// ../core/src/explorations.ts
+var EXPLORATION_USE_CASES = [
+  { value: "user-test", label: "Prototype for a user test", hint: "A coded prototype on a product staging branch, with the real components and tokens." },
+  { value: "stakeholder-demo", label: "Stakeholder demo", hint: "Show an idea on real screens before anyone commits to it." },
+  { value: "ab-idea", label: "A/B idea", hint: "Ship a variant to a staging or experiment branch and compare it with what is live." },
+  { value: "terminal", label: "Exploring with Claude Code", hint: "A designer works from the terminal with Claude and the Bridge MCP server on this branch, never on main." },
+  { value: "other", label: "Other", hint: "Anything else worth trying before it becomes a change." }
+];
+var EXPLORATION_STATUS_LABEL = { active: "Running", promoted: "Promoted to review", closed: "Closed" };
+
+// ../core/src/requests.ts
+var REQUEST_KINDS = [
+  { value: "new-component", label: "New component", hint: "A component the design system does not have yet." },
+  { value: "new-variant", label: "New variant", hint: "A size, tone or state the component does not have yet." },
+  { value: "prop-change", label: "Option change (prop)", hint: "Add, rename or change an option (a prop in code) or its default." },
+  { value: "structure", label: "Structure change", hint: "A part was added, removed or moved." },
+  { value: "visual", label: "Visual change", hint: "Spacing, radius, layout or icon placement." },
+  { value: "token-binding", label: "Token change", hint: "The component should paint with another token." },
+  { value: "bug", label: "Bug", hint: "It looks or behaves differently from the guidance." },
+  { value: "other", label: "Other", hint: "Anything else." }
+];
+var REQUEST_LABEL = "component-change";
+function requestIssueTitle(r) {
+  const t = r.title.trim().replace(/\.$/, "");
+  return `${r.component}: ${t.charAt(0).toLowerCase()}${t.slice(1)}`;
+}
+var REQUEST_STATUS_LABEL = { requested: "Requested", "in-progress": "In progress", done: "Done", declined: "Declined" };
+function validateIntegrations(i) {
+  const out = [];
+  if (!i?.jira) return out;
+  if (!/^https:\/\/[^/]+/.test(i.jira.baseUrl ?? "")) out.push("Jira site must start with https://, for example https://acme.atlassian.net.");
+  if (!/^[A-Z][A-Z0-9_]{1,9}$/.test(i.jira.project ?? "")) out.push("Jira project key is 2 to 10 capital letters or digits, like DS.");
+  return out;
+}
+function jiraIssueFields(r, jira, issueUrl) {
+  const text = (t) => ({ type: "text", text: t });
+  const para = (...c) => ({ type: "paragraph", content: c });
+  return {
+    project: { key: jira.project },
+    issuetype: { name: jira.issueType ?? "Task" },
+    summary: requestIssueTitle(r),
+    labels: [.../* @__PURE__ */ new Set(["bridge", REQUEST_LABEL, ...jira.labels ?? []])].map((l) => l.replace(/\s+/g, "-")),
+    description: {
+      type: "doc",
+      version: 1,
+      content: [
+        para(text(r.summary.trim() || r.title)),
+        ...r.line?.trim() ? [para(text(r.line.trim()))] : [],
+        ...r.changes.map((c) => para(text(`${c.field}: ${c.before ?? "(none)"} -> ${c.after ?? "(removed)"}`))),
+        para({ type: "text", text: "GitHub request", marks: [{ type: "link", attrs: { href: issueUrl } }] })
+      ]
+    }
+  };
+}
+
+// src/index.ts
+import { fileURLToPath } from "node:url";
+
+// ../visual/src/run.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { mkdir as mkdir3, readFile as readFile3, rm as rm2, unlink, writeFile as writeFile3 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join as join4, relative as relative3, resolve as resolve2 } from "node:path";
+
+// ../core/src/protection.ts
+var PROTECTION_PARTS = ["review", "checks", "history", "deletion"];
+var protectionRulesetName = (defaultBranch) => `Protect the library (${defaultBranch})`;
+function refPattern(pattern) {
+  const src = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\u0000/g, ".*");
+  return new RegExp(`^${src}$`);
+}
+function rulesetTargetsDefault(ruleset, defaultBranch) {
+  if (ruleset.target && ruleset.target !== "branch") return false;
+  const ref = `refs/heads/${defaultBranch}`;
+  const hit = (p) => p === "~ALL" || p === "~DEFAULT_BRANCH" || p === ref || p === defaultBranch || refPattern(p.startsWith("refs/") ? p : `refs/heads/${p}`).test(ref);
+  const cond = ruleset.conditions?.ref_name;
+  if (!cond) return false;
+  if ((cond.exclude ?? []).some(hit)) return false;
+  return (cond.include ?? []).some(hit);
+}
+var count = (v) => typeof v === "number" ? v : 0;
+function rulesetParts(ruleset) {
+  const parts = /* @__PURE__ */ new Set();
+  if (ruleset.enforcement !== "active") return parts;
+  for (const rule of ruleset.rules ?? []) {
+    if (rule.type === "deletion") parts.add("deletion");
+    if (rule.type === "non_fast_forward") parts.add("history");
+    if (rule.type === "pull_request" && count(rule.parameters?.required_approving_review_count) >= 1) parts.add("review");
+    if (rule.type === "required_status_checks" && Array.isArray(rule.parameters?.required_status_checks) && rule.parameters.required_status_checks.length > 0) parts.add("checks");
+  }
+  return parts;
+}
+function classicParts(p) {
+  const parts = /* @__PURE__ */ new Set();
+  if (count(p.required_pull_request_reviews?.required_approving_review_count) >= 1) parts.add("review");
+  if (((p.required_status_checks?.contexts?.length ?? 0) || (p.required_status_checks?.checks?.length ?? 0)) > 0) parts.add("checks");
+  if (!p.allow_force_pushes?.enabled) parts.add("history");
+  if (!p.allow_deletions?.enabled) parts.add("deletion");
+  return parts;
+}
+var rulesetUrl = (r) => r.html_url ?? r._links?.html?.href;
+function protectionState(rulesets, branchProtection, defaultBranch) {
+  const bridge = rulesets?.find((r) => r.name === protectionRulesetName(defaultBranch));
+  const extra = bridge?.id !== void 0 ? { bridgeRulesetId: bridge.id } : {};
+  const covered = /* @__PURE__ */ new Set();
+  let url;
+  for (const r of rulesets ?? []) {
+    if (!rulesetTargetsDefault(r, defaultBranch)) continue;
+    const parts = rulesetParts(r);
+    if (parts.size && !url) url = rulesetUrl(r);
+    parts.forEach((p) => covered.add(p));
+  }
+  if (branchProtection) classicParts(branchProtection).forEach((p) => covered.add(p));
+  const missing = PROTECTION_PARTS.filter((p) => !covered.has(p));
+  const withUrl = url ? { url } : {};
+  if (!missing.length) return { kind: "protected", missing, ...extra, ...withUrl };
+  const unreadable = rulesets == null || branchProtection === void 0;
+  if (covered.size === 0) return { kind: unreadable ? "unknown" : "unprotected", missing, ...extra };
+  return { kind: "partial", missing, ...extra, ...withUrl };
+}
+var PROTECTION_PART_PHRASE = {
+  review: "changes can skip review",
+  checks: "checks do not have to pass",
+  history: "past changes can be rewritten",
+  deletion: "the library can be deleted"
+};
+var joinAnd = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
+function protectionSentence(state) {
+  switch (state.kind) {
+    case "protected":
+      return "Protected: every change goes through review.";
+    case "unprotected":
+      return "Your library can be changed without review.";
+    case "partial": {
+      const s = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
+      return `Partly protected: ${s}.`;
+    }
+    default:
+      return "Protection status unknown: GitHub did not let this token read it.";
+  }
+}
+
 // ../core/src/protection-github.ts
 async function loadProtection(client, defaultBranch) {
   const rulesets = await client.listRulesets().then((list2) => Promise.all(list2.map((r) => r.enforcement === "disabled" || r.id === void 0 ? r : client.getRuleset(r.id)))).catch(() => null);
@@ -4021,61 +4104,6 @@ function impactedModules(index, input) {
   return { modules, globalHits };
 }
 
-// ../core/src/explorations.ts
-var EXPLORATION_USE_CASES = [
-  { value: "user-test", label: "Prototype for a user test", hint: "A coded prototype on a product staging branch, with the real components and tokens." },
-  { value: "stakeholder-demo", label: "Stakeholder demo", hint: "Show an idea on real screens before anyone commits to it." },
-  { value: "ab-idea", label: "A/B idea", hint: "Ship a variant to a staging or experiment branch and compare it with what is live." },
-  { value: "terminal", label: "Exploring with Claude Code", hint: "A designer works from the terminal with Claude and the Bridge MCP server on this branch, never on main." },
-  { value: "other", label: "Other", hint: "Anything else worth trying before it becomes a change." }
-];
-var EXPLORATION_STATUS_LABEL = { active: "Running", promoted: "Promoted to review", closed: "Closed" };
-
-// ../core/src/requests.ts
-var REQUEST_KINDS = [
-  { value: "new-component", label: "New component", hint: "A component the design system does not have yet." },
-  { value: "new-variant", label: "New variant", hint: "A size, tone or state the component does not have yet." },
-  { value: "prop-change", label: "Option change (prop)", hint: "Add, rename or change an option (a prop in code) or its default." },
-  { value: "structure", label: "Structure change", hint: "A part was added, removed or moved." },
-  { value: "visual", label: "Visual change", hint: "Spacing, radius, layout or icon placement." },
-  { value: "token-binding", label: "Token change", hint: "The component should paint with another token." },
-  { value: "bug", label: "Bug", hint: "It looks or behaves differently from the guidance." },
-  { value: "other", label: "Other", hint: "Anything else." }
-];
-var REQUEST_LABEL = "component-change";
-function requestIssueTitle(r) {
-  const t = r.title.trim().replace(/\.$/, "");
-  return `${r.component}: ${t.charAt(0).toLowerCase()}${t.slice(1)}`;
-}
-var REQUEST_STATUS_LABEL = { requested: "Requested", "in-progress": "In progress", done: "Done", declined: "Declined" };
-function validateIntegrations(i) {
-  const out = [];
-  if (!i?.jira) return out;
-  if (!/^https:\/\/[^/]+/.test(i.jira.baseUrl ?? "")) out.push("Jira site must start with https://, for example https://acme.atlassian.net.");
-  if (!/^[A-Z][A-Z0-9_]{1,9}$/.test(i.jira.project ?? "")) out.push("Jira project key is 2 to 10 capital letters or digits, like DS.");
-  return out;
-}
-function jiraIssueFields(r, jira, issueUrl) {
-  const text = (t) => ({ type: "text", text: t });
-  const para = (...c) => ({ type: "paragraph", content: c });
-  return {
-    project: { key: jira.project },
-    issuetype: { name: jira.issueType ?? "Task" },
-    summary: requestIssueTitle(r),
-    labels: [.../* @__PURE__ */ new Set(["bridge", REQUEST_LABEL, ...jira.labels ?? []])].map((l) => l.replace(/\s+/g, "-")),
-    description: {
-      type: "doc",
-      version: 1,
-      content: [
-        para(text(r.summary.trim() || r.title)),
-        ...r.line?.trim() ? [para(text(r.line.trim()))] : [],
-        ...r.changes.map((c) => para(text(`${c.field}: ${c.before ?? "(none)"} -> ${c.after ?? "(removed)"}`))),
-        para({ type: "text", text: "GitHub request", marks: [{ type: "link", attrs: { href: issueUrl } }] })
-      ]
-    }
-  };
-}
-
 // ../core/src/fidelity-references.ts
 var FIGMA_REFERENCES_DIR = "figma-references";
 var FIGMA_REFERENCES_MANIFEST = `${FIGMA_REFERENCES_DIR}/manifest.json`;
@@ -4299,15 +4327,15 @@ async function shoot(page, r) {
 }
 async function switchStory(page, storyId2) {
   const ok = await page.evaluate(
-    (id) => new Promise((resolve5) => {
+    (id) => new Promise((resolve6) => {
       const ch = window.__STORYBOOK_ADDONS_CHANNEL__;
-      if (!ch) return resolve5(false);
+      if (!ch) return resolve6(false);
       const events = ["storyRendered", "storyErrored", "storyThrewException", "storyMissing", "playFunctionThrewException"];
       const timer = setTimeout(() => done(), 15e3);
       function done() {
         clearTimeout(timer);
         for (const e of events) ch.off(e, done);
-        resolve5(true);
+        resolve6(true);
       }
       for (const e of events) ch.on(e, done);
       window.scrollTo(0, 0);
@@ -4720,12 +4748,12 @@ function serveDir(dir) {
     res.writeHead(200, { "content-type": TYPES[extname(file)] ?? "application/octet-stream", "cache-control": "no-store" });
     createReadStream(file).pipe(res);
   });
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     server.once("error", reject);
     server.listen(0, "127.0.0.1", () => {
       const addr = server.address();
       const port = typeof addr === "object" && addr ? addr.port : 0;
-      resolve5({ url: `http://127.0.0.1:${port}`, close: () => new Promise((r) => server.close(() => r())) });
+      resolve6({ url: `http://127.0.0.1:${port}`, close: () => new Promise((r) => server.close(() => r())) });
     });
   });
 }
@@ -4797,7 +4825,7 @@ async function removeWorktree(repo, dir) {
   await git(repo, ["worktree", "prune"]).catch(() => void 0);
 }
 function run(cmd, args, cwd, log, root = cwd, env = {}) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const bin = [.../* @__PURE__ */ new Set([join3(cwd, "node_modules", ".bin"), join3(root, "node_modules", ".bin")])].join(":");
     const child = spawn(cmd, args, {
       cwd,
@@ -4810,7 +4838,7 @@ function run(cmd, args, cwd, log, root = cwd, env = {}) {
     child.stderr.on("data", keep);
     child.on("error", reject);
     child.on("close", (code) => {
-      if (code === 0) resolve5();
+      if (code === 0) resolve6();
       else {
         log(tail);
         reject(new Error(`${cmd} ${args.join(" ")} failed in ${cwd} (exit ${code})`));
@@ -5221,12 +5249,12 @@ async function captureFigmaReferences(o) {
       }
       const plan = JSON.stringify(j.plan.render);
       await page.evaluate(
-        ({ id, plan: plan2 }) => new Promise((resolve5) => {
+        ({ id, plan: plan2 }) => new Promise((resolve6) => {
           const ch = window.__STORYBOOK_ADDONS_CHANNEL__;
           const done = () => {
             clearTimeout(timer);
             ch.off("storyRendered", done);
-            resolve5();
+            resolve6();
           };
           const timer = setTimeout(done, 1e4);
           ch.on("storyRendered", done);
@@ -5515,7 +5543,7 @@ Claude Code is not installed (no \`claude\` on PATH). Install it (npm install -g
       if (!REQUEST_KINDS.some((k) => k.value === kind)) throw new RequestUsageError(`--kind takes ${REQUEST_KINDS.map((k) => k.value).join(", ")}, got "${kind}"`);
       const dryRun = has(a, "dry-run");
       const ctx = await context(root, io, !dryRun);
-      const figma = flag(a, "figma");
+      const figma2 = flag(a, "figma");
       const exploration = flag(a, "exploration");
       const r = await requests2.createRequest(ctx, {
         component,
@@ -5523,7 +5551,7 @@ Claude Code is not installed (no \`claude\` on PATH). Install it (npm install -g
         title,
         summary,
         changes: (a.flags.change ?? []).map(parseChange),
-        ...figma ? { figmaUrl: figma } : {},
+        ...figma2 ? { figmaUrl: figma2 } : {},
         ...exploration ? { exploration } : {},
         ...flag(a, "product") ? { product: flag(a, "product") } : {},
         source: "cli",
@@ -5904,6 +5932,177 @@ ${r.content}` : String(r.said));
   return 0;
 }
 
+// src/pieces.ts
+import { BridgeContext as BridgeContext5, branches as branches2, pieces } from "@bridge-ds/mcp";
+var PIECES_HELP = `bridge pieces: a product branch and the library
+
+Usage:
+  bridge pieces <n> [--record] [--json]          what the product branch adds that the library lacks (the audit
+                                                 on its diff against main); --record saves it in the branch,
+                                                 where Bridge Studio shows it
+  bridge pieces status <n> [--json]              each linked library branch: status, reviewers, preview, next step
+  bridge pieces open <n> <piece> [--no-preview] [--dry-run] [--json]
+                                                 open the library side of a piece, linked both ways: a token
+                                                 change, a library exploration (variant) or a request (component)
+  bridge pieces preview <n> <piece>              the product branch takes the latest library branch (merged in)
+  bridge pieces switch <n>                       once the library shipped: main into the product branch
+
+GitHub token: GITHUB_TOKEN or BRIDGE_GITHUB_TOKEN, else \`gh auth token\`. Exit codes: 0 ok, 2 usage or setup error.`;
+var has4 = (a, k) => Boolean(a.flags[k]);
+async function context4(root, io) {
+  const token = io.env.BRIDGE_GITHUB_TOKEN || io.env.GITHUB_TOKEN || io.ghToken();
+  return BridgeContext5.create({ root, ...token ? { token } : {}, ...io.fetch ? { fetch: io.fetch } : {} });
+}
+function number2(a, at, usage) {
+  const raw = a._[at];
+  if (!raw) throw new RequestUsageError(`Usage: ${usage}`);
+  return branches2.branchNumber(raw);
+}
+function piece(a, at, usage) {
+  const raw = a._[at];
+  if (!raw) throw new RequestUsageError(`Usage: ${usage}. \`bridge pieces <n>\` lists the piece ids.`);
+  return raw;
+}
+async function runPieces(a, root, io = defaultIO()) {
+  const sub = a._[1];
+  if (!sub || sub === "help" || has4(a, "help")) {
+    io.print(PIECES_HELP);
+    return sub || has4(a, "help") ? 0 : 2;
+  }
+  const json = has4(a, "json");
+  const ctx = await context4(root, io);
+  const out = (r, text) => (json ? io.print(JSON.stringify(r, null, 2)) : text(), 0);
+  switch (sub) {
+    case "status": {
+      const r = await pieces.productBranchOp(ctx, { pr: number2(a, 2, "bridge pieces status <n>") });
+      return out(r, () => {
+        io.print(`#${r.pr} ${r.title} (${r.product})`);
+        io.print(r.said);
+        for (const l of r.linked) io.print(`  ${l.piece}: #${l.library.number} ${l.status}. ${l.preview}${l.action ? ` Next: ${l.action}.` : ""}`);
+        for (const p of r.notLinked) io.print(`  ${p.title} (${p.id}): no library branch yet. bridge pieces open ${r.pr} ${p.id}`);
+        if (r.next) io.print(r.next);
+      });
+    }
+    case "open": {
+      const usage = "bridge pieces open <n> <piece>";
+      const r = await pieces.openLibraryBranchOp(ctx, { pr: number2(a, 2, usage), piece: piece(a, 3, usage), usePreview: !has4(a, "no-preview"), dryRun: has4(a, "dry-run"), source: "cli" });
+      return out(r, () => {
+        io.print(`${r.status === "dry-run" ? "Would open" : r.status === "already-linked" ? "Already linked" : "Opened"} a ${r.opens}: ${r.title}, needed by ${r.neededBy}.`);
+        if (r.library) io.print(`  #${r.library.number} ${r.library.url}`);
+        if (r.preview) io.print(`  ${r.preview.said}`);
+        for (const w of r.warnings ?? []) io.print(`  ${w}`);
+        io.print(`Next: ${r.next}`);
+      });
+    }
+    case "preview": {
+      const usage = "bridge pieces preview <n> <piece>";
+      const r = await pieces.useLibraryPreviewOp(ctx, { pr: number2(a, 2, usage), piece: piece(a, 3, usage) });
+      return out(r, () => io.print(r.said));
+    }
+    case "switch": {
+      const r = await pieces.switchToPublishedOp(ctx, { pr: number2(a, 2, "bridge pieces switch <n>") });
+      return out(r, () => io.print(r.said));
+    }
+    default: {
+      const r = await pieces.missingPiecesOp(ctx, { pr: number2(a, 1, "bridge pieces <n> [--record]"), record: has4(a, "record") });
+      return out(r, () => {
+        io.print(`#${r.pr} ${r.branch} (${r.product}): ${r.pieces.length ? `${r.pieces.length} ${r.pieces.length === 1 ? "piece is" : "pieces are"} missing from the library` : "nothing is missing from the library"}, ${r.files} files read.`);
+        for (const p of r.pieces) io.print(`  ${p.id}  ${p.title}: ${p.summary} Opens ${p.opens}.${"linked" in p ? ` Linked: #${p.linked}.` : ""}`);
+        if (r.fixes.count) io.print(`${r.fixes.count} value${r.fixes.count === 1 ? "" : "s"} the library already has (use them instead):
+${r.fixes.sample.map((s) => `  ${s}`).join("\n")}`);
+        if (r.skipped) io.print(r.skipped);
+        io.print(`Next: ${r.next}`);
+      });
+    }
+  }
+}
+
+// src/figma.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
+import { BridgeContext as BridgeContext6, branches as branches3, figma } from "@bridge-ds/mcp";
+var FIGMA_HELP = `bridge figma: component changes sent from Figma
+
+Usage:
+  bridge figma [--all] [--json]                  the library branches the DS Bridge plugin opened for components
+                                                 changed in Figma, and where each stands
+  bridge figma show <n> [--draft] [--json]       one of them: its spec and the brief to draft the code; --draft
+                                                 runs Claude Code on the brief (\`claude\` on PATH)
+  bridge figma drafted <n> [--json]              the code is pushed: label it drafted by Claude AI for review
+  bridge figma push <diff.json> [--dry-run] [--json]
+                                                 send a structured component diff like the plugin does: an exact
+                                                 token change, or a branch with the spec for Claude AI
+
+GitHub token: GITHUB_TOKEN or BRIDGE_GITHUB_TOKEN, else \`gh auth token\`. Exit codes: 0 ok, 2 usage or setup error.`;
+var has5 = (a, k) => Boolean(a.flags[k]);
+async function context5(root, io) {
+  const token = io.env.BRIDGE_GITHUB_TOKEN || io.env.GITHUB_TOKEN || io.ghToken();
+  return BridgeContext6.create({ root, ...token ? { token } : {}, ...io.fetch ? { fetch: io.fetch } : {} });
+}
+function number3(a, usage) {
+  const raw = a._[2];
+  if (!raw) throw new RequestUsageError(`Usage: ${usage}`);
+  return branches3.branchNumber(raw);
+}
+async function runFigma(a, root, io = defaultIO()) {
+  const sub = a._[1];
+  if (sub === "help" || has5(a, "help")) {
+    io.print(FIGMA_HELP);
+    return 0;
+  }
+  const json = has5(a, "json");
+  const ctx = await context5(root, io);
+  const out = (r, text) => (json ? io.print(JSON.stringify(r, null, 2)) : text(), 0);
+  switch (sub) {
+    case void 0:
+    case "list": {
+      const r = await figma.figmaChangesOp(ctx, { state: has5(a, "all") ? "all" : "open" });
+      return out(r, () => {
+        for (const c of r.changes) io.print(`#${c.pr} ${c.title} (${c.route}): ${c.status}. ${c.said}`);
+        io.print(`Next: ${r.next}`);
+      });
+    }
+    case "show": {
+      const r = await figma.getFigmaChangeOp(ctx, { pr: number3(a, "bridge figma show <n>") });
+      if (has5(a, "draft")) {
+        if (!r.brief) throw new RequestUsageError(`#${r.pr} is an exact token change: there is no code to draft.`);
+        if (!io.hasClaude()) throw new RequestUsageError("`claude` is not on PATH: install Claude Code, or paste the brief from `bridge figma show <n>` into Claude.");
+        return io.runClaude(r.brief, root);
+      }
+      return out(r, () => {
+        io.print(`#${r.pr} ${r.title} (${r.route}): ${r.status}. ${r.said}`);
+        io.print(`  ${r.url}`);
+        if (r.brief) io.print(`
+${r.brief}`);
+      });
+    }
+    case "drafted": {
+      const r = await figma.markFigmaDraftedOp(ctx, { pr: number3(a, "bridge figma drafted <n>") });
+      return out(r, () => io.print(`#${r.pr}: ${r.status}. ${r.said}`));
+    }
+    case "push": {
+      const file = a._[2];
+      if (!file) throw new RequestUsageError("Usage: bridge figma push <diff.json> [--dry-run]");
+      let diff2;
+      try {
+        diff2 = JSON.parse(readFileSync2(resolve4(root, file), "utf8"));
+      } catch (err) {
+        throw new RequestUsageError(`${file} could not be read as JSON: ${err.message}`);
+      }
+      const r = await figma.pushFigmaComponentOp(ctx, { diff: diff2, dryRun: has5(a, "dry-run"), source: "cli" });
+      return out(r, () => {
+        io.print(`${r.component}: ${r.route}. ${r.said}`);
+        for (const x of r.reasons ?? []) io.print(`  ${x}`);
+        for (const x of r.fixInFigma ?? []) io.print(`  Fix in Figma: ${x.what} ${x.todo}`);
+        if (r.library) io.print(`  #${r.library.number} ${r.library.url}`);
+        io.print(`Next: ${r.next}`);
+      });
+    }
+    default:
+      throw new RequestUsageError(`Unknown subcommand "${sub}". ${FIGMA_HELP}`);
+  }
+}
+
 // src/protection.ts
 var UNKNOWN = { kind: "unknown", missing: ["review", "checks", "history", "deletion"] };
 async function protectionReport(opts) {
@@ -5936,7 +6135,7 @@ async function rolesReport(opts) {
 }
 
 // src/index.ts
-import { brand, BridgeContext as BridgeContext5, CONFIG_FILE as CONFIG_FILE2, core, detectConfig, GitRefSource, history as hist, LocalSource, ops, optionsFromArgv, serveStdio, toConfigJson, VERSION } from "@bridge-ds/mcp";
+import { brand, BridgeContext as BridgeContext7, CONFIG_FILE as CONFIG_FILE2, core, detectConfig, GitRefSource, history as hist, LocalSource, ops, optionsFromArgv, serveStdio, toConfigJson, VERSION } from "@bridge-ds/mcp";
 var MCP_PACKAGE = "@bridge-ds/mcp";
 var HELP = `bridge ${VERSION}: design system as code, for you and your Claude
 
@@ -6018,6 +6217,13 @@ Usage:
                                       (\`bridge branch help\`): what needs me, send for review, review,
                                       merge through the same gate (owner override with a reason), update
                                       from main with token conflicts, try it in a product, try together
+  bridge pieces <n> [--record] | status <n> | open <n> <piece> | preview <n> <piece> | switch <n>
+                                      a product branch and the library (\`bridge pieces help\`): what it adds
+                                      that the library lacks, the library branch each piece opens (linked
+                                      both ways), its preview in the product branch, the published version
+  bridge figma [show <n> | drafted <n> | push <diff.json>]
+                                      component changes sent from Figma (\`bridge figma help\`): exact token
+                                      changes and branches Claude AI drafts from the spec
   bridge products | bridge settings | bridge coverage [Component]
                                       products (and this folder's), Studio settings safe to read, which
                                       components are in Figma
@@ -6046,16 +6252,16 @@ function parse(argv) {
   return out;
 }
 var flag4 = (a, k) => a.flags[k]?.[a.flags[k].length - 1];
-var has4 = (a, k) => Boolean(a.flags[k]);
+var has6 = (a, k) => Boolean(a.flags[k]);
 var print = (s) => process.stdout.write(`${s}
 `);
 var modeArg = (s) => s ? Object.fromEntries(s.split(",").map((kv) => kv.split("="))) : void 0;
 async function init(a, root) {
   const cfgPath = join6(root, CONFIG_FILE2);
   let config;
-  if (existsSync6(cfgPath) && !has4(a, "force")) {
+  if (existsSync6(cfgPath) && !has6(a, "force")) {
     print(`${CONFIG_FILE2} exists, keeping it (--force to regenerate).`);
-    config = (await (await BridgeContext5.create({ root })).config()).config;
+    config = (await (await BridgeContext7.create({ root })).config()).config;
   } else {
     const src = new LocalSource(root);
     const files = await src.list("");
@@ -6083,14 +6289,14 @@ async function init(a, root) {
   print(`  claude mcp add bridge -- ${desktop.command} ${desktop.args.join(" ")}`);
 }
 async function check(a, root) {
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const v = await ops.validateTokens(ctx, { includeWarnings: true });
   const c = await ops.checkContrast(ctx, {});
   const warnings = "warnings" in v ? v.warnings ?? [] : [];
-  const failed = !v.valid || "failing" in c && (c.failing ?? 0) > 0 || has4(a, "strict") && warnings.length > 0;
+  const failed = !v.valid || "failing" in c && (c.failing ?? 0) > 0 || has6(a, "strict") && warnings.length > 0;
   const protection = await protectionOf(a, root, ctx);
   const roles = await rolesOf(a, root, ctx);
-  if (has4(a, "json")) {
+  if (has6(a, "json")) {
     print(JSON.stringify({ ok: !failed, validation: v, contrast: c, ...protection ? { protection: protection.state } : {}, ...roles?.teams.length ? { teams: roles.teams } : {} }, null, 2));
     return failed ? 1 : 0;
   }
@@ -6109,7 +6315,7 @@ async function check(a, root) {
   return failed ? 1 : 0;
 }
 async function protectionOf(a, root, ctx) {
-  if (has4(a, "offline") || process.env.BRIDGE_OFFLINE === "1") return void 0;
+  if (has6(a, "offline") || process.env.BRIDGE_OFFLINE === "1") return void 0;
   const { config } = await ctx.config();
   const repo = config.repo ? `${config.repo.owner}/${config.repo.name}` : await originRepo(root);
   if (!repo) return void 0;
@@ -6117,7 +6323,7 @@ async function protectionOf(a, root, ctx) {
   return protectionReport({ repo, defaultBranch: config.repo?.defaultBranch ?? "main", token });
 }
 async function rolesOf(a, root, ctx) {
-  if (has4(a, "offline") || process.env.BRIDGE_OFFLINE === "1") return void 0;
+  if (has6(a, "offline") || process.env.BRIDGE_OFFLINE === "1") return void 0;
   const { config } = await ctx.config();
   const repo = config.repo ? `${config.repo.owner}/${config.repo.name}` : await originRepo(root);
   if (!repo) return void 0;
@@ -6127,9 +6333,9 @@ async function rolesOf(a, root, ctx) {
 async function tokens(a, root) {
   const q = a._.slice(1).join(" ");
   if (!q) throw new UsageError("bridge tokens <query>");
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const r = await ops.searchTokens(ctx, { query: q, limit: Number(flag4(a, "limit") ?? 20) });
-  if (has4(a, "json")) return print(JSON.stringify(r, null, 2));
+  if (has6(a, "json")) return print(JSON.stringify(r, null, 2));
   if (!r.results.length) return print(`No token matches "${q}".`);
   const w = Math.max(...r.results.map((x) => x.path.length));
   for (const t of r.results) print(`${t.path.padEnd(w)}  ${String(t.value).padEnd(10)}  ${(t.tier ?? "").padEnd(9)}  ${t.description ?? ""}`);
@@ -6137,7 +6343,7 @@ async function tokens(a, root) {
 async function diff(a, root) {
   const base = a._[1];
   if (!base) throw new UsageError("bridge diff <base>   (a git ref: main, HEAD~1, a sha)");
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const { config } = await ctx.config();
   const before = await core.loadTokenSet(new GitRefSource(root, base), config);
   const after = await ctx.tokens();
@@ -6146,11 +6352,11 @@ async function diff(a, root) {
   const delta2 = pairs2.length ? core.contrastDelta(core.runContrast(before, pairs2, config.contrast?.modes), core.runContrast(after, pairs2, config.contrast?.modes)) : [];
   const tier = core.classify(changes, [], config);
   const imp = core.impact(before, after, changes, 30);
-  if (has4(a, "json")) {
+  if (has6(a, "json")) {
     print(JSON.stringify({ base, changes, contrast: delta2, tier, impact: imp }, null, 2));
     return 0;
   }
-  if (has4(a, "md")) {
+  if (has6(a, "md")) {
     print(`## Token changes since \`${base}\`
 
 ${core.tokenTable(changes)}
@@ -6196,11 +6402,11 @@ async function propose(a, root) {
     edits.push({ op: "set", path: s.slice(0, i), value: s.slice(i + 1), ...file ? { file } : {}, ...mode2 ? { mode: mode2 } : {} });
   }
   const editsFile = flag4(a, "edits");
-  if (editsFile) edits.push(...JSON.parse(await readFile7(resolve4(editsFile), "utf8")));
+  if (editsFile) edits.push(...JSON.parse(await readFile7(resolve5(editsFile), "utf8")));
   if (!edits.length) throw new UsageError("Give at least one --set path=value or --edits file.json");
   const pr = flag4(a, "pr");
   const token = pr ? process.env.BRIDGE_GITHUB_TOKEN || process.env.GITHUB_TOKEN || defaultIO().ghToken() : void 0;
-  const ctx = await BridgeContext5.create({ root, ...token ? { token } : {} });
+  const ctx = await BridgeContext7.create({ root, ...token ? { token } : {} });
   const summary = flag4(a, "summary");
   const branch = flag4(a, "branch");
   const jira = flag4(a, "jira");
@@ -6213,9 +6419,9 @@ async function propose(a, root) {
     ...pr ? { pr } : {},
     ...jira ? { jira } : {},
     ...product ? { product } : {},
-    dryRun: has4(a, "dry-run")
+    dryRun: has6(a, "dry-run")
   });
-  if (has4(a, "json")) print(JSON.stringify(r, null, 2));
+  if (has6(a, "json")) print(JSON.stringify(r, null, 2));
   else {
     print(`status: ${r.status}${r.why ? ` (${r.why})` : ""}`);
     if (r.tier) print(`tier ${r.tier}, ${r.bump}`);
@@ -6230,10 +6436,10 @@ ${r.prBody}`);
 }
 async function brandCmd(a, root) {
   const sub = a._[1];
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   if (sub === "list") {
     const r2 = await brand.listBrands(ctx);
-    if (has4(a, "json")) print(JSON.stringify(r2.brands, null, 2));
+    if (has6(a, "json")) print(JSON.stringify(r2.brands, null, 2));
     else for (const b of r2.brands) print(`${b.default ? "*" : " "} ${b.slug.padEnd(14)} ${b.name.padEnd(18)} ${b.primary ?? ""}${b.overrides.length ? `  overrides: ${b.overrides.join(", ")}` : ""}`);
     return 0;
   }
@@ -6253,9 +6459,9 @@ async function brandCmd(a, root) {
     ...opt("radius") ? { radius: opt("radius") } : {},
     ...Object.keys(fonts).length ? { fonts } : {},
     ...opt("notes") ? { notes: opt("notes") } : {},
-    dryRun: has4(a, "dry-run")
+    dryRun: has6(a, "dry-run")
   });
-  if (has4(a, "json")) {
+  if (has6(a, "json")) {
     const { fileContents: _f, ...rest } = r;
     print(JSON.stringify(rest, null, 2));
     return r.status === "blocked" ? 1 : 0;
@@ -6286,14 +6492,14 @@ async function figmaReferences(a, root) {
   }
   const only = (flag4(a, "only") ?? "").split(",").filter(Boolean);
   const r = await captureFigmaReferences({
-    storybook: resolve4(root, flag4(a, "storybook") ?? "storybook-static"),
-    specs: resolve4(root, flag4(a, "specs") ?? "packages/react/component-specs.json"),
-    out: resolve4(root, flag4(a, "out") ?? "figma-references"),
+    storybook: resolve5(root, flag4(a, "storybook") ?? "storybook-static"),
+    specs: resolve5(root, flag4(a, "specs") ?? "packages/react/component-specs.json"),
+    out: resolve5(root, flag4(a, "out") ?? "figma-references"),
     sha,
     ...only.length ? { only } : {},
-    log: has4(a, "json") ? void 0 : (line) => print(line)
+    log: has6(a, "json") ? void 0 : (line) => print(line)
   });
-  if (has4(a, "json")) print(JSON.stringify({ manifest: r.manifestPath, captured: r.captured, skipped: r.skipped }, null, 2));
+  if (has6(a, "json")) print(JSON.stringify({ manifest: r.manifestPath, captured: r.captured, skipped: r.skipped }, null, 2));
   return 0;
 }
 async function impact(a, root) {
@@ -6311,22 +6517,22 @@ async function impact(a, root) {
     root,
     base: flag4(a, "base") ?? "main",
     head: flag4(a, "head") ?? "HEAD",
-    ...out ? { out: resolve4(out) } : {},
+    ...out ? { out: resolve5(out) } : {},
     ...only.length ? { only } : {},
     ...threshold !== void 0 ? { threshold } : {},
-    ...cacheDir ? { cacheDir: resolve4(cacheDir) } : {},
+    ...cacheDir ? { cacheDir: resolve5(cacheDir) } : {},
     ...maxStories ? { maxStoriesPerComponent: maxStories } : {},
     ...imageBase !== void 0 ? { imageBase } : {},
     ...artifactUrl ? { artifactUrl } : {},
-    plan: has4(a, "plan"),
-    keepUnchanged: has4(a, "keep-unchanged")
+    plan: has6(a, "plan"),
+    keepUnchanged: has6(a, "keep-unchanged")
   });
-  if (has4(a, "json")) {
+  if (has6(a, "json")) {
     print(JSON.stringify({ summary: r.summary, manifest: r.manifestPath, comment: r.commentPath ?? null, ...r.manifest.summary, selection: r.manifest.selection }, null, 2));
     return 0;
   }
   const sel = r.manifest.selection;
-  if (has4(a, "plan")) {
+  if (has6(a, "plan")) {
     print(`Plan ${r.manifest.base.ref} (${r.manifest.base.sha.slice(0, 7)}) -> ${r.manifest.head.ref} (${r.manifest.head.sha.slice(0, 7)})`);
     print(`  tokens changing value: ${sel.tokens.length}${sel.tokens.length ? ` (${sel.tokens.filter((t) => t.kind === "direct").map((t) => t.path).slice(0, 6).join(", ")})` : ""}`);
     print(`  components: ${sel.components.map((c) => c.id).join(", ") || "none"}`);
@@ -6342,12 +6548,12 @@ async function impact(a, root) {
 }
 var day = (iso) => iso.slice(0, 10);
 async function historyCmd(a, root) {
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const token = a._[1];
   const limit = Number(flag4(a, "limit") ?? 20);
   if (token) {
     const r2 = await hist.getTokenHistory(ctx, { path: token, limit });
-    if (has4(a, "json")) return print(JSON.stringify(r2, null, 2)), 0;
+    if (has6(a, "json")) return print(JSON.stringify(r2, null, 2)), 0;
     if (!r2.total) return print(`No recorded change of ${r2.path} in ${r2.source}.`), 0;
     print(`${r2.path}: ${r2.total} change(s)  (${r2.source})
 `);
@@ -6359,8 +6565,8 @@ async function historyCmd(a, root) {
     return 0;
   }
   const tier = flag4(a, "tier");
-  const r = await hist.getHistory(ctx, { limit, ...flag4(a, "author") ? { author: flag4(a, "author") } : {}, ...tier ? { tier: Number(tier) } : {}, ...flag4(a, "version") ? { version: flag4(a, "version") } : {}, ...has4(a, "breaking") ? { breaking: true } : {} });
-  if (has4(a, "json")) return print(JSON.stringify(r, null, 2)), 0;
+  const r = await hist.getHistory(ctx, { limit, ...flag4(a, "author") ? { author: flag4(a, "author") } : {}, ...tier ? { tier: Number(tier) } : {}, ...flag4(a, "version") ? { version: flag4(a, "version") } : {}, ...has6(a, "breaking") ? { breaking: true } : {} });
+  if (has6(a, "json")) return print(JSON.stringify(r, null, 2)), 0;
   print(`${r.source}${r.currentVersion ? `, package version ${r.currentVersion}` : ""}`);
   if (!r.total) return print(r.note ?? "No token change matches."), 0;
   for (const v of r.versions) print(`  ${v.version.padEnd(11)} ${day(v.date)}  ${v.entries} change(s), ${v.tokenChanges} token edit(s)${v.breaking ? ", breaking" : ""}`);
@@ -6378,10 +6584,10 @@ ${r.truncated}`);
 async function revertCmd(a, root) {
   const target = a._[1];
   if (!target) throw new UsageError("bridge revert <pr|commit|id> [--dry-run]   (ids from `bridge history`)");
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const resolutions = Object.fromEntries((a.flags["use-before"] ?? []).map((k) => [k, "use-before"]));
-  const r = await hist.proposeRevert(ctx, { target, resolutions, restoreConflicts: has4(a, "restore-conflicts"), dryRun: has4(a, "dry-run") });
-  if (has4(a, "json")) {
+  const r = await hist.proposeRevert(ctx, { target, resolutions, restoreConflicts: has6(a, "restore-conflicts"), dryRun: has6(a, "dry-run") });
+  if (has6(a, "json")) {
     print(JSON.stringify(r, null, 2));
     return r.status === "blocked" ? 1 : 0;
   }
@@ -6406,11 +6612,11 @@ async function audit(a, root) {
   const target = a._[1];
   if (!target) throw new UsageError("bridge audit <path>   (a product folder or file that uses the design system)");
   if (!existsSync6(target)) throw new UsageError(`No such file or folder: ${target}`);
-  const dsRoot = flag4(a, "ds") ? resolve4(flag4(a, "ds")) : existsSync6(join6(root, CONFIG_FILE2)) ? root : findDesignSystemRoot(root);
+  const dsRoot = flag4(a, "ds") ? resolve5(flag4(a, "ds")) : existsSync6(join6(root, CONFIG_FILE2)) ? root : findDesignSystemRoot(root);
   if (!dsRoot) throw new UsageError(`No ${CONFIG_FILE2} found: run bridge audit from the design system repo or pass --ds <dir>.`);
   const ds = loadDesignSystem(dsRoot);
-  if (has4(a, "fix")) {
-    const write = has4(a, "write");
+  if (has6(a, "fix")) {
+    const write = has6(a, "write");
     const changes = fixCss(target, ds.index, write);
     const n = changes.reduce((acc, c) => acc + c.edits.length, 0);
     for (const c of changes) for (const e of c.edits) print(`${c.file}:${e.line}:${e.column}  ${e.from} -> ${e.to}`);
@@ -6486,7 +6692,7 @@ async function audit(a, root) {
       code = 1;
     }
   }
-  if (has4(a, "no-regress") && report.baseline) {
+  if (has6(a, "no-regress") && report.baseline) {
     const b = report.baseline;
     if ((b.tokenAdoption.delta ?? 0) < 0 || (b.componentAdoption.delta ?? 0) < 0 || b.hardcoded.delta > 0) {
       process.stderr.write("bridge audit: adoption regressed since the baseline\n");
@@ -6498,9 +6704,9 @@ async function audit(a, root) {
 async function docsCmd(a, root) {
   const [, sub, name] = a._;
   if (sub !== "draft" || !name) throw new UsageError("Usage: bridge docs draft <Component> [--json]");
-  const ctx = await BridgeContext5.create({ root });
+  const ctx = await BridgeContext7.create({ root });
   const d = await ops.draftDocsOp(ctx, { name });
-  if (has4(a, "json")) {
+  if (has6(a, "json")) {
     print(JSON.stringify({ component: d.component, path: d.path, exists: d.exists, prefill: d.prefill, prompt: d.prompt }, null, 2));
     return 0;
   }
@@ -6531,15 +6737,17 @@ async function main() {
   const argv = process.argv.slice(2);
   const a = parse(argv);
   const cmd = a._[0];
-  const root = resolve4(flag4(a, "root") ?? process.cwd());
+  const root = resolve5(flag4(a, "root") ?? process.cwd());
   if (cmd === "request") return runRequest(a, root);
   if (cmd === "explore") return runExplore(a, root);
   if (cmd === "branch") return runBranch(a, root);
+  if (cmd === "pieces") return runPieces(a, root);
+  if (cmd === "figma") return runFigma(a, root);
   if (cmd === "products" || cmd === "settings" || cmd === "coverage") return runStudioRead(cmd, a, root);
   if (cmd === "docs" && a._[1] === "save") return runDocsSave(a, root);
-  if (!cmd || has4(a, "help") || cmd === "help") {
+  if (!cmd || has6(a, "help") || cmd === "help") {
     print(HELP);
-    return cmd || has4(a, "help") ? 0 : 2;
+    return cmd || has6(a, "help") ? 0 : 2;
   }
   if (cmd === "--version" || cmd === "version") return print(VERSION), 0;
   switch (cmd) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/cli",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "bridge CLI: set up Bridge in a design system repo, check tokens in CI, search and diff tokens, propose changes, start the MCP server.",
   "license": "MIT",
@@ -43,8 +43,8 @@
     "build:package": "node ../../scripts/build-packages.mjs cli"
   },
   "dependencies": {
-    "@bridge-ds/mcp": "^0.4.0",
-    "@bridge-ds/visual": "^0.3.1",
+    "@bridge-ds/mcp": "^0.6.0",
+    "@bridge-ds/visual": "^0.3.4",
     "typescript": "5.9.3"
   },
   "devDependencies": {