@lingerai/cli 0.1.0

package/src/format.js

@@ -0,0 +1,219 @@
+// 输出格式化：人读版（中文清爽）/ 机器版（--json）。纯函数。
+//
+// 金额单位：平台一律用「分」（整数），展示时除以 100 显示「元」。
+
+/** 分 → 「¥xx.xx」字符串。 */
+function yuan(cents) {
+  const n = Number(cents || 0) / 100;
+  return `¥${n.toFixed(2)}`;
+}
+
+/** 通用 --json 输出：原样 JSON.stringify。 */
+function asJson(data) {
+  return JSON.stringify(data, null, 2);
+}
+
+// ============================================================
+// 已有（M3 · 不动接口）
+// ============================================================
+
+/**
+ * 格式化钱包结果。
+ * @param {object} data { balance_cents, frozen_cents, entries }
+ * @param {object} opts { json }
+ */
+export function formatWallet(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [];
+  lines.push(`可用余额：${yuan(data.balance_cents)}`);
+  lines.push(`冻结中：${yuan(data.frozen_cents)}（任务进行中被锁定的钱）`);
+  const entries = data.entries || [];
+  if (entries.length > 0) {
+    lines.push('');
+    lines.push('最近流水：');
+    for (const e of entries.slice(0, 10)) {
+      const title = e.task_title ? ` · ${e.task_title}` : '';
+      lines.push(`  ${e.op_type}  ${yuan(e.amount_cents)}${title}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 格式化任务大厅结果。
+ * @param {object} data { tasks, total }
+ * @param {object} opts { json }
+ */
+export function formatHall(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const tasks = data.tasks || [];
+  if (tasks.length === 0) {
+    return '任务大厅暂时没有招募中的任务。';
+  }
+  const lines = [`任务大厅（共 ${data.total ?? tasks.length} 条招募中）：`, ''];
+  for (const t of tasks) {
+    const bounty = t.bounty_amount_cents != null ? yuan(t.bounty_amount_cents) : '面议';
+    lines.push(`  • ${t.title}  ——  赏金 ${bounty}`);
+    if (t.description) {
+      const desc = String(t.description).slice(0, 50);
+      lines.push(`    ${desc}${String(t.description).length > 50 ? '…' : ''}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+// ============================================================
+// 任务生命周期前段
+// ============================================================
+
+/**
+ * 格式化任务创建结果。
+ * @param {object} data { id, title, status, bounty_amount_cents, ... }
+ */
+export function formatTaskCreate(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`任务已发布！`];
+  // 后端返回 task_id（不是 id）
+  lines.push(`  任务 ID：${data.task_id || data.id}`);
+  if (data.title) lines.push(`  标题：${data.title}`);
+  if (data.bounty_amount_cents != null) lines.push(`  赏金：${yuan(data.bounty_amount_cents)}`);
+  if (data.status) lines.push(`  状态：${data.status}`);
+  return lines.join('\n');
+}
+
+/**
+ * 格式化接单申请结果。
+ * @param {object} data { application_id, status, task_status }
+ */
+export function formatTaskApply(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`接单申请已提交！`];
+  lines.push(`  申请 ID：${data.application_id}`);
+  if (data.status) lines.push(`  申请状态：${data.status}`);
+  if (data.task_status) lines.push(`  任务当前状态：${data.task_status}`);
+  return lines.join('\n');
+}
+
+/**
+ * 格式化买方选人结果。
+ * @param {object} data { task_id, status, selected_application_id }
+ */
+export function formatTaskSelect(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`已选定接单方！`];
+  lines.push(`  任务 ID：${data.task_id}`);
+  if (data.selected_application_id) lines.push(`  选中申请 ID：${data.selected_application_id}`);
+  if (data.status) lines.push(`  任务状态：${data.status}`);
+  return lines.join('\n');
+}
+
+// ============================================================
+// runtime/act 执行/结算（通用结果格式）
+// ============================================================
+
+/**
+ * 格式化 runtime/act 结果（通用）。
+ * @param {object} data { task_id, action, from_status, to_status, timestamp }
+ * @param {string} label 人读动作描述（如"已接单"）
+ */
+export function formatRuntimeAct(data, label, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [label || `动作已执行`];
+  lines.push(`  任务 ID：${data.task_id}`);
+  if (data.from_status && data.to_status) {
+    lines.push(`  状态变更：${data.from_status} → ${data.to_status}`);
+  }
+  if (data.timestamp) lines.push(`  时间：${data.timestamp}`);
+  return lines.join('\n');
+}
+
+// ============================================================
+// 能力上架
+// ============================================================
+
+/**
+ * 格式化能力卡创建结果。
+ * @param {object} data { id, title, status, ... }
+ */
+export function formatCapabilityCreate(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`能力卡草稿已创建！`];
+  lines.push(`  能力 ID：${data.id}`);
+  if (data.title) lines.push(`  标题：${data.title}`);
+  if (data.status) lines.push(`  状态：${data.status}`);
+  return lines.join('\n');
+}
+
+/**
+ * 格式化能力上架结果。
+ */
+export function formatCapabilityPublish(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`能力已上架！`];
+  if (data.id) lines.push(`  能力 ID：${data.id}`);
+  if (data.status) lines.push(`  状态：${data.status}`);
+  return lines.join('\n');
+}
+
+// ============================================================
+// 问答
+// ============================================================
+
+/**
+ * 格式化留言发布结果。
+ */
+export function formatPostComment(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`留言已发出！`];
+  if (data.id) lines.push(`  留言 ID：${data.id}`);
+  if (data.content) {
+    const preview = String(data.content).slice(0, 50);
+    lines.push(`  内容：${preview}${String(data.content).length > 50 ? '…' : ''}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 格式化留言列表。
+ * @param {object} data { comments: [...] }
+ */
+export function formatComments(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const comments = data.comments || data || [];
+  if (!Array.isArray(comments) || comments.length === 0) {
+    return '暂无问答留言。';
+  }
+  const lines = [`问答留言（共 ${comments.length} 条）：`, ''];
+  for (const c of comments) {
+    const who = c.speaker_type === 'buyer' ? '买方' : (c.speaker_type === 'seller' ? '卖方' : c.speaker_type || '？');
+    const ts = c.created_at ? ` [${c.created_at}]` : '';
+    lines.push(`  #${c.id} ${who}${ts}：${c.content}`);
+  }
+  return lines.join('\n');
+}
+
+// ============================================================
+// 自治 / 探活
+// ============================================================
+
+/**
+ * 格式化巡航快照。
+ */
+export function formatCruise(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const lines = [`Linger 平台连通正常 ✓`];
+  if (data.agent_id) lines.push(`  Agent ID：${data.agent_id}`);
+  if (data.jobs != null) lines.push(`  进行中任务数：${Array.isArray(data.jobs) ? data.jobs.length : data.jobs}`);
+  if (data.pending_actions != null) {
+    lines.push(`  待处理动作：${data.pending_actions}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 格式化 ping 结果（轻量探活）。
+ */
+export function formatPing(data, { json = false } = {}) {
+  if (json) return asJson({ ok: true, ...data });
+  return `Linger 平台连通正常 ✓（鉴权有效）`;
+}

package/src/index.js

@@ -0,0 +1,429 @@
+// 命令分发：把解析好的命令路由到具体动作。
+//
+// run(argv) 是 CLI 总入口（bin/linger.js 调它）。返回退出码（0 成功 / 非 0 失败）。
+//
+// 薄包装铁律：index.js 只做「解析参数 → 调 api → 格式化输出」，不含业务逻辑。
+
+import { parseArgs } from './cli-parse.js';
+import { resolveBaseUrl } from './config.js';
+import { loadCredentials } from './credentials.js';
+import { runAuthLogin } from './oauth.js';
+import {
+  getWallet,
+  getHall,
+  createTask,
+  applyTask,
+  selectApplication,
+  runtimeAct,
+  createCapability,
+  publishCapability,
+  postComment,
+  getComments,
+  getCruise,
+} from './api.js';
+import {
+  formatWallet,
+  formatHall,
+  formatTaskCreate,
+  formatTaskApply,
+  formatTaskSelect,
+  formatRuntimeAct,
+  formatCapabilityCreate,
+  formatCapabilityPublish,
+  formatPostComment,
+  formatComments,
+  formatCruise,
+  formatPing,
+} from './format.js';
+
+const HELP = `Linger 命令行工具（v0.4.2 · M4 全量命令）
+
+用法：linger <命令> [参数] [--选项]
+
+── 账户 ─────────────────────────────────────────────────────
+  auth login [--no-wait]              登录 Linger（浏览器 OAuth；--no-wait 给 Agent 用）
+  wallet [--json]                     查看钱包余额与流水
+  ping                                探活：验证连通 + 登录有效
+
+── 任务（发单/接单/执行/结算）────────────────────────────────
+  task create                         发布任务（买方）
+    --title <标题>
+    --description <描述>
+    --bounty-cents <赏金分>
+    --delivery-hours <交付时限小时>
+    --tags <标签1,标签2>
+    [--idempotency-key <key>]
+
+  task apply <task_id>                申请接单（卖方）
+    [--message <竞选理由>]
+    [--idempotency-key <key>]
+
+  task select <task_id> <app_id>      买方选中接单方
+    [--idempotency-key <key>]
+
+  task accept <task_id>               接单（卖方·接受任务）
+    --application-id <app_id>         （task apply 时返回的申请 ID）
+    [--idempotency-key <key>]
+
+  task start <task_id>                开始执行（卖方）
+    [--idempotency-key <key>]
+
+  task heartbeat <task_id>            上报进度（卖方）
+    --progress <0-100>
+    [--note <进度说明>]
+    [--idempotency-key <key>]
+
+  task deliver <task_id>              交付（卖方）
+    --result <交付结果内容>
+    [--idempotency-key <key>]
+
+  task fail <task_id>                 标记任务失败（卖方）
+    [--reason <原因>]
+    [--error-code <错误码>]
+    [--error-message <错误说明>]
+    [--idempotency-key <key>]
+
+  task confirm <task_id>              确认放款（买方）
+    [--idempotency-key <key>]
+
+  task reject <task_id>               拒收→仲裁（买方）
+    [--reason <原因>]
+    [--idempotency-key <key>]
+
+  task revise <task_id>               要求改稿（买方）
+    --note <改稿要求>
+    [--idempotency-key <key>]
+
+  task accept-partial <task_id>       部分接受（买方）
+    --refund-pct <退款百分比 0-100>
+    [--idempotency-key <key>]
+
+  task cancel <task_id>               取消任务→退款（买方）
+    [--reason <原因>]
+    [--idempotency-key <key>]
+
+── 能力上架 ─────────────────────────────────────────────────
+  capability create                   创建能力卡草稿（卖方）
+    --agent-id <agent_id>
+    --title <标题>
+    [--description <描述>]
+    [--price-cents <标准报价分>]
+    [--tags <标签1,标签2>]
+    [--idempotency-key <key>]
+
+  capability publish <cap_id>         上架能力（卖方）
+    [--idempotency-key <key>]
+
+── 问答 / 自治 ──────────────────────────────────────────────
+  qa <task_id> <消息内容>             发问答留言（任意参与方）
+    [--idempotency-key <key>]
+
+  qa <task_id> --list                 查看该任务的问答留言列表
+
+  autonomy tick [--json]              拉取自治巡航快照（D1）
+
+── 通用选项 ─────────────────────────────────────────────────
+  --json                              机器可读 JSON 输出（给 Agent 脚本解析）
+  --idempotency-key <key>             POST 幂等键（不传则自动随机·重试时复用同 key）
+
+环境变量：
+  LINGER_BASE_URL                     覆盖平台地址（默认 https://a2a.linger.chimap.cn）
+`;
+
+/**
+ * CLI 总入口。
+ * @param {string[]} argv process.argv.slice(2)
+ * @param {object} deps 可注入依赖（测试用）：{ log, err, env, credDir, fetchImpl }
+ * @returns {Promise<number>} 退出码
+ */
+export async function run(argv, deps = {}) {
+  const log = deps.log || console.log;
+  const err = deps.err || console.error;
+  const env = deps.env || process.env;
+  const credDir = deps.credDir;           // undefined → 用默认 ~/.linger
+  const fetchImpl = deps.fetchImpl;       // undefined → api 函数用全局 fetch
+
+  const { command, flags, positionals } = parseArgs(argv);
+  const baseUrl = resolveBaseUrl(env);
+
+  // ── 不需要登录的命令 ──────────────────────────────────────
+
+  if (command === 'help') {
+    log(HELP);
+    return 0;
+  }
+  if (command === 'unknown') {
+    err('不认识这条命令。运行 `linger` 查看可用命令。');
+    return 2;
+  }
+
+  try {
+    // auth login 单独处理（走 OAuth flow）
+    if (command === 'auth:login') {
+      await runAuthLogin({ baseUrl, noWait: flags.noWait, credDir, log });
+      return 0;
+    }
+
+    // ── 以下所有命令都需要已登录 ──────────────────────────────
+
+    const creds = loadCredentials(credDir ? { dir: credDir } : {});
+    if (!creds || !creds.access_token) {
+      err('还没登录。请先运行：linger auth login');
+      return 3;
+    }
+    const token = creds.access_token;
+    const idemKey = flags.idempotencyKey || null; // null → api 层自动生成 UUID
+
+    // ── 已有命令（M3）────────────────────────────────────────
+
+    if (command === 'wallet') {
+      const data = await getWallet(baseUrl, token, { fetchImpl });
+      log(formatWallet(data, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'hall:browse') {
+      const data = await getHall(baseUrl, token, { fetchImpl });
+      log(formatHall(data, { json: flags.json }));
+      return 0;
+    }
+
+    // ── 探活 ─────────────────────────────────────────────────
+
+    if (command === 'ping') {
+      const data = await getCruise(baseUrl, token, { fetchImpl });
+      log(formatPing(data, { json: flags.json }));
+      return 0;
+    }
+
+    // ── 任务生命周期前段 ─────────────────────────────────────
+
+    if (command === 'task:create') {
+      // 必填项校验（薄包装：只做入参存在性检查，不做业务规则）
+      if (!flags.title) { err('缺少 --title 参数'); return 2; }
+      if (!flags.description) { err('缺少 --description 参数'); return 2; }
+      if (flags.bountyCents == null) { err('缺少 --bounty-cents 参数'); return 2; }
+      if (flags.deliveryHours == null) { err('缺少 --delivery-hours 参数'); return 2; }
+      if (!flags.tags || flags.tags.length === 0) { err('缺少 --tags 参数（至少 1 个标签，逗号分隔）'); return 2; }
+      const taskData = {
+        title: flags.title,
+        description: flags.description,
+        bounty_amount_cents: flags.bountyCents,
+        delivery_hours: flags.deliveryHours,
+        tags: flags.tags,
+      };
+      const data = await createTask(baseUrl, token, taskData, idemKey, { fetchImpl });
+      log(formatTaskCreate(data, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:apply') {
+      // positionals = ['task', 'apply', '<task_id>'] → [2] 是 task_id
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数。用法：linger task apply <task_id>'); return 2; }
+      const applyData = {};
+      if (flags.message) applyData.message = flags.message;
+      const data = await applyTask(baseUrl, token, taskId, applyData, idemKey, { fetchImpl });
+      log(formatTaskApply(data, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:select') {
+      // positionals = ['task', 'select', '<task_id>', '<app_id>']
+      const taskId = positionals[2];
+      const appId = positionals[3];
+      if (!taskId) { err('缺少 task_id 参数。用法：linger task select <task_id> <application_id>'); return 2; }
+      if (!appId) { err('缺少 application_id 参数。用法：linger task select <task_id> <application_id>'); return 2; }
+      const data = await selectApplication(baseUrl, token, taskId, appId, idemKey, { fetchImpl });
+      log(formatTaskSelect(data, { json: flags.json }));
+      return 0;
+    }
+
+    // ── 任务执行/结算（统一走 runtime/act）───────────────────
+
+    if (command === 'task:accept') {
+      // positionals = ['task', 'accept', '<task_id>']
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      // 后端 accept 需要 application_id（之前 task apply 时返回的）
+      if (!flags.applicationId) {
+        err('缺少 --application-id 参数（task apply 时返回的申请 ID）');
+        return 2;
+      }
+      const data = await runtimeAct(
+        baseUrl, token, 'accept_job',
+        { job_id: taskId, application_id: flags.applicationId },
+        idemKey, { fetchImpl }
+      );
+      log(formatRuntimeAct(data, '已接单！', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:start') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      const data = await runtimeAct(
+        baseUrl, token, 'start',
+        { job_id: taskId },
+        idemKey, { fetchImpl }
+      );
+      log(formatRuntimeAct(data, '已开始执行！', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:heartbeat') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      if (flags.progress == null) { err('缺少 --progress 参数（0-100）'); return 2; }
+      const payload = { job_id: taskId, progress: flags.progress };
+      if (flags.note) payload.progress_note = flags.note;
+      const data = await runtimeAct(baseUrl, token, 'heartbeat_job', payload, idemKey, { fetchImpl });
+      log(formatRuntimeAct(data, `进度已更新（${flags.progress}%）`, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:deliver') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      if (!flags.result) { err('缺少 --result 参数（交付结果内容）'); return 2; }
+      const payload = { job_id: taskId, result_payload: flags.result };
+      const data = await runtimeAct(baseUrl, token, 'deliver_job', payload, idemKey, { fetchImpl });
+      log(formatRuntimeAct(data, '已提交交付！（系统自动进入待验收）', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:fail') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      const payload = { job_id: taskId };
+      if (flags.reason) payload.reason = flags.reason;
+      if (flags.errorCode) payload.error_code = flags.errorCode;
+      if (flags.errorMessage) payload.error_message = flags.errorMessage;
+      const data = await runtimeAct(baseUrl, token, 'fail_job', payload, idemKey, { fetchImpl });
+      log(formatRuntimeAct(data, '任务已标记失败。', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:confirm') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      const data = await runtimeAct(
+        baseUrl, token, 'confirm',
+        { job_id: taskId },
+        idemKey, { fetchImpl }
+      );
+      log(formatRuntimeAct(data, '已确认放款！赏金将结算给接单方。', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:reject') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      const payload = { job_id: taskId };
+      if (flags.reason) payload.reason = flags.reason;
+      const data = await runtimeAct(baseUrl, token, 'reject_job', payload, idemKey, { fetchImpl });
+      log(formatRuntimeAct(data, '已拒收，任务进入仲裁流程。', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:revise') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      if (!flags.note) { err('缺少 --note 参数（改稿要求）'); return 2; }
+      const data = await runtimeAct(
+        baseUrl, token, 'request_revision',
+        { job_id: taskId, revision_note: flags.note },
+        idemKey, { fetchImpl }
+      );
+      log(formatRuntimeAct(data, '已发出改稿请求。', { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:accept-partial') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      if (flags.refundPct == null) { err('缺少 --refund-pct 参数（退款百分比 0-100）'); return 2; }
+      const data = await runtimeAct(
+        baseUrl, token, 'accept_partial',
+        { job_id: taskId, refund_pct: flags.refundPct },
+        idemKey, { fetchImpl }
+      );
+      log(formatRuntimeAct(data, `已部分接受（退款 ${flags.refundPct}%）。`, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'task:cancel') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数'); return 2; }
+      const payload = { job_id: taskId };
+      if (flags.reason) payload.reason = flags.reason;
+      const data = await runtimeAct(baseUrl, token, 'cancel', payload, idemKey, { fetchImpl });
+      log(formatRuntimeAct(data, '任务已取消，已托管赏金将退回。', { json: flags.json }));
+      return 0;
+    }
+
+    // ── 能力上架 ─────────────────────────────────────────────
+
+    if (command === 'capability:create') {
+      if (!flags.agentId) { err('缺少 --agent-id 参数'); return 2; }
+      if (!flags.title) { err('缺少 --title 参数'); return 2; }
+      const capData = { agent_id: flags.agentId, title: flags.title };
+      if (flags.description) capData.description = flags.description;
+      if (flags.type) capData.type = flags.type;
+      if (flags.category) capData.category = flags.category;
+      if (flags.tags && flags.tags.length > 0) capData.tags = flags.tags;
+      if (flags.priceCents != null) capData.price_cents = flags.priceCents;
+      // M5：交付物边界说明（草稿可空，上架前平台要求必填）
+      if (flags.deliverableBoundary) capData.deliverable_boundary = flags.deliverableBoundary;
+      const data = await createCapability(baseUrl, token, capData, idemKey, { fetchImpl });
+      log(formatCapabilityCreate(data, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'capability:publish') {
+      // positionals = ['capability', 'publish', '<cap_id>']
+      const capId = positionals[2];
+      if (!capId) { err('缺少 capability_id 参数。用法：linger capability publish <cap_id>'); return 2; }
+      const data = await publishCapability(baseUrl, token, capId, idemKey, { fetchImpl });
+      log(formatCapabilityPublish(data, { json: flags.json }));
+      return 0;
+    }
+
+    // ── 问答 ─────────────────────────────────────────────────
+
+    if (command === 'qa:post') {
+      const taskId = positionals[1];
+      // 消息内容：positionals[2] 或 --message flag
+      const content = positionals[2] || flags.message;
+      if (!taskId) { err('缺少 task_id 参数。用法：linger qa <task_id> <消息>'); return 2; }
+      if (!content) { err('缺少消息内容。用法：linger qa <task_id> <消息>'); return 2; }
+      const data = await postComment(baseUrl, token, taskId, content, null, idemKey, { fetchImpl });
+      log(formatPostComment(data, { json: flags.json }));
+      return 0;
+    }
+
+    if (command === 'qa:list') {
+      const taskId = positionals[1];
+      if (!taskId) { err('缺少 task_id 参数。用法：linger qa <task_id> --list'); return 2; }
+      const data = await getComments(baseUrl, token, taskId, { fetchImpl });
+      log(formatComments(data, { json: flags.json }));
+      return 0;
+    }
+
+    // ── 自治巡航 ─────────────────────────────────────────────
+
+    if (command === 'autonomy:tick') {
+      const data = await getCruise(baseUrl, token, { fetchImpl });
+      log(formatCruise(data, { json: flags.json }));
+      return 0;
+    }
+
+  } catch (e) {
+    err(e && e.message ? e.message : String(e));
+    return 1;
+  }
+
+  // 理论上到不了这里（所有已知 command 都在上面分支覆盖了）
+  err('未处理的命令。');
+  return 2;
+}