@weiping/wingline 0.0.0-stage → 0.1.1

package/dist/tui/reduce.js

@@ -0,0 +1,127 @@
+import { rowsOf } from './items.js';
+import { LineInput } from './input.js';
+const VIEWS = ['overview', 'inbox', 'timeline'];
+const FILTER_USAGE = '过滤格式：source:task|patrol|command / post:<岗位> / task:<任务 id>；留空清除';
+const SOURCES = ['task', 'patrol', 'command'];
+export function initialTuiState() {
+    return {
+        view: 'overview', selected: 0, menu: null, flow: null, input: null, inputKind: null, confirm: null,
+        filter: null, help: false, status: '', lastUncertain: null, stale: false,
+    };
+}
+const cancelled = (s) => ({ ...s, menu: null, flow: null, input: null, inputKind: null, confirm: null, status: '已取消' });
+/** 逐项问完 steps：还有没回答的就开下一个输入框，问完交给 build。 */
+function advanceFlow(s, item, values) {
+    const next = item.steps[values.length];
+    if (next)
+        return { state: { ...s, menu: null, flow: { item, values }, input: new LineInput(next.prompt), inputKind: 'flow' } };
+    const built = item.build(values);
+    const done = { ...s, menu: null, flow: null, input: null, inputKind: null };
+    return typeof built === 'string' ? { state: { ...done, status: built } } : { state: { ...done, confirm: built, status: '' } };
+}
+function parseFilter(text) {
+    const m = /^(source|post|task):(.+)$/.exec(text.trim());
+    if (!m)
+        return FILTER_USAGE;
+    if (m[1] === 'source')
+        return SOURCES.includes(m[2]) ? { source: m[2] } : FILTER_USAGE;
+    return { [m[1]]: m[2].trim() };
+}
+function applyFilter(s, text) {
+    const closed = { ...s, input: null, inputKind: null };
+    if (text.trim() === '')
+        return { state: { ...closed, filter: null, selected: 0, status: '已清除过滤' } };
+    const f = parseFilter(text);
+    return typeof f === 'string' ? { state: { ...closed, status: f } } : { state: { ...closed, filter: f, selected: 0, status: '' } };
+}
+function inputKey(s, k) {
+    const box = s.input.clone();
+    const r = box.feed(k);
+    if (r === 'continue')
+        return { state: { ...s, input: box } };
+    if (r === 'cancel')
+        return { state: cancelled(s) };
+    if (s.inputKind === 'filter')
+        return applyFilter(s, box.value);
+    const { item, values } = s.flow;
+    if (box.value.trim() === '' && !item.steps[values.length].optional)
+        return { state: { ...s, input: box, status: '不能为空' } };
+    return advanceFlow(s, item, [...values, box.value]);
+}
+function menuKey(s, k) {
+    const m = s.menu;
+    if (k.name === 'escape')
+        return { state: { ...s, menu: null, status: '' } };
+    if (k.name === 'enter')
+        return advanceFlow(s, m.items[m.selected], []);
+    const step = k.name === 'up' ? -1 : k.name === 'down' ? 1 : 0;
+    return { state: step ? { ...s, menu: { ...m, selected: Math.max(0, Math.min(m.items.length - 1, m.selected + step)) } } : s };
+}
+function confirmKey(s, k) {
+    if (k.name === 'char' && k.ch === 'y')
+        return { state: { ...s, confirm: null, status: '执行中…' }, effect: { kind: 'run', action: s.confirm } };
+    return { state: { ...s, confirm: null, status: '已取消' } };
+}
+function switchView(s, view, data) {
+    // 时间线新的在下，进来时选中最新一条
+    const selected = view === 'timeline' ? Math.max(0, rowsOf(view, s, data).length - 1) : 0;
+    return { ...s, view, selected, menu: null };
+}
+function openRow(s, data) {
+    const row = rowsOf(s.view, s, data)[s.selected];
+    if (!row)
+        return { state: s };
+    if (row.actions.length === 0) {
+        const status = row.hint ? `这一项没有对应的写操作，请在终端执行：${row.hint}` : '这一项没有可执行的操作';
+        return { state: { ...s, status } };
+    }
+    if (row.actions.length === 1)
+        return advanceFlow(s, row.actions[0], []);
+    return { state: { ...s, menu: { items: row.actions, selected: 0 }, status: '' } };
+}
+function move(s, data, delta) {
+    const last = Math.max(0, rowsOf(s.view, s, data).length - 1);
+    return { state: { ...s, selected: Math.max(0, Math.min(last, s.selected + delta)) } };
+}
+function charKey(s, data, ch) {
+    const n = Number(ch);
+    if (n >= 1 && n <= VIEWS.length)
+        return { state: switchView(s, VIEWS[n - 1], data) };
+    switch (ch) {
+        case 'j': return move(s, data, 1);
+        case 'k': return move(s, data, -1);
+        case 'r': return { state: s, effect: { kind: 'refresh' } };
+        case 'R': return s.lastUncertain ? { state: s, effect: { kind: 'run', action: s.lastUncertain } } : { state: s };
+        case '?': return { state: { ...s, help: true } };
+        case 'q': return { state: s, effect: { kind: 'quit' } };
+        case '/':
+            return s.view === 'timeline'
+                ? { state: { ...s, input: new LineInput('过滤（source:/post:/task:，留空清除）: '), inputKind: 'filter' } }
+                : { state: s };
+        default: return { state: s };
+    }
+}
+function normalKey(s, k, data) {
+    switch (k.name) {
+        case 'tab': return { state: switchView(s, VIEWS[(VIEWS.indexOf(s.view) + 1) % VIEWS.length], data) };
+        case 'down': return move(s, data, 1);
+        case 'up': return move(s, data, -1);
+        case 'enter': return openRow(s, data);
+        case 'char': return charKey(s, data, k.ch ?? '');
+        default: return { state: s };
+    }
+}
+/** 按键状态机（纯函数）：返回新状态，以及需要外部执行的动作（写操作 / 刷新 / 退出）。 */
+export function reduce(s, k, data) {
+    if (k.name === 'ctrl-c')
+        return { state: s, effect: { kind: 'quit' } };
+    if (s.help)
+        return { state: { ...s, help: false } };
+    if (s.confirm)
+        return confirmKey(s, k);
+    if (s.input)
+        return inputKey(s, k);
+    if (s.menu)
+        return menuKey(s, k);
+    return normalKey(s, k, data);
+}

