@bridge-ds/mcp 0.4.1 → 0.5.0

package/dist/explorations.d.ts

@@ -1,5 +1,10 @@
-import { explorationRules, type ExplorationSource, type ExplorationTryIt } from '@bridge-ds/core';
+import { explorationRules, type BridgeConfig, type ExplorationSource, type ExplorationTryIt } from '@bridge-ds/core';
 import { BridgeContext } from './context.js';
+export declare const settingsOf: (config: BridgeConfig) => {
+    base: string;
+    packages: string[];
+    apps: import("@bridge-ds/core").PreviewApps;
+};
 /** `explore/<slug>` from a branch, a slug or a name; throws with how to fix it when it cannot be one. */
 export declare function toExplorationBranch(ref: string): string;
 export interface StartExplorationInput {

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-MXMMPO7F.js";
+} from "./chunk-MHCXMHCL.js";
 import "./chunk-QTO4EP6V.js";
 
 // src/index.ts

package/dist/lib.d.ts

@@ -13,6 +13,7 @@ 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 * as pieces from './pieces.js';
 export { DOCS_DRAFT_MODEL, anthropicReplyText, anthropicRequest, formatDocsJson, mergeDocsDraft, missingProse, parseDocsReply } from '@bridge-ds/core';
 export interface ServeOptions extends ContextOptions {
 }

package/dist/lib.js

@@ -22,10 +22,11 @@ import {
   ops_exports,
   optionsFromArgv,
   parseDocsReply,
+  pieces_exports,
   requests_exports,
   serveStdio,
   studio_exports
-} from "./chunk-MXMMPO7F.js";
+} from "./chunk-MHCXMHCL.js";
 import {
   CONFIG_FILE,
   loadConfig,
@@ -57,6 +58,7 @@ export {
   optionsFromArgv,
   loadConfig as parseConfig,
   parseDocsReply,
+  pieces_exports as pieces,
   requests_exports as requests,
   serveStdio,
   studio_exports as studio,

package/dist/ops.d.ts

@@ -1,3 +1,4 @@
+import { DesignSystemIndex } from '@bridge-ds/core/audit';
 import { type ScaffoldInput } from './components.js';
 import { type BridgeConfig, type GitHubClient } from '@bridge-ds/core';
 import { type Combo, type PairInput, type TokenEdit, type TokenSet } from './core-adapter.js';
@@ -713,6 +714,8 @@ export declare function visualImpact(ctx: BridgeContext, a: {
     manifest: string;
     next: string;
 }>;
+/** The design system the audit measures against: tokens of this repo, its components and package names. */
+export declare function designSystemIndex(ctx: BridgeContext): Promise<DesignSystemIndex>;
 /** Audit a product folder or file (local only): adoption metrics, top files, top fixes, and findings for one file. */
 export declare function auditOp(ctx: BridgeContext, a: {
     path: string;

package/dist/pieces.d.ts

@@ -0,0 +1,122 @@
+import type { BridgeContext } from './context.js';
+/** Who opens library branches from here: the MCP server speaks for an AI agent, the CLI for the person. */
+export type PiecesSource = 'mcp' | 'cli';
+/**
+ * bridge_missing_pieces / `bridge pieces <n>`: the audit on each product file the branch changes, at its start and at its
+ * head, keeping what the branch added that the library lacks. With `record`, saves the result in the branch body
+ * (Studio's product branch page reads it there), keeping the library branches already opened.
+ */
+export declare function missingPiecesOp(ctx: BridgeContext, a: {
+    pr: number | string;
+    record?: boolean | undefined;
+}): Promise<{
+    pieces: {
+        linked?: number | undefined;
+        where: string[];
+        opens: string;
+        token?: string | undefined;
+        nearest?: string | undefined;
+        component?: string | undefined;
+        id: string;
+        kind: import("@bridge-ds/core").PieceKind;
+        title: string;
+        summary: string;
+    }[];
+    fixes: {
+        count: number;
+        sample: string[];
+    };
+    recorded: boolean;
+    next: string;
+    skipped?: string | undefined;
+    pr: number;
+    branch: string;
+    product: string;
+    files: number;
+}>;
+/**
+ * bridge_open_library_branch / `bridge pieces open <n> <piece>`: the library side of one recorded piece, linked both
+ * ways. A token opens a token change (and the product branch takes its preview), a variant a library exploration with
+ * the brief to build it, a new component a request.
+ */
+export declare function openLibraryBranchOp(ctx: BridgeContext, a: {
+    pr: number | string;
+    piece: string;
+    usePreview?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    source?: PiecesSource | undefined;
+}): Promise<{
+    next: string;
+    warnings?: string[] | undefined;
+    preview?: import("@bridge-ds/core").PreviewMerge | undefined;
+    library?: {
+        branch?: string | undefined;
+        kind: import("@bridge-ds/core").LibraryLinkKind;
+        number: number;
+        url: string;
+    } | undefined;
+    neededBy: string;
+    request?: string | undefined;
+    exploration?: string | undefined;
+    brief?: string | undefined;
+    edits?: import("@bridge-ds/core").TokenEdit[] | undefined;
+    status: "opened" | "already-linked" | "dry-run";
+    pr: number;
+    piece: string;
+    opens: string;
+    title: string;
+}>;
+/** bridge_product_branch / `bridge pieces status <n>`: the product branch page, as Studio shows it. */
+export declare function productBranchOp(ctx: BridgeContext, a: {
+    pr: number | string;
+}): Promise<{
+    next?: string | undefined;
+    pr: number;
+    title: string;
+    product: string;
+    said: string;
+    checked: string | null;
+    linked: {
+        action?: string | undefined;
+        tool?: string | undefined;
+        piece: string;
+        library: {
+            kind: import("@bridge-ds/core").LibraryLinkKind;
+            number: number;
+            url: string;
+        };
+        status: string;
+        preview: string;
+    }[];
+    notLinked: {
+        where: string[];
+        opens: string;
+        token?: string | undefined;
+        nearest?: string | undefined;
+        component?: string | undefined;
+        id: string;
+        kind: import("@bridge-ds/core").PieceKind;
+        title: string;
+        summary: string;
+    }[];
+}>;
+/** bridge_use_library_preview: the product branch takes (again) the library branch of a piece, merged in. */
+export declare function useLibraryPreviewOp(ctx: BridgeContext, a: {
+    pr: number | string;
+    piece: string;
+}): Promise<{
+    status: "merged" | "up-to-date" | "conflict";
+    sha: string | null;
+    said: string;
+    pr: number;
+    piece: string;
+    library: number;
+}>;
+/** bridge_switch_to_published: main into the product branch once its library branches shipped. */
+export declare function switchToPublishedOp(ctx: BridgeContext, a: {
+    pr: number | string;
+}): Promise<{
+    status: "switched" | "up-to-date";
+    said: string;
+    pr: number;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.4.1",
+  "version": "0.5.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.8.0",
-    "@bridge-ds/visual": "^0.3.2",
+    "@bridge-ds/core": "^0.9.0",
+    "@bridge-ds/visual": "^0.3.3",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"