@bridge-ds/mcp 0.9.0 → 0.10.0

package/dist/figma-fixes.d.ts

@@ -1,4 +1,4 @@
-import { type FigmaFixesFile } from '@bridge-ds/core';
+import { type FigmaFidelityRun, type FigmaFixesFile, type MeasuredSpecsFile } from '@bridge-ds/core';
 import type { BridgeContext } from './context.js';
 /** Where `bridge specs --measure` writes, from the repo root. */
 export declare const MEASURED_SPECS_FILE = "measured-specs.json";
@@ -12,20 +12,48 @@ export interface FixFilesArgs {
     /** figma-fixes.json path in the repo. */
     fixesFile?: string | undefined;
 }
+export interface FixFiles {
+    measured: MeasuredSpecsFile;
+    measuredPath: string;
+    /** Where the measure came from, in words: "measured-specs.json", or "measured-specs.json on bridge-requests". */
+    measuredFrom: string;
+    fixes?: FigmaFixesFile | undefined;
+    fixesPath: string;
+    run?: FigmaFidelityRun | undefined;
+    /** Where the run came from, in words. */
+    runFrom?: string | undefined;
+}
+/**
+ * Reads the measure (the repo, else the measure branch the automatic measure publishes to), the team's fixes and the
+ * fidelity run (the repo, else the requests branch the plugin writes to). No measure: MeasureMissingError, whose
+ * message is the designer sentence and the steps to turn the automatic measure on.
+ */
+export declare function loadFixFiles(ctx: BridgeContext, a: FixFilesArgs): Promise<FixFiles>;
 /** bridge_figma_gaps / `bridge gaps`: the components whose Figma build differs from their story, or cannot be checked. */
 export declare function figmaGapsOp(ctx: BridgeContext, a?: FixFilesArgs): Promise<{
+    status: string;
+    say: string;
+    steps: string[];
+    gaps: never[];
+} | {
     measured: string;
     gaps: import("@bridge-ds/core").FigmaGapRow[];
     next: string;
     report: string;
     checkedAt: string | undefined;
     referee: string;
+    status?: undefined;
+    say?: undefined;
+    steps?: undefined;
 } | {
     measured: string;
     gaps: import("@bridge-ds/core").FigmaGapRow[];
     next: string;
     note: string;
     referee: string;
+    status?: undefined;
+    say?: undefined;
+    steps?: undefined;
 }>;
 /** bridge_get_gap_case / `bridge fix <component> --case`: one component's gap case and the fix schema. */
 export declare function getGapCaseOp(ctx: BridgeContext, a: FixFilesArgs & {
@@ -107,7 +135,7 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
     source?: 'mcp' | 'cli' | undefined;
 }): Promise<{
     status: string;
-    verdict: "same" | "worse";
+    verdict: import("@bridge-ds/core").FixVerdict;
     why: string;
     detail: string;
     hint: string;
@@ -119,11 +147,11 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
         content: string;
     }[];
     component: string;
-    verdict: "closer" | "same";
+    verdict: import("@bridge-ds/core").FixVerdict;
     summary: string;
     variants: import("@bridge-ds/core").TriedVariant[];
     fixes: string[];
-    tier: import("@bridge-ds/core").RiskTier;
+    tier: number;
     prTitle: string;
     status: string;
     why?: undefined;
@@ -136,11 +164,11 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
         content: string;
     }[];
     component: string;
-    verdict: "closer" | "same";
+    verdict: import("@bridge-ds/core").FixVerdict;
     summary: string;
     variants: import("@bridge-ds/core").TriedVariant[];
     fixes: string[];
-    tier: import("@bridge-ds/core").RiskTier;
+    tier: number;
     prTitle: string;
     status: string;
     message: string;
@@ -155,11 +183,11 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
     labels: string[];
     next: string;
     component: string;
-    verdict: "closer" | "same";
+    verdict: import("@bridge-ds/core").FixVerdict;
     summary: string;
     variants: import("@bridge-ds/core").TriedVariant[];
     fixes: string[];
-    tier: import("@bridge-ds/core").RiskTier;
+    tier: number;
     prTitle: string;
     status: string;
     why?: undefined;
@@ -173,11 +201,11 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
         content: string;
     }[];
     component: string;
-    verdict: "closer" | "same";
+    verdict: import("@bridge-ds/core").FixVerdict;
     summary: string;
     variants: import("@bridge-ds/core").TriedVariant[];
     fixes: string[];
-    tier: import("@bridge-ds/core").RiskTier;
+    tier: number;
     prTitle: string;
     status: string;
     message: string;
