@bridge-ds/mcp 0.5.0 → 0.7.0

package/dist/figma.d.ts

@@ -0,0 +1,90 @@
+import { type ChangesMode, type ComponentPushDiff } from '@bridge-ds/core';
+import type { BridgeContext } from './context.js';
+/** Who sends from here: the MCP server speaks for an AI agent, the CLI for the person. */
+export type FigmaSource = 'mcp' | 'cli';
+/** bridge_figma_changes / `bridge figma`: the library branches opened from Figma components, and where each stands. */
+export declare function figmaChangesOp(ctx: BridgeContext, a?: {
+    state?: 'open' | 'closed' | 'all' | undefined;
+}): Promise<{
+    changes: {
+        pr: number;
+        title: string;
+        url: string;
+        branch: string;
+        component: string;
+        route: string;
+        status: string;
+        said: string;
+    }[];
+    next: string;
+}>;
+/** bridge_get_figma_change / `bridge figma show <n>`: one library branch from Figma, its spec and the brief to draft it. */
+export declare function getFigmaChangeOp(ctx: BridgeContext, a: {
+    pr: number | string;
+}): Promise<{
+    next: string;
+    brief?: string | undefined;
+    spec?: {
+        path: string | undefined;
+        changes: import("@bridge-ds/core").RequestChange[];
+        variantAxes: Record<string, string[]>;
+        properties: {
+            name: string;
+            type: string;
+            default: string;
+        }[];
+        tokenEdits: import("@bridge-ds/core").TokenEdit[];
+        reasons: string[];
+    } | undefined;
+    pr: number;
+    title: string;
+    url: string;
+    branch: string;
+    component: string;
+    route: string;
+    status: string;
+    said: string;
+}>;
+/** bridge_mark_figma_change_drafted / `bridge figma drafted <n>`: the code is on the branch, labelled drafted by Claude AI. */
+export declare function markFigmaDraftedOp(ctx: BridgeContext, a: {
+    pr: number | string;
+}): Promise<{
+    pr: number;
+    status: string;
+    said: string;
+    files: string[];
+    next: string;
+}>;
+/**
+ * bridge_push_figma_component / `bridge figma push <diff.json>`: the plugin's push from a structured diff. An exact token
+ * swap opens a token change (same plan, contrast gate and body as bridge_propose_token_change, plus the component pairs
+ * the swap moves); anything that needs code opens a draft branch with the spec for Claude AI; what cannot be read is
+ * listed with what to do. dryRun shows the route.
+ */
+export declare function pushFigmaComponentOp(ctx: BridgeContext, a: {
+    diff: ComponentPushDiff;
+    dryRun?: boolean | undefined;
+    source?: FigmaSource | undefined;
+    changes?: ChangesMode | undefined;
+}): Promise<{
+    next: string;
+    suggestion?: {
+        route: "token-change" | "claude-draft";
+        number: number;
+        url: string;
+    } | undefined;
+    library?: {
+        route: "token-change" | "claude-draft";
+        number: number;
+        url: string;
+        branch: string;
+    } | undefined;
+    changesMode: ChangesMode;
+    fixInFigma?: import("@bridge-ds/core").PushIssue[] | undefined;
+    reasons?: string[] | undefined;
+    edits?: import("@bridge-ds/core").TokenEdit[] | undefined;
+    status: "opened" | "suggested" | "dry-run" | "not-sent";
+    component: string;
+    route: string;
+    said: string;
+}>;

package/dist/history.d.ts

@@ -1,4 +1,4 @@
-import { type HistoryEntry, type HistoryReport, type RevertResolution } from '@bridge-ds/core';
+import { type ChangesMode, type HistoryEntry, type HistoryReport, type RevertResolution } from '@bridge-ds/core';
 import type { BridgeContext } from './context.js';
 /** The history report for this context: local git (first parent of HEAD) or GitHub (the ref, PRs folded). */
 export declare function loadHistory(ctx: BridgeContext, limit?: number): Promise<HistoryReport>;
