@xdxer/dingtalk-agent 0.1.1 → 0.1.4-beta.0

package/dist/bin/dingtalk-agent.js

@@ -0,0 +1,763 @@
+#!/usr/bin/env node
+// dingtalk-agent —— 钉钉数字员工的标准范式（TypeScript source）。
+//
+//   CLI   = 拦   标准动作：可程序化、可强制、可验证。撞上去没得商量。
+//   Skill = 劝   判断：只有 LLM 能做的（该不该答、话题归属、怎么写点评）。
+//   本体  = 记   它是谁 + 它知道什么。git clone 就带走。
+//
+// **分界线：凡是能程序化的，收进 CLI；凡是需要判断的，留在 Skill。**
+//
+// 因为：文档会被漏读、误读、自我说服；**撞到闸门上就没得商量。**
+import { parseArgs } from 'node:util';
+import { join, resolve } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { spawn, spawnSync } from 'node:child_process';
+import * as cfgmod from '../src/config.js';
+import * as kbmod from '../src/kb.js';
+import * as runsmod from '../src/runs.js';
+import * as dutymod from '../src/duty.js';
+import { boot } from '../src/boot.js';
+import { init } from '../src/init.js';
+import { ackDispatch, listPendingDispatches, prepareSession } from '../src/sessions.js';
+import { readEventFile, consumeNdjson, heartbeatEvent } from '../src/driver.js';
+import { findRun, previewAction, executeAction } from '../src/actions.js';
+import { resolvePackageRoot } from '../src/package-root.js';
+import { bootstrap } from '../src/bootstrap.js';
+import { doctor } from '../src/doctor.js';
+import { setup } from '../src/setup.js';
+import { installGlobalSkill, skillStatus, uninstallGlobalSkill, upgradeGlobalSkill, } from '../src/skill-manager.js';
+const PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
+const PACKAGE_JSON = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+// ROOT = **你的工作区**（当前目录），不是包所在的目录。
+// 全局装 / npx 跑的时候，包住在 node_modules 里 —— 那不是 agent 的家。
+const ROOT = process.env.DTA_ROOT
+    ? resolve(process.env.DTA_ROOT)
+    : (cfgmod.findRoot(process.cwd()) || process.cwd());
+const HELP = `
+dingtalk-agent —— Skill-first 的钉钉数字员工行为容器
+
+  首次使用（无全局命令时: npx --yes @xdxer/dingtalk-agent setup）
+  setup                        用户级安装 CLI、修复 PATH、安装 Skill、检查 DWS
+  doctor                       检查 PATH / Node / DWS / Skill / Agent 客户端
+
+  Skill（不要求 Workspace）
+  skill install                安装全局 Basic Behavior（Claude Code + Codex + OpenCode）
+  skill status                 检查版本、漂移和客户端可发现性
+  skill upgrade                升级本工具管理的全局 Skill
+  skill uninstall              安全卸载本工具管理的全局 Skill
+    通用: [--dry-run] [--json] [--discard-local-changes]
+
+  每个 Agent Session（不要求 init）
+  bootstrap                    发现当前本地 Workspace；不修改项目文件
+    [--storage <uri>]          local-dir:<path> | dingtalk-doc:<node-or-url>
+    [--state-dir <path>]       远端文档只读快照目录
+    [--profile <dws-profile>] [--json]
+
+  可信事件模式（可选；需要一次 init）
+  init [--context-id X]        仅为 Prepared Run 建最小 Workspace
+  prepare --event-file <file|-> 事件 → Session → Run
+  act ack                       对原消息贴「收到」;不代表接单
+  act reply --text "…"          引用回复原消息
+  act ask --text "…"            只问一个真正阻塞的问题
+  act silence [--reason "…"]    不外发,但留下行为回执
+    通用: [--run <path>] [--dry-run] [--json]
+
+  smoke                         极简本地验收（不写钉钉）
+  eval contract / behavior      完整合同或模型行为评测
+
+  help runtime                  事件宿主与 controller 命令
+  help adapters                 可选 DWS listen 适配器
+  help legacy                   查看兼容的本体、KB、值班与进化命令
+`;
+const RUNTIME_HELP = `
+dingtalk-agent 可信事件运行时（可选宿主能力）
+
+  init [--context-id X] [--memory <uri>] [--knowledge <uri>]
+  prepare --event-file <file|->
+  run --stdin | --event-file <file> | --heartbeat
+  dispatch pending
+  dispatch ack --event-id X --run-id X
+  act ack|reply|ask|silence
+
+这些命令负责目标冻结、Session/Run、Wait、幂等和回执；普通 Agent Session 不必使用。
+`;
+const ADAPTER_HELP = `
+dingtalk-agent 可选 Driver / 开发联调适配器
+
+  listen mention --once
+  listen dm --user <userId> --once
+  listen group --group <openConversationId> --once
+
+listen 不是 Agent 主入口。Claude Code、DWS 云端或其他宿主都可以直接提供事件。
+`;
+const LEGACY_HELP = `
+dingtalk-agent 兼容命令（不属于 P0 四对象主链）
+
+  boot
+  kb mount|list|sync|search
+  duty --check|--run|--list
+  todo
+  log / feedback / runs / evolve
+
+这些能力继续可用，但新增 Agent 应先安装全局 Skill；只有可信事件宿主才需要 runtime。
+`;
+function fail(msg, code = 1) {
+    console.error(msg);
+    process.exit(code);
+}
+const argv = process.argv.slice(2);
+const cmd = argv[0];
+const sub = argv[1];
+try {
+    await main();
+}
+catch (e) {
+    if (e.exitCode)
+        process.exit(e.exitCode);
+    fail(String(e.message || e), 2);
+}
+async function main() {
+    if (cmd === 'help' && sub === 'legacy') {
+        console.log(LEGACY_HELP);
+        return;
+    }
+    if (cmd === 'help' && sub === 'runtime') {
+        console.log(RUNTIME_HELP);
+        return;
+    }
+    if (cmd === 'help' && sub === 'adapters') {
+        console.log(ADAPTER_HELP);
+        return;
+    }
+    if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
+        console.log(HELP);
+        return;
+    }
+    if (cmd === '--version' || cmd === '-V' || cmd === 'version') {
+        console.log(PACKAGE_JSON.version);
+        return;
+    }
+    // ── setup / doctor：npx 永远可启动的首次使用入口。──
+    if (cmd === 'setup') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: {
+                prefix: { type: 'string' }, 'dry-run': { type: 'boolean' },
+                'no-shell-write': { type: 'boolean' }, 'skip-cli-install': { type: 'boolean' },
+                json: { type: 'boolean' },
+            },
+        });
+        const out = setup(PACKAGE_ROOT, {
+            prefix: o.prefix,
+            dryRun: o['dry-run'],
+            writeShell: !o['no-shell-write'],
+            skipCliInstall: o['skip-cli-install'],
+        });
+        if (o.json)
+            console.log(JSON.stringify(out, null, 2));
+        else
+            printSetup(out);
+        if (!out.doctor.ready)
+            process.exitCode = 2;
+        return;
+    }
+    if (cmd === 'doctor') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1), options: { json: { type: 'boolean' } },
+        });
+        const out = doctor(PACKAGE_ROOT);
+        if (o.json)
+            console.log(JSON.stringify(out, null, 2));
+        else
+            printDoctor(out);
+        if (!out.ready)
+            process.exitCode = 2;
+        return;
+    }
+    // ── skill：唯一一次性的主入口；完全不依赖 Workspace。──
+    if (cmd === 'skill') {
+        const { values: o } = parseArgs({
+            args: argv.slice(2),
+            options: {
+                'dry-run': { type: 'boolean' }, json: { type: 'boolean' },
+                'discard-local-changes': { type: 'boolean' },
+            },
+        });
+        const options = {
+            dryRun: o['dry-run'],
+            discardLocalChanges: o['discard-local-changes'],
+        };
+        let out;
+        if (sub === 'install')
+            out = installGlobalSkill(PACKAGE_ROOT, options);
+        else if (sub === 'status')
+            out = skillStatus(PACKAGE_ROOT, options);
+        else if (sub === 'upgrade')
+            out = upgradeGlobalSkill(PACKAGE_ROOT, options);
+        else if (sub === 'uninstall')
+            out = uninstallGlobalSkill(PACKAGE_ROOT, options);
+        else
+            fail('skill 的子命令: install / status / upgrade / uninstall');
+        if (o.json)
+            console.log(JSON.stringify(out, null, 2));
+        else
+            printSkillStatus(out, sub, Boolean(o['dry-run']));
+        return;
+    }
+    // ── bootstrap：当前 Agent Session 按需发现/拉取语义上下文。──
+    if (cmd === 'bootstrap') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: {
+                storage: { type: 'string' }, 'state-dir': { type: 'string' },
+                profile: { type: 'string' }, json: { type: 'boolean' },
+            },
+        });
+        const out = bootstrap(ROOT, {
+            storage: o.storage, stateDir: o['state-dir'], profile: o.profile,
+        });
+        if (o.json)
+            console.log(JSON.stringify(out, null, 2));
+        else {
+            console.log(`✅ ${out.mode === 'workspace' ? '已装载 Workspace' : '直接会话模式'}`);
+            console.log(`   scope=${out.scopeId}  initialized=${out.initialized}`);
+            if (!out.mounts.length)
+                console.log('   没有发现持久上下文；这不是错误，也不需要自动 init。');
+            for (const mount of out.mounts)
+                console.log(`   ${mount.slot}: ${mount.path}`);
+            console.log(`   ${out.note}`);
+        }
+        return;
+    }
+    // ── init ──
+    if (cmd === 'init') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: {
+                'context-id': { type: 'string' }, id: { type: 'string' },
+                memory: { type: 'string' }, knowledge: { type: 'string' },
+            },
+        });
+        // init 的语义是“初始化当前目录”；不能因为父目录恰好有配置就改到父工作区。
+        init(process.env.DTA_ROOT ? ROOT : process.cwd(), {
+            contextId: o['context-id'], id: o.id,
+            memory: o.memory, knowledge: o.knowledge,
+        });
+        return;
+    }
+    // ── prepare：一个事件物化成一个可交给沙箱的 Run ──
+    if (cmd === 'prepare') {
+        const cfg = cfgmod.must(ROOT);
+        const { values: o, positionals } = parseArgs({
+            args: argv.slice(1), allowPositionals: true,
+            options: {
+                'event-file': { type: 'string' }, field: { type: 'string' },
+                'session-key': { type: 'string' }, 'context-id': { type: 'string' },
+                json: { type: 'boolean' },
+            },
+        });
+        const file = o['event-file'] || positionals[0];
+        if (!file)
+            fail('prepare 需要 --event-file <file|->');
+        const out = prepareSession(ROOT, cfg, readEventFile(file), {
+            fieldId: o.field, sessionKey: o['session-key'], contextId: o['context-id'],
+        });
+        printDispatch(out, o.json);
+        return;
+    }
+    // ── run：不内置模型，只把事件流转换为 sandbox dispatch ──
+    if (cmd === 'run') {
+        const cfg = cfgmod.must(ROOT);
+        const { values: o, positionals } = parseArgs({
+            args: argv.slice(1), allowPositionals: true,
+            options: {
+                stdin: { type: 'boolean' }, 'event-file': { type: 'string' },
+                field: { type: 'string' }, 'session-key': { type: 'string' },
+                'context-id': { type: 'string' },
+                heartbeat: { type: 'boolean' }, 'heartbeat-key': { type: 'string' },
+                'heartbeat-event-id': { type: 'string' },
+            },
+        });
+        const options = {
+            fieldId: o.field, sessionKey: o['session-key'], contextId: o['context-id'],
+        };
+        const modes = [Boolean(o.stdin), Boolean(o.heartbeat), Boolean(o['event-file'] || positionals[0])];
+        if (modes.filter(Boolean).length !== 1) {
+            fail('run 的 --stdin / --event-file <file> / --heartbeat 必须且只能选一个');
+        }
+        if (o.stdin) {
+            const result = await consumeNdjson(ROOT, cfg, process.stdin, options);
+            if (result.rejected)
+                process.exitCode = 2;
+            return;
+        }
+        let event;
+        if (o.heartbeat)
+            event = heartbeatEvent(o['heartbeat-key'], o['heartbeat-event-id']);
+        else {
+            const file = o['event-file'] || positionals[0];
+            if (!file)
+                fail('run 需要 --stdin / --event-file <file> / --heartbeat 三选一');
+            event = readEventFile(file);
+        }
+        const out = prepareSession(ROOT, cfg, event, options);
+        process.stdout.write(JSON.stringify(out) + '\n');
+        return;
+    }
+    // ── listen：本地 DWS Driver；云端 Driver 仍走 run --stdin/--event-file。──
+    if (cmd === 'listen') {
+        const cfg = cfgmod.must(ROOT);
+        const modes = {
+            mention: { event: 'user_im_message_receive_at' },
+            dm: { event: 'user_im_message_receive_o2o', required: 'user' },
+            group: { event: 'user_im_message_receive_group', required: 'group' },
+        };
+        const mode = modes[sub];
+        if (!mode)
+            fail('listen 的类型只能是 mention / dm / group');
+        const { values: o } = parseArgs({
+            args: argv.slice(2),
+            options: {
+                user: { type: 'string' }, group: { type: 'string' },
+                once: { type: 'boolean' }, duration: { type: 'string' },
+                'dry-run': { type: 'boolean' }, 'context-id': { type: 'string' },
+                field: { type: 'string' }, 'session-key': { type: 'string' },
+            },
+        });
+        if (mode.required === 'user' && !o.user)
+            fail('listen dm 需要 --user <userId>');
+        if (mode.required === 'group' && !o.group)
+            fail('listen group 需要 --group <openConversationId>');
+        const dwsArgs = ['event', 'consume', mode.event, '-f', 'ndjson'];
+        if (o.user)
+            dwsArgs.push('--user', o.user);
+        if (o.group)
+            dwsArgs.push('--group', o.group);
+        if (o.once)
+            dwsArgs.push('--max-events', '1', '--ephemeral');
+        if (o.duration)
+            dwsArgs.push('--duration', o.duration);
+        if (o['dry-run']) {
+            const child = spawnSync('dws', [...dwsArgs, '--dry-run'], { stdio: 'inherit' });
+            if (child.error)
+                throw child.error;
+            process.exitCode = child.status ?? 2;
+            return;
+        }
+        const child = spawn('dws', dwsArgs, { stdio: ['ignore', 'pipe', 'inherit'] });
+        const status = new Promise((resolveStatus, rejectStatus) => {
+            child.once('error', rejectStatus);
+            child.once('close', (code, signal) => {
+                if (signal)
+                    rejectStatus(new Error(`DWS listener 被 ${signal} 终止`));
+                else
+                    resolveStatus(code ?? 2);
+            });
+        });
+        const result = await consumeNdjson(ROOT, cfg, child.stdout, {
+            fieldId: o.field,
+            sessionKey: o['session-key'],
+            contextId: o['context-id'],
+        });
+        const exitCode = await status;
+        if (exitCode !== 0)
+            fail(`DWS listener 退出码 ${exitCode}`, exitCode);
+        if (result.rejected)
+            process.exitCode = 2;
+        return;
+    }
+    // ── dispatch：durable outbox。ack 表示 controller 已幂等入队，不表示 Run 已完成。──
+    if (cmd === 'dispatch') {
+        const cfg = cfgmod.must(ROOT);
+        const { values: o } = parseArgs({
+            args: argv.slice(2),
+            options: {
+                'event-id': { type: 'string' }, 'run-id': { type: 'string' },
+                consumer: { type: 'string' }, json: { type: 'boolean' },
+            },
+        });
+        if (sub === 'pending') {
+            for (const out of listPendingDispatches(ROOT, cfg)) {
+                process.stdout.write(JSON.stringify(out) + '\n');
+            }
+            return;
+        }
+        if (sub === 'ack') {
+            if (!o['event-id'] || !o['run-id'])
+                fail('dispatch ack 需要 --event-id 和 --run-id');
+            const out = ackDispatch(ROOT, cfg, o['event-id'], o['run-id'], o.consumer || '');
+            process.stdout.write(JSON.stringify(out) + '\n');
+            return;
+        }
+        fail('dispatch 的子命令: pending / ack');
+    }
+    // ── act：元语化动作；目标/身份/预算/状态转移都由 Run 固定 ──
+    if (cmd === 'act') {
+        const kind = sub;
+        const { values: o } = parseArgs({
+            args: argv.slice(2),
+            options: {
+                run: { type: 'string' }, text: { type: 'string' },
+                'text-file': { type: 'string' }, reason: { type: 'string' },
+                'dry-run': { type: 'boolean' }, json: { type: 'boolean' },
+            },
+        });
+        if (o.text && o['text-file'])
+            fail('--text 和 --text-file 只能选一个');
+        const text = o['text-file']
+            ? readFileSync(resolve(process.cwd(), o['text-file']), 'utf8')
+            : o.text;
+        const runPath = findRun(process.cwd(), o.run);
+        const out = o['dry-run']
+            ? previewAction(runPath, kind, { text, reason: o.reason })
+            : executeAction(runPath, kind, { text, reason: o.reason });
+        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}`);
+            if (!out.verified)
+                console.log(`   ${out.verification}`);
+        }
+        if (out.outcome === 'uncertain')
+            process.exitCode = 2;
+        return;
+    }
+    // ── eval：宿主评测入口；shadow 永不调用 act / DWS。──
+    if (cmd === 'eval') {
+        const script = sub === 'contract'
+            ? join(PACKAGE_ROOT, 'evals', 'run-contract-evals.mjs')
+            : sub === 'shadow'
+                ? join(PACKAGE_ROOT, 'evals', 'runners', 'claude-shadow.mjs')
+                : sub === 'behavior'
+                    ? join(PACKAGE_ROOT, 'evals', 'run-shadow-evals.mjs')
+                    : '';
+        if (!script)
+            fail('eval 的子命令: contract / shadow / behavior');
+        const childEnv = { ...process.env };
+        // 合同评测会创建隔离工作区；继承宿主 DTA_ROOT 会让 Action Gate 错读外层 control store。
+        delete childEnv.DTA_ROOT;
+        const child = spawnSync(process.execPath, [script, ...argv.slice(2)], {
+            cwd: ROOT,
+            env: childEnv,
+            stdio: 'inherit',
+        });
+        if (child.error)
+            throw child.error;
+        if (child.signal)
+            throw new Error(`评测进程被 ${child.signal} 终止`);
+        process.exitCode = child.status ?? 2;
+        return;
+    }
+    if (cmd === 'smoke') {
+        const script = join(PACKAGE_ROOT, 'evals', 'run-contract-evals.mjs');
+        const childEnv = { ...process.env };
+        delete childEnv.DTA_ROOT;
+        const child = spawnSync(process.execPath, [script, '--smoke'], {
+            cwd: ROOT, env: childEnv, stdio: 'inherit',
+        });
+        if (child.error)
+            throw child.error;
+        if (child.signal)
+            throw new Error(`Smoke 被 ${child.signal} 终止`);
+        process.exitCode = child.status ?? 2;
+        return;
+    }
+    // ── kb ──
+    if (cmd === 'kb') {
+        const cfg = cfgmod.must(ROOT);
+        const { values: o } = parseArgs({
+            args: argv.slice(2), allowPositionals: true,
+            options: {
+                name: { type: 'string' }, from: { type: 'string' }, own: { type: 'string' },
+                sync: { type: 'string' }, local: { type: 'string' }, force: { type: 'boolean' },
+            },
+        });
+        if (sub === 'mount') {
+            if (!o.name || !o.from)
+                fail('要 --name 和 --from。源的写法见 --help');
+            kbmod.parseSource(o.from); // 写错了当场炸
+            const own = o.own || kbmod.EXTERNAL;
+            const sync = o.sync || (own === kbmod.OWNED ? kbmod.PUSH : kbmod.PULL);
+            if (own === kbmod.OWNED && sync === kbmod.PULL) {
+                fail('owned 的真值在 Git,不该 pull —— 那会把远端的东西覆盖到本地。\n' +
+                    '  **所有权决定真值方向。** owned → push;external → pull。');
+            }
+            const local = o.local || join('.cache/kb', o.name);
+            cfg.kb = (cfg.kb || []).filter((k) => k.name !== o.name);
+            cfg.kb.push({ name: o.name, from: o.from, own, sync, local });
+            cfgmod.save(ROOT, cfg);
+            console.log(`✅ 挂上「${o.name}」 ${o.from}`);
+            console.log(`   所有权=${own} · 同步=${sync} · 落在 ${local}`);
+            console.log(own === kbmod.OWNED
+                ? '   （真值在 Git,钉钉是暴露层。人在钉钉里改了 → sync 时会【停下来问】,不盲覆盖。）'
+                : '   （真值在钉钉,本地只是【可丢弃的缓存】。过期了 kb search 会警告。）');
+            return;
+        }
+        if (sub === 'list') {
+            if (!cfg.kb?.length)
+                return console.log('一个都没挂。 kb mount --help');
+            for (const kb of cfg.kb) {
+                const s = kbmod.stale(kb);
+                console.log(`  ${s ? '⚠️' : '·'} ${kb.name.padEnd(14)} ${kb.own.padEnd(9)} ${kb.sync.padEnd(5)} ${kb.from}`);
+                console.log(`     落在 ${kb.local}  上次同步 ${kb._syncedAt || '从未'}${s ? '  ← **过期了,不许拿来回答**' : ''}`);
+            }
+            return;
+        }
+        if (sub === 'sync') {
+            const targets = (cfg.kb || []).filter((k) => !o.name || k.name === o.name);
+            if (!targets.length)
+                fail('没有这个知识库。 kb list');
+            for (const kb of targets) {
+                if (kb.sync === kbmod.NONE) {
+                    console.log(`  skip   ${kb.name}（sync=none）`);
+                    continue;
+                }
+                if (kb.sync === kbmod.PULL)
+                    kbmod.pull(kb, ROOT, o.force);
+                else
+                    kbmod.push(kb, ROOT, o.force);
+            }
+            cfgmod.save(ROOT, cfg);
+            return;
+        }
+        if (sub === 'search') {
+            const kw = argv[2];
+            if (!kw)
+                fail('要给关键词。 kb search "<关键词>"');
+            kbmod.search(cfg, ROOT, kw);
+            return;
+        }
+        fail('kb 的子命令: mount / list / sync / search');
+    }
+    // ── boot ──
+    if (cmd === 'boot') {
+        boot(cfgmod.must(ROOT), ROOT);
+        return;
+    }
+    // ── duty ──
+    if (cmd === 'duty') {
+        const cfg = cfgmod.must(ROOT);
+        const { values: o } = parseArgs({
+            args: argv.slice(1), allowPositionals: true,
+            options: { check: { type: 'boolean' }, run: { type: 'string' },
+                list: { type: 'boolean' }, force: { type: 'boolean' } },
+        });
+        const duties = dutymod.loadDuties(cfg, ROOT);
+        if (o.list) {
+            const ks = Object.keys(duties);
+            console.log(ks.length ? ks.join('\n')
+                : '(值班表是空的 —— 母体出厂如此,这是【正确】的。在 .dingtalk-agent/config.json 的 duties 里加。)');
+            return;
+        }
+        if (o.run) {
+            const fn = duties[o.run];
+            if (!fn)
+                fail(`没有这个值班: ${o.run}（有: ${Object.keys(duties).join('、') || '无'}）`);
+            const s = fn();
+            if (s.kind === '交付' && !dutymod.inDeliver() && !o.force) {
+                return console.log(`⏸ 「${o.run}」是外发动作,静默时段顺延,**不打扰第三方**。`);
+            }
+            if (s.done)
+                return console.log(`✅ 「${o.run}」已完成,本拍无需执行。${s.detail}`);
+            console.log(`【${o.run}】该做了。${s.gap}`);
+            console.log(`  剧本: ${s.playbook || '(没写剧本 —— 这个值班不合格)'}`);
+            console.log(`  ⚠️ 送达【回读确认】之后才准记 pass。没送达就写 pass = 自己骗自己。`);
+            return;
+        }
+        // --check（默认）
+        console.log('值班表（**完成状态在数据里,不在记忆里**;幂等,漏拍下一拍自愈）');
+        console.log(`  现在 ${runsmod.now().slice(11, 16)} · ${dutymod.inNight() ? '夜间窗口(重活可跑)' : '白天(重活挂起)'} · 外发窗口${dutymod.inDeliver() ? '开' : '关'}`);
+        const ids = Object.keys(duties);
+        if (!ids.length) {
+            console.log('\n  (值班表是空的 —— 母体出厂如此。)');
+            return;
+        }
+        const todo = [];
+        for (const id of ids) {
+            const s = duties[id]();
+            const mark = s.done ? '✅ 已完成' : (s.due ? '⬜ 待补齐' : '⏸ 不在窗口');
+            console.log(`  ${s.id.padEnd(8)} [${s.kind}] ${mark}  ${s.detail}${s.gap ? '  → ' + s.gap : ''}`);
+            if (!s.done && s.due)
+                todo.push(s.id);
+        }
+        if (todo.length) {
+            console.log(`\n本拍要做: ${todo.map((t) => 'duty --run ' + t).join('、')}`);
+            process.exit(1);
+        }
+        console.log('\n全部补齐,静默即可（**不要为此打扰主人**）');
+        return;
+    }
+    // ── 留痕与进化 ──
+    if (cmd === 'log' || cmd === 'logq') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: { did: { type: 'string' }, asked: { type: 'string' }, kind: { type: 'string' },
+                secs: { type: 'string' }, r: { type: 'string' }, ev: { type: 'string' },
+                ch: { type: 'string' }, issue: { type: 'string' },
+                conv: { type: 'string' }, msg: { type: 'string' } },
+        });
+        if (!o.did)
+            fail('要 --did（我怎么答的）');
+        const t = runsmod.logq(ROOT, {
+            ...o, did: o.did, secs: +(o.secs || 0), r: o.r || 'pass',
+        });
+        console.log(`运行记录已落: runs/${runsmod.today()}.md @${t}`);
+        if (!o.conv)
+            console.log('  ⚠️ 没带 --conv —— 事后【拉不出对话流】,这一条基本没有训练价值。');
+        return;
+    }
+    if (cmd === 'feedback') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: { kind: { type: 'string' }, text: { type: 'string' },
+                conv: { type: 'string' }, at: { type: 'string' } },
+        });
+        if (!o.kind || ![runsmod.FB_OK, runsmod.FB_MORE, runsmod.FB_FIX].includes(o.kind)) {
+            fail('--kind 只能是 认可 / 追问 / 纠正');
+        }
+        const day = runsmod.today();
+        const rows = runsmod.read(ROOT, day);
+        let cand = rows.filter((r) => r.asked);
+        if (o.conv)
+            cand = cand.filter((r) => r.conv === o.conv);
+        if (!cand.length)
+            fail(`今天没有可回填的问答行 —— **是不是答完忘了 logq?**`);
+        const tgt = o.at ? cand.find((r) => r.t === o.at) : cand[cand.length - 1];
+        if (!tgt)
+            fail(`找不到 t=${o.at} 的行`);
+        tgt.fb = o.kind;
+        if (o.text)
+            tgt.fbt = o.text.slice(0, 600);
+        runsmod.write(ROOT, day, rows);
+        console.log(`已回填: ${day} @${tgt.t} → 「${o.kind}」（原问: ${(tgt.asked || '').slice(0, 40)}）`);
+        return;
+    }
+    if (cmd === 'runs') {
+        const { values: o } = parseArgs({
+            args: argv.slice(1),
+            options: { days: { type: 'string' }, conv: { type: 'string' },
+                issue: { type: 'string' }, top: { type: 'string' } },
+        });
+        let rows = runsmod.scan(ROOT, +(o.days || 1));
+        if (o.conv) {
+            rows = rows.filter((r) => r.conv === o.conv);
+            console.log(`【对话流】会话 ${o.conv} · ${rows.length} 条 —— **这就是训练素材**`);
+            for (const r of rows) {
+                console.log(`  ── ${r._day} ${r.t}  issue=${r.issue || '-'}  msg=${r.msg || '-'}`);
+                if (r.asked)
+                    console.log(`     主人: ${r.asked}`);
+                console.log(`     我  : ${r.did}   [${r.r}]`);
+                if (r.fb)
+                    console.log(`     反馈: ${r.fb}${r.fbt ? `  「${r.fbt}」` : ''}`);
+            }
+            if (!rows.length)
+                console.log('  (空 —— 这个会话没留痕。**没留痕 = 这些交互等于没发生过。**)');
+            return;
+        }
+        if (o.issue) {
+            const issue = o.issue;
+            rows = rows.filter((r) => (r.issue || '').startsWith(issue));
+        }
+        console.log(`运行记录 runs/ · ${rows.length} 条`);
+        for (const r of rows.slice(-(+(o.top || 30)))) {
+            console.log(`  ${r._day} ${r.t} [${(r.r || '').padEnd(11)}] ${(r.ch || '').padEnd(6)} ${(r.did || '').slice(0, 30)} ${r.fb ? '← ' + r.fb : ''}`);
+        }
+        return;
+    }
+    if (cmd === 'evolve') {
+        const { values: o } = parseArgs({ args: argv.slice(1), options: { days: { type: 'string' } } });
+        const rows = runsmod.scan(ROOT, +(o.days || 7));
+        const ans = rows.filter((r) => r.asked);
+        const bad = ans.filter((r) => [runsmod.FB_FIX, runsmod.FB_MORE].includes(r.fb || ''));
+        const unk = ans.filter((r) => !r.fb);
+        const failed = rows.filter((r) => ['fail', 'unsupported', 'degraded'].includes(r.r));
+        console.log(`【进化清单】近 ${o.days || 7} 天`);
+        console.log(`  面向主人的回答 ${ans.length} 条 · 被【打回】${bad.length} 条 · 引擎层没答出来 ${failed.length} 条`);
+        if (unk.length)
+            console.log(`  ⚠️ ${unk.length} 条【没收到反馈就结案了】—— 答完没回填,这次交互等于白跑。`);
+        if (bad.length) {
+            console.log('\n── 主人打回的（**直接就是这周该改什么**）──');
+            for (const r of bad) {
+                console.log(`  ${r._day} ${r.t} [${r.fb}]  会话=${r.conv || '-'}`);
+                console.log(`     主人问: ${(r.asked || '').slice(0, 60)}`);
+                console.log(`     我答  : ${(r.did || '').slice(0, 60)}`);
+                console.log(`     他说  : ${r.fbt || '(没记下来)'}`);
+                console.log(`     复盘  : dingtalk-agent runs --conv ${r.conv || '<会话id>'}`);
+            }
+        }
+        if (!bad.length && !failed.length) {
+            console.log('\n  (没有打回,也没有失败 —— 要么真的都对,要么【没人回填反馈】。看上面那行。)');
+        }
+        return;
+    }
+    // ── todo：把待办拉全（心跳收件用）──
+    if (cmd === 'todo') {
+        const dws = await import('../src/dws.js');
+        const all = dws.todosAll('false');
+        console.log(`未完成待办 ${all.length} 条（**已翻页拉全** —— 只看第一页会漏掉循环件）`);
+        for (const t of all)
+            console.log(`  ${t.taskId}  ${(t.subject || '').slice(0, 60)}`);
+        return;
+    }
+    fail(`不认识的命令: ${cmd}\n${HELP}`);
+}
+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}`);
+    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})`);
+    console.log(`   launch=${out.launch}  delivery=${out.delivery?.status || 'unknown'}`);
+    console.log(`   allowed=${out.allowedActions.join(', ')}  default=${out.defaultAction}`);
+    console.log('   Local 模式可直接用 cwd/env；生产模式由宿主 Broker 保留 DWS 与 control 权限。');
+}
+function printSkillStatus(out, action, dryRun) {
+    const prefix = dryRun ? 'DRY-RUN' : '✅';
+    const verb = action === 'status' ? '全局 Skill 状态' : `skill ${action}`;
+    console.log(`${prefix} ${verb}: ${out.name}`);
+    console.log(`   bundled=${out.bundled.skillVersion || '-'}  hash=${out.bundled.hash.slice(0, 12)}`);
+    console.log(`   canonical=${out.canonical.path}`);
+    console.log(`   installed=${out.canonical.exists}  managed=${out.canonical.managed}  ` +
+        `modified=${out.canonical.modified}  current=${out.canonical.current}`);
+    for (const client of out.clients) {
+        console.log(`   ${client.label}=${client.state} (${client.discovery}: ${client.path})`);
+    }
+    if (out.legacyCodex.conflict) {
+        console.log(`   ⚠️ legacy Codex 同名路径存在: ${out.legacyCodex.path}`);
+    }
+    if (action === 'install' && !dryRun) {
+        console.log('   新 Agent 会话将自动发现；当前会话未发现时请重启 Claude Code/Codex。');
+    }
+}
+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.nextSteps.length) {
+        console.log('\n下一步:');
+        for (const step of out.nextSteps)
+            console.log(`  ${step}`);
+    }
+}
+function printSetup(out) {
+    console.log(`${out.dryRun ? 'DRY-RUN' : '✅'} dingtalk-agent setup`);
+    console.log(`   CLI: ${out.cli.executable}`);
+    console.log(`   Skill: ${out.skill.canonical.path}`);
+    if (!out.shell.pathReady) {
+        console.log(`   当前 shell 尚未加载 PATH；本次终端执行: ${out.shell.activateCommand}`);
+        if (out.shell.rcFile)
+            console.log(`   新终端会从 ${out.shell.rcFile} 自动加载`);
+    }
+    printDoctor(out.doctor);
+    console.log(`\n开始使用: ${out.nextCommand}`);
+}
+//# sourceMappingURL=dingtalk-agent.js.map