@arii/boomtick-mcp 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.7.0](https://github.com/arii/boomtick/compare/mcp-v0.6.2...mcp-v0.7.0) (2026-10-29)
+
+
+### Features
+
+* **aggregate:** agent onboarding, multi-repo context, and sequential orchestration ([#1001](https://github.com/arii/boomtick/issues/1001)) ([7060777](https://github.com/arii/boomtick/commit/7060777195a84d391b5098226ce06a04ddefcd9a))
+* **aggregate:** pure-node container, review runner hardening, mcp modernization, and offline dag engine ([#1002](https://github.com/arii/boomtick/issues/1002)) ([056503c](https://github.com/arii/boomtick/commit/056503c8c21b5bd99f3b9d874ee7fac25972362a))
+* **mcp:** modernize boomtick-mcp with typed outputSchema, resources interface, and streamable HTTP transport ([26401df](https://github.com/arii/boomtick/commit/26401df06774e9de7756a375e0080810cc35926e))
+
+
+### Bug Fixes
+
+* **mcp:** resolve active repository dynamically across workspaces ([#981](https://github.com/arii/boomtick/issues/981)) ([9a757ea](https://github.com/arii/boomtick/commit/9a757ea5d1a878861e69bee4e36201849f7a03e4))
+
+## [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)
 
 

package/README.md

@@ -41,19 +41,21 @@ A Model Context Protocol (MCP) server designed to empower AI agents with structu
 
 ### Installation
 ```bash
-cd boomtick-mcp
-pnpm install
-pnpm build
+# From repository root
+pnpm --filter @arii/boomtick-mcp run build
+
+# Register boomtick-mcp across installed agent hosts automatically
+td mcp install --execute
 ```
 
-### Installation via MCP Client (e.g. Claude Desktop)
+### Manual Configuration via MCP Client (e.g. Claude Desktop, Cursor)
 Add the following to your MCP client configuration (e.g. `claude_desktop_config.json`):
 ```json
 {
   "mcpServers": {
     "boomtick": {
       "command": "node",
-      "args": ["/absolute/path/to/boomtick-mcp/dist/index.js"],
+      "args": ["/absolute/path/to/mcp/dist/index.js"],
       "env": {
         "GITHUB_TOKEN": "your_pat",
         "GITHUB_OWNER": "your_org",
@@ -75,11 +77,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,34 @@
+import { execSync } from "child_process";
+import { findRepoRoot } from "./repo.js";
+let cachedDynamicConfig = null;
+export function initializeConfig(targetCwd) {
+    if (cachedDynamicConfig !== null) {
+        return cachedDynamicConfig;
+    }
+    try {
+        const cwd = findRepoRoot(targetCwd);
+        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(startDir) {
+    let current = startDir || 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);
+    }
+    if (process.env.BOOMTICK_REPO_PATH) {
+        return process.env.BOOMTICK_REPO_PATH;
+    }
+    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/config.test.js

@@ -19,9 +19,10 @@ describe("config", () => {
             const mockConfig = { github_repo: "owner/repo", base_branch: "origin/main", vite_base_path: "/app/" };
             vi.mocked(execSync).mockReturnValue(JSON.stringify(mockConfig));
             const { initializeConfig } = await import("./config.js");
+            const { findRepoRoot } = await import("./config/repo.js");
             const result = initializeConfig();
             expect(execSync).toHaveBeenCalledWith("td config view", expect.objectContaining({
-                cwd: process.cwd()
+                cwd: findRepoRoot()
             }));
             expect(result).toEqual(mockConfig);
         });
@@ -103,10 +104,16 @@ describe("config", () => {
             expect(() => config.githubOwner).toThrow("GITHUB_OWNER must be set via environment variable or project_config.json");
             expect(() => config.githubRepo).toThrow("GITHUB_REPO must be set via environment variable or project_config.json");
         });
-        it("should resolve repoPath from BOOMTICK_REPO_PATH or findRepoRoot fallback", async () => {
+        it("should resolve active workspace from process.cwd() over BOOMTICK_REPO_PATH when inside a repo", async () => {
             process.env.BOOMTICK_REPO_PATH = "/custom/repo/path";
             const { config } = await import("./config.js");
-            expect(config.repoPath).toBe("/custom/repo/path");
+            expect(config.repoPath).toBe(process.cwd().replace(/\/mcp$/, ""));
+        });
+        it("should fallback to BOOMTICK_REPO_PATH when process.cwd() is outside any repo", async () => {
+            process.env.BOOMTICK_REPO_PATH = "/custom/repo/path";
+            const { findRepoRoot } = await import("./config/repo.js");
+            const rootDir = process.platform === "win32" ? "C:\\" : "/";
+            expect(findRepoRoot(rootDir)).toBe("/custom/repo/path");
         });
         it("should resolve defaultBaseBranch, viteBasePath, and ghPath", async () => {
             process.env.DEFAULT_BASE_BRANCH = "develop";

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);
+});