@bridge-ds/mcp 0.0.0-stage → 0.3.0

package/dist/history.d.ts

@@ -0,0 +1,431 @@
+import { 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>;
+export interface HistoryArgs {
+    token?: string;
+    author?: string;
+    tier?: 1 | 2 | 3;
+    version?: string;
+    breaking?: boolean;
+    since?: string;
+    until?: string;
+    query?: string;
+    limit?: number;
+    includeChanges?: boolean;
+}
+export declare function getHistory(ctx: BridgeContext, a?: HistoryArgs): Promise<{
+    hint: string;
+    note?: string | undefined;
+    versions: {
+        version: string;
+        date: string;
+        pending: boolean;
+        prs: number[];
+        entries: number;
+        tokenChanges: number;
+        breaking: boolean;
+        bump: import("@bridge-ds/core").SemverBump;
+    }[];
+    total: number;
+    entries: {
+        moreChanges?: number | undefined;
+        changes?: {
+            fields?: ("value" | "description" | "type" | "extensions")[] | undefined;
+            after?: string | undefined;
+            before?: string | undefined;
+            file: string;
+            from?: string | undefined;
+            kind: "added" | "changed" | "renamed" | "removed";
+            path: string;
+        }[] | undefined;
+        bulk?: boolean | undefined;
+        version: string | undefined;
+        tier: 1 | 2 | 3;
+        bump: import("@bridge-ds/core").SemverBump;
+        breaking: boolean;
+        counts: import("@bridge-ds/core").HistoryCounts;
+        url?: string | undefined;
+        pr?: number | undefined;
+        id: string;
+        sha: string;
+        date: string;
+        author: string;
+        title: string;
+        why: string;
+    }[];
+    truncated?: string | undefined;
+    source: string;
+    currentVersion: string | null;
+}>;
+export declare function getTokenHistory(ctx: BridgeContext, a: {
+    path: string;
+    limit?: number;
+}): Promise<{
+    hint: string;
+    path: string;
+    exists: boolean;
+    source: string;
+    total: number;
+    changes: {
+        descriptionBefore?: string | undefined;
+        descriptionAfter?: string | undefined;
+        after?: {} | null | undefined;
+        afterCss?: string | undefined;
+        before?: {} | null | undefined;
+        beforeCss?: string | undefined;
+        file: string;
+        mode: string;
+        pathThen?: string | undefined;
+        from?: string | undefined;
+        version: string | undefined;
+        kind: "added" | "changed" | "renamed" | "removed";
+        pr?: number | undefined;
+        entry: string;
+        date: string;
+        author: string;
+        title: string;
+        why: string;
+    }[];
+} | {
+    note: string;
+    path: string;
+    exists: boolean;
+    source: string;
+    total: number;
+    changes: {
+        descriptionBefore?: string | undefined;
+        descriptionAfter?: string | undefined;
+        after?: {} | null | undefined;
+        afterCss?: string | undefined;
+        before?: {} | null | undefined;
+        beforeCss?: string | undefined;
+        file: string;
+        mode: string;
+        pathThen?: string | undefined;
+        from?: string | undefined;
+        version: string | undefined;
+        kind: "added" | "changed" | "renamed" | "removed";
+        pr?: number | undefined;
+        entry: string;
+        date: string;
+        author: string;
+        title: string;
+        why: string;
+    }[];
+}>;
+/** Finds an entry by id ("pr-12"), PR number ("#12", "12"), or sha (7 characters or more). */
+export declare function findEntry(entries: HistoryEntry[], target: string): HistoryEntry;
+export interface RestoreArg {
+    path: string;
+    /** History entry whose value to restore (its value AFTER that change), or use `value`. */
+    entry?: string;
+    /** "before": the value from before `entry` instead of after it. */
+    side?: 'before' | 'after';
+    value?: unknown;
+    file?: string;
+    mode?: Record<string, string>;
+}
+export interface PlanArgs {
+    target?: string;
+    restore?: RestoreArg;
+    /** Conflict key (path@file) -> keep-current | use-before. */
+    resolutions?: Record<string, RevertResolution>;
+    /** Shortcut: every conflict uses the value from before the change. */
+    restoreConflicts?: boolean;
+}
+/** Dry run: what undoing a change (or restoring a token) takes, conflicts included. Writes nothing. */
+export declare function planRevertOp(ctx: BridgeContext, a: PlanArgs & {
+    includeBody?: boolean;
+}): Promise<{
+    next: string;
+    prBody?: string | undefined;
+    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: "ready" | "blocked" | "nothing-to-do";
+}>;
+/** 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;
+}): Promise<{
+    hint: 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: "ready" | "blocked" | "nothing-to-do";
+} | {
+    status: string;
+    prBody: 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;
+} | {
+    status: string;
+    message: string;
+    prBody: 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;
+} | {
+    status: string;
+    branch: string;
+    base: string;
+    commit: string;
+    prBody: string;
+    next: 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[];
+    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;
+    branch: string;
+    commit: string;
+    pr: number;
+    url: string;
+    labels: string[];
+    draft: boolean;
+    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[];
+    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;
+}>;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import {
+  VERSION,
+  optionsFromArgv,
+  serveStdio
+} from "./chunk-GABRGCKY.js";
+import "./chunk-X455XY4E.js";
+
+// src/index.ts
+var argv = process.argv.slice(2);
+if (argv.includes("--help") || argv.includes("-h")) {
+  process.stdout.write(`bridge-mcp ${VERSION}: Bridge design system MCP server (stdio)
+
+Usage:
+  bridge-mcp [--root <dir>]                 local repo (default: current directory)
+  bridge-mcp --repo <owner/name> [--ref r]  GitHub repo over the API
+
+Env:
+  GITHUB_TOKEN   optional. Without it Bridge is read-only. With it Bridge can open PRs on new
+                 bridge/* branches (never main). Use a fine-grained token scoped to one repo.
+`);
+  process.exit(0);
+}
+if (argv.includes("--version")) {
+  process.stdout.write(`${VERSION}
+`);
+  process.exit(0);
+}
+serveStdio(optionsFromArgv(argv)).catch((e) => {
+  process.stderr.write(`bridge-mcp: ${e.message}
+`);
+  process.exit(1);
+});

package/dist/lib.d.ts

@@ -0,0 +1,20 @@
+import { type ContextOptions } from './context.js';
+export { BridgeContext, type ContextOptions } from './context.js';
+export { createServer, VERSION } 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';
+export { auditSnippet } from './audit.js';
+export * as ops from './ops.js';
+export * as history from './history.js';
+export * as brand from './brand.js';
+export * as requests from './requests.js';
+export * as explorations from './explorations.js';
+export * as drafts from './drafts.js';
+export { DOCS_DRAFT_MODEL, anthropicReplyText, anthropicRequest, formatDocsJson, mergeDocsDraft, missingProse, parseDocsReply } from '@bridge-ds/core';
+export interface ServeOptions extends ContextOptions {
+}
+/** Starts the stdio MCP server. Logs go to stderr: stdout belongs to the protocol. */
+export declare function serveStdio(opts?: ServeOptions): Promise<void>;
+/** Parses `--root <dir> --repo <owner/name> --ref <ref>`; token from GITHUB_TOKEN or BRIDGE_GITHUB_TOKEN. */
+export declare function optionsFromArgv(argv: string[], env?: NodeJS.ProcessEnv): ServeOptions;

package/dist/lib.js

@@ -0,0 +1,60 @@
+import {
+  BridgeContext,
+  DOCS_DRAFT_MODEL,
+  GitHubSource,
+  GitRefSource,
+  LocalSource,
+  VERSION,
+  anthropicReplyText,
+  anthropicRequest,
+  auditSnippet,
+  brand_exports,
+  core,
+  createServer,
+  detectConfig,
+  drafts_exports,
+  explorations_exports,
+  formatDocsJson,
+  history_exports,
+  mergeDocsDraft,
+  missingProse,
+  ops_exports,
+  optionsFromArgv,
+  parseDocsReply,
+  requests_exports,
+  serveStdio
+} from "./chunk-GABRGCKY.js";
+import {
+  CONFIG_FILE,
+  loadConfig,
+  toConfigJson
+} from "./chunk-X455XY4E.js";
+export {
+  BridgeContext,
+  CONFIG_FILE,
+  DOCS_DRAFT_MODEL,
+  GitHubSource,
+  GitRefSource,
+  LocalSource,
+  VERSION,
+  anthropicReplyText,
+  anthropicRequest,
+  auditSnippet,
+  brand_exports as brand,
+  core,
+  createServer,
+  detectConfig,
+  drafts_exports as drafts,
+  explorations_exports as explorations,
+  formatDocsJson,
+  history_exports as history,
+  mergeDocsDraft,
+  missingProse,
+  ops_exports as ops,
+  optionsFromArgv,
+  loadConfig as parseConfig,
+  parseDocsReply,
+  requests_exports as requests,
+  serveStdio,
+  toConfigJson
+};

package/dist/markdown.d.ts

@@ -0,0 +1,16 @@
+export interface Section {
+    level: number;
+    title: string;
+    slug: string;
+    body: string;
+}
+export declare const slug: (s: string) => string;
+export declare function sections(md: string): Section[];
+export declare function toc(md: string): {
+    level: number;
+    title: string;
+    slug: string;
+}[];
+/** Matches "4", "color", "Color", "contrast-commitments". Returns all matches, best first. */
+export declare function findSection(md: string, query: string): Section[];
+export declare function bullets(body: string): string[];