@bridge-ds/mcp 0.0.0-stage → 0.2.0

package/dist/requests.d.ts

@@ -0,0 +1,89 @@
+import { type ComponentChangeRequest, type IssueSummary, type RequestChange, type RequestKind, type RequestSource, type RequestStatus } from '@bridge-ds/core';
+import type { BridgeContext } from './context.js';
+export type RequestStatusFilter = RequestStatus | 'all';
+export interface LinkedPr {
+    number: number;
+    title: string;
+    /** "open", "closed" or "merged". */
+    state: string;
+    url: string;
+}
+export interface RequestRow {
+    number: number;
+    component: string;
+    kind: RequestKind;
+    title: string;
+    status: RequestStatus;
+    url: string;
+    linkedPrs: LinkedPr[];
+    /** Exploration branch it is implemented on, when it is part of one. */
+    exploration?: string | undefined;
+}
+/**
+ * The request in an issue: the hidden Bridge block, or, for an issue someone labeled component-change by hand, what
+ * the title ("Button: add a ghost variant"), the request labels and the body tell.
+ */
+export declare function requestFromIssue(issue: Pick<IssueSummary, 'title' | 'body' | 'labels'>): ComponentChangeRequest;
+export declare function listRequests(ctx: BridgeContext, a: {
+    status?: RequestStatusFilter;
+    component?: string;
+    limit?: number;
+}): Promise<{
+    repo: string;
+    label: string;
+    status: RequestStatusFilter;
+    total: number;
+    requests: RequestRow[];
+}>;
+export declare function getRequest(ctx: BridgeContext, a: {
+    number: number;
+    branch?: string | undefined;
+}): Promise<{
+    next: string;
+    exploration?: string | undefined;
+    number: number;
+    url: string;
+    state: "closed" | "open";
+    status: RequestStatus;
+    labels: string[];
+    author: string;
+    request: ComponentChangeRequest;
+    linkedPrs: LinkedPr[];
+    component: {
+        name: string;
+        exists: boolean;
+        dir: string | undefined;
+        files: string[];
+    };
+    agentsFile: string;
+    brief: string;
+}>;
+export interface CreateRequestInput {
+    component: string;
+    kind: RequestKind;
+    title: string;
+    summary: string;
+    changes?: RequestChange[] | undefined;
+    figmaUrl?: string | undefined;
+    source?: RequestSource | undefined;
+    /** Exploration branch to implement it on (`explore/<slug>`), instead of a pull request to main. */
+    exploration?: string | undefined;
+    dryRun?: boolean | undefined;
+}
+export declare function createRequest(ctx: BridgeContext, a: CreateRequestInput): Promise<{
+    status: "dry-run";
+    issue: import("@bridge-ds/core").RequestIssue;
+    number?: undefined;
+    url?: undefined;
+    title?: undefined;
+    labels?: undefined;
+    next?: undefined;
+} | {
+    status: "created";
+    number: number;
+    url: string;
+    title: string;
+    labels: string[];
+    next: string;
+    issue?: undefined;
+}>;

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BridgeContext } from './context.js';
+export declare const VERSION = "0.1.0";
+export declare function createServer(ctx: BridgeContext): McpServer;

package/dist/source.d.ts

@@ -0,0 +1,39 @@
+import type { GitHubClient } from '@bridge-ds/core';
+export interface RepoSource {
+    kind: 'local' | 'git-ref' | 'github';
+    /** Human label: a path, `ref` or `owner/repo@ref`. */
+    label: string;
+    /** Repo-relative file paths under `prefix` ('' for everything). */
+    list(prefix?: string): Promise<string[]>;
+    read(path: string): Promise<string | null>;
+}
+export declare class LocalSource implements RepoSource {
+    readonly root: string;
+    readonly kind: "local";
+    constructor(root: string);
+    get label(): string;
+    list(prefix?: string): Promise<string[]>;
+    read(path: string): Promise<string | null>;
+}
+/** A local git ref (branch, tag, sha): reviews of local proposal branches and `bridge diff <base>`. */
+export declare class GitRefSource implements RepoSource {
+    readonly root: string;
+    readonly ref: string;
+    readonly kind: "git-ref";
+    private files?;
+    constructor(root: string, ref: string);
+    get label(): string;
+    list(prefix?: string): Promise<string[]>;
+    read(path: string): Promise<string | null>;
+}
+export declare class GitHubSource implements RepoSource {
+    readonly client: GitHubClient;
+    readonly ref: string;
+    readonly kind: "github";
+    private tree?;
+    private cache;
+    constructor(client: GitHubClient, ref: string);
+    get label(): string;
+    list(prefix?: string): Promise<string[]>;
+    read(path: string): Promise<string | null>;
+}