@whyshu/argent 0.1.26 → 0.2.0

package/bin/argent.mjs

@@ -1,385 +0,0 @@
-#!/usr/bin/env node
-/**
- * @whyshu/argent CLI
- *
- *   argent web                       生成/复用 profile 并启动 dsh web
- *   argent health                    版本/宿主/profile/runner 自检（--json）
- *   argent setup                     只生成/更新 profile
- *   argent service install|uninstall runner 常驻（macOS launchd；--print-only/--plist-dir）
- *   argent update check|run      客户机 outbound npm 更新（不依赖 SSH/EasyTier /dl）
- *
- * 公共参数：--dsh-home <dir>  --profile <name>  --repo <dir>  --json  --dry-run
- */
-import { spawn, spawnSync } from 'node:child_process';
-import { mkdirSync, writeFileSync, rmSync, existsSync, copyFileSync, chmodSync, readFileSync, cpSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { homedir } from 'node:os';
-import {
-  DSH_EXACT_VERSION, PROFILE_NAME, PROD_BUNDLES, buildLaunchdPlist, buildProfile, dshHomeOf, runnerScriptPath,
-  depsInstalled, health, installDeps, loginWithPhone, pairRunner, probeDshVersion, readAuthToken, repoRoot, runnerConfigPath, sendLoginCode, versionMatches,
-  engineRoot, materializeRuntime, checkForUpdate, compareVersions, launcherVersion,
-  PUBLISHED_BUNDLE_VERSIONS, resolveDshBin, updateProfilePluginVersions, writeEngineContract,
-} from '../lib/index.mjs';
-
-const argv = process.argv.slice(2);
-const has = (f) => argv.includes(f);
-const val = (f, d = '') => { const i = argv.indexOf(f); return i > -1 ? (argv[i + 1] ?? d) : d; };
-const JSON_OUT = has('--json');
-const DRY_RUN = has('--dry-run');
-
-const command = (() => {
-  const positional = argv.filter((a) => !a.startsWith('--') && !['-h'].includes(a));
-  const i = argv.findIndex((a) => a === 'web' || a === 'health' || a === 'setup' || a === 'pair' || a === 'login' || a === 'service' || a === 'runtime' || a === 'update');
-  if (i < 0) return '';
-  if (argv[i] === 'service' || argv[i] === 'runtime' || argv[i] === 'update') return `${argv[i]} ${argv[i + 1] || ''}`.trim();
-  return argv[i];
-})();
-
-const opts = {
-  dshHome: dshHomeOf(val('--dsh-home')),
-  profile: val('--profile', PROFILE_NAME),
-  repo: repoRoot({ repo: val('--repo') }),
-  port: Number(val('--port', '3080')) || 3080,
-  target: val('--target', join(homedir(), '.argent-dsh')),
-  skillsTarget: has('--no-skills') ? '' : val('--skills-target', join(dshHomeOf(val('--dsh-home')), 'skills')),
-  registry: val('--registry', process.env.ARGENT_NPM_REGISTRY || 'https://registry.npmjs.org'),
-  dshBin: val('--dsh-bin', resolveDshBin()),
-  extraBundles: (() => { const raw = val('--bundles', '').split(',').map((x) => x.trim()).filter(Boolean); return raw.flatMap((x) => (x === 'prod' ? PROD_BUNDLES : [x])); })(),
-};
-
-function print(obj) {
-  if (JSON_OUT) console.log(JSON.stringify(obj, null, 2));
-  else for (const [k, v] of Object.entries(obj)) console.log(`${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}`);
-}
-
-function ensureBundleDeps() {
-  const dir = join(opts.dshHome, 'profiles', opts.profile);
-  let pkg;
-  try { pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')); } catch { return; }
-  for (const [name, version] of Object.entries(pkg.dependencies || {})) {
-    const depDir = join(dir, 'node_modules', ...name.split('/'));
-    if (existsSync(depDir)) continue;
-    console.error(`→ 补装缺失 bundle ${name}@${version} …`);
-    const r = spawnSync('dsh', ['plugin', '--profile', opts.profile, 'add', `${name}@${version}`], {
-      cwd: dir, stdio: 'inherit', env: { ...process.env, DSH_HOME: opts.dshHome },
-    });
-    if (r.status !== 0) {
-      console.error(`❌ 补装失败：${name}（exit ${r.status}）`);
-      process.exit(2);
-    }
-  }
-}
-
-function ensureProfile({ install = true } = {}) {
-  const built = buildProfile({ dshHome: opts.dshHome, profile: opts.profile, repo: opts.repo, extraBundles: opts.extraBundles });
-  if (!built.ok) {
-    console.error(`❌ ${built.message}`);
-    process.exit(2);
-  }
-  if (install && (has('--force-install') || !depsInstalled(opts.dshHome, opts.profile)) && !has('--no-install')) {
-    console.error('→ 装配 profile 依赖（dsh plugin --profile ' + opts.profile + ' install）…');
-    const r = installDeps({ dshHome: opts.dshHome, profile: opts.profile });
-    if (!r.ok) {
-      console.error(`❌ profile 依赖装配失败：${r.message}`);
-      console.error('   可手动重试：DSH_HOME=' + opts.dshHome + ' dsh plugin --profile ' + opts.profile + ' install');
-      process.exit(2);
-    }
-    console.error('✅ profile 依赖装配完成');
-  }
-  if (install && !has('--no-install')) ensureBundleDeps();
-  return built;
-}
-
-function checkVersionOrExit() {
-  const probe = probeDshVersion();
-  if (!probe.ok) {
-    console.error(`❌ 未找到 dsh（${probe.error}）。安装器不代装宿主：请先按官方方式准备 dsh@${DSH_EXACT_VERSION}（npx @deepseek-ai/dsh@${DSH_EXACT_VERSION} web）。`);
-    process.exit(2);
-  }
-  if (!versionMatches(probe.version)) {
-    console.error(`❌ dsh 版本不匹配：当前 ${probe.version}，要求 exact ${DSH_EXACT_VERSION}。`);
-    console.error('   启动器按 exact pin 运行（防混合版本事故）；请切换 dsh 版本后重试。');
-    process.exit(2);
-  }
-  return probe.version;
-}
-
-function launchWeb() {
-  const built = ensureProfile();
-  const version = checkVersionOrExit();
-  const args = ['--profile', opts.profile, ...(opts.port !== 3080 ? ['--port', String(opts.port)] : [])];
-  if (DRY_RUN) {
-    print({ ok: true, dryRun: true, dshVersion: version, profile: built.dir, command: `dsh ${args.join(' ')}` });
-    return;
-  }
-  const child = spawn('dsh', args, { stdio: 'inherit', env: process.env });
-  child.on('close', (code) => process.exit(code ?? 0));
-  child.on('error', (error) => { console.error(`❌ 启动 dsh 失败：${error.message}`); process.exit(1); });
-}
-
-async function webCommand() {
-  if (DRY_RUN || JSON_OUT) {
-    const built = ensureProfile();
-    const probe = probeDshVersion();
-    print({
-      ok: probe.ok && versionMatches(probe.version),
-      dshVersion: probe.ok ? probe.version : '', expected: DSH_EXACT_VERSION,
-      profile: built.dir, command: 'dsh --profile ' + opts.profile + (opts.port !== 3080 ? ' --port ' + opts.port : ''),
-      note: probe.ok && versionMatches(probe.version) ? '版本匹配，可启动' : '版本不匹配/未安装 dsh',
-    });
-    return;
-  }
-  launchWeb();
-}
-
-async function healthCommand() {
-  const h = health({ dshHome: opts.dshHome, profile: opts.profile, repo: opts.repo, port: opts.port, dshBin: opts.dshBin });
-  if (JSON_OUT) console.log(JSON.stringify(h, null, 2));
-  else {
-    console.log(`dsh: ${h.dsh.ok ? h.dsh.version : '(未找到)'} ${h.dsh.matchesExact ? '✅ exact' : `❌ 期望 ${h.expectedDsh}`}`);
-    console.log(`profile: ${h.profile.dir} ${h.profile.packageJson && h.profile.patch ? '✅' : '❌ 未生成（跑 argent setup）'}`);
-    console.log(`runner 配置: ${h.runner.configPresent ? `✅ ${h.runner.configPath}（${h.runner.mode}）` : `— 未配置（${h.runner.configPath}）`}`);
-    console.log(`web: ${h.webUrl}`);
-    console.log(h.ok ? '✅ 可启动' : '❌ 有前置未满足');
-  }
-  process.exit(h.ok ? 0 : 1);
-}
-
-async function readLine(promptText) {
-  const { createInterface } = await import('node:readline/promises');
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try { return (await rl.question(promptText)).trim(); } finally { rl.close(); }
-}
-
-async function loginCommand() {
-  const serverUrl = val('--server-url');
-  const phone = val('--phone');
-  if (!serverUrl || !phone) { console.error('用法：argent login --server-url <url> --phone <手机号> [--code <验证码>]'); process.exit(2); }
-  let code = val('--code');
-  if (!code) {
-    const sent = await sendLoginCode({ serverUrl, phone });
-    if (!sent.ok) { console.error(`❌ 发送验证码失败：${sent.message}`); process.exit(2); }
-    if (sent.devCode) console.error(`（开发环境验证码：${sent.devCode}）`);
-    code = await readLine('请输入短信验证码：');
-  }
-  const r = await loginWithPhone({ serverUrl, phone, code, dshHome: opts.dshHome });
-  if (!r.ok) { console.error(`❌ 登录失败：${r.message}`); process.exit(2); }
-  print({ ok: true, auth: r.path, serverUrl: r.serverUrl, phone: r.phone, tokenTail: `…${r.tokenTail}`, next: '运行 argent pair --from-login --tenant <appId>' });
-}
-
-async function pairCommand() {
-  const r = await pairRunner({
-    serverUrl: val('--server-url'),
-    tenantAppId: val('--tenant') || val('--tenant-app-id'),
-    adminToken: val('--admin-token') || (has('--from-login') ? (readAuthToken(opts.dshHome)?.token || '') : ''),
-    runnerToken: val('--runner-token'),
-    runnerId: val('--runner-id'),
-    label: val('--label', 'argent-launcher'),
-    dshHome: opts.dshHome,
-  });
-  if (!r.ok) { console.error(`❌ ${r.message}`); process.exit(2); }
-  print({ ok: true, config: r.configPath, serverUrl: r.serverUrl, tenantAppId: r.tenantAppId, runnerId: r.runnerId, tokenTail: `…${r.tokenTail}` });
-}
-
-function setupCommand() {
-  const built = ensureProfile();
-  print({ ok: true, profile: built.dir, bundles: built.bundles.join(', '), plugins: built.plugins.join(', '), preset: built.preset, depsInstalled: depsInstalled(opts.dshHome, opts.profile) });
-}
-
-function runtimeCommand(sub) {
-  const engine = engineRoot();
-  if (!engine) { console.error('❌ 未找到 @whyshu/argent-engine；请用新版启动器（npm 依赖应随包安装）'); process.exit(2); }
-  const version = readFileSync(join(engine, 'VERSION'), 'utf8').trim();
-  if (sub === 'status' || sub === '') {
-    let current = null;
-    try { current = JSON.parse(readFileSync(join(opts.target, 'RUNTIME_VERSION.json'), 'utf8')); } catch { current = null; }
-    print({ ok: true, engine, engineVersion: version, target: opts.target, current: current ? current.version : null, installed: Boolean(current) });
-    return;
-  }
-  if (sub !== 'install') { console.error('用法：argent runtime install|status [--target <dir>] [--dry-run]'); process.exit(2); }
-  if (DRY_RUN) { print({ ok: true, dryRun: true, engine, version, target: opts.target, action: 'materialize runtime files' }); return; }
-  const r = materializeRuntime({ target: opts.target, engine, skillsTarget: opts.skillsTarget });
-  if (!r.ok) { console.error(`❌ runtime 安装失败：${r.message}`); process.exit(2); }
-  print({ ok: true, package: '@whyshu/argent-engine', version: r.version, files: r.files, skillsFiles: r.skillsFiles, target: r.target, skillsTarget: r.skillsTarget, backupDir: r.backupDir });
-}
-
-function runCli(bin, args, { cwd = '', env = {} } = {}) {
-  const r = spawnSync(bin, args, {
-    cwd: cwd || undefined,
-    stdio: inherit_stdout() ? 'inherit' : 'pipe',
-    encoding: 'utf8',
-    env: { ...process.env, ...env },
-    timeout: 600000,
-  })
-  if (r.error) throw new Error(`${bin} ${args.join(' ')} 启动失败：${r.error.message}`)
-  if (r.status !== 0) throw new Error(`${bin} ${args.join(' ')} 退出 ${r.status}${r.stderr ? `：${String(r.stderr).slice(-400)}` : ''}`)
-  return r
-}
-
-function inherit_stdout() { return !JSON_OUT }
-
-
-/** desktop profile 的依赖安装器：ARGENT_PNPM → 宿主自带 pnpm → PATH 上的 pnpm */
-function resolvePnpm() {
-  const cands = [
-    process.env.ARGENT_PNPM,
-    '/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs',
-  ].filter(Boolean)
-  for (const c of cands) { if (existsSync(c)) return { cmd: process.execPath, args: [c] } }
-  const which = spawnSync('pnpm', ['--version'], { encoding: 'utf8' })
-  if (which.status === 0) return { cmd: 'pnpm', args: [] }
-  return null
-}
-
-async function updateCommand(sub) {
-  if (sub !== 'check' && sub !== 'run') {
-    console.error('用法：argent update check|run [--to <version>] [--yes] [--registry <url>] [--dsh-home <dir>] [--target <dir>] [--json] [--dry-run]');
-    process.exit(2)
-  }
-  const current = launcherVersion()
-  let remote
-  try { remote = await checkForUpdate({ target: opts.target, registry: opts.registry, dshHome: opts.dshHome, profile: opts.profile }) }
-  catch (e) { console.error(`❌ 检查更新失败：${e.message}`); process.exit(2) }
-  if (!remote.ok) {
-    if (JSON_OUT) console.log(JSON.stringify(remote, null, 2)); else console.error(`❌ ${remote.message}`)
-    process.exit(2)
-  }
-  const targetVersion = val('--to', remote.latest)
-  if (sub === 'check') {
-    const out = { ...remote, targetVersion, launcher: current, restartRequired: Boolean(remote.updateAvailable) }
-    if (JSON_OUT) console.log(JSON.stringify(out, null, 2))
-    else {
-      console.log(`当前启动器: ${current || '(未知)'}`)
-      console.log(`npm latest: ${remote.latest}`)
-      console.log(remote.updateAvailable ? '→ 有可用更新' : '→ 已是最新')
-      if (remote.pluginUpdates?.length) console.log('插件可更新：' + remote.pluginUpdates.map((x) => `${x.name} ${x.current}→${x.latest}`).join('；'))
-      console.log(`runtime: ${remote.runtime || '(未物化)'} @ ${remote.runtimeTarget}`)
-      console.log(`来源: ${remote.registry}`)
-    }
-    return
-  }
-  if (!remote.updateAvailable && !has('--force')) {
-    console.log(`已是最新（${current}${remote.pluginUpdates?.length ? '，插件也无更新' : ''}），无需更新。`)
-    return
-  }
-  const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx'
-  const common = ['--yes', `@whyshu/argent@${targetVersion}`]
-  const installArgs = [...common, 'runtime', 'install', '--target', opts.target, '--skills-target', opts.skillsTarget]
-  const healthArgs = [...common, 'health', '--dsh-home', opts.dshHome, '--profile', opts.profile, '--json', '--dsh-bin', opts.dshBin]
-  if (DRY_RUN) {
-    print({ ok: true, dryRun: true, current, targetVersion, dshBin: opts.dshBin, commands: [
-      [npx, ...installArgs].join(' '),
-      `update profile plugin versions (${Object.keys(PUBLISHED_BUNDLE_VERSIONS).join(', ')})`,
-      `${opts.dshBin} plugin --profile ${opts.profile} install  # DSH_HOME=${opts.dshHome}`,
-      [npx, ...healthArgs].join(' '),
-    ] })
-    return
-  }
-  if (!has('--yes')) {
-    console.error('⛔ 更新会改 runtime / profile 插件，必须显式加 --yes。先看计划：argent update run --dry-run')
-    process.exit(2)
-  }
-  // 宿主版本不匹配时绝不能先改 profile（新插件可能要求新 dsh；改完再 health 失败会留下半升级）。
-  const dshProbe = probeDshVersion({ dshBin: opts.dshBin })
-  if (!dshProbe.ok || !versionMatches(dshProbe.version)) {
-    console.error(`⛔ 宿主 dsh 版本不匹配：当前 ${dshProbe.ok ? dshProbe.version : '(未找到)'}，启动器要求 ${DSH_EXACT_VERSION}。`)
-    console.error('   请先按客户机 dsh 升级流程升级宿主，再重跑 update run；本次未改任何文件。')
-    process.exit(2)
-  }
-  const stamp = new Date().toISOString().replace(/[:.]/g, '-')
-  const profileDir = join(opts.dshHome, 'profiles', opts.profile)
-  const backupDir = join(opts.dshHome, 'argent', 'backup', `update-${stamp}`)
-  mkdirSync(backupDir, { recursive: true })
-  for (const f of ['package.json', 'cordis.patch.yml', 'pnpm-lock.yaml', 'pnpm-workspace.yaml', 'argent.json']) {
-    const src = join(profileDir, f)
-    if (existsSync(src)) { mkdirSync(dirname(join(backupDir, f)), { recursive: true }); cpSync(src, join(backupDir, f)) }
-  }
-  const env = { NPM_CONFIG_REGISTRY: opts.registry }
-  let eng = null
-  try {
-    runCli(npx, installArgs, { env })
-    // 不调用 setup：setup 会重建 profile，可能丢掉客户现有 bundles/依赖结构（2026-10-22 实测）。
-    const prof = updateProfilePluginVersions({ dshHome: opts.dshHome, profile: opts.profile, versions: PUBLISHED_BUNDLE_VERSIONS })
-    if (!prof.ok) throw new Error(`更新 profile 插件版本失败：${prof.message}`)
-    // 方案 C · P3：runtime 换完必须重写契约文件（否则壳仍按旧 engineDir/版本读）
-    eng = writeEngineContract(profileDir, { repo: opts.repo, target: opts.target })
-    // ⚠️ dsh CLI **拒绝管理 desktop profile**（"managed exclusively by the Electron application"）
-    // ⇒ desktop 必须由宿主自己的 pnpm 装依赖（2026-11-02 实测：`dsh plugin --profile desktop install` 直接 exit 1）。
-    if (opts.profile === 'desktop') {
-      const ws = join(profileDir, 'pnpm-workspace.yaml')
-      if (!existsSync(ws)) {
-        writeFileSync(ws, 'packages:\n  - .\nnodeLinker: hoisted\nautoInstallPeers: false\nallowBuilds:\n  protobufjs: true\n')
-      }
-      const pnpm = resolvePnpm()
-      if (!pnpm) throw new Error('desktop profile 需要 pnpm：设置 ARGENT_PNPM，或确保 PATH 上有 pnpm')
-      runCli(pnpm.cmd, pnpm.args.concat(['install', '--reporter=append-only']), { cwd: profileDir, env })
-    } else {
-      runCli(opts.dshBin, ['plugin', '--profile', opts.profile, 'install'], { env: { ...env, DSH_HOME: opts.dshHome }, cwd: opts.dshHome })
-    }
-    runCli(npx, healthArgs, { env })
-  } catch (e) {
-    console.error(`❌ 更新失败：${e.message}`)
-    console.error(`   已保留更新前 profile 清单备份：${backupDir}`)
-    console.error('   可分步重试：npx -y @whyshu/argent@' + targetVersion + ' runtime install，再按 dsh plugin install 重试；必要时用备份恢复 package.json/patch。')
-    process.exit(2)
-  }
-  print({
-    ok: true, from: current, to: targetVersion, runtimeTarget: opts.target, profile: profileDir, backupDir,
-    contract: { engineDir: eng.engineDir, engineVersion: eng.engineVersion, contract: eng.contract, source: eng.source },
-    restartRequired: true, next: '空闲窗口重启 dsh web（service install/launchd 或现有重启脚本）',
-  })
-}
-
-function serviceCommand(sub) {
-  const bundled = runnerScriptPath({ repo: opts.repo });
-  // 固定 runner 路径：复制进 DSH_HOME，避免 launchd 指向 npx 临时缓存（缓存清理后失效）
-  const stableRunner = join(opts.dshHome, 'argent', 'runner', 'argent-runner.mjs');
-  const runnerPath = bundled ? stableRunner : '';
-  const plist = buildLaunchdPlist({ dshHome: opts.dshHome, repo: opts.repo, runnerPath });
-  if (sub === 'install' && bundled && !has('--print-only')) {
-    mkdirSync(dirname(stableRunner), { recursive: true });
-    copyFileSync(bundled, stableRunner);
-    chmodSync(stableRunner, 0o755);
-  }
-  const outDir = val('--plist-dir', '');
-  const targetDir = outDir || join(homedir(), 'Library', 'LaunchAgents');
-  const target = join(targetDir, plist.file);
-  if (sub === 'uninstall') {
-    if (existsSync(target)) { rmSync(target); print({ ok: true, removed: target }); } else print({ ok: true, removed: '', note: '未安装' });
-    return;
-  }
-  if (sub !== 'install') { console.error('用法：argent service install|uninstall [--print-only|--plist-dir <dir>]'); process.exit(2); }
-  if (!plist.script) {
-    console.error('❌ 找不到 scripts/argent-runner.mjs（发布包应内置 runner；本地联调请给 --repo）');
-    process.exit(2);
-  }
-  if (has('--print-only')) { console.log(plist.content); return; }
-  mkdirSync(targetDir, { recursive: true });
-  writeFileSync(target, plist.content);
-  print({
-    ok: true, plist: target, label: plist.label,
-    next: [
-      `launchctl unload ${target} 2>/dev/null || true`,
-      `launchctl load -w ${target}`,
-      `# 日志：${join(opts.dshHome, 'argent', 'runner', 'logs')}`,
-    ].join('\n'),
-    runnerConfig: runnerConfigPath(opts.dshHome),
-  });
-}
-
-const main = async () => {
-  if (!command || has('-h') || has('--help')) {
-    console.log('用法：argent <web|health|setup|login|pair|runtime install|runtime status|service install|service uninstall|update check|update run> [--dsh-home <dir>] [--target <dir>] [--skills-target <dir>|--no-skills] [--json] [--dry-run]');
-    process.exit(command ? 0 : 2);
-  }
-  if (command === 'health') return healthCommand();
-  if (command === 'setup') return setupCommand();
-  if (command === 'pair') return pairCommand();
-  if (command === 'login') return loginCommand();
-  if (command === 'runtime install' || command === 'runtime status') return runtimeCommand(command.split(' ')[1]);
-  if (command === 'service install' || command === 'service uninstall') return serviceCommand(command.split(' ')[1]);
-  if (command === 'update check' || command === 'update run') return updateCommand(command.split(' ')[1]);
-  return webCommand();
-};
-
-main().catch((error) => { console.error(`❌ ${error.message}`); process.exit(1); });