@weareikko/code-review 0.9.6 → 0.9.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.d.ts CHANGED
@@ -1,10 +1,10 @@
1
1
  import type { Config } from './config.js';
2
2
  import { type DiagnosticContext } from './diagnostics.js';
3
- import type { ReviewUsage } from './gitlab-review.js';
3
+ import type { McpServerUsage, ReviewUsage, SkillUsage } from './gitlab-review.js';
4
4
  import type { OtelBridge } from './otel.js';
5
5
  import { type ScmResponseInfo } from './platform.js';
6
6
  import type { SummaryResult } from './posting.js';
7
- import { type SkillLinkContext, type SkillRef } from './skill-links.js';
7
+ import { type SkillLinkContext } from './skill-links.js';
8
8
  import type { GeneratedComment, Severity } from './types.js';
9
9
  export type { DiagnosticContext, DiagnosticError, DiagnosticPhase, DiagnosticUsage, DiagnosticUsageBreakdown, } from './diagnostics.js';
10
10
  export { DIAGNOSTIC_CHANNEL_NAMES, DIAGNOSTIC_CHANNEL_PREFIX, createDiagnosticContext, createDiagnosticRunId, diagnosticChannels, traceDiagnostic, traceDiagnosticPhase, } from './diagnostics.js';
@@ -28,7 +28,17 @@ export declare function run(config: Config, bridges?: RunBridges): Promise<RunRe
28
28
  * with no reachable source (a `file:` path, or an in-repo skill on a run without
29
29
  * CI project coordinates) stay as plain names.
30
30
  */
31
- export declare function formatSkillsFooter(skills: SkillRef[], context?: SkillLinkContext): string | undefined;
31
+ export declare function formatSkillsFooter(skills: SkillUsage[], context?: SkillLinkContext): string | undefined;
32
+ /**
33
+ * The summary footer's MCP line, e.g. `MCP: jira (2 calls), docs (unused),
34
+ * context7 (unavailable)`. A connected server reports how many tool calls the
35
+ * reviewer actually made against it; an unavailable one is flagged as such. The
36
+ * exposed tool list stays in the usage artifact — the footer answers what was
37
+ * used, not what was offered. Each server name links to its source (the repo
38
+ * `.mcp.json` or the marketplace plugin) when one is reachable, the same way
39
+ * `formatSkillsFooter` links skills.
40
+ */
41
+ export declare function formatMcpFooter(servers: McpServerUsage[], context?: SkillLinkContext): string | undefined;
32
42
  export declare function formatUsageLine(usage: ReviewUsage): string;
33
43
  /**
34
44
  * Render the per-model usage breakdown for heterogeneous `full`-depth runs: one
package/dist/cli.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAE5E,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA6E3D,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiBD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAuBD,wBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA6UlF;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAoB1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAW1E;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,YAAY,EAAE,MAAM,eAAe,GAAG,SAAS,EAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAU5C;AAsBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAQnC;AAED,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtE"}
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAE5E,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA6E3D,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiBD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAuBD,wBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkVlF;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAoB1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAW1E;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,YAAY,EAAE,MAAM,eAAe,GAAG,SAAS,EAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAU5C;AAsBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAQnC;AAED,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtE"}
package/dist/cli.js CHANGED
@@ -1,2 +1,2 @@
1
- import { C as createDiagnosticContext, D as traceDiagnosticPhase, E as traceDiagnostic, S as DIAGNOSTIC_CHANNEL_PREFIX, T as diagnosticChannels, a as main, g as startOtelBridge, h as isOtelEnabled, i as formatUsageLine, n as formatPerModelUsage, o as run, r as formatSkillsFooter, s as withHttpStamping, t as countPostedBySeverity, w as createDiagnosticRunId, x as DIAGNOSTIC_CHANNEL_NAMES } from "./cli-D6vNV3kA.js";
2
- export { DIAGNOSTIC_CHANNEL_NAMES, DIAGNOSTIC_CHANNEL_PREFIX, countPostedBySeverity, createDiagnosticContext, createDiagnosticRunId, diagnosticChannels, formatPerModelUsage, formatSkillsFooter, formatUsageLine, isOtelEnabled, main, run, startOtelBridge, traceDiagnostic, traceDiagnosticPhase, withHttpStamping };
1
+ import { A as DIAGNOSTIC_CHANNEL_PREFIX, I as traceDiagnostic, L as traceDiagnosticPhase, M as createDiagnosticContext, N as createDiagnosticRunId, P as diagnosticChannels, _ as startOtelBridge, a as formatUsageLine, c as withHttpStamping, g as isOtelEnabled, i as formatSkillsFooter, k as DIAGNOSTIC_CHANNEL_NAMES, n as formatMcpFooter, o as main, r as formatPerModelUsage, s as run, t as countPostedBySeverity } from "./cli-CgQF5-WG.js";
2
+ export { DIAGNOSTIC_CHANNEL_NAMES, DIAGNOSTIC_CHANNEL_PREFIX, countPostedBySeverity, createDiagnosticContext, createDiagnosticRunId, diagnosticChannels, formatMcpFooter, formatPerModelUsage, formatSkillsFooter, formatUsageLine, isOtelEnabled, main, run, startOtelBridge, traceDiagnostic, traceDiagnosticPhase, withHttpStamping };
package/dist/config.d.ts CHANGED
@@ -3,7 +3,7 @@ import { type PostingMode } from './posting.js';
3
3
  import { type ReviewDepth, type ReviewInputMode, type Severity, type ThinkingLevel } from './types.js';
4
4
  export type GitLabAuthHeader = 'PRIVATE-TOKEN' | 'JOB-TOKEN';
5
5
  /** Source-control backends the reviewer can target. */
