@bolloon/bolloon-agent 0.5.2 → 0.5.4

package/dist/cli/update-commands.js

@@ -14,7 +14,7 @@
  */
 import { resolveBolloonHome } from '../setup/setup-store.js';
 import { collectVersionInfo, renderVersionText, renderVersionJson, DEV_CHANNEL_WARNING, DEV_BACK_TO_STABLE_HINT, channelKindOf, isDevIdentity, } from '../utils/version-info.js';
-import { checkForUpdate, buildUpdatePlan, renderUpdatePlan, applyUpdate, readUpdateStatus, readHistory, renderHistory, updateSummaryFor, compareVersions, checkExitCode, REFUSED_STATUSES, } from '../utils/update-manager.js';
+import { checkForUpdate, buildUpdatePlan, renderUpdatePlan, applyUpdate, readUpdateStatus, readHistory, renderHistory, updateSummaryFor, compareVersions, REFUSED_STATUSES, } from '../utils/update-manager.js';
 import { renderGithubReportLine } from '../utils/dual-source.js';
 import { runDoctor, renderDoctor } from '../utils/update-health.js';
 import { detectRuntimeReport, bootstrapRuntimes, renderRuntimeReport, renderBootstrapPlan, RUNTIME_MIN, readRuntimeConfigWithFallback, } from '../utils/runtime-bootstrap.js';
