@arii/boomtick-mcp 0.6.0 → 0.6.2

package/.mcp/schemas/github_search_open_prs.json

@@ -63,8 +63,135 @@
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "$defs": {
+      "PRSummary": {
+        "properties": {
+          "number": {
+            "title": "Number",
+            "type": "integer"
+          },
+          "title": {
+            "title": "Title",
+            "type": "string"
+          },
+          "author": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "title": "Author",
+            "type": "object"
+          },
+          "headRefName": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Headrefname"
+          },
+          "baseRefName": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Baserefname"
+          },
+          "isDraft": {
+            "default": false,
+            "title": "Isdraft",
+            "type": "boolean"
+          },
+          "mergeStateStatus": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Mergestatestatus"
+          },
+          "updatedAt": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Updatedat"
+          },
+          "url": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Url"
+          }
+        },
+        "required": [
+          "number",
+          "title"
+        ],
+        "title": "PRSummary",
+        "type": "object"
+      }
+    },
+    "properties": {
+      "status": {
+        "default": "success",
+        "title": "Status",
+        "type": "string"
+      },
+      "message": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Message"
+      },
+      "data": {
+        "anyOf": [
+          {},
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Data"
+      },
+      "prs": {
+        "items": {
+          "$ref": "#/$defs/PRSummary"
+        },
+        "title": "Prs",
+        "type": "array"
+      }
+    },
+    "title": "SearchPRsResponse",
+    "type": "object"
   }
 }

package/.mcp/schemas/repo.check_jules_status.json

@@ -0,0 +1,38 @@
+{
+  "name": "repo.check_jules_status",
+  "description": "Check or poll the status of a Jules remediation session and verify its branch or PR status.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "sessionId": {
+        "type": "string",
+        "description": "The unique ID or task ID of the Jules session."
+      },
+      "commitSha": {
+        "type": "string",
+        "description": "Commit SHA for idempotency key verification."
+      },
+      "failureLog": {
+        "type": "string",
+        "description": "Failure log content for idempotency key calculation."
+      },
+      "poll": {
+        "type": "boolean",
+        "description": "Whether to poll until session completion or timeout."
+      },
+      "timeoutMs": {
+        "type": "integer",
+        "description": "Timeout in milliseconds when polling."
+      },
+      "intervalMs": {
+        "type": "integer",
+        "description": "Polling interval in milliseconds."
+      }
+    }
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {},
+    "additionalProperties": true
+  }
+}

package/.mcp/schemas/repo.run_tests.json

@@ -43,8 +43,36 @@
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "properties": {
+      "passed": {
+        "title": "Passed",
+        "type": "boolean"
+      },
+      "exitCode": {
+        "title": "Exitcode",
+        "type": "integer"
+      },
+      "failedTests": {
+        "items": {
+          "type": "string"
+        },
+        "title": "Failedtests",
+        "type": "array"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        "title": "Results",
+        "type": "array"
+      }
+    },
+    "required": [
+      "passed",
+      "exitCode"
+    ],
+    "title": "RunTestsResponse",
+    "type": "object"
   }
 }

package/.mcp/schemas/repo_check_jules_status.json

@@ -0,0 +1,38 @@
+{
+  "name": "repo_check_jules_status",
+  "description": "Check or poll the status of a Jules remediation session and verify its branch or PR status.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "sessionId": {
+        "type": "string",
+        "description": "The unique ID or task ID of the Jules session."
+      },
+      "commitSha": {
+        "type": "string",
+        "description": "Commit SHA for idempotency key verification."
+      },
+      "failureLog": {
+        "type": "string",
+        "description": "Failure log content for idempotency key calculation."
+      },
+      "poll": {
+        "type": "boolean",
+        "description": "Whether to poll until session completion or timeout."
+      },
+      "timeoutMs": {
+        "type": "integer",
+        "description": "Timeout in milliseconds when polling."
+      },
+      "intervalMs": {
+        "type": "integer",
+        "description": "Polling interval in milliseconds."
+      }
+    }
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {},
+    "additionalProperties": true
+  }
+}