package/dist/tui/render.d.ts

@@ -0,0 +1,7 @@
+import type { TuiData, TuiState } from './types.js';
+export declare const MIN_COLS = 40;
+/** 整屏内容：每行恰好 cols 列；窗口过窄只给一行提示。输出里不含任何 ANSI 序列。 */
+export declare function renderView(s: TuiState, data: TuiData, size: {
+    cols: number;
+    rows: number;
+}): string[];

package/dist/tui/render.js

@@ -0,0 +1,71 @@
+import { pendingCount } from '@weiping/wingline-core';
+import { dispatcherLine } from '../output.js';
+import { rowsOf } from './items.js';
+import { oneLine } from './text.js';
+import { fit } from './width.js';
+import { inboxBody } from './views/inbox.js';
+import { overviewBody } from './views/overview.js';
+import { timelineBody } from './views/timeline.js';
+export const MIN_COLS = 40;
+const TABS = [['overview', '1 总览'], ['inbox', '2 收件箱'], ['timeline', '3 时间线']];
+const KEYS_HINT = 'j/k 选择  Enter 操作  Tab 切换  ? 帮助  q 退出';
+const HELP = [
+    '按键',
+    '  1 2 3 / Tab     切换 总览 / 收件箱 / 时间线',
+    '  ↑ ↓ / j k       选中行',
+    '  Enter           打开选中项的操作菜单（没有写操作的条目会显示对应的 wl 命令）',
+    '  /               时间线里按 source: / post: / task: 过滤，留空清除',
+    '  r               立即刷新',
+    '  R               结果不确定时按原样重试上一次写操作',
+    '  ?               显示 / 关闭本帮助',
+    '  q / Ctrl-C      退出',
+    '',
+    '写操作提交前会再确认一次：按 y 执行，其他键取消。',
+];
+function header(s, data) {
+    const tabs = TABS.map(([v, label]) => (v === s.view ? `[${label}]` : ` ${label} `)).join(' ');
+    const a = data.attention;
+    const pending = pendingCount(a);
+    const disp = dispatcherLine(a.dispatcher) ?? '调度员：未启动';
+    return [`雁阵 ${oneLine(data.team)}   ${tabs}`, `${disp}   待办 ${pending}${s.stale ? '   [数据过期]' : ''}`];
+}
+function footer(s, cols) {
+    if (s.confirm)
+        return [`确认：${oneLine(s.confirm.label)}？按 y 执行，其他键取消`];
+    const status = s.status ? oneLine(s.status) : KEYS_HINT;
+    if (s.input)
+        return [status, s.input.view(cols)];
+    if (!s.menu)
+        return [status];
+    const items = s.menu.items.map((m, i) => `${i === s.menu.selected ? '> ' : '  '}${m.label}`);
+    return ['操作（↑↓ 选择，Enter 确认，Esc 取消）：', ...items];
+}
+function body(s, data, height) {
+    if (s.help)
+        return HELP;
+    const rows = rowsOf(s.view, s, data);
+    const selected = Math.max(0, Math.min(s.selected, rows.length - 1));
+    if (s.view === 'overview')
+        return overviewBody(rows, selected, data);
+    return s.view === 'inbox' ? inboxBody(rows, selected, data) : timelineBody(rows, selected, s.filter, height);
+}
+/** 正文比可用高度长时，围绕选中行（以 `> ` 开头）取一个窗口，保证选中的那一行始终看得见。 */
+function windowAround(lines, height) {
+    if (lines.length <= height)
+        return lines;
+    const focus = Math.max(0, lines.findIndex((l) => l.startsWith('> ')));
+    const start = Math.max(0, Math.min(focus - Math.floor(height / 2), lines.length - height));
+    return lines.slice(start, start + height);
+}
+/** 整屏内容：每行恰好 cols 列；窗口过窄只给一行提示。输出里不含任何 ANSI 序列。 */
+export function renderView(s, data, size) {
+    if (size.cols < MIN_COLS)
+        return ['窗口太窄'];
+    const head = header(s, data);
+    const foot = footer(s, size.cols);
+    const height = Math.max(1, size.rows - head.length - foot.length);
+    const main = [...windowAround(body(s, data, height), height)];
+    while (main.length < height)
+        main.push('');
+    return [...head, ...main, ...foot].map((l) => fit(l, size.cols));
+}