6
- export declare const PLATFORMS: readonly ["gitlab", "github"];
6
+ export declare const PLATFORMS: readonly ['gitlab', 'github'];
7
7
  export type Platform = (typeof PLATFORMS)[number];
8
8
  /** Default GitHub server (web) URL, honoring `GITHUB_SERVER_URL` on Enterprise. */
9
9
  export declare const DEFAULT_GITHUB_SERVER_URL = "https://github.com";
@@ -17,7 +17,7 @@ export declare const DEFAULT_GITHUB_SERVER_URL = "https://github.com";
17
17
  * Note: `API_KEY` is reserved. `CODE_REVIEW_API_KEY` was intentionally retired
18
18
  * as the AI provider key and must not be revived as one.
19
19
  */
20
- export declare const RESERVED_ENV_SUFFIXES: readonly ["API_KEY", "BASE_URL", "DECOMPOSE_HINT_LINES", "MAX_DIFF_CHARS", "MAX_TOKENS", "MIN_SEVERITY", "MODEL", "MODEL_POOL", "PLATFORM", "OTEL", "OTEL_CAPTURE_CONTENT", "POSTING_MODE", "POST_SUMMARY", "FORCE_REVIEW", "VERBOSE", "SKILLS", "MARKETPLACES", "REFRESH_SKILLS", "THINKING_LEVEL"];
20
+ export declare const RESERVED_ENV_SUFFIXES: readonly ['API_KEY', 'BASE_URL', 'DECOMPOSE_HINT_LINES', 'MAX_DIFF_CHARS', 'MAX_TOKENS', 'MIN_SEVERITY', 'MODEL', 'MODEL_POOL', 'PLATFORM', 'OTEL', 'OTEL_CAPTURE_CONTENT', 'POSTING_MODE', 'POST_SUMMARY', 'FORCE_REVIEW', 'VERBOSE', 'SKILLS', 'MARKETPLACES', 'REFRESH_SKILLS', 'THINKING_LEVEL', 'MCP', 'DISABLE_MCP', 'MCP_ENV', 'MCP_DISCOVERY'];
21
21
  /**
22
22
  * Optional namespacing shim for provider/infra environment variables.
23
23
  *
@@ -28,8 +28,8 @@ export declare const RESERVED_ENV_SUFFIXES: readonly ["API_KEY", "BASE_URL", "DE
28
28
  * CI-wide variable of the same name.
29
29
  *
30
30
  * This lets credentials and infra vars that `@earendil-works/pi-ai` reads
31
- * (`ANTHROPIC_API_KEY`, `CLOUDFLARE_API_KEY`, `CLOUDFLARE_ACCOUNT_ID`,
32
- * `OLLAMA_HOST`, ambient AWS/Vertex creds, …) — and the GitLab tokens — be
31
+ * (`ANTHROPIC_API_KEY`, `OPENROUTER_API_KEY`, `OLLAMA_HOST`,
32
+ * ambient AWS/Vertex creds, …) — and the GitLab tokens — be
33
33
  * scoped under `CODE_REVIEW_` in shared CI without enumerating pi-ai's
34
34
  * provider list.
35
35
  *
@@ -47,8 +47,8 @@ export declare function applyCodeReviewEnvPrefix(env?: NodeJS.ProcessEnv): NodeJ
47
47
  /**
48
48
  * Default pi-ai's prompt-cache retention to `long` when the caller has not set
49
49
  * it. pi-ai reads `PI_CACHE_RETENTION` from `process.env` at request time; `long`
50
- * asks providers that support it (e.g. OpenAI's `openai-responses` API, including
51
- * via the Cloudflare AI Gateway) to keep the cached system-prompt prefix for up
50
+ * asks providers that support it (e.g. OpenAI's `openai-responses` API) to keep
51
+ * the cached system-prompt prefix for up
52
52
  * to 24h so reviews spaced hours apart still reuse it. It is a safe no-op for
53
53
  * providers/models without long-retention support (e.g. Anthropic), where it
54
54
  * behaves exactly like the default `short`.
@@ -162,6 +162,30 @@ export interface Config {
162
162
  marketplaces: MarketplaceRef[];
163
163
  /** Re-clone `git:` / `git+ssh:` skills, bypassing the on-disk clone cache. */
