@bridge-ds/mcp 0.9.0 → 0.11.0

package/dist/explorations.d.ts

@@ -9,7 +9,8 @@ export declare const settingsOf: (config: BridgeConfig) => {
 export declare function toExplorationBranch(ref: string): string;
 export interface StartExplorationInput {
     name: string;
-    purpose: string;
+    /** What the designer wants to learn. Optional: nobody is asked for a brief; Claude passes their first sentence when it has one. */
+    purpose?: string | undefined;
     useCase?: string | undefined;
     experimental?: string[] | undefined;
     author?: string | undefined;
@@ -18,16 +19,61 @@ export interface StartExplorationInput {
     agent?: string | undefined;
     /** The product it is tried in (key or name, bridge.config.json "products"). Default: the product of the current folder or repo. */
     product?: string | undefined;
+    /**
+     * Where the branch is created. `product` (the default): in the product's own repository when the team connected one
+     * (bridge.config.json products[].repo), else in the design system repository. `library`: always in the design system
+     * repository, the fallback when the person chooses it because Bridge cannot reach the product repository.
+     */
+    where?: 'product' | 'library' | undefined;
     dryRun?: boolean | undefined;
 }
+/** What Claude says when Bridge cannot reach a product's own repository: the admin action first, the fallback on request. */
+export declare function productRepoBlocked(ctx: BridgeContext, product: string, repo: string, reason: 'not-connected' | 'read-only' | 'no-token'): string;
 /**
  * bridge_start_exploration / `bridge explore start`. With a GitHub token: the branch on GitHub from the default branch
  * and a draft pull request labeled exploration. Without one, in a local git repo: a local branch with the note,
  * nothing pushed, and the commands to push it and open the draft pull request.
  */
 export declare function startExploration(ctx: BridgeContext, a: StartExplorationInput): Promise<{
+    blocked?: string | undefined;
     branch: string;
     product: string;
+    repo: string;
+    inProductRepo: boolean;
+    slug: string;
+    base: string;
+    title: string;
+    label: string;
+    note: {
+        path: string;
+        content: string;
+    };
+    prBody: string;
+    status: "dry-run";
+} | {
+    pr: number;
+    url: string;
+    commit: string;
+    next: string;
+    branch: string;
+    product: string;
+    repo: string;
+    inProductRepo: boolean;
+    slug: string;
+    base: string;
+    title: string;
+    label: string;
+    note: {
+        path: string;
+        content: string;
+    };
+    prBody: string;
+    status: "started";
+} | {
+    branch: string;
+    product: string;
+    repo: string | null;
+    inProductRepo: boolean;
     slug: string;
     base: string;
     title: string;
@@ -55,6 +101,8 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     next: string;
     branch: string;
     product: string;
+    repo: string | null;
+    inProductRepo: boolean;
     slug: string;
     base: string;
     title: string;
@@ -70,6 +118,8 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     next: string;
     branch: string;
     product: string;
+    repo: string | null;
+    inProductRepo: boolean;
     slug: string;
     base: string;
     title: string;
@@ -93,6 +143,8 @@ export declare function installOf(t: ExplorationTryIt): {
 /** bridge_list_explorations / `bridge explore list`. */
 export declare function listExplorations(ctx: BridgeContext, a?: {
     state?: 'open' | 'closed' | 'all';
+    archived?: boolean | undefined;
+    mine?: boolean | undefined;
 }): Promise<{
     localBranches?: string[] | undefined;
     localHint?: string | undefined;
@@ -109,6 +161,7 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
             url: string;
             state: string;
         }[];
+        ref: string;
         number: number;
         url: string;
         branch: string;
@@ -117,6 +170,7 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
         purpose: string;
         useCase?: string | undefined;
         status: import("@bridge-ds/core").ExplorationStatus;
+        archived: boolean;
         draft: boolean;
         author: string;
         source?: ExplorationSource | undefined;
@@ -128,6 +182,8 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
             label: string;
             url: string;
         }[];
+        repo?: string | undefined;
+        product?: string | undefined;
     } | {
         install: {
             state: ExplorationTryIt["state"];
@@ -140,6 +196,7 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
             url: string;
             state: string;
         }[];
+        ref: string;
         number: number;
         url: string;
         branch: string;
@@ -148,6 +205,7 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
         purpose: string;
         useCase?: string | undefined;
         status: import("@bridge-ds/core").ExplorationStatus;
+        archived: boolean;
         draft: boolean;
         author: string;
         source?: ExplorationSource | undefined;
@@ -159,6 +217,8 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
             label: string;
             url: string;
         }[];
+        repo?: string | undefined;
+        product?: string | undefined;
     } | {
         previews: {
             app: keyof import("@bridge-ds/core").PreviewApps;
@@ -177,6 +237,7 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
             url: string;
             state: string;
         }[];
+        ref: string;
         number: number;
         url: string;
         branch: string;
@@ -185,37 +246,137 @@ export declare function listExplorations(ctx: BridgeContext, a?: {
         purpose: string;
         useCase?: string | undefined;
         status: import("@bridge-ds/core").ExplorationStatus;
+        archived: boolean;
         draft: boolean;
         author: string;
         source?: ExplorationSource | undefined;
         agent?: string | undefined;
         updatedAt: string;
         headSha: string;
+        repo?: string | undefined;
+        product?: string | undefined;
     })[];
 }>;
-/** `bridge explore promote`: ready for review, tier labels, exploration label and note removed, linked requests closed on merge. */
-export declare function promoteExploration(ctx: BridgeContext, a: {
+/**
+ * bridge_promote_exploration (kept name) / `bridge explore done` (`promote` is an alias): "Done exploring". The pieces
+ * named in `pieces` (ids from bridge_missing_pieces) go to the DS lead as requests with the preview link; the
+ * exploration label and note go, `ready-for-devs` comes, and developers take the branch from there. Nothing is closed,
+ * merged or marked ready for review, so the preview link stays alive. Without `pieces`, the result lists the pieces
+ * still unsent so the person can pick.
+ */
+export declare function doneExploring(ctx: BridgeContext, a: {
     ref: string;
+    pieces?: string[] | undefined;
     dryRun?: boolean | undefined;
+    source?: ExplorationSource | undefined;
+    agent?: string | undefined;
 }): Promise<{
-    closes: number[];
-    number: number;
+    notProposed: {
+        id: string;
+        title: string;
+        summary: string;
+    }[];
+    checked: boolean;
+    forDevelopers: {
+        take: [string, string];
+        note: string;
+    };
+    warnings: string[];
+    next: string;
+    unknownPieces?: string[] | undefined;
     url: string;
     branch: string;
-    warnings: string[];
-    tier: import("@bridge-ds/core").RiskTier;
-    reasons: string[];
-    removeLabels: string[];
-    addLabels: string[];
+    exploration: import("@bridge-ds/core").ExplorationStatus;
+    labels: {
+        add: string[];
+        remove: string[];
+    } | null;
     removeFiles: string[];
-    body: string;
-    title: string;
-    markReady: true;
-    status: "promoted" | "dry-run";
+    requests: {
+        piece: string;
+        title: string;
+        number: number;
+        url: string;
+    }[];
+    alreadySent: {
+        piece: string;
+        number: number;
+    }[];
+    repo?: string | undefined;
+    product?: string | undefined;
+    requestsIn?: string | undefined;
+    status: "dry-run" | "done-exploring" | "already-done";
+    number: number;
+    ref: string;
+}>;
+/**
+ * bridge_continue_exploration / "Continue Bridge exploration #12" (or shop#12): resolves the exploration, switches the
+ * local checkout of its repository to its branch when that is safe, and returns where it stands in plain words (what
+ * changed, the last activity) for Claude to say first, with the previews and the missing pieces when recorded.
+ * One read of the pull request, its files and its commits.
+ */
+export declare function continueExploration(ctx: BridgeContext, a: {
+    ref: string;
+    checkout?: boolean | undefined;
+}): Promise<{
+    checkout: {
+        status: "already-on-it" | "switched" | "not-switched";
+        note: string;
+    };
+    continueLines: {
+        app: string;
+        terminal: string;
+    };
+    next: string;
+    missingPieces?: {
+        id: string;
+        title: string;
+    }[] | undefined;
+    ref: string;
+    number: number;
+    name: string;
+    product: string;
+    repo: string;
+    branch: string;
+    url: string;
+    status: import("@bridge-ds/core").ExplorationStatus;
+    statusLabel: string;
+    archived: boolean;
+    stage: "exploring" | "not-started" | "handed";
+    whereItStands: string;
+    activity: {
+        who: string;
+        what: string;
+        when: string;
+    }[];
+    changedFiles: string[] | null;
+    previews: {
+        app: keyof import("@bridge-ds/core").PreviewApps;
+        label: string;
+        url: string;
+    }[];
+}>;
+/** @deprecated The old name: "Promote to review" became "Done exploring" (doneExploring). */
+export declare const promoteExploration: typeof doneExploring;
+/** bridge_archive_exploration / `bridge explore archive|unarchive`: the archived label on the still open pull request. */
+export declare function archiveExploration(ctx: BridgeContext, a: {
+    ref: string;
+    archived?: boolean | undefined;
+}): Promise<{
+    next: string;
+    repo?: string | undefined;
+    ref: string;
+    number: number;
+    url: string;
+    branch: string;
+    archived: boolean;
+    status: "archived" | "unarchived";
 }>;
 export declare function closeExploration(ctx: BridgeContext, a: {
     ref: string;
 }): Promise<{
+    note: string;
+    repo?: string | undefined;
     number: number;
     url: string;
     branch: string;

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/figma.d.ts

@@ -84,7 +84,7 @@ export declare function pushFigmaComponentOp(ctx: BridgeContext, a: {
     fixInFigma?: import("@bridge-ds/core").PushIssue[] | undefined;
     reasons?: string[] | undefined;
     edits?: import("@bridge-ds/core").TokenEdit[] | undefined;
-    status: "opened" | "suggested" | "dry-run" | "not-sent";
+    status: "suggested" | "opened" | "dry-run" | "not-sent";
     component: string;
     route: string;
     said: string;

package/dist/index.js

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

package/dist/lib.d.ts

@@ -1,7 +1,9 @@
-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 { findProductLink, GIT_CONFIG_KEYS, linkedOptions, parseProductPointer, PRODUCT_POINTER, type ProductLink, type ProductPointer } from './product-link.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 +31,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

@@ -2,9 +2,12 @@ import {
   BlockedError,
   BridgeContext,
   DOCS_DRAFT_MODEL,
+  GIT_CONFIG_KEYS,
   GitHubSource,
   GitRefSource,
   LocalSource,
+  PRODUCT_POINTER,
+  SERVER_INFO,
   VERSION,
   anthropicReplyText,
   anthropicRequest,
@@ -19,15 +22,19 @@ import {
   explorations_exports,
   figma_exports,
   figma_fixes_exports,
+  findProductLink,
   formatDocsJson,
   ghAuthToken,
+  handleHttp,
   history_exports,
   isBlocked,
+  linkedOptions,
   mergeDocsDraft,
   missingProse,
   ops_exports,
   optionsFromArgv,
   parseDocsReply,
+  parseProductPointer,
   pieces_exports,
   requests_exports,
   say,
@@ -35,20 +42,23 @@ import {
   studio_exports,
   suggestions_exports,
   tokenNote
-} from "./chunk-TP33MW7E.js";
+} from "./chunk-LI4FNPYK.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-ZVORAO5H.js";
+} from "./chunk-WSNJYGA5.js";
 export {
   BlockedError,
   BridgeContext,
   CONFIG_FILE,
   DOCS_DRAFT_MODEL,
+  GIT_CONFIG_KEYS,
   GitHubSource,
   GitRefSource,
   LocalSource,
+  PRODUCT_POINTER,
+  SERVER_INFO,
   VERSION,
   anthropicReplyText,
   anthropicRequest,
@@ -63,16 +73,20 @@ export {
   explorations_exports as explorations,
   figma_exports as figma,
   figma_fixes_exports as figmaFixes,
+  findProductLink,
   formatDocsJson,
   ghAuthToken,
+  handleHttp,
   history_exports as history,
   isBlocked,
+  linkedOptions,
   mergeDocsDraft,
   missingProse,
   ops_exports as ops,
   optionsFromArgv,
   loadConfig as parseConfig,
   parseDocsReply,
+  parseProductPointer,
   pieces_exports as pieces,
   requests_exports as requests,
   say,

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/pieces.d.ts

@@ -30,10 +30,12 @@ export declare function missingPiecesOp(ctx: BridgeContext, a: {
     recorded: boolean;
     next: string;
     skipped?: string | undefined;
-    pr: number;
     branch: string;
     product: string;
     files: number;
+    repo?: string | undefined;
+    pr: number;
+    ref: string;
 }>;
 /**
  * bridge_open_library_branch / `bridge pieces open <n> <piece>`: the library side of one recorded piece, linked both
@@ -57,13 +59,15 @@ export declare function openLibraryBranchOp(ctx: BridgeContext, a: {
         number: number;
         url: string;
     } | undefined;
-    changesMode: ChangesMode;
     neededBy: string;
+    ref?: string | undefined;
+    repo?: string | undefined;
+    changesMode: ChangesMode;
     request?: string | undefined;
     exploration?: string | undefined;
     brief?: string | undefined;
     edits?: import("@bridge-ds/core").TokenEdit[] | undefined;
-    status: "opened" | "suggested" | "already-linked" | "dry-run";
+    status: "suggested" | "opened" | "already-linked" | "dry-run";
     pr: number;
     piece: string;
     opens: string;
@@ -74,7 +78,6 @@ export declare function productBranchOp(ctx: BridgeContext, a: {
     pr: number | string;
 }): Promise<{
     next?: string | undefined;
-    pr: number;
     title: string;
     product: string;
     said: string;
@@ -102,6 +105,10 @@ export declare function productBranchOp(ctx: BridgeContext, a: {
         title: string;
         summary: string;
     }[];
+    ref?: string | undefined;
+    repo?: string | undefined;
+    library?: string | undefined;
+    pr: number;
 }>;
 /** bridge_use_library_preview: the product branch takes (again) the library branch of a piece, merged in. */
 export declare function useLibraryPreviewOp(ctx: BridgeContext, a: {

package/dist/product-link.d.ts

@@ -0,0 +1,42 @@
+import type { ContextOptions } from './context.js';
+/** Where the pointer lives, relative to the product repository root. */
+export declare const PRODUCT_POINTER = ".bridge/product.json";
+export interface ProductPointer {
+    version: 1;
+    /** The team's design system repository, `owner/name`, where bridge.config.json lives. */
+    designSystem: string;
+    /** The product key in that bridge.config.json `products[]`. */
+    product: string;
+}
+export interface ProductLink extends ProductPointer {
+    /** The product repository root: the folder holding `.bridge/product.json`. */
+    root: string;
+}
+/**
+ * The same link kept in the clone's own git config (`bridge.designSystem`, `bridge.product`, set by `bridge connect`):
+ * it survives switching to a branch made before the setup was committed, where `.bridge/product.json` is not.
+ */
+export declare const GIT_CONFIG_KEYS: {
+    readonly designSystem: "bridge.designSystem";
+    readonly product: "bridge.product";
+};
+/** The pointer from its JSON text, or why it cannot be read, in plain words. */
+export declare function parseProductPointer(text: string): ProductPointer;
+/**
+ * The connected product repository `dir` is in: the nearest folder at or above it with `.bridge/product.json`. A
+ * folder with its own bridge.config.json met first wins (it is a design system repository, not a product), and so
+ * does the end of the git repository (the folder holding `.git`): there the clone's git config may still keep the link
+ * (GIT_CONFIG_KEYS), else null.
+ */
+export declare function findProductLink(dir: string): Promise<ProductLink | null>;
+/**
+ * Context options for a command run in `dir`. In a connected product repository: the design system repository on
+ * GitHub (`repo`), this checkout (`workTree`) and its product key (`product`). Elsewhere `base` unchanged with `root`.
+ * An explicit `repo` (the MCP server's `--repo`) keeps it, and takes the checkout and product only when the pointer
+ * names that same repository.
+ */
+export declare function linkedOptions(dir: string, base?: Omit<ContextOptions, 'root'> & {
+    root?: string | undefined;
+}): Promise<ContextOptions & {
+    link?: ProductLink;
+}>;