package/dist/tui/screen.d.ts

@@ -0,0 +1,25 @@
+/** Screen 只需要能写字符串、知道窗口大小。 */
+export interface ScreenOut {
+    write(s: string): unknown;
+    columns: number;
+    rows: number;
+}
+/** 备用屏幕 + 按行差分重绘。restore 幂等，可以放心在 finally / exit / 信号处理里重复调用。 */
+export declare class Screen {
+    private readonly out;
+    private prev;
+    private entered;
+    private restored;
+    private clearNext;
+    constructor(out: ScreenOut);
+    enter(): void;
+    /** 逐行比较上一帧，只重写变了的行；上一帧多出来的行清空。 */
+    render(lines: string[]): void;
+    /** 尺寸变化时调用：下一帧先清屏再整屏重绘。 */
+    invalidate(): void;
+    restore(): void;
+    size(): {
+        cols: number;
+        rows: number;
+    };
+}

package/dist/tui/screen.js

@@ -0,0 +1,52 @@
+const ENTER = '\x1b[?1049h\x1b[?25l';
+const LEAVE = '\x1b[?25h\x1b[?1049l';
+const at = (row) => `\x1b[${row};1H`;
+/** 备用屏幕 + 按行差分重绘。restore 幂等，可以放心在 finally / exit / 信号处理里重复调用。 */
+export class Screen {
+    out;
+    prev = [];
+    entered = false;
+    restored = false;
+    clearNext = false;
+    constructor(out) {
+        this.out = out;
+    }
+    enter() {
+        this.out.write(ENTER);
+        this.entered = true;
+        this.restored = false;
+    }
+    /** 逐行比较上一帧，只重写变了的行；上一帧多出来的行清空。 */
+    render(lines) {
+        if (this.restored)
+            return;
+        let w = '';
+        if (this.clearNext) {
+            w = '\x1b[2J';
+            this.prev = [];
+            this.clearNext = false;
+        }
+        for (let i = 0; i < Math.max(lines.length, this.prev.length); i++) {
+            const next = lines[i];
+            if (next === this.prev[i])
+                continue;
+            w += `${at(i + 1)}${next ?? ''}\x1b[K`;
+        }
+        this.prev = [...lines];
+        if (w)
+            this.out.write(w);
+    }
+    /** 尺寸变化时调用：下一帧先清屏再整屏重绘。 */
+    invalidate() {
+        this.clearNext = true;
+    }
+    restore() {
+        if (!this.entered || this.restored)
+            return;
+        this.restored = true;
+        this.out.write(LEAVE);
+    }
+    size() {
+        return { cols: this.out.columns, rows: this.out.rows };
+    }
+}

package/dist/tui/text.d.ts