@@ -187,6 +187,8 @@ export declare function planRevertOp(ctx: BridgeContext, a: PlanArgs & {
 /** Plans, then commits to a new local bridge/* branch or opens a PR on a new bridge/* branch. Never main. */
 export declare function proposeRevert(ctx: BridgeContext, a: PlanArgs & {
     dryRun?: boolean;
+    changes?: ChangesMode | undefined;
+    source?: 'mcp' | 'cli' | undefined;
 }): Promise<{
     hint: string;
     tier: 1 | 2 | 3;
@@ -232,6 +234,162 @@ export declare function proposeRevert(ctx: BridgeContext, a: PlanArgs & {
     title: string;
     why?: string | undefined;
     status: "ready" | "blocked" | "nothing-to-do";
+} | {
+    status: string;
+    changesMode: string;
+    suggestion: {
+        title: string;
+        labels: string[];
+        body: string;
+        parts: number;
+    };
+    fileContents: {
+        path: string;
+        content: string;
+    }[];
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    edits: string[];
+    conflicts: {
+        before?: string | undefined;
+        now?: unknown;
+        key: string;
+        path: string;
+        file: string;
+        reason: import("@bridge-ds/core").ConflictReason;
+        message: string;
+        later: string[];
+        resolution: RevertResolution;
+    }[];
+    skipped: string[];
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+        sample: import("@bridge-ds/core").ContrastDelta[];
+    };
+    newErrors: import("@bridge-ds/core").LayerIssue[];
+    branch: string;
+    files: string[];
+    notes: string[];
+    reverts?: {
+        pr?: number | undefined;
+        id: string;
+        title: string;
+        date: string;
+        author: string;
+    } | undefined;
+    kind: "revert" | "restore";
+    title: string;
+    why?: string | undefined;
+} | {
+    status: string;
+    message: string;
+    changesMode: string;
+    fileContents: {
+        path: string;
+        content: string;
+    }[];
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    edits: string[];
+    conflicts: {
+        before?: string | undefined;
+        now?: unknown;
+        key: string;
+        path: string;
+        file: string;
+        reason: import("@bridge-ds/core").ConflictReason;
+        message: string;
+        later: string[];
+        resolution: RevertResolution;
+    }[];
+    skipped: string[];
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+        sample: import("@bridge-ds/core").ContrastDelta[];
+    };
+    newErrors: import("@bridge-ds/core").LayerIssue[];
+    branch: string;
+    files: string[];
+    notes: string[];
+    reverts?: {
+        pr?: number | undefined;
+        id: string;
+        title: string;
+        date: string;
+        author: string;
+    } | undefined;
+    kind: "revert" | "restore";
+    title: string;
+    why?: string | undefined;
+} | {
+    next: string;
+    warnings?: string[] | undefined;
+    status: string;
+    changesMode: string;
+    number: number;
+    url: string;
+    version: string;
+    labels: string[];
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    edits: string[];
+    conflicts: {
+        before?: string | undefined;
+        now?: unknown;
+        key: string;
+        path: string;
+        file: string;
+        reason: import("@bridge-ds/core").ConflictReason;
+        message: string;
+        later: string[];
+        resolution: RevertResolution;
+    }[];
+    skipped: string[];
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+        sample: import("@bridge-ds/core").ContrastDelta[];
+    };
+    newErrors: import("@bridge-ds/core").LayerIssue[];
+    branch: string;
+    files: string[];
+    notes: string[];
+    reverts?: {
+        pr?: number | undefined;
+        id: string;
+        title: string;
+        date: string;
+        author: string;
+    } | undefined;
+    kind: "revert" | "restore";
+    title: string;
+    why?: string | undefined;
 } | {
     status: string;
     prBody: string;

package/dist/index.js

@@ -3,8 +3,8 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-MHCXMHCL.js";
-import "./chunk-QTO4EP6V.js";
+} from "./chunk-MFV5WHB5.js";
+import "./chunk-BZ3KXXMM.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.d.ts

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

package/dist/lib.js

@@ -15,6 +15,7 @@ import {
   detectConfig,
   drafts_exports,
   explorations_exports,
+  figma_exports,
   formatDocsJson,
   history_exports,
   mergeDocsDraft,
@@ -25,13 +26,14 @@ import {
   pieces_exports,
   requests_exports,
   serveStdio,
-  studio_exports
-} from "./chunk-MHCXMHCL.js";
+  studio_exports,
+  suggestions_exports
+} from "./chunk-MFV5WHB5.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-QTO4EP6V.js";
+} from "./chunk-BZ3KXXMM.js";
 export {
   BridgeContext,
   CONFIG_FILE,
@@ -50,6 +52,7 @@ export {
   detectConfig,
   drafts_exports as drafts,
   explorations_exports as explorations,
+  figma_exports as figma,
   formatDocsJson,
   history_exports as history,
   mergeDocsDraft,
@@ -62,5 +65,6 @@ export {
   requests_exports as requests,
   serveStdio,
   studio_exports as studio,
+  suggestions_exports as suggestions,
   toConfigJson
 };

package/dist/ops.d.ts

@@ -1,6 +1,6 @@
 import { DesignSystemIndex } from '@bridge-ds/core/audit';
 import { type ScaffoldInput } from './components.js';
-import { type BridgeConfig, type GitHubClient } from '@bridge-ds/core';
+import { type ChangesMode, type BridgeConfig, type GitHubClient } from '@bridge-ds/core';
 import { type Combo, type PairInput, type TokenEdit, type TokenSet } from './core-adapter.js';
 import { BridgeContext } from './context.js';
 /** Accepts `color.text.muted`, `--color-text-muted` or `var(--color-text-muted)`. */
@@ -9,6 +9,7 @@ export declare function getConfig(ctx: BridgeContext): Promise<{
     source: string;
     configOrigin: string;
     write: string;
+    changes: string;
     repo: string | null;
     tokenFiles: number;
     tokens: number;
@@ -278,6 +279,10 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     pr?: number | string | undefined;
     jira?: string | undefined;
     product?: string | undefined;
+    /** "suggest" or "direct" for this call; default: `changes` in bridge.config.json, else "suggest". */
+    changes?: ChangesMode | undefined;
+    /** Who sends it: the MCP server (an AI agent) or the CLI (the person). */
+    source?: 'mcp' | 'cli' | undefined;
 }): Promise<{
     status: string;
     pr: number;
@@ -374,6 +379,106 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     why: string;
     newErrors: import("@bridge-ds/core").LayerIssue[];
     message?: undefined;
+} | {
+    suggestion: {
+        title: string;
+        body: string;
+    };
+    fileContents: {
+        path: string;
+        content: string | null;
+    }[];
+    changesMode: "suggest";
+    files: string[];
+    title: string;
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    changes: {
+        fields?: ("value" | "description" | "type" | "extensions")[] | undefined;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+        from?: string | undefined;
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    impact: {
+        total: number;
+        sample: import("@bridge-ds/core").ImpactEntry[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
+} | {
+    fileContents: {
+        path: string;
+        content: string | null;
+    }[];
+    changesMode: "suggest";
+    files: string[];
+    title: string;
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    changes: {
+        fields?: ("value" | "description" | "type" | "extensions")[] | undefined;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+        from?: string | undefined;
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    impact: {
+        total: number;
+        sample: import("@bridge-ds/core").ImpactEntry[];
+    };
+    notes: string[];
+    status: string;
+    message: string;
+} | {
+    product: string;
+    next: string;
+    warnings?: string[] | undefined;
+    number: number;
+    url: string;
+    version: string;
+    labels: string[];
+    changesMode: "suggest";
+    files: string[];
+    title: string;
+    tier: 1 | 2 | 3;
+    bump: import("@bridge-ds/core").SemverBump;
+    reasons: string[];
+    changes: {
+        fields?: ("value" | "description" | "type" | "extensions")[] | undefined;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+        from?: string | undefined;
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    impact: {
+        total: number;
+        sample: import("@bridge-ds/core").ImpactEntry[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
 } | {
     fileContents: {
         path: string;

package/dist/pieces.d.ts

@@ -1,3 +1,4 @@
+import { type ChangesMode } from '@bridge-ds/core';
 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';
@@ -45,6 +46,7 @@ export declare function openLibraryBranchOp(ctx: BridgeContext, a: {
     usePreview?: boolean | undefined;
     dryRun?: boolean | undefined;
     source?: PiecesSource | undefined;
+    changes?: ChangesMode | undefined;
 }): Promise<{
     next: string;
     warnings?: string[] | undefined;
@@ -55,12 +57,13 @@ export declare function openLibraryBranchOp(ctx: BridgeContext, a: {
         number: number;
         url: string;
     } | undefined;
+    changesMode: ChangesMode;
     neededBy: string;
     request?: string | undefined;
     exploration?: string | undefined;
     brief?: string | undefined;
     edits?: import("@bridge-ds/core").TokenEdit[] | undefined;
-    status: "opened" | "already-linked" | "dry-run";
+    status: "opened" | "suggested" | "already-linked" | "dry-run";
     pr: number;
     piece: string;
     opens: string;

package/dist/{src-DHJOM5PQ.js → src-ABI7LARD.js}

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

package/dist/studio.d.ts

@@ -1,3 +1,4 @@
+import { type ChangesMode } from '@bridge-ds/core';
 import type { BridgeContext } from './context.js';
 /**
  * Save a component's guidance (docs.json) the way the Library edit mode does: merged into the docs on the branch,
@@ -13,6 +14,9 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     jira?: string | undefined;
     product?: string | undefined;
     dryRun?: boolean | undefined;
+    /** "suggest" or "direct" for this call; default: `changes` in bridge.config.json, else "suggest". */
+    changes?: ChangesMode | undefined;
+    source?: 'mcp' | 'cli' | undefined;
 }): Promise<{
     status: "dry-run";
     pr: number;
@@ -57,9 +61,23 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     path: string;
     content: string;
     product: string;
+    changesMode: ChangesMode;
     pr?: undefined;
     url?: undefined;
     title?: undefined;
+} | {
+    said: string;
+    next: string;
+    warnings?: string[] | undefined;
+    status: "suggested";
+    number: number;
+    url: string;
+    title: string;
+    path: string;
+    product: string;
+    changesMode: "suggest";
+    pr?: undefined;
+    content?: undefined;
 } | {
     status: "sent-for-review";
     pr: number;