@bridge-ds/mcp 0.4.1 → 0.6.0

package/dist/branches.d.ts

@@ -9,8 +9,16 @@ export declare const RIGHTS: {
     readonly draft: "Pull requests: read and write (you must be the author, as in Studio)";
     readonly docs: "Contents and Pull requests: read and write";
 };
+export declare function reader(ctx: BridgeContext): Promise<GitHubClient>;
+/**
+ * A client for writes on a branch someone already opened (any name, never a protected branch): the token is required,
+ * with the rights `need` names, so the error says exactly what to add.
+ */
+export declare function writer(ctx: BridgeContext, what: string, need: string): Promise<GitHubClient>;
 /** 12, "#12" or a pull request link: the branch number. Throws how to fix it otherwise. */
 export declare function branchNumber(input: number | string): number;
+/** The viewer of the token, or null without one (or when GitHub does not say). */
+export declare function viewerOf(ctx: BridgeContext, gh: GitHubClient): Promise<string | null>;
 /** Everything Studio reads about one branch to paint its header and decide its actions. */
 export declare function branchFacts(ctx: BridgeContext, gh: GitHubClient, n: number, viewer: string | null): Promise<{
     config: BridgeConfig;
@@ -180,7 +188,7 @@ export declare function tryBranch(ctx: BridgeContext, a: {
     }[];
     share: {
         message?: import("@bridge-ds/core").ShareMessage | undefined;
-        state: "ready" | "building" | "failed" | "closed" | "no-packages" | "shipped";
+        state: "ready" | "building" | "failed" | "closed" | "shipped" | "no-packages";
         install: string | null;
         sentence: string;
     };

package/dist/{chunk-QTO4EP6V.js → chunk-E4D5KPIQ.js}

@@ -558,6 +558,8 @@ function sameProducts(a, b) {
 
 // ../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",
@@ -697,6 +699,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 } } : {},
@@ -819,6 +823,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 audit = d.audit;
   if (audit !== void 0) {
@@ -851,6 +862,7 @@ function loadConfig(source) {
 var tokensPath = (config, rel = "") => [config.tokens.root === "." ? "" : config.tokens.root, rel].filter(Boolean).join("/");
 var protectedBranchesOf = (config) => [.../* @__PURE__ */ new Set([...config.governance.protectedBranches, ...config.repo ? [config.repo.defaultBranch] : []])];
 var baseBranchOf = (config) => config.repo?.defaultBranch ?? "main";
+var changesMode = (config) => config?.changes === "direct" ? "direct" : DEFAULT_CHANGES_MODE;
 function toConfigJson(config, schema = "./packages/core/bridge.config.schema.json") {
   return {
     $schema: schema,
@@ -867,6 +879,8 @@ function toConfigJson(config, schema = "./packages/core/bridge.config.schema.jso
     ...config.audit ? { audit: config.audit } : {},
     ...config.previews ? { previews: config.previews } : {},
     ...config.visualImpact ? { visualImpact: config.visualImpact } : {},
+    changes: changesMode(config),
+    ...config.storybook ? { storybook: config.storybook } : {},
     ...config.products && !sameProducts(config.products, DEFAULT_PRODUCTS) ? { products: config.products } : {}
   };
 }
@@ -1943,11 +1957,17 @@ async function commitToNewLocalBranch(root, args) {
     throw new Error(`Refusing to write branch "${args.branch}": ${err.message}`);
   }
   if (await branchExists(root, args.branch)) throw new Error(`Branch "${args.branch}" already exists. Pick another title or delete it first.`);
-  const baseSha = (await git(root, ["rev-parse", "--verify", `${args.base}^{commit}`])).trim();
+  const { sha, parent } = await commitTree(root, args);
+  await git(root, ["update-ref", `refs/heads/${args.branch}`, sha, ""]);
+  const diff = await git(root, ["diff", parent, sha]);
+  return { sha, diff };
+}
+async function commitTree(root, args) {
+  const parent = (await git(root, ["rev-parse", "--verify", `${args.base}^{commit}`])).trim();
   const dir = await mkdtemp(join(tmpdir(), "bridge-index-"));
   const env = { GIT_INDEX_FILE: join(dir, "index") };
   try {
-    await git(root, ["read-tree", baseSha], { env });
+    await git(root, ["read-tree", parent], { env });
     for (const f of args.files) {
       if (f.content === null) {
         await git(root, ["update-index", "--force-remove", f.path], { env });
@@ -1958,10 +1978,8 @@ async function commitToNewLocalBranch(root, args) {
     }
     const tree = (await git(root, ["write-tree"], { env })).trim();
     const ident = await identityEnv(root);
-    const sha = (await git(root, ["commit-tree", tree, "-p", baseSha, "-F", "-"], { input: args.message, env: ident })).trim();
-    await git(root, ["update-ref", `refs/heads/${args.branch}`, sha, ""]);
-    const diff = await git(root, ["diff", baseSha, sha]);
-    return { sha, diff };
+    const sha = (await git(root, ["commit-tree", tree, "-p", parent, "-F", "-"], { input: args.message, env: ident })).trim();
+    return { sha, parent };
   } finally {
     await rm(dir, { recursive: true, force: true });
   }
@@ -2035,6 +2053,7 @@ export {
   assertSafeBranch,
   DEFAULT_COMPONENT_SPECS_FILE,
   coverageSummary,
+  variantKeyOf,
   parseComponentSpecs,
   figmaCell,
   FIGMA_REFERENCES_BRANCH,