@@ -0,0 +1,8 @@
+import { type TimelineEvent } from '@weiping/wingline-core';
+/**
+ * 外部文本（提问正文、任务标题、时间线字段……）显示前一律经这里：剥掉 ANSI/OSC 序列和控制字符，折成一行。
+ * 否则一条带 `\x1b]0;…\x07` 的提问就能改掉终端标题（标题是岗位身份）或清屏。
+ */
+export declare function oneLine(s: string): string;
+/** 时间线事件里所有字符串（含 detail 的嵌套内容）都先清洗，再交给 renderTimelineEvent 排版。 */
+export declare function cleanEvent(e: TimelineEvent): TimelineEvent;

package/dist/tui/text.js

@@ -0,0 +1,28 @@
+import { plainText } from '@weiping/wingline-core';
+/**
+ * 外部文本（提问正文、任务标题、时间线字段……）显示前一律经这里：剥掉 ANSI/OSC 序列和控制字符，折成一行。
+ * 否则一条带 `\x1b]0;…\x07` 的提问就能改掉终端标题（标题是岗位身份）或清屏。
+ */
+export function oneLine(s) {
+    return plainText(s).replace(/[\r\n\t]+/g, ' ');
+}
+function cleanDeep(v) {
+    if (typeof v === 'string')
+        return oneLine(v);
+    if (Array.isArray(v))
+        return v.map(cleanDeep);
+    if (v && typeof v === 'object')
+        return Object.fromEntries(Object.entries(v).map(([k, x]) => [oneLine(k), cleanDeep(x)]));
+    return v;
+}
+/** 时间线事件里所有字符串（含 detail 的嵌套内容）都先清洗，再交给 renderTimelineEvent 排版。 */
+export function cleanEvent(e) {
+    return {
+        ...e,
+        actor: oneLine(e.actor),
+        action: oneLine(e.action),
+        target: e.target === null ? null : oneLine(e.target),
+        outcome: e.outcome === null ? null : oneLine(e.outcome),
+        detail: cleanDeep(e.detail),
+    };
+}

package/dist/tui/types.d.ts

@@ -0,0 +1,86 @@
+import type { AttentionReport, PsRow, TaskRow, TimelineEvent, TimelineSource, WriteCommands } from '@weiping/wingline-core';
+import type { LineInput } from './input.js';
+import type { ScreenOut } from './screen.js';
+export type View = 'overview' | 'inbox' | 'timeline';
+/** 时间线过滤：`source:` / `post:` / `task:` 三选一。 */
+export interface TimelineFilterSpec {
+    source?: TimelineSource;
+    post?: string;
+    task?: string;
+}
+/** 等用户按 y 确认后才执行的一次写操作。args 原样交给核心命令。 */
+export interface PendingAction {
+    command: keyof WriteCommands;
+    args: Record<string, unknown>;
+    label: string;
+}
+export interface Step {
+    prompt: string;
+    /** 留空也算数（比如静音时长）。 */
+    optional?: boolean;
+}
+/** 操作菜单里的一项：依次问完 steps，再由 build 给出要执行的操作；build 返回字符串表示输入有误。 */
+export interface MenuItem {
+    label: string;
+    steps: Step[];
+    build(values: string[]): PendingAction | string;
+}
+export interface TuiData {
+    team: string;
+    posts: PsRow[];
+    attention: AttentionReport;
+    tasks: TaskRow[];
+    /** 最旧的在前。 */
+    timeline: TimelineEvent[];
+    /** 静音中的岗位地址。 */
+    hushed: string[];
+}
+export interface TuiState {
+    view: View;
+    selected: number;
+    menu: {
+        items: MenuItem[];
+        selected: number;
+    } | null;
+    /** 正在逐项回答的操作。 */
+    flow: {
+        item: MenuItem;
+        values: string[];
+    } | null;
+    input: LineInput | null;
+    inputKind: 'flow' | 'filter' | null;
+    confirm: PendingAction | null;
+    filter: TimelineFilterSpec | null;
+    help: boolean;
+    status: string;
+    /** 结果不确定的上一次写操作（带 retryRequest），R 原样重试。 */
+    lastUncertain: PendingAction | null;
+    /** 最近一次读取失败，显示的数据可能过期。 */
+    stale: boolean;
+}
+export type Effect = {
+    kind: 'run';
+    action: PendingAction;
+} | {
+    kind: 'refresh';
+} | {
+    kind: 'quit';
+};
+export interface TuiInput {
+    isTTY?: boolean;
+    on(event: 'data', fn: (chunk: Buffer | string) => void): unknown;
+    off(event: 'data', fn: (chunk: Buffer | string) => void): unknown;
+    setRawMode?(mode: boolean): unknown;
+    setEncoding?(enc: string): unknown;
+    resume?(): unknown;
+    pause?(): unknown;
+}
+export interface TuiOutput extends ScreenOut {
+    isTTY?: boolean;
+    on(event: 'resize', fn: () => void): unknown;
+    off(event: 'resize', fn: () => void): unknown;
+}
+export interface TuiIo {
+    stdin: TuiInput;
+    stdout: TuiOutput;
+}

