ictrp-mcp-server 0.1.0

package/dist/cli/setup-cli.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+/**
+ * Setup CLI.
+ *
+ * Exit codes are contractual -- installers and desktop hosts branch on them,
+ * so they must not drift:
+ *
+ *   0  success, or the environment is ready
+ *   1  not ready, and the user needs to do something
+ *   2  self-setup failed with a definite error
+ *
+ * Every subcommand is read-only except `setup`, `sidecar` and `clean`.
+ */
+import { existsSync, rmSync } from "node:fs";
+import { formatEnvReport, getEnvReport, invalidateEnvReport, packageRoot, stateRoot, venvDir, venvPython, sidecarScript, } from "../runtime/env-probe.js";
+import { bootstrapEnvironment, discoverPython, mirrorChain } from "../runtime/bootstrap.js";
+import { ensureSidecar, stopSidecar } from "../runtime/supervisor.js";
+const EXIT_OK = 0;
+const EXIT_NOT_READY = 1;
+const EXIT_BOOTSTRAP_FAILED = 2;
+const HELP = `ictrp-setup — 环境自举与诊断
+
+用法:
+  ictrp-setup doctor              只读体检，报告能否访问 ICTRP
+  ictrp-setup setup               创建私有 venv 并安装依赖
+  ictrp-setup sidecar             前台运行 Python sidecar（调试用）
+  ictrp-setup clean [--yes]       删除私有 venv 与缓存
+  ictrp-setup postinstall         npm 安装后提示（只检查，不下载）
+
+选项:
+  --mirror=<名称|URL>   首选 PyPI 镜像（默认 aliyun；可选 tencent/tsinghua/official）
+  --timeout=<秒>        单步超时（默认 1800）
+  --yes                 跳过 clean 的确认
+  -h, --help            显示本帮助
+
+退出码:
+  0  就绪 / 成功
+  1  未就绪，需要用户操作
+  2  自举失败
+
+环境变量:
+  ICTRP_HOME                 可写状态目录覆盖（虚拟环境、快照）
+  ICTRP_VENV                 venv 路径（默认 <root>/.venv）
+  ICTRP_SIDECAR_PORT         sidecar 端口（默认 8849）
+  ICTRP_SIDECAR_URL          sidecar 地址
+  ICTRP_PIP_MIRROR           首选镜像
+  ICTRP_AUTOSTART_SIDECAR    设为 0 则永不自动拉起 sidecar
+`;
+function parseFlags(argv) {
+    const flags = { timeoutSec: 1800, yes: false };
+    for (const arg of argv) {
+        if (arg.startsWith("--mirror="))
+            flags.mirror = arg.slice("--mirror=".length);
+        else if (arg.startsWith("--timeout=")) {
+            const n = Number(arg.slice("--timeout=".length));
+            if (Number.isFinite(n) && n > 0)
+                flags.timeoutSec = n;
+        }
+        else if (arg === "--yes" || arg === "-y")
+            flags.yes = true;
+    }
+    return flags;
+}
+function progressLine(message, percent) {
+    const prefix = percent === undefined ? "  " : `  [${String(percent).padStart(3)}%] `;
+    process.stdout.write(`${prefix}${message}\n`);
+}
+// ---------------------------------------------------------------------------
+async function cmdDoctor() {
+    const report = await getEnvReport(true);
+    process.stdout.write(`${formatEnvReport(report)}\n`);
+    const ping = await import("../runtime/sidecar-client.js").then((m) => m.pingSidecar());
+    if (ping.ok) {
+        process.stdout.write(`\nsidecar: 运行中（python ${ping.data.python}，持有 ${ping.data.sets_held} 个结果集）\n`);
+    }
+    else {
+        process.stdout.write(`\nsidecar: 未运行（${ping.code}）\n`);
+    }
+    return report.ready ? EXIT_OK : EXIT_NOT_READY;
+}
+async function cmdSetup(flags) {
+    const chain = mirrorChain(flags.mirror);
+    process.stdout.write(`包根目录: ${packageRoot()}\n`);
+    process.stdout.write(`状态目录: ${stateRoot()}\n`);
+    process.stdout.write(`镜像顺序: ${chain.map((m) => m.name).join(" -> ")}\n`);
+    const python = await discoverPython();
+    if (!python) {
+        process.stdout.write("\n未找到 Python 3.10+。请先安装 Python，然后重新运行 `ictrp-setup setup`。\n");
+        return EXIT_NOT_READY;
+    }
+    process.stdout.write(`系统 Python: ${python.cmd} (${python.version})\n\n`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), flags.timeoutSec * 1000);
+    try {
+        const result = await bootstrapEnvironment({
+            ...(flags.mirror !== undefined ? { mirror: flags.mirror } : {}),
+            onProgress: (event) => progressLine(`${event.step}: ${event.message}`, event.percent),
+            signal: controller.signal,
+        });
+        process.stdout.write("\n");
+        for (const step of result.steps) {
+            const icon = step.outcome === "ok" ? "✅" : step.outcome === "skipped" ? "➖" : "❌";
+            process.stdout.write(`${icon} ${step.step}: ${step.message}\n`);
+        }
+        if (!result.ok) {
+            process.stdout.write("\n");
+            for (const err of result.errors)
+                process.stdout.write(`❌ ${err}\n`);
+            return EXIT_BOOTSTRAP_FAILED;
+        }
+        invalidateEnvReport();
+        const report = await getEnvReport(true);
+        process.stdout.write(`\n${report.summary}\n`);
+        if (!report.ready) {
+            process.stdout.write("\n");
+            for (const action of report.actions)
+                process.stdout.write(`  - ${action}\n`);
+            return EXIT_NOT_READY;
+        }
+        return EXIT_OK;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function cmdSidecar() {
+    const python = venvPython();
+    const script = sidecarScript();
+    if (!existsSync(python)) {
+        process.stderr.write(`❌ 未找到虚拟环境解释器: ${python}\n   先运行: ictrp-setup setup\n`);
+        return EXIT_BOOTSTRAP_FAILED;
+    }
+    if (!existsSync(script)) {
+        process.stderr.write(`❌ 未找到 sidecar 脚本: ${script}\n`);
+        return EXIT_BOOTSTRAP_FAILED;
+    }
+    process.stdout.write(`启动 sidecar: ${python} ${script}\n`);
+    // Run through the supervisor so the foreground path and the auto-start path
+    // share one implementation, including the readiness wait.
+    const started = await ensureSidecar({ autoStart: true });
+    if (!started.ok) {
+        process.stderr.write(`❌ ${started.code}: ${started.message}\n`);
+        if (started.hint)
+            process.stderr.write(`   ${started.hint}\n`);
+        return EXIT_BOOTSTRAP_FAILED;
+    }
+    process.stdout.write(`✅ sidecar 就绪：python ${started.data.python}，端口来自 ${process.env.ICTRP_SIDECAR_URL ?? "http://127.0.0.1:8849"}\n`);
+    process.stdout.write("按 Ctrl-C 停止。\n");
+    await new Promise((resolve) => {
+        const stop = () => resolve();
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    await stopSidecar();
+    return EXIT_OK;
+}
+async function cmdClean(flags) {
+    const dir = venvDir();
+    if (!existsSync(dir)) {
+        process.stdout.write(`无需清理：${dir} 不存在。\n`);
+        return EXIT_OK;
+    }
+    if (!flags.yes) {
+        process.stdout.write(`将删除: ${dir}\n确认请加 --yes。\n`);
+        return EXIT_NOT_READY;
+    }
+    await stopSidecar();
+    rmSync(dir, { recursive: true, force: true });
+    invalidateEnvReport();
+    process.stdout.write(`✅ 已删除 ${dir}\n`);
+    return EXIT_OK;
+}
+/**
+ * npm's postinstall hook.
+ *
+ * Check and print. It never downloads and never fails: a postinstall that can
+ * fail turns an ordinary "you don't have Python yet" into a broken npm install
+ * that the user cannot get past.
+ */
+async function cmdPostinstall() {
+    try {
+        const report = await getEnvReport(true);
+        if (report.ready) {
+            process.stdout.write("ictrp-mcp-server: 环境就绪。\n");
+        }
+        else {
+            process.stdout.write("ictrp-mcp-server: 首次使用前需要创建私有 Python 环境。\n" +
+                "运行: npx ictrp-setup setup\n");
+            for (const action of report.actions)
+                process.stdout.write(`  - ${action}\n`);
+        }
+    }
+    catch {
+        // Absolutely nothing here may fail an install.
+    }
+    return EXIT_OK;
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const command = argv[0];
+    if (!command || command === "-h" || command === "--help" || command === "help") {
+        process.stdout.write(HELP);
+        return EXIT_OK;
+    }
+    const flags = parseFlags(argv.slice(1));
+    switch (command) {
+        case "doctor":
+            return cmdDoctor();
+        case "setup":
+            return cmdSetup(flags);
+        case "sidecar":
+            return cmdSidecar();
+        case "clean":
+            return cmdClean(flags);
+        case "postinstall":
+            return cmdPostinstall();
+        default:
+            process.stderr.write(`未知命令: ${command}\n\n${HELP}`);
+            return EXIT_NOT_READY;
+    }
+}
+main()
+    .then((code) => {
+    process.exit(code);
+})
+    .catch((err) => {
+    process.stderr.write(`${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+    process.exit(EXIT_BOOTSTRAP_FAILED);
+});
+//# sourceMappingURL=setup-cli.js.map

package/dist/cli/setup-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-cli.js","sourceRoot":"","sources":["../../src/cli/setup-cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * MCP server for the WHO ICTRP, over stdio.
+ *
+ * This file is the MCP surface and nothing else. It validates arguments,
+ * ensures the Python sidecar is up, forwards the call, and shapes the result.
+ * All domain logic -- the postback chain, the incompleteness accounting, the
+ * local query engine -- lives in Python, where it is tested.
+ *
+ * The one rule that shapes every handler here: **a failure must never be
+ * presented as a successful empty result.** ICTRP's export silently omits
+ * records, so an empty answer and a failed answer are dangerously easy to
+ * confuse. Failures are therefore reported with `isError: true` and a
+ * machine-readable `error_code`, and the incompleteness notice is attached to
+ * every successful result that carries rows.
+ */
+import { toErrorText } from "./runtime/sidecar-client.js";
+export { toErrorText };