@danceiny/gotry 0.0.1-rc.18 → 0.0.1-rc.19

package/dist/scripts/bootstrap-tests.js

@@ -1,5 +1,7 @@
 import assert from 'node:assert/strict';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdtempSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 const repoRoot = join(import.meta.dirname, '..', '..');
 const bootstrap = join(repoRoot, 'bin', 'gotry-bootstrap.js');
@@ -102,7 +104,90 @@ const c7b = runBootstrap([
 assert.equal(c7b.code, 0, `非法 --extension-from 值应回落 bundled 且 exit 0,实际 ${c7b.code}\n${c7b.out}`);
 assert.ok(!c7b.out.includes('下载通道'), '非法值不应进入 github 通道');
 console.log('7. 扩展分发 github 通道(不可达基址即时降级 + 非法值回落 bundled)OK');
-console.log('BOOTSTRAP TESTS: 7/7 OK(扩展就位 + 跳过开关 / wizard --dry-run / wizard 真实 / 扩展分发通道 / 显式跳过 + auto 跳过 + 单项跳过)');
+const c8 = runBootstrap([
+    'doctor'
+], {});
+assert.ok(c8.out.includes('[gotry-doctor]'), '应输出 [gotry-doctor] 标签');
+assert.ok(c8.out.includes('Agent Reach'), '体检应含 agent-reach 项');
+assert.ok(c8.out.includes('hbcli'), '体检应含 hbcli 项');
+assert.ok(c8.out.includes('FLYAI_API_KEY'), '体检应含 flyai key 项(试用额度降级面)');
+assert.ok(c8.out.includes('LLM key'), '体检应含 LLM key 让渡说明(doctor 不管 key)');
+assert.ok(c8.out.includes('dsh-map-tools'), '体检应含 dsh-map-tools 项(#139;与 ts/capabilities/doctor.ts 两面成对)');
+assert.ok(c8.out.includes('dsh-tool-ask-user'), '体检应含 dsh-tool-ask-user 项(与 ts/capabilities/doctor.ts 两面成对)');
+assert.ok(c8.out.includes('doctor-report.md'), '应提示报告落盘路径');
+assert.ok([
+    0,
+    1
+].includes(c8.code), `doctor exit 应为 0(就绪)或 1(有缺失),实际 ${c8.code}`);
+const reportPath = join(repoRoot, 'gotry-state', 'doctor-report.md');
+const report = readFileSync(reportPath, 'utf-8');
+assert.ok(report.includes('# GoTry 依赖体检报告'), '报告 markdown 应落盘可预览');
+assert.ok(report.includes('npx gotry doctor --fix'), '报告应带补装指引');
+console.log('8. doctor 子命令(体检清单 + LLM key 让渡 + 报告落盘)OK');
+const calHome = mkdtempSync(join(tmpdir(), 'gotry-cal-test-'));
+const calEnv = {
+    HOME: calHome
+};
+const c9a = runBootstrap([
+    'calendar',
+    '--status'
+], calEnv);
+assert.equal(c9a.code, 0, `calendar --status(默认态)应 exit 0\n${c9a.out}`);
+assert.ok(c9a.out.includes('默认未挂载'), '默认态=未挂载');
+assert.ok(c9a.out.includes(join(calHome, '.gotry', 'calendar.json')), '状态文件路径可见');
+const c9b = runBootstrap([
+    'calendar'
+], calEnv);
+assert.equal(c9b.code, 0, `calendar(开启)应 exit 0\n${c9b.out}`);
+assert.ok(c9b.out.includes('已开启挂载'), '开启态输出');
+assert.ok(c9b.out.includes('cordis.patch.yml'), '未配置时给 profile 配置指引');
+const c9c = runBootstrap([
+    'calendar',
+    '--status'
+], calEnv);
+assert.ok(c9c.out.includes('已挂载'), '开启后 --status 显示已挂载');
+const c9d = runBootstrap([
+    'doctor'
+], {
+    ...calEnv,
+    GOTRY_SETUP_SKIP: '1'
+});
+assert.ok(c9d.out.includes('dsh-calendar'), 'doctor 清单含 calendar 项(setup 状态面)');
+assert.ok(c9d.out.includes('已挂载但 calendar 未配置'), '开启未配置=doctor 可见');
+const c9e = runBootstrap([
+    'calendar',
+    '--off'
+], calEnv);
+assert.equal(c9e.code, 0, `calendar --off 应 exit 0\n${c9e.out}`);
+assert.ok(c9e.out.includes('恢复默认不挂载'), '关闭态输出');
+const c9f = runBootstrap([
+    'calendar',
+    '--status'
+], calEnv);
+assert.ok(c9f.out.includes('默认未挂载'), '关闭后回到默认态');
+console.log('9. calendar 子命令(setup 状态面 on/off/status + doctor 三态,HOME 隔离)OK');
+{
+    const sumHome = mkdtempSync(join(tmpdir(), 'gotry-sum-test-'));
+    const r = spawnSync('node', [
+        bootstrap,
+        'doctor',
+        '--summary'
+    ], {
+        encoding: 'utf-8',
+        timeout: 60_000,
+        env: {
+            ...process.env,
+            HOME: sumHome
+        }
+    });
+    assert.equal(r.status, 0, `doctor --summary 应恒 exit 0(不挡启动),实际 ${r.status}\n${r.stderr}`);
+    assert.ok(!r.stdout.includes('报告已写'), 'summary 模式零写盘(不落 doctor-report.md)');
+    assert.ok(!r.stdout.includes('[gotry-doctor]'), 'summary 模式零 header(stdout 静默)');
+    assert.match(r.stderr, /\[gotry\] doctor: \d+ 项待处理/, '隔离 HOME 有缺失项 → 一行摘要进 stderr');
+    assert.match(r.stderr, /gotry_doctor/, '摘要带对话内指路');
+    assert.match(r.stderr, /扩展=缺/, '缺失项人话=缺(降级类=半可用)');
+}console.log('10. 启动一次性 doctor 摘要(--summary:stderr 一行/零写盘/恒 exit 0)OK');
+console.log('BOOTSTRAP TESTS: 10/10 OK(扩展就位 + 跳过开关 / wizard --dry-run / wizard 真实 / 扩展分发通道 / doctor 体检面 / calendar setup 状态面 / 显式跳过 + auto 跳过 + 单项跳过 / 启动摘要)');
 
 
 //# sourceURL=ts/scripts/bootstrap-tests.ts

package/dist/scripts/build-metrics-report.js

@@ -0,0 +1,339 @@
+import { existsSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+const BRIDGE_LATENCY_BUDGET_MS = 500;
+const CHANNEL_WINDOW_DAYS = 30;
+function stateFile(stateRoot, name) {
+    const root = stateRoot === '.' ? process.cwd() : stateRoot;
+    return join(root, 'gotry-state', name);
+}
+function readJsonl(path) {
+    if (!existsSync(path)) return [];
+    try {
+        const rows = [];
+        for (const line of readFileSync(path, 'utf-8').split('\n')){
+            const t = line.trim();
+            if (!t) continue;
+            try {
+                rows.push(JSON.parse(t));
+            } catch  {}
+        }
+        return rows;
+    } catch  {
+        return [];
+    }
+}
+function bounded(value, max = 120) {
+    if (!value) return undefined;
+    return value.length <= max ? value : `${value.slice(0, max - 1)}…`;
+}
+const BLOCKED_VERDICTS = new Set([
+    'error',
+    'needs-setup'
+]);
+export function aggregateFacts(rows) {
+    const latest = new Map();
+    let lines = 0;
+    for (const raw of rows){
+        const row = typeof raw === 'object' && raw !== null ? raw : {};
+        lines += 1;
+        const id = typeof row.fact_id === 'string' ? row.fact_id : '';
+        if (!id) continue;
+        latest.set(id, row);
+    }
+    const byKind = {};
+    for (const row of latest.values()){
+        const kind = typeof row.kind === 'string' && row.kind ? row.kind : 'unknown';
+        const verdict = typeof row.verdict === 'string' && row.verdict ? row.verdict : 'n/a';
+        const slot = byKind[kind] ??= {
+            total: 0,
+            verdicts: {},
+            blocked: 0
+        };
+        slot.total += 1;
+        slot.verdicts[verdict] = (slot.verdicts[verdict] ?? 0) + 1;
+        if (BLOCKED_VERDICTS.has(verdict)) slot.blocked += 1;
+    }
+    return {
+        lines,
+        deduped: latest.size,
+        byKind
+    };
+}
+export function aggregateChannels(rows, opts = {}) {
+    const nowMs = (opts.now ?? new Date()).getTime();
+    const cutoff = nowMs - (opts.windowDays ?? CHANNEL_WINDOW_DAYS) * 86_400_000;
+    const counts = new Map();
+    const newest = new Map();
+    const lastState = new Map();
+    for (const raw of rows){
+        const row = typeof raw === 'object' && raw !== null ? raw : {};
+        if (typeof row.channel !== 'string' || !row.channel) continue;
+        if (typeof row.state === 'string' && [
+            'down',
+            'cooldown',
+            'ok'
+        ].includes(row.state)) {
+            lastState.set(row.channel, row.state);
+        }
+    }
+    for (const raw of rows){
+        const row = typeof raw === 'object' && raw !== null ? raw : {};
+        if (typeof row.channel !== 'string' || !row.channel) continue;
+        if (row.state !== 'down' && row.state !== 'cooldown') continue;
+        if (lastState.get(row.channel) === 'ok') continue;
+        const at = typeof row.at === 'string' ? row.at : '';
+        const atMs = Date.parse(at);
+        if (Number.isFinite(atMs) && atMs < cutoff) continue;
+        counts.set(row.channel, (counts.get(row.channel) ?? 0) + 1);
+        const atMsSafe = Number.isFinite(atMs) ? atMs : 0;
+        const prev = newest.get(row.channel);
+        if (prev && prev.atMs >= atMsSafe) continue;
+        newest.set(row.channel, {
+            channel: row.channel,
+            state: row.state,
+            reason: typeof row.reason === 'string' ? row.reason : undefined,
+            at: at || undefined,
+            events: 0,
+            atMs: atMsSafe
+        });
+    }
+    const latest = [
+        ...newest.values()
+    ].map(({ atMs: _atMs, ...row })=>({
+            ...row,
+            events: counts.get(row.channel) ?? 0
+        }));
+    return {
+        windowDays: opts.windowDays ?? CHANNEL_WINDOW_DAYS,
+        latest
+    };
+}
+export function aggregateIncidents(rows, opts = {}) {
+    const nowMs = (opts.now ?? new Date()).getTime();
+    const windowDays = opts.windowDays ?? 7;
+    const cutoff = nowMs - windowDays * 86_400_000;
+    const byKind = {};
+    const sources = new Map();
+    let total = 0;
+    for (const raw of rows){
+        const row = typeof raw === 'object' && raw !== null ? raw : {};
+        const ts = typeof row.ts === 'string' ? row.ts : '';
+        const atMs = Date.parse(ts);
+        if (Number.isFinite(atMs) && atMs < cutoff) continue;
+        const kind = typeof row.kind === 'string' && row.kind ? row.kind : 'unknown';
+        const slot = byKind[kind] ??= {
+            count: 0
+        };
+        slot.count += 1;
+        if (!slot.lastTs || Number.isFinite(atMs) && atMs > Date.parse(slot.lastTs)) {
+            slot.lastTs = ts || slot.lastTs;
+            slot.lastMessage = bounded(typeof row.message === 'string' ? row.message : undefined);
+        }
+        const source = typeof row.source === 'string' && row.source ? row.source : '(unknown)';
+        sources.set(source, (sources.get(source) ?? 0) + 1);
+        total += 1;
+    }
+    const topSources = [
+        ...sources.entries()
+    ].sort((a, b)=>b[1] - a[1]).slice(0, 5).map(([source, count])=>({
+            source,
+            count
+        }));
+    return {
+        windowDays,
+        totalInWindow: total,
+        byKind,
+        topSources
+    };
+}
+export function aggregateLatency(rows, opts = {}) {
+    const nowMs = (opts.now ?? new Date()).getTime();
+    const cutoff = nowMs - (opts.windowDays ?? 7) * 86_400_000;
+    const values = [];
+    const kinds = new Map();
+    for (const raw of rows){
+        const row = typeof raw === 'object' && raw !== null ? raw : {};
+        const ts = typeof row.ts === 'string' ? row.ts : '';
+        const atMs = Date.parse(ts);
+        if (Number.isFinite(atMs) && atMs < cutoff) continue;
+        const ms = typeof row.latencyMs === 'number' ? row.latencyMs : Number.NaN;
+        if (!Number.isFinite(ms)) continue;
+        values.push(ms);
+        const kind = typeof row.kind === 'string' && row.kind ? row.kind : 'unknown';
+        kinds.set(kind, (kinds.get(kind) ?? 0) + 1);
+    }
+    const sorted = [
+        ...values
+    ].sort((a, b)=>a - b);
+    const pick = (q)=>sorted.length === 0 ? 0 : sorted[Math.min(sorted.length - 1, Math.ceil(q * sorted.length) - 1)];
+    return {
+        count: sorted.length,
+        p50: pick(0.5),
+        p95: pick(0.95),
+        max: sorted.length === 0 ? 0 : sorted[sorted.length - 1],
+        overBudget: sorted.filter((ms)=>ms > BRIDGE_LATENCY_BUDGET_MS).length,
+        budgetMs: BRIDGE_LATENCY_BUDGET_MS,
+        topKinds: [
+            ...kinds.entries()
+        ].sort((a, b)=>b[1] - a[1]).slice(0, 5).map(([kind, count])=>({
+                kind,
+                count
+            }))
+    };
+}
+function presenceOf(path) {
+    try {
+        if (!existsSync(path)) return {
+            exists: false
+        };
+        const st = statSync(path);
+        return {
+            exists: true,
+            bytes: st.size,
+            mtime: st.mtime.toISOString()
+        };
+    } catch  {
+        return {
+            exists: false
+        };
+    }
+}
+export async function collectMetrics(stateRoot, opts = {}) {
+    const root = resolve(stateRoot === '.' ? process.cwd() : stateRoot);
+    return {
+        generatedAt: (opts.now ?? new Date()).toISOString(),
+        stateRoot: root,
+        facts: aggregateFacts(readJsonl(stateFile(stateRoot, 'bookable-facts.jsonl'))),
+        channels: aggregateChannels(readJsonl(stateFile(stateRoot, 'channel-health.jsonl')), {
+            now: opts.now,
+            windowDays: CHANNEL_WINDOW_DAYS
+        }),
+        incidents: aggregateIncidents(readJsonl(stateFile(stateRoot, 'incidents.jsonl')), {
+            now: opts.now,
+            windowDays: opts.days ?? 7
+        }),
+        latency: aggregateLatency(readJsonl(stateFile(stateRoot, 'bridge-latency.jsonl')), {
+            now: opts.now,
+            windowDays: opts.days ?? 7
+        }),
+        ledger: presenceOf(stateFile(stateRoot, 'gotry-state.db')),
+        doctorReport: presenceOf(stateFile(stateRoot, 'doctor-report.md'))
+    };
+}
+function fmtRate(blocked, total) {
+    return total === 0 ? '—' : `${blocked}/${total}(${(blocked / total * 100).toFixed(0)}%)`;
+}
+function fmtBytes(bytes) {
+    if (bytes === undefined) return '—';
+    return bytes >= 1_048_576 ? `${(bytes / 1_048_576).toFixed(1)}MB` : `${bytes}B`;
+}
+export function renderMetricsReport(s) {
+    const L = [];
+    L.push(`# GoTry 质量指标报告(只读聚合,#138 第一切片)`);
+    L.push('');
+    L.push(`- 生成时间:${s.generatedAt}`);
+    L.push(`- stateRoot:\`${s.stateRoot}\`(全程只读,零 SQLite 打开)`);
+    L.push(`- 口径:工程面交付,不构成 M3 Exit 证据(Exit 证据归 issue #22)`);
+    L.push('');
+    L.push('## 事实闸 verdict 分布(bookable-facts.jsonl,同 fact_id 取最新)');
+    L.push('');
+    const kinds = Object.entries(s.facts.byKind);
+    if (kinds.length === 0) {
+        L.push('(空:无事实落盘)');
+    } else {
+        L.push('| kind | 去重后 | verdict 分布 | blocked(error+needs-setup) |');
+        L.push('|---|---|---|---|');
+        for (const [kind, st] of kinds){
+            const dist = Object.entries(st.verdicts).map(([v, n])=>`${v}:${n}`).join(' / ');
+            L.push(`| ${kind} | ${st.total} | ${dist} | ${fmtRate(st.blocked, st.total)} |`);
+        }
+        L.push('');
+        L.push(`原始行 ${s.facts.lines},去重后 ${s.facts.deduped}(重查重放幂等)。`);
+    }
+    L.push('');
+    L.push(`## 通道健康(channel-health.jsonl,${s.channels.windowDays} 天窗;hit 即清除,此处只见当前处于 down/cooldown 的通道;'ok' 恢复事件已超越)`);
+    L.push('');
+    if (s.channels.latest.length === 0) {
+        L.push('(空:窗口内无 down/cooldown 事件)');
+    } else {
+        L.push('| 通道 | 最新状态 | 原因 | 时间 | 窗口事件 |');
+        L.push('|---|---|---|---|---|');
+        for (const c of s.channels.latest){
+            L.push(`| ${c.channel} | ${c.state} | ${bounded(c.reason ?? '', 60) ?? '—'} | ${c.at ?? '—'} | ${c.events} |`);
+        }
+    }
+    L.push('');
+    L.push(`## 事故面(incidents.jsonl,${s.incidents.windowDays} 天窗)`);
+    L.push('');
+    const incidentKinds = Object.entries(s.incidents.byKind);
+    if (incidentKinds.length === 0) {
+        L.push('(空:窗口内无事故)');
+    } else {
+        L.push('| kind | 次数 | 最近一次 |');
+        L.push('|---|---|---|');
+        for (const [kind, st] of incidentKinds){
+            L.push(`| ${kind} | ${st.count} | ${st.lastTs ?? '—'}${st.lastMessage ? ` · ${st.lastMessage}` : ''} |`);
+        }
+        const src = s.incidents.topSources.map((t)=>`${t.source}×${t.count}`).join(', ');
+        if (src) {
+            L.push('');
+            L.push(`Top 来源:${src}`);
+        }
+    }
+    L.push('');
+    L.push(`## 桥延迟(bridge-latency.jsonl,${s.incidents.windowDays} 天窗;预算 ${s.latency.budgetMs}ms,超限即复审锚点)`);
+    L.push('');
+    if (s.latency.count === 0) {
+        L.push('(空:窗口内无延迟记录)');
+    } else {
+        const kinds = s.latency.topKinds.map((t)=>`${t.kind}×${t.count}`).join(', ');
+        L.push(`样本 ${s.latency.count}:p50=${s.latency.p50}ms · p95=${s.latency.p95}ms · max=${s.latency.max}ms · 超预算(>${s.latency.budgetMs}ms)= **${s.latency.overBudget}**`);
+        if (kinds) L.push(`按 kind:${kinds}`);
+    }
+    L.push('');
+    L.push('## 账本与体检报告');
+    L.push('');
+    L.push(`- 账本 gotry-state.db:${s.ledger.exists ? `存在(${fmtBytes(s.ledger.bytes)},更新 ${s.ledger.mtime};明细经 \`npx gotry state\` 查看,指标面不打开 SQLite)` : '不存在(该 stateRoot 无账本)'}`);
+    L.push(`- doctor 报告 doctor-report.md:${s.doctorReport.exists ? `存在(更新 ${s.doctorReport.mtime})` : '不存在(跑 `npx gotry doctor` 生成)'}`);
+    L.push('');
+    L.push('## 评测三层入口(ADR-11;运行结果由 run-all-tests.sh / CI 承载,v1 不在此重跑)');
+    L.push('');
+    L.push('- 单元/合同/golden E2E:`./scripts/run-all-tests.sh`(全绿是任何提交前闸)');
+    L.push('- 合同层样例:`evaluation-contract-tests.ts`;golden E2E:`benchmark-environment-bridge-e2e.ts`;typed 契约 canary:`typed-contract-canary.ts`');
+    L.push('');
+    return L.join('\n');
+}
+export function parseArgs(argv) {
+    let stateRoot = '.';
+    let out;
+    let days = 7;
+    for(let i = 0; i < argv.length; i += 1){
+        const a = argv[i];
+        if (a === '--state-root') stateRoot = argv[++i] ?? stateRoot;
+        else if (a === '--out') out = argv[++i];
+        else if (a === '--days') days = Math.max(1, Number.parseInt(argv[++i] ?? '7', 10) || 7);
+    }
+    return {
+        stateRoot: isAbsolute(stateRoot) ? stateRoot : resolve(stateRoot),
+        out,
+        days
+    };
+}
+export async function main(argv) {
+    const { stateRoot, out, days } = parseArgs(argv);
+    const snapshot = await collectMetrics(stateRoot, {
+        days
+    });
+    const markdown = renderMetricsReport(snapshot);
+    if (out) {
+        writeFileSync(out, markdown + '\n', 'utf-8');
+        process.stdout.write(`指标报告已写 ${out}(stateRoot 只读未动)\n`);
+    } else {
+        process.stdout.write(markdown + '\n');
+    }
+}
+const invokedDirectly = process.argv[1] && import.meta.url === new URL(`file://${resolve(process.argv[1])}`).href;
+if (invokedDirectly) await main(process.argv.slice(2));
+
+
+//# sourceURL=ts/scripts/build-metrics-report.ts

package/dist/scripts/channel-probe-tests.js

@@ -0,0 +1,148 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, writeFile, mkdir, readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { evaluateProbeResults, defaultProbes, parseArgs, main } from './channel-probe.js';
+import { readLatestChannelEvents, recordChannelEvent } from '../capabilities/channel-health.js';
+import { aggregateChannels } from './build-metrics-report.js';
+const tmp = await mkdtemp(join(tmpdir(), 'gotry-probe-test-'));
+const probes = defaultProbes();
+const hb = probes.find((p)=>p.channel === 'hbcli-hotel');
+const om = probes.find((p)=>p.channel === 'open-meteo');
+const fly = probes.find((p)=>p.channel === 'flyai');
+const now = new Date('2026-09-07T12:00:00Z');
+const evs = evaluateProbeResults([
+    {
+        probe: hb,
+        result: {
+            ok: false,
+            reason: 'auth-denied',
+            ms: 5
+        }
+    },
+    {
+        probe: om,
+        result: {
+            ok: true,
+            ms: 100
+        }
+    },
+    {
+        probe: fly,
+        result: {
+            ok: true,
+            ms: 0
+        }
+    }
+], new Set([
+    'open-meteo'
+]), now);
+assert.equal(evs.length, 2, `fail→down + ok恢复→'ok' 共 2 条,实际 ${evs.length}`);
+assert.deepEqual({
+    channel: evs[0].channel,
+    state: evs[0].state,
+    reason: evs[0].reason
+}, {
+    channel: 'hbcli-hotel',
+    state: 'down',
+    reason: 'auth-denied'
+}, 'fail 应产 down 事件带 reason');
+assert.deepEqual({
+    channel: evs[1].channel,
+    state: evs[1].state
+}, {
+    channel: 'open-meteo',
+    state: 'ok'
+}, 'ok 且此前 down 应产 ok 恢复事件');
+const noWrites = evaluateProbeResults([
+    {
+        probe: om,
+        result: {
+            ok: true,
+            ms: 90
+        }
+    }
+], new Set(), now);
+assert.equal(noWrites.length, 0, 'ok 且此前健康 → 零写放大');
+const stateRoot = join(tmp, 'state');
+await mkdir(join(stateRoot, 'gotry-state'), {
+    recursive: true
+});
+const jsonl = join(stateRoot, 'gotry-state', 'channel-health.jsonl');
+await writeFile(jsonl, [
+    JSON.stringify({
+        channel: 'opensky',
+        state: 'down',
+        reason: 'http-503',
+        at: '2026-09-07T10:00:00.000Z'
+    }),
+    JSON.stringify({
+        channel: 'opensky',
+        state: 'ok',
+        at: '2026-09-07T11:00:00.000Z'
+    }),
+    JSON.stringify({
+        channel: 'hbcli-hotel',
+        state: 'down',
+        reason: 'auth-denied',
+        at: '2026-09-07T10:30:00.000Z'
+    }),
+    'not-json-garbage',
+    ''
+].join('\n'), 'utf-8');
+const latest = await readLatestChannelEvents(stateRoot, {
+    now: Date.parse('2026-09-07T12:00:00Z')
+});
+assert.equal(latest.get('opensky')?.state, 'ok', "'ok' 应超越同通道更早的 down");
+assert.equal(latest.get('hbcli-hotel')?.state, 'down', '未恢复通道保持 down');
+assert.equal(latest.size, 2, '坏行跳过,latest 只含两通道');
+const openskyEv = latest.get('opensky');
+assert.ok(openskyEv && openskyEv.state !== 'down', 'doctor 的 down 判定应不再命中已恢复通道');
+const rows = (await readFile(jsonl, 'utf-8')).split('\n').filter((l)=>l.trim()).flatMap((l)=>{
+    try {
+        return [
+            JSON.parse(l)
+        ];
+    } catch  {
+        return [];
+    }
+});
+const stats = aggregateChannels(rows, {
+    now: new Date('2026-09-07T12:00:00Z'),
+    windowDays: 30
+});
+const openskyStat = stats.latest.find((c)=>c.channel === 'opensky');
+assert.equal(openskyStat, undefined, 'ok 超越的通道不应出现在当前 down/cooldown newest 面');
+const hbStat = stats.latest.find((c)=>c.channel === 'hbcli-hotel');
+assert.ok(hbStat && hbStat.state === 'down', '未恢复通道仍在 newest 面');
+const listed = defaultProbes();
+assert.ok(listed.find((p)=>p.channel === 'flyai')?.probeable === false, 'flyai 默认不探(共享额度)');
+assert.ok(listed.filter((p)=>p.channel.startsWith('session:')).every((p)=>!p.probeable), 'session:* 全部 skip');
+assert.deepEqual(parseArgs([
+    '--state-root',
+    '/tmp/x',
+    '--only',
+    'a, b',
+    '--dry-run'
+]), {
+    stateRoot: '/tmp/x',
+    only: [
+        'a',
+        'b'
+    ],
+    dryRun: true,
+    list: false
+}, 'parseArgs 解析');
+const rcList = await main([
+    '--list'
+]);
+assert.equal(rcList, 0, '--list exit 0');
+const rcBad = await main([
+    '--only',
+    'no-such-channel'
+]);
+assert.equal(rcBad, 2, '--only 未匹配 exit 2');
+console.log('CHANNEL PROBE TESTS: 5/5 OK(evaluate 纯函数 / latest-wins 恢复 / doctor 口径 / metrics 超越 / CLI 面)');
+
+
+//# sourceURL=ts/scripts/channel-probe-tests.ts