@okclaw-build/cli 1.0.0-beta.5 → 1.0.0-beta.50

package/dist/output/mode.js

@@ -0,0 +1,27 @@
+/**
+ * CLI 输出模式全局状态。index.ts 解析 --output / --op-id 后注入；
+ * ndjson.ts 与 logger.ts 读取以决定行为。
+ */
+let currentMode = 'text';
+let currentOpId;
+let currentNdjsonPath;
+export function setOutputMode(mode, opId) {
+    currentMode = mode;
+    currentOpId = opId;
+}
+export function setNdjsonPath(path) {
+    currentNdjsonPath = path;
+}
+export function getOutputMode() {
+    return currentMode;
+}
+export function getOpId() {
+    return currentOpId;
+}
+export function getNdjsonPath() {
+    return currentNdjsonPath;
+}
+export function isNdjson() {
+    return currentMode === 'ndjson';
+}
+//# sourceMappingURL=mode.js.map

package/dist/output/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../src/output/mode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,IAAI,WAAW,GAAe,MAAM,CAAC;AACrC,IAAI,WAA+B,CAAC;AACpC,IAAI,iBAAqC,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,IAAa;IAC3D,WAAW,GAAG,IAAI,CAAC;IACnB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,WAAW,KAAK,QAAQ,CAAC;AAClC,CAAC"}

package/dist/output/ndjson.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Envelope 字段说明见 docs/superpowers/specs/2026-04-19-host-operation-refactor-design.md
+ * §okclaw-cli ndjson 输出契约。
+ */
+export type OpPhase = 'start' | 'step_start' | 'progress' | 'step_done' | 'log' | 'end';
+export type Level = 'debug' | 'info' | 'warn' | 'error';
+export interface NdjsonEvent {
+    ts: string;
+    seq: number;
+    op: string;
+    phase: OpPhase;
+    step?: string;
+    level: Level;
+    progress?: number;
+    msg?: string;
+    fields?: Record<string, unknown>;
+    code?: string;
+}
+export type NdjsonWriter = (line: string) => void;
+/**
+ * 单 op 的事件发射器。在 text 模式下所有方法都是 no-op；ndjson 模式才写出。
+ *
+ * 约定：
+ *   - seq 单调递增，同一 emitter 实例内唯一
+ *   - end() 只能发一次，重复调用忽略
+ *   - 非正常退出（exception/signal）由 registerExitHandlers 兜底补 end
+ */
+export declare class NdjsonEmitter {
+    private seq;
+    private readonly op;
+    private readonly writer;
+    private ended;
+    constructor(op: string, writer?: NdjsonWriter);
+    start(msg?: string, fields?: Record<string, unknown>): void;
+    stepStart(step: string, msg: string, fields?: Record<string, unknown>): void;
+    progress(step: string, progress: number, msg?: string, fields?: Record<string, unknown>): void;
+    stepDone(step: string, msg: string, fields?: Record<string, unknown>): void;
+    /**
+     * 通用日志事件。走独立 phase="log"（bug#7 修：之前借用 phase="progress" 会
+     * 污染"取 max(progress) 作为当前进度"的聚合逻辑）。用 level 区分严重度。
+     */
+    log(level: Level, msg: string, fields?: Record<string, unknown>): void;
+    /**
+     * 终态事件；必发。ok=false 时 fields 里加 errorCode（可选）。
+     * end 事件的 fields 可承载 op-specific 返回值（如 FILE_READ 的 content）。
+     */
+    end(ok: boolean, exitCode: number, code?: string, fields?: Record<string, unknown>): void;
+    hasEnded(): boolean;
+    private emit;
+}
+export declare function getActiveEmitter(): NdjsonEmitter | null;
+export declare function clearActiveEmitter(): void;
+/**
+ * 注册进程兜底，确保 ndjson 模式下 end 事件必发（plan P1 风险：忘 flush → os-api 卡死）。
+ * 只在 ndjson 模式生效。
+ */
+export declare function registerExitHandlers(emitter: NdjsonEmitter): void;

package/dist/output/ndjson.js