@@ -193,11 +221,11 @@ export declare function proposeFigmaFixesOp(ctx: BridgeContext, a: FixFilesArgs
     draft: boolean;
     next: string;
     component: string;
-    verdict: "closer" | "same";
+    verdict: import("@bridge-ds/core").FixVerdict;
     summary: string;
     variants: import("@bridge-ds/core").TriedVariant[];
     fixes: string[];
-    tier: import("@bridge-ds/core").RiskTier;
+    tier: number;
     prTitle: string;
     status: string;
     why?: undefined;

package/dist/index.js

@@ -3,8 +3,8 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-TP33MW7E.js";
-import "./chunk-ZVORAO5H.js";
+} from "./chunk-E5V42VCS.js";
+import "./chunk-BZEPCY42.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.d.ts

@@ -1,7 +1,8 @@
-import { type ContextOptions } from './context.js';
+import { BridgeContext, type ContextOptions } from './context.js';
+import { type ServerOptions } from './server.js';
 export { BridgeContext, type ContextOptions } from './context.js';
 export { BlockedError, isBlocked, say } from './say.js';
-export { createServer, VERSION } from './server.js';
+export { createServer, SERVER_INFO, VERSION, type ServerOptions } from './server.js';
 export { CONFIG_FILE, detectConfig, parseConfig, toConfigJson, type BridgeConfig } from './config.js';
 export { core } from './core-adapter.js';
 export { LocalSource, GitRefSource, GitHubSource, type RepoSource } from './source.js';
@@ -29,6 +30,22 @@ export interface ServeOptions extends ContextOptions {
 export declare function ghAuthToken(): string | undefined;
 /** Said once at start, on stderr: where the token came from, or what the server does without one. Never the token. */
 export declare function tokenNote(source: TokenSource | undefined): string | undefined;
+/**
+ * One Streamable HTTP request to a Bridge MCP server (the hosted connector, apps/docs-site/api/mcp): stateless, a
+ * server per request on `ctx` (a remote repo with the signed-in person's GitHub token), JSON answers, no session id.
+ * `parsedBody` is the JSON-RPC body when the caller already read it; `opts.exclude` leaves tools out (createServer).
+ *
+ * The first POST of a Claude session answers 400, on purpose. Bridge speaks the initialize-based ("legacy") MCP
+ * revisions up to 2025-11-25, the newest the SDK supports. Claude is a dual-era client: it first tries a request of the
+ * stateless 2026-07-28 revision (no initialize, `MCP-Protocol-Version: 2026-07-28`), the SDK rejects that version with
+ * 400 and a plain -32000 error, and Claude falls back to initialize (200), notifications/initialized (202), tools/list
+ * (200). That 400 is the era detection the spec defines (2026-07-28 Streamable HTTP, Backward Compatibility; Versioning,
+ * compatibility matrix "Dual-era client, Legacy server"): a 4xx without a recognized modern error means "fall back".
+ * Never answer it with a modern error (UnsupportedProtocolVersionError -32022, HeaderMismatch -32020): Claude would
+ * then treat Bridge as a 2026-07-28 server and retry instead of falling back. The 400 goes away only when Bridge
+ * implements 2026-07-28 itself (server/discover, per-request _meta), which needs an SDK that supports it.
+ */
+export declare function handleHttp(ctx: BridgeContext, req: Request, parsedBody?: unknown, opts?: ServerOptions): Promise<Response>;
 /** Starts the stdio MCP server. Logs go to stderr: stdout belongs to the protocol. */
 export declare function serveStdio(opts?: ServeOptions): Promise<void>;
 /**

package/dist/lib.js

@@ -5,6 +5,7 @@ import {
   GitHubSource,
   GitRefSource,
   LocalSource,
+  SERVER_INFO,
   VERSION,
   anthropicReplyText,
   anthropicRequest,
@@ -21,6 +22,7 @@ import {
   figma_fixes_exports,
   formatDocsJson,
   ghAuthToken,
+  handleHttp,
   history_exports,
   isBlocked,
   mergeDocsDraft,
@@ -35,12 +37,12 @@ import {
   studio_exports,
   suggestions_exports,
   tokenNote
-} from "./chunk-TP33MW7E.js";
+} from "./chunk-E5V42VCS.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-ZVORAO5H.js";
+} from "./chunk-BZEPCY42.js";
 export {
   BlockedError,
   BridgeContext,
@@ -49,6 +51,7 @@ export {
   GitHubSource,
   GitRefSource,
   LocalSource,
+  SERVER_INFO,
   VERSION,
   anthropicReplyText,
   anthropicRequest,
@@ -65,6 +68,7 @@ export {
   figma_fixes_exports as figmaFixes,
   formatDocsJson,
   ghAuthToken,
+  handleHttp,
   history_exports as history,
   isBlocked,
   mergeDocsDraft,

package/dist/ops.d.ts

@@ -778,6 +778,7 @@ export declare function getReview(ctx: BridgeContext, a: {
 export declare function reviewRoles(gh: GitHubClient, config: BridgeConfig, approvers: string[]): Promise<{
     unreadableTeams?: string[] | undefined;
     ship: string;
+    tier1Publish: string;
     soloOwner?: string | undefined;
     design: {
         owners: string[];

package/dist/server.d.ts

@@ -2,4 +2,31 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { BridgeContext } from './context.js';
 /** The package version, injected at build time; tests and source runs fall back to "dev". */
 export declare const VERSION: string;
-export declare function createServer(ctx: BridgeContext): McpServer;
+/** The Bridge site: it serves the hosted connector (/mcp) and the official icons. */
+export declare const BRIDGE_SITE = "https://bridge.floriangouloubi.com";
+/**
+ * How clients show this server (MCP 2025-11-25, Implementation: `title` is the display name, `icons` the images; the
+ * SDK here supports that version). `name` stays machine-safe. Icons are absolute https URLs on the same domain as the
+ * hosted connector, PNG first since every client that renders icons must support it.
+ */
+export declare const SERVER_INFO: {
+    name: string;
+    title: string;
+    version: string;
+    websiteUrl: string;
+    icons: {
+        src: string;
+        mimeType: string;
+        sizes: string[];
+    }[];
+};
+/** How a server is built for where it runs. */
+export interface ServerOptions {
+    /**
+     * Tools this server neither lists nor runs. The hosted connector (Bridge inside the team's Claude) leaves out the
+     * merge (bridge_merge_branch and its owner override): agents never merge there, a person does. The local CLI and
+     * MCP server keep every tool.
+     */
+    exclude?: readonly string[] | undefined;
+}
+export declare function createServer(ctx: BridgeContext, opts?: ServerOptions): McpServer;

package/dist/{src-RUS6SPYZ.js → src-ATD4DJF3.js}

@@ -11,7 +11,7 @@ import {
   referenceImagePath,
   selectTokenFiles,
   showFile
-} from "./chunk-ZVORAO5H.js";
+} from "./chunk-BZEPCY42.js";
 
 // ../visual/src/run.ts
 import { existsSync as existsSync3 } from "node:fs";

