@openturtle/cli 0.3.0 → 0.3.1

package/README.md

@@ -12,6 +12,23 @@ OpenTurtle CLI 是一个本地命令行工具。它让你不安装 Desktop，也
 npm install --global @openturtle/cli
 ```
 
+CLI 启动时会在后台检查 npm 新版本，最多每 24 小时检查一次。检查不会阻塞当前命令；发现新版本后会通过 npm 自动完成全局升级。
+
+也可以手动检查或立即升级：
+
+```bash
+ot update --check
+ot update
+```
+
+需要关闭启动时自动更新时，设置：
+
+```bash
+export OPENTURTLE_DISABLE_AUTO_UPDATE=1
+```
+
+源码运行、`pnpm link` 等开发安装不会被自动覆盖。自动更新状态记录在 `~/.openturtle/cli/update.json`。
+
 临时使用、不全局安装时：
 
 ```bash

package/dist/core/auto-update-worker.js

@@ -0,0 +1,5 @@
+import { runAutomaticUpdate } from './auto-update.js';
+import { cliVersion } from './version.js';
+void runAutomaticUpdate(cliVersion()).catch(() => {
+    process.exitCode = 1;
+});

package/dist/core/auto-update.js

@@ -0,0 +1,176 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { cliGlobalDir, ensureFileDir } from './paths.js';
+export const AUTO_UPDATE_INTERVAL_MS = 24 * 60 * 60 * 1000;
+export const CLI_PACKAGE_NAME = '@openturtle/cli';
+export const NPM_REGISTRY_URL = 'https://registry.npmjs.org';
+const packageRoot = path.dirname(fileURLToPath(new URL('../../package.json', import.meta.url)));
+export function compareStableVersions(left, right) {
+    const leftParts = parseStableVersion(left);
+    const rightParts = parseStableVersion(right);
+    return leftParts[0] - rightParts[0] || leftParts[1] - rightParts[1] || leftParts[2] - rightParts[2];
+}
+export function isUpdateDue(lastCheckedAt, now = Date.now()) {
+    if (!lastCheckedAt)
+        return true;
+    const checkedAt = Date.parse(lastCheckedAt);
+    return !Number.isFinite(checkedAt) || now - checkedAt >= AUTO_UPDATE_INTERVAL_MS;
+}
+export function isManagedNpmInstall(root = packageRoot) {
+    const normalized = root.split(path.sep).join('/');
+    if (!normalized.includes('/node_modules/@openturtle/cli'))
+        return false;
+    try {
+        return fs.statSync(root).isDirectory() && !fs.lstatSync(root).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+export function npmUpdateArgs() {
+    return [
+        'install',
+        '--global',
+        `${CLI_PACKAGE_NAME}@latest`,
+        `--registry=${NPM_REGISTRY_URL}`,
+        '--no-audit',
+        '--no-fund',
+    ];
+}
+export async function updateCli(currentVersion, options = {}, dependencies = {}) {
+    const latest = await fetchLatestVersion(dependencies.fetchImpl);
+    if (!latest) {
+        return { current: currentVersion, latest: null, available: false, updated: false, reason: 'not_published' };
+    }
+    const available = compareStableVersions(latest, currentVersion) > 0;
+    if (!available || options.check) {
+        return {
+            current: currentVersion,
+            latest,
+            available,
+            updated: false,
+            reason: available ? undefined : 'current',
+        };
+    }
+    if (!isManagedNpmInstall(dependencies.packageRoot)) {
+        return {
+            current: currentVersion,
+            latest,
+            available: true,
+            updated: false,
+            reason: 'local_development',
+        };
+    }
+    await (dependencies.runNpmInstall || runNpmInstall)(npmUpdateArgs());
+    return { current: currentVersion, latest, available: true, updated: true };
+}
+export function scheduleAutomaticUpdate(currentVersion, dependencies = {}) {
+    try {
+        const env = dependencies.env || process.env;
+        const argv = dependencies.argv || process.argv;
+        if (env.OPENTURTLE_DISABLE_AUTO_UPDATE === '1' || env.OPENTURTLE_AUTO_UPDATE_WORKER === '1')
+            return false;
+        if (argv[2] === 'update' || !isManagedNpmInstall(dependencies.packageRoot))
+            return false;
+        const statePath = dependencies.statePath || updateStatePath();
+        const state = readUpdateState(statePath);
+        const now = dependencies.now || Date.now();
+        if (!isUpdateDue(state?.checked_at, now))
+            return false;
+        writeUpdateState({
+            checked_at: new Date(now).toISOString(),
+            current_version: currentVersion,
+            latest_version: state?.latest_version || null,
+            status: 'checking',
+        }, statePath);
+        const workerPath = dependencies.workerPath || fileURLToPath(new URL('./auto-update-worker.js', import.meta.url));
+        const workerEnv = { ...env, OPENTURTLE_AUTO_UPDATE_WORKER: '1' };
+        (dependencies.spawnWorker || spawnUpdateWorker)(workerPath, workerEnv);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runAutomaticUpdate(currentVersion, statePath = updateStatePath()) {
+    try {
+        const result = await updateCli(currentVersion);
+        writeUpdateState({
+            checked_at: new Date().toISOString(),
+            current_version: currentVersion,
+            latest_version: result.latest,
+            status: result.updated ? 'updated' : result.reason === 'not_published' ? 'unavailable' : 'current',
+        }, statePath);
+        return result;
+    }
+    catch (error) {
+        writeUpdateState({
+            checked_at: new Date().toISOString(),
+            current_version: currentVersion,
+            latest_version: null,
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error),
+        }, statePath);
+        throw error;
+    }
+}
+export function updateStatePath(homeDir) {
+    return path.join(cliGlobalDir(homeDir), 'update.json');
+}
+export function readUpdateState(statePath = updateStatePath()) {
+    try {
+        return JSON.parse(fs.readFileSync(statePath, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeUpdateState(state, statePath = updateStatePath()) {
+    ensureFileDir(statePath);
+    fs.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+}
+async function fetchLatestVersion(fetchImpl = fetch) {
+    const packagePath = encodeURIComponent(CLI_PACKAGE_NAME).replace('%40', '@');
+    const response = await fetchImpl(`${NPM_REGISTRY_URL}/${packagePath}/latest`, {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (response.status === 404)
+        return null;
+    if (!response.ok)
+        throw new Error(`npm registry returned HTTP ${response.status}`);
+    const metadata = (await response.json());
+    if (!metadata.version)
+        throw new Error('npm registry response did not include a version');
+    parseStableVersion(metadata.version);
+    return metadata.version;
+}
+function parseStableVersion(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version.trim());
+    if (!match)
+        throw new Error(`Expected a stable semantic version, received: ${version}`);
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function runNpmInstall(args) {
+    const command = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: 'inherit' });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`npm update failed (${signal || `exit ${code ?? 'unknown'}`})`));
+        });
+    });
+}
+function spawnUpdateWorker(workerPath, env) {
+    const child = spawn(process.execPath, [workerPath], {
+        detached: true,
+        env,
+        stdio: 'ignore',
+    });
+    child.unref();
+}

package/dist/index.js

@@ -5,6 +5,7 @@ import { registerCollaborationCommands } from './commands/collaboration.js';
 import { ingestRawHook, recordGitPostCommit } from './commands/hook.js';
 import { doctor, draftDailyReport, createResourceCommands } from './commands/resources.js';
 import { ApiClient, ApiError } from './core/api-client.js';
+import { scheduleAutomaticUpdate, updateCli } from './core/auto-update.js';
 import { clearAuth, readAuth, redactToken, writeAuth } from './core/auth.js';
 import { DEFAULT_SERVER_URL } from './core/defaults.js';
 import { findWorkspaceRoot } from './core/paths.js';
@@ -22,6 +23,13 @@ program
     .description('OpenTurtle collaboration, knowledge, meeting, and local agent CLI')
     .version(cliVersion());
 program.option('-j, --json', 'emit machine-readable JSON, including errors');
+program
+    .command('update')
+    .description('check npm for a newer CLI and install it')
+    .option('--check', 'check for an update without installing it')
+    .action(action(async (options) => {
+    print(await updateCli(cliVersion(), { check: Boolean(options.check) }));
+}));
 program
     .command('init')
     .option('--update-gitignore', 'append .openturtle-cli to .gitignore')
@@ -341,6 +349,7 @@ program
     }
     throw new Error('Usage: ot mcp serve');
 }));
+scheduleAutomaticUpdate(cliVersion());
 if (!runSpecialNestedCommand(process.argv)) {
     try {
         program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openturtle/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "OpenTurtle collaboration, knowledge, meeting, and agent CLI",
   "keywords": [
     "openturtle",