164
164
  refreshGitSkills: boolean;
165
+ /**
166
+ * `--mcp` / `CODE_REVIEW_MCP` specs (repeatable / comma-separated), in the
167
+ * order given: `file:<path>`, `<marketplace>:<plugin>`, or
168
+ * `<marketplace>:<plugin>/<server>`. See `parseMcpSpec` in `mcp-config.ts`.
169
+ */
170
+ mcp: string[];
171
+ /** MCP server names to drop, applied last over every source (`--disable-mcp` / `CODE_REVIEW_DISABLE_MCP`). */
172
+ disableMcp: string[];
173
+ /**
174
+ * Environment variable names an MCP server definition may read through
175
+ * `${VAR}` expansion (`--mcp-env` / `CODE_REVIEW_MCP_ENV`). Empty by default:
176
+ * server definitions are not always operator-authored, so the reviewer's own
177
+ * secrets are never exposed to them unless named here.
178
+ */
179
+ mcpEnv: string[];
180
+ /**
181
+ * Auto-discover `.mcp.json` files walked from the git root to `cwd` (same
182
+ * walk as skill auto-discovery). Default `false` — those files are content of
183
+ * the repository under review, and connecting a server means running a command
184
+ * or calling a URL the merge request chose. Opt in with `--mcp-discovery` /
185
+ * `CODE_REVIEW_MCP_DISCOVERY=true`, and only for repositories whose
186
+ * contributors you trust.
187
+ */
188
+ mcpDiscovery: boolean;
165
189
  }
166
190
  export type ParsedArgs = Record<string, string | boolean | string[]>;
167
191
  export declare function parseArgs(argv: string[]): ParsedArgs;
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { type TracingChannel } from 'node:diagnostics_channel';
1
+ import { tracingChannel, type TracingChannel } from 'node:diagnostics_channel';
2
2
  import type { Config } from './config.js';
3
3
  import type { Severity } from './types.js';
4
4
  export type DiagnosticPhase = 'run' | 'scm.get_merge_request' | 'scm.get_latest_version' | 'git.prepare_history' | 'git.get_merge_diff' | 'git.get_commit_log' | 'reviewer.run' | 'review.parse' | 'scm.get_discussions' | 'comments.build' | 'artifact.write_output' | 'scm.post_comments' | 'scm.upsert_summary';
@@ -32,10 +32,35 @@ export interface DiagnosticUsageBreakdown {
32
32
  cacheWrite: number;
33
33
  total: number;
34
34
  }
35
+ /**
36
+ * One MCP server's outcome, as carried on {@link DiagnosticUsage.mcp}. A
37
+ * deliberately minimal subset of `McpServerUsage` (`src/gitlab-review.ts`) —
38
+ * only the fields the OTel bridge needs for the per-server call-count
39
+ * attribute — kept local so `diagnostics.ts` does not depend on the
40
+ * higher-level review module.
41
+ */
42
+ export interface DiagnosticMcpUsage {
43
+ name: string;
44
+ status: 'connected' | 'unavailable';
45
+ calls: number;
46
+ }
47
+ /**
48
+ * One loaded skill's outcome, as carried on {@link DiagnosticUsage.skills}. The
49
+ * same minimal-subset rule as {@link DiagnosticMcpUsage}: just what the OTel
50
+ * bridge needs to report whether the reviewer actually read the skill.
51
+ */
52
+ export interface DiagnosticSkillUsage {
53
+ name: string;
54
+ reads: number;
55
+ }
35
56
  export interface DiagnosticUsage {
36
57
  model: string;
37
58
  tokens: DiagnosticUsageBreakdown;
38
59
  cost: DiagnosticUsageBreakdown;
60
+ /** MCP servers connected for the review, with their call counts. */
61
+ mcp?: DiagnosticMcpUsage[];
62
+ /** Skills loaded for the review, with the number of files read under each. */
63
+ skills?: DiagnosticSkillUsage[];
39
64
  }
