@xdxer/dingtalk-agent 0.1.5-beta.1 → 0.1.5-beta.11

package/dist/bin/dingtalk-agent.js

@@ -31,16 +31,20 @@ import { runRobotEvaluation } from '../src/robot-evals.js';
 import { runOpenCodeEvaluation } from '../src/opencode-evals.js';
 import { runStorageEvaluation } from '../src/storage-evals.js';
 import { runPersonalEventEvaluation } from '../src/personal-event-evals.js';
-import { doctor } from '../src/doctor.js';
+import { CHECK_LABELS, doctor } from '../src/doctor.js';
 import { doctorDevelopmentWorkspace, inspectAgentProject, showDevelopmentWorkspace, } from '../src/development-workspace.js';
+import { buildScheduleShow, buildSchedulePlan, scheduleBlockers } from '../src/schedule-plan.js';
 import { applyOpenCodeWorkspace, evalOpenCodeWorkspace, planOpenCodeWorkspace, runOpenCodeWorkspace, useOpenCodeWorkspace, } from '../src/opencode-provider.js';
-import { inspectMulticaWorkspace, listMulticaWorkspaceResources, planMulticaWorkspace, statusMulticaWorkspace, } from '../src/multica-provider.js';
-import { applyMulticaDeployment, listMulticaDeployments, planMulticaDeployment, statusMulticaDeployment, } from '../src/multica-deploy.js';
+import { inspectMulticaWorkspace, listMulticaWorkspaceResources, planMulticaWorkspace, scaffoldMulticaWorkspace, statusMulticaWorkspace, } from '../src/multica-provider.js';
+import { applyMulticaDeployment, listMulticaDeployments, planMulticaDeployment, runMulticaWorkspaceIssue, statusMulticaDeployment, statusMulticaWorkspaceRun, } from '../src/multica-deploy.js';
 import { applyObservation, applyPromotion, listPromotions, planObservation, planPromotion, statusPromotion, } from '../src/promotion.js';
 import { setup } from '../src/setup.js';
-import { upgradeAgent } from '../src/upgrade.js';
+import { checkUpgrade, upgradeAgent } from '../src/upgrade.js';
+// out/err 在本文件里改名导入：printX 的形参普遍叫 out，直接同名会被遮蔽。
+import { configureTui, confirm, displayWidth, padRight, renderPairs, StepReporter, err as stderrUi, out as stdoutUi, } from '../src/tui.js';
 import { checkpointTask, showTaskCheckpoint } from '../src/memory/task-checkpoints.js';
 import { upsertOperationalMemory } from '../src/memory/operational.js';
+import { listMemoryNoops, recordMemoryNoop, traceMemoryNoop } from '../src/memory/noop-receipt.js';
 import { proposeMemoryCandidate, publishMemoryCandidate, reviewMemoryCandidate, showMemoryCandidate, } from '../src/memory/candidates.js';
 import { installBundledSkills, installGlobalSkill, skillStatus, skillSuiteStatus, uninstallBundledSkills, uninstallGlobalSkill, upgradeBundledSkills, upgradeGlobalSkill, } from '../src/skill-manager.js';
 import { agentPlatformReadiness, MANAGED_AGENT_PLATFORMS, multicaTargets, platformDocPath, platformSkillForRole, requireSupportedAgentPlatform, resolveAgentPlatform, resolveEndpoint, statusLabel as platformStatusLabel, useAgentPlatform, } from '../src/agent-platform.js';
@@ -64,7 +68,7 @@ dta —— 给 Agent 安装钉钉员工的基础行为和工作环境
   dta setup             首次配置 CLI、DWS 和内置 Skill（基础行为 + Agent 装配 + 交付后评测）
   dta bootstrap --json  为当前 Agent 会话加载工作区
   dta agent enhance / audit  安全增强已有仓库，再审计定义、存储与 Skill 真加载
-  dta info / dta workspace doctor <name>  查看 Project 并只读诊断 Workspace
+  dta info / workspace doctor / schedule show <name>  只读诊断 Project、Workspace 与声明的常驻节律
   dta agent-platform use <platform> → dta deploy / dta promote  声明平台归属并装平台技能包，再受控部署与晋级
 
 维护环境：
@@ -86,6 +90,7 @@ dingtalk-agent 可信事件运行时（可选宿主能力）
   task checkpoint --input checkpoint.json --expect-revision N
   memory operational upsert --provider provider.json --input record.json [--live --yes]
   memory candidate propose|show|review|publish
+  memory noop record|list|trace
   act ack|reply|ask|silence
 
 这些命令负责目标冻结、Session/Run、Wait、幂等和回执；普通 Agent Session 不必使用。
@@ -155,7 +160,7 @@ const DEPLOY_HELP = `
 dingtalk-agent Multica 受控部署
 
   deploy --workspace <name> --dry-run [--json]
-  deploy --workspace <name> --plan-id <id> --yes [--no-wait] [--json]
+  deploy --workspace <name> --plan-id <id> --yes [--wait | --no-wait] [--json]
   deploy --workspace <name> --status [--operation-id <id>] [--json]
   deploy --workspace <name> --status --operation-id <id> --execute --yes [--json]
   deploy --workspace <name> --list [--json]
@@ -163,6 +168,9 @@ dingtalk-agent Multica 受控部署
   deploy --workspace <name> --retire --plan-id <id> --yes [--json]
 
 dry-run 不启动 Multica。apply/retire 必须携带当前 planId；scope 或源码漂移会在写入前拒绝。
+apply 默认在同一条命令内等 load smoke 到 ~30 秒；云端 runtime 冷启常超 30 秒会返回 verifying，
+再用 --status --operation-id 独立 reconcile。加 --wait 把等待预算放宽到 4 分钟，一条命令直接到 ready；
+--no-wait 立即返回 verifying（异步/CI）。--smoke-timeout <ms> 精确覆盖等待预算（上限 5 分钟）。
 status 默认只验本地脱敏 operation/Receipt；--execute --yes 才做远端独立回读。
 deploy 只管理 Agent、完整 Skill tree、assignment 和 load smoke，不创建机器人、Webhook、Autopilot 或定时 Trigger。
 `;