package/dist/studio.d.ts

@@ -94,6 +94,7 @@ export declare function getSettings(ctx: BridgeContext): Promise<{
     main: string;
     roles: {
         teamsNotRead?: string[] | undefined;
+        tier1Publish: string;
         soloOwner?: string | undefined;
         designApproval: string[];
         techApproval: string[];

package/dist/suggestions.d.ts

@@ -146,6 +146,7 @@ export declare function getSuggestionOp(ctx: BridgeContext, a: {
         }[];
     } | undefined;
     approvals: {
+        ownerOverride?: string | undefined;
         soloOwner?: string | undefined;
         notCounted?: string[] | undefined;
         staleReviews?: string[] | undefined;
@@ -226,7 +227,13 @@ export declare function getSuggestionOp(ctx: BridgeContext, a: {
         merged: boolean;
     }[];
 }>;
-export type SuggestionReviewEventArg = 'approve' | 'request-changes' | 'comment' | 'decline';
+export type SuggestionReviewEventArg = 'approve' | 'request-changes' | 'comment' | 'decline' | 'override';
+/** The owner override on a suggestion, as Studio and History say it. */
+export declare const suggestionOverrideLine: (o: {
+    login: string;
+    reason: string;
+    missing: readonly string[];
+}) => string;
 /**
  * bridge_review_suggestion / `bridge review <n>`: approve, request changes, comment on or decline a suggestion, as the
  * token's user. Approvals count only from the owners in bridge.config.json and only on the version reviewed
@@ -244,6 +251,16 @@ export declare function reviewSuggestionOp(ctx: BridgeContext, a: {
     number: number;
     status: SuggestionStatus;
     said: string;
+} | {
+    next: string;
+    warnings?: string[] | undefined;
+    number: number;
+    event: "override";
+    counts: boolean;
+    version: string;
+    status: SuggestionStatus;
+    said: string;
+    comment: string;
 } | {
     next: string;
     warnings?: string[] | undefined;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.9.0",
+  "version": "0.10.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",
+  "license": "FSL-1.1-MIT",
   "author": "Florian Gouloubi",
   "homepage": "https://github.com/peterbono/ai-design-system-demo/tree/main/packages/mcp#readme",
   "repository": {
@@ -55,8 +55,8 @@
     "build:package": "node ../../scripts/build-packages.mjs mcp"
   },
   "dependencies": {
-    "@bridge-ds/core": "^0.19.0",
-    "@bridge-ds/visual": "^0.3.13",
+    "@bridge-ds/core": "^0.20.0",
+    "@bridge-ds/visual": "^0.3.14",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"