@openlibing/openlibing-cli 0.1.12 → 0.1.14

package/dist/commands/mcp.js

@@ -1,6 +1,10 @@
 import { startStdioServer } from "../mcp/server.js";
 import { tools } from "../mcp/registry.js";
 import { ensureAuthenticated } from "../auth/login.js";
+import { env } from "../config/env.js";
+import { APP_VERSION } from "../version.js";
+import { checkForUpdate } from "../updateCheck.js";
+import { EXIT_AUTH } from "../exitCodes.js";
 export function mcpCommand(program) {
     const cmd = program
         .command("mcp")
@@ -9,6 +13,8 @@ export function mcpCommand(program) {
         .command("start")
         .description("启动 MCP stdio server（自动完成授权：已有凭证自动续期，无凭证弹出浏览器点一次授权）")
         .action(async () => {
+        // 版本横幅：让客户端日志中能直接确认本次运行的实际版本（npx 缓存/配置差异时尤为重要）
+        console.error(`[mcp] openlibing-cli v${APP_VERSION} 启动（环境 ${env.env}，${tools.length} 个工具）`);
         try {
             // 连接即授权：凭证续期/授权失败则退出，提示用户处理，避免无凭证空跑
             await ensureAuthenticated();
@@ -16,15 +22,24 @@ export function mcpCommand(program) {
         catch (err) {
             console.error(`[mcp] 自动授权失败：${err.message}`);
             console.error("[mcp] 请先运行 `openlibing-cli auth login` 完成登录（或安装 Chrome/Edge 后重连）");
-            process.exitCode = 1;
+            // 认证未建立（含浏览器不可用导致的授权未完成）：退出码 4，便于客户端/脚本识别并触发登录
+            process.exitCode = EXIT_AUTH;
             return;
         }
+        // 后台检查更新（fire-and-forget：不阻塞启动；24h 节流；失败静默）
+        void checkForUpdate().then((info) => {
+            if (info?.hasUpdate) {
+                console.error(`[mcp] 提示：openlibing-cli 有新版本 v${info.latest}（当前 v${info.current}）。` +
+                    "建议 MCP 客户端配置中的包名使用 @latest 并重连以升级；也可调用 cli_version 工具查看详情");
+            }
+        });
         await startStdioServer();
     });
     cmd
         .command("list")
         .description("列出已注册的 MCP 工具")
         .action(() => {
+        console.log(`openlibing-cli v${APP_VERSION}（${tools.length} 个工具）：`);
         for (const tool of tools) {
             console.log(`${tool.name}\t${tool.description}`);
         }

package/dist/commands/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3B,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,oCAAoC;YACpC,MAAM,mBAAmB,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAClF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,GAAG,EAAE;QACX,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3B,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,+CAA+C;QAC/C,OAAO,CAAC,KAAK,CAAC,yBAAyB,WAAW,UAAU,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,oCAAoC;YACpC,MAAM,mBAAmB,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAClF,+CAA+C;YAC/C,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,4CAA4C;QAC5C,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CACX,iCAAiC,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,OAAO,IAAI;oBAClE,2DAA2D,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,mBAAmB,WAAW,IAAI,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QACpE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 结构化错误：CLI / MCP 工具共用的错误载体。
+ * type 供程序分支（AI 客户端可编程恢复），hint 给出下一步行动，details 附机器可读的补充数据。
+ */
+export type CliErrorType = "auth" | "not_found" | "api_error" | "unexpected";
+export interface CliErrorOptions {
+    /** 面向用户/模型的错误说明 */
+    message: string;
+    /** 错误分类，默认 unexpected */
+    type?: CliErrorType;
+    /** 下一步行动指引（如“调用 auth_login 重新授权”） */
+    hint?: string;
+    /** 附加数据（如可用选项列表） */
+    details?: Record<string, unknown>;
+}
+export declare class CliError extends Error {
+    readonly type: CliErrorType;
+    readonly hint?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(opts: CliErrorOptions);
+}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class CliError extends Error {
+    type;
+    hint;
+    details;
+    constructor(opts) {
+        super(opts.message);
+        this.name = "CliError";
+        this.type = opts.type ?? "unexpected";
+        this.hint = opts.hint;
+        this.details = opts.details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,IAAI,CAAU;IACd,OAAO,CAA2B;IAE3C,YAAY,IAAqB;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;CACF"}

package/dist/exitCodes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI 退出码约定（脚本可据此分支）：
+ * - 0 成功
+ * - 1 一般错误（含 commander 用法错误）
+ * - 4 认证未建立或凭证失效（脚本可据此触发 openlibing-cli auth login）
+ */
+export declare const EXIT_OK = 0;
+export declare const EXIT_ERROR = 1;
+export declare const EXIT_AUTH = 4;

package/dist/exitCodes.js

@@ -0,0 +1,10 @@
+/**
+ * CLI 退出码约定（脚本可据此分支）：
+ * - 0 成功
+ * - 1 一般错误（含 commander 用法错误）
+ * - 4 认证未建立或凭证失效（脚本可据此触发 openlibing-cli auth login）
+ */
+export const EXIT_OK = 0;
+export const EXIT_ERROR = 1;
+export const EXIT_AUTH = 4;
+//# sourceMappingURL=exitCodes.js.map

package/dist/exitCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../src/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC"}

package/dist/index.js

@@ -4,15 +4,14 @@
  * 用法：openlibing-cli mcp start（AI 客户端配置 command 方式启动）；openlibing-cli auth login（插件授权登录）
  */
 import { Command } from "commander";
-import { readFileSync } from "node:fs";
 import { mcpCommand } from "./commands/mcp.js";
 import { authCommand } from "./commands/auth.js";
-const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+import { APP_VERSION } from "./version.js";
 const program = new Command();
 program
     .name("openlibing-cli")
     .description("OpenLibing MCP CLI：本地 stdio MCP server")
-    .version(pkg.version);
+    .version(APP_VERSION);
 mcpCommand(program);
 authCommand(program);
 program.parse(process.argv);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC3C,CAAC;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AAErB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,WAAW,CAAC,CAAC;AAExB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AAErB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/mcp/registry.js

@@ -4,5 +4,6 @@
  */
 import { reportTools } from "../tools/report/index.js";
 import { authTools } from "../tools/auth/login.js";
-export const tools = [...reportTools, ...authTools];
+import { cliTools } from "../tools/cli/version.js";
+export const tools = [...reportTools, ...authTools, ...cliTools];
 //# sourceMappingURL=registry.js.map

package/dist/mcp/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,CAAC,MAAM,KAAK,GAAqB,CAAC,GAAG,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,MAAM,CAAC,MAAM,KAAK,GAAqB,CAAC,GAAG,WAAW,EAAE,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC"}

package/dist/mcp/server.d.ts

@@ -5,7 +5,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare const SERVER_INFO: {
     readonly name: "openlibing-mcp";
-    readonly version: "0.1.0";
+    readonly version: string;
 };
 export declare function createMcpServer(): McpServer;
 /** 启动 stdio 传输的 MCP Server（阻塞运行，直到 stdin 关闭） */

package/dist/mcp/server.js

@@ -5,9 +5,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { tools } from "./registry.js";
+import { toErrorResult } from "../tools/types.js";
+import { APP_VERSION } from "../version.js";
 export const SERVER_INFO = {
     name: "openlibing-mcp",
-    version: "0.1.0",
+    version: APP_VERSION,
 };
 export function createMcpServer() {
     const server = new McpServer(SERVER_INFO, {
@@ -21,7 +23,16 @@ export function createMcpServer() {
             "(3) 所有工具均为只读，不会修改平台数据。",
     });
     for (const tool of tools) {
-        server.tool(tool.name, tool.description, tool.schema, async (args) => tool.handler(args));
+        server.tool(tool.name, tool.description, tool.schema, async (args) => {
+            // 统一失败契约：handler 抛出的 CliError/普通异常均转为 isError 结构化结果，
+            // 不再落到 SDK 裸文本兜底（丢失 type/hint 等机器可读信息）
+            try {
+                return await tool.handler(args);
+            }
+            catch (err) {
+                return toErrorResult(err);
+            }
+        });
     }
     return server;
 }

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACR,CAAC;AAEX,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,WAAW,EACX;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B;8CACsC;QACtC,YAAY,EACV,6BAA6B;YAC7B,uDAAuD;YACvD,gDAAgD;YAChD,2DAA2D;YAC3D,wBAAwB;KAC3B,CACF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,EACX,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAA+B,CAAC,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,WAAW;CACZ,CAAC;AAEX,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,WAAW,EACX;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B;8CACsC;QACtC,YAAY,EACV,6BAA6B;YAC7B,uDAAuD;YACvD,gDAAgD;YAChD,2DAA2D;YAC3D,wBAAwB;KAC3B,CACF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,qDAAqD;YACrD,uCAAuC;YACvC,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/auth/login.js

@@ -1,5 +1,6 @@
 import { loginAuto } from "../../auth/login.js";
 import { textResult } from "../types.js";
+import { CliError } from "../../errors.js";
 export const authLoginTool = {
     name: "auth_login",
     description: "触发浏览器授权登录（自动弹出浏览器，用户点一次授权即完成，无需手动复制 URL）。" +
@@ -11,15 +12,15 @@ export const authLoginTool = {
         try {
             const auth = await loginAuto();
             return textResult({
-                success: true,
                 message: "登录成功",
                 accountName: auth.accountName ?? "unknown",
             });
         }
         catch (err) {
-            return textResult({
-                success: false,
-                message: `登录失败：${err.message}（可让用户手动运行 openlibing-cli auth login 完成登录）`,
+            throw new CliError({
+                message: `登录失败：${err.message}`,
+                type: "auth",
+                hint: "可让用户手动运行 openlibing-cli auth login 完成登录；或确认已安装 Chrome/Edge 后重试",
             });
         }
     },

package/dist/tools/auth/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/tools/auth/login.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,2CAA2C;QAC3C,qCAAqC;QACrC,wBAAwB;QACxB,wBAAwB;IAC1B,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;YAC/B,OAAO,UAAU,CAAC;gBAChB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;aAC3C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,UAAU,CAAC;gBAChB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,QAAS,GAAa,CAAC,OAAO,2CAA2C;aACnF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC;AAEF,kCAAkC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAqB,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/tools/auth/login.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,2CAA2C;QAC3C,qCAAqC;QACrC,wBAAwB;QACxB,wBAAwB;IAC1B,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;YAC/B,OAAO,UAAU,CAAC;gBAChB,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;aAC3C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC;gBACjB,OAAO,EAAE,QAAS,GAAa,CAAC,OAAO,EAAE;gBACzC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gEAAgE;aACvE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC;AAEF,kCAAkC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAqB,CAAC,aAAa,CAAC,CAAC"}

package/dist/tools/cli/version.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "../types.js";
+export declare const cliVersionTool: ToolDefinition;
+/** cli 功能组工具列表（供 registry 聚合） */
+export declare const cliTools: ToolDefinition[];

package/dist/tools/cli/version.js

@@ -0,0 +1,38 @@
+/**
+ * cli 功能组：cli_version —— 查询当前运行的 CLI/MCP 服务版本，并检查是否有新版本。
+ * 场景：MCP 使用中用户/AI 无法直接得知 npx 拉起的实际版本（配置缓存差异），
+ * 也无法感知版本落后；本工具提供单一查询入口（24h 节流，失败静默）。
+ */
+import { env } from "../../config/env.js";
+import { APP_VERSION } from "../../version.js";
+import { checkForUpdate, updateCheckDisabled } from "../../updateCheck.js";
+import { textResult } from "../types.js";
+export const cliVersionTool = {
+    name: "cli_version",
+    description: "查询当前运行的 openlibing-cli 版本，并检查是否有新版本可用（检查结果缓存 24 小时，网络失败时静默）。" +
+        "当用户询问 CLI 版本 / 是否最新 / 如何升级，或怀疑本地版本过旧导致行为不一致时调用。",
+    schema: {},
+    handler: async () => {
+        const update = await checkForUpdate();
+        const payload = {
+            version: APP_VERSION,
+            env: env.env,
+            /** ok=已检查；disabled=用户关闭了更新检查；unavailable=网络不可达/超时 */
+            updateCheck: updateCheckDisabled() ? "disabled" : update ? "ok" : "unavailable",
+        };
+        if (update) {
+            payload.latestVersion = update.latest;
+            payload.hasUpdate = update.hasUpdate;
+        }
+        if (update?.hasUpdate) {
+            payload.updateHint =
+                `检测到新版本 v${update.latest}（当前 v${update.current}）。升级方式：` +
+                    "MCP 客户端配置中的包名使用 @openlibing/openlibing-cli@latest 并重连（npx 自动拉取最新版）；" +
+                    "或在终端运行 npx -y @openlibing/openlibing-cli@latest --version 验证。";
+        }
+        return textResult(payload);
+    },
+};
+/** cli 功能组工具列表（供 registry 聚合） */
+export const cliTools = [cliVersionTool];
+//# sourceMappingURL=version.js.map

package/dist/tools/cli/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/tools/cli/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,8DAA8D;QAC9D,iDAAiD;IACnD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QACtC,MAAM,OAAO,GAA4B;YACvC,OAAO,EAAE,WAAW;YACpB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,qDAAqD;YACrD,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa;SAChF,CAAC;QACF,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;YACtC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACvC,CAAC;QACD,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,UAAU;gBAChB,WAAW,MAAM,CAAC,MAAM,QAAQ,MAAM,CAAC,OAAO,SAAS;oBACvD,qEAAqE;oBACrE,+DAA+D,CAAC;QACpE,CAAC;QACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF,iCAAiC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAqB,CAAC,cAAc,CAAC,CAAC"}

package/dist/tools/report/listTemplates.js

@@ -7,6 +7,7 @@
 import { z } from "zod";
 import { listReportTemplates } from "../../client/reportApi.js";
 import { textResult } from "../types.js";
+import { CliError } from "../../errors.js";
 export const listTemplatesSchema = {
     modelCode: z
         .string()
@@ -31,9 +32,11 @@ export const listTemplatesTool = {
         }
         const target = templates.find((t) => t.modelCode === modelCode);
         if (!target) {
-            return textResult({
-                error: `未找到模板：${modelCode}`,
-                availableModelCodes: templates.map((t) => t.modelCode),
+            throw new CliError({
+                message: `未找到模板：${modelCode}`,
+                type: "not_found",
+                hint: "请从 details.availableModelCodes 中选择模板 code 后重试",
+                details: { availableModelCodes: templates.map((t) => t.modelCode) },
             });
         }
         return textResult(target);

package/dist/tools/report/listTemplates.js.map

@@ -1 +1 @@
-{"version":3,"file":"listTemplates.js","sourceRoot":"","sources":["../../../src/tools/report/listTemplates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAuB,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE,CACxE;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,sEAAsE;QACtE,4EAA4E;QAC5E,yCAAyC;IAC3C,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAI,IAAI,CAAC,SAAgC,EAAE,IAAI,EAAE,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CACf,SAAS,CAAC,GAAG,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC;gBACpC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;aACjC,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,UAAU,CAAC;gBAChB,KAAK,EAAE,SAAS,SAAS,EAAE;gBAC3B,mBAAmB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC"}
+{"version":3,"file":"listTemplates.js","sourceRoot":"","sources":["../../../src/tools/report/listTemplates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAuB,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE,CACxE;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,sEAAsE;QACtE,4EAA4E;QAC5E,yCAAyC;IAC3C,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAI,IAAI,CAAC,SAAgC,EAAE,IAAI,EAAE,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CACf,SAAS,CAAC,GAAG,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC;gBACpC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;aACjC,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC;gBACjB,OAAO,EAAE,SAAS,SAAS,EAAE;gBAC7B,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,+CAA+C;gBACrD,OAAO,EAAE,EAAE,mBAAmB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;aACpE,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC"}

package/dist/tools/types.d.ts

@@ -1,9 +1,14 @@
 /**
- * MCP 工具定义类型。
+ * MCP 工具定义类型与结果构造。
+ * 返回契约（与 lark-cli 信封思路一致）：
+ * - 成功：textResult(data)，纯业务 JSON；
+ * - 失败：errorResult/toErrorResult → isError: true + { error, type, hint?, details? }，
+ *   AI 客户端可据 isError/type 编程分支（如 auth 类错误引导调用 auth_login）。
  * 协议层由 @modelcontextprotocol/sdk 内置，工具只需声明 name/schema/执行函数。
  */
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import type { ZodRawShape } from "zod";
+import { CliError } from "../errors.js";
 export interface ToolDefinition {
     /** 工具名：<功能组>_<动作>，如 report_listTemplates */
     name: string;
@@ -11,8 +16,12 @@ export interface ToolDefinition {
     description: string;
     /** 参数 schema（zod），自动生成 JSON Schema */
     schema: ZodRawShape;
-    /** 执行函数：参数为按 schema 校验后的对象，返回 MCP CallToolResult */
+    /** 执行函数：参数为按 schema 校验后的对象，返回 MCP CallToolResult；业务错误建议抛 CliError，由 server 层统一转失败结果 */
     handler: (args: Record<string, unknown>) => Promise<CallToolResult>;
 }
-/** 把任意 JSON 序列化为文本内容块 */
+/** 把任意 JSON 序列化为文本内容块（成功结果） */
 export declare function textResult(data: unknown): CallToolResult;
+/** 构造失败结果：结构化 JSON + isError 标记 */
+export declare function errorResult(err: CliError): CallToolResult;
+/** 把任意异常统一转为失败结果（server 注册层 catch 使用；非 CliError 归为 unexpected） */
+export declare function toErrorResult(err: unknown): CallToolResult;

package/dist/tools/types.js

@@ -1,7 +1,29 @@
-/** 把任意 JSON 序列化为文本内容块 */
+import { CliError } from "../errors.js";
+/** 把任意 JSON 序列化为文本内容块（成功结果） */
 export function textResult(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
     };
 }
+/** 构造失败结果：结构化 JSON + isError 标记 */
+export function errorResult(err) {
+    const payload = { error: err.message, type: err.type };
+    if (err.hint)
+        payload.hint = err.hint;
+    if (err.details)
+        payload.details = err.details;
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        isError: true,
+    };
+}
+/** 把任意异常统一转为失败结果（server 注册层 catch 使用；非 CliError 归为 unexpected） */
+export function toErrorResult(err) {
+    if (err instanceof CliError)
+        return errorResult(err);
+    return errorResult(new CliError({
+        message: err instanceof Error ? err.message : String(err),
+        type: "unexpected",
+    }));
+}
 //# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAkBA,yBAAyB;AACzB,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAaxC,+BAA+B;AAC/B,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,WAAW,CAAC,GAAa;IACvC,MAAM,OAAO,GAA4B,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAChF,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,GAAG,YAAY,QAAQ;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,WAAW,CAChB,IAAI,QAAQ,CAAC;QACX,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACzD,IAAI,EAAE,YAAY;KACnB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/updateCheck.d.ts

@@ -0,0 +1,18 @@
+export interface UpdateInfo {
+    /** 当前版本 */
+    current: string;
+    /** registry 上的最新版本 */
+    latest: string;
+    /** 是否有新版本可用 */
+    hasUpdate: boolean;
+}
+/** 更新检查是否被禁用（OPENLIBING_NO_UPDATE_NOTIFIER=1） */
+export declare function updateCheckDisabled(): boolean;
+/** 比较 x.y.z 版本号：a > b 返回正数，相等返回 0（按数字段比较，非字符串比较） */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * 检查是否有新版本可用（24h 节流）：
+ * - 禁用 / 网络失败 → null（调用方按“无法判断”静默处理）
+ * - 其余返回 UpdateInfo（hasUpdate 表示是否落后）
+ */
+export declare function checkForUpdate(): Promise<UpdateInfo | null>;

package/dist/updateCheck.js

@@ -0,0 +1,100 @@
+/**
+ * 版本更新检查（借鉴 gh 的 24h 节流 + lark-cli 的缓存优先策略）：
+ * - 检查源：npm registry 的 latest 版本（包名从 package.json 动态读取）
+ * - 节流：结果缓存 24 小时（~/.openlibing-cli/update-check.json），避免频繁网络请求
+ * - 静默失败：网络错误 / 超时（3s）返回 null，不影响调用方主流程
+ * - 开关：OPENLIBING_NO_UPDATE_NOTIFIER=1 完全禁用检查（MCP 客户端配置 env 中设置）
+ * - 测试隔离：OPENLIBING_UPDATE_CHECK_FILE 可覆盖缓存文件路径
+ * 注意：环境变量均在调用时读取（而非模块加载时），便于测试覆盖与运行期生效。
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { APP_VERSION, PKG_NAME } from "./version.js";
+const CHECK_INTERVAL_MS = 24 * 60 * 60_000;
+const FETCH_TIMEOUT_MS = 3_000;
+function cacheFilePath() {
+    return (process.env.OPENLIBING_UPDATE_CHECK_FILE ??
+        join(homedir(), ".openlibing-cli", "update-check.json"));
+}
+/** 更新检查是否被禁用（OPENLIBING_NO_UPDATE_NOTIFIER=1） */
+export function updateCheckDisabled() {
+    return !!process.env.OPENLIBING_NO_UPDATE_NOTIFIER;
+}
+function readCache() {
+    try {
+        return JSON.parse(readFileSync(cacheFilePath(), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(state) {
+    try {
+        const file = cacheFilePath();
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, JSON.stringify(state, null, 2));
+    }
+    catch {
+        // 缓存写入失败不影响主流程（下次调用重新检查）
+    }
+}
+/** 比较 x.y.z 版本号：a > b 返回正数，相等返回 0（按数字段比较，非字符串比较） */
+export function compareVersions(a, b) {
+    const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+    const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+function toInfo(latest) {
+    return {
+        current: APP_VERSION,
+        latest,
+        hasUpdate: compareVersions(latest, APP_VERSION) > 0,
+    };
+}
+/** 从 npm registry 拉取 latest 版本号（超时/失败返回 null） */
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const url = `https://registry.npmjs.org/${encodeURIComponent(PKG_NAME)}/latest`;
+        const resp = await fetch(url, {
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        return typeof data.version === "string" ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * 检查是否有新版本可用（24h 节流）：
+ * - 禁用 / 网络失败 → null（调用方按“无法判断”静默处理）
+ * - 其余返回 UpdateInfo（hasUpdate 表示是否落后）
+ */
+export async function checkForUpdate() {
+    if (updateCheckDisabled())
+        return null;
+    const cached = readCache();
+    if (cached && Date.now() - Date.parse(cached.checkedAt) < CHECK_INTERVAL_MS) {
+        return toInfo(cached.latestVersion);
+    }
+    const latest = await fetchLatestVersion();
+    if (!latest)
+        return null;
+    writeCache({ checkedAt: new Date().toISOString(), latestVersion: latest });
+    return toInfo(latest);
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/updateCheck.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const APP_VERSION: string;
+export declare const PKG_NAME: string;

package/dist/version.js

@@ -0,0 +1,10 @@
+/**
+ * 应用元信息：统一从 package.json 动态读取，
+ * 供 CLI --version、MCP ServerInfo.version、更新检查（包名拼 registry URL）共用，
+ * 避免硬编码导致版本/包名漂移。
+ */
+import { readFileSync } from "node:fs";
+const PKG = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+export const APP_VERSION = PKG.version;
+export const PKG_NAME = PKG.name;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC7B,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,CAAC;AAC/C,MAAM,CAAC,MAAM,QAAQ,GAAW,GAAG,CAAC,IAAI,CAAC"}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@openlibing/openlibing-cli",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "OpenLibing MCP 本地 CLI：把 ops 报告等只读能力包装为 MCP 工具（stdio 传输）",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitcode.com/w30060144/openlibing-cli.git"
+  },
   "type": "module",
   "bin": {
     "openlibing-cli": "dist/index.js"
@@ -10,7 +14,8 @@
     "access": "public"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": "^20.19.0 || >=22.12.0"