@arii/boomtick-mcp 0.6.2 → 0.7.1

package/.mcp/schemas/repo_logs.json

@@ -43,8 +43,19 @@
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "properties": {
+      "logs": {
+        "anyOf": [
+          {},
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Logs"
+      }
+    },
+    "title": "RepoLogsResponse",
+    "type": "object"
   }
 }

package/.mcp/schemas/repo_multi_exec.json

@@ -0,0 +1,89 @@
+{
+  "name": "repo_multi_exec",
+  "description": "Execute a shell command sequentially across ecosystem repositories (or a filtered subset).",
+  "parameters": {
+    "properties": {
+      "command": {
+        "description": "Shell command to execute sequentially across repositories",
+        "title": "Command",
+        "type": "string"
+      },
+      "repos": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional list of repository names to target",
+        "title": "Repos"
+      },
+      "continueOnError": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": true,
+        "description": "Whether to continue execution if a repo command fails",
+        "title": "Continueonerror"
+      }
+    },
+    "required": [
+      "command"
+    ],
+    "title": "MultiExecInput",
+    "type": "object"
+  },
+  "outputSchema": {
+    "properties": {
+      "status": {
+        "default": "success",
+        "description": "Execution status",
+        "title": "Status",
+        "type": "string"
+      },
+      "total": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Total repositories executed against",
+        "title": "Total"
+      },
+      "results": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Execution results per repository",
+        "title": "Results"
+      }
+    },
+    "title": "MultiExecResponse",
+    "type": "object"
+  }
+}

package/.mcp/schemas/repo_read_agent_context.json

@@ -1,14 +1,126 @@
 {
   "name": "repo_read_agent_context",
-  "description": "Read the full repository index including file tree, CLI schema, and MCP tools.",
+  "description": "Read the repository index including metadata, model review chains, or multi-repo ecosystem status.",
   "parameters": {
-    "properties": {},
+    "properties": {
+      "path": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Local filesystem path to target repository root",
+        "title": "Path"
+      },
+      "repoPath": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Alias for path (filesystem path to target workspace repository root).",
+        "title": "Repopath"
+      },
+      "repo": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Target GitHub repository string (e.g. org/repo).",
+        "title": "Repo"
+      },
+      "repos": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "List of repository names to fetch context for",
+        "title": "Repos"
+      },
+      "all": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Whether to fetch context across all discovered ecosystem repositories",
+        "title": "All"
+      }
+    },
     "title": "ReadAgentContextInput",
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "properties": {
+      "status": {
+        "default": "success",
+        "title": "Status",
+        "type": "string"
+      },
+      "packageName": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Packagename"
+      },
+      "gitCommit": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Gitcommit"
+      },
+      "config": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Config"
+      }
+    },
+    "title": "ReadAgentContextResponse",
+    "type": "object"
   }
 }

package/.mcp/schemas/repo_read_ci_logs.json