@@ -179,13 +187,100 @@ dingtalk-agent 已验版本晋级与反馈候选
 Promotion 只接受指定 suite 的 load/hard/surface gate 与精确 W2 evidence hash，并委托 W4 deploy。
 Observe 只写 gitignored、proposed、不可直接发布的 Eval candidate；不修改 AGENTS.md、Prompt、Skill 或 Trigger。
 `;
+const UPGRADE_HELP = `
+dta upgrade —— 自升级 CLI，再重新检查完整环境
+
+用法:
+  dta upgrade                       升级到当前通道的最新版本
+  dta upgrade --check               只查有没有新版本，不安装
+  dta upgrade --dry-run             只预览将执行的命令，不安装
+  dta upgrade --channel beta        指定通道（beta | latest）
+  dta upgrade --version <x.y.z>     升级到指定版本
+  dta upgrade --version <x.y.z> --force   允许降级（两者必须同时给）
+  dta upgrade --yes                 跳过确认提示（AI Agent 模式）
+  dta upgrade --json                机器通道；输出 upgrade@1，不打任何进度
+
+参数:
+  --check           只解析升级目标并对比当前版本
+  --channel <name>  beta 或 latest；不给时按当前版本是否带 - 推断
+  --version <ver>   精确版本；与 --channel 互斥
+  --prefix <dir>    安装前缀，默认 ~/.local
+  --dry-run         不安装，只回报将执行的 install/verify 命令
+  --force           强制重装当前版本；配合 --version 才允许降级
+  --yes             跳过确认；非交互环境本来就不提示
+  --json            输出 JSON，不混入任何日志
+  --no-color        关闭颜色（也支持 NO_COLOR 环境变量）
+
+升级过程分 7 步：冻结 Skill 版本 → 解析目标 → 检查版本关系 → 安装
+→ 定位新 CLI → 校验版本 → 复核环境。前 3 步失败不会改动机器；从第 4 步
+（安装）起失败可能留下已更新但未复核的 CLI，此时按提示重跑 setup 或
+用 --version <旧版本> --force 回退。
+
+非交互环境（管道 / CI / Agent 调用）不提示确认，直接执行。
+颜色只在终端里出现；管道里想要颜色需显式 --color。
+`;
+/**
+ * 帮助文本的打印时装饰。**不把 ANSI 写进常量**——常量一旦带色就没法降级，
+ * 而这里 color=false 时原样返回，NO_COLOR / 管道下与改造前逐字节相同。
+ *
+ * 只染整段连续短语：命令名从行首吃到两个以上空格为止，所以
+ * `dta setup`、`dta skill status` 这类断言目标始终完整。行数不变。
+ */
+function renderHelp(text) {
+    const { ctx, theme } = stdoutUi();
+    if (!ctx.color)
+        return text;
+    return text.split('\n').map((line, index) => {
+        if (index === 1 && line.trim())
+            return theme.bold(line);
+        if (/^\S.*[：:]$/.test(line))
+            return theme.bold(line);
+        if (/^\s+·\s/.test(line))
+            return theme.dim(line);
+        const command = line.match(/^(\s+)((?:dta|dingtalk-agent)\s\S.*?)(\s{2,})(.*)$/);
+        if (command)
+            return `${command[1]}${theme.noun(command[2])}${command[3]}${theme.dim(command[4])}`;
+        return line;
+    }).join('\n');
+}
 function fail(msg, code = 1, hint = '') {
-    console.error(`错误: ${msg}`);
+    // 整行染色，绝不做 danger('错误') + ': ' + msg 这种切分——
+    // 契约 eval 断言的是 stderr.includes('错误:')，切开就再也匹配不上。
+    const { theme } = stderrUi();
+    console.error(theme.danger(`错误: ${msg}`));
     if (hint)
-        console.error(`提示: ${hint}`);
+        console.error(theme.dim(`提示: ${hint}`));
     process.exit(code);
 }
-const argv = process.argv.slice(2);
+// --color / --no-color 在 dispatch 前预剥：parseArgs 是 strict 模式，
+// 想让它成为全局参数就得改 23 个 options 块，预剥只需要这一处。
+//
+// 三条边界：`--` 之后的 token 是 positional，一律不碰；非法取值报错而不是
+// 静默吞掉；同一参数出现多次以最后一次为准（与 parseArgs 的口径一致）。
+const rawArgv = process.argv.slice(2);
+const COLOR_VALUES = new Set(['auto', 'always', 'never']);
+const terminator = rawArgv.indexOf('--');
+const scannable = terminator === -1 ? rawArgv : rawArgv.slice(0, terminator);
+let colorFlag = 'auto';
+for (const item of scannable) {
+    if (item === '--no-color')
+        colorFlag = 'never';
+    else if (item === '--color')
+        colorFlag = 'always';
+    else if (item.startsWith('--color=')) {
+        const value = item.slice('--color='.length);
+        if (!COLOR_VALUES.has(value)) {
+            console.error(`错误: --color 只接受 auto | always | never，收到 ${JSON.stringify(value)}`);
+            process.exit(1);
+        }
+        colorFlag = value;
+    }
+}
+configureTui(colorFlag);
+const isColorToken = (item) => item === '--color' || item === '--no-color' || item.startsWith('--color=');
+const argv = terminator === -1
+    ? rawArgv.filter((item) => !isColorToken(item))
+    : [...rawArgv.slice(0, terminator).filter((item) => !isColorToken(item)), ...rawArgv.slice(terminator)];
 const cmd = argv[0];
 const sub = argv[1];
 try {
@@ -198,38 +293,38 @@ catch (e) {
 }
 async function main() {
     if (cmd === 'help' && sub === 'runtime') {
-        console.log(RUNTIME_HELP);
+        console.log(renderHelp(RUNTIME_HELP));
         return;
     }
     if (cmd === 'help' && sub === 'adapters') {
-        console.log(ADAPTER_HELP);
+        console.log(renderHelp(ADAPTER_HELP));
         return;
     }
     if (cmd === 'help' && sub === 'lab') {
-        console.log(LAB_HELP);
+        console.log(renderHelp(LAB_HELP));
         return;
     }
     if (cmd === 'help' && sub === 'agent') {
-        console.log(AGENT_HELP);
+        console.log(renderHelp(AGENT_HELP));
         return;
     }
     if (cmd === 'help' && sub === 'workspace') {
-        console.log(WORKSPACE_HELP);
+        console.log(renderHelp(WORKSPACE_HELP));
         return;
     }
     if (cmd === 'help' && sub === 'deploy') {
-        console.log(DEPLOY_HELP);
+        console.log(renderHelp(DEPLOY_HELP));
         return;
     }
     if (cmd === 'help' && ['promote', 'observe'].includes(sub || '')) {
-        console.log(PROMOTION_HELP);
+        console.log(renderHelp(PROMOTION_HELP));
         return;
     }
     if (cmd === 'help' && sub) {
         fail(`不认识的帮助主题: ${sub}`, 1, '运行 dta --help 回到产品入口；事件宿主可用 dta help runtime。');
     }
     if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
-        console.log(HELP);
+        console.log(renderHelp(HELP));
         return;
     }
     if (cmd === '--version' || cmd === '-V' || cmd === 'version') {
@@ -245,10 +340,11 @@ async function main() {
                 workspace: { type: 'string' }, json: { type: 'boolean' },
                 'dry-run': { type: 'boolean' }, yes: { type: 'boolean' },
                 'plan-id': { type: 'string' }, 'no-wait': { type: 'boolean' },
+                wait: { type: 'boolean' },
                 status: { type: 'boolean' }, list: { type: 'boolean' },
                 execute: { type: 'boolean' }, 'operation-id': { type: 'string' },
                 timeout: { type: 'string' }, 'smoke-timeout': { type: 'string' },
-                retire: { type: 'boolean' },
+                retire: { type: 'boolean' }, 'rebind-runtime': { type: 'boolean' },
             },
         });
         if (positionals.length)
@@ -265,16 +361,21 @@ async function main() {
         const timeoutMs = parseOptionalTimeout(o.timeout, '--timeout');
         const smokeTimeoutMs = parseOptionalTimeout(o['smoke-timeout'], '--smoke-timeout');
         let out;
+        if (o.wait && o['no-wait'])
+            fail('deploy --wait 与 --no-wait 互斥');
+        if (o['rebind-runtime'] && o.retire)
+            fail('deploy --rebind-runtime 与 --retire 互斥');
         if (o.list) {
-            if (o.execute || o['operation-id'] || o.retire || o['plan-id'] || o['no-wait'] ||
-                o.timeout || o['smoke-timeout']) {
+            if (o.execute || o['operation-id'] || o.retire || o['plan-id'] || o['no-wait'] || o.wait ||
+                o.timeout || o['smoke-timeout'] || o['rebind-runtime']) {
                 fail('deploy --list 只接受 --workspace 和 --json');
             }
             out = listMulticaDeployments(PROJECT_START, o.workspace, PACKAGE_JSON.version);
         }
         else if (o.status) {
-            if (o.retire || o['plan-id'] || o['no-wait'] || o['dry-run'] || o['smoke-timeout']) {
-                fail('deploy --status 不接受 retire/plan-id/no-wait/dry-run/smoke-timeout');
+            if (o.retire || o['plan-id'] || o['no-wait'] || o.wait || o['dry-run'] || o['smoke-timeout'] ||
+                o['rebind-runtime']) {
+                fail('deploy --status 不接受 retire/plan-id/no-wait/wait/dry-run/smoke-timeout/rebind-runtime');
             }
             if (Boolean(o.execute) !== Boolean(o.yes)) {
                 fail('deploy --status 远端 reconcile 必须同时传 --execute --yes');
@@ -285,24 +386,30 @@ async function main() {
             });
         }
         else if (o['dry-run']) {
-            if (o.execute || o['operation-id'] || o['plan-id'] || o['no-wait'] ||
+            if (o.execute || o['operation-id'] || o['plan-id'] || o['no-wait'] || o.wait ||
                 o.timeout || o['smoke-timeout']) {
-                fail('deploy --dry-run 不接受 execute/operation-id/plan-id/no-wait/timeout/smoke-timeout');
+                fail('deploy --dry-run 不接受 execute/operation-id/plan-id/no-wait/wait/timeout/smoke-timeout');
             }
             out = planMulticaDeployment(PROJECT_START, o.workspace, {
                 action: o.retire ? 'retire' : 'apply', cliVersion: PACKAGE_JSON.version,
+                rebindRuntime: o['rebind-runtime'],
             });
         }
         else {
             if (o.execute || o['operation-id'] || o.status || o.list || o['dry-run']) {
                 fail('deploy apply 不接受 execute/operation-id/status/list/dry-run');
             }
-            if (o.retire && (o['no-wait'] || o['smoke-timeout'])) {
-                fail('deploy --retire 不接受 no-wait/smoke-timeout');
+            if (o.retire && (o['no-wait'] || o.wait || o['smoke-timeout'])) {
+                fail('deploy --retire 不接受 no-wait/wait/smoke-timeout');
             }
+            // --wait widens the in-band smoke-wait budget so one command reaches ready across a
+            // cold-start runtime; an explicit --smoke-timeout still wins. Default stays ~30s.
+            const effectiveSmokeTimeoutMs = smokeTimeoutMs !== undefined
+                ? smokeTimeoutMs : o.wait ? 240_000 : undefined;
             out = applyMulticaDeployment(PROJECT_START, o.workspace, {
                 yes: o.yes, planId: o['plan-id'], noWait: o['no-wait'],
-                timeoutMs, smokeTimeoutMs, cliVersion: PACKAGE_JSON.version,
+                timeoutMs, smokeTimeoutMs: effectiveSmokeTimeoutMs, cliVersion: PACKAGE_JSON.version,
+                rebindRuntime: o['rebind-runtime'],
             }, o.retire ? 'retire' : 'apply');
         }
         if (o.json)
@@ -413,6 +520,106 @@ async function main() {
             printProjectInfo(out);
         return;
     }
+    if (cmd === 'schedule') {
+        const sub = argv[1];
+        const { values: o, positionals } = parseArgs({
+            args: argv.slice(2), allowPositionals: true,
+            options: { json: { type: 'boolean' }, workspace: { type: 'string' } },
+        });
+        if (sub === 'show') {
+            const out = buildScheduleShow(PROJECT_START, PACKAGE_JSON.version);
+            // 有阻断问题 = 非 0 退出，json 和人类两条路都设，否则自动化用 --json 拿到 exit 0 照样部署 → fail-open。
+            // 判据来自 scheduleBlockers（含 unverified），不在这手写，避免和 plan 那边分叉。
+            if (scheduleBlockers(out).length)
+                process.exitCode = 2;
+            if (o.json) {
+                console.log(JSON.stringify(out, null, 2));
+                return;
+            }
+            if (out.count === 0) {
+                console.log(muted('本 Project 未声明任何常驻节律（schedules）。'));
+                return;
+            }
+            console.log(`${strong('声明的常驻节律（本地 manifest 声明，非线上实态）')} · ${out.count} 条`);
+            for (const s of out.schedules) {
+                const metered = s.mode === 'work-item' ? '记账' : '不记账';
+                console.log(`\n  ${noun(s.name)}  ${s.cron}  ${s.timezone}  ${muted(`[${s.mode}·${metered}]`)}`);
+                if (s.wake)
+                    console.log(muted(`    唤醒 ${s.wake}`));
+                if (s.completion)
+                    console.log(muted(`    ②判据 ${s.completion}`));
+            }
+            if (out.collidingPairs.length) {
+                console.log(`\n${mark('fail', `✗ 同刻并发: ${out.collidingPairs.join('、')} —— 外发拍同一时刻 fire 会重复送第三方，请错开`)}`);
+            }
+            if (out.missingCompletion.length) {
+                console.log(`${mark('fail', `✗ 缺完成判据: ${out.missingCompletion.join('、')} —— 没有数据派生的 completion，只能靠"跑没跑"判完成，漏拍就永久丢一期`)}`);
+            }
+            if (out.unverifiedPairs.length) {
+                console.log(`${mark('fail', `✗ 证不出是否同刻: ${out.unverifiedPairs.join('、')} —— 跨时区或 cron 扩展语法本地读不懂，一律当撞车挡住（0 9 * * * @Asia/Shanghai 和 0 1 * * * @UTC 就是同一时刻）；把两条写成同一个 timezone，或换掉扩展语法`)}`);
+            }
+            for (const issue of out.completionRefIssues) {
+                console.log(`${mark('fail', `✗ 判据引用: ${issue}`)}`);
+            }
+            // 绿灯条件必须和退出码同源（scheduleBlockers），否则新增一类 blocker 时
+            // 人类输出继续报绿而 exit 2——手工操作者只看文案就会照常部署（issue #38）。
+            if (!scheduleBlockers(out).length) {
+                console.log(`\n${mark('pass', '✓ 各节律不同刻 fire、完成判据齐备且引用合法')}`);
+            }
+            return;
+        }
+        if (sub === 'plan') {
+            const workspaceName = o.workspace || positionals[0];
+            if (!workspaceName)
+                fail('schedule plan 需要 --workspace <name>');
+            const info = inspectAgentProject(PROJECT_START, PACKAGE_JSON.version);
+            const plan = buildSchedulePlan(info, workspaceName);
+            // fail closed（json 和人类两条路都设）：plan 是 operator 真正照着部署的路径，
+            // 撞车不在这拦，两条会各建一个 autopilot → 重复外发。判据同 show，见 scheduleBlockers。
+            if (scheduleBlockers(plan).length)
+                process.exitCode = 2;
+            if (o.json) {
+                console.log(JSON.stringify(plan, null, 2));
+                return;
+            }
+            console.log(`${strong('schedule 部署计划')} · workspace=${noun(plan.workspace)} · provider=${plan.provider}`);
+            if (!plan.supported) {
+                console.log(`\n${mark('fail', `✗ 不支持: ${plan.reason}`)}`);
+                console.log(`  ${noun(plan.reconcile)}`);
+                process.exitCode = 2;
+                return;
+            }
+            // 阻断时不打印任何可执行命令：手工操作者会复制粘贴人类输出里的命令，
+            // 「成功版面 + 可执行命令 + exit 2」等于把 fail-closed 只留给脚本（issue #38）。
+            const blocked = scheduleBlockers(plan).length > 0;
+            if (!blocked) {
+                console.log(`  ${plan.count} 条声明 → provider ops:\n`);
+                for (const s of plan.schedules) {
+                    console.log(`  ${muted(`# ${s.name}  [${s.metered ? '记账' : '不记账·平台看不到成本'}]`)}\n  ${noun(s.applyCommand)}\n`);
+                }
+            }
+            else {
+                console.log(`\n${mark('fail', `✗ 已阻断：manifest 存在必须先修复的问题，本计划不可执行（apply 命令已隐藏）`)}`);
+            }
+            if (plan.collidingPairs.length) {
+                console.log(`${mark('fail', `✗ 同刻并发: ${plan.collidingPairs.join('、')} —— 别照此部署，两条会各建一个 autopilot → 重复外发；先错开 fire 时刻`)}`);
+            }
+            if (plan.missingCompletion.length) {
+                console.log(`${mark('fail', `✗ 缺完成判据: ${plan.missingCompletion.join('、')} —— 补上数据派生的 completion，别靠"跑没跑"判完成`)}`);
+            }
+            if (plan.unverifiedPairs.length) {
+                console.log(`${mark('fail', `✗ 证不出是否同刻: ${plan.unverifiedPairs.join('、')} —— 别照此部署。跨时区或扩展语法本地判不了，一律当撞车；把两条写成同一个 timezone 再 plan，判得出不撞就自动放行`)}`);
+            }
+            for (const issue of plan.completionRefIssues) {
+                console.log(`${mark('fail', `✗ 判据引用: ${issue}`)}`);
+            }
+            if (!blocked)
+                console.log(`执行: ${noun(plan.reconcile)}`);
+            return;
+        }
+        fail(`可用: dta schedule show | plan --workspace <name>${suggest(sub || '', ['show', 'plan'], 'dta schedule')}`);
+        return;
+    }
     if (cmd === 'workspace') {
         const { values: o, positionals } = parseArgs({
             args: argv.slice(2), allowPositionals: true,
@@ -423,6 +630,8 @@ async function main() {
                 cases: { type: 'string' }, lanes: { type: 'string' }, runs: { type: 'string' },
                 out: { type: 'string' }, timeout: { type: 'string' },
                 'previous-skill': { type: 'string' },
+                status: { type: 'boolean' }, 'run-id': { type: 'string' },
+                provider: { type: 'string' }, stage: { type: 'string' }, profile: { type: 'string' },
             },
         });
         if (sub === 'list') {
@@ -544,16 +753,46 @@ async function main() {
             return;
         }
         if (sub === 'create') {
-            rejectWorkspaceOptions(o, ['json', 'yes', 'dry-run'], 'workspace create');
             if (positionals.length !== 1)
                 fail('workspace create 需要且只接受一个 Workspace name');
             if (o.yes && o['dry-run'])
                 fail('workspace create 的 --dry-run 与 --yes 不能同时使用');
+            const wsName = positionals[0];
+            // Resolve the provider kind to scaffold/build: explicit --provider wins, else an already
+            // declared Workspace keeps its kind, else the attributed platform's provider (registry-
+            // driven so deap inherits it), else opencode. multica has no local host — create authors
+            // its config entry; opencode keeps building the managed host.
+            if (o.provider && !['opencode', 'multica'].includes(String(o.provider))) {
+                fail('workspace create --provider 只支持 opencode 或 multica');
+            }
+            const declaredWs = inspectAgentProject(PROJECT_START, PACKAGE_JSON.version)
+                .workspaces.find((item) => item.name === wsName);
+            const platformProvider = resolveAgentPlatform(PROJECT_START).definition?.provider;
+            const kind = String(o.provider || declaredWs?.provider.kind || platformProvider || 'opencode');
+            if (declaredWs && o.provider && declaredWs.provider.kind !== kind) {
+                fail(`Workspace ${wsName} 已声明为 ${declaredWs.provider.kind}，与 --provider ${kind} 冲突`);
+            }
+            if (kind === 'multica') {
+                rejectWorkspaceOptions(o, ['json', 'yes', 'dry-run', 'provider', 'stage', 'profile'], 'workspace create');
+                const out = scaffoldMulticaWorkspace(PROJECT_START, wsName, {
+                    stage: o.stage, profile: o.profile, apply: o.yes, cliVersion: PACKAGE_JSON.version,
+                });
+                if (o.json)
+                    console.log(JSON.stringify(out, null, 2));
+                else {
+                    const tag = out.alreadyDeclared ? '已存在' : out.applied ? '已写入' : 'DRY-RUN';
+                    console.log(`${tag} workspace ${out.workspace} · provider=multica · profile=${out.profile}`);
+                    for (const step of out.nextSteps)
+                        console.log(`   ${step}`);
+                }
+                return;
+            }
+            rejectWorkspaceOptions(o, ['json', 'yes', 'dry-run', 'provider'], 'workspace create');
             const out = o.yes
-                ? applyOpenCodeWorkspace(PROJECT_START, positionals[0], {
+                ? applyOpenCodeWorkspace(PROJECT_START, wsName, {
                     yes: true, cliVersion: PACKAGE_JSON.version,
                 })
-                : planOpenCodeWorkspace(PROJECT_START, positionals[0], PACKAGE_JSON.version);
+                : planOpenCodeWorkspace(PROJECT_START, wsName, PACKAGE_JSON.version);
             if (o.json)
                 console.log(JSON.stringify(out, null, 2));
             else
@@ -568,30 +807,65 @@ async function main() {
             if (o.json)
                 console.log(JSON.stringify(out, null, 2));
             else
-                console.log(`✅ current workspace: ${out.previous || '-'} → ${out.current}`);
+                console.log(`${mark('pass', '✅')} current workspace: ${muted(out.previous || '-')} → ${noun(out.current)}`);
             return;
         }
         if (sub === 'run') {
+            const timeoutMs = o.timeout === undefined ? undefined : Number(o.timeout);
+            if (o.status) {
+                // Resume a timed-out multica run by re-reading the SAME Issue; no new Issue is created.
+                rejectWorkspaceOptions(o, ['json', 'yes', 'execute', 'out', 'timeout', 'status', 'run-id'], 'workspace run --status');
+                if (positionals.length !== 1)
+                    fail('workspace run --status 需要一个 Workspace name');
+                if (o['prompt-file'])
+                    fail('workspace run --status 不接受 --prompt-file；用 --run-id 续读');
+                if (!o['run-id'])
+                    fail('workspace run --status 需要 --run-id <上次 run 的 runId>');
+                const out = statusMulticaWorkspaceRun(PROJECT_START, positionals[0], {
+                    runId: o['run-id'], execute: o.execute, yes: o.yes, timeoutMs, out: o.out,
+                    cliVersion: PACKAGE_JSON.version,
+                });
+                if (o.json)
+                    console.log(JSON.stringify(out, null, 2));
+                else {
+                    console.log(`${out.passed ? '✅' : '❌'} workspace run ${out.runId} (resumed)`);
+                    if (out.answer)
+                        console.log(out.answer);
+                }
+                if (!out.passed)
+                    process.exitCode = 2;
+                return;
+            }
             rejectWorkspaceOptions(o, ['json', 'yes', 'execute', 'prompt-file', 'out', 'timeout'], 'workspace run');
             if (positionals.length !== 1 || !o['prompt-file']) {
                 fail('workspace run 需要一个 Workspace name 和 --prompt-file <file>');
             }
-            const timeoutMs = o.timeout === undefined ? undefined : Number(o.timeout);
             const prompt = readProjectText(PROJECT_START, o['prompt-file'], 'workspace run prompt');
-            const out = runOpenCodeWorkspace(PROJECT_START, positionals[0], prompt, {
-                execute: o.execute, yes: o.yes, timeoutMs, out: o.out,
-            });
+            const workspace = showDevelopmentWorkspace(PROJECT_START, positionals[0], PACKAGE_JSON.version);
+            const out = workspace.provider.kind === 'multica'
+                ? runMulticaWorkspaceIssue(PROJECT_START, positionals[0], prompt, {
+                    execute: o.execute, yes: o.yes, timeoutMs, out: o.out,
+                    cliVersion: PACKAGE_JSON.version,
+                })
+                : runOpenCodeWorkspace(PROJECT_START, positionals[0], prompt, {
+                    execute: o.execute, yes: o.yes, timeoutMs, out: o.out,
+                });
             if (o.json)
                 console.log(JSON.stringify(out, null, 2));
             else if (out.$schema === 'dingtalk-agent/opencode-workspace-run-plan@1') {
-                console.log(`DRY-RUN workspace=${out.workspace} model=${out.model} prompt=${out.promptHash}`);
+                console.log(`${mark('muted', 'DRY-RUN')} workspace=${noun(out.workspace)} model=${out.model} prompt=${out.promptHash}`);
+            }
+            else if (out.$schema === 'dingtalk-agent/multica-workspace-run-plan@1') {
+                console.log(`${mark('muted', 'DRY-RUN')} workspace=${noun(out.workspace)} agent=${out.agentId || '-'} prompt=${out.promptHash}`);
             }
             else {
-                console.log(`${out.passed ? '✅' : '❌'} workspace run ${out.runId}`);
-                if (out.execution?.answer)
+                console.log(`${mark(levelOf(Boolean(out.passed)), out.passed ? '✅' : '❌')} workspace run ${noun(out.runId)}`);
+                if ('execution' in out && out.execution?.answer)
                     console.log(out.execution.answer);
+                if ('answer' in out && out.answer)
+                    console.log(out.answer);
                 if (out.evidencePath)
-                    console.log(`evidence=${out.evidencePath}`);
+                    console.log(`evidence=${noun(out.evidencePath)}`);
             }
             if (o.execute && !out.passed)
                 process.exitCode = 2;
@@ -660,23 +934,72 @@ async function main() {
         return;
     }
     if (cmd === 'upgrade') {
+        // parseArgs strict 模式会把 --help 当成未知参数抛掉，必须先拦。
+        if (argv.includes('--help') || argv.includes('-h')) {
+            console.log(renderHelp(UPGRADE_HELP));
+            return;
+        }
         const { values: o } = parseArgs({
             args: argv.slice(1),
             options: {
                 channel: { type: 'string' }, version: { type: 'string' }, prefix: { type: 'string' },
                 'dry-run': { type: 'boolean' }, force: { type: 'boolean' }, json: { type: 'boolean' },
+                check: { type: 'boolean' }, yes: { type: 'boolean' },
             },
         });
-        const out = upgradeAgent(PACKAGE_ROOT, {
-            channel: o.channel,
-            version: o.version, prefix: o.prefix,
+        const channel = o.channel;
+        const json = Boolean(o.json);
+        if (o.check) {
+            if (o['dry-run'] || o.force || o.prefix || o.yes) {
+                fail('upgrade --check 只接受 --channel / --version / --json');
+            }
+            const checked = checkUpgrade(PACKAGE_ROOT, { channel, version: o.version });
+            if (json)
+                console.log(JSON.stringify(checked, null, 2));
+            else
+                printUpgradeCheck(checked);
+            return;
+        }
+        // --json 是机器通道：结构性绕开 tui，连回调都不构造。
+        // 非交互（管道/CI/Agent）也不提示，保持"敲下去就装"的既有行为。
+        const interactive = !json && Boolean(process.stdin.isTTY);
+        let known = null;
+        if (interactive) {
+            known = checkUpgrade(PACKAGE_ROOT, { channel, version: o.version });
+            printUpgradePreamble(known, { dryRun: Boolean(o['dry-run']), force: Boolean(o.force) });
+            const proceed = await confirm(o['dry-run'] ? '是否预览升级?' : '是否升级?', { yes: Boolean(o.yes), fallback: true });
+            if (!proceed) {
+                console.error(stderrUi().theme.dim('  已取消'));
+                return;
+            }
+        }
+        const reporter = json ? null : new StepReporter({ total: o['dry-run'] ? 3 : 7 });
+        const result = upgradeAgent(PACKAGE_ROOT, {
+            channel, version: o.version, prefix: o.prefix,
             dryRun: o['dry-run'], force: o.force,
+            // 已经解析过就别再问一次 registry；**同时把安装源钉死到精确版本**——
+            // 只冻结期望版本而仍按 `pkg@latest` 安装，会在用户思考的这几秒里
+            // 被移动的 tag 装进另一个版本，然后按旧期望校验失败，而机器已经改了。
+            env: known
+                ? {
+                    DTA_UPGRADE_TARGET_VERSION: known.targetVersion,
+                    DTA_UPGRADE_PACKAGE_SOURCE: known.pinnedSource,
+                }
+                : undefined,
+            onEvent: reporter
+                ? (event) => {
+                    if (event.phase === 'begin')
+                        reporter.begin(event.label);
+                    else
+                        reporter.end(event.ok !== false, event.meta || '');
+                }
+                : undefined,
         });
-        if (o.json)
-            console.log(JSON.stringify(out, null, 2));
+        if (json)
+            console.log(JSON.stringify(result, null, 2));
         else
-            printUpgrade(out);
-        if (!out.dryRun && !out.ready)
+            printUpgrade(result);
+        if (!result.dryRun && !result.ready)
             process.exitCode = 2;
         return;
     }
@@ -719,9 +1042,16 @@ async function main() {
         }
         if (o.json)
             console.log(JSON.stringify(out, null, 2));
-        else if ('skills' in out)
+        else if ('skills' in out) {
             for (const item of out.skills)
                 printSkillStatus(item, sub, dryRun);
+            // 静默删目录会让人以为什么都没发生；说清楚删了哪几个旧名。
+            for (const item of out.prunedLegacy || []) {
+                console.log(item.replacedBy
+                    ? `   已迁移 ${item.name} → ${item.replacedBy}`
+                    : `   已清理停用的 Skill ${item.name}`);
+            }
+        }
         else
             printSkillStatus(out, sub, dryRun);
         return;
@@ -776,7 +1106,7 @@ async function main() {
             if (o.json)
                 console.log(JSON.stringify({ ...out, endpoint, readiness, targets, doc }, null, 2));
             else {
-                console.log(`✅ 工作区已归属 ${out.definition?.label}（写入 ${out.written}）`);
+                console.log(`${mark('pass', '✅')} 工作区已归属 ${strong(out.definition?.label)}（写入 ${noun(out.written)}）`);
                 for (const install of out.skillInstalls)
                     printSkillStatus(install, 'install', false);
                 if (!out.skillInstalls.length) {
@@ -816,14 +1146,14 @@ async function main() {
         if (o.json)
             console.log(JSON.stringify(out, null, 2));
         else {
-            console.log(`✅ ${out.mode === 'workspace' ? '已装载 Workspace' : '直接会话模式'}`);
+            console.log(`${mark('pass', '✅')} ${strong(out.mode === 'workspace' ? '已装载 Workspace' : '直接会话模式')}`);
             console.log(`   scope=${out.scopeId}  initialized=${out.initialized}`);
             console.log(`   agent=${out.definition.id}  definition=${out.definition.status}`);
             if (!out.mounts.length)
-                console.log('   没有发现持久上下文；这不是错误，也不需要自动 init。');
+                console.log(muted('   没有发现持久上下文；这不是错误，也不需要自动 init。'));
             for (const mount of out.mounts)
-                console.log(`   ${mount.slot}: ${mount.path}`);
-            console.log(`   ${out.note}`);
+                console.log(`   ${mount.slot}: ${noun(mount.path)}`);
+            console.log(`   ${muted(out.note)}`);
         }
         return;
     }
@@ -877,6 +1207,7 @@ async function main() {
                 'state-dir': { type: 'string' }, profile: { type: 'string' },
                 'expected-user-id': { type: 'string' }, 'require-skill': { type: 'string' },
                 'verify-load': { type: 'boolean' }, yes: { type: 'boolean' },
+                'strict-single-run': { type: 'boolean' },
                 model: { type: 'string' }, out: { type: 'string' },
                 'load-report': { type: 'string' }, 'remote-report': { type: 'string' },
                 json: { type: 'boolean' },
@@ -893,6 +1224,7 @@ async function main() {
             bindings: loaded ? { path: loaded.path, hash: loaded.hash } : undefined,
             requiredSkills: o['require-skill']?.split(','),
             verifyLoad: o['verify-load'], yes: o.yes, model: o.model, out: o.out,
+            strictSingleRun: o['strict-single-run'],
             loadReport: o['load-report'], remoteReport: o['remote-report'],
         });
         if (o.json)
@@ -1209,9 +1541,9 @@ async function main() {
         if (o.json)
             console.log(JSON.stringify(out, null, 2));
         else if (!out.found)
-            console.log('当前 Session 尚无 Task checkpoint。');
+            console.log(muted('当前 Session 尚无 Task checkpoint。'));
         else {
-            console.log(`✅ Task ${out.checkpoint.taskId} · ${out.checkpoint.status}`);
+            console.log(`${mark('pass', '✅')} Task ${noun(out.checkpoint.taskId)} · ${out.checkpoint.status}`);
             console.log(`   revision=${out.checkpoint.revision}  hash=${out.hash}`);
             console.log(`   next=${out.checkpoint.nextAction || '-'}`);
         }
@@ -1236,7 +1568,7 @@ async function main() {
             if (o.json || !o.live)
                 console.log(JSON.stringify(out, null, 2));
             else {
-                console.log(`${out.verified ? '✅' : '⚠️'} Operational Memory · ${out.mode}`);
+                console.log(`${mark(out.verified ? 'pass' : 'warn', out.verified ? '✅' : '⚠️')} ${strong('Operational Memory')} · ${out.mode}`);
                 console.log(`   record=${out.recordId || '-'}  verification=${out.verification}`);
             }
             if (out.mode === 'uncertain')
@@ -1290,18 +1622,78 @@ async function main() {
             if (o.json)
                 console.log(JSON.stringify(out, null, 2));
             else if (action === 'publish') {
-                console.log(`${out.verified ? '✅' : out.mode === 'dry-run' ? '🔎' : '⚠️'} Candidate ${o.id}`);
+                console.log(`${mark(out.verified ? 'pass' : out.mode === 'dry-run' ? 'muted' : 'warn', out.verified ? '✅' : out.mode === 'dry-run' ? '🔎' : '⚠️')} Candidate ${noun(o.id)}`);
                 console.log(`   mode=${out.mode} targetHash=${out.currentTargetHash}`);
             }
             else {
-                console.log(`✅ Candidate ${out.candidate.id} · ${out.candidate.status}`);
-                console.log(`   revision=${out.candidate.revision}  path=${out.path}`);
+                console.log(`${mark('pass', '✅')} Candidate ${noun(out.candidate.id)} · ${out.candidate.status}`);
+                console.log(`   revision=${out.candidate.revision}  path=${noun(out.path)}`);
             }
             if (action === 'publish' && out.mode === 'uncertain')
                 process.exitCode = 2;
             return;
         }
-        fail('memory 当前支持: operational upsert / candidate propose|show|review|publish');
+        if (sub === 'noop') {
+            const { values: o } = parseArgs({
+                args: argv.slice(3),
+                options: {
+                    input: { type: 'string' }, scope: { type: 'string' }, step: { type: 'string' },
+                    occurrence: { type: 'string' }, 'state-dir': { type: 'string' },
+                    session: { type: 'string' }, json: { type: 'boolean' },
+                },
+            });
+            const noopCfg = cfgmod.load(ROOT);
+            const options = {
+                stateDir: o['state-dir'], runPath: process.env.DTA_RUN,
+                sessionPath: o.session || process.env.DTA_SESSION,
+                sessionRoot: noopCfg?.runtime?.sessionRoot,
+            };
+            if (action === 'record') {
+                if (!o.input)
+                    fail('memory noop record 需要 --input（memory-noop-claim@1 JSON）');
+                const out = recordMemoryNoop(ROOT, readEventFile(o.input), options);
+                if (o.json)
+                    console.log(JSON.stringify(out, null, 2));
+                else {
+                    console.log(`${mark('pass', '✅')} No-op Receipt ${noun(out.receipt.id)}${out.duplicate ? ' · duplicate（幂等命中既有痕迹）' : ''}`);
+                    console.log(`   step=${out.receipt.step}  occurrence=${out.receipt.occurrence}  reason=${out.receipt.reason}`);
+                }
+            }
+            else if (action === 'list') {
+                const out = listMemoryNoops(ROOT, { scopeId: o.scope, step: o.step, occurrence: o.occurrence }, options);
+                if (o.json)
+                    console.log(JSON.stringify(out, null, 2));
+                else {
+                    console.log(`${mark('pass', '✅')} No-op Receipts · ${out.count} 条`);
+                    for (const receipt of out.receipts) {
+                        console.log(`   ${receipt.id}  ${receipt.step}  ${receipt.occurrence}  ${receipt.reason}`);
+                    }
+                }
+            }
+            else if (action === 'trace') {
+                if (!o.scope || !o.occurrence)
+                    fail('memory noop trace 需要 --scope 和 --occurrence');
+                const out = traceMemoryNoop(ROOT, { scopeId: o.scope, occurrence: o.occurrence, step: o.step }, options);
+                if (o.json)
+                    console.log(JSON.stringify(out, null, 2));
+                else {
+                    const ran = out.verdict === 'ran-empty';
+                    console.log(`${mark(ran ? 'pass' : 'warn', ran ? '✅' : '⚠️')} ${strong(out.verdict)} · step=${out.step} occurrence=${noun(out.occurrence)}`);
+                    if (ran)
+                        console.log(`   receipt=${out.receiptId}`);
+                    else
+                        console.log('   没有任何痕迹——「判过无内容」会留 no-op Receipt，这里连它都没有');
+                }
+                // 判存步骤没跑就是没跑：给脚本一个可断言的非零退出码（区别于 uncertain 的 2）。
+                if (out.verdict === 'no-trace')
+                    process.exitCode = 3;
+            }
+            else {
+                fail('memory noop 的子命令: record / list / trace');
+            }
+            return;
+        }
+        fail('memory 当前支持: operational upsert / candidate propose|show|review|publish / noop record|list|trace');
     }
     // ── act：元语化动作；目标/身份/预算/状态转移都由 Run 固定 ──
     if (cmd === 'act') {
@@ -1326,10 +1718,10 @@ async function main() {
         if (o.json || o['dry-run'])
             console.log(JSON.stringify(out, null, 2));
         else {
-            console.log(`${out.verified ? '✅' : '⚠️'} ${out.kind} · ${out.outcome} · ${out.toState}`);
-            console.log(`   action=${out.actionId}  run=${out.runId}`);
+            console.log(`${mark(out.verified ? 'pass' : 'warn', out.verified ? '✅' : '⚠️')} ${strong(out.kind)} · ${out.outcome} · ${out.toState}`);
+            console.log(`   action=${noun(out.actionId)}  run=${noun(out.runId)}`);
             if (!out.verified)
-                console.log(`   ${out.verification}`);
+                console.log(`   ${muted(out.verification)}`);
         }
         if (out.outcome === 'uncertain')
             process.exitCode = 2;
@@ -1401,11 +1793,41 @@ function editDistance(a, b) {
     }
     return row[b.length];
 }
+/** 按语义给状态标记上色；字形原样返回，不做任何替换。 */
+function mark(level, text) {
+    const { theme } = stdoutUi();
+    return level === 'pass' ? theme.success(text)
+        : level === 'warn' ? theme.warn(text)
+            : level === 'fail' ? theme.danger(text)
+                : theme.dim(text);
+}
+/** 可复制的名词：路径、版本号、ID、命令。 */
+function noun(text) {
+    return stdoutUi().theme.noun(text);
+}
+/** 次要信息：补充说明、括注、下一步提示。 */
+function muted(text) {
+    return stdoutUi().theme.dim(text);
+}
+/** 标题行 / key=value 的结构性强调。 */
+function strong(text) {
+    return stdoutUi().theme.bold(text);
+}
+/** ready 布尔 → 语义级别，printX 里到处都是这个三态。 */
+function levelOf(state) {
+    if (state === true)
+        return 'pass';
+    if (state === false)
+        return 'fail';
+    return state;
+}
 function printDispatch(out, json = false) {
     if (json)
         return console.log(JSON.stringify(out, null, 2));
-    const mark = out.duplicate ? (out.launch ? '🔁 REDELIVER' : '↩️ DUPLICATE') : '✅ READY';
-    console.log(`${mark} ${out.runId}`);
+    const state = out.duplicate
+        ? mark(out.launch ? 'warn' : 'muted', out.launch ? '🔁 REDELIVER' : '↩️ DUPLICATE')
+        : mark('pass', '✅ READY');
+    console.log(`${state} ${noun(out.runId)}`);
     console.log(`   Field=${out.fieldId}  Session=${out.sessionId}  Event=${out.eventKind}`);
     console.log(`   cwd=${out.cwd}`);
     console.log(`   entrypoint=${out.entrypoint}  queue=${out.queue.key} (max=${out.queue.maxConcurrency})`);
@@ -1415,7 +1837,7 @@ function printDispatch(out, json = false) {
 }
 function printLab(out) {
     const passed = out.ready ?? out.passed ?? out.assertions?.passed;
-    console.log(`${passed === false ? '❌' : '✅'} ${out.$schema || 'dingtalk-agent/lab'}`);
+    console.log(`${mark(levelOf(passed !== false), passed === false ? '❌' : '✅')} ${out.$schema || 'dingtalk-agent/lab'}`);
     if (out.mode)
         console.log(`   mode=${out.mode}`);
     if (out.marker)
@@ -1424,17 +1846,33 @@ function printLab(out) {
         console.log(`   evidence=${out.evidencePath}`);
     if (Array.isArray(out.checks)) {
         for (const check of out.checks) {
-            console.log(`   ${check.passed ? 'PASS' : 'FAIL'} ${check.id}: ${check.detail}`);
+            console.log(`   ${mark(levelOf(Boolean(check.passed)), check.passed ? 'PASS' : 'FAIL')} ${check.id}: ${check.detail}`);
         }
     }
 }
 function printAgentAudit(out) {
-    console.log(`dingtalk-agent agent audit · ${out.ready ? 'READY' : 'PARTIAL'}`);
+    console.log(`${strong('dingtalk-agent agent audit')} · ${mark(out.ready ? 'pass' : 'warn', out.ready ? 'READY' : 'PARTIAL')}`);
     console.log(`   definition=${out.definition.hash}  storage=${out.storageMode}`);
     console.log(`   dingtalkSideEffect=${out.dingtalkSideEffect}  sideEffect=${out.sideEffect}`);
     for (const check of out.checks) {
-        const mark = check.level === 'pass' ? 'PASS' : check.level === 'warn' ? 'WARN' : 'FAIL';
-        console.log(`   ${mark} ${check.id}: ${check.summary}`);
+        const word = check.level === 'pass' ? 'PASS' : check.level === 'warn' ? 'WARN' : 'FAIL';
+        console.log(`   ${mark(levelOf(check.level), word)} ${check.id}: ${check.summary}`);
+        const evidence = check.evidence;
+        // 失败可归因：把 failureSummary 的前几条与证据路径直接摆到失败行下面，
+        // 不再让人去 JSON 深处找「为什么」。flaky 通过（第二次 attempt 才过）也如实标注。
+        if (check.level !== 'pass' && check.blocking && Array.isArray(evidence?.failureSummary)) {
+            for (const line of evidence.failureSummary.slice(0, 3)) {
+                console.log(`      · ${line}`);
+            }
+            if (typeof evidence.report === 'string' && evidence.report) {
+                console.log(`      evidence: ${evidence.report}`);
+            }
+        }
+        const verification = evidence?.verification;
+        if (verification && Array.isArray(verification.attempts) && verification.attempts.length > 1) {
+            console.log(`      attempts: ${verification.attempts.length}` +
+                `（passedOnAttempt=${verification.passedOnAttempt || '-'}）`);
+        }
     }
     if (out.repairs.length) {
         console.log('\n修复建议:');
@@ -1447,7 +1885,7 @@ function printAgentAudit(out) {
 }
 function printAgentEnhance(out) {
     if (out.$schema === 'dingtalk-agent/agent-enhancement-plan@1') {
-        console.log(`dingtalk-agent agent enhance · ${out.ready ? 'READY PLAN' : 'BLOCKED'}`);
+        console.log(`${strong('dingtalk-agent agent enhance')} · ${mark(out.ready ? 'pass' : 'fail', out.ready ? 'READY PLAN' : 'BLOCKED')}`);
         console.log(`   planId=${out.planId}  project=${out.projectName}`);
         console.log(`   sideEffect=${out.sideEffect}  dingtalkSideEffect=${out.dingtalkSideEffect}`);
         for (const operation of out.operations) {
@@ -1457,12 +1895,12 @@ function printAgentEnhance(out) {
             console.log(`   REVIEW ${out.semanticReview.files.join(', ')}: ${out.semanticReview.why}`);
         }
         for (const blocker of out.blockers)
-            console.log(`   BLOCK ${blocker}`);
+            console.log(`   ${mark('fail', 'BLOCK')} ${blocker}`);
         if (out.ready)
             console.log(`\nApply:\n  ${out.apply.command}`);
         return;
     }
-    console.log('dingtalk-agent agent enhance · APPLIED');
+    console.log(`${strong('dingtalk-agent agent enhance')} · ${mark('pass', 'APPLIED')}`);
     console.log(`   operation=${out.operationId}  planId=${out.planId}`);
     console.log(`   changes=${out.changes.length}  idempotent=${out.idempotent}`);
     if (out.backupRoot)
@@ -1470,8 +1908,8 @@ function printAgentEnhance(out) {
     console.log(`   audit=${out.audit.status}  missing=${out.audit.missing.join(', ') || '-'}`);
 }
 function printAgentPlatform(platform) {
-    console.log(`${platform.status === 'supported' ? '✅' : '⏳'} ${platform.name} · ${platform.label} · ${platformStatusLabel(platform.status)}`);
-    console.log(`   ${platform.description}`);
+    console.log(`${mark(platform.status === 'supported' ? 'pass' : 'muted', platform.status === 'supported' ? '✅' : '⏳')} ${strong(platform.name)} · ${platform.label} · ${platformStatusLabel(platform.status)}`);
+    console.log(`   ${muted(platform.description)}`);
     for (const skill of platform.skills)
         console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
     if (platform.commands.length)
@@ -1479,12 +1917,12 @@ function printAgentPlatform(platform) {
 }
 function printAgentPlatformResolution(out) {
     if (!out.platform) {
-        console.log('⚠️ 当前工作区未声明 managed agent platform');
+        console.log(mark('warn', '⚠️ 当前工作区未声明 managed agent platform'));
         console.log('   运行 `dta agent-platform use multica-dingtalk`，或设置 DTA_AGENT_PLATFORM 环境变量。');
         return;
     }
     const known = out.definition;
-    console.log(`${known ? '✅' : '❌'} 当前 platform: ${out.platform}${known ? ` · ${known.label} · ${platformStatusLabel(known.status)}` : '（未知）'}`);
+    console.log(`${mark(levelOf(Boolean(known)), known ? '✅' : '❌')} 当前 platform: ${strong(out.platform)}${known ? ` · ${known.label} · ${platformStatusLabel(known.status)}` : '（未知）'}`);
     console.log(`   来源: ${out.source}${out.file ? ` · ${out.file}` : ''}`);
     for (const skill of known?.skills || [])
         console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
@@ -1492,8 +1930,9 @@ function printAgentPlatformResolution(out) {
 // 披露：dta 层平台命令关联到平台内确切的 Skill（诊断信息走 stderr，不污染 --json stdout）。
 function disclosePlatformSkill(resolution, role) {
     const skillName = resolution.definition ? platformSkillForRole(resolution.definition.name, role) : null;
-    if (skillName)
-        console.error(`提示: 平台 ${resolution.definition.name} 的该命令方法学由 Skill ${skillName} 承载`);
+    if (skillName) {
+        console.error(stderrUi().theme.dim(`提示: 平台 ${resolution.definition.name} 的该命令方法学由 Skill ${skillName} 承载`));
+    }
 }
 function printEndpoint(endpoint) {
     if (!endpoint)
@@ -1507,9 +1946,9 @@ function printEndpoint(endpoint) {
         console.log(`   Endpoint: 未解析——设 ${endpoint.envVar} 或登录 multica 后生效`);
         return;
     }
-    const mark = endpoint.confirmed ? '✅' : '⚠️';
+    const glyph = mark(endpoint.confirmed ? 'pass' : 'warn', endpoint.confirmed ? '✅' : '⚠️');
     const note = endpoint.confirmed ? '' : '（建议/未确认，deploy 前需显式确认是预发还是生产）';
-    console.log(`   ${mark} Endpoint: ${endpoint.endpoint} · 来源: ${endpoint.source}${note}`);
+    console.log(`   ${glyph} Endpoint: ${noun(endpoint.endpoint)} · 来源: ${endpoint.source}${muted(note)}`);
     console.log(`   （切换：设 ${endpoint.envVar}=<url>、写 dingtalk-agent.json#multicaEndpoint、或登录对应 profile；无需改代码）`);
 }
 function printPlatformDoc(platformName) {
@@ -1517,27 +1956,27 @@ function printPlatformDoc(platformName) {
         return;
     const path = platformDocPath(PACKAGE_ROOT, platformName);
     if (path)
-        console.log(`   平台说明: ${path}\n   （切换到该平台后请阅读，了解各技能用途与交付链）`);
+        console.log(`   平台说明: ${noun(path)}\n${muted('   （切换到该平台后请阅读，了解各技能用途与交付链）')}`);
 }
 function printMulticaTargets(targets) {
     if (!targets.length)
         return;
-    console.log('   本机 Multica 登录目标（发布前必须与用户确认 endpoint 与 workspace）:');
+    console.log(strong('   本机 Multica 登录目标（发布前必须与用户确认 endpoint 与 workspace）:'));
     for (const target of targets) {
         console.log(`     - profile=${target.profile} · ${target.serverUrl}${target.workspaceId ? ` · workspace=${target.workspaceId}` : ''}`);
     }
 }
 function printAgentPlatformReadiness(checks) {
     for (const check of checks) {
-        console.log(`   ${check.ok ? '✅' : '⚠️'} ${check.summary}`);
+        console.log(`   ${mark(check.ok ? 'pass' : 'warn', check.ok ? '✅' : '⚠️')} ${check.summary}`);
         if (check.hint)
-            console.log(`      ${check.hint}`);
+            console.log(`      ${muted(check.hint)}`);
     }
 }
 function printSkillStatus(out, action, dryRun) {
-    const prefix = dryRun ? 'DRY-RUN' : '✅';
+    const prefix = dryRun ? mark('muted', 'DRY-RUN') : mark('pass', '✅');
     const verb = action === 'status' ? '全局 Skill 状态' : `skill ${action}`;
-    console.log(`${prefix} ${verb}: ${out.name}`);
+    console.log(`${prefix} ${verb}: ${strong(out.name)}`);
     console.log(`   manager=${out.manager}  bundled=${out.bundled.skillVersion || '-'}`);
     console.log(`   canonical=${out.canonical.path}`);
     console.log(`   installed=${out.canonical.exists}  ` +
@@ -1548,71 +1987,110 @@ function printSkillStatus(out, action, dryRun) {
             ` → ${out.operation.after.installedVersion}(${out.operation.after.state})`);
     }
     if (out.operation)
-        console.log(`   delegated: ${out.operation.command}`);
+        console.log(`   delegated: ${noun(out.operation.command)}`);
     for (const client of out.clients) {
-        console.log(`   ${client.label}=${client.state} (${client.discovery}: ${client.path})`);
+        console.log(`   ${client.label}=${mark(client.state === 'ok' ? 'pass' : 'warn', client.state)} (${client.discovery}: ${noun(client.path)})`);
     }
     if (action === 'install' && !dryRun) {
-        console.log('   新 Agent 会话将自动发现；当前会话未发现时请重启 Claude Code/Codex。');
+        console.log(muted('   新 Agent 会话将自动发现；当前会话未发现时请重启 Claude Code/Codex。'));
     }
 }
+/**
+ * doctor 的版面。改造前的问题不是"不够花哨"，是三条实打实的：
+ *   1. 同一事实说两遍——⚠️ 摘要和它的 detail 重复平台 Skill 漂移；三个客户端
+ *      的 Skill 可见性在 check 区和「本机 Coding Agent」区各说一次。
+ *   2. 一行塞太多——detail 用 ` | ` 把四条 canonical 路径和平台 Skill 状态拼在
+ *      一起，200+ 字符，终端里必然折行。
+ *   3. 分隔符混用 `·` `;` `|` 三种，没有一列是对齐的。
+ * 所以这里按「一行一件事、明细缩进、列对齐」重排，并把客户端合并成一节。
+ */
 function printDoctor(out) {
-    console.log(`dingtalk-agent doctor · ${out.ready ? 'READY' : 'NOT READY'}`);
-    for (const check of out.checks) {
-        const mark = check.level === 'pass' ? '✅' : check.level === 'warn' ? '⚠️' : '❌';
-        console.log(`${mark} ${check.summary}`);
-        if (check.detail)
-            console.log(`   ${check.detail}`);
-        if (check.fix)
-            console.log(`   修复: ${check.fix}`);
-    }
-    if (out.hosts.length) {
-        // Host 面回答"本地能在哪跑"，不改变上面的 ready 结论。
-        console.log('\n本机 Coding Agent:');
-        const width = Math.max(...out.hosts.map((host) => displayWidth(host.label)));
-        for (const host of out.hosts) {
-            const label = host.label + ' '.repeat(width - displayWidth(host.label));
-            const where = host.cli.found
-                ? [host.cli.path, host.cli.version].filter(Boolean).join('  ')
-                : `未找到 ${host.cli.command}`;
-            console.log(`  ${host.cli.found ? '✅' : '❌'} ${label}  ${where}`);
-            console.log(`     Skill 可见性: ${host.skillExposure.exists ? '已暴露' : '未暴露'} · ${host.skillExposureRoot}`);
-        }
-    }
-    if (out.nextSteps.length) {
-        console.log('\n下一步:');
-        for (const step of out.nextSteps)
-            console.log(`  ${step}`);
+    const { theme } = stdoutUi();
+    // 字形沿用全 CLI 既定的 ✅/⚠️/❌（bin 里各出现 24/11/5 次）。上一版换成
+    // ✔/!/✗ 让 doctor 成了唯一的异类，也违反 AGENTS.md「stdout 是稳定的人/
+    // 机器接口」——颜色可以加，承载语义的字形不能动。三者都是 2 列宽，对齐不受影响。
+    const glyph = (level) => level === 'pass' ? mark('pass', '✅')
+        : level === 'warn' ? mark('warn', '⚠️') : mark('fail', '❌');
+    const clientIds = new Set(['claude-code', 'codex', 'opencode']);
+    const envChecks = out.checks.filter((check) => !clientIds.has(check.id));
+    const clientChecks = out.checks.filter((check) => clientIds.has(check.id));
+    console.log(`${strong('dingtalk-agent doctor')} · ${out.ready ? mark('pass', 'READY') : mark('fail', 'NOT READY')}`);
+    console.log('');
+    // 左列按显示宽度对齐——中文标签用 String.length 补齐必然错位
+    const labelWidth = Math.max(...envChecks.map((check) => displayWidth(CHECK_LABELS[check.id])));
+    for (const check of envChecks) {
+        const label = padRight(CHECK_LABELS[check.id], labelWidth);
+        console.log(`  ${glyph(check.level)} ${strong(label)}  ${check.value || check.summary}`);
+        const items = check.items || [];
+        const itemWidth = items.length ? Math.max(...items.map((i) => displayWidth(i.label))) : 0;
+        const valueWidth = items.length ? Math.max(...items.map((i) => displayWidth(i.value || ''))) : 0;
+        for (const item of items) {
+            console.log(`      ${noun(padRight(item.label, itemWidth))}  ${padRight(item.value || '', valueWidth)}${item.note ? `  ${muted(item.note)}` : ''}`);
+        }
+        if (check.level !== 'pass' && check.fix) {
+            // 一条命令一行。挤在同一行里用「与」串起来的命令没法直接复制。
+            const commands = plain(check.fix).replace(/^运行\s*/, '').split(/\s*与\s*/);
+            commands.forEach((command, index) => {
+                console.log(`      ${muted(index === 0 ? '修复' : '    ')}  ${noun(command)}`);
+            });
+        }
+    }
+    if (clientChecks.length) {
+        console.log('');
+        console.log(`  ${strong('Coding Agent')}`);
+        const nameWidth = Math.max(...clientChecks.map((c) => displayWidth(CHECK_LABELS[c.id])));
+        const hostOf = (id) => out.hosts.find((host) => host.name === id);
+        // 版本列去掉冗余括注与前缀：claude 报 "2.1.218 (Claude Code)"、codex 报 "codex-cli 0.144.6"
+        const versions = clientChecks.map((c) => (hostOf(c.id)?.cli.version || '')
+            .replace(/\s*\(.*\)\s*$/, '').replace(/^\S+-cli\s+/, ''));
+        const versionWidth = Math.max(...versions.map(displayWidth));
+        clientChecks.forEach((check, index) => {
+            const host = hostOf(check.id);
+            const name = padRight(CHECK_LABELS[check.id], nameWidth);
+            const version = padRight(versions[index], versionWidth);
+            const where = host?.cli.found ? tilde(host.skillExposureRoot) : `未安装 ${host?.cli.command || ''}`;
+            console.log(`  ${glyph(check.level)} ${strong(name)}  ${muted(version)}  ${check.value || check.summary}  ${noun(where)}`);
+        });
     }
+    // 「下一步」此前逐字重复上面已经打过的修复命令。只留没展示过的。
+    const shown = new Set(out.checks.filter((c) => c.level !== 'pass' && c.fix).map((c) => c.fix));
+    const remaining = out.nextSteps.filter((step) => !shown.has(step));
+    if (remaining.length) {
+        console.log('');
+        for (const step of remaining)
+            console.log(`  ${strong('下一步')}  ${noun(plain(step))}`);
+    }
+}
+/** 反引号在终端里不是强调，是噪声；着色已经承担了同一职责。 */
+function plain(text) {
+    return text.replace(/`/g, '');
 }
-/** 全角字符按两列计宽，避免中英混排的 Host 列表错位。 */
-function displayWidth(text) {
-    let width = 0;
-    for (const char of text)
-        width += /[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹯＀-｠￠-￦]/.test(char) ? 2 : 1;
-    return width;
+/** 家目录缩成 ~/，省掉对读者零信息量的前缀。 */
+function tilde(path) {
+    const home = process.env.HOME || '';
+    return home && path.startsWith(home) ? `~${path.slice(home.length)}` : path;
 }
 function printProjectInfo(out) {
-    console.log(`dingtalk-agent Project · ${out.project.name}`);
+    console.log(`${strong('dingtalk-agent Project')} · ${noun(out.project.name)}`);
     console.log(`   root=${out.root}`);
     console.log(`   source=${out.source}  manifest=${out.manifest || '(synthetic legacy)'}`);
     console.log(`   hash=${out.manifestHash}  dta=${out.project.dtaVersion}`);
     console.log(`   current=${out.currentWorkspace || '(not selected)'}`);
     for (const workspace of out.workspaces) {
-        console.log(`   ${workspace.current ? '*' : '-'} ${workspace.name} · ${workspace.provider.kind} · ${workspace.status}`);
+        console.log(`   ${workspace.current ? strong('*') : muted('-')} ${workspace.name} · ${workspace.provider.kind} · ${workspace.status}`);
     }
 }
 function printWorkspaceList(out) {
-    console.log(`dingtalk-agent workspaces · ${out.project.name}`);
+    console.log(`${strong('dingtalk-agent workspaces')} · ${noun(out.project.name)}`);
     if (!out.workspaces.length)
-        console.log('   尚未声明 Development Workspace。');
+        console.log(muted('   尚未声明 Development Workspace。'));
     for (const workspace of out.workspaces) {
-        console.log(`   ${workspace.current ? '*' : '-'} ${workspace.name}  provider=${workspace.provider.kind}  ` +
+        console.log(`   ${workspace.current ? strong('*') : muted('-')} ${workspace.name}  provider=${workspace.provider.kind}  ` +
             `stage=${workspace.stage}  status=${workspace.status}`);
     }
 }
 function printDevelopmentWorkspace(out) {
-    console.log(`dingtalk-agent workspace · ${out.name}`);
+    console.log(`${strong('dingtalk-agent workspace')} · ${noun(out.name)}`);
     console.log(`   provider=${out.provider.kind}  stage=${out.stage}  status=${out.status}`);
     console.log(`   desired=${out.desiredHash}  observed=${out.observedHash || '-'}`);
     console.log(`   current=${out.current}  legacy=${out.legacy}`);
@@ -1622,19 +2100,22 @@ function printDevelopmentWorkspace(out) {
         console.log(`   source=${source}`);
 }
 function printDevelopmentWorkspaceDoctor(out) {
-    console.log(`dingtalk-agent workspace doctor · ${out.workspace} · ${out.ready ? 'READY' : 'PARTIAL'}`);
+    console.log(`${strong('dingtalk-agent workspace doctor')} · ${noun(out.workspace)} · ${mark(out.ready ? 'pass' : 'warn', out.ready ? 'READY' : 'PARTIAL')}`);
     console.log(`   provider=${out.provider}  status=${out.status}`);
     console.log(`   sideEffect=${out.sideEffect}  dingtalkSideEffect=${out.dingtalkSideEffect}`);
     for (const check of out.checks) {
-        const mark = check.level === 'pass' ? 'PASS' : check.level === 'warn' ? 'WARN' : 'FAIL';
-        console.log(`   ${mark} ${check.id}: ${check.summary}`);
+        const word = check.level === 'pass' ? 'PASS' : check.level === 'warn' ? 'WARN' : 'FAIL';
+        console.log(`   ${mark(levelOf(check.level), word)} ${check.id}: ${check.summary}`);
         if (check.fix && check.level !== 'pass')
-            console.log(`      fix: ${check.fix}`);
+            console.log(`      fix: ${noun(check.fix)}`);
     }
 }
 function printOpenCodeWorkspaceOperation(out) {
     const applied = out.$schema === 'dingtalk-agent/opencode-workspace-apply@1';
-    console.log(`${applied ? out.applied ? '✅' : '↩️' : 'DRY-RUN'} OpenCode Workspace ${out.workspace}`);
+    const glyph = applied
+        ? mark(out.applied ? 'pass' : 'muted', out.applied ? '✅' : '↩️')
+        : mark('muted', 'DRY-RUN');
+    console.log(`${glyph} OpenCode Workspace ${noun(out.workspace)}`);
     console.log(`   action=${out.action}  model=${out.model}`);
     console.log(`   desired=${out.desiredHash}  observed=${out.observedHash || '-'}`);
     console.log(`   managed=${out.managedPath}`);
@@ -1644,7 +2125,7 @@ function printOpenCodeWorkspaceOperation(out) {
 function printMulticaWorkspaceOperation(out) {
     const passed = out.passed ?? out.readyForApply ?? out.blocking?.length === 0;
     const mode = out.remoteRead ? 'REMOTE-READ' : 'DRY-RUN';
-    console.log(`${passed ? '✅' : '⚠️'} ${mode} Multica Workspace ${out.workspace}`);
+    console.log(`${mark(passed ? 'pass' : 'warn', passed ? '✅' : '⚠️')} ${mode} Multica Workspace ${noun(out.workspace)}`);
     console.log(`   schema=${out.$schema}  profile=${out.profile || '-'}`);
     if (out.planId)
         console.log(`   plan=${out.planId}`);
@@ -1660,12 +2141,41 @@ function printMulticaWorkspaceOperation(out) {
         console.log(`   blocking=${out.blocking.join(', ')}`);
     if (out.failures?.length)
         console.log(`   failures=${out.failures.join(', ')}`);
+    printFailureDetails(out.failureDetails, '   ');
+    // 同名候选就在 JSON 里，人类输出却只给一个枚举串——把出路直接摆出来（B10/C3）。
+    if (out.failures?.includes('agent.unbound-name-candidates') &&
+        Array.isArray(out.resources?.agentCandidates) && out.resources.agentCandidates.length) {
+        for (const candidate of out.resources.agentCandidates) {
+            console.log(`     candidate: ${candidate.id}  ${candidate.name}${candidate.archived ? '  (archived)' : ''}`);
+        }
+        console.log('     fix: 核对后在 manifest 声明 provider.agentIdFrom 指向正确 ID' +
+            '（或依赖首次 deploy 写入的 state.binding.agentId）；不要按名字猜绑定');
+    }
     if (out.evidencePath)
         console.log(`   evidence=${out.evidencePath}`);
     console.log(`   remoteWrite=${out.remoteWrite}  dingtalkSideEffect=${out.dingtalkSideEffect}`);
 }
+/** 期望 vs 实际 + 下一步：把 fail-closed 从「正确但沉默」升级为「正确且能自救」。 */
+function printFailureDetails(details, indent) {
+    if (!Array.isArray(details))
+        return;
+    for (const detail of details) {
+        if (!detail || typeof detail !== 'object')
+            continue;
+        const item = detail;
+        const format = (value) => Array.isArray(value) ? value.join(', ') : typeof value === 'string' ? value : '';
+        const expected = format(item.expected);
+        const actual = format(item.actual);
+        const parts = [
+            expected ? `expected=${expected}` : '', actual ? `actual=${actual}` : '',
+        ].filter(Boolean).join('  ');
+        console.log(`${indent}- ${item.code}${parts ? `: ${parts}` : ''}`);
+        if (typeof item.hint === 'string' && item.hint)
+            console.log(`${indent}  → ${item.hint}`);
+    }
+}
 function printMulticaDeployment(out) {
-    console.log(`Multica deploy: ${out.workspace || '<unknown>'}`);
+    console.log(`${strong('Multica deploy')}: ${noun(out.workspace || '<unknown>')}`);
     if (out.planId)
         console.log(`  plan: ${out.planId}`);
     if (out.operationId)
@@ -1678,17 +2188,42 @@ function printMulticaDeployment(out) {
         console.log(`  status: ${out.status}`);
     if (typeof out.providerReady === 'boolean')
         console.log(`  provider ready: ${out.providerReady}`);
+    // 首次创建 Agent 后把「二次部署怎么绑定」讲在当下（B10）：正常路径 ID 已存 state
+    // 自动复用；换机器/state 丢失才需要显式声明。
+    if (out.action === 'apply' && out.agent?.action === 'create' && out.agent?.id) {
+        console.log(`  agent created: ${out.agent.id}`);
+        console.log(`    ID 已写入 .dingtalk-agent/state/workspaces/${out.workspace}.json，二次部署与 schedule 自动复用`);
+        console.log('    换机器或 state 丢失时：在 manifest 声明 provider.agentIdFrom=env:<VAR> 并 export 该 ID');
+    }
+    if (out.rebind?.fromRuntimeId) {
+        console.log(`  rebind: ${out.rebind.fromRuntimeId} -> ${out.rebind.toRuntimeId}`);
+    }
+    const smoke = out.smoke || out.receipt?.smoke;
+    if (smoke && smoke.status && smoke.status !== 'not-run') {
+        const classified = smoke.classification ? ` (${smoke.classification})` : '';
+        console.log(`  smoke: ${smoke.status}${classified}  task=${smoke.taskId || '-'}${smoke.taskStatus ? ` (${smoke.taskStatus})` : ''}`);
+        console.log(`    loaded: ${smoke.loadedSkills?.length ?? 0}/${smoke.requiredSkills?.length ?? 0}  response: ${smoke.responsePassed === true}`);
+        if (Array.isArray(smoke.unrecognizedTools) && smoke.unrecognizedTools.length) {
+            console.log(`    unrecognized tools: ${smoke.unrecognizedTools.join(', ')}`);
+        }
+    }
     if (Array.isArray(out.blocking) && out.blocking.length) {
         console.log(`  blocking: ${out.blocking.join(', ')}`);
     }
     if (Array.isArray(out.failures) && out.failures.length) {
         console.log(`  failures: ${out.failures.join(', ')}`);
     }
+    printFailureDetails(out.failureDetails || out.receipt?.failureDetails, '  ');
+    if (Array.isArray(smoke?.failureDetails))
+        printFailureDetails(smoke.failureDetails, '  ');
+    if (out.receiptFrozen && out.nextAction) {
+        console.log(muted(`  smoke 字段为 apply 时刻的冻结值；刷新: ${out.nextAction}`));
+    }
     if (out.triggerWrite === false)
         console.log('  triggers: unchanged');
 }
 function printPromotion(out) {
-    console.log(`Promotion: ${out.promotionId || out.candidateId || out.candidate?.candidateId || '<none>'}`);
+    console.log(`${strong('Promotion')}: ${noun(out.promotionId || out.candidateId || out.candidate?.candidateId || '<none>')}`);
     if (out.planId)
         console.log(`  plan: ${out.planId}`);
     if (out.routeId)
@@ -1739,33 +2274,84 @@ function rejectWorkspaceOptions(values, allowed, command) {
         fail(`${command} 不接受参数: ${extras.join(', ')}`);
 }
 function printSetup(out) {
-    console.log(`${out.dryRun ? 'DRY-RUN' : '✅'} dingtalk-agent setup`);
-    console.log(`   CLI: ${out.cli.executable}`);
-    console.log(`   短命令: ${out.cli.alias}`);
-    console.log(`   Skill: ${out.skill.canonical.path}`);
+    console.log(`${out.dryRun ? mark('muted', 'DRY-RUN') : mark('pass', '✅')} ${strong('dingtalk-agent setup')}`);
+    console.log(`   CLI: ${noun(out.cli.executable)}`);
+    console.log(`   短命令: ${noun(out.cli.alias)}`);
+    console.log(`   Skill: ${noun(out.skill.canonical.path)}`);
     if (!out.shell.pathReady) {
-        console.log(`   当前 shell 尚未加载 PATH；本次终端执行: ${out.shell.activateCommand}`);
+        console.log(`   当前 shell 尚未加载 PATH；本次终端执行: ${noun(out.shell.activateCommand)}`);
         if (out.shell.rcFile)
-            console.log(`   新终端会从 ${out.shell.rcFile} 自动加载`);
+            console.log(muted(`   新终端会从 ${out.shell.rcFile} 自动加载`));
     }
     printDoctor(out.doctor);
-    console.log(`\n开始使用: ${out.nextCommand}`);
+    console.log(`\n开始使用: ${noun(out.nextCommand)}`);
+}
+/**
+ * 确认之前的抬头：告诉人「将要去哪」，好让 [y/N] 是个有信息的决定。
+ *
+ * 三态必须分开说。只判 outdated 会让 `--version <旧版> --force` 显示成
+ * "已是最新版本"，用户确认之后却真的降级——在唯一的不可逆动作前给了反的信息。
+ */
+function printUpgradePreamble(checked, options) {
+    const { theme } = stderrUi();
+    const arrow = (from, to, paint) => `${theme.dim(from)} ${theme.bold('→')} ${paint(to)}`;
+    if (checked.relation === 'same' && !options.force && !options.dryRun) {
+        console.error(`  ${theme.success('✔')} 已是最新版本 ${theme.bold(checked.currentVersion)}`);
+        console.error(theme.dim('  仍会重新校验环境；只想查版本可用 dta upgrade --check'));
+        return;
+    }
+    const label = checked.relation === 'upgrade' ? '新版本可用'
+        : checked.relation === 'downgrade' ? '降级' : '重装';
+    const value = checked.relation === 'upgrade'
+        ? arrow(checked.currentVersion, checked.targetVersion, theme.success)
+        : checked.relation === 'downgrade'
+            ? `${arrow(checked.currentVersion, checked.targetVersion, theme.warn)}${theme.warn('（降级）')}`
+            : `${theme.bold(checked.targetVersion)}${theme.dim('（与当前版本相同，将强制重装）')}`;
+    for (const line of renderPairs([
+        [label, value],
+        ['通道', `${checked.channel}  ${theme.dim(checked.pinnedSource)}`],
+    ]))
+        console.error(line);
+    console.error('');
+}
+function printUpgradeCheck(checked) {
+    const { theme } = stdoutUi();
+    const glyph = checked.relation === 'upgrade' ? theme.warn('⬆️')
+        : checked.relation === 'downgrade' ? theme.warn('⬇️') : theme.success('✅');
+    const summary = checked.relation === 'upgrade'
+        ? `${theme.dim(checked.currentVersion)} → ${theme.success(checked.targetVersion)}`
+        : checked.relation === 'downgrade'
+            ? `${theme.dim(checked.currentVersion)} → ${theme.warn(checked.targetVersion)}（目标更旧）`
+            : `${theme.bold(checked.currentVersion)}（已是最新）`;
+    console.log(`${glyph} dta upgrade --check: ${summary}`);
+    console.log(`   target=${theme.noun(checked.pinnedSource)}  channel=${checked.channel}`);
+    if (checked.relation === 'upgrade')
+        console.log(`   ${theme.dim('运行 dta upgrade 执行升级')}`);
+    if (checked.relation === 'downgrade') {
+        console.log(`   ${theme.dim(`降级需显式确认: dta upgrade --version ${checked.targetVersion} --force`)}`);
+    }
 }
 function printUpgrade(out) {
-    const mark = out.dryRun ? 'DRY-RUN' : out.ready ? '✅' : '⚠️';
-    const relation = out.changed ? `${out.currentVersion} → ${out.targetVersion}` : `${out.targetVersion}（已是当前版本）`;
+    const { theme } = stdoutUi();
+    const mark = out.dryRun ? theme.dim('DRY-RUN') : out.ready ? theme.success('✅') : theme.warn('⚠️');
+    const relation = out.changed
+        ? `${theme.dim(out.currentVersion)} → ${theme.success(out.targetVersion)}`
+        : `${out.targetVersion}（已是当前版本）`;
     console.log(`${mark} dta upgrade: ${relation}`);
-    console.log(`   target=${out.target}`);
-    console.log(`   CLI=${out.executable}`);
+    console.log(`   target=${theme.noun(out.target)}`);
+    console.log(`   CLI=${theme.noun(out.executable)}`);
     if (out.dryRun) {
-        console.log(`   将执行: ${out.commands.install}`);
-        console.log(`   将复核: ${out.commands.verify}`);
+        console.log(`   将执行: ${theme.noun(out.commands.install)}`);
+        console.log(`   将复核: ${theme.noun(out.commands.verify)}`);
+        console.log(`   ${theme.dim('移除 --dry-run 以实际执行升级')}`);
     }
     else if (out.ready) {
         console.log('   setup / DWS / Skill / Claude Code / Codex / OpenCode 全部 ready');
+        // 出口指引：验证命令 + 后悔药，都是可以直接复制的
+        console.log(`   ${theme.dim(`验证: dta --version${out.changed ? `　回退: dta upgrade --version ${out.currentVersion} --force` : ''}`)}`);
     }
     else {
-        console.log(`   CLI 已更新；环境复核未完全 ready，请运行: ${out.commands.verify}`);
+        console.log(`   CLI 已更新；环境复核未完全 ready，请运行: ${theme.noun(out.commands.verify)}`);
     }
 }
 //# sourceMappingURL=dingtalk-agent.js.map