package/dist/tui/types.js

@@ -0,0 +1 @@
+export {};

package/dist/tui/views/inbox.d.ts

@@ -0,0 +1,4 @@
+import type { Row } from '../items.js';
+import type { TuiData } from '../types.js';
+/** 收件箱：告警（只读）在最前，然后按分节列出可处理的条目。 */
+export declare function inboxBody(rows: Row[], selected: number, data: TuiData): string[];

package/dist/tui/views/inbox.js

@@ -0,0 +1,23 @@
+import { oneLine } from '../text.js';
+import { marker } from './overview.js';
+/** 收件箱：告警（只读）在最前，然后按分节列出可处理的条目。 */
+export function inboxBody(rows, selected, data) {
+    const a = data.attention;
+    const lines = [];
+    if (a.warnings.length)
+        lines.push(`告警（${a.warnings.length}）`, ...a.warnings.map((w) => `  ${oneLine(w)}`), '');
+    let section = '';
+    rows.forEach((r, i) => {
+        if (r.section !== section) {
+            section = r.section ?? '';
+            const count = rows.filter((x) => x.section === section).length;
+            lines.push(`${section}（${count}）`);
+        }
+        lines.push(`${marker(i === selected)}${r.text}`);
+    });
+    if (rows.length === 0 && a.warnings.length === 0)
+        lines.push('没有需要处理的事项');
+    if (a.unavailable.length)
+        lines.push('', `无法读取：${a.unavailable.map(oneLine).join('；')}`);
+    return lines;
+}

package/dist/tui/views/overview.d.ts

@@ -0,0 +1,6 @@
+import { type Row } from '../items.js';
+import type { TuiData } from '../types.js';
+export declare const RECENT_EVENTS = 8;
+export declare const marker: (selected: boolean) => "  " | "> ";
+/** 总览：岗位表，底部最近 8 条时间线。选中行用 `> ` 标出，不用任何终端样式。 */
+export declare function overviewBody(rows: Row[], selected: number, data: TuiData): string[];

package/dist/tui/views/overview.js

@@ -0,0 +1,13 @@
+import { eventLine } from '../items.js';
+export const RECENT_EVENTS = 8;
+export const marker = (selected) => (selected ? '> ' : '  ');
+/** 总览：岗位表，底部最近 8 条时间线。选中行用 `> ` 标出，不用任何终端样式。 */
+export function overviewBody(rows, selected, data) {
+    const lines = [`岗位（${rows.length}）`, ...rows.map((r, i) => `${marker(i === selected)}${r.text}`)];
+    if (rows.length === 0)
+        lines.push('  还没有岗位');
+    lines.push('', '最近事件');
+    const recent = data.timeline.slice(-RECENT_EVENTS);
+    lines.push(...(recent.length ? recent.map((e) => `  ${eventLine(e)}`) : ['  暂无']));
+    return lines;
+}

package/dist/tui/views/picker.d.ts

@@ -0,0 +1,4 @@
+import type { TeamRow } from '@weiping/wingline-core';
+import type { TuiIo } from '../types.js';
+/** 没有指定团队名且登记了多个团队时的选择列表：↑↓ 选择、Enter 进入、q 退出（返回 null）。 */
+export declare function pickTeam(teams: TeamRow[], io: TuiIo): Promise<string | null>;

package/dist/tui/views/picker.js

@@ -0,0 +1,44 @@
+import { parseKeys } from '../keys.js';
+import { oneLine } from '../text.js';
+import { Screen } from '../screen.js';
+import { fit } from '../width.js';
+/** 没有指定团队名且登记了多个团队时的选择列表：↑↓ 选择、Enter 进入、q 退出（返回 null）。 */
+export function pickTeam(teams, io) {
+    return new Promise((resolve) => {
+        const screen = new Screen(io.stdout);
+        let sel = 0;
+        const draw = () => {
+            const cols = Math.max(20, screen.size().cols);
+            screen.render([
+                fit('选择团队（↑↓ 选择，Enter 进入，q 退出）', cols),
+                ...teams.map((t, i) => fit(`${i === sel ? '> ' : '  '}${oneLine(t.name)}  ${t.status === 'up' ? '运行中' : '已停止'}`, cols)),
+            ]);
+        };
+        const done = (value) => {
+            io.stdin.off('data', onData);
+            io.stdin.setRawMode?.(false);
+            io.stdin.pause?.();
+            screen.restore();
+            resolve(value);
+        };
+        const onData = (chunk) => {
+            for (const k of parseKeys(String(chunk))) {
+                if (k.name === 'up' || (k.name === 'char' && k.ch === 'k'))
+                    sel = Math.max(0, sel - 1);
+                else if (k.name === 'down' || (k.name === 'char' && k.ch === 'j'))
+                    sel = Math.min(teams.length - 1, sel + 1);
+                else if (k.name === 'enter')
+                    return done(teams[sel].name);
+                else if (k.name === 'escape' || k.name === 'ctrl-c' || (k.name === 'char' && k.ch === 'q'))
+                    return done(null);
+            }
+            draw();
+        };
+        io.stdin.setRawMode?.(true);
+        io.stdin.setEncoding?.('utf8');
+        io.stdin.resume?.();
+        screen.enter();
+        draw();
+        io.stdin.on('data', onData);
+    });
+}