@@ -0,0 +1,136 @@
+import { appendFileSync } from 'node:fs';
+import { getNdjsonPath, getOpId, isNdjson } from './mode.js';
+const defaultWriter = (line) => {
+    const path = getNdjsonPath();
+    if (path) {
+        appendFileSync(path, line);
+    }
+    else {
+        process.stdout.write(line);
+    }
+};
+/**
+ * 单 op 的事件发射器。在 text 模式下所有方法都是 no-op；ndjson 模式才写出。
+ *
+ * 约定：
+ *   - seq 单调递增，同一 emitter 实例内唯一
+ *   - end() 只能发一次，重复调用忽略
+ *   - 非正常退出（exception/signal）由 registerExitHandlers 兜底补 end
+ */
+export class NdjsonEmitter {
+    seq = 0;
+    op;
+    writer;
+    ended = false;
+    constructor(op, writer = defaultWriter) {
+        this.op = op;
+        this.writer = writer;
+    }
+    start(msg = '', fields) {
+        this.emit('start', 'info', { msg, fields });
+    }
+    stepStart(step, msg, fields) {
+        this.emit('step_start', 'info', { step, msg, fields });
+    }
+    progress(step, progress, msg, fields) {
+        const clamped = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : undefined;
+        this.emit('progress', 'info', { step, progress: clamped, msg, fields });
+    }
+    stepDone(step, msg, fields) {
+        this.emit('step_done', 'info', { step, msg, fields });
+    }
+    /**
+     * 通用日志事件。走独立 phase="log"（bug#7 修：之前借用 phase="progress" 会
+     * 污染"取 max(progress) 作为当前进度"的聚合逻辑）。用 level 区分严重度。
+     */
+    log(level, msg, fields) {
+        this.emit('log', level, { msg, fields });
+    }
+    /**
+     * 终态事件；必发。ok=false 时 fields 里加 errorCode（可选）。
+     * end 事件的 fields 可承载 op-specific 返回值（如 FILE_READ 的 content）。
+     */
+    end(ok, exitCode, code, fields) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        const mergedFields = { ok, exitCode, ...(fields ?? {}) };
+        this.emit('end', ok ? 'info' : 'error', {
+            msg: ok ? 'success' : 'failed',
+            fields: mergedFields,
+            code,
+        });
+    }
+    hasEnded() {
+        return this.ended;
+    }
+    emit(phase, level, partial) {
+        if (!isNdjson())
+            return;
+        const opId = getOpId();
+        const userFields = { ...(partial.fields ?? {}) };
+        if (opId !== undefined && userFields.opId === undefined) {
+            userFields.opId = opId;
+        }
+        const event = {
+            ts: new Date().toISOString(),
+            seq: ++this.seq,
+            op: this.op,
+            phase,
+            level,
+        };
+        if (partial.step !== undefined)
+            event.step = partial.step;
+        if (partial.progress !== undefined)
+            event.progress = partial.progress;
+        if (partial.msg !== undefined && partial.msg !== '')
+            event.msg = partial.msg;
+        if (Object.keys(userFields).length > 0)
+            event.fields = userFields;
+        if (partial.code !== undefined)
+            event.code = partial.code;
+        this.writer(JSON.stringify(event) + '\n');
+    }
+}
+// bug#4 修：顶层 main().catch 里也要能拿到活 emitter 发 end 兜底。
+// registerExitHandlers 时把 emitter 挂到 module 级，exposé getActiveEmitter 给 index.ts。
+let activeEmitter = null;
+export function getActiveEmitter() {
+    return activeEmitter;
+}
+export function clearActiveEmitter() {
+    activeEmitter = null;
+}
+/**
+ * 注册进程兜底，确保 ndjson 模式下 end 事件必发（plan P1 风险：忘 flush → os-api 卡死）。
+ * 只在 ndjson 模式生效。
+ */
+export function registerExitHandlers(emitter) {
+    if (!isNdjson())
+        return;
+    activeEmitter = emitter;
+    const finalize = (exitCode, code) => {
+        if (!emitter.hasEnded()) {
+            emitter.end(false, exitCode, code);
+        }
+    };
+    process.on('uncaughtException', (err) => {
+        finalize(1, 'E_UNCAUGHT');
+        process.stderr.write(String(err?.stack ?? err) + '\n');
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        finalize(1, 'E_UNHANDLED_REJECTION');
+        process.stderr.write(String(reason) + '\n');
+        process.exit(1);
+    });
+    process.on('SIGTERM', () => {
+        finalize(143, 'E_SIGTERM');
+        process.exit(143);
+    });
+    process.on('SIGINT', () => {
+        finalize(130, 'E_SIGINT');
+        process.exit(130);
+    });
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/output/ndjson.js.map

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

package/dist/utils/constants.d.ts

@@ -4,20 +4,23 @@ export declare const OKCLAW_BACKUP_DIR = "/root/okclaw/backup";
 export declare const OKCLAW_TMP_DIR = "/root/okclaw/tmp";
 export declare const OPENCLAW_HOME = "/root/.openclaw";
 export declare const OPENCLAW_WORKSPACE = "/root/.openclaw/workspace";
+export declare const OPENCLAW_GATEWAY_PORT = 18789;
 export declare const OPENVIKING_HOME = "/root/.openviking";
 export declare const OPENVIKING_CONF = "/root/.openviking/ov.conf";
 export declare const OPENVIKING_ENV = "/root/.openclaw/openviking.env";
 export declare const OPENVIKING_PORT = 1933;
-export declare const NODE_MIN_MAJOR = 22;
-export declare const NODE_MIN_MINOR = 16;
-export declare const NODE_INSTALL_VERSION = "22.16.0";
-export declare const PYTHON_MIN_MAJOR = 3;
-export declare const PYTHON_MIN_MINOR = 11;
+export declare const NODE_MIN_MAJOR = 24;
+export declare const NODE_MIN_MINOR = 0;
+export declare const NODE_INSTALL_VERSION = "24";
 export declare const NPM_REGISTRY = "https://registry.npmmirror.com";
+export declare const CLI_NPM_REGISTRY = "https://registry.npmjs.org";
+export declare const CLI_PACKAGE = "@okclaw-build/cli";
 export declare const PIP_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple";
 export declare const PIP_TRUSTED_HOST = "pypi.tuna.tsinghua.edu.cn";
 export declare const NODE_MIRROR = "https://npmmirror.com/mirrors/node";
 export declare const JSDELIVR_GH = "https://cdn.jsdelivr.net/gh";
+export declare const NVM_VERSION = "v0.40.3";
+export declare const NVM_SH_SOURCES: string[];
 export declare const OPENVIKING_REPO = "volcengine/OpenViking";
 export declare const OPENVIKING_PLUGIN_DIR = "examples/openclaw-plugin";
 export declare const OPENVIKING_PLUGIN_REQUIRED_FILES: string[];

package/dist/utils/constants.js

@@ -5,24 +5,49 @@ export const OKCLAW_BACKUP_DIR = `${OKCLAW_HOME}/backup`;
 export const OKCLAW_TMP_DIR = `${OKCLAW_HOME}/tmp`;
 export const OPENCLAW_HOME = '/root/.openclaw';
 export const OPENCLAW_WORKSPACE = `${OPENCLAW_HOME}/workspace`;
+// openclaw gateway 默认 WebSocket 端口。gateway 进程名在不同启动方式下不固定
+// （`openclaw gateway run` → `openclaw`，systemd → `node`），所以进程识别一律
+// 按这个监听端口来，不能用 `ps -C` / `pkill -f` 匹配进程名。
+export const OPENCLAW_GATEWAY_PORT = 18789;
 export const OPENVIKING_HOME = '/root/.openviking';
 export const OPENVIKING_CONF = `${OPENVIKING_HOME}/ov.conf`;
 export const OPENVIKING_ENV = `${OPENCLAW_HOME}/openviking.env`;
 export const OPENVIKING_PORT = 1933;
-// Version requirements — slightly above official minimums
-// Official: Node >= 22.14, Python >= 3.10
-export const NODE_MIN_MAJOR = 22;
-export const NODE_MIN_MINOR = 16;
-export const NODE_INSTALL_VERSION = '22.16.0';
-export const PYTHON_MIN_MAJOR = 3;
-export const PYTHON_MIN_MINOR = 11;
+// Node baseline — standardize on the current LTS (Node 24, "Krypton").
+// openclaw keeps raising its own minimum over time (e.g. >=22.19), so any
+// host sitting on an older Node makes `openclaw onboard` fail with
+// "Node.js vX is required". Keeping the CLI's floor well ahead means a stale
+// host is auto-upgraded via nvm (see deps.ts) — never a hard error.
+export const NODE_MIN_MAJOR = 24;
+export const NODE_MIN_MINOR = 0;
+// Major-only: nvm resolves the latest 24.x LTS patch at install time, so we
+// pick up security releases without bumping a pinned version here.
+export const NODE_INSTALL_VERSION = '24';
 // China mirrors
 export const NPM_REGISTRY = 'https://registry.npmmirror.com';
+// The okclaw CLI itself is published on the public npm registry (not mirrored
+// to npmmirror reliably), so self-relocation after a Node upgrade pulls it from
+// npmjs.org — same registry os-api's preflight uses to install the CLI.
+export const CLI_NPM_REGISTRY = 'https://registry.npmjs.org';
+export const CLI_PACKAGE = '@okclaw-build/cli';
 export const PIP_INDEX_URL = 'https://pypi.tuna.tsinghua.edu.cn/simple';
 export const PIP_TRUSTED_HOST = 'pypi.tuna.tsinghua.edu.cn';
 export const NODE_MIRROR = 'https://npmmirror.com/mirrors/node';
 // jsdelivr CDN for GitHub content (works in China, GitHub raw does not)
 export const JSDELIVR_GH = 'https://cdn.jsdelivr.net/gh';
+// nvm install sources. The official install.sh clones/downloads from GitHub
+// (raw.githubusercontent.com / github.com .git) which is unreliable in China,
+// so instead we drop nvm.sh itself directly — a single self-contained file that
+// is enough for `nvm install/use/alias`. jsdelivr serves any repo file and is
+// reachable in China; gitee/github raw are fallbacks. Tried in order, each curl
+// time-bounded, and validated by running `nvm --version` (rejects HTML/redirect
+// bodies that still return 200).
+export const NVM_VERSION = 'v0.40.3';
+export const NVM_SH_SOURCES = [
+    `${JSDELIVR_GH}/nvm-sh/nvm@${NVM_VERSION}/nvm.sh`,
+    `https://gitee.com/mirrors/nvm/raw/${NVM_VERSION}/nvm.sh`,
+    `https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/nvm.sh`,
+];
 export const OPENVIKING_REPO = 'volcengine/OpenViking';
 export const OPENVIKING_PLUGIN_DIR = 'examples/openclaw-plugin';
 // Plugin files to download (same as ov-install)

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,WAAW,MAAM,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,aAAa,YAAY,CAAC;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,eAAe,UAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,aAAa,iBAAiB,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,0DAA0D;AAC1D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,0CAA0C,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEhE,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,6BAA6B,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB,EAAE,WAAW,EAAE,oBAAoB;IACtD,mBAAmB,EAAE,eAAe,EAAE,iBAAiB;IACvD,8BAA8B,EAAE,sBAAsB;IACtD,eAAe;CAChB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,iCAAiC;IACzC,iDAAiD;IACjD,mEAAmE;CACpE,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,WAAW,MAAM,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,aAAa,YAAY,CAAC;AAC/D,0DAA0D;AAC1D,kEAAkE;AAClE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,eAAe,UAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,aAAa,iBAAiB,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,uEAAuE;AACvE,0EAA0E;AAC1E,mEAAmE;AACnE,6EAA6E;AAC7E,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,4EAA4E;AAC5E,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,8EAA8E;AAC9E,gFAAgF;AAChF,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,0CAA0C,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEhE,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,6BAA6B,CAAC;AAEzD,4EAA4E;AAC5E,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,WAAW,eAAe,WAAW,SAAS;IACjD,qCAAqC,WAAW,SAAS;IACzD,gDAAgD,WAAW,SAAS;CACrE,CAAC;AACF,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB,EAAE,WAAW,EAAE,oBAAoB;IACtD,mBAAmB,EAAE,eAAe,EAAE,iBAAiB;IACvD,8BAA8B,EAAE,sBAAsB;IACtD,eAAe;CAChB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,iCAAiC;IACzC,iDAAiD;IACjD,mEAAmE;CACpE,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/utils/deps.d.ts

@@ -4,10 +4,41 @@
  */
 export declare function ensureNodeVersion(): Promise<void>;
 /**
- * Ensure Python >= PYTHON_MIN_MAJOR.PYTHON_MIN_MINOR is installed.
- * Auto-installs via system package manager if missing or too old.
+ * 升级 default node 后,把 okclaw CLI 也装到新 default 下。
+ *
+ * 为什么必须做:CLI 最初由 os-api preflight 装在升级前的旧 node(如 22.x)的全局
+ * 目录里;`nvm alias default 24` 之后,os-api 用新 shell(只 source nvm → auto-use
+ * default 24)再调 `okclaw stop/start/status` 时,新 default 下找不到 okclaw →
+ * "command not found",迁移会从 bootstrap 之后的步骤失败。把 CLI 重装到新 default
+ * 下,让 okclaw 和 openclaw 都落在 node 24,os-api 侧无需任何改动。
+ *
+ * 版本固定为当前正在运行的 CLI 自身版本:`@okclaw-build/cli` 的 latest dist-tag 并非
+ * 最新版,裸装会回退到旧版本,必须显式 pin。
+ *
+ * 失败必须抛、不能吞:relocation 是"升级完成"的一部分。若只 warn 放过,okclaw check
+ * 仍会成功返回,但 default node 下没有 okclaw —— openclaw 这次能在 24 跑起来,可
+ * 之后 os-api 用新 shell 调 okclaw 会以 "command not found" 在更晚、更难定位的步骤
+ * (迁移 target:stop 等)失败;且此时 node 已是 24,下一次 okclaw check 会直接
+ * early-return、永不重试 relocation,这个半坏状态自己解不开。所以用 shellRetry 吸收
+ * 瞬时抖动,重试仍失败就抛,让 okclaw check 在 bootstrap 早早干净失败(可重试),
+ * 而不是留下半坏主机。
+ *
+ * shell 副作用经 {@link RelocateCliDeps} 注入(沿用 openviking-purge 的 deps 约定),
+ * 让"失败必抛 + 重装后校验可解析"这条契约可单测。
  */
-export declare function ensurePython(): Promise<void>;
+export interface RelocateCliDeps {
+    /** 把指定 spec 装到当前 default node 全局(默认 shellRetry npm install)。 */
+    installGlobal: (spec: string) => Promise<void>;
+    /** 校验 okclaw 在当前 default node 下可解析(默认 commandExists)。 */
+    isResolvable: () => Promise<boolean>;
+}
+export declare function relocateCliToDefaultNode(deps?: Partial<RelocateCliDeps>): Promise<void>;
+/**
+ * 把版本号格式化成 CLI 安装 spec。有版本则 pin 成 `@okclaw-build/cli@<version>`;
+ * 读不到版本(空/缺失)时回退到 `@beta` dist-tag —— 绝不用裸包名,因为
+ * `@okclaw-build/cli` 的 latest tag 指向的不是最新版,裸装会回退到旧版本。
+ */
+export declare function formatCliSpec(version: string | null | undefined): string;
 /**
  * Ensure a command exists on PATH.
  */

package/dist/utils/deps.js

@@ -1,6 +1,7 @@
-import { shell, shellCapture, commandExists } from './shell.js';
+import { readFileSync } from 'node:fs';
+import { shell, shellRetry, shellCapture, commandExists } from './shell.js';
 import { info, warn } from './logger.js';
-import { NODE_MIN_MAJOR, NODE_MIN_MINOR, NODE_INSTALL_VERSION, NODE_MIRROR, PYTHON_MIN_MAJOR, PYTHON_MIN_MINOR, } from './constants.js';
+import { NODE_MIN_MAJOR, NODE_MIN_MINOR, NODE_INSTALL_VERSION, NODE_MIRROR, NVM_SH_SOURCES, CLI_NPM_REGISTRY, CLI_PACKAGE, } from './constants.js';
 /**
  * Ensure Node.js >= NODE_MIN_MAJOR.NODE_MIN_MINOR is installed via nvm.
  * Installs nvm first if not present, then installs Node.js through nvm.
@@ -21,6 +22,49 @@ export async function ensureNodeVersion() {
     }
     await ensureNvm();
     await installNodejs();
+    await relocateCliToDefaultNode();
+}
+function relocateCliDeps(deps = {}) {
+    return {
+        installGlobal: deps.installGlobal
+            ?? ((spec) => shellRetry(`npm install -g ${spec} --registry ${CLI_NPM_REGISTRY} --no-audit --no-fund`)),
+        isResolvable: deps.isResolvable ?? (() => commandExists('okclaw')),
+    };
+}
+export async function relocateCliToDefaultNode(deps = {}) {
+    const d = relocateCliDeps(deps);
+    const spec = cliPackageSpec();
+    info(`Relocating okclaw CLI (${spec}) onto the upgraded default Node...`);
+    await d.installGlobal(spec); // shellRetry 抖动重试;彻底失败直接抛(不 catch)
+    // 校验真的在升级后的 default node 下可解析(npm 偶发 exit 0 但 bin 没就位)。
+    if (!(await d.isResolvable())) {
+        throw new Error(`okclaw CLI not resolvable under the upgraded default Node after relocate (${spec})`);
+    }
+    info('okclaw CLI relocated onto default Node ✓');
+}
+/**
+ * 把版本号格式化成 CLI 安装 spec。有版本则 pin 成 `@okclaw-build/cli@<version>`;
+ * 读不到版本(空/缺失)时回退到 `@beta` dist-tag —— 绝不用裸包名,因为
+ * `@okclaw-build/cli` 的 latest tag 指向的不是最新版,裸装会回退到旧版本。
+ */
+export function formatCliSpec(version) {
+    if (typeof version === 'string' && version.length > 0) {
+        return `${CLI_PACKAGE}@${version}`;
+    }
+    return `${CLI_PACKAGE}@beta`;
+}
+/** 当前正在运行的 CLI 自身的安装 spec。 */
+function cliPackageSpec() {
+    let version = null;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        if (typeof pkg.version === 'string')
+            version = pkg.version;
+    }
+    catch {
+        // ignore — formatCliSpec falls back to the @beta tag
+    }
+    return formatCliSpec(version);
 }
 const NVM_DIR = '/root/.nvm';
 async function ensureNvm() {
@@ -31,17 +75,22 @@ async function ensureNvm() {
         return;
     }
     info('nvm not found, installing...');
-    // Install nvm from gitee mirror (GitHub is unreliable in China)
-    await shell(`curl -fsSL https://gitee.com/mirrors/nvm/raw/master/install.sh | PROFILE=/dev/null NVM_DIR=${NVM_DIR} bash`).catch(async () => {
-        // Fallback: npmmirror hosted nvm install script
-        info('Retrying nvm install from npmmirror...');
-        await shell(`curl -fsSL https://npmmirror.com/mirrors/nvm/v0.40.3/install.sh | PROFILE=/dev/null NVM_DIR=${NVM_DIR} bash`);
-    });
-    // Verify
-    const verify = await shellCapture('nvm --version');
-    if (verify.code !== 0)
-        throw new Error('nvm installation failed');
-    info(`nvm ${verify.stdout.trim()} installed ✓`);
+    // 不跑官方 install.sh：它内部从 GitHub clone/下载，国内不可靠且无超时会卡住部署。
+    // 直接把 nvm.sh 本体落到 $NVM_DIR（单文件即可支撑 nvm install/use/alias）。
+    // 多源按序尝试，每个 curl 带 --connect-timeout/--max-time 快速失败，并用
+    // `nvm --version` 校验真的拿到了可用 nvm（镜像偶发返回重定向/HTML 也是 200）。
+    for (const src of NVM_SH_SOURCES) {
+        const dl = await shellCapture(`mkdir -p ${NVM_DIR} && curl -fsSL --connect-timeout 10 --max-time 60 '${src}' -o ${NVM_DIR}/nvm.sh`);
+        if (dl.code === 0) {
+            const verify = await shellCapture('nvm --version');
+            if (verify.code === 0) {
+                info(`nvm ${verify.stdout.trim()} installed (source: ${src}) ✓`);
+                return;
+            }
+        }
+        warn(`nvm source unavailable, trying next: ${src}`);
+    }
+    throw new Error('nvm installation failed: all sources unreachable (jsdelivr/gitee/github)');
 }
 async function installNodejs() {
     info(`Installing Node.js ${NODE_INSTALL_VERSION} via nvm...`);
@@ -55,79 +104,6 @@ async function installNodejs() {
         throw new Error('Node.js installation failed: node command not found');
     info(`Node.js ${verify.stdout.trim()} installed via nvm ✓`);
 }
-/**
- * Ensure Python >= PYTHON_MIN_MAJOR.PYTHON_MIN_MINOR is installed.
- * Auto-installs via system package manager if missing or too old.
- */
-export async function ensurePython() {
-    const required = `${PYTHON_MIN_MAJOR}.${PYTHON_MIN_MINOR}`;
-    const result = await shellCapture('python3 --version');
-    if (result.code === 0) {
-        const match = result.stdout.match(/(\d+)\.(\d+)\.?(\d+)?/);
-        if (match) {
-            const version = `${match[1]}.${match[2]}`;
-            if (versionGe(version, required)) {
-                info(`Python ${result.stdout.trim()} >= ${required} ✓`);
-                await ensurePip();
-                return;
-            }
-            warn(`Python ${version} < ${required}, upgrading...`);
-        }
-    }
-    else {
-        info('Python3 not found, installing...');
-    }
-    await installPython();
-    await ensurePip();
-}
-async function installPython() {
-    const required = `${PYTHON_MIN_MAJOR}.${PYTHON_MIN_MINOR}`;
-    info(`Installing Python >= ${required}...`);
-    if (await commandExists('apt-get')) {
-        // Try deadsnakes PPA for newer Python on older Ubuntu
-        await shell('apt-get update -qq').catch(() => { });
-        await shell('apt-get install -y -qq python3 python3-pip python3-venv python3-dev').catch(async () => {
-            info('Trying deadsnakes PPA...');
-            await shell('apt-get install -y -qq software-properties-common').catch(() => { });
-            await shell('add-apt-repository -y ppa:deadsnakes/ppa').catch(() => { });
-            await shell('apt-get update -qq');
-            await shell('apt-get install -y -qq python3 python3-pip python3-venv python3-dev');
-        });
-    }
-    else if (await commandExists('dnf')) {
-        await shell('dnf install -y python3 python3-pip python3-devel');
-    }
-    else if (await commandExists('yum')) {
-        await shell('yum install -y python3 python3-pip python3-devel');
-    }
-    else {
-        throw new Error(`Cannot install Python: no supported package manager. Install Python >= ${required} manually.`);
-    }
-    // Verify
-    const verify = await shellCapture('python3 --version');
-    if (verify.code !== 0)
-        throw new Error('Python installation failed');
-    const match = verify.stdout.match(/(\d+)\.(\d+)/);
-    if (match && !versionGe(`${match[1]}.${match[2]}`, required)) {
-        throw new Error(`Installed Python ${match[1]}.${match[2]} still below ${required}. Install manually.`);
-    }
-    info(`Python ${verify.stdout.trim()} installed ✓`);
-}
-/**
- * Ensure pip is available.
- */
-async function ensurePip() {
-    const result = await shellCapture('python3 -m pip --version');
-    if (result.code === 0)
-        return;
-    info('pip not found, installing...');
-    await shell('curl -fsSL https://bootstrap.pypa.io/get-pip.py | python3').catch(async () => {
-        await installSystemPackages(['python3-pip']);
-    });
-    const verify = await shellCapture('python3 -m pip --version');
-    if (verify.code !== 0)
-        throw new Error('Failed to install pip');
-}
 /**
  * Ensure a command exists on PATH.
  */
@@ -147,20 +123,6 @@ export async function checkDiskSpace(requiredMb) {
     }
 }
 // ---- helpers ----