@@ -36,8 +36,51 @@
     "type": "object"
   },
   "outputSchema": {
-    "type": "object",
-    "properties": {},
-    "additionalProperties": true
+    "properties": {
+      "checks": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Checks"
+      },
+      "failedChecks": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Failedchecks"
+      },
+      "logs": {
+        "anyOf": [
+          {},
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Logs"
+      }
+    },
+    "title": "ReadCiLogsResponse",
+    "type": "object"
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.7.1](https://github.com/arii/boomtick/compare/mcp-v0.7.0...mcp-v0.7.1) (2026-10-29)
+
+
+### Bug Fixes
+
+* **mcp:** resolve ecosystem_repos without requiring local path existence during isolated test runs ([53ab66a](https://github.com/arii/boomtick/commit/53ab66ab6503c93ff07bfd4e525a5f490df16386))
+* **mcp:** resolve target workspace dynamically in repo.create_branch and worktree tools ([#990](https://github.com/arii/boomtick/issues/990)) ([cd2f34e](https://github.com/arii/boomtick/commit/cd2f34ea8607f037b855d41f899bf5152dc13c1f))
+
+## [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)
 
 

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",

package/dist/config/dynamic.js

@@ -1,11 +1,12 @@
 import { execSync } from "child_process";
+import { findRepoRoot } from "./repo.js";
 let cachedDynamicConfig = null;
-export function initializeConfig() {
+export function initializeConfig(targetCwd) {
     if (cachedDynamicConfig !== null) {
         return cachedDynamicConfig;
     }
     try {
-        const cwd = process.env.BOOMTICK_REPO_PATH || process.cwd();
+        const cwd = findRepoRoot(targetCwd);
         const cmd = `td config view`;
         const output = execSync(cmd, {
             cwd,

package/dist/config/repo.js

@@ -2,11 +2,8 @@ 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();
+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")) ||
@@ -15,6 +12,9 @@ export function findRepoRoot() {
         }
         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")) ||

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/lib/git.js

@@ -2,6 +2,7 @@ import { runCommand } from "./shell.js";
 import { config } from "../config.js";
 import path from "path";
 import fs from "fs/promises";
+import * as syncFs from "fs";
 import { execSync } from "child_process";
 const repoCache = new Map();
 export function resolveRepo(explicitRepo, cwd) {
@@ -31,6 +32,75 @@ export function resolveRepo(explicitRepo, cwd) {
     repoCache.set(targetCwd, fallback);
     return fallback;
 }
+export function resolveRepoPath(options = {}) {
+    // 1. Explicit path parameter has highest precedence
+    if (options.path && options.path.trim().length > 0) {
+        return path.resolve(options.path.trim());
+    }
+    // 2. repoPath alias parameter
+    if (options.repoPath && options.repoPath.trim().length > 0) {
+        return path.resolve(options.repoPath.trim());
+    }
+    // 3. Repository name override (e.g. "arii/tech-dancer" or "tech-dancer")
+    if (options.repo && options.repo.trim().length > 0) {
+        const rawRepo = options.repo.trim();
+        const repoName = rawRepo.includes("/") ? rawRepo.split("/")[1] : rawRepo;
+        // First check project_config.json ecosystem_repos if available
+        let rootPath = process.cwd();
+        try {
+            if (options.cwd && options.cwd.trim().length > 0) {
+                rootPath = options.cwd.trim();
+            }
+            else if (config.repoPath) {
+                rootPath = config.repoPath;
+            }
+        }
+        catch {
+            rootPath = process.cwd();
+        }
+        const projectConfigPath = path.join(rootPath, "project_config.json");
+        if (syncFs.existsSync(projectConfigPath)) {
+            try {
+                const parsed = JSON.parse(syncFs.readFileSync(projectConfigPath, "utf-8"));
+                if (parsed?.ecosystem_repos && typeof parsed.ecosystem_repos === "object") {
+                    for (const [key, relPath] of Object.entries(parsed.ecosystem_repos)) {
+                        const keyRepoName = key.includes("/") ? key.split("/")[1] : key;
+                        if (key === rawRepo || keyRepoName === repoName) {
+                            return path.resolve(rootPath, relPath);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Fallback to directory inspection
+            }
+        }
+        // Check sibling directory relative to cwd or rootPath
+        const candidateDirs = [
+            path.resolve(process.cwd(), "..", repoName),
+            path.resolve(rootPath, "..", repoName),
+        ];
+        for (const cand of candidateDirs) {
+            if (syncFs.existsSync(cand)) {
+                return cand;
+            }
+        }
+    }
+    // 4. Explicit cwd parameter
+    if (options.cwd && options.cwd.trim().length > 0) {
+        return path.resolve(options.cwd.trim());
+    }
+    // 5. Configured repoPath or process.cwd()
+    try {
+        if (config.repoPath && syncFs.existsSync(config.repoPath)) {
+            return config.repoPath;
+        }
+    }
+    catch {
+        // Fall back to process.cwd()
+    }
+    return process.cwd();
+}
 function validatePrNumber(value) {
     const prNumber = Number(value);
     if (!Number.isInteger(prNumber) || prNumber <= 0) {
@@ -38,26 +108,28 @@ function validatePrNumber(value) {
     }
     return prNumber;
 }
-export async function createWorktree(branch, prNumber) {
+export async function createWorktree(branch, prNumber, baseRepoPath) {
     const safePrNumber = validatePrNumber(prNumber);
     const workspaceRoot = "/tmp/boomtick-worktrees";
     // nosemgrep
     const worktreePath = path.join(workspaceRoot, `boomtick-mcp-rescue-${safePrNumber}`);
+    const cwdOption = baseRepoPath ? { cwd: baseRepoPath } : undefined;
     // Clean up if exists
     try {
         await fs.rm(worktreePath, { recursive: true, force: true });
-        await runCommand("git", ["worktree", "prune"]);
+        await runCommand("git", ["worktree", "prune"], cwdOption);
     }
     catch (e) { /* ignore if no previous worktree */ }
-    const result = await runCommand("git", ["worktree", "add", "-b", `repair-pr-${prNumber}-${Date.now()}`, worktreePath, branch]);
+    const result = await runCommand("git", ["worktree", "add", "-b", `repair-pr-${prNumber}-${Date.now()}`, worktreePath, branch], cwdOption);
     if (result.exitCode !== 0) {
         throw new Error(`Failed to create worktree: ${result.stderr}`);
     }
     return worktreePath;
 }
-export async function removeWorktree(worktreePath) {
-    await runCommand("git", ["worktree", "remove", "--force", worktreePath]);
-    await runCommand("git", ["worktree", "prune"]);
+export async function removeWorktree(worktreePath, baseRepoPath) {
+    const cwdOption = baseRepoPath ? { cwd: baseRepoPath } : undefined;
+    await runCommand("git", ["worktree", "remove", "--force", worktreePath], cwdOption);
+    await runCommand("git", ["worktree", "prune"], cwdOption);
 }
 export async function getChangedFiles(base = "main", head = "HEAD", cwd) {
     const result = await runCommand("git", ["diff", "--name-status", "-z", `${base}...${head}`], { cwd });

package/dist/lib/git.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi, beforeEach } from "vitest";
-import { getChangedFiles, getMergeConflictFiles } from "./git.js";
+import { getChangedFiles, getMergeConflictFiles, resolveRepoPath, createWorktree } from "./git.js";
 import * as shell from "./shell.js";
 vi.mock("./shell.js", () => ({
     runCommand: vi.fn(),
@@ -79,4 +79,37 @@ describe("Git Helpers", () => {
             await expect(getMergeConflictFiles("invalid", "feature")).rejects.toThrow("Git merge-tree failed: fatal: not a valid object name");
         });
     });
+    describe("resolveRepoPath", () => {
+        it("should return explicit path when path is provided", () => {
+            const resolved = resolveRepoPath({ path: "/tmp/custom-repo" });
+            expect(resolved).toBe("/tmp/custom-repo");
+        });
+        it("should return explicit repoPath when repoPath is provided", () => {
+            const resolved = resolveRepoPath({ repoPath: "/tmp/another-repo" });
+            expect(resolved).toBe("/tmp/another-repo");
+        });
+        it("should resolve repo path via ecosystem_repos when repo is given", () => {
+            const resolved = resolveRepoPath({ repo: "arii/tech-dancer" });
+            expect(resolved).toContain("tech-dancer");
+        });
+        it("should fall back to current working directory when empty", () => {
+            const resolved = resolveRepoPath({});
+            expect(typeof resolved).toBe("string");
+            expect(resolved.length).toBeGreaterThan(0);
+        });
+    });
+    describe("createWorktree", () => {
+        it("should pass baseRepoPath cwd to runCommand when provided", async () => {
+            vi.mocked(shell.runCommand).mockResolvedValue({
+                exitCode: 0,
+                stdout: "",
+                stderr: "",
+                durationMs: 5,
+                command: "git",
+            });
+            const worktree = await createWorktree("origin/feature", 123, "/home/ari/tech-dancer");
+            expect(worktree).toContain("boomtick-mcp-rescue-123");
+            expect(shell.runCommand).toHaveBeenCalledWith("git", expect.arrayContaining(["worktree", "add"]), { cwd: "/home/ari/tech-dancer" });
+        });
+    });
 });