@lonca/baron-mcp-server 0.3.0 → 0.5.0

package/dist/bin.js

@@ -2,7 +2,7 @@
 import {
   createMcpServer,
   loadPorts
-} from "./chunk-IJ6VTOQW.js";
+} from "./chunk-7KF4L47I.js";
 
 // src/bin.ts
 import { cwd, env, exit, stderr } from "process";

package/dist/{chunk-IJ6VTOQW.js → chunk-7KF4L47I.js}

@@ -47,10 +47,12 @@ function loadPorts(root, env) {
 import {
   BaronError as BaronError2,
   ISSUE_LINK_TYPES,
+  PR_STATE_FILTERS,
   RUN_STATUSES,
   WORKFLOW_ROLES,
   WORK_ITEM_TYPE_ROLES,
   isIssueLinkType,
+  isPrStateFilter,
   isRunStatus,
   isWorkItemTypeRole,
   isWorkflowRole
@@ -108,6 +110,7 @@ var TYPE_ROLE_ENUM = [...WORK_ITEM_TYPE_ROLES];
 var LINK_TYPE_ENUM = [...ISSUE_LINK_TYPES];
 var FOLLOWUP_STATUS_ENUM = [...FOLLOWUP_STATUSES];
 var RUN_STATUS_ENUM = [...RUN_STATUSES];
+var PR_STATE_FILTER_ENUM = [...PR_STATE_FILTERS];
 var DEFAULT_QUERY_LIMIT = 50;
 var TOOL_DEFINITIONS = [
   {
@@ -303,7 +306,7 @@ var SCM_TOOL_DEFINITIONS = [
   },
   {
     name: SCM_TOOL_NAMES.prForBranch,
-    description: "Find the OPEN pull request whose source is the given branch (null when none). Check this BEFORE opening a PR for a branch so a re-run updates/reports instead of duplicating.",
+    description: "Find the most recent pull request for a branch matching `state` (null when none), with its normalized `state`. `open` (default) = the finish-flow idempotency probe (don't duplicate an open PR); `merged` = the drift probe (did this branch land while its item stayed in progress?).",
     inputSchema: {
       type: "object",
       additionalProperties: false,
@@ -313,6 +316,11 @@ var SCM_TOOL_DEFINITIONS = [
           type: "string",
           minLength: 1,
           description: "Branch name (no refs/heads/)."
+        },
+        state: {
+          type: "string",
+          enum: PR_STATE_FILTER_ENUM,
+          description: "Lifecycle to search: 'open' (default), 'merged', 'closed', or 'all'."
         }
       }
     }
@@ -749,7 +757,17 @@ function callScmTool(port, name, args) {
       return run(() => port.prStatus(requireString(args, "pullRequestId")));
     case SCM_TOOL_NAMES.prForBranch:
       return run(async () => {
-        const pr = await port.prForBranch(requireString(args, "sourceBranch"));
+        const stateRaw = optionalString(args, "state");
+        if (stateRaw !== void 0 && !isPrStateFilter(stateRaw)) {
+          throw new BaronError2(
+            `Invalid state '${stateRaw}'. Expected one of: ${PR_STATE_FILTERS.join(", ")}.`,
+            INVALID_ARGS
+          );
+        }
+        const pr = await port.prForBranch(
+          requireString(args, "sourceBranch"),
+          stateRaw
+        );
         return pr ?? null;
       });
     case SCM_TOOL_NAMES.prThread:
@@ -1079,15 +1097,82 @@ function dispatchTool(ports, name, args) {
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-var SERVER_INFO = { name: "baron", version: "0.0.0" };
-function createMcpServer(ports) {
+
+// src/update-check.ts
+var UPDATE_CHECK_DISABLE_ENV = "BARON_NO_UPDATE_CHECK";
+var REGISTRY_BASE = "https://registry.npmjs.org";
+var ABBREVIATED_ACCEPT = "application/vnd.npm.install-v1+json";
+var CHECK_TIMEOUT_MS = 4e3;
+function compareSemver(a, b) {
+  const parse = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v.trim());
+    return m === null ? void 0 : [Number(m[1]), Number(m[2]), Number(m[3])];
+  };
+  const pa = parse(a);
+  const pb = parse(b);
+  if (pa === void 0 || pb === void 0) return 0;
+  for (let i = 0; i < 3; i += 1) {
+    const da = pa[i] ?? 0;
+    const db = pb[i] ?? 0;
+    if (da !== db) return da < db ? -1 : 1;
+  }
+  return 0;
+}
+function formatUpdateNotice(name, current, latest) {
+  return `\u26A0\uFE0F ${name} v${current} outdated \u2192 v${latest} available. Restart the baron MCP server to update (an @latest npx launcher fetches it automatically); pinned installs: reinstall ${name}@latest.`;
+}
+async function defaultFetchJson(url, accept) {
+  const response = await fetch(url, {
+    headers: { accept },
+    signal: AbortSignal.timeout(CHECK_TIMEOUT_MS)
+  });
+  if (!response.ok) throw new Error(`registry responded ${response.status}`);
+  return response.json();
+}
+function startUpdateCheck(options) {
+  let notice;
+  const disabled = (options.env ?? process.env)[UPDATE_CHECK_DISABLE_ENV];
+  if (disabled === void 0 || disabled.length === 0) {
+    const fetchJson = options.fetchJson ?? defaultFetchJson;
+    void fetchJson(`${REGISTRY_BASE}/${encodeURIComponent(options.name)}`, ABBREVIATED_ACCEPT).then((data) => {
+      const latest = data["dist-tags"]?.latest;
+      if (latest !== void 0 && compareSemver(options.currentVersion, latest) < 0) {
+        notice = formatUpdateNotice(options.name, options.currentVersion, latest);
+      }
+    }).catch(() => {
+    });
+  }
+  return { notice: () => notice };
+}
+
+// src/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+function readOwnPackage() {
+  try {
+    const raw = readFileSync2(new URL("../package.json", import.meta.url), "utf8");
+    const pkg = JSON.parse(raw);
+    return { name: pkg.name ?? "baron-mcp-server", version: pkg.version ?? "0.0.0" };
+  } catch {
+    return { name: "baron-mcp-server", version: "0.0.0" };
+  }
+}
+var OWN_PACKAGE = readOwnPackage();
+
+// src/server.ts
+var SERVER_INFO = { name: "baron", version: OWN_PACKAGE.version };
+function withUpdateNotice(result, notice) {
+  if (notice === void 0 || result.isError === true) return result;
+  return { ...result, content: [...result.content, { type: "text", text: notice }] };
+}
+function createMcpServer(ports, options = {}) {
   const server = new Server(SERVER_INFO, { capabilities: { tools: {} } });
+  const updateNotice = options.updateNotice ?? startUpdateCheck({ name: OWN_PACKAGE.name, currentVersion: OWN_PACKAGE.version }).notice;
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: activeToolDefinitions(ports)
   }));
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const result = await dispatchTool(ports, request.params.name, request.params.arguments);
-    return result;
+    return withUpdateNotice(result, updateNotice());
   });
   return server;
 }
