@arii/boomtick-mcp 0.6.1 → 0.7.0

package/dist/mcp/definitions.js

@@ -1,4 +1,4 @@
-import { HealthCheckInputJsonSchema, SearchPRsInputJsonSchema, GetPrDiffInputJsonSchema, CheckoutBranchInputJsonSchema, GetMergeConflictFilesInputJsonSchema, GetChangedFilesInputJsonSchema, GetPackageScriptsInputJsonSchema, ReadCiLogsInputJsonSchema, RepoLogsInputJsonSchema, CreateBranchInputJsonSchema, CreateRepairBranchInputJsonSchema, RunTestsInputJsonSchema, CommitPatchInputJsonSchema, OpenReplacementPrInputJsonSchema, CreatePullRequestInputJsonSchema, CommentTriageSummaryInputJsonSchema, GetPrInputJsonSchema, IssueViewInputJsonSchema, IssueUpdateInputJsonSchema, IssueCommentInputJsonSchema, CreateIssueInputJsonSchema, 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,30 @@ 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",
+        mimeType: "application/json",
+        description: "Recent CI exit statuses, workflow runs, and annotations.",
+    },
     {
         uri: "repo://package-json",
         name: "package.json",
@@ -77,215 +95,232 @@ 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",
         description: "Search for open pull requests in the repository.",
         inputSchema: SearchPRsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: SearchPRsResponseJsonSchema,
     },
     {
         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",
         description: "Get the diff and changed files for a pull request.",
         inputSchema: GetPrDiffInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: PrDiffResponseJsonSchema,
     },
     {
         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",
         description: "Detect files that conflict when a PR is merged with the base branch.",
         inputSchema: GetMergeConflictFilesInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: GetMergeConflictFilesResponseJsonSchema,
     },
     {
         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",
+        description: "Check or poll the status of a Jules remediation session and verify its branch or PR status.",
+        inputSchema: {
+            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: CheckJulesStatusResponseJsonSchema,
     },
     {
         name: "repo.run_tests",
         description: "Run repository tests and checks.",
         inputSchema: RunTestsInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: RunTestsResponseJsonSchema,
     },
     {
         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",
         description: "Update a GitHub issue's body, labels, and/or state.",
         inputSchema: IssueUpdateInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: IssueUpdateResponseJsonSchema,
     },
     {
         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",
         description: "Create a new GitHub issue.",
         inputSchema: CreateIssueInputJsonSchema,
-        outputSchema: DEFAULT_OUTPUT_SCHEMA,
+        outputSchema: CreateIssueResponseJsonSchema,
     },
     {
         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

@@ -7,7 +7,7 @@ export function createMcpHttpServer(options) {
     const server = http.createServer(async (req, res) => {
         // CORS Headers
         res.setHeader("Access-Control-Allow-Origin", "*");
-        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS, HEAD");
         res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
         if (req.method === "OPTIONS") {
             res.writeHead(204);
@@ -15,19 +15,33 @@ export function createMcpHttpServer(options) {
             return;
         }
         const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
-        // Endpoint 1: OAuth Protected Resource metadata
-        if (url.pathname === "/.well-known/oauth-protected-resource" && req.method === "GET") {
+        // 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({
-                resource: "mcp://boomtick-mcp",
-                "authorization_servers": [
+            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 = {
+                resource: process.env.MCP_RESOURCE_URI || process.env.BOOMTICK_RESOURCE_URI || "mcp://boomtick-mcp",
+                authorization_servers: [
                     process.env.MCP_OAUTH_AUTH_SERVER || "https://auth.boomtick.dev",
                 ],
                 scopes_supported: ["mcp:read", "mcp:write"],
-            }));
+                bearer_methods_supported: ["header"],
+                resource_documentation: process.env.MCP_RESOURCE_DOCS || "https://github.com/arii/boomtick",
+            };
+            res.writeHead(200, { "Content-Type": "application/json" });
+            if (req.method === "HEAD") {
+                res.end();
+            }
+            else {
+                res.end(JSON.stringify(metadata, null, 2));
+            }
             return;
         }
-        // Bearer Token Validation for SSE & Messages endpoints
+        // Bearer Token / OAuth 2.1 Validation for Protected Routes (/sse & /messages)
         if (url.pathname === "/sse" || url.pathname === "/messages") {
             if (!bearerToken) {
                 res.writeHead(500, { "Content-Type": "application/json" });
@@ -44,7 +58,7 @@ export function createMcpHttpServer(options) {
             if (!isMatch) {
                 res.writeHead(401, {
                     "Content-Type": "application/json",
-                    "WWW-Authenticate": 'Bearer realm="boomtick-mcp", error="invalid_token"',
+                    "WWW-Authenticate": 'Bearer realm="boomtick-mcp", error="invalid_token", error_description="Invalid or missing Bearer token"',
                 });
                 res.end(JSON.stringify({ error: "unauthorized", message: "Invalid or missing Bearer token" }));
                 return;
@@ -52,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

@@ -1,6 +1,7 @@
 import { describe, it, expect, beforeEach, afterEach } from "vitest";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { createMcpHttpServer } from "./http.js";
+import { BoomtickMCPServer } from "./server.js";
 describe("createMcpHttpServer", () => {
     let mcpServer;
     let httpServerObj;
@@ -13,29 +14,62 @@ describe("createMcpHttpServer", () => {
             httpServerObj.server.close();
         }
     });
-    it("should respond with OAuth protected resource metadata on /.well-known/oauth-protected-resource", async () => {
+    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);
         const res = await fetch(`http://localhost:${port}/.well-known/oauth-protected-resource`);
         expect(res.status).toBe(200);
+        expect(res.headers.get("content-type")).toContain("application/json");
         const body = await res.json();
         expect(body.resource).toBe("mcp://boomtick-mcp");
-        expect(body.authorization_servers).toBeDefined();
+        expect(body.authorization_servers).toEqual(["https://auth.boomtick.dev"]);
         expect(body.scopes_supported).toEqual(["mcp:read", "mcp:write"]);
+        expect(body.bearer_methods_supported).toEqual(["header"]);
+        expect(body.resource_documentation).toBe("https://github.com/arii/boomtick");
+    });
+    it("should handle HEAD requests for /.well-known/oauth-protected-resource", async () => {
+        httpServerObj = createMcpHttpServer({ port: 0, mcpServer });
+        port = await httpServerObj.listen(0);
+        const res = await fetch(`http://localhost:${port}/.well-known/oauth-protected-resource`, {
+            method: "HEAD",
+        });
+        expect(res.status).toBe(200);
+        const text = await res.text();
+        expect(text).toBe("");
     });
-    it("should reject requests when Bearer token is missing or invalid", async () => {
+    it("should handle OPTIONS preflight CORS requests", async () => {
+        httpServerObj = createMcpHttpServer({ port: 0, mcpServer });
+        port = await httpServerObj.listen(0);
+        const res = await fetch(`http://localhost:${port}/sse`, {
+            method: "OPTIONS",
+        });
+        expect(res.status).toBe(204);
+        expect(res.headers.get("access-control-allow-origin")).toBe("*");
+        expect(res.headers.get("access-control-allow-methods")).toContain("GET");
+        expect(res.headers.get("access-control-allow-headers")).toContain("Authorization");
+    });
+    it("should reject protected requests when Bearer token is missing or invalid", async () => {
         httpServerObj = createMcpHttpServer({ port: 0, bearerToken: "secret123", mcpServer });
         port = await httpServerObj.listen(0);
         // Request without token
         const res1 = await fetch(`http://localhost:${port}/sse`);
         expect(res1.status).toBe(401);
         expect(res1.headers.get("www-authenticate")).toContain('Bearer realm="boomtick-mcp"');
+        expect(res1.headers.get("www-authenticate")).toContain('error="invalid_token"');
         // Request with wrong token
         const res2 = await fetch(`http://localhost:${port}/sse`, {
             headers: { Authorization: "Bearer wrong" },
         });
         expect(res2.status).toBe(401);
-        // Request with valid token
+        // Public resource metadata accessible with or without token
         const res3 = await fetch(`http://localhost:${port}/.well-known/oauth-protected-resource`, {
             headers: { Authorization: "Bearer secret123" },
         });
@@ -55,4 +89,28 @@ describe("createMcpHttpServer", () => {
         const body = await res.json();
         expect(body.error).toContain("Server misconfiguration");
     });
+    it("should return 400 for message requests without session or invalid session", async () => {
+        httpServerObj = createMcpHttpServer({ port: 0, bearerToken: "secret123", mcpServer });
+        port = await httpServerObj.listen(0);
+        const res = await fetch(`http://localhost:${port}/messages?sessionId=invalid_session`, {
+            method: "POST",
+            headers: {
+                Authorization: "Bearer secret123",
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ jsonrpc: "2.0", method: "ping", id: 1 }),
+        });
+        expect(res.status).toBe(400);
+        const body = await res.json();
+        expect(body.error).toContain("Session not found or expired");
+    });
+    it("should allow BoomtickMCPServer to start HTTP server via run() when transport is http", async () => {
+        process.env.MCP_TRANSPORT = "http";
+        process.env.PORT = "0";
+        process.env.BOOMTICK_MCP_BEARER_TOKEN = "test-token";
+        const boomtickServer = new BoomtickMCPServer();
+        await boomtickServer.run();
+        // Verify instance initialized properly
+        expect(boomtickServer).toBeInstanceOf(BoomtickMCPServer);
+    });
 });

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";
@@ -20,6 +21,7 @@ import { getWorkflowRunsHandler, GetWorkflowRunsInputSchema } from "../tools/rep
 import { createRepairBranchHandler, CreateRepairBranchInputSchema } from "../tools/repo.create_repair_branch.js";
 import { createBranchHandler, CreateBranchInputSchema } from "../tools/repo.create_branch.js";
 import { runTestsHandler, RunTestsInputSchema } from "../tools/repo.run_tests.js";
+import { checkJulesStatusHandler, CheckJulesStatusInputSchema } from "../tools/repo.check_jules_status.js";
 import { commitPatchHandler, CommitPatchInputSchema } from "../tools/repo.commit_patch.js";
 import { openReplacementPrHandler, OpenReplacementPrInputSchema } from "../tools/github.open_replacement_pr.js";
 import { commentTriageSummaryHandler, CommentTriageSummaryInputSchema } from "../tools/github.comment_triage_summary.js";
@@ -113,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({}));
@@ -120,6 +137,29 @@ 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") {
+                const workflowRuns = await getWorkflowRunsHandler(GetWorkflowRunsInputSchema.parse({}));
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: JSON.stringify(workflowRuns, null, 2) }],
+                };
+            }
             if (uri === "repo://package-json" || uri === "mcp://workspace/package-json") {
                 const content = await fs.readFile(path.join(config.repoPath, "package.json"), "utf-8");
                 return {
@@ -169,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)));
@@ -201,6 +244,9 @@ export class BoomtickMCPServer {
                     case "repo.create.repair.branch":
                     case "repo.create_repair_branch":
                         return createSuccessResult(await createRepairBranchHandler(CreateRepairBranchInputSchema.parse(normArgs)));
+                    case "repo.check.jules.status":
+                    case "repo.check_jules_status":
+                        return createSuccessResult(await checkJulesStatusHandler(CheckJulesStatusInputSchema.parse(normArgs)));
                     case "repo.run.tests":
                     case "repo.run_tests":
                         return createSuccessResult(await runTestsHandler(RunTestsInputSchema.parse(normArgs)));
@@ -335,20 +381,33 @@ export class BoomtickMCPServer {
             process.exit(1);
         }
     }
-    async startHttp(port = parseInt(process.env.PORT || process.env.HTTP_PORT || "3000", 10), bearerToken) {
-        this.prepareEnvironmentAndPreflight();
-        const mcpHttp = createMcpHttpServer({ port, bearerToken, mcpServer: this.server });
-        return await mcpHttp.listen(port);
-    }
     async run() {
         this.prepareEnvironmentAndPreflight();
+        const args = process.argv.slice(2);
+        let port = parseInt(process.env.PORT || process.env.HTTP_PORT || "3000", 10);
+        let bearerToken = process.env.BOOMTICK_MCP_BEARER_TOKEN || process.env.MCP_BEARER_TOKEN || process.env.AUTH_TOKEN;
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] === "--port" && i + 1 < args.length) {
+                port = parseInt(args[i + 1], 10);
+                i++;
+            }
+            else if (args[i].startsWith("--port=")) {
+                port = parseInt(args[i].split("=")[1], 10);
+            }
+            else if (args[i] === "--bearer-token" && i + 1 < args.length) {
+                bearerToken = args[i + 1];
+                i++;
+            }
+            else if (args[i].startsWith("--bearer-token=")) {
+                bearerToken = args[i].split("=")[1];
+            }
+        }
         const isHttp = process.env.MCP_TRANSPORT === "http" ||
-            process.argv.includes("--http") ||
-            (process.env.PORT !== undefined && !process.argv.includes("--stdio")) ||
-            (process.env.HTTP_PORT !== undefined && !process.argv.includes("--stdio"));
+            args.includes("--http") ||
+            (process.env.PORT !== undefined && !args.includes("--stdio")) ||
+            (process.env.HTTP_PORT !== undefined && !args.includes("--stdio"));
         if (isHttp) {
-            const port = parseInt(process.env.PORT || process.env.HTTP_PORT || "3000", 10);
-            const mcpHttp = createMcpHttpServer({ port, mcpServer: this.server });
+            const mcpHttp = createMcpHttpServer({ port, bearerToken, mcpServer: this.server });
             await mcpHttp.listen(port);
             return;
         }