@@ -148,7 +148,7 @@ export function renderCheckResult(r) {
         L.push(`说明: ${r.reason}`);
     L.push('');
     if (r.status === 'update_available') {
-        L.push(`下一步: ${BOLD}bolloon update plan --channel ${r.channel}${RESET} 看计划, ${BOLD}bolloon update now --channel ${r.channel}${RESET} 执行更新`);
+        L.push(`下一步: ${BOLD}bolloon update --channel ${r.channel}${RESET} 直接更新 (会先打印计划与风险检查); 只想看计划不动任何东西: ${BOLD}bolloon update --dry-run${RESET}`);
         if (dev)
             L.push(DEV_CHANNEL_WARNING), L.push(DEV_BACK_TO_STABLE_HINT);
     }
@@ -183,7 +183,7 @@ export function renderStatusReport(s) {
         : 'stable (npm registry)'}`);
     L.push(`身份标识:   ${dev ? `commit ${s.installedDevSha || '未知'}` : s.currentVersion}`);
     L.push(`能切回:     ${s.switchableTo
-        ? `${s.switchableTo.channel} (${s.switchableTo.source}${s.switchableTo.target ? ` @ ${s.switchableTo.target}` : ''}) — 一键切: bolloon update now --channel ${s.switchableTo.channel}`
+        ? `${s.switchableTo.channel} (${s.switchableTo.source}${s.switchableTo.target ? ` @ ${s.switchableTo.target}` : ''}) — 一键切: bolloon update --channel ${s.switchableTo.channel}`
         : '无 (未知来源)'}`);
     if (s.lastDevSha && !dev)
         L.push(`上次 dev:   commit ${s.lastDevSha}${s.devCheckedAt ? ` @ ${s.devCheckedAt}` : ''} (已切回 stable)`);
@@ -218,7 +218,7 @@ export function renderStatusReport(s) {
 // ── update 子命令 ───────────────────────────────────────────────────────────
 export async function runUpdateCommand(args = []) {
     const home = resolveBolloonHome();
-    // 裸词优先 (bolloon update plan / status / history / now / wait / force / json / --channel dev),
+    // 裸词优先 (bolloon update / status / history / wait / force / dry-run / json / --channel dev),
     // 同时兼容旧的 --plan / --status / ... 写法 (已有脚本不断裂)。
     const has = (...f) => f.some((x) => args.includes(x));
     const json = has('json', '--json');
@@ -228,6 +228,28 @@ export async function runUpdateCommand(args = []) {
         return 2;
     }
     const channel = ch.channel;
+    // `update --help` 必须是**只读**的 (三合一后默认会真装, 这条不拦就会「看帮助反而装了东西」)
+    if (has('help', '-h', '--help')) {
+        out(UPDATE_HELP.trim());
+        return 0;
+    }
+    /**
+     * 防误触 (2026-09-28, 与三合一同时加的): `update` 现在**默认就执行更新** ——
+     * 于是打错一个词 (如 `bolloon update plna`) 会直接装东西, 这是不可接受的。
+     * 白名单之外、又不是数字、又不是 --channel 的取值的裸词 ⇒ 拒绝执行并打用法。
+     */
+    {
+        const KNOWN_BARE = new Set(['status', 'history', 'wait', 'force', 'dry-run', 'plan', 'json', 'now']);
+        const valIdx = new Set();
+        args.forEach((a, i) => { if (a === '--channel' || a === 'channel')
+            valIdx.add(i + 1); });
+        const unknown = args.filter((a, i) => !a.startsWith('-') && !KNOWN_BARE.has(a) && !/^\d+$/.test(a) && !valIdx.has(i));
+        if (unknown.length > 0) {
+            err(`${RED}✗ 不认识 ${BOLD}update ${unknown[0]}${RESET} —— 已拒绝执行 (什么都没装)`);
+            err(`  用法: bolloon update [wait|force] [--dry-run|status|history [N]] [--channel stable|dev]`);
+            return 2;
+        }
+    }
     // ── 状态 ──
     if (has('status', '--status')) {
         const s = await readUpdateStatus({ home, channel });
@@ -250,8 +272,9 @@ export async function runUpdateCommand(args = []) {
         out(renderHistory(recs));
         return 0;
     }
-    // ── 计划 ──
-    if (has('plan', '--plan')) {
+    // ── 只读: --dry-run (2026-09-28 leo: `update` 三个动作合成一个, 默认直接执行;
+    //    只读位改由 `--dry-run` 承接 —— 旧写法 `plan`/`--plan` 等价于它, **只打印、不装任何东西**) ──
+    if (has('dry-run', '--dry-run', 'plan', '--plan')) {
         const plan = await buildUpdatePlan({ home, force: true, channel });
         if (json) {
             out(JSON.stringify(plan, null, 2));
@@ -260,10 +283,15 @@ export async function runUpdateCommand(args = []) {
         out(renderUpdatePlan(plan));
         if (plan.channelKind === 'git-ref')
             printDevNotice();
+        out('');
+        out(`${YELLOW}本次只打印计划, 没有安装任何东西${RESET} —— 要真更新就运行 ${BOLD}bolloon update${RESET}`);
         return 0;
     }
-    // ── 执行 ──
-    if (has('now', '--now')) {
+    // ── 默认动作 (三合一): 计划 + 风险检查 + 直接执行 ──
+    {
+        if (has('now', '--now')) {
+            out(`${YELLOW}提示${RESET}: \`now\` 已去掉 —— \`bolloon update\` 现在直接执行更新 (本条按新行为继续)。`);
+        }
         const wait = has('wait', '--wait');
         const force = has('force', '--force', '-f');
         const plan = await buildUpdatePlan({ home, force: true, channel });
@@ -332,18 +360,6 @@ export async function runUpdateCommand(args = []) {
             err(`  已回滚到 ${res.from}`);
         return 1;
     }