package/.mcp/schemas/repo_run_tests.json

@@ -43,8 +43,36 @@
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "properties": {
+      "passed": {
+        "title": "Passed",
+        "type": "boolean"
+      },
+      "exitCode": {
+        "title": "Exitcode",
+        "type": "integer"
+      },
+      "failedTests": {
+        "items": {
+          "type": "string"
+        },
+        "title": "Failedtests",
+        "type": "array"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        "title": "Results",
+        "type": "array"
+      }
+    },
+    "required": [
+      "passed",
+      "exitCode"
+    ],
+    "title": "RunTestsResponse",
+    "type": "object"
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.6.2](https://github.com/arii/boomtick/compare/mcp-v0.6.1...mcp-v0.6.2) (2026-10-28)
+
+
+### Bug Fixes
+
+* **ci:** fix release pipeline schema generation and issue quality check on automated alerts [skip-scope-check] ([#956](https://github.com/arii/boomtick/issues/956)) ([a0e6114](https://github.com/arii/boomtick/commit/a0e6114e33dac799313f36f363de6008477cebfe))
+* **cli:** Eliminate runtime sys.path mutations in schema_gen.py ([#967](https://github.com/arii/boomtick/issues/967)) ([e1654de](https://github.com/arii/boomtick/commit/e1654dec8cf4af0da08d0808ee815e39cb9ab634))
+
+## [0.6.1](https://github.com/arii/boomtick/compare/mcp-v0.6.0...mcp-v0.6.1) (2026-10-23)
+
+
+### Bug Fixes
+
+* **mcp:** mount missing handlers for github_get_pr_reviews, github_get_pr_commits, and repo_get_workflow_runs [skip-scope-check] ([#916](https://github.com/arii/boomtick/issues/916)) ([60a2851](https://github.com/arii/boomtick/commit/60a2851a2f2d5ac8010422796573b7ea20bb6767))
+
 ## [0.6.0](https://github.com/arii/boomtick/compare/mcp-v0.5.0...mcp-v0.6.0) (2026-10-22)
 
 

package/README.md

@@ -75,11 +75,32 @@ BOOMTICK_REPO_PATH=/path/to/repo
 ```
 
 ## Usage
-Run the server via stdio:
+
+### Stdio Transport
+Run the server via stdio (ideal for local CLI workflows and Docker container actions):
 ```bash
 node dist/index.js
 ```
 
+### Streamable HTTP Transport & Remote Networked Access
+For hosted agent harnesses (e.g. Google Gemini Agent endpoints, remote DevAI dashboards) requiring network transport with Bearer token / OAuth 2.1 authentication and RFC 9728 metadata discovery:
+
+```bash
+# Run HTTP entrypoint directly
+node dist/http.js --port 3000 --bearer-token secret123
+
+# Or via CLI binary entrypoint
+boomtick-mcp-http --port 3000 --bearer-token secret123
+
+# Or using environment variables
+MCP_TRANSPORT=http PORT=3000 BOOMTICK_MCP_BEARER_TOKEN=secret123 node dist/index.js
+```
+
+#### Network Endpoints & RFC 9728 Discovery
+- `GET /.well-known/oauth-protected-resource`: OAuth 2.0 / 2.1 Protected Resource Metadata discovery endpoint (RFC 9728).
+- `GET /sse`: Server-Sent Events (SSE) stream endpoint for MCP connections (Protected via Bearer token).
+- `POST /messages?sessionId=...`: MCP client JSON-RPC message posting endpoint (Protected via Bearer token).
+
 ## Release Process
 1. Run tests: `pnpm test`
 2. Run evals: `pnpm run run-evals`

package/actions/run-project-gate/action.yml

@@ -94,7 +94,7 @@ runs:
           if command -v td >/dev/null 2>&1; then
             PYTHONPATH="$CLI_PATH" td schema --generate
           else
-            PYTHONPATH="$CLI_PATH" python3 "$CLI_PATH/dev_tools/schema_gen.py"
+            PYTHONPATH="$CLI_PATH" python3 -m dev_tools.schema_gen
           fi
           npx tsx "$FILTER_PATH/scripts/sync-contracts.ts"
           pnpm --filter "$FILTER_PATH" run sync:mcp-schemas

package/dist/config/dynamic.js

@@ -0,0 +1,33 @@
+import { execSync } from "child_process";
+let cachedDynamicConfig = null;
+export function initializeConfig() {
+    if (cachedDynamicConfig !== null) {
+        return cachedDynamicConfig;
+    }
+    try {
+        const cwd = process.env.BOOMTICK_REPO_PATH || process.cwd();
+        const cmd = `td config view`;
+        const output = execSync(cmd, {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        cachedDynamicConfig = JSON.parse(output);
+        return cachedDynamicConfig;
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        const errorPrefix = `CRITICAL: Failed to load dynamic config from Python CLI. Ensure Python 3 is installed and cli is in your PYTHONPATH. Details: ${message}`;
+        if (process.env.NODE_ENV === "development" || process.env.CI === "true") {
+            throw new Error(errorPrefix);
+        }
+        else {
+            console.warn(errorPrefix);
+        }
+        cachedDynamicConfig = {};
+    }
+    return cachedDynamicConfig;
+}
+export function getCachedDynamicConfig() {
+    return cachedDynamicConfig;
+}

package/dist/config/github.js

@@ -0,0 +1,16 @@
+import { execSync } from "child_process";
+export function getGithubToken() {
+    if (process.env.GITHUB_TOKEN) {
+        return process.env.GITHUB_TOKEN;
+    }
+    try {
+        const token = execSync("gh auth token", { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        if (token) {
+            return token;
+        }
+    }
+    catch {
+        /* ignore to allow fallback */
+    }
+    return undefined;
+}

package/dist/config/repo.js

@@ -0,0 +1,28 @@
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function findRepoRoot() {
+    if (process.env.BOOMTICK_REPO_PATH) {
+        return process.env.BOOMTICK_REPO_PATH;
+    }
+    let current = process.cwd();
+    while (current !== path.parse(current).root) {
+        if (fs.existsSync(path.join(current, "project_config.json")) ||
+            fs.existsSync(path.join(current, "workspace.json")) ||
+            fs.existsSync(path.join(current, ".git"))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    current = __dirname;
+    while (current !== path.parse(current).root) {
+        if (fs.existsSync(path.join(current, "project_config.json")) ||
+            fs.existsSync(path.join(current, "workspace.json")) ||
+            fs.existsSync(path.join(current, ".git"))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return path.resolve(__dirname, "../../../../");
+}

package/dist/config.js

@@ -1,7 +1,9 @@
 import path from "path";
 import fs from "fs";
 import { fileURLToPath } from "url";
-import { execSync } from "child_process";
+import { findRepoRoot } from "./config/repo.js";
+import { getGithubToken } from "./config/github.js";
+import { initializeConfig, getCachedDynamicConfig } from "./config/dynamic.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const envPath = path.resolve(__dirname, "../.env");
 if (fs.existsSync(envPath) && typeof process.loadEnvFile === "function") {
@@ -12,84 +14,13 @@ if (fs.existsSync(envPath) && typeof process.loadEnvFile === "function") {
         // Ignore if already loaded or invalid
     }
 }
-function getGithubToken() {
-    if (process.env.GITHUB_TOKEN) {
-        return process.env.GITHUB_TOKEN;
-    }
-    try {
-        const token = execSync("gh auth token", { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-        if (token) {
-            return token;
-        }
-    }
-    catch (e) { /* ignore to allow fallback */ }
-    return undefined;
-}
-let cachedDynamicConfig = null;
-/**
- * Explicitly initializes dynamic configuration from the Python CLI.
- * Should be called once during server startup.
- */
-export function initializeConfig() {
-    if (cachedDynamicConfig !== null) {
-        return cachedDynamicConfig;
-    }
-    try {
-        // Attempt to load core properties from the Python CLI in the active workspace
-        const cwd = process.env.BOOMTICK_REPO_PATH || process.cwd();
-        const cmd = `td config view`;
-        const output = execSync(cmd, {
-            cwd,
-            encoding: "utf-8",
-            stdio: ["ignore", "pipe", "ignore"]
-        });
-        cachedDynamicConfig = JSON.parse(output);
-        return cachedDynamicConfig;
-    }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        const errorPrefix = `CRITICAL: Failed to load dynamic config from Python CLI. Ensure Python 3 is installed and cli is in your PYTHONPATH. Details: ${message}`;
-        if (process.env.NODE_ENV === "development" || process.env.CI === "true") {
-            throw new Error(errorPrefix);
-        }
-        else {
-            console.warn(errorPrefix);
-        }
-        // Set an empty object to prevent repeated attempts if initialization fails in non-blocking mode
-        cachedDynamicConfig = {};
-    }
-    return cachedDynamicConfig;
-}
-function findRepoRoot() {
-    if (process.env.BOOMTICK_REPO_PATH) {
-        return process.env.BOOMTICK_REPO_PATH;
-    }
-    // Traverse up from process.cwd() to find project_config.json, workspace.json, or .git
-    let current = process.cwd();
-    while (current !== path.parse(current).root) {
-        if (fs.existsSync(path.join(current, "project_config.json")) ||
-            fs.existsSync(path.join(current, "workspace.json")) ||
-            fs.existsSync(path.join(current, ".git"))) {
-            return current;
-        }
-        current = path.dirname(current);
-    }
-    // Fallback to __dirname search if discovery from cwd fails
-    current = __dirname;
-    while (current !== path.parse(current).root) {
-        if (fs.existsSync(path.join(current, "project_config.json")) ||
-            fs.existsSync(path.join(current, "workspace.json")) ||
-            fs.existsSync(path.join(current, ".git"))) {
-            return current;
-        }
-        current = path.dirname(current);
-    }
-    // Fallback to the monolithic relative path if discovery fails
-    return path.resolve(__dirname, "../../../");
-}
+export { initializeConfig };
 export const config = {
-    get githubToken() { return getGithubToken(); },
+    get githubToken() {
+        return getGithubToken();
+    },
     get githubOwner() {
+        const cachedDynamicConfig = getCachedDynamicConfig();
         const repoString = cachedDynamicConfig?.github_repo;
         if (typeof repoString === "string" && repoString.includes("/")) {
             return repoString.split("/")[0];
@@ -103,6 +34,7 @@ export const config = {
         throw new Error("GITHUB_OWNER must be set via environment variable or project_config.json");
     },
     get githubRepo() {
+        const cachedDynamicConfig = getCachedDynamicConfig();
         const repoString = cachedDynamicConfig?.github_repo;
         if (typeof repoString === "string" && repoString.includes("/")) {
             return repoString.split("/")[1];
@@ -119,16 +51,19 @@ export const config = {
         return findRepoRoot();
     },
     get defaultBaseBranch() {
+        const cachedDynamicConfig = getCachedDynamicConfig();
         return process.env.DEFAULT_BASE_BRANCH || cachedDynamicConfig?.base_branch?.split("/").pop() || "main";
     },
     get viteBasePath() {
-        const path = process.env.VITE_BASE_PATH || cachedDynamicConfig?.vite_base_path;
-        if (!path) {
+        const cachedDynamicConfig = getCachedDynamicConfig();
+        const pathValue = process.env.VITE_BASE_PATH || cachedDynamicConfig?.vite_base_path;
+        if (!pathValue) {
             throw new Error("VITE_BASE_PATH must be set via environment variable or project_config.json");
         }
-        return path;
+        return pathValue;
     },
     get ghPath() {
+        const cachedDynamicConfig = getCachedDynamicConfig();
         return process.env.GH_PATH || cachedDynamicConfig?.gh_path || "gh";
-    }
+    },
 };

package/dist/http.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { BoomtickMCPServer } from "./mcp/server.js";
+import { initializeConfig } from "./config.js";
+initializeConfig();
+process.env.MCP_TRANSPORT = "http";
+const server = new BoomtickMCPServer();
+server.run().catch((error) => {
+    console.error("Fatal error running HTTP server:", error);
+    process.exit(1);
+});