package/dist/tui/views/timeline.d.ts

@@ -0,0 +1,4 @@
+import { type Row } from '../items.js';
+import type { TimelineFilterSpec } from '../types.js';
+/** 时间线：旧的在上、新的在下，选中行默认贴着最新一条；超出屏幕高度只留选中行附近。 */
+export declare function timelineBody(rows: Row[], selected: number, filter: TimelineFilterSpec | null, height: number): string[];

package/dist/tui/views/timeline.js

@@ -0,0 +1,11 @@
+import { filterText } from '../items.js';
+import { marker } from './overview.js';
+/** 时间线：旧的在上、新的在下，选中行默认贴着最新一条；超出屏幕高度只留选中行附近。 */
+export function timelineBody(rows, selected, filter, height) {
+    const head = filter ? `时间线（过滤：${filterText(filter)}，共 ${rows.length} 条）` : `时间线（共 ${rows.length} 条）`;
+    if (rows.length === 0)
+        return [head, '  暂无事件'];
+    const room = Math.max(1, height - 1);
+    const start = Math.max(0, Math.min(selected - Math.floor(room / 2), rows.length - room));
+    return [head, ...rows.slice(start, start + room).map((r, i) => `${marker(start + i === selected)}${r.text}`)];
+}

package/dist/tui/width.d.ts

@@ -0,0 +1,4 @@
+/** 字符串占的终端列数；ANSI 序列不占列。 */
+export declare function cellWidth(s: string): number;
+/** 截到刚好 cols 列：放得下就补空格，放不下就截断并以 … 结尾（… 占最后一列，宽字符不会被切开）。 */
+export declare function fit(s: string, cols: number): string;

package/dist/tui/width.js

