@bridge-ds/mcp 0.6.0 → 0.7.1

package/dist/figma.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentPushDiff } from '@bridge-ds/core';
+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';
@@ -65,14 +65,21 @@ 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;

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-M7DUTFIQ.js";
-import "./chunk-E4D5KPIQ.js";
+} from "./chunk-YCKNSKPW.js";
+import "./chunk-BZ3KXXMM.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.d.ts

@@ -15,6 +15,7 @@ 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

@@ -26,13 +26,14 @@ import {
   pieces_exports,
   requests_exports,
   serveStdio,
-  studio_exports
-} from "./chunk-M7DUTFIQ.js";
+  studio_exports,
+  suggestions_exports
+} from "./chunk-YCKNSKPW.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-E4D5KPIQ.js";
+} from "./chunk-BZ3KXXMM.js";
 export {
   BridgeContext,
   CONFIG_FILE,
@@ -64,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,6 +57,7 @@ export declare function openLibraryBranchOp(ctx: BridgeContext, a: {
         number: number;
         url: string;
     } | undefined;
+    changesMode: ChangesMode;
     neededBy: string;
     request?: string | undefined;
     exploration?: string | undefined;

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

@@ -11,7 +11,7 @@ import {
   referenceImagePath,
   selectTokenFiles,
   showFile
-} from "./chunk-E4D5KPIQ.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;