@mebular/mcp 0.0.0-stage → 0.1.0

package/src/apply-supervisor.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// G：应用监督进程（分离启动；守护被重启/终止后仍能完成「健康校验 → 回滚兜底」）。
+//
+// 由 serve 在保存需重启配置时分离启动：
+//   node apply-supervisor.mjs --home <home> --config <config.json> --old-pid <pid> [--port N] [--fields a,b] [--timeout ms]
+//
+// 退出码：0 = 已生效或已回滚（结果写 <home>/config-apply.result.json）；2 = 监督失败。
+
+import { runApplySupervisor } from './config-apply.mjs';
+import { resolveBuildSha } from '../../service/dist/index.js';
+
+function parseArgs(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (!token.startsWith('--')) continue;
+    const key = token.slice(2);
+    const next = argv[i + 1];
+    if (next === undefined || next.startsWith('--')) out[key] = true;
+    else { out[key] = next; i += 1; }
+  }
+  return out;
+}
+
+const flags = parseArgs(process.argv.slice(2));
+const home = typeof flags.home === 'string' ? flags.home : null;
+if (!home) {
+  console.error('apply-supervisor: 缺少 --home');
+  process.exit(2);
+}
+const configFile = typeof flags.config === 'string' ? flags.config : `${home}/config.json`;
+const oldPid = Number(flags['old-pid'] ?? '0') || 0;
+const port = Number(flags.port ?? '0') || 0;
+const fields = typeof flags.fields === 'string' && flags.fields.length > 0 ? flags.fields.split(',').filter(Boolean) : [];
+const timeoutMs = Number(flags.timeout ?? '0') > 0 ? Number(flags.timeout) : undefined;
+
+const result = await runApplySupervisor({
+  home,
+  configFile,
+  oldPid,
+  port,
+  fields,
+  ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+  log: (message) => console.error(`[apply ${new Date().toISOString()}] ${message}`),
+}).catch((error) => ({ status: 'supervisor-error', reason: String(error?.message ?? error) }));
+
+console.error(`[apply] 结果：${JSON.stringify(result)} sha=${resolveBuildSha()}`);
+process.exit(result.status === 'supervisor-error' ? 2 : 0);

package/src/build-sha.mjs

@@ -0,0 +1,36 @@
+// 构建 SHA 解析（F-INSTALL-1：**与 cwd 解耦**）。
+//
+// 病灶：旧 `resolveBuildSha()` 默认 `git rev-parse HEAD` 于 `process.cwd()`——全局安装的
+// `mebular service install` 在仓库目录外执行时 sha=unknown，在仓库内执行才是真实 sha。
+// 本模块是 ESM 边界（.mjs，不经 ts-jest），可安全用 import.meta 定位**安装自身**：
+//
+//   1. env 覆盖（MEBULAR_BUILD_SHA / MEBULAR_SERVICE_SHA）；
+//   2. 模块邻接构建元数据 `packages/service/dist/version.json`（构建期由
+//      scripts/gen-fleet-version.mjs 写入；npm 全局安装 `@mebular/core` 后依然在包内）；
+//   3. 模块所在仓库的 git HEAD（仓库内直跑兜底；全局安装不是 git 仓库 → 跳过）；
+//   4. `unknown`。
+//
+// 三种来源均与调用者的 cwd 无关。
+
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+export function serviceBuildSha(env = process.env) {
+  const fromEnv = env.MEBULAR_BUILD_SHA ?? env.MEBULAR_SERVICE_SHA;
+  if (fromEnv) return fromEnv;
+  // packages/mcp/src/build-sha.mjs → packages/service/dist/version.json（同一 @mebular/core 包内）
+  try {
+    const meta = JSON.parse(readFileSync(new URL('../../service/dist/version.json', import.meta.url), 'utf-8'));
+    if (typeof meta.sha === 'string' && meta.sha.length > 0 && meta.sha !== 'unknown') return meta.sha;
+  } catch {
+    // 无构建元数据（未构建）→ 继续
+  }
+  // packages/mcp/src/build-sha.mjs → 包根（仓库检出时为 git 仓库根）
+  try {
+    const pkgRoot = fileURLToPath(new URL('../../..', import.meta.url));
+    return execFileSync('git', ['rev-parse', 'HEAD'], { cwd: pkgRoot, stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+  } catch {
+    return 'unknown';
+  }
+}

package/src/client.mjs

@@ -0,0 +1,49 @@
+// 最小 MCP Streamable HTTP 客户端（CLI 在**守护持锁**时作为本机 MCP 客户端调用 `/mcp`）。
+//
+// 仅覆盖 CLI 所需：initialize → notifications/initialized → tools/call。
+// 复用既有 bearer token 体系（`mebular token`）。
+
+async function rpc(endpoint, token, message, sessionId, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const headers = {
+      'content-type': 'application/json',
+      accept: 'application/json, text/event-stream',
+    };
+    if (token) headers.authorization = `Bearer ${token}`;
+    if (sessionId) headers['mcp-session-id'] = sessionId;
+    const res = await fetch(endpoint, { method: 'POST', headers, body: JSON.stringify(message), signal: controller.signal });
+    const sid = res.headers.get('mcp-session-id') ?? sessionId ?? null;
+    const text = await res.text();
+    if (!res.ok) {
+      throw new Error(`MCP HTTP ${res.status}：${text.slice(0, 200)}`);
+    }
+    const ct = res.headers.get('content-type') ?? '';
+    if (ct.includes('text/event-stream')) {
+      const dataLines = text.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim());
+      const last = dataLines[dataLines.length - 1];
+      return { sessionId: sid, json: last ? JSON.parse(last) : null };
+    }
+    return { sessionId: sid, json: text.trim().length > 0 ? JSON.parse(text) : null };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/** 调用守护 MCP 的某个工具；返回 MCP result（{content, structuredContent}）。 */
+export async function callToolViaHttp({ endpoint, token, name, args, timeoutMs = 30000 }) {
+  if (typeof endpoint !== 'string' || endpoint.length === 0) throw new Error('缺少守护 MCP 端点');
+  const url = `${endpoint.replace(/\/+$/, '')}/mcp`;
+  const init = await rpc(url, token, {
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'initialize',
+    params: { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'mebular-cli', version: '0.1.0' } },
+  }, null, timeoutMs);
+  const sessionId = init.sessionId;
+  await rpc(url, token, { jsonrpc: '2.0', method: 'notifications/initialized' }, sessionId, timeoutMs);
+  const res = await rpc(url, token, { jsonrpc: '2.0', id: 2, method: 'tools/call', params: { name, arguments: args } }, sessionId, timeoutMs);
+  if (res.json?.error) throw new Error(`MCP 错误：${res.json.error.message ?? JSON.stringify(res.json.error)}`);
+  return res.json?.result ?? null;
+}