@@ -1121,5 +1206,6 @@ export {
   activeToolDefinitions,
   dispatchTool,
   SERVER_INFO,
+  withUpdateNotice,
   createMcpServer
 };

package/dist/index.d.ts

@@ -119,8 +119,21 @@ declare function dispatchTool(ports: McpPorts, name: string, args: Record<string
 
 declare const SERVER_INFO: {
     readonly name: "baron";
-    readonly version: "0.0.0";
+    readonly version: string;
 };
+interface McpServerOptions {
+    /**
+     * Supplies the one-line "outdated" notice (or undefined). Defaults to a live npm-registry check;
+     * injectable for tests and disabled entirely via BARON_NO_UPDATE_CHECK.
+     */
+    readonly updateNotice?: () => string | undefined;
+}
+/**
+ * Append the update notice as an ADDITIONAL content block. The first block stays untouched: it is
+ * parseable JSON that agents (and our tests) read with JSON.parse — prepending prose there would
+ * break every consumer. Error results are left alone so the notice never muddies failure handling.
+ */
+declare function withUpdateNotice(result: ToolResult, notice: string | undefined): ToolResult;
 /**
  * Wire the bound ports' primitives onto a low-level MCP {@link Server}. It advertises only the tools
  * for ports present in {@link McpPorts} and routes each call to the right port by name prefix. The
@@ -128,7 +141,7 @@ declare const SERVER_INFO: {
  * / result shapes are structurally the SDK's, cast at this single boundary to bridge readonly /
  * zod-inferred nominal differences while keeping `tools.ts` SDK-free.
  */
-declare function createMcpServer(ports: McpPorts): Server;
+declare function createMcpServer(ports: McpPorts, options?: McpServerOptions): Server;
 
 /**
  * Load the committed policy and build the ports it serves: the issues/scm ports it binds (either or
@@ -138,4 +151,4 @@ declare function createMcpServer(ports: McpPorts): Server;
  */
 declare function loadPorts(root: string, env: Env): McpPorts;
 
-export { CI_TOOL_DEFINITIONS, CI_TOOL_NAMES, DEPLOY_TOOL_DEFINITIONS, DEPLOY_TOOL_NAMES, LOOP_TOOL_DEFINITIONS, LOOP_TOOL_NAMES, MCP_TOOL_NAMES, type McpPorts, NATIVE_TOOL_DEFINITIONS, NATIVE_TOOL_NAMES, NOTIFY_TOOL_DEFINITIONS, NOTIFY_TOOL_NAMES, type NativeAccess, RECIPE_TOOL_DEFINITIONS, RECIPE_TOOL_NAMES, SCM_TOOL_DEFINITIONS, SCM_TOOL_NAMES, SERVER_INFO, TOOL_DEFINITIONS, type ToolDefinition, type ToolResult, activeToolDefinitions, callCiTool, callDeployTool, callLoopTool, callNativeTool, callNotifyTool, callRecipeTool, callScmTool, callTool, createMcpServer, dispatchTool, loadPorts };
+export { CI_TOOL_DEFINITIONS, CI_TOOL_NAMES, DEPLOY_TOOL_DEFINITIONS, DEPLOY_TOOL_NAMES, LOOP_TOOL_DEFINITIONS, LOOP_TOOL_NAMES, MCP_TOOL_NAMES, type McpPorts, type McpServerOptions, NATIVE_TOOL_DEFINITIONS, NATIVE_TOOL_NAMES, NOTIFY_TOOL_DEFINITIONS, NOTIFY_TOOL_NAMES, type NativeAccess, RECIPE_TOOL_DEFINITIONS, RECIPE_TOOL_NAMES, SCM_TOOL_DEFINITIONS, SCM_TOOL_NAMES, SERVER_INFO, TOOL_DEFINITIONS, type ToolDefinition, type ToolResult, activeToolDefinitions, callCiTool, callDeployTool, callLoopTool, callNativeTool, callNotifyTool, callRecipeTool, callScmTool, callTool, createMcpServer, dispatchTool, loadPorts, withUpdateNotice };

package/dist/index.js

@@ -27,8 +27,9 @@ import {
   callTool,
   createMcpServer,
   dispatchTool,
-  loadPorts
-} from "./chunk-IJ6VTOQW.js";
+  loadPorts,
+  withUpdateNotice
+} from "./chunk-7KF4L47I.js";
 export {
   CI_TOOL_DEFINITIONS,
   CI_TOOL_NAMES,
@@ -58,5 +59,6 @@ export {
   callTool,
   createMcpServer,
   dispatchTool,
-  loadPorts
+  loadPorts,
+  withUpdateNotice
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lonca/baron-mcp-server",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -19,15 +19,15 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@lonca/baron-core": "0.3.0",
-    "@lonca/baron-providers": "0.3.0",
-    "@lonca/baron-recipes": "0.3.0",
-    "@lonca/baron-knowledge-loop": "0.3.0"
+    "@lonca/baron-core": "0.5.0",
+    "@lonca/baron-recipes": "0.5.0",
+    "@lonca/baron-providers": "0.5.0",
+    "@lonca/baron-knowledge-loop": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@lonca/baron-conformance": "0.3.0",
-    "@lonca/baron-adapter-github": "0.3.0"
+    "@lonca/baron-conformance": "0.5.0",
+    "@lonca/baron-adapter-github": "0.5.0"
   },
   "description": "Baron MCP server: drive issues, scm, ci, deploy, and notify across providers from any MCP client.",
   "keywords": [