40
65
  export interface DiagnosticContext {
41
66
  version: 1;
@@ -125,9 +150,57 @@ export declare const DIAGNOSTIC_CHANNEL_NAMES: {
125
150
  readonly postComments: "@weareikko/code-review:scm.post_comments";
126
151
  readonly upsertSummary: "@weareikko/code-review:scm.upsert_summary";
127
152
  };
128
- export declare const diagnosticChannels: Record<"buildComments" | "getCommitLog" | "getDiscussions" | "getLatestVersion" | "getMergeDiff" | "getMergeRequest" | "parseReview" | "postComments" | "prepareGitHistory" | "run" | "runReviewer" | "upsertSummary" | "writeOutput", TracingChannel<DiagnosticContext, DiagnosticContext>>;
153
+ export declare const diagnosticChannels: Record<keyof typeof DIAGNOSTIC_CHANNEL_NAMES, ReturnType<typeof tracingChannel<DiagnosticContext>>>;
129
154
  export declare function createDiagnosticRunId(): string;
130
155
  export declare function createDiagnosticContext(phase: DiagnosticPhase, config: Config, runId: string, overrides?: Partial<DiagnosticContext>): DiagnosticContext;
131
156
  export declare function traceDiagnostic<T>(channel: TracingChannel<DiagnosticContext>, context: DiagnosticContext, operation: (context: DiagnosticContext) => Promise<T>, secretValues?: readonly string[]): Promise<T>;
132
157
  export declare function traceDiagnosticPhase<T>(phase: DiagnosticPhase, config: Config, runId: string, operation: (context: DiagnosticContext) => Promise<T>, overrides?: Partial<DiagnosticContext>): Promise<T>;
158
+ /** One MCP bridge operation traced independently of the phase channels above. */
159
+ export type McpDiagnosticOp = 'mcp.connect' | 'mcp.tools' | 'mcp.call';
160
+ /**
161
+ * Safe payload for an MCP connect/list-tools/call-tool operation. Deliberately
162
+ * excludes tool arguments and results — only the server/tool identity and
163
+ * result size (`resultChars`, already capped and never the content itself)
164
+ * are carried, matching the no-secrets/no-content rule the phase channels
165
+ * follow for GitLab tokens and API keys.
166
+ */
167
+ export interface McpDiagnosticContext {
168
+ version: 1;
169
+ runId: string;
170
+ op: McpDiagnosticOp;
171
+ /** Configured MCP server name. */
172
+ server: string;
173
+ /** Tool name; set on `mcp.call` only. */
174
+ tool?: string;
175
+ startedAt: string;
176
+ completedAt?: string;
177
+ durationMs?: number;
178
+ /** Number of read-only tools exposed; set on `mcp.tools` only. */
179
+ toolCount?: number;
180
+ /** Characters returned to the agent, after truncation; set on `mcp.call` only. */
181
+ resultChars?: number;
182
+ errorInfo?: DiagnosticError;
183
+ }
184
+ export declare const MCP_DIAGNOSTIC_CHANNEL_NAMES: {
185
+ readonly connect: "@weareikko/code-review:mcp.connect";
186
+ readonly tools: "@weareikko/code-review:mcp.tools";
187
+ readonly call: "@weareikko/code-review:mcp.call";
188
+ };
189
+ export declare const mcpDiagnosticChannels: Record<keyof typeof MCP_DIAGNOSTIC_CHANNEL_NAMES, ReturnType<typeof tracingChannel<McpDiagnosticContext>>>;
190
+ /**
191
+ * Traces one MCP bridge operation on its own `mcp.connect` / `mcp.tools` /
192
+ * `mcp.call` channel. Mirrors {@link traceDiagnosticPhase} (context built,
193
+ * `tracePromise`d, `durationMs`/`completedAt` stamped, errors sanitized) but
194
+ * is keyed by `runId` + server name instead of a `Config`, since the MCP
195
+ * bridge (`src/mcp.ts`) has no `Config` of its own.
196
+ *
197
+ * Node's `tracingChannel.tracePromise` assigns the traced function's return
198
+ * value onto the published context as `.result` — fine for the phase channels
199
+ * above (their payloads are small counts/flags), but `mcp.call`'s return value
200
+ * is the MCP tool's arguments/result content, which must never reach a
201
+ * diagnostics payload. The traced function here always resolves to
202
+ * `undefined`; the operation's real result is captured in a closure and
203
+ * returned to the caller separately, after tracing completes.
204
+ */
205
+ export declare function traceMcpDiagnostic<T>(op: McpDiagnosticOp, runId: string, server: string, operation: (context: McpDiagnosticContext) => Promise<T>, overrides?: Partial<McpDiagnosticContext>): Promise<T>;
133
206
  //# sourceMappingURL=diagnostics.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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"}
@@ -2,14 +2,18 @@ import type { AgentEvent, AgentTool } from '@earendil-works/pi-agent-core';
2
2
  import type { AssistantMessage, Model } from '@earendil-works/pi-ai';
3
3
  import { streamSimple } from '@earendil-works/pi-ai/compat';
4
4
  import type { Config } from './config.js';
5
+ import { type ReviewIntent } from './intent.js';
5
6
  import type { Logger } from './logger.js';
6
7
  import type { MarketplaceRef } from './marketplaces.js';
8
+ import { type McpServerConfig, type McpServerSource } from './mcp-config.js';
9
+ import { type ConnectMcpServersOptions, type McpConnection, type McpServerStatus } from './mcp.js';
7
10
  import type { PriorThread } from './prior-threads.js';
8
11
  import type { SkillRef } from './skill-links.js';
9
12
  import type { Skill } from './skills.js';
10
13
  import { type SkippedDiffFile } from './skipped-retrieval.js';
11
14
  import { type ReviewAngle } from './triage.js';
12
15
  import type { GitLabReviewSeverity, SizeSkippedFile, ThinkingLevel } from './types.js';
16
+ import { type McpResultEntry } from './verify.js';
13
17
  export interface UsageBreakdown {
14
18
  input: number;
15
19
  output: number;
@@ -66,7 +70,9 @@ export interface ReviewUsage {
66
70
  */
67
71
  byModel?: ModelUsage[];
68
72
  /** Skills the reviewer loaded, with the origin each was loaded from. */
69
- skills: SkillRef[];
73
+ skills: SkillUsage[];
74
+ /** MCP servers connected for this review, with their exposed tools and call counts. */
75
+ mcp: McpServerUsage[];
70
76
  /**
71
77
  * Size signals for surfacing in the MR summary. `sizeSkippedFiles` lists files
72
78
  * dropped for the char budget; `decomposeHint` is set when the reviewed diff is
@@ -74,6 +80,24 @@ export interface ReviewUsage {
74
80
  */
75
81
  sizeNotice: ReviewSizeNotice;
76
82
  }
83
+ /** One loaded skill's outcome for a review, as reported in {@link ReviewUsage}. */
84
+ export interface SkillUsage extends SkillRef {
85
+ /**
86
+ * Files the reviewer read under the skill's directory — its `SKILL.md` or a
87
+ * reference file it points at. Zero means the skill was offered but never read.
88
+ */
89
+ reads: number;
90
+ }
91
+ /** One MCP server's outcome for a review, as reported in {@link ReviewUsage}. */
92
+ export interface McpServerUsage {
93
+ name: string;
94
+ status: 'connected' | 'unavailable';
95
+ /** Names of the tools exposed to the reviewer (read-only only — see `isReadOnlyMcpTool`). */
96
+ exposedTools: string[];
97
+ /** Tool calls made against this server during the review. */
98
+ calls: number;
99
+ source: McpServerSource;
100
+ }
77
101
  export interface AgentLike {
78
102
  subscribe(listener: (event: AgentEvent) => void | Promise<void>): () => void;
79
103
  prompt(input: string): Promise<void>;
@@ -136,6 +160,21 @@ export interface RunReviewOptions {
136
160
  * after it (incremental review); when absent, the whole history is in scope.
137
161
  */
138
162
  sinceRef?: string;
163
+ /**
164
+ * Supported library extension point: override how resolved MCP server configs
165
+ * are connected. Defaults to `connectMcpServers`. A caller (or a test) can
166
+ * substitute its own connection — e.g. an in-memory transport with a canned
167
+ * tool list — without touching how MCP server configs are resolved from the
168
+ * repo/marketplace/file sources. See `docs/mcp.md`.
169
+ */
170
+ connectMcp?: (configs: readonly McpServerConfig[], options: ConnectMcpServersOptions) => Promise<McpConnection>;
171
+ /**
172
+ * The enclosing review's diagnostic run id (from `createDiagnosticRunId()` in
173
+ * `cli.ts`). Forwarded to `connectMcpServers` so MCP connect/list-tools/call
174
+ * are traced on the same run as the rest of the review's diagnostics/OTel
175
+ * data; omitted means no MCP diagnostics events are published.
176
+ */
177
+ runId?: string;
139
178
  }
140
179
  interface ContextFile {
141
180
  path: string;
@@ -151,12 +190,11 @@ interface ReviewContext {
151
190
  *
152
191
  * pi-ai >=0.82 requires an explicit stream function (earlier versions built one
153
192
  * internally from model + getApiKey); `streamSimple` is the drop-in. Critically,
154
- * 0.83 also moved cloudflare-ai-gateway base-URL substitution — the
155
- * `{CLOUDFLARE_ACCOUNT_ID}` / `{CLOUDFLARE_GATEWAY_ID}` placeholders — from a
156
- * direct `process.env` read to an explicit `env` on the stream options. Without
157
- * threading `env` through, the gateway URL keeps its literal placeholders and
158
- * every request fails with Cloudflare 401 2035 ("Invalid request path"). Passing
159
- * `env` is harmless for providers whose base URL has no placeholders.
193
+ * 0.83 also moved base-URL placeholder substitution from a direct `process.env`
194
+ * read to an explicit `env` on the stream options. Providers whose base URL
195
+ * contains `{VAR}` placeholders keep them literal — and fail every request —
196
+ * unless `env` is threaded through. Passing `env` is harmless for providers
197
+ * whose base URL has none.
160
198
  *
161
199
  * `stream` is injectable so the env threading can be unit-tested without a live call.
162
200
  */
@@ -200,15 +238,6 @@ export interface FilteredDiff {
200
238
  }
201
239
  export declare function filterDiff(raw: string, maxChars?: number): FilteredDiff;
202
240
  export declare function buildJSONSystemPrompt(context: ReviewContext, minSeverity: GitLabReviewSeverity): string;
203
- /**
204
- * Author-declared intent for the change, sourced from the GitLab MR.
205
- * Both fields are optional and may be empty/whitespace — the renderer degrades
206
- * gracefully and emits no intent block when there is nothing meaningful to show.
207
- */
208
- export interface ReviewIntent {
209
- title?: string;
210
- description?: string | null;
211
- }
212
241
  /**
213
242
  * Build a Find system prompt specialised to one review angle. Used by `full`
214
243
  * depth, which runs one finder per angle. The base prompt (severity/confidence
@@ -222,7 +251,7 @@ export declare function buildUserPrompt(diff: string, skippedFiles?: string[], c
222
251
  totalLines: number;
223
252
  }, retrievableSkipped?: SkippedDiffFile[], omitInlineDiff?: boolean, commitExploration?: {
224
253
  sinceRef?: string;
225
- }): string;
254
+ }, mcpServers?: McpServerStatus[]): string;
226
255
  export declare function extractLastAssistantText(messages: AssistantMessage[]): string;
227
256
  /**
228
257
  * One usable model in the review pool. `id` is the original `provider/modelId`
@@ -270,5 +299,33 @@ export declare function resolveDecomposeHint(threshold: number, reviewedLines: n
270
299
  threshold: number;
271
300
  } | undefined;
272
301
  export declare function runReview(config: Config, options: RunReviewOptions): Promise<ReviewUsage>;
302
+ /** Per-agent capture handles. Tool-call ids are only unique within one agent. */
303
+ export interface McpResultScope {
304
+ start(toolName: string, args: unknown, toolCallId: string): void;
305
+ end(toolName: string, result: unknown, isError: boolean, toolCallId: string): void;
306
+ }
307
+ export interface McpResultCollector {
308
+ /** Results captured so far, oldest first. Read by the Verify stage. */
309
+ entries: McpResultEntry[];
310
+ /**
311
+ * Open a capture scope for one agent. Concurrent agents share the collector
312
+ * but each gets its own pending-call namespace, so two agents that happen to
313
+ * mint the same tool-call id cannot overwrite or delete each other's pending
314
+ * argument summary.
315
+ */
316
+ scope(): McpResultScope;
317
+ }
318
+ /**
319
+ * Collect what the MCP tools returned during Find so the Verify stage can read
320
+ * the same external evidence without calling any tool itself. Only `mcp__*`
321
+ * tools are captured (repo/file reads are already reproducible from the diff),
322
+ * and failed calls are skipped — an error string is not evidence.
323
+ *
324
+ * Identical calls are captured once: at full depth the angle finders share one
325
+ * collector and each resolves the same identifiers from the same intent block,
326
+ * so the same lookup arrives up to one time per angle. Keeping every copy would
327
+ * spend the Verify render budget on duplicates and evict distinct lookups.
328
+ */
329
+ export declare function createMcpResultCollector(): McpResultCollector;
273
330
  export {};
274
331
  //# sourceMappingURL=gitlab-review.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"gitlab-review.d.ts","sourceRoot":"","sources":["../src/gitlab-review.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"gitlab-review.d.ts","sourceRoot":"","sources":["../src/gitlab-review.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Author-declared intent for the change, sourced from the GitLab MR.
3
+ * Both fields are optional and may be empty/whitespace — the renderer degrades
4
+ * gracefully and emits no intent block when there is nothing meaningful to show.
5
+ */
6
+ export interface ReviewIntent {
7
+ title?: string;
8
+ description?: string | null;
9
+ }
10
+ /**
11
+ * Renders the author-declared intent (MR title + description) as a clearly
12
+ * delimited `<intent>` block. Returns an empty string when neither field has
13
+ * meaningful content, so a missing/empty description degrades gracefully.
14
+ * The description is trimmed and length-capped to bound token cost.
15
+ *
16
+ * Lives in its own module because both the Find prompt (`gitlab-review.ts`) and
17
+ * the Verify prompt (`verify.ts`) render it, and `gitlab-review.ts` already
18
+ * imports `verify.ts` — keeping it here avoids an import cycle.
19
+ */
20
+ export declare function renderIntentBlock(intent: ReviewIntent | undefined): string;
21
+ //# sourceMappingURL=intent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAKD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAe1E"}
@@ -1,3 +1,4 @@
1
+ import { type McpEnvVars, type McpServerConfig } from './mcp-parse.js';
1
2
  import { type Skill, type SkillSpec } from './skills.js';
2
3
  /**
3
4
  * Marketplace manifest formats we know how to read. Different vendors ship the
@@ -6,7 +7,7 @@ import { type Skill, type SkillSpec } from './skills.js';
6
7
  * `.codex-plugin/` layout (a future `codex` format). Only `anthropic` is
7
8
  * implemented today; the type is the extension point for the rest.
8
9
  */
9
- export declare const MARKETPLACE_FORMATS: readonly ["anthropic"];
10
+ export declare const MARKETPLACE_FORMATS: readonly ['anthropic'];
10
11
  export type MarketplaceFormat = (typeof MARKETPLACE_FORMATS)[number];
11
12
  /** The default format assumed when a marketplace declaration omits a prefix. */
12
13
  export declare const DEFAULT_MARKETPLACE_FORMAT: MarketplaceFormat;
@@ -59,5 +60,41 @@ export declare function loadMarketplaceSkill(spec: MarketplaceSkillSpec, registr
59
60
  cacheDir?: string;
60
61
  refresh?: boolean;
61
62
  }): Promise<Skill>;
63
+ /**
64
+ * A `<marketplace>:<plugin>[/<server>]` reference — the `marketplace`
65
+ * protocol case of `mcp-config.ts`'s `McpSpec`, restated structurally here so
66
+ * this module does not need to import `mcp-config.ts` (which imports this
67
+ * module for the marketplace source).
68
+ */
69
+ export interface MarketplaceMcpSpec {
70
+ marketplace: string;
71
+ plugin: string;
72
+ /** Empty means "every server the plugin exposes". */
73
+ server: string;
74
+ }
75
+ /**
76
+ * Resolve a `<marketplace>:<plugin>` or `<marketplace>:<plugin>/<server>`
77
+ * reference to its normalised {@link McpServerConfig}s.
78
+ *
79
+ * Clones the marketplace repo (reusing the shared on-disk clone cache), then
80
+ * reads two independent, additive sources for the plugin's servers: a
81
+ * `.mcp.json` colocated with the plugin (either the project or the plugin
82
+ * shape), and the `mcpServers` field of the plugin's own
83
+ * `.claude-plugin/plugin.json` (subject to the same `strict` gating as its
84
+ * `skills` field). A server declared in both is taken from `plugin.json`,
85
+ * since it is the more specific, authored-by-the-plugin declaration.
86
+ * `${CLAUDE_PLUGIN_ROOT}` expands to the plugin's directory in both.
87
+ *
88
+ * With `spec.server` set, only that server is returned. Throws a
89
+ * `ConfigError` with a redacted, actionable hint when the marketplace,
90
+ * plugin, or named server cannot be resolved — the caller treats that as a
91
+ * skip-and-warn, not a fatal error, matching `loadMarketplaceSkill`.
92
+ */
93
+ export declare function loadMarketplaceMcpServers(spec: MarketplaceMcpSpec, registry: MarketplaceRegistry, options?: {
94
+ cacheDir?: string;
95
+ refresh?: boolean;
96
+ vars?: McpEnvVars;
97
+ warn?: (msg: string) => void;
98
+ }): Promise<McpServerConfig[]>;
62
99
  export {};
63
100
  //# sourceMappingURL=marketplaces.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"marketplaces.d.ts","sourceRoot":"","sources":["../src/marketplaces.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,wBAAyB,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,iBAA+B,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAKzD,CAAC;AAEH,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAQtE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA4CnE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,CAW7F;AAuBD,KAAK,oBAAoB,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,KAAK,CAAC,CAiChB"}
1
+ {"version":3,"file":"marketplaces.d.ts","sourceRoot":"","sources":["../src/marketplaces.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,YAAI,WAAW,CAAU,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,iBAA+B,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAKzD,CAAC;AAEH,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAQtE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA4CnE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,CAW7F;AAyBD,KAAK,oBAAoB,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,KAAK,CAAC,CAiChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzB,GACL,OAAO,CAAC,eAAe,EAAE,CAAC,CA0E5B"}
@@ -0,0 +1,90 @@
1
+ import type { Logger } from './logger.js';
2
+ import { type MarketplaceRegistry } from './marketplaces.js';
3
+ import { type McpDisableFilters, type McpEnvVars, type McpServerConfig } from './mcp-parse.js';
4
+ export { applyMcpDisableFilters, dropEmptyHeaders, expandMcpTemplate, extractMcpServerMap, MAX_MCP_TIMEOUT_MS, normalizeMcpServer, parseMcpDisableFilters, parseMcpServers, pickMcpEnvVars, type McpDisableFilters, type McpEnvVars, type McpServerConfig, type McpServerSource, type McpTransportType, type NormalizeMcpServerOptions, } from './mcp-parse.js';
5
+ /** Options for `loadAutoDiscoveredMcpServers`. */
6
+ export interface LoadAutoDiscoveredMcpServersOptions {
7
+ /** Variables for `${VAR}` expansion; defaults to none. */
8
+ vars?: McpEnvVars;
9
+ /** Disable lists to apply; loaded with `loadMcpDisableFilters` when omitted. */
10
+ filters?: McpDisableFilters;
11
+ }
12
+ /**
13
+ * Collect the MCP disable lists declared in the repository: `.claude/settings.json`
14
+ * and the gitignored project-local `.claude/settings.local.json` — where Claude
15
+ * Code persists `disabledMcpjsonServers` when a developer declines a server —
16
+ * in every directory from `gitRoot` down to `cwd`. Lists from every level and
17
+ * both files are unioned. Enable keys are ignored: this tool never re-enables a
18
+ * server another config disabled.
19
+ */
20
+ export declare function loadMcpDisableFilters(cwd: string, gitRoot: string, warn?: (msg: string) => void): Promise<McpDisableFilters>;
21
+ /**
22
+ * Discover MCP servers declared in the repository, mirroring
23
+ * `loadAutoDiscoveredSkills`: `.mcp.json` in every directory from `gitRoot` down
24
+ * to `cwd`, the closest directory winning per server name.
25
+ *
26
+ * `disabledMcpjsonServers` is scoped to these project-declared servers and
27
+ * applied here. `disabledMcpServers` is *not* scoped to them — it names a server
28
+ * whatever its source — so `resolveMcpServers` applies it once at the end, over
29
+ * marketplace and `file:` servers too.
30
+ */
31
+ export declare function loadAutoDiscoveredMcpServers(cwd: string, gitRoot: string, warn?: (msg: string) => void, options?: LoadAutoDiscoveredMcpServersOptions): Promise<McpServerConfig[]>;
32
+ /** A parsed `--mcp` spec. Produced by `parseMcpSpec`. */
33
+ export type McpSpec = {
34
+ protocol: 'file';
35
+ path: string;
36
+ } | {
37
+ protocol: 'marketplace';
38
+ marketplace: string;
39
+ plugin: string;
40
+ server: string;
41
+ };
42
+ /**
43
+ * Parse a `--mcp` / `CODE_REVIEW_MCP` spec string, mirroring `parseSkillSpec`'s
44
+ * conventions:
45
+ *
46
+ * | Input | Result |
47
+ * |---------------------------------|------------------------------------------------------------------|
48
+ * | `file:./extra-servers.json` | `{ protocol: 'file', path: './extra-servers.json' }` |
49
+ * | `acme:dev` | `{ protocol: 'marketplace', marketplace: 'acme', plugin: 'dev', server: '' }` |
50
+ * | `acme:dev/context7` | `{ protocol: 'marketplace', marketplace: 'acme', plugin: 'dev', server: 'context7' }` |
51
+ *
52
+ * An empty `server` means "every server the plugin exposes". Throws a
53
+ * `ConfigError` with an actionable hint on any malformed input.
54
+ */
55
+ export declare function parseMcpSpec(spec: string): McpSpec;
56
+ /** The slice of `Config` `resolveMcpServers` needs — kept structural to avoid importing `Config`. */
57
+ export interface McpServerSourcesConfig {
58
+ /** Raw `--mcp` / `CODE_REVIEW_MCP` specs, in the order given. */
59
+ mcp: string[];
60
+ /** Server names to drop, applied last over every source. */
61
+ disableMcp: string[];
62
+ /** Whether to auto-discover `.mcp.json` files walked from `gitRoot` to `cwd`. Opt-in. */
63
+ mcpDiscovery: boolean;
64
+ }
65
+ /**
66
+ * Resolve every MCP server for a review, merging sources in the approved order:
67
+ *
68
+ * 1. Repo auto-discovery (`.mcp.json` walked from `gitRoot` to `cwd`, closest
69
+ * wins, `disabledMcpjsonServers` applied) — only when `config.mcpDiscovery`
70
+ * is `true`, which is opt-in: `.mcp.json` is content of the repository under
71
+ * review, so a merge request could otherwise make the reviewer spawn a
72
+ * process of its choosing on the CI runner.
73
+ * 2. Every `--mcp` / `CODE_REVIEW_MCP` spec, in the order given: a `file:` spec
74
+ * loads a standalone document, a `<marketplace>:<plugin>[/<server>]` spec
75
+ * loads from the registered marketplace. A later spec's server overrides an
76
+ * earlier one (from any source) of the same name.
77
+ * 3. `disabledMcpServers` from `.claude/settings.json` (and `settings.local.json`)
78
+ * plus `config.disableMcp` (`--disable-mcp` / `CODE_REVIEW_DISABLE_MCP`),
79
+ * applied last over every source above — a name disabled there stays dropped
80
+ * even when a `--mcp` spec redeclares it.
81
+ *
82
+ * A spec that fails to resolve (bad file, unregistered marketplace, unknown
83
+ * plugin/server) is skipped with a warning — one broken `--mcp` entry must not
84
+ * abort the whole review.
85
+ */
86
+ export declare function resolveMcpServers(config: McpServerSourcesConfig, cwd: string, gitRoot: string, registry: MarketplaceRegistry, logger?: Logger, options?: {
87
+ vars?: McpEnvVars;
88
+ refresh?: boolean;
89
+ }): Promise<McpServerConfig[]>;
90
+ //# sourceMappingURL=mcp-config.d.ts.map