@almightygpt/core 0.8.1 → 0.9.0

package/dist/index.d.ts

@@ -12,7 +12,8 @@
  *   - review/     ✅ task #11 diff review pipeline (with #12/#13/#14 wiring)
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
-export declare const VERSION = "0.8.1";
+export declare const VERSION = "0.9.0";
+export { startMcpServer } from "./mcp/server.js";
 export { checkGitStatus, assertSafeToWrite, GitStatusDirtyError, type GitStatusCheck, } from "./git/status.js";
 export { installTemplate, hasExistingConfig, type InstallOptions, type InstallResult, } from "./templates/install.js";
 export { loadConfig, ConfigError } from "./config/load.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -12,7 +12,9 @@
  *   - review/     ✅ task #11 diff review pipeline (with #12/#13/#14 wiring)
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
-export const VERSION = "0.8.1";
+export const VERSION = "0.9.0";
+// MCP server (v0.9.0+) — exposes AlmightyGPT's review surface as MCP tools.
+export { startMcpServer } from "./mcp/server.js";
 // Git safety primitives
 export { checkGitStatus, assertSafeToWrite, GitStatusDirtyError, } from "./git/status.js";
 // Template installer

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,GAQd,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAA6C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,GAGf,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,GAGxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAqC,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAO5B,2DAA2D;AAC3D,OAAO,EACL,aAAa,EACb,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAyB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAEhC,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,GAQd,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAA6C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,GAGf,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,GAGxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAqC,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAO5B,2DAA2D;AAC3D,OAAO,EACL,aAAa,EACb,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAyB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AlmightyGPT MCP server.
+ *
+ * Exposes the AlmightyGPT CLI's review/precommit/auth/runs surface as
+ * Model Context Protocol tools, so MCP-aware clients (Claude Desktop,
+ * Cursor, Continue, etc.) can invoke them directly.
+ *
+ * Transport: stdio (the default for local MCP servers). Spawned from
+ * the user's MCP client config — typically something like:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "almightygpt": {
+ *         "command": "almightygpt",
+ *         "args": ["mcp", "serve"]
+ *       }
+ *     }
+ *   }
+ *
+ * Tool surface (v0.9.0):
+ *   - review_diff:  run a Worker/Reviewer or Reviewer-only review on a diff
+ *   - precommit:    quick last-mile review of uncommitted changes
+ *   - auth_status:  see which providers are configured
+ *   - runs_list:    list recent runs
+ *   - runs_latest:  show the most recent run
+ *
+ * Each tool is a thin wrapper around the existing core functions —
+ * no orchestration logic lives here. The CLI and MCP server are
+ * peer transports for the same underlying capabilities.
+ */
+interface ServeOptions {
+    /** Override the cwd the MCP server treats as the repo root. */
+    cwd?: string;
+}
+/**
+ * Start the AlmightyGPT MCP server on stdio. Blocks for the lifetime
+ * of the process (returns the connect() promise — caller should await
+ * it inside the CLI command handler).
+ */
+export declare function startMcpServer(options?: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAkBH,UAAU,YAAY;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+Q9E"}

package/dist/mcp/server.js

@@ -0,0 +1,317 @@
+/**
+ * AlmightyGPT MCP server.
+ *
+ * Exposes the AlmightyGPT CLI's review/precommit/auth/runs surface as
+ * Model Context Protocol tools, so MCP-aware clients (Claude Desktop,
+ * Cursor, Continue, etc.) can invoke them directly.
+ *
+ * Transport: stdio (the default for local MCP servers). Spawned from
+ * the user's MCP client config — typically something like:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "almightygpt": {
+ *         "command": "almightygpt",
+ *         "args": ["mcp", "serve"]
+ *       }
+ *     }
+ *   }
+ *
+ * Tool surface (v0.9.0):
+ *   - review_diff:  run a Worker/Reviewer or Reviewer-only review on a diff
+ *   - precommit:    quick last-mile review of uncommitted changes
+ *   - auth_status:  see which providers are configured
+ *   - runs_list:    list recent runs
+ *   - runs_latest:  show the most recent run
+ *
+ * Each tool is a thin wrapper around the existing core functions —
+ * no orchestration logic lives here. The CLI and MCP server are
+ * peer transports for the same underlying capabilities.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { runDiffReview } from "../review/run-diff-review.js";
+import { runWorkerReviewerReview } from "../review/run-worker-reviewer.js";
+import { listRuns, findLatestRun } from "../runs/list.js";
+import { resolveApiKey } from "../auth/resolver.js";
+import { PROVIDER_ENV_VARS } from "../auth/types.js";
+import { loadConfig } from "../config/load.js";
+const SERVER_NAME = "almightygpt";
+/**
+ * Start the AlmightyGPT MCP server on stdio. Blocks for the lifetime
+ * of the process (returns the connect() promise — caller should await
+ * it inside the CLI command handler).
+ */
+export async function startMcpServer(options = {}) {
+    const repoRoot = options.cwd ?? process.cwd();
+    const server = new Server({
+        name: SERVER_NAME,
+        version: "0.9.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Tool list — what clients see when they introspect the server.
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "review_diff",
+                description: "Run a cross-AI review on a git diff. Use `worker` to enable the " +
+                    "Worker/Reviewer two-role flow, or omit for reviewer-only. Returns " +
+                    "the review markdown plus cost/latency metrics.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        topic: {
+                            type: "string",
+                            description: "Topic slug for the review file path (e.g. 'auth-refactor').",
+                        },
+                        reviewer: {
+                            type: "string",
+                            description: "Reviewer agent name. Falls back to config.defaults.reviewer.",
+                        },
+                        worker: {
+                            type: "string",
+                            description: "Worker agent name. If set, runs the two-role flow.",
+                        },
+                        range: {
+                            type: "string",
+                            description: "Git range like 'HEAD~3..HEAD'. Omit for uncommitted.",
+                        },
+                        force: {
+                            type: "boolean",
+                            description: "Overwrite existing review file. Default false.",
+                        },
+                    },
+                    required: ["topic"],
+                },
+            },
+            {
+                name: "precommit",
+                description: "Quick last-mile review of uncommitted changes using the configured " +
+                    "quick reviewer (Gemini Flash by default). Cheap (~$0.003) and fast. " +
+                    "Returns review markdown + shallow-flag for CI gating.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        topic: {
+                            type: "string",
+                            description: "Topic slug. Defaults to `precommit-<unix-timestamp>` if omitted.",
+                        },
+                        reviewer: {
+                            type: "string",
+                            description: "Override the quick reviewer. Defaults to config.defaults.quickReviewer.",
+                        },
+                        range: {
+                            type: "string",
+                            description: "Git range. Omit for uncommitted changes.",
+                        },
+                    },
+                },
+            },
+            {
+                name: "auth_status",
+                description: "Report which providers (OpenAI, Anthropic, Google) have API keys " +
+                    "configured, and from where (env var vs keychain vs missing).",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "runs_list",
+                description: "List recent AlmightyGPT runs with cost, status, and timestamps.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        limit: {
+                            type: "number",
+                            description: "Max runs to return. Default 10.",
+                        },
+                    },
+                },
+            },
+            {
+                name: "runs_latest",
+                description: "Show the most recent run (path to review file + metrics).",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+        ],
+    }));
+    // Tool dispatcher — routes to the right core function.
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const a = args;
+        try {
+            switch (name) {
+                case "review_diff": {
+                    const topic = String(a["topic"]);
+                    if (!topic)
+                        throw new Error("`topic` is required");
+                    const useWorker = typeof a["worker"] === "string";
+                    if (useWorker) {
+                        const opts = {
+                            repoRoot,
+                            topic,
+                            force: a["force"] === true,
+                        };
+                        if (typeof a["range"] === "string")
+                            opts.range = a["range"];
+                        if (typeof a["worker"] === "string")
+                            opts.worker = a["worker"];
+                        if (typeof a["reviewer"] === "string")
+                            opts.reviewer = a["reviewer"];
+                        const result = await runWorkerReviewerReview(opts);
+                        return formatReviewResult({
+                            reviewPath: result.reviewPath,
+                            tokensIn: result.totals.tokensIn,
+                            tokensOut: result.totals.tokensOut,
+                            costUsd: result.totals.costUsd,
+                            latencyMs: result.totals.latencyMs,
+                            filesReviewed: result.filesReviewed.length,
+                            runFolder: result.runFolder,
+                            worker: result.worker.name,
+                            reviewer: result.reviewer.name,
+                        });
+                    }
+                    const opts = {
+                        repoRoot,
+                        topic,
+                        force: a["force"] === true,
+                    };
+                    if (typeof a["range"] === "string")
+                        opts.range = a["range"];
+                    if (typeof a["reviewer"] === "string")
+                        opts.reviewer = a["reviewer"];
+                    const result = await runDiffReview(opts);
+                    return formatReviewResult({
+                        reviewPath: result.reviewPath,
+                        tokensIn: result.tokensIn,
+                        tokensOut: result.tokensOut,
+                        costUsd: result.costUsd,
+                        latencyMs: result.latencyMs,
+                        filesReviewed: result.filesReviewed.length,
+                        runFolder: result.runFolder,
+                        reviewer: result.reviewer,
+                        shallowWarning: result.shallowWarning,
+                    });
+                }
+                case "precommit": {
+                    const config = await loadConfig(repoRoot);
+                    const reviewer = (typeof a["reviewer"] === "string" && a["reviewer"]) ||
+                        config.defaults.quickReviewer ||
+                        config.defaults.reviewer;
+                    if (!reviewer) {
+                        throw new Error("No quick reviewer configured. Set defaults.quickReviewer in " +
+                            ".almightygpt/config.yaml or pass `reviewer`.");
+                    }
+                    const topic = (typeof a["topic"] === "string" && a["topic"]) ||
+                        `precommit-${Math.floor(Date.now() / 1000)}`;
+                    const opts = {
+                        repoRoot,
+                        topic,
+                        reviewer,
+                        force: true,
+                    };
+                    if (typeof a["range"] === "string")
+                        opts.range = a["range"];
+                    const precommitDir = config.precommitDir;
+                    if (precommitDir)
+                        opts.reviewsDirOverride = precommitDir;
+                    const result = await runDiffReview(opts);
+                    return formatReviewResult({
+                        reviewPath: result.reviewPath,
+                        tokensIn: result.tokensIn,
+                        tokensOut: result.tokensOut,
+                        costUsd: result.costUsd,
+                        latencyMs: result.latencyMs,
+                        filesReviewed: result.filesReviewed.length,
+                        runFolder: result.runFolder,
+                        reviewer,
+                        shallowWarning: result.shallowWarning,
+                    });
+                }
+                case "auth_status": {
+                    const providers = ["openai", "anthropic", "google"];
+                    const rows = await Promise.all(providers.map(async (p) => {
+                        const r = await resolveApiKey(p);
+                        return {
+                            provider: p,
+                            source: r.source,
+                            envVar: r.envVar ?? PROVIDER_ENV_VARS[p][0],
+                            configured: r.source !== "missing",
+                        };
+                    }));
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ providers: rows }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "runs_list": {
+                    const config = await loadConfig(repoRoot);
+                    const limit = typeof a["limit"] === "number" ? a["limit"] : 10;
+                    const result = await listRuns({
+                        repoRoot,
+                        runsDir: config.runsDir,
+                        limit,
+                    });
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify(result, null, 2) },
+                        ],
+                    };
+                }
+                case "runs_latest": {
+                    const config = await loadConfig(repoRoot);
+                    const result = await findLatestRun(repoRoot, config.runsDir);
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify(result ?? null, null, 2) },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: ${message}` }],
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/** Compact summary of a review result for MCP clients. */
+function formatReviewResult(r) {
+    const summary = {
+        reviewPath: r.reviewPath,
+        reviewer: r.reviewer,
+        ...(r.worker ? { worker: r.worker } : {}),
+        metrics: {
+            tokensIn: r.tokensIn,
+            tokensOut: r.tokensOut,
+            costUsd: r.costUsd,
+            latencyMs: r.latencyMs,
+            filesReviewed: r.filesReviewed,
+        },
+        runFolder: r.runFolder,
+        ...(r.shallowWarning ? { shallowWarning: r.shallowWarning } : {}),
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(summary, null, 2) }],
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almightygpt/core",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Core orchestrator, adapters, config, runs, and review logic for AlmightyGPT",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.30.0",
     "@google/generative-ai": "^0.21.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "execa": "^9.3.0",
     "ignore": "^6.0.2",
     "openai": "^4.52.0",

package/src/index.ts

@@ -13,7 +13,10 @@
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
 
-export const VERSION = "0.8.1";
+export const VERSION = "0.9.0";
+
+// MCP server (v0.9.0+) — exposes AlmightyGPT's review surface as MCP tools.
+export { startMcpServer } from "./mcp/server.js";
 
 // Git safety primitives
 export {

package/src/mcp/server.ts

@@ -0,0 +1,361 @@
+/**
+ * AlmightyGPT MCP server.
+ *
+ * Exposes the AlmightyGPT CLI's review/precommit/auth/runs surface as
+ * Model Context Protocol tools, so MCP-aware clients (Claude Desktop,
+ * Cursor, Continue, etc.) can invoke them directly.
+ *
+ * Transport: stdio (the default for local MCP servers). Spawned from
+ * the user's MCP client config — typically something like:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "almightygpt": {
+ *         "command": "almightygpt",
+ *         "args": ["mcp", "serve"]
+ *       }
+ *     }
+ *   }
+ *
+ * Tool surface (v0.9.0):
+ *   - review_diff:  run a Worker/Reviewer or Reviewer-only review on a diff
+ *   - precommit:    quick last-mile review of uncommitted changes
+ *   - auth_status:  see which providers are configured
+ *   - runs_list:    list recent runs
+ *   - runs_latest:  show the most recent run
+ *
+ * Each tool is a thin wrapper around the existing core functions —
+ * no orchestration logic lives here. The CLI and MCP server are
+ * peer transports for the same underlying capabilities.
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import { runDiffReview } from "../review/run-diff-review.js";
+import { runWorkerReviewerReview } from "../review/run-worker-reviewer.js";
+import { listRuns, findLatestRun } from "../runs/list.js";
+import { resolveApiKey } from "../auth/resolver.js";
+import { PROVIDER_ENV_VARS, type ProviderId } from "../auth/types.js";
+import { loadConfig } from "../config/load.js";
+
+const SERVER_NAME = "almightygpt";
+
+interface ServeOptions {
+  /** Override the cwd the MCP server treats as the repo root. */
+  cwd?: string;
+}
+
+/**
+ * Start the AlmightyGPT MCP server on stdio. Blocks for the lifetime
+ * of the process (returns the connect() promise — caller should await
+ * it inside the CLI command handler).
+ */
+export async function startMcpServer(options: ServeOptions = {}): Promise<void> {
+  const repoRoot = options.cwd ?? process.cwd();
+  const server = new Server(
+    {
+      name: SERVER_NAME,
+      version: "0.9.0",
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    },
+  );
+
+  // Tool list — what clients see when they introspect the server.
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+      {
+        name: "review_diff",
+        description:
+          "Run a cross-AI review on a git diff. Use `worker` to enable the " +
+          "Worker/Reviewer two-role flow, or omit for reviewer-only. Returns " +
+          "the review markdown plus cost/latency metrics.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            topic: {
+              type: "string",
+              description:
+                "Topic slug for the review file path (e.g. 'auth-refactor').",
+            },
+            reviewer: {
+              type: "string",
+              description:
+                "Reviewer agent name. Falls back to config.defaults.reviewer.",
+            },
+            worker: {
+              type: "string",
+              description:
+                "Worker agent name. If set, runs the two-role flow.",
+            },
+            range: {
+              type: "string",
+              description: "Git range like 'HEAD~3..HEAD'. Omit for uncommitted.",
+            },
+            force: {
+              type: "boolean",
+              description: "Overwrite existing review file. Default false.",
+            },
+          },
+          required: ["topic"],
+        },
+      },
+      {
+        name: "precommit",
+        description:
+          "Quick last-mile review of uncommitted changes using the configured " +
+          "quick reviewer (Gemini Flash by default). Cheap (~$0.003) and fast. " +
+          "Returns review markdown + shallow-flag for CI gating.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            topic: {
+              type: "string",
+              description:
+                "Topic slug. Defaults to `precommit-<unix-timestamp>` if omitted.",
+            },
+            reviewer: {
+              type: "string",
+              description:
+                "Override the quick reviewer. Defaults to config.defaults.quickReviewer.",
+            },
+            range: {
+              type: "string",
+              description: "Git range. Omit for uncommitted changes.",
+            },
+          },
+        },
+      },
+      {
+        name: "auth_status",
+        description:
+          "Report which providers (OpenAI, Anthropic, Google) have API keys " +
+          "configured, and from where (env var vs keychain vs missing).",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+      {
+        name: "runs_list",
+        description:
+          "List recent AlmightyGPT runs with cost, status, and timestamps.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            limit: {
+              type: "number",
+              description: "Max runs to return. Default 10.",
+            },
+          },
+        },
+      },
+      {
+        name: "runs_latest",
+        description: "Show the most recent run (path to review file + metrics).",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+    ],
+  }));
+
+  // Tool dispatcher — routes to the right core function.
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    const a = args as Record<string, unknown>;
+
+    try {
+      switch (name) {
+        case "review_diff": {
+          const topic = String(a["topic"]);
+          if (!topic) throw new Error("`topic` is required");
+          const useWorker = typeof a["worker"] === "string";
+
+          if (useWorker) {
+            const opts: Parameters<typeof runWorkerReviewerReview>[0] = {
+              repoRoot,
+              topic,
+              force: a["force"] === true,
+            };
+            if (typeof a["range"] === "string") opts.range = a["range"];
+            if (typeof a["worker"] === "string") opts.worker = a["worker"];
+            if (typeof a["reviewer"] === "string") opts.reviewer = a["reviewer"];
+            const result = await runWorkerReviewerReview(opts);
+            return formatReviewResult({
+              reviewPath: result.reviewPath,
+              tokensIn: result.totals.tokensIn,
+              tokensOut: result.totals.tokensOut,
+              costUsd: result.totals.costUsd,
+              latencyMs: result.totals.latencyMs,
+              filesReviewed: result.filesReviewed.length,
+              runFolder: result.runFolder,
+              worker: result.worker.name,
+              reviewer: result.reviewer.name,
+            });
+          }
+
+          const opts: Parameters<typeof runDiffReview>[0] = {
+            repoRoot,
+            topic,
+            force: a["force"] === true,
+          };
+          if (typeof a["range"] === "string") opts.range = a["range"];
+          if (typeof a["reviewer"] === "string") opts.reviewer = a["reviewer"];
+          const result = await runDiffReview(opts);
+          return formatReviewResult({
+            reviewPath: result.reviewPath,
+            tokensIn: result.tokensIn,
+            tokensOut: result.tokensOut,
+            costUsd: result.costUsd,
+            latencyMs: result.latencyMs,
+            filesReviewed: result.filesReviewed.length,
+            runFolder: result.runFolder,
+            reviewer: result.reviewer,
+            shallowWarning: result.shallowWarning,
+          });
+        }
+
+        case "precommit": {
+          const config = await loadConfig(repoRoot);
+          const reviewer =
+            (typeof a["reviewer"] === "string" && a["reviewer"]) ||
+            config.defaults.quickReviewer ||
+            config.defaults.reviewer;
+          if (!reviewer) {
+            throw new Error(
+              "No quick reviewer configured. Set defaults.quickReviewer in " +
+                ".almightygpt/config.yaml or pass `reviewer`.",
+            );
+          }
+          const topic =
+            (typeof a["topic"] === "string" && a["topic"]) ||
+            `precommit-${Math.floor(Date.now() / 1000)}`;
+          const opts: Parameters<typeof runDiffReview>[0] = {
+            repoRoot,
+            topic,
+            reviewer,
+            force: true,
+          };
+          if (typeof a["range"] === "string") opts.range = a["range"];
+          const precommitDir = (config as { precommitDir?: string }).precommitDir;
+          if (precommitDir) opts.reviewsDirOverride = precommitDir;
+
+          const result = await runDiffReview(opts);
+          return formatReviewResult({
+            reviewPath: result.reviewPath,
+            tokensIn: result.tokensIn,
+            tokensOut: result.tokensOut,
+            costUsd: result.costUsd,
+            latencyMs: result.latencyMs,
+            filesReviewed: result.filesReviewed.length,
+            runFolder: result.runFolder,
+            reviewer,
+            shallowWarning: result.shallowWarning,
+          });
+        }
+
+        case "auth_status": {
+          const providers: ProviderId[] = ["openai", "anthropic", "google"];
+          const rows = await Promise.all(
+            providers.map(async (p) => {
+              const r = await resolveApiKey(p);
+              return {
+                provider: p,
+                source: r.source,
+                envVar: r.envVar ?? PROVIDER_ENV_VARS[p][0],
+                configured: r.source !== "missing",
+              };
+            }),
+          );
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({ providers: rows }, null, 2),
+              },
+            ],
+          };
+        }
+
+        case "runs_list": {
+          const config = await loadConfig(repoRoot);
+          const limit = typeof a["limit"] === "number" ? a["limit"] : 10;
+          const result = await listRuns({
+            repoRoot,
+            runsDir: config.runsDir,
+            limit,
+          });
+          return {
+            content: [
+              { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+          };
+        }
+
+        case "runs_latest": {
+          const config = await loadConfig(repoRoot);
+          const result = await findLatestRun(repoRoot, config.runsDir);
+          return {
+            content: [
+              { type: "text", text: JSON.stringify(result ?? null, null, 2) },
+            ],
+          };
+        }
+
+        default:
+          throw new Error(`Unknown tool: ${name}`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return {
+        isError: true,
+        content: [{ type: "text", text: `Error: ${message}` }],
+      };
+    }
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+/** Compact summary of a review result for MCP clients. */
+function formatReviewResult(r: {
+  reviewPath: string;
+  tokensIn: number;
+  tokensOut: number;
+  costUsd: number;
+  latencyMs: number;
+  filesReviewed: number;
+  runFolder: string;
+  worker?: string;
+  reviewer: string;
+  shallowWarning?: string | undefined;
+}) {
+  const summary = {
+    reviewPath: r.reviewPath,
+    reviewer: r.reviewer,
+    ...(r.worker ? { worker: r.worker } : {}),
+    metrics: {
+      tokensIn: r.tokensIn,
+      tokensOut: r.tokensOut,
+      costUsd: r.costUsd,
+      latencyMs: r.latencyMs,
+      filesReviewed: r.filesReviewed,
+    },
+    runFolder: r.runFolder,
+    ...(r.shallowWarning ? { shallowWarning: r.shallowWarning } : {}),
+  };
+  return {
+    content: [{ type: "text", text: JSON.stringify(summary, null, 2) }],
+  };
+}