-    // ── 默认: 只检查, 给清晰结论 (显式命令 = 忽略节流) ──
-    const r = await checkForUpdate({ home, force: true, channel });
-    if (json) {
-        out(JSON.stringify(r, null, 2));
-        return checkExitCode(r.status);
-    }
-    out(renderCheckResult(r));
-    if (r.status !== 'up_to_date' && r.status !== 'check_skipped') {
-        out('');
-        out(`${YELLOW}提示${RESET}: 本次只检查, 没有安装任何东西。`);
-    }
-    return checkExitCode(r.status);
 }
 // ── doctor ──────────────────────────────────────────────────────────────────
 export async function runDoctorCommand(args = []) {
@@ -441,12 +457,12 @@ ${BOLD}版本与更新:${RESET} (子命令一律裸词, 不带 -- 前缀)
   bolloon --version                  版本 + 安装方式/目录/入口/通道/来源身份/上游/是否最新
   bolloon --version verbose          诊断版 (构建时间/git/Node/npm/Python/配置目录/最近更新)
   bolloon --version json             机器版 (同一份 VersionInfo, 给脚本与问题报告)
-  bolloon update                     只检查并给结论 (不安装任何东西)
-  bolloon update plan                更新计划: 要更新什么 / 不会动什么 / 风险检查
+  bolloon update                     直接执行更新 (先打印计划与风险检查, 再真装; 不写 plan/now)
+  bolloon update --dry-run           只看计划与风险检查, 一个字节都不动 (旧 update plan 等价于它)
+  bolloon update wait                等当前 Run 结束后再更新 (有长期任务时的默认建议)
+  bolloon update force               忽略"有长期任务在跑"的提醒 (阻塞项仍然阻塞)
   bolloon update status              更新状态: 装的哪个源+版本/commit+能切回哪/最近检查/失败/开关
   bolloon update history [N]         最近 N 次更新 (时间 · 版本变化 · 结果 · 耗时 · 原因)
-  bolloon update now                 真正执行更新 (默认先看计划)
-  bolloon update now wait            等当前 Run 结束后再更新 (有长期任务时的默认建议)
   bolloon doctor                     安装入口 + 版本事实 + 更新状态 + 运行时 是否自洽
   bolloon doctor json                同上, 机器可读
   bolloon runtime [plan|install|json] 运行时 (Node/npm/Git/Python) 检查与安装 (install 需显式 yes)
@@ -456,7 +472,7 @@ ${BOLD}双源 (--channel):${RESET}
                            比较语义 = semver (npm 的 latest ↔ GitHub 同名 tag)
   --channel dev     GitHub master HEAD 是唯一源; 比较语义 = git ref + commit sha (不用 semver);
                            身份 = <版本>+dev.<sha7>; 未走发布门, 会打印警告并记录 sha
-  一键回稳定版:     bolloon update now --channel stable
+  一键回稳定版:     bolloon update --channel stable
   --channel 只覆盖本次进程, 不落盘 (config 里的 updateChannel 仍是默认值)
   源不可达 / 版本不存在 → 拒绝并说清 (退出码 2), 不会静默装回旧版
 

package/dist/cli/wallet-store.js

@@ -0,0 +1,159 @@
+/**
+ * wallet-store.ts — bolloon 自己的钱包台账: **一个目录, 一钱包一文件** (leo 2026-09-30)
+ *
+ * 事实与边界:
+ *   · agent 工具 `wallet_create` / `wallet_import` 只**生成/解析**钱包, **从不落盘**
+ *     (`constraint-runtime/src/tools/WalletTools/createWallet.ts` 纯 `Wallet.createRandom()`) ⇒
+ *     `/wallet` 一直是「钱包 (0)」不是路径写错, 是**从来没写过文件**。
+ *   · 台账目录 = `~/.bolloon/wallets/`, **一钱包一文件** `<名字>.json` (**0600**)。
+ *     放这儿而不是仓库里: 仓库是公开的 (`private:false`), 私钥进 git 就完了。
+ *   · 文件里允许有私钥/助记词 (签名要用), 但**命令输出永不回显** —— 只给地址 + 路径。
+ *   · 不读别的 agent 的钱包目录 (`~/.hermes/wallets/…`): `chain-config.ts` 定的硬规则 ——
+ *     那不属于本进程, 读了就是越权。要收编必须由**用户显式给路径** (`/wallet import <path>`)。
+ *   · 老的单文件台账 (`~/.bolloon/wallets.json`) 若存在 ⇒ 一次性拆进目录, 原文件改名 `.migrated`
+ *     (不删: 用户的数据, 出问题能翻回去)。
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/** 一钱包一文件所在目录 */
+export function walletsDir() {
+    return path.join(process.env.HOME || '/tmp', '.bolloon', 'wallets');
+}
+/** 文件名安全化 (只保留字母数字与 - _ .) */
+function safeName(name, fallback = 'wallet') {
+    const s = String(name || '').trim().replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+    return s || fallback;
+}
+async function readOne(file) {
+    try {
+        const raw = JSON.parse(await fs.readFile(file, 'utf-8'));
+        const address = raw?.address;
+        if (typeof address !== 'string' || !address.startsWith('0x'))
+            return null;
+        return {
+            name: String(raw?.name || path.basename(file).replace(/\.json$/, '')),
+            address,
+            network: String(raw?.network || '—'),
+            source: raw?.source === 'imported' ? 'imported' : 'created',
+            createdAt: String(raw?.createdAt || ''),
+            privateKey: typeof raw?.privateKey === 'string' ? raw.privateKey : undefined,
+            mnemonic: typeof raw?.mnemonic === 'string' ? raw.mnemonic : undefined,
+        };
+    }
+    catch {
+        return null; // 坏文件不挡列表 —— 但下面 loadWallets 会把"读不了的"计数报出去
+    }
+}
+/** 老单文件台账拆进目录 (一次性; 原文件改名 .migrated 保留) */
+async function migrateLegacySingleFile(dir) {
+    const legacy = path.join(process.env.HOME || '/tmp', '.bolloon', 'wallets.json');
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readFile(legacy, 'utf-8'));
+    }
+    catch {
+        return 0;
+    }
+    const list = Array.isArray(raw) ? raw : Array.isArray(raw?.wallets) ? raw.wallets : [];
+    let n = 0;
+    for (const w of list) {
+        if (!w?.address)
+            continue;
+        const rec = {
+            name: safeName(w.name || `wallet-${n + 1}`), address: String(w.address),
+            network: String(w.network || '—'), source: w.source === 'imported' ? 'imported' : 'created',
+            createdAt: String(w.createdAt || new Date().toISOString()),
+            privateKey: typeof w.privateKey === 'string' ? w.privateKey : undefined,
+            mnemonic: typeof w.mnemonic === 'string' ? w.mnemonic : undefined,
+        };
+        await writeWalletFile(dir, rec);
+        n++;
+    }
+    try {
+        await fs.rename(legacy, `${legacy}.migrated`);
+    }
+    catch { /* 改名失败就留着, 下次再试 */ }
+    return n;
+}
+async function writeWalletFile(dir, rec) {
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `${safeName(rec.name)}.json`);
+    const tmp = `${file}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(rec, null, 2), { encoding: 'utf-8', mode: 0o600 });
+    await fs.rename(tmp, file);
+    try {
+        await fs.chmod(file, 0o600);
+    }
+    catch { /* 已足够 */ }
+    return file;
+}
+/** 迁移只做一次 (模块级旗标) —— 每次进程首次读台账时试一次 */
+let legacyMigrated = false;
+/** 读全部钱包 (一钱包一文件, 按文件名排序) */
+export async function loadWallets() {
+    const dir = walletsDir();
+    await fs.mkdir(dir, { recursive: true }).catch(() => { });
+    // 老单文件台账: 每进程首次读的时候试一次迁移 (旗标防重复; 迁移里自己判断有没有老文件)
+    if (!legacyMigrated) {
+        legacyMigrated = true;
+        const n = await migrateLegacySingleFile(dir);
+        if (n > 0) { /* 迁移来的文件就在下面一起读 */ }
+    }
+    let names = [];
+    try {
+        names = (await fs.readdir(dir)).filter(n => n.endsWith('.json') && !n.endsWith('.tmp')).sort();
+    }
+    catch (e) {
+        throw new Error(`钱包目录读不了 (${dir}): ${String(e?.message || e).slice(0, 120)}`);
+    }
+    const out = [];
+    for (const n of names) {
+        const rec = await readOne(path.join(dir, n));
+        if (rec)
+            out.push(rec);
+    }
+    return out;
+}
+/**
+ * 写一个钱包进目录。
+ *   · 同地址**不新建文件**: 合并进那条 (不覆盖已有私钥/助记词)
+ *   · 名字撞了就自动加后缀 (-2, -3 …)
+ */
+export async function addWallet(rec) {
+    const dir = walletsDir();
+    const existing = await loadWallets();
+    const dup = existing.find(w => w.address.toLowerCase() === rec.address.toLowerCase());
+    if (dup) {
+        const merged = {
+            ...rec,
+            name: dup.name, // 保留原来的文件名/名字
+            privateKey: dup.privateKey || rec.privateKey,
+            mnemonic: dup.mnemonic || rec.mnemonic,
+            createdAt: dup.createdAt || rec.createdAt,
+        };
+        const file = await writeWalletFile(dir, merged);
+        return { rec: merged, replaced: true, file };
+    }
+    let name = safeName(rec.name);
+    const used = new Set(existing.map(w => w.name));
+    for (let i = 2; used.has(name); i++)
+        name = `${safeName(rec.name)}-${i}`;
+    const out = { ...rec, name };
+    const file = await writeWalletFile(dir, out);
+    return { rec: out, replaced: false, file };
+}
+/** 按 # / 地址 / 名字挑一个 */
+export function pickWallet(list, spec) {
+    if (!spec)
+        return list[0];
+    const n = Number(spec);
+    if (Number.isFinite(n) && n >= 1)
+        return list[n - 1];
+    if (spec.startsWith('0x'))
+        return list.find(w => w.address.toLowerCase() === spec.toLowerCase());
+    return list.find(w => w.name === spec);
+}
+/** 地址缩写 (单行显示用) */
+export function shortAddr(a) {
+    return a && a.length > 12 ? `${a.slice(0, 6)}…${a.slice(-4)}` : String(a || '?');
+}

package/dist/cli/wallet-table.js

@@ -0,0 +1,46 @@
+/**
+ * wallet-table.ts — `/wallet` 的钱包表格渲染 (leo 2026-09-30: 「钱包格式也统一一个表格」)
+ *
+ * 为什么单独抽出来: 表格的**对齐/裁宽**必须能确定性验证 —— 之前它内联在 CLI 的 /wallet 分支里,
+ *   只能靠 PTY 抓包看 (那工具这轮抽风 6 次只成 2 次), 验证变成了碰运气。
+ *   抽成纯函数 (进 list, 出 string[] 无 ANSI) ⇒ 可以直接跑、直接看列宽对不对 (含中文名列)。
+ *
+ * 与 `/sessions` 同一套口径: 列宽按终端宽动态分配; 中文按**显示宽**对齐 (dispWidth);
+ *   地址优先给满 42 字符 (能直接复制), 列宽不足才退回缩写 (0x1234…abcd) —— 不截半截地址。
+ */
+import { dispWidth, truncate } from './loading-tui.js';
+/**
+ * 返回表格行 (无 ANSI): [表头, 分隔线, ...数据行]
+ * 调用方负责加颜色前缀/缩进。
+ */
+export function renderWalletTable(list, opts) {
+    const zh = opts.lang !== 'en';
+    const PAD = (v, w) => v + ' '.repeat(Math.max(0, w - dispWidth(v)));
+    const avail = Math.max(60, opts.width - 2);
+    const wN = 3, wChain = 8, wSrc = 6, wDate = 10;
+    const fixed = wN + wChain + wSrc + wDate + 5; // 5 = 列间空格
+    const wAddr = Math.max(13, Math.min(42, Math.floor((avail - fixed) * 0.55)));
+    const wName = Math.max(12, avail - fixed - wAddr);
+    const cols = [wN, wName, wAddr, wChain, wSrc, wDate];
+    const hdr = [
+        PAD('#', wN),
+        PAD(zh ? '名字' : 'Name', wName),
+        PAD(zh ? '地址' : 'Address', wAddr),
+        PAD(zh ? '链' : 'Chain', wChain),
+        PAD(zh ? '来源' : 'Source', wSrc),
+        PAD(zh ? '建立' : 'Created', wDate),
+    ].join(' ');
+    const rule = cols.map(w => '─'.repeat(w)).join(' ');
+    const rows = list.map((w, k) => {
+        const addr = wAddr >= 42 ? w.address : opts.shortAddr(w.address);
+        return [
+            PAD(String(k + 1), wN),
+            PAD(truncate(w.name, wName), wName),
+            PAD(truncate(addr, wAddr), wAddr),
+            PAD(truncate(w.network || '—', wChain), wChain),
+            PAD(w.source === 'imported' ? (zh ? '导入' : 'imported') : (zh ? '生成' : 'created'), wSrc),
+            PAD(String(w.createdAt).slice(0, 10), wDate),
+        ].join(' ');
+    });
+    return [hdr, rule, ...rows];
+}