@arii/boomtick-mcp 0.6.2 → 0.7.1

package/dist/mcp/definitions.js

@@ -1,4 +1,4 @@
-import { HealthCheckInputJsonSchema, SearchPRsInputJsonSchema, SearchPRsResponseJsonSchema, GetPrDiffInputJsonSchema, PrDiffResponseJsonSchema, CheckoutBranchInputJsonSchema, GetMergeConflictFilesInputJsonSchema, GetMergeConflictFilesResponseJsonSchema, GetChangedFilesInputJsonSchema, GetPackageScriptsInputJsonSchema, ReadCiLogsInputJsonSchema, RepoLogsInputJsonSchema, CreateBranchInputJsonSchema, CreateRepairBranchInputJsonSchema, RunTestsInputJsonSchema, RunTestsResponseJsonSchema, CommitPatchInputJsonSchema, OpenReplacementPrInputJsonSchema, CreatePullRequestInputJsonSchema, CommentTriageSummaryInputJsonSchema, GetPrInputJsonSchema, IssueViewInputJsonSchema, IssueUpdateInputJsonSchema, IssueUpdateResponseJsonSchema, IssueCommentInputJsonSchema, CreateIssueInputJsonSchema, CreateIssueResponseJsonSchema, GetCommandSchemaInputJsonSchema, ReadAgentContextInputJsonSchema as ReadAgentContextSchema, CreateJulesSessionInputJsonSchema, JulesSessionIdInputJsonSchema, JulesSendMessageInputJsonSchema, JulesListSessionsInputJsonSchema, GetPrReviewsInputJsonSchema, GetPrCommitsInputJsonSchema, GetWorkflowRunsInputJsonSchema, } from "../tools/contract.js";
+import { HealthCheckInputJsonSchema, HealthCheckResponseJsonSchema, SearchPRsInputJsonSchema, SearchPRsResponseJsonSchema, GetPrDiffInputJsonSchema, PrDiffResponseJsonSchema, CheckoutBranchInputJsonSchema, CheckoutBranchResponseJsonSchema, GetMergeConflictFilesInputJsonSchema, GetMergeConflictFilesResponseJsonSchema, GetChangedFilesInputJsonSchema, GetChangedFilesResponseJsonSchema, GetPackageScriptsInputJsonSchema, GetPackageScriptsResponseJsonSchema, ReadCiLogsInputJsonSchema, ReadCiLogsResponseJsonSchema, RepoLogsInputJsonSchema, RepoLogsResponseJsonSchema, CreateBranchInputJsonSchema, CreateBranchResponseJsonSchema, CreateRepairBranchInputJsonSchema, CreateRepairBranchResponseJsonSchema, CheckJulesStatusResponseJsonSchema, RunTestsInputJsonSchema, RunTestsResponseJsonSchema, CommitPatchInputJsonSchema, CommitPatchResponseJsonSchema, OpenReplacementPrInputJsonSchema, OpenReplacementPrResponseJsonSchema, CreatePullRequestInputJsonSchema, CreatePullRequestResponseJsonSchema, CommentTriageSummaryInputJsonSchema, CommentTriageSummaryResponseJsonSchema, GetPrInputJsonSchema, GetPrResponseJsonSchema, IssueViewInputJsonSchema, IssueViewResponseJsonSchema, IssueUpdateInputJsonSchema, IssueUpdateResponseJsonSchema, IssueCommentInputJsonSchema, IssueCommentResponseJsonSchema, CreateIssueInputJsonSchema, CreateIssueResponseJsonSchema, GetCommandSchemaInputJsonSchema, GetCommandSchemaResponseJsonSchema, ReadAgentContextInputJsonSchema as ReadAgentContextSchema, ReadAgentContextResponseJsonSchema, MultiExecInputJsonSchema, MultiExecResponseJsonSchema, CreateJulesSessionInputJsonSchema, JulesSessionIdInputJsonSchema, JulesSendMessageInputJsonSchema, JulesSendMessageResponseJsonSchema, JulesGetMessagesResponseJsonSchema, JulesListSessionsInputJsonSchema, JulesListSessionsResponseJsonSchema, JulesSessionResponseJsonSchema, JulesGetPrResponseJsonSchema, JulesTriggerFeedbackResponseJsonSchema, GetPrReviewsInputJsonSchema, GetPrReviewsResponseJsonSchema, GetPrCommitsInputJsonSchema, GetPrCommitsResponseJsonSchema, GetWorkflowRunsInputJsonSchema, GetWorkflowRunsResponseJsonSchema, } from "../tools/contract.js";
 export const MCP_PROMPTS = [
     {
         name: "conflict-scout",
@@ -38,12 +38,24 @@ export const MCP_RESOURCES = [
         mimeType: "text/markdown",
         description: "The agent contract specification file (.agents/AGENT_CONTRACT.md).",
     },
+    {
+        uri: "mcp://workspace/project-config",
+        name: "Project Configuration",
+        mimeType: "application/json",
+        description: "The project configuration (project_config.json).",
+    },
     {
         uri: "mcp://git/changed-files",
         name: "Git Changed Files",
         mimeType: "application/json",
         description: "List of changed files in the repository.",
     },
+    {
+        uri: "mcp://git/status",
+        name: "Git Status",
+        mimeType: "application/json",
+        description: "Current working directory git status.",
+    },
     {
         uri: "mcp://ci/latest-run",
         name: "Latest CI Run",
@@ -83,17 +95,12 @@ export const MCP_RESOURCE_TEMPLATES = [
         description: "The validation report for a specific repair branch.",
     },
 ];
-const DEFAULT_OUTPUT_SCHEMA = {
-    type: "object",
-    properties: {},
-    additionalProperties: true,
-};
 const BASE_MCP_TOOLS = [
     {
         name: "boomtick.health",
         description: "Check the health and configuration of the MCP server.",
         inputSchema: HealthCheckInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: HealthCheckResponseJsonSchema,
     },
     {
         name: "github.search_open_prs",
@@ -103,9 +110,15 @@ const BASE_MCP_TOOLS = [
     },
     {
         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.",
         inputSchema: ReadAgentContextSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: ReadAgentContextResponseJsonSchema,
+    },
+    {
+        name: "repo.multi_exec",
+        description: "Execute a shell command sequentially across ecosystem repositories (or a filtered subset).",
+        inputSchema: MultiExecInputJsonSchema,
+        outputSchema: MultiExecResponseJsonSchema,
     },
     {
         name: "github.get_pr_diff",
@@ -117,7 +130,7 @@ const BASE_MCP_TOOLS = [
         name: "github.checkout_branch",
         description: "Checkout a specific branch in the repository or worktree.",
         inputSchema: CheckoutBranchInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CheckoutBranchResponseJsonSchema,
     },
     {
         name: "github.get_merge_conflict_files",
@@ -129,43 +142,43 @@ const BASE_MCP_TOOLS = [
         name: "repo.get_changed_files",
         description: "Get the list of changed files between two refs.",
         inputSchema: GetChangedFilesInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetChangedFilesResponseJsonSchema,
     },
     {
         name: "repo.get_command_schema",
         description: "Retrieve a lightweight, targeted schema for a specific td subcommand. Use this instead of reading the entire cli-schema.json to save tokens.",
         inputSchema: GetCommandSchemaInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetCommandSchemaResponseJsonSchema,
     },
     {
         name: "repo.get_package_scripts",
         description: "Get the scripts defined in package.json.",
         inputSchema: GetPackageScriptsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetPackageScriptsResponseJsonSchema,
     },
     {
         name: "repo.read_ci_logs",
         description: "Read CI logs for a given pull request.",
         inputSchema: ReadCiLogsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: ReadCiLogsResponseJsonSchema,
     },
     {
         name: "repo.logs",
         description: "Stream or grep combined CI logs for all jobs in a pull request.",
         inputSchema: RepoLogsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: RepoLogsResponseJsonSchema,
     },
     {
         name: "repo.create_branch",
         description: "Creates a new clean git branch from a target base branch.",
         inputSchema: CreateBranchInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CreateBranchResponseJsonSchema,
     },
     {
         name: "repo.create_repair_branch",
         description: "Creates a fresh worktree and a new repair branch for an existing PR. This isolates the repair work from the main codebase.",
         inputSchema: CreateRepairBranchInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CreateRepairBranchResponseJsonSchema,
     },
     {
         name: "repo.check_jules_status",
@@ -181,7 +194,7 @@ const BASE_MCP_TOOLS = [
                 intervalMs: { type: "integer", description: "Polling interval in milliseconds." },
             },
         },
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CheckJulesStatusResponseJsonSchema,
     },
     {
         name: "repo.run_tests",
@@ -193,55 +206,55 @@ const BASE_MCP_TOOLS = [
         name: "repo.commit_patch",
         description: "Commit verified repair changes in a worktree.",
         inputSchema: CommitPatchInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CommitPatchResponseJsonSchema,
     },
     {
         name: "github.open_replacement_pr",
         description: "Open a new PR that replaces or repairs the original PR.",
         inputSchema: OpenReplacementPrInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: OpenReplacementPrResponseJsonSchema,
     },
     {
         name: "github.create_pull_request",
         description: "Creates a pull request on GitHub using the MCP server's integrated credentials. Bypasses terminal CLI constraints.",
         inputSchema: CreatePullRequestInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CreatePullRequestResponseJsonSchema,
     },
     {
         name: "github.comment_triage_summary",
         description: "Comment on the original PR with a diagnosis and replacement link.",
         inputSchema: CommentTriageSummaryInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CommentTriageSummaryResponseJsonSchema,
     },
     {
         name: "github.get_pr",
         description: "Get details of a GitHub PR including title, state, and URLs.",
         inputSchema: GetPrInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetPrResponseJsonSchema,
     },
     {
         name: "github.get_pr_reviews",
         description: "Get top-level reviews, verdicts, states, and bodies for a GitHub PR.",
         inputSchema: GetPrReviewsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetPrReviewsResponseJsonSchema,
     },
     {
         name: "github.get_pr_commits",
         description: "List commits and commit metadata (SHAs, authors, messages) for a GitHub PR.",
         inputSchema: GetPrCommitsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetPrCommitsResponseJsonSchema,
     },
     {
         name: "repo.get_workflow_runs",
         description: "List recent GitHub Actions workflow runs for the repository.",
         inputSchema: GetWorkflowRunsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetWorkflowRunsResponseJsonSchema,
     },
     {
         name: "github.issue_view",
         description: "View details of a GitHub issue including title, body, and state.",
         inputSchema: IssueViewInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: IssueViewResponseJsonSchema,
     },
     {
         name: "github.issue_update",
@@ -253,7 +266,7 @@ const BASE_MCP_TOOLS = [
         name: "github.issue_comment",
         description: "Add a new comment to a GitHub issue.",
         inputSchema: IssueCommentInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: IssueCommentResponseJsonSchema,
     },
     {
         name: "github.create_issue",
@@ -265,49 +278,49 @@ const BASE_MCP_TOOLS = [
         name: "jules.create_session",
         description: "Create a Jules session that performs work externally and may generate a GitHub pull request.",
         inputSchema: CreateJulesSessionInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesSessionResponseJsonSchema,
     },
     {
         name: "jules.get_session",
         description: "Get the status and details of a Jules session.",
         inputSchema: JulesSessionIdInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesSessionResponseJsonSchema,
     },
     {
         name: "jules.send_message",
         description: "Send a message to an active Jules session.",
         inputSchema: JulesSendMessageInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesSendMessageResponseJsonSchema,
     },
     {
         name: "jules.get_messages",
         description: "Get the message history of a Jules session.",
         inputSchema: JulesSessionIdInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesGetMessagesResponseJsonSchema,
     },
     {
         name: "jules.list_sessions",
         description: "List all Jules sessions.",
         inputSchema: JulesListSessionsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesListSessionsResponseJsonSchema,
     },
     {
         name: "jules.cancel_session",
         description: "Cancel an ongoing Jules session.",
         inputSchema: JulesSessionIdInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesSessionResponseJsonSchema,
     },
     {
         name: "jules.get_pr",
         description: "Get the generated pull request url associated with an active Jules agent session.",
         inputSchema: JulesSessionIdInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesGetPrResponseJsonSchema,
     },
     {
         name: "jules.trigger_feedback",
         description: "Automatically collect CI status/logs for the PR associated with a Jules session and send them back as feedback.",
         inputSchema: JulesSessionIdInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: JulesTriggerFeedbackResponseJsonSchema,
     },
 ];
 export const MCP_TOOLS = BASE_MCP_TOOLS.flatMap((tool) => {

package/dist/mcp/http.js

@@ -15,6 +15,12 @@ export function createMcpHttpServer(options) {
             return;
         }
         const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+        // Endpoint 0: Health check endpoint for readiness probes / load balancers
+        if (url.pathname === "/health" && req.method === "GET") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", transport: "http" }));
+            return;
+        }
         // Endpoint 1: RFC 9728 OAuth Protected Resource Metadata Discovery
         if (url.pathname === "/.well-known/oauth-protected-resource" && (req.method === "GET" || req.method === "HEAD")) {
             const metadata = {
@@ -60,9 +66,18 @@ export function createMcpHttpServer(options) {
         }
         // Endpoint 2: SSE stream setup
         if (url.pathname === "/sse" && req.method === "GET") {
+            res.setHeader("Cache-Control", "no-cache");
+            res.setHeader("Content-Type", "text/event-stream");
+            res.setHeader("Connection", "keep-alive");
             const transport = new SSEServerTransport("/messages", res);
             transports.set(transport.sessionId, transport);
+            const keepAliveInterval = setInterval(() => {
+                if (!res.writableEnded) {
+                    res.write(": keep-alive\n\n");
+                }
+            }, 15000);
             transport.onclose = () => {
+                clearInterval(keepAliveInterval);
                 transports.delete(transport.sessionId);
             };
             await mcpServer.connect(transport);

package/dist/mcp/http.test.js

@@ -14,6 +14,14 @@ describe("createMcpHttpServer", () => {
             httpServerObj.server.close();
         }
     });
+    it("should respond with 200 on GET /health endpoint", async () => {
+        httpServerObj = createMcpHttpServer({ port: 0, mcpServer });
+        port = await httpServerObj.listen(0);
+        const res = await fetch(`http://localhost:${port}/health`);
+        expect(res.status).toBe(200);
+        const body = await res.json();
+        expect(body).toEqual({ status: "ok", transport: "http" });
+    });
     it("should respond with RFC 9728 OAuth protected resource metadata on /.well-known/oauth-protected-resource", async () => {
         httpServerObj = createMcpHttpServer({ port: 0, mcpServer });
         port = await httpServerObj.listen(0);

package/dist/mcp/server.js

@@ -12,6 +12,7 @@ import { getMergeConflictFilesHandler, GetMergeConflictFilesInputSchema } from "
 import { checkoutBranchHandler, CheckoutBranchInputSchema } from "../tools/github.checkout_branch.js";
 import { getChangedFilesHandler, GetChangedFilesInputSchema } from "../tools/repo.get_changed_files.js";
 import { readAgentContextHandler, ReadAgentContextInputSchema } from "../tools/repo.read_agent_context.js";
+import { multiExecHandler, MultiExecInputSchema } from "../tools/repo.multi_exec.js";
 import { getCommandSchemaHandler, GetCommandSchemaInputSchema } from "../tools/repo.get_command_schema.js";
 import { getPackageScriptsHandler, GetPackageScriptsInputSchema } from "../tools/repo.get_package_scripts.js";
 import { readCiLogsHandler, ReadCiLogsInputSchema } from "../tools/repo.read_ci_logs.js";
@@ -114,6 +115,21 @@ export class BoomtickMCPServer {
                     contents: [{ uri, mimeType: "text/markdown", text: content }],
                 };
             }
+            if (uri === "mcp://workspace/project-config" ||
+                uri === "mcp://workspace/project_config" ||
+                uri === "repo://project-config") {
+                const configPath = path.join(config.repoPath, "project_config.json");
+                let content = "{}";
+                try {
+                    content = await fs.readFile(configPath, "utf-8");
+                }
+                catch {
+                    // Fallback if file doesn't exist
+                }
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: content }],
+                };
+            }
             if (uri === "mcp://git/changed-files" ||
                 uri === "repo://changed-files") {
                 const changedFiles = await getChangedFilesHandler(GetChangedFilesInputSchema.parse({}));
@@ -121,6 +137,21 @@ export class BoomtickMCPServer {
                     contents: [{ uri, mimeType: "application/json", text: JSON.stringify(changedFiles, null, 2) }],
                 };
             }
+            if (uri === "mcp://git/status" ||
+                uri === "repo://git-status" ||
+                uri === "repo://status") {
+                let statusText = "";
+                try {
+                    const res = spawnSync("git", ["status", "--porcelain"], { cwd: config.repoPath, encoding: "utf-8" });
+                    statusText = res.stdout || "";
+                }
+                catch {
+                    // Fallback if git fails
+                }
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: JSON.stringify({ status: statusText.trim() }, null, 2) }],
+                };
+            }
             if (uri === "mcp://ci/latest-run" ||
                 uri === "repo://ci/latest-run" ||
                 uri === "repo://ci-latest-run") {
@@ -178,6 +209,9 @@ export class BoomtickMCPServer {
                     case "repo.read.agent.context":
                     case "repo.read_agent_context":
                         return createSuccessResult(await readAgentContextHandler(ReadAgentContextInputSchema.parse(normArgs)));
+                    case "repo.multi.exec":
+                    case "repo.multi_exec":
+                        return createSuccessResult(await multiExecHandler(MultiExecInputSchema.parse(normArgs)));
                     case "github.get.pr.diff":
                     case "github.get_pr_diff":
                         return createSuccessResult(await getPrDiffHandler(GetPrDiffInputSchema.parse(normArgs)));

package/dist/mcp/server.test.js

@@ -166,6 +166,27 @@ describe("BoomtickMCPServer", () => {
             expect(result.contents[0].mimeType).toBe("application/json");
             expect(JSON.parse(result.contents[0].text)).toEqual({ files: ["src/index.ts"] });
         });
+        it("should handle mcp://workspace/project-config", async () => {
+            const handler = requestHandlers.get("resources/read");
+            vi.mocked(fs.readFile).mockResolvedValue('{"packageName": "boomtick"}');
+            const result = await handler({
+                method: "resources/read",
+                params: { uri: "mcp://workspace/project-config" },
+            });
+            expect(result.contents[0].uri).toBe("mcp://workspace/project-config");
+            expect(result.contents[0].mimeType).toBe("application/json");
+            expect(JSON.parse(result.contents[0].text)).toEqual({ packageName: "boomtick" });
+        });
+        it("should handle mcp://git/status", async () => {
+            const handler = requestHandlers.get("resources/read");
+            const result = await handler({
+                method: "resources/read",
+                params: { uri: "mcp://git/status" },
+            });
+            expect(result.contents[0].uri).toBe("mcp://git/status");
+            expect(result.contents[0].mimeType).toBe("application/json");
+            expect(JSON.parse(result.contents[0].text)).toHaveProperty("status");
+        });
         it("should handle mcp://ci/latest-run", async () => {
             const handler = requestHandlers.get("resources/read");
             vi.spyOn(workflowRunsModule, "getWorkflowRunsHandler").mockResolvedValue({ workflowRuns: [{ id: 1, status: "completed", conclusion: "success" }] });
@@ -193,6 +214,16 @@ describe("BoomtickMCPServer", () => {
             expect(result.tools).toBeDefined();
             expect(Array.isArray(result.tools)).toBe(true);
         });
+        it("should ensure all tools have typed outputSchema and none are empty or untyped DEFAULT_OUTPUT_SCHEMA", async () => {
+            const handler = requestHandlers.get("tools/list");
+            const result = await handler({ method: "tools/list" });
+            for (const tool of result.tools) {
+                expect(tool.outputSchema).toBeDefined();
+                expect(tool.outputSchema.type).toBe("object");
+                expect(tool.outputSchema.properties).toBeDefined();
+                expect(Object.keys(tool.outputSchema.properties).length).toBeGreaterThan(0);
+            }
+        });
     });
     describe("CallTool", () => {
         it("should execute registered tool handler successfully", async () => {