-async function installSystemPackages(packages) {
-    if (await commandExists('apt-get')) {
-        await shell(`apt-get update -qq && apt-get install -y -qq ${packages.join(' ')}`);
-    }
-    else if (await commandExists('dnf')) {
-        await shell(`dnf install -y ${packages.join(' ')}`);
-    }
-    else if (await commandExists('yum')) {
-        await shell(`yum install -y ${packages.join(' ')}`);
-    }
-    else {
-        throw new Error(`Cannot install packages: no supported package manager`);
-    }
-}
 function versionGe(a, b) {
     const pa = a.split('.').map(Number);
     const pb = b.split('.').map(Number);

package/dist/utils/deps.js.map

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

package/dist/utils/logger.d.ts

@@ -1,3 +1,13 @@
+/**
+ * 人类可读 log。
+ *
+ * ndjson 模式下：所有业务级 log（info / warn / success / error）静默。
+ *   - info/warn/success 本就无关紧要，静默避免污染 stdout 结构化流
+ *   - error 也静默（bug#5 修）：业务错误必须通过 emitter.end(false, code, { error: msg }) 承载，
+ *     与 design 契约对齐（stderr 仅给真正的崩溃栈，由 registerExitHandlers 的 uncaughtException 打印）
+ *
+ * 调用方注意：ndjson 模式下调 error(msg) 不会让用户看见消息，务必把 msg 塞进 emitter.end 的 fields。
+ */
 export declare function info(msg: string): void;
 export declare function warn(msg: string): void;
 export declare function error(msg: string): void;