@@ -0,0 +1,45 @@
+// 终端显示宽度：东亚宽字符与常见 emoji 占 2 列，组合字符与控制字符占 0 列。只处理纯文本（外部文本先经 plainText）。
+const ANSI = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[[0-9:;<=>?]*[ -/]*[@-~]|\x1b[@-Z\\-_]/g;
+/** 占两列的码点区间（闭区间）。 */
+const WIDE = [
+    [0x1100, 0x115f], [0x2e80, 0xa4cf], [0xac00, 0xd7a3], [0xf900, 0xfaff], [0xfe30, 0xfe4f],
+    [0xff00, 0xff60], [0xffe0, 0xffe6], [0x1f300, 0x1f64f], [0x1f680, 0x1f6ff], [0x1f900, 0x1f9ff], [0x1fa70, 0x1faff],
+    // BMP 里默认就是 emoji 样式（占两列）的符号；⚠ ❄ ✓ ✔ ★ © 这类文本样式的符号占一列，不在这里
+    [0x231a, 0x231b], [0x23e9, 0x23ec], [0x23f0, 0x23f0], [0x23f3, 0x23f3], [0x25fd, 0x25fe], [0x2614, 0x2615], [0x2648, 0x2653],
+    [0x267f, 0x267f], [0x2693, 0x2693], [0x26a1, 0x26a1], [0x26aa, 0x26ab], [0x26bd, 0x26be], [0x26c4, 0x26c5], [0x26ce, 0x26ce],
+    [0x26d4, 0x26d4], [0x26ea, 0x26ea], [0x26f2, 0x26f3], [0x26f5, 0x26f5], [0x26fa, 0x26fa], [0x26fd, 0x26fd], [0x2705, 0x2705],
+    [0x270a, 0x270b], [0x2728, 0x2728], [0x274c, 0x274c], [0x274e, 0x274e], [0x2753, 0x2755], [0x2757, 0x2757], [0x2795, 0x2797],
+    [0x27b0, 0x27b0], [0x27bf, 0x27bf], [0x2b1b, 0x2b1c], [0x2b50, 0x2b50], [0x2b55, 0x2b55],
+];
+function charWidth(cp) {
+    if (cp < 0x20 || (cp >= 0x7f && cp < 0xa0))
+        return 0;
+    if (cp >= 0x300 && cp <= 0x36f)
+        return 0;
+    return WIDE.some(([lo, hi]) => cp >= lo && cp <= hi) ? 2 : 1;
+}
+/** 字符串占的终端列数；ANSI 序列不占列。 */
+export function cellWidth(s) {
+    let w = 0;
+    for (const ch of s.replace(ANSI, ''))
+        w += charWidth(ch.codePointAt(0));
+    return w;
+}
+/** 截到刚好 cols 列：放得下就补空格，放不下就截断并以 … 结尾（… 占最后一列，宽字符不会被切开）。 */
+export function fit(s, cols) {
+    if (cols <= 0)
+        return '';
+    const total = cellWidth(s);
+    if (total <= cols)
+        return s + ' '.repeat(cols - total);
+    let kept = '';
+    let w = 0;
+    for (const ch of s) {
+        const cw = charWidth(ch.codePointAt(0));
+        if (w + cw > cols - 1)
+            break;
+        kept += ch;
+        w += cw;
+    }
+    return `${kept}…${' '.repeat(cols - w - 1)}`;
+}

package/dist/verified.json

@@ -0,0 +1 @@
+{ "verifiedOrca": ">=1.4.222 <1.5.0" }

package/dist/web/assets/index-DLO1-OIY.css

@@ -0,0 +1 @@
+:root{color-scheme:light dark;--bg: #f6f5f1;--surface: #ffffff;--ink: #1d1d1b;--muted: #6b6a64;--line: #e2dfd6;--accent: #2f5d50;--ok: #2f7d4f;--warn: #a2650c;--bad: #b03a2e;--radius: 10px;--gap: 14px;font-family:system-ui,-apple-system,Segoe UI,PingFang SC,Microsoft YaHei,sans-serif;font-size:15px;line-height:1.5}@media(prefers-color-scheme:dark){:root{--bg: #171816;--surface: #1f201e;--ink: #e8e6df;--muted: #9a988f;--line: #33342f;--accent: #7fb8a3;--ok: #6fbf8a;--warn: #e0a84f;--bad: #e7796c}}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink)}h1,h2,h3{margin:0 0 var(--gap);font-weight:650;letter-spacing:.01em}h1{font-size:1.5rem}h2{font-size:1.05rem;display:flex;align-items:center;gap:8px}a{color:var(--accent);text-decoration:none}a:hover{text-decoration:underline}code,pre,.term{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.85em}code{background:var(--line);padding:1px 5px;border-radius:4px}pre{white-space:pre-wrap;word-break:break-word;margin:0}.muted{color:var(--muted)}.small{font-size:.85em}.error{color:var(--bad)}.banner{background:var(--surface);border:1px solid var(--line);border-left:4px solid var(--warn);padding:8px 12px;border-radius:var(--radius);margin:0 0 var(--gap)}.banner.error{border-left-color:var(--bad)}.shell{display:grid;grid-template-columns:210px 1fr;min-height:100vh}.side{border-right:1px solid var(--line);padding:20px 16px;display:flex;flex-direction:column;gap:var(--gap)}.brand{font-weight:700;font-size:1.1rem;letter-spacing:.08em;color:var(--accent)}.team-switch,.field input,.field select,.field textarea{font:inherit;color:var(--ink);background:var(--bg);border:1px solid var(--line);border-radius:6px;padding:6px 8px;width:100%}.field textarea{min-height:84px;resize:vertical}.nav-link{display:block;padding:6px 8px;border-radius:6px;color:var(--ink)}.nav-link:hover{background:var(--line);text-decoration:none}.main{padding:20px 28px 48px;min-width:0}.topbar{display:flex;align-items:center;gap:12px;margin-bottom:var(--gap);flex-wrap:wrap}.badge{background:var(--line);padding:2px 10px;border-radius:999px;font-size:.85em}.page{display:flex;flex-direction:column;gap:20px}.page-head{display:flex;align-items:baseline;gap:12px;flex-wrap:wrap}.page-head h1{margin:0}.section{display:flex;flex-direction:column;gap:8px}.section h2 .count,.col h2 .count{color:var(--muted);font-weight:500;font-size:.9em}.card{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:14px 16px}.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:var(--gap)}.post header{display:flex;align-items:center;gap:8px;justify-content:space-between}.post-name{font-weight:650;font-size:1.02rem}.flags,.actions{display:flex;flex-wrap:wrap;gap:6px;align-items:center;margin-top:8px}.row{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:10px 0;border-bottom:1px solid var(--line);flex-wrap:wrap}.pill{display:inline-block;font-size:.78em;padding:1px 8px;border-radius:999px;border:1px solid var(--line);color:var(--muted)}.pill-ok{color:var(--ok);border-color:var(--ok)}.pill-warn{color:var(--warn);border-color:var(--warn)}.pill-bad{color:var(--bad);border-color:var(--bad)}.chip{font-size:.78em;background:var(--line);padding:1px 7px;border-radius:4px}.btn{font:inherit;font-size:.9em;padding:5px 12px;border-radius:6px;border:1px solid var(--accent);background:var(--accent);color:var(--surface);cursor:pointer}.btn:disabled{opacity:.55;cursor:default}.btn.ghost{background:transparent;color:var(--ink);border-color:var(--line)}.btn.danger{background:var(--bad);border-color:var(--bad)}.btn.small{padding:2px 8px;font-size:.8em}.dialog-backdrop{position:fixed;inset:0;background:#00000059;display:grid;place-items:center;z-index:10}.dialog{background:var(--surface);color:var(--ink);border:1px solid var(--line);border-radius:var(--radius);padding:20px;width:min(440px,92vw)}.dialog form{display:flex;flex-direction:column;gap:10px}.dialog-actions{display:flex;justify-content:flex-end;gap:8px}.field{display:flex;flex-direction:column;gap:4px;font-size:.9em}.field.inline{flex-direction:row;align-items:center;gap:6px}.field.inline input,.field.inline select{width:auto;min-width:160px}.field.check{flex-direction:row;align-items:center}.filters{display:flex;flex-wrap:wrap;gap:12px;align-items:center}.cmd{display:flex;align-items:center;gap:8px;flex-wrap:wrap;font-size:.9em}.toasts{position:fixed;bottom:16px;right:16px;display:flex;flex-direction:column;gap:8px;z-index:20}.toast{background:var(--surface);border:1px solid var(--line);border-left:4px solid var(--ok);padding:8px 12px;border-radius:6px}.toast-err{border-left-color:var(--bad)}.events{list-style:none;padding:0;margin:0;display:flex;flex-direction:column}.event{display:grid;grid-template-columns:70px 64px 150px 150px 1fr auto;gap:8px;align-items:baseline;padding:6px 0;border-bottom:1px solid var(--line);font-size:.9em}.event time{color:var(--muted);font-variant-numeric:tabular-nums}.event .tag{color:var(--muted)}.event details{grid-column:2 / -1}.event details pre{margin-top:4px;color:var(--muted)}.facts{display:grid;grid-template-columns:max-content 1fr;gap:6px 16px;margin:0}.facts dt{color:var(--muted)}.facts dd{margin:0}.board{display:grid;grid-template-columns:repeat(5,minmax(180px,1fr));gap:var(--gap);overflow-x:auto}.col{display:flex;flex-direction:column;gap:10px;min-width:0}.col h2{font-size:.95rem}.task{display:flex;flex-direction:column;gap:4px}.task-title{font-weight:600}.expired{max-width:520px;margin:15vh auto;padding:0 20px}.team-list{list-style:none;padding:0;display:flex;flex-direction:column;gap:8px}.side-foot{margin-top:auto}.tabs{display:flex;gap:6px}.spec-form{display:flex;flex-direction:column;gap:var(--gap)}.spec-form fieldset{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:10px var(--gap);margin:0}.spec-form legend{font-weight:650;padding:0 6px}.field label{display:flex;flex-direction:column;gap:4px}.field.check label{flex-direction:row;align-items:center;gap:8px}.field.check input{width:auto}textarea.yaml{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.85em;width:100%;min-height:360px;background:var(--surface);color:var(--ink);border:1px solid var(--line);border-radius:var(--radius);padding:10px}.spec-errors{margin:0;padding-left:18px}.save-panel{display:flex;flex-direction:column;gap:8px;align-items:flex-start}.preview-posts,.preview-fields{margin:0 0 var(--gap);padding-left:18px}.table{border-collapse:collapse;width:100%;font-size:.92em}.table td{padding:6px 10px;border-bottom:1px solid var(--line);vertical-align:top}@media(max-width:760px){.shell{grid-template-columns:1fr}.side{border-right:none;border-bottom:1px solid var(--line);flex-direction:row;flex-wrap:wrap;align-items:center}.event{grid-template-columns:62px 1fr}.event>*{grid-column:auto}}