pdlab-cli 0.3.0 → 0.4.0

package/README.md

@@ -149,6 +149,22 @@ API 地址的解析顺序：`--api-url` 参数 > `PDLAB_API_URL` 环境变量 >
 作者也才能 `post get` 到自己那篇还没过审的稿子。没登录则匿名读公开内容，照常可用。
 在 CI 里可以只给环境变量，不落配置文件。
 
+## 版本更新提示
+
+`pdlab` 每次运行都会顺手看一眼本地缓存的版本信息，如果有新版本会在命令结束时打印一行提示到
+**stderr**（不影响 stdout 的 JSON 输出，脚本/agent 该怎么解析还怎么解析）：
+
+```
+※ pdlab-cli 有新版本可用：0.3.0 → 0.4.0
+  运行 npm install -g pdlab-cli@latest 升级（可用 PDLAB_NO_UPDATE_CHECK=1 关闭此提示）
+```
+
+这个检查本身不会拖慢任何命令：真正去问 npm registry 的动作放在一个独立的后台进程里做，
+每 24 小时最多问一次，前台命令只读本地缓存（一次磁盘读，微秒级）。离线或连不上 registry
+时静默跳过，不影响命令本身的执行结果。
+
+不想看到这个提示：设置环境变量 `PDLAB_NO_UPDATE_CHECK=1`（CI/自动化脚本建议直接设置）。
+
 ## 凭证与安全
 
 - **凭证怎么来的**：走设备码授权——CLI 生成一次性 code，你在浏览器里确认后服务端才签发。

package/dist/index.js

@@ -24,8 +24,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_fs2 = require("fs");
-var import_path2 = require("path");
+var import_fs3 = require("fs");
+var import_path3 = require("path");
 var import_commander2 = require("commander");
 
 // src/commands/login.ts
@@ -975,6 +975,9 @@ function exitCodeTable() {
   }
   return table;
 }
+function isInternalCommand(command) {
+  return command.name().startsWith("__");
+}
 function serialize(command) {
   const meta = getMeta(command);
   return {
@@ -984,7 +987,7 @@ function serialize(command) {
     arguments: command.registeredArguments.map((a) => ({ name: a.name(), required: a.required })),
     options: command.options.map((o) => ({ flags: o.flags, description: o.description, required: o.mandatory })),
     examples: meta.examples ?? [],
-    subcommands: command.commands.map(serialize)
+    subcommands: command.commands.filter((c) => !isInternalCommand(c)).map(serialize)
   };
 }
 function registerSchemaCommand(program2) {
@@ -993,7 +996,7 @@ function registerSchemaCommand(program2) {
       JSON.stringify(
         {
           exitCodes: exitCodeTable(),
-          commands: program2.commands.map(serialize)
+          commands: program2.commands.filter((c) => !isInternalCommand(c)).map(serialize)
         },
         null,
         2
@@ -1002,8 +1005,96 @@ function registerSchemaCommand(program2) {
   });
 }
 
+// src/update-check.ts
+var import_fs2 = require("fs");
+var import_child_process = require("child_process");
+var import_path2 = require("path");
+var CACHE_FILE = (0, import_path2.join)(CONFIG_DIR, "update-check.json");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+function readUpdateCache() {
+  if (!(0, import_fs2.existsSync)(CACHE_FILE)) return { lastCheckedAt: 0 };
+  try {
+    return JSON.parse((0, import_fs2.readFileSync)(CACHE_FILE, "utf8"));
+  } catch {
+    return { lastCheckedAt: 0 };
+  }
+}
+function writeUpdateCache(cache) {
+  if (!(0, import_fs2.existsSync)(CONFIG_DIR)) (0, import_fs2.mkdirSync)(CONFIG_DIR, { recursive: true, mode: 448 });
+  (0, import_fs2.writeFileSync)(CACHE_FILE, JSON.stringify(cache, null, 2));
+}
+function parseVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isNewerVersion(candidate, current) {
+  const a = parseVersion(candidate);
+  const b = parseVersion(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    if (a[i] !== b[i]) return a[i] > b[i];
+  }
+  return false;
+}
+async function fetchLatestVersion(packageName) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(`https://registry.npmjs.org/-/package/${packageName}/dist-tags`, {
+      signal: controller.signal
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.latest ?? null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function refreshUpdateCache(packageName) {
+  const latestVersion = await fetchLatestVersion(packageName);
+  const previous = readUpdateCache();
+  writeUpdateCache({
+    lastCheckedAt: Date.now(),
+    latestVersion: latestVersion ?? previous.latestVersion
+  });
+}
+function spawnBackgroundRefresh(packageName) {
+  try {
+    const entry = process.argv[1];
+    if (!entry) return;
+    const child = (0, import_child_process.spawn)(process.execPath, [entry, "__update-check-worker", packageName], {
+      detached: true,
+      stdio: "ignore"
+    });
+    child.unref();
+  } catch {
+  }
+}
+function notifyIfUpdateAvailable(currentVersion, packageName) {
+  if (process.env.PDLAB_NO_UPDATE_CHECK) return;
+  try {
+    const cache = readUpdateCache();
+    if (cache.latestVersion && isNewerVersion(cache.latestVersion, currentVersion)) {
+      console.error(
+        `
+\u203B ${packageName} \u6709\u65B0\u7248\u672C\u53EF\u7528\uFF1A${currentVersion} \u2192 ${cache.latestVersion}
+  \u8FD0\u884C npm install -g ${packageName}@latest \u5347\u7EA7\uFF08\u53EF\u7528 PDLAB_NO_UPDATE_CHECK=1 \u5173\u95ED\u6B64\u63D0\u793A\uFF09
+`
+      );
+    }
+    if (Date.now() - cache.lastCheckedAt > CHECK_INTERVAL_MS) {
+      spawnBackgroundRefresh(packageName);
+    }
+  } catch {
+  }
+}
+
 // src/index.ts
-var pkg = JSON.parse((0, import_fs2.readFileSync)((0, import_path2.join)(__dirname, "../package.json"), "utf8"));
+var pkg = JSON.parse((0, import_fs3.readFileSync)((0, import_path3.join)(__dirname, "../package.json"), "utf8"));
 var program = new import_commander2.Command();
 program.name("pdlab").description("1836 \u5F00\u6E90\u5171\u5EFA\u5E73\u53F0\u547D\u4EE4\u884C\u5DE5\u5177\u2014\u2014\u662F\u73B0\u6709 REST API \u7684\u8584\u5C01\u88C5\u3002\u7ED9 agent/\u811A\u672C\u7528\uFF1Apdlab schema \u4E00\u6B21\u6027\u5217\u51FA\u5168\u90E8\u547D\u4EE4\u3001\u53C2\u6570\u4E0E\u9000\u51FA\u7801\u542B\u4E49\u3002").version(pkg.version);
 program.exitOverride();
@@ -1018,6 +1109,11 @@ registerProjectCommand(program);
 registerPostCommand(program);
 registerTaxonomyCommand(program);
 registerSchemaCommand(program);
+program.command("__update-check-worker <packageName>", { hidden: true }).action(async (packageName) => {
+  await refreshUpdateCache(packageName);
+  process.exit(0);
+});
+notifyIfUpdateAvailable(pkg.version, "pdlab-cli");
 program.parseAsync(process.argv).catch((error) => {
   if (error instanceof import_commander2.CommanderError && error.exitCode === 0) {
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdlab-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "private": false,
   "description": "1836 开源共建平台（problem-driven-lab）的命令行工具：项目、内容的增删改查，浏览器授权登录",
   "keywords": [