@weiping/wingline 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 weiping liu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/audit-table.d.ts

@@ -0,0 +1,7 @@
+import type { AuditTable } from '@weiping/wingline-core';
+import type { Commands } from './cli.js';
+/**
+ * 写命令 → 审计行（spec 6.2、6.3）。摘要只放位置参数与开关：正文与理由类字段统一由
+ * `auditedCommands` 截到 60 字，规格文件、webhook 地址、会话标记都不进摘要。
+ */
+export declare const AUDIT: AuditTable<Commands>;

package/dist/audit-table.js

@@ -0,0 +1,68 @@
+/** 地址参数取 `@` 之后的团队名；解析不出（没有 `@`）记 `-`。 */
+const ofAddress = (a) => a.address.split('@')[1] ?? '-';
+/** 任务 id 的团队名从注册表查；查不到（任务不存在、已被清理）记 `-`。 */
+const byTask = (idOf) => (_a, ctx) => ctx.deps.registry.getTaskExt(idOf(_a))?.team ?? '-';
+const byGate = (gateId) => (_a, ctx) => ctx.deps.registry.getGate(gateId(_a))?.team ?? '-';
+/** 只有结果里才有团队名（up 成功时）；失败或没跑出结果记 `-`。 */
+const byResult = (_a, ctx) => ctx.result?.team ?? '-';
+const id = (a) => a.id;
+/**
+ * 写命令 → 审计行（spec 6.2、6.3）。摘要只放位置参数与开关：正文与理由类字段统一由
+ * `auditedCommands` 截到 60 字，规格文件、webhook 地址、会话标记都不进摘要。
+ */
+export const AUDIT = {
+    up: {
+        command: 'up',
+        team: byResult,
+        summary: (a) => ({ adoptRun: a.adoptRun, newRun: a.newRun, draft: a.draft }),
+    },
+    down: {
+        command: 'down',
+        team: (a) => a.team,
+        summary: (a) => ({ close: a.close }),
+    },
+    restore: {
+        command: 'restore',
+        team: (a) => a.team,
+        skip: (a) => !!a.dryRun,
+        summary: (a) => ({ dryRun: !!a.dryRun, noTasks: !!a.noTasks, session: Object.keys(a.sessions ?? {}) }),
+    },
+    send: {
+        command: 'send',
+        team: ofAddress,
+        target: (a) => a.address,
+        summary: (a) => ({ message: a.message }),
+    },
+    createTask: {
+        command: 'task create',
+        team: (a) => a.team,
+        target: (_a, ctx) => ctx.result?.id ?? null,
+        summary: (a) => ({ title: a.title, post: a.post, tags: a.tags, parent: a.parent, as: a.as }),
+    },
+    claimTask: { command: 'task claim', team: byTask(id), target: id, summary: (a) => ({ as: a.as }) },
+    releaseTask: { command: 'task release', team: byTask(id), target: id, summary: (a) => ({ as: a.as }) },
+    reassignTask: { command: 'task reassign', team: byTask(id), target: id, summary: (a) => ({ to: a.to, as: a.as }) },
+    startTask: { command: 'task start', team: byTask(id), target: id, summary: (a) => ({ as: a.as }) },
+    planTask: { command: 'task plan', team: byTask(id), target: id, summary: (a) => ({ text: a.text }) },
+    doneTask: { command: 'task done', team: byTask(id), target: id, summary: (a) => ({ as: a.as, resumeEpoch: a.resumeEpoch }) },
+    escalateTask: { command: 'task escalate', team: byTask(id), target: id, summary: (a) => ({ reason: a.reason, reopen: a.reopen, as: a.as }) },
+    resolveGate: {
+        command: 'task resolve',
+        team: byGate((a) => a.gateId),
+        target: (a) => a.gateId,
+        summary: (a) => ({ resolution: a.resolution, reassign: a.reassign, as: a.as }),
+    },
+    recoverTask: { command: 'task recover', team: byTask(id), target: id, summary: (a) => ({ as: a.as }) },
+    dispatcherUp: { command: 'dispatcher up', team: (a) => a.team, summary: (a) => ({ platform: a.platform }) },
+    dispatcherDown: { command: 'dispatcher down', team: (a) => a.team, summary: (a) => ({ close: a.close }) },
+    freezePostCmd: { command: 'dispatcher freeze', team: ofAddress, target: (a) => a.address, summary: (a) => ({ reason: a.reason }) },
+    unfreezePostCmd: { command: 'dispatcher unfreeze', team: ofAddress, target: (a) => a.address },
+    hushCmd: { command: 'dispatcher hush', team: ofAddress, target: (a) => a.address, summary: (a) => ({ forMs: a.forMs }) },
+    unhushCmd: { command: 'dispatcher unhush', team: ofAddress, target: (a) => a.address },
+    dispatcherReply: {
+        command: 'dispatcher reply',
+        team: (a) => a.team,
+        target: (a) => a.messageId,
+        summary: (a) => ({ body: a.body, again: a.again }),
+    },
+};

package/dist/cli.d.ts

@@ -0,0 +1,61 @@
+import type { Writable } from 'node:stream';
+import { type CallLogOptions, attention, claimTask, createTask, doneTask, down, escalateTask, followTimeline, listStale, listTasks, planTask, ps, readTimeline, reassignTask, recoverTask, releaseTask, resolveGate, restore, send, showTask, startTask, type AutostartSys, up, dispatcherUp, dispatcherDown, dispatcherStatus, dispatcherReply, freezePostCmd, unfreezePostCmd, hushCmd, unhushCmd, runDispatcherLoop, type CommandDeps } from '@weiping/wingline-core';
+import { consoleCmd } from './console.js';
+import { tuiCmd } from './tui/command.js';
+export interface RunIO {
+    stdout: Writable;
+    stderr: Writable;
+    env: NodeJS.ProcessEnv;
+    /** 只有 wl tui 用；缺省取 process.stdin。 */
+    stdin?: NodeJS.ReadableStream;
+}
+export interface Commands {
+    up: typeof up;
+    ps: typeof ps;
+    send: typeof send;
+    down: typeof down;
+    restore: typeof restore;
+    log: typeof readTimeline;
+    followLog: typeof followTimeline;
+    console: typeof consoleCmd;
+    createTask: typeof createTask;
+    listTasks: typeof listTasks;
+    listStale: typeof listStale;
+    showTask: typeof showTask;
+    claimTask: typeof claimTask;
+    releaseTask: typeof releaseTask;
+    reassignTask: typeof reassignTask;
+    startTask: typeof startTask;
+    planTask: typeof planTask;
+    doneTask: typeof doneTask;
+    escalateTask: typeof escalateTask;
+    resolveGate: typeof resolveGate;
+    recoverTask: typeof recoverTask;
+    dispatcherUp: typeof dispatcherUp;
+    dispatcherDown: typeof dispatcherDown;
+    runDispatcherLoop: typeof runDispatcherLoop;
+    dispatcherStatus: typeof dispatcherStatus;
+    freezePostCmd: typeof freezePostCmd;
+    unfreezePostCmd: typeof unfreezePostCmd;
+    hushCmd: typeof hushCmd;
+    unhushCmd: typeof unhushCmd;
+    dispatcherReply: typeof dispatcherReply;
+    attention: typeof attention;
+    tui: typeof tuiCmd;
+}
+/** 只读轮询（spec 第 8 节）：调度员的 CallLog 只记摘要。 */
+export declare const isReadOnlyCall: (args: string[]) => boolean;
+/** `dispatcher run` 的覆盖项：Orca 启动的终端不继承 WINGLINE_HOME/WINGLINE_ORCA，所以由命令行显式传入。 */
+export interface DepsOverrides {
+    home?: string;
+    orca?: string;
+    summarize?: boolean;
+}
+/** CallLog 选项：summarize 为真时只读轮询只记摘要。 */
+export declare const callLogOptions: (o: DepsOverrides) => CallLogOptions;
+export declare function defaultMakeDeps(inputEnv: NodeJS.ProcessEnv, warn: (m: string) => void, o?: DepsOverrides): CommandDeps;
+/** node:sqlite 在 Node 22 上会打印实验特性警告；只屏蔽它，其他警告照常输出。 */
+export declare function installWarningFilter(stderr: Writable): void;
+/** 真实宿主：系统命令以参数数组启动（不经 shell），入口脚本取符号链接解析后的真实路径。 */
+export declare function realAutostartSys(): AutostartSys;
+export declare function run(argv: string[], io: RunIO, commands?: Commands, makeDeps?: (env: NodeJS.ProcessEnv, warn: (m: string) => void, overrides?: DepsOverrides) => CommandDeps, autostartSys?: AutostartSys): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,328 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { Command, CommanderError, InvalidArgumentError, Option } from 'commander';
+import { READ_ONLY_CALLS, Registry, WinglineError, attention, auditedCommands, claimTask, createCallLog, createOrcaClient, createOrcaRunner, createTask, doneTask, down, escalateTask, exitCodeOf, followTimeline, listStale, listTasks, parseDuration, planTask, ps, readTimeline, reassignTask, recoverTask, releaseTask, resolveGate, resolveOrcaExecutable, restore, restoreAll, restoreAllExitCode, restoreExitCode, send, showTask, startTask, autostartInstall, autostartStatusOf, autostartUninstall, up, winglineHome, dispatcherUp, dispatcherDown, dispatcherStatus, dispatcherReply, freezePostCmd, unfreezePostCmd, hushCmd, unhushCmd, runDispatcherLoop, } from '@weiping/wingline-core';
+import { consoleCmd, renderConsole, renderReady } from './console.js';
+import { tuiCmd } from './tui/command.js';
+import { AUDIT } from './audit-table.js';
+import verified from './verified.json' with { type: 'json' };
+import { errorDoc, renderAttention, renderDispatcherDown, renderDispatcherStatus, renderDispatcherUp, renderUnfreeze, renderCreate, renderDone, renderDown, renderError, renderEscalate, renderList, renderLog, renderPs, renderReassign, renderRecover, renderResolve, renderRestore, renderRestoreAll, renderAutostartInstall, renderAutostartStatus, renderAutostartUninstall, logPrinter, renderSend, renderShow, renderStale, renderStart, renderUp, } from './output.js';
+const rawCommands = {
+    up, ps, send, down, restore, log: readTimeline, followLog: followTimeline, createTask, listTasks, listStale, showTask, claimTask, releaseTask, reassignTask, startTask, planTask, doneTask,
+    escalateTask, resolveGate, recoverTask, dispatcherUp, dispatcherDown, runDispatcherLoop, dispatcherStatus, freezePostCmd, unfreezePostCmd,
+    hushCmd, unhushCmd, dispatcherReply, attention,
+    console: consoleCmd, tui: tuiCmd,
+};
+/** 表里登记过的写命令每执行一次写一行审计（spec 6.2）。 */
+const realCommands = auditedCommands(rawCommands, AUDIT);
+const splitList = (s) => s?.split(',').filter(Boolean);
+/** 参数组合不合法时返回输入错误（交给 execute 统一渲染）；合法返回 null。 */
+function restoreOptsError(team, o) {
+    const bad = (message) => new WinglineError('input', 'restore_args_invalid', message);
+    if (o.actor !== undefined && o.actor !== 'autostart')
+        return new WinglineError('input', 'actor_invalid', `--actor 只接受 autostart，不接受 ${o.actor}`);
+    if (o.all && (team || o.session.length > 0))
+        return bad('--all 不能与 <team> 或 --session 同用');
+    if (!o.all && !team)
+        return bad('需要给出团队名，或用 --all 恢复所有运行中的团队');
+    if (!o.all && o.waitOrca !== undefined)
+        return bad('--wait-orca 只能与 --all 同用');
+    return null;
+}
+const parseSessions = (list) => {
+    const out = {};
+    for (const s of list) {
+        const i = s.indexOf('=');
+        if (i < 1)
+            throw new WinglineError('input', 'session_override_invalid', `--session ${s} 无效：应写成 <post>=<sessionId>`);
+        out[s.slice(0, i)] = s.slice(i + 1);
+    }
+    return out;
+};
+const collect = (v, acc) => [...acc, v];
+const LOG_SOURCES = ['task', 'patrol', 'command'];
+/** wl log 的筛选参数；--limit 必须是正整数，--source 必须是已知来源，否则按用法错处理而不是静默读空。 */
+function logArgs(team, o) {
+    if (o.limit !== undefined && !(Number.isInteger(o.limit) && o.limit >= 1)) {
+        throw new WinglineError('input', 'limit_invalid', `--limit ${String(o.limit)} 无效：应为正整数`);
+    }
+    if (o.source !== undefined && !LOG_SOURCES.includes(o.source)) {
+        throw new WinglineError('input', 'source_invalid', `--source ${o.source} 无效：应为 ${LOG_SOURCES.join('/')} 之一`);
+    }
+    return { team, task: o.task, post: o.post, since: o.since, limit: o.limit, source: o.source };
+}
+/** done：通过 0；gate 失败/转人工/绕过后补跑失败 1。 */
+const exitCodeOfDone = (r) => (r.outcome === 'done' ? 0 : 1);
+const PACKAGE_VERSION = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+function which(name, env) {
+    for (const dir of (env.PATH ?? env.Path ?? '').split(path.delimiter).filter(Boolean)) {
+        const file = path.join(dir, name);
+        if (fs.existsSync(file) && fs.statSync(file).isFile())
+            return file;
+    }
+    return null;
+}
+/** 只读轮询（spec 第 8 节）：调度员的 CallLog 只记摘要。 */
+export const isReadOnlyCall = (args) => READ_ONLY_CALLS.some(([group, sub]) => args[0] === group && args[1] === sub);
+/** CallLog 选项：summarize 为真时只读轮询只记摘要。 */
+export const callLogOptions = (o) => (o.summarize ? { summarize: isReadOnlyCall } : {});
+export function defaultMakeDeps(inputEnv, warn, o = {}) {
+    const env = { ...inputEnv, ...(o.home ? { WINGLINE_HOME: o.home } : {}), ...(o.orca ? { WINGLINE_ORCA: o.orca } : {}) };
+    const home = winglineHome(env);
+    const exe = resolveOrcaExecutable({ env, platform: process.platform, which: (n) => which(n, env) });
+    const runner = createOrcaRunner(exe, createCallLog(path.join(home, 'logs'), undefined, callLogOptions(o)));
+    return {
+        orca: createOrcaClient(runner),
+        registry: Registry.open(path.join(home, 'state.db')),
+        warn,
+        verifiedOrca: verified.verifiedOrca,
+        multilineSafe: !exe.viaCmd,
+        home,
+        orcaPath: exe.cmdPath ?? exe.file,
+        env,
+        now: () => new Date(),
+        monotonic: () => performance.now(),
+    };
+}
+/** node:sqlite 在 Node 22 上会打印实验特性警告；只屏蔽它，其他警告照常输出。 */
+export function installWarningFilter(stderr) {
+    process.removeAllListeners('warning');
+    process.on('warning', (w) => {
+        if (w.name === 'ExperimentalWarning' && w.message.includes('SQLite'))
+            return;
+        stderr.write(`(${w.name}) ${w.message}\n`);
+    });
+}
+const RUN_EXIT = { ambiguous: 1, failed: 2, lost: 2, uncertain: 3 };
+/** 岗位结果与 Run 步骤取最严重者：失败/丢失 2 > 不确定 3 > 候选不唯一 1。 */
+const exitCodeOfUp = (r) => {
+    const codes = [...r.posts.map((p) => (p.outcome === 'failed' ? 2 : p.outcome === 'uncertain' ? 3 : 0)), RUN_EXIT[r.run?.outcome ?? ''] ?? 0];
+    return codes.includes(2) ? 2 : codes.includes(3) ? 3 : codes.includes(1) ? 1 : 0;
+};
+function registerDispatcherCommands(program, commands, execute, io) {
+    const disp = program.command('dispatcher').description('调度员：收件箱中继与巡查');
+    const sub = (spec, desc) => disp.command(spec).description(desc).option('--json', '输出 JSON');
+    sub('up <team>', '启动调度员').action((team, o) => execute(!!o.json, (d) => commands.dispatcherUp(d, { team }), renderDispatcherUp));
+    sub('down <team>', '停止调度员；加 --close 关闭其终端').option('--close', '关闭调度员终端')
+        .action((team, o) => execute(!!o.json, (d) => commands.dispatcherDown(d, { team, close: !!o.close }), renderDispatcherDown));
+    disp.command('run <team>').description('在当前终端运行调度员循环（长期运行）').option('--home <path>', '数据目录（等价 WINGLINE_HOME）')
+        .option('--orca <path>', 'Orca 可执行文件（等价 WINGLINE_ORCA）')
+        .action((team, o) => {
+        const ctl = new AbortController();
+        const stop = () => { io.stderr.write('收到信号，正在停止…\n'); ctl.abort(); };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        process.once('SIGHUP', stop);
+        return execute(false, (d) => commands.runDispatcherLoop(d, team, { signal: ctl.signal }).then(() => ({})), () => '', undefined, { home: o.home, orca: o.orca, summarize: true }).finally(() => { process.off('SIGINT', stop); process.off('SIGTERM', stop); process.off('SIGHUP', stop); });
+    });
+    sub('status <team>', '调度员状态').action((team, o) => execute(!!o.json, (d) => commands.dispatcherStatus(d, team), renderDispatcherStatus));
+    sub('freeze <post@team>', '冻结岗位（不再派发给它）').requiredOption('--reason <text>', '理由')
+        .action((address, o) => execute(!!o.json, (d) => commands.freezePostCmd(d, { address, reason: o.reason }).then(() => ({ address })), (r) => `${r.address} 已冻结\n`));
+    sub('unfreeze <post@team>', '解冻岗位').action((address, o) => execute(!!o.json, (d) => commands.unfreezePostCmd(d, { address }), (r) => renderUnfreeze(r, address)));
+    sub('hush <post@team>', '暂停往岗位终端自动打字').option('--for <时长>', '如 15m、2h；默认 30 分钟')
+        .action((address, o) => execute(!!o.json, async (d) => commands.hushCmd(d, { address, forMs: o.for === undefined ? undefined : parseDuration(o.for) }), (r) => `${address} 静音至 ${r.until}\n`));
+    sub('unhush <post@team>', '取消静音').action((address, o) => execute(!!o.json, (d) => commands.unhushCmd(d, { address }).then(() => ({ address })), (r) => `${r.address} 已取消静音\n`));
+    sub('reply <team> <message_id>', '以协调者身份回答岗位的提问').requiredOption('--body <text>', '回答').option('--again', '再回答一次已答过的问题')
+        .action((team, messageId, o) => execute(!!o.json, (d) => commands.dispatcherReply(d, { team, messageId, body: o.body, again: !!o.again }), (r) => (r.duplicate ? `消息 ${r.messageId} 已回答过，未重复发送\n` : `已回答，消息 ${r.messageId}\n`)));
+}
+function registerTaskCommands(program, commands, execute) {
+    const task = program.command('task').description('任务工作流');
+    const sub = (spec, desc) => task.command(spec).description(desc).option('--json', '输出 JSON');
+    sub('create <team>', '建任务').requiredOption('--title <t>', '标题').option('--post <addr>', '直接派给岗位').option('--tags <a,b>', '标签')
+        .option('--parent <id>', '父任务').option('--as <addr>', '以该岗位身份').option('--retry-request <id>', '重跑上次不确定的创建')
+        .action((team, o) => execute(!!o.json, (d) => commands.createTask(d, { team, title: o.title, post: o.post, tags: splitList(o.tags), parent: o.parent, as: o.as, retryRequest: o.retryRequest }), (r) => renderCreate(r, o.post)));
+    sub('list [team]', '列出任务').option('--mine', '只看我的').option('--status <s>', '按状态').option('--tags <a,b>', '按标签')
+        .option('--stale', '只列卡住的任务').option('--as <addr>', '以该岗位身份')
+        .action((team, o) => {
+        if (!o.stale)
+            return execute(!!o.json, (d) => commands.listTasks(d, { team, mine: o.mine, status: o.status, tags: splitList(o.tags), as: o.as }), renderList);
+        return execute(!!o.json, (d) => commands.listStale(d, team), renderStale);
+    });
+    sub('show <id>', '查看任务').option('--team <team>', '团队').option('--history', '附变迁记录')
+        .action((id, o) => execute(!!o.json, (d) => commands.showTask(d, { id, team: o.team, history: !!o.history }), renderShow));
+    sub('claim <id>', '认领').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.claimTask(d, { id, as: o.as }).then(() => ({ id })), (r) => `任务 ${r.id} 已认领\n`));
+    sub('release <id>', '放弃认领').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.releaseTask(d, { id, as: o.as }).then(() => ({ id })), (r) => `任务 ${r.id} 已放回\n`));
+    sub('reassign <id>', '改派').requiredOption('--to <addr>', '新主人').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.reassignTask(d, { id, to: o.to, as: o.as }), (r) => renderReassign(r, id, o.to)));
+    sub('start <id>', '开始').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.startTask(d, { id, as: o.as }), (r) => renderStart(r, id, o.as)));
+    sub('plan <id> <text>', '写计划')
+        .action((id, text, o) => execute(!!o.json, (d) => commands.planTask(d, { id, text }).then(() => ({ id })), (r) => `任务 ${r.id} 计划已记录\n`));
+    sub('done <id>', '完成').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.doneTask(d, { id, as: o.as }), renderDone, exitCodeOfDone));
+    sub('escalate <id>', '转人工决策').requiredOption('--reason <text>', '理由').option('--reopen', '重开已终态的任务').option('--as <addr>', '以该岗位身份')
+        .option('--retry-request <id>', '重跑上次不确定的 escalate')
+        .action((id, o) => execute(!!o.json, (d) => commands.escalateTask(d, { id, reason: o.reason, reopen: !!o.reopen, as: o.as, retryRequest: o.retryRequest }), renderEscalate));
+    sub('resolve <gateId>', '决策').requiredOption('--resolution <text>', '决定').option('--reassign <addr>', '同时改派').option('--as <addr>', '以该岗位身份')
+        .action((gateId, o) => execute(!!o.json, (d) => commands.resolveGate(d, { gateId, resolution: o.resolution, reassign: o.reassign, as: o.as }), renderResolve));
+    sub('recover <id>', '恢复派给已消失终端的任务').option('--as <addr>', '以该岗位身份')
+        .action((id, o) => execute(!!o.json, (d) => commands.recoverTask(d, { id, as: o.as }), (r) => renderRecover(r, id)));
+}
+function registerBaseCommands(program, commands, execute, io) {
+    program.command('up <team.yaml>').description('拉起团队的全部岗位').option('--json', '输出 JSON')
+        .option('--adopt-run <id>', '找回指定的 Run').option('--new-run', '丢弃旧 Run，新建一个')
+        .option('--draft', '先把同目录的 team.draft.yaml 应用为正式规格（旧规格备份为 .bak）')
+        .action((specPath, o) => execute(!!o.json, async (d) => {
+        if (o.adoptRun && o.newRun)
+            throw new WinglineError('input', 'run_flags_conflict', '--adopt-run 与 --new-run 互斥');
+        return commands.up(d, { specPath, adoptRun: o.adoptRun, newRun: o.newRun, draft: !!o.draft });
+    }, (r) => renderUp(r, { newRun: o.newRun }), exitCodeOfUp));
+    program.command('ps [team]').description('查看岗位状态').option('--json', '输出 JSON')
+        .action((team, o) => execute(!!o.json, (d) => commands.ps(d, { team }), renderPs));
+    program.command('attention <team>').description('需要人处理的事项汇总').option('--json', '输出 JSON')
+        .action((team, o) => execute(!!o.json, (d) => commands.attention(d, team), renderAttention));
+    program.command('tui [team]').description('终端里的团队视图：总览、收件箱、时间线，可处理待办')
+        .action((team) => execute(false, (d) => commands.tui(d, { team, io: { stdin: io.stdin ?? process.stdin, stdout: io.stdout } }), () => ''));
+    program.command('send <post@team> <message>').description('给岗位发消息').option('--json', '输出 JSON')
+        .option('--retry-request <id>', '确认上次未确认的发送：传入当时报告的 Orca 请求 ID，消息须与原来完全相同，不会重复发送')
+        .action((address, message, o) => execute(!!o.json, (d) => commands.send(d, { address, message, retryRequest: o.retryRequest }), renderSend));
+    program.command('down <team>').description('停止团队；加 --close 关闭终端').option('--close', '关闭岗位终端').option('--json', '输出 JSON')
+        .action((team, o) => execute(!!o.json, (d) => commands.down(d, { team, close: !!o.close }), renderDown));
+    program.command('restore [team]').description('重启之后把团队接回来：恢复岗位会话、Run、调度员与任务；--all 恢复所有运行中的团队')
+        .option('--all', '恢复注册表里所有运行中的团队（登录后自动恢复用）')
+        .option('--wait-orca <时长>', '与 --all 同用：先等 Orca 可达且终端列表稳定，如 15m')
+        .option('--dry-run', '只看会做什么，不改动任何东西').option('--no-tasks', '不恢复任务，只接回岗位')
+        .option('--session <post=id>', '跳过搜索，直接用给定的会话接回该岗位（可重复）', collect, [])
+        .addOption(new Option('--actor <name>', '审计里的执行者（只接受 autostart）').hideHelp())
+        .option('--home <path>', '数据目录（等价 WINGLINE_HOME）').option('--orca <path>', 'Orca 可执行文件（等价 WINGLINE_ORCA）')
+        .option('--json', '输出 JSON')
+        .action((team, o) => {
+        const overrides = { home: o.home, orca: o.orca };
+        const bad = restoreOptsError(team, o);
+        if (bad)
+            return execute(!!o.json, async () => { throw bad; }, () => '');
+        const base = { dryRun: !!o.dryRun, noTasks: o.tasks === false, ...(o.actor ? { as: o.actor } : {}) };
+        if (o.all) {
+            return execute(!!o.json, (d) => restoreAll(d, { ...base, waitOrcaMs: o.waitOrca === undefined ? undefined : parseDuration(o.waitOrca) }, { restoreOne: (a) => commands.restore(d, a) }), renderRestoreAll, restoreAllExitCode, overrides);
+        }
+        return execute(!!o.json, (d) => commands.restore(d, { team: team, ...base, sessions: parseSessions(o.session) }), renderRestore, restoreExitCode, overrides);
+    });
+    program.command('log <team>').description('团队时间线：任务、巡查与命令事件按时间合并')
+        .option('--task <id>', '只看某个任务').option('--post <post>', '只看某个岗位')
+        .option('--since <when>', '只看这段时间之后：90s、15m、2h 或 ISO 时间')
+        .option('--limit <n>', '只看最新 n 条', Number).option('--source <s>', '只看某个来源：task/patrol/command')
+        .option('--follow', '持续输出新事件，Ctrl-C 停止').option('--json', '每行一个 JSON（NDJSON）')
+        .action(async (team, o) => {
+        if (!o.follow)
+            return execute(!!o.json, (d) => commands.log(d, logArgs(team, o)), (r) => renderLog(r.events));
+        const ctl = new AbortController();
+        const stop = () => ctl.abort();
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        try {
+            // 先把已有的事件打出来，再从那个游标往后跟；日期行与一次性输出共用同一套格式。
+            return await execute(false, async (d) => {
+                const print = o.json ? (e) => JSON.stringify(e) + '\n' : logPrinter();
+                const args = logArgs(team, o);
+                const first = await commands.log(d, args);
+                for (const e of first.events)
+                    io.stdout.write(print(e));
+                await commands.followLog(d, { ...args, cursor: first.cursor }, (e) => io.stdout.write(print(e)), { signal: ctl.signal });
+                return {};
+            }, () => '');
+        }
+        finally {
+            process.off('SIGINT', stop);
+            process.off('SIGTERM', stop);
+        }
+    });
+}
+/** 真实宿主：系统命令以参数数组启动（不经 shell），入口脚本取符号链接解析后的真实路径。 */
+export function realAutostartSys() {
+    const exec = (file, args) => new Promise((resolve, reject) => {
+        const child = spawn(file, args, { shell: false });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (d) => { stdout += String(d); });
+        child.stderr.on('data', (d) => { stderr += String(d); });
+        child.on('error', reject);
+        child.on('close', (code) => resolve({ code: code ?? 1, stdout, stderr }));
+    });
+    const entry = process.argv[1] ?? '';
+    let script = path.resolve(entry);
+    try {
+        script = fs.realpathSync(entry);
+    }
+    catch { /* 保持 resolve 的结果 */ }
+    return { platform: process.platform, homeDir: os.homedir(), uid: process.getuid?.(), user: os.userInfo().username, node: process.execPath, script, exec, fs };
+}
+function registerAutostartCommands(program, execute, sys) {
+    const auto = program.command('autostart').description('登录后自动执行 wl restore --all（macOS launchd、Linux systemd 用户服务）');
+    const sub = (spec, desc) => auto.command(spec).description(desc).option('--json', '输出 JSON');
+    sub('install', '安装（重复执行会覆盖自己的那一个文件）').option('--wait-orca <时长>', '登录时等 Orca 就绪的最长时间，默认 15m')
+        .action((o) => execute(!!o.json, (d) => autostartInstall(d, sys(), { waitOrca: o.waitOrca }), renderAutostartInstall));
+    sub('uninstall', '卸载（只删雁阵自己的文件，日志保留）')
+        .action((o) => execute(!!o.json, (d) => autostartUninstall(d, sys()), renderAutostartUninstall));
+    sub('status', '是否已安装、将执行的命令与最近的日志')
+        .action((o) => execute(!!o.json, (d) => autostartStatusOf(d, sys()), renderAutostartStatus));
+}
+export async function run(argv, io, commands = realCommands, makeDeps = defaultMakeDeps, autostartSys) {
+    let code = 0;
+    const json = argv.includes('--json');
+    async function execute(json, fn, render, exitOf = () => 0, overrides) {
+        let deps;
+        try {
+            deps = makeDeps(io.env, (m) => io.stderr.write(`警告：${m}\n`), overrides);
+            const result = await fn(deps);
+            io.stdout.write(json ? JSON.stringify({ ok: true, result }) + '\n' : render(result));
+            code = exitOf(result);
+        }
+        catch (err) {
+            const doc = errorDoc(err);
+            if (json)
+                io.stdout.write(JSON.stringify({ ok: false, error: doc }) + '\n');
+            else
+                io.stderr.write(renderError(doc));
+            code = exitCodeOf(err);
+        }
+        finally {
+            deps?.registry.close();
+        }
+    }
+    const program = new Command()
+        .name('wingline')
+        .description('雁阵 Wingline：在 Orca 之上运行常驻 agent 团队')
+        .version(PACKAGE_VERSION)
+        .exitOverride()
+        .configureOutput({ writeOut: (s) => io.stdout.write(s), writeErr: (s) => { if (!json)
+            io.stderr.write(s); } });
+    registerBaseCommands(program, commands, execute, io);
+    registerTaskCommands(program, commands, execute);
+    registerDispatcherCommands(program, commands, execute, io);
+    registerAutostartCommands(program, execute, () => autostartSys ?? realAutostartSys());
+    program
+        .command('console')
+        .description('本地控制台服务')
+        .option('--port <n>', '监听端口', (v) => {
+        const n = Number(v);
+        if (!(Number.isInteger(n) && n >= 1 && n <= 65535))
+            throw new InvalidArgumentError(`不是有效端口：${v}`);
+        return n;
+    })
+        .option('--open', '在 Orca 内置浏览器中打开')
+        .option('--worktree <selector>', '工作区选择器')
+        .option('--link', '获取一次性登录链接')
+        .option('--home <path>', '数据目录（等价 WINGLINE_HOME）')
+        .option('--orca <path>', 'Orca 可执行文件（等价 WINGLINE_ORCA）')
+        .option('--json', '输出 JSON')
+        .action((o) => execute(json, (deps) => commands.console(deps, {
+        port: o.port, open: o.open, worktree: o.worktree, link: o.link,
+        onReady: json ? undefined : (r) => io.stdout.write(renderReady(r)),
+    }), renderConsole, undefined, { home: o.home, orca: o.orca }));
+    try {
+        await program.parseAsync(argv, { from: 'user' });
+    }
+    catch (err) {
+        if (!(err instanceof CommanderError))
+            throw err;
+        code = err.exitCode === 0 ? 0 : 1;
+        // --json 时用法错误也要给出一份合法的 JSON 文档
+        if (json && code !== 0)
+            io.stdout.write(JSON.stringify({ ok: false, error: { kind: 'input', code: 'usage', message: err.message.replace(/^error: /, '') } }) + '\n');
+    }
+    return code;
+}

package/dist/console.d.ts

@@ -0,0 +1,33 @@
+import { type CommandDeps } from '@weiping/wingline-core';
+export interface ConsoleArgs {
+    port?: number;
+    open?: boolean;
+    worktree?: string;
+    link?: boolean;
+    webRoot?: string;
+    /** 新起服务的就绪确认窗口；缺省 10_000。 */
+    confirmMs?: number;
+    /** 确认窗口里的等待；缺省真的是 setTimeout。 */
+    sleep?: (ms: number) => Promise<void>;
+    /** 前台服务就绪后调用一次，用来先打印登录链接（服务随后阻塞到收到信号）。 */
+    onReady?: (r: ConsoleResult) => void;
+}
+export interface ConsoleResult {
+    outcome: 'started' | 'link' | 'opened';
+    url: string;
+    port?: number;
+    tab?: 'opened' | 'unsupported';
+    tabReason?: 'worktree';
+}
+/**
+ * 先关服务、再删 console.json（关闭失败也删）：另一个 wl 进程读到文件时服务一定还能连上，
+ * 不会读到指向已关闭服务的文件（复审 I-3 的残余窗口）。
+ */
+export declare function stopServer(srv: {
+    close(): Promise<void>;
+}, cleanup: () => void): Promise<void>;
+export declare function consoleCmd(deps: CommandDeps, a: ConsoleArgs): Promise<ConsoleResult>;
+/** 启动就绪时打印（前台服务还在跑）。 */
+export declare function renderReady(r: ConsoleResult): string;
+/** 最终结果（服务停止后，或其他三种结果）。 */
+export declare function renderConsole(r: ConsoleResult): string;