@mebular/fleet 0.0.0-stage → 0.1.0

package/dist/onboard.js

@@ -0,0 +1,510 @@
+// Fleet 设备上车 + 自检（Step 1b）。
+//
+// `onboardDevice`：一次（幂等）完成 主密钥（生成/导入，0600）→ 配置 → 设备证书（core 落盘）。
+// `doctor`：逐项 PASS/FAIL/SKIP（含脱敏与修复建议）；`skipped` 明列原因。
+import { access, chmod, mkdir } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import net from 'node:net';
+import { Mebular, } from '@mebular/core';
+import { isHeartbeatFresh, readHeartbeat, registeredServicesForDir } from '../../service/dist/index.js';
+import { fileMode, permissionsApplicable, fleetConfigPath, fleetMasterKeyPath, fleetStoragePath, generateMasterKey, loadFleetConfig, loadToolConfig, masterKeyFingerprint, readMasterKeyFile, saveFleetConfig, validateFleetConfig, writeMasterKeyFile, } from './config.js';
+import { CommandAgent, ExecutorRegistry, HermesAgent } from './runtime/agent.js';
+import { HttpOpenChamberSeam } from './runtime/openchamber-http.js';
+import { OpenChamberAgent } from './runtime/openchamber.js';
+import { EchoExecutor } from './runtime/executor.js';
+async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 由 agent 配置构建执行器注册表（未知 kind 已在校验期拒绝）。 */
+export function buildRegistry(agents) {
+    const registry = new ExecutorRegistry();
+    for (const a of agents) {
+        if (a.kind === 'echo')
+            registry.register(a.name, new EchoExecutor());
+        else if (a.kind === 'command') {
+            registry.register(a.name, new CommandAgent({
+                command: a.command ?? '',
+                ...(a.baseArgs !== undefined ? { baseArgs: a.baseArgs } : {}),
+                ...(a.timeoutMs !== undefined ? { timeoutMs: a.timeoutMs } : {}),
+                ...(a.concurrency !== undefined ? { concurrency: a.concurrency } : {}),
+            }));
+        }
+        else if (a.kind === 'hermes') {
+            registry.register(a.name, new HermesAgent({ ...(a.timeoutMs !== undefined ? { timeoutMs: a.timeoutMs } : {}) }));
+        }
+        else {
+            registry.register(a.name, new OpenChamberAgent(new HttpOpenChamberSeam({ ...(a.timeoutMs !== undefined ? { timeoutMs: a.timeoutMs } : {}) })));
+        }
+    }
+    return registry;
+}
+/** 由配置 + 加密材料构造 core `Mebular` 选项（订阅自主；对端自行声明）。 */
+export function mebularOptions(config, encryption) {
+    return {
+        storagePath: config.storagePath,
+        deviceId: config.device,
+        encryption,
+        network: { enabled: true, libp2p: { listen: [config.listen] } },
+        sync: {
+            autoSync: true,
+            pushOnWrite: true,
+            pushOnWriteThrottleMs: 20,
+            namespaces: [config.namespace],
+            antiEntropy: { enabled: true, intervalMs: 600_000, jitterRatio: 0.2 },
+        },
+    };
+}
+/** 离线（不启网络）`Mebular` 选项：onboard/doctor/subscribe 用，只读写本地存储。 */
+export function offlineMebularOptions(config, encryption) {
+    return {
+        storagePath: config.storagePath,
+        deviceId: config.device,
+        encryption,
+        network: { enabled: false },
+    };
+}
+/** 生成/导入主密钥并写配置；幂等（重复执行不损坏身份）。 */
+export async function onboardDevice(input) {
+    if (typeof input.device !== 'string' || input.device.length === 0)
+        throw new Error('onboard 需要 --device');
+    await mkdir(input.dir, { recursive: true });
+    if (permissionsApplicable())
+        await chmod(input.dir, 0o700);
+    const keyPath = fleetMasterKeyPath(input.dir);
+    let masterKeyCreated = false;
+    let encryption;
+    if (input.masterKeyFile !== undefined) {
+        encryption = await readMasterKeyFile(input.masterKeyFile);
+        await writeMasterKeyFile(keyPath, encryption); // 归一化到设备目录，0600
+    }
+    else if (await exists(keyPath)) {
+        encryption = await readMasterKeyFile(keyPath);
+    }
+    else {
+        encryption = await generateMasterKey();
+        await writeMasterKeyFile(keyPath, encryption);
+        masterKeyCreated = true;
+    }
+    const config = {
+        v: 1,
+        device: input.device,
+        dir: input.dir,
+        storagePath: fleetStoragePath(input.dir),
+        masterKeyFile: keyPath,
+        namespace: input.namespace ?? 'tasks',
+        listen: input.listen ?? '/ip4/0.0.0.0/tcp/0',
+        peers: input.peerDevice !== undefined ? [{ device: input.peerDevice, ...(input.peerAddr !== undefined ? { addr: input.peerAddr } : {}) }] : [],
+        agents: input.agents ?? [{ name: 'echo', kind: 'echo' }],
+        ...(input.quotaLimitPerDevice !== undefined ? { quotaLimitPerDevice: input.quotaLimitPerDevice } : {}),
+    };
+    const errors = validateFleetConfig(config);
+    if (errors.length > 0)
+        throw new Error(`onboard 配置非法：${errors.join('; ')}`);
+    const alreadyOnboarded = await exists(fleetConfigPath(input.dir));
+    await saveFleetConfig(fleetConfigPath(input.dir), config);
+    // 用 core 落盘设备身份/证书（幂等：已存在则复用）。
+    const mebular = new Mebular({
+        storagePath: config.storagePath,
+        deviceId: config.device,
+        encryption,
+        network: { enabled: false },
+    });
+    await mebular.initialize();
+    try {
+        // 上车即声明本机对该域的订阅（订阅自主、零门槛；其他人仍需自行订阅）。
+        await mebular.subscribeNamespace(config.namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+    return { config, alreadyOnboarded, masterKeyCreated, masterKeyFingerprint: masterKeyFingerprint(encryption.userMasterKey) };
+}
+/**
+ * 工具/CLI 共用的 app 生命周期：注入 live app（运行中 daemon）时**复用它**——不 initialize、
+ * 不 shutdown；否则按目录新建离线实例并在结束时关闭。这样同一份 handler 既能服务 daemon，也能离线跑。
+ */
+async function withToolMebular(dir, live, run) {
+    const config = await loadToolConfig(dir);
+    if (live !== undefined)
+        return run(live, config);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await run(mebular, config);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/**
+ * 本机订阅/退订某记忆域（**只能改自己**；写 `namespace_subscription` 到 `__policy__`）。
+ * `active=false` 只退订，不清本地数据；退出并交接走 `leaveNamespace`。
+ *
+ * `mebular`：运行中 daemon 的 live app（可选）；提供时写入同一 EventLog，不另开离线实例。
+ */
+export async function subscribeNamespace(dir, input) {
+    const active = input.active ?? true;
+    return withToolMebular(dir, input.mebular, async (mebular, config) => {
+        const namespace = input.namespace ?? config.namespace;
+        const event = active
+            ? await mebular.subscribeNamespace(namespace)
+            : await mebular.unsubscribeNamespace(namespace);
+        return { member: config.device, namespace, active, eventId: event.id };
+    });
+}
+/** 某分区的 active 订阅者（只读）。 */
+export async function namespaceSubscribers(dir, namespace) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.getNamespaceSubscribers(namespace ?? config.namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 某分区订阅视图（只读）。 */
+export async function namespaceSubscriptions(dir, namespace) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.getNamespaceSubscriptions(namespace ?? config.namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 建域（零门槛）：写 `namespace_declare`；不自动订阅。`mebular` 为运行中 daemon 的 live app（可选）。 */
+export async function declareNamespace(dir, input) {
+    if (typeof input.namespace !== 'string' || input.namespace.length === 0)
+        throw new Error('namespace 不能为空');
+    return withToolMebular(dir, input.mebular, async (mebular) => {
+        const event = await mebular.declareNamespace({ namespace: input.namespace, ...(input.note !== undefined ? { note: input.note } : {}) });
+        return { namespace: input.namespace, eventId: event.id };
+    });
+}
+/** 恢复被移出的设备（写 `device_restore`；high 档证明由调用方给出）。 */
+export async function restoreDevice(dir, input) {
+    if (typeof input.subject !== 'string' || input.subject.length === 0)
+        throw new Error('restore 需要 --to <deviceId>');
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        const event = await mebular.restoreDevice({
+            subject: input.subject,
+            ...(input.note !== undefined ? { note: input.note } : {}),
+            ...(input.nonce !== undefined ? { nonce: input.nonce } : {}),
+            ...(input.cosign !== undefined ? { cosign: input.cosign } : {}),
+            ...(input.breakGlass !== undefined ? { breakGlass: input.breakGlass } : {}),
+        });
+        return { subject: input.subject, eventId: event.id };
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 重订阅恢复（准入：曾订阅 ∧ 未被移出；写图外 reset 标记）。 */
+export async function rejoinNamespace(dir, input = {}) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.rejoinNamespace({ namespace: input.namespace ?? config.namespace });
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 本机是否已声明某分区重置（读图外标记）。只读。 */
+export async function rejoinReset(dir, namespace) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.hasRejoinReset(namespace ?? config.namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 交接前置校验（只读）——继任者是否订阅且已 ack 本机在该分区的全部事件。 */
+export async function planHandoff(dir, input) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.planNamespaceHandoff({ namespace: input.namespace ?? config.namespace, successor: input.successor });
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+/** 退出并交接（默认要求继任者全量 ack；`force` 仅本地 CLI，仍如实记录）。 */
+export async function leaveNamespace(dir, input) {
+    const config = await loadToolConfig(dir);
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        return await mebular.leaveNamespace({
+            namespace: input.namespace ?? config.namespace,
+            successor: input.successor,
+            ...(input.force !== undefined ? { force: input.force } : {}),
+            ...(input.note !== undefined ? { note: input.note } : {}),
+        });
+    }
+    finally {
+        await mebular.shutdown();
+    }
+}
+function parseTcp(multiaddr) {
+    const m = /\/ip4\/([0-9.]+)\/tcp\/(\d+)/.exec(multiaddr);
+    return m ? { host: m[1], port: Number(m[2]) } : null;
+}
+function tcpReachable(host, port, timeoutMs = 1500) {
+    return new Promise((resolve) => {
+        const socket = net.connect({ host, port });
+        const done = (ok) => {
+            socket.destroy();
+            resolve(ok);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once('connect', () => done(true));
+        socket.once('timeout', () => done(false));
+        socket.once('error', () => done(false));
+    });
+}
+/** 从 multiaddr 取监听主机（`/ip4|ip6/<host>/tcp/<port>`）；无法解析 → null。 */
+function listenHostOf(multiaddr) {
+    const m = /^\/(?:ip4|ip6)\/([^/]+)\/tcp\/\d+/.exec(multiaddr);
+    return m ? m[1] : null;
+}
+/** 回环/私有/链路本地/ULA 视为“非公网”；`0.0.0.0`/`::`/全局地址 → false。 */
+function isPrivateListenHost(host) {
+    if (host === '127.0.0.1' || host === '::1' || host === 'localhost')
+        return true;
+    if (/^10\./.test(host) || /^192\.168\./.test(host))
+        return true;
+    if (/^172\.(1[6-9]|2\d|3[01])\./.test(host))
+        return true;
+    if (/^169\.254\./.test(host))
+        return true;
+    if (/^fe80:/i.test(host))
+        return true;
+    if (/^f[cd]/i.test(host))
+        return true; // IPv6 ULA
+    return false;
+}
+/** 逐项自检；默认脱敏（不含任何密钥材料）。 */
+export async function doctor(dir) {
+    const checks = [];
+    const cfgPath = fleetConfigPath(dir);
+    const add = (name, status, detail, hint) => {
+        checks.push({ name, status, detail, ...(hint !== undefined ? { hint } : {}) });
+    };
+    let config;
+    try {
+        config = await loadFleetConfig(cfgPath);
+    }
+    catch (error) {
+        add('config', 'FAIL', `无法加载配置：${error.message}`, `先运行：fleet onboard --dir ${dir} --device <id>`);
+        return { ok: false, device: '<unknown>', checks, skipped: [] };
+    }
+    // 1) 配置权限（POSIX mode；Windows 无该语义 → SKIP，依赖用户目录 ACL）
+    const posix = permissionsApplicable();
+    if (posix) {
+        const cfgMode = await fileMode(cfgPath).catch(() => -1);
+        add('config 权限', cfgMode === 0o600 ? 'PASS' : 'FAIL', `mode=${cfgMode.toString(8)}`, cfgMode === 0o600 ? undefined : `chmod 600 ${cfgPath}`);
+    }
+    else {
+        add('config 权限', 'SKIP', 'Windows 无 POSIX mode；依赖用户目录 ACL（见 ONBOARDING Windows 章节）');
+    }
+    // 1.5) 监听地址：绑定全接口/公网 → **WARN**（不静默；给加固建议）。不使 ok=false。
+    const listenHost = listenHostOf(config.listen);
+    if (listenHost === null) {
+        add('监听地址', 'SKIP', `无法解析 listen：${config.listen}`);
+    }
+    else if (isPrivateListenHost(listenHost)) {
+        add('监听地址', 'PASS', config.listen);
+    }
+    else {
+        add('监听地址', 'WARN', `${config.listen} 绑定到全接口/公网地址（${listenHost}）`, '改绑回环或 LAN 地址（/ip4/127.0.0.1 或内网 IP）+ 经 relay 互联，或仅放行已授权对端（见 RELAY-OPS.md）');
+    }
+    // 2) 主密钥（存在 + 权限 + 可加载）
+    let encryption = null;
+    try {
+        encryption = await readMasterKeyFile(config.masterKeyFile);
+    }
+    catch {
+        encryption = null;
+    }
+    if (!posix) {
+        add('主密钥权限', 'SKIP', 'Windows 无 POSIX mode；依赖用户目录 ACL（见 ONBOARDING Windows 章节）');
+        if (encryption === null)
+            add('主密钥', 'FAIL', '无法加载主密钥文件', '重新生成或导入（--master-key）');
+        else
+            add('主密钥', 'PASS', `fingerprint=${masterKeyFingerprint(encryption.userMasterKey)}`);
+    }
+    else {
+        const keyMode = await fileMode(config.masterKeyFile).catch(() => -1);
+        if (keyMode !== 0o600)
+            add('主密钥权限', 'FAIL', `mode=${keyMode.toString(8)}`, `chmod 600 ${config.masterKeyFile}`);
+        else if (encryption === null)
+            add('主密钥', 'FAIL', '无法加载主密钥文件', '重新生成或导入（--master-key）');
+        else
+            add('主密钥', 'PASS', `fingerprint=${masterKeyFingerprint(encryption.userMasterKey)}`);
+    }
+    // 3) 设备身份 + 主密钥链（core 验签设备证书）
+    const identityPath = `${config.storagePath}.identity.json`;
+    add('设备身份文件', (await exists(identityPath)) ? 'PASS' : 'FAIL', identityPath, `fleet onboard --dir ${dir} --device ${config.device}`);
+    if (encryption !== null) {
+        try {
+            const m = new Mebular({ storagePath: config.storagePath, deviceId: config.device, encryption, network: { enabled: false } });
+            await m.initialize();
+            await m.shutdown();
+            add('主密钥链', 'PASS', '设备证书链到用户主密钥');
+        }
+        catch (error) {
+            add('主密钥链', 'FAIL', `初始化失败：${error.message}`, '确认 --master-key 与既有身份一致');
+        }
+    }
+    // 4) 对端可达（有 addr 才测；否则等待对端拨入）
+    const withAddr = config.peers.filter((p) => typeof p.addr === 'string');
+    if (config.peers.length === 0) {
+        add('peer 可达', 'SKIP', '未配置任何对端（默认拒绝）', 'fleet onboard … --peer-device <id> [--peer-addr <multiaddr>]');
+    }
+    else if (withAddr.length === 0) {
+        add('peer 可达', 'SKIP', '对端未提供 addr（等待对端拨入）', undefined);
+    }
+    else {
+        for (const peer of withAddr) {
+            const tcp = parseTcp(peer.addr);
+            const reachable = tcp !== null && (await tcpReachable(tcp.host, tcp.port));
+            add(`peer 可达(${peer.device})`, reachable ? 'PASS' : 'FAIL', peer.addr, '确认对端已启动且地址/端口可达');
+        }
+    }
+    // 5) 订阅：本机自声明 + 对端自声明（没有「授权」项）。
+    const peerDevices = config.peers.map((p) => p.device);
+    if (encryption === null) {
+        add('namespace 订阅', 'SKIP', `主密钥不可用，无法读取图上订阅（namespace=${config.namespace}）`, '导入主密钥后重试（--master-key）');
+    }
+    else {
+        try {
+            const m = new Mebular(offlineMebularOptions(config, encryption));
+            await m.initialize();
+            const view = await m.getNamespaceSubscriptions(config.namespace);
+            const blocked = await m.getBlockedDevices();
+            const peerParts = [];
+            let allPeersSubscribed = peerDevices.length > 0;
+            for (const device of peerDevices) {
+                const subscribed = (await m.getSubscriptions(device)).includes(config.namespace);
+                peerParts.push(`${device}:${subscribed ? 'subscribed' : 'not-yet'}`);
+                if (!subscribed)
+                    allPeersSubscribed = false;
+            }
+            await m.shutdown();
+            const selfSubscribed = view.subscribers.includes(config.device);
+            add('namespace 订阅', selfSubscribed ? 'PASS' : 'FAIL', `namespace=${config.namespace} subscribers=[${view.subscribers.join(', ')}] self=${config.device}`, selfSubscribed ? undefined : `fleet subscribe --namespace ${config.namespace}`);
+            add('对端订阅', peerDevices.length === 0 ? 'SKIP' : allPeersSubscribed ? 'PASS' : 'SKIP', peerDevices.length === 0 ? '未登记对端' : `peers=[${peerParts.join(', ')}]`, allPeersSubscribed ? undefined : '对端自行声明订阅后即可互通（订阅零门槛）');
+            add('移出状态', blocked.includes(config.device) ? 'FAIL' : blocked.length > 0 ? 'WARN' : 'PASS', blocked.length === 0 ? '无设备被移出' : `blocked=[${blocked.join(', ')}]`, blocked.includes(config.device) ? '本机已被移出：请由其他设备执行 device_restore 后重新订阅' : undefined);
+        }
+        catch (error) {
+            add('namespace 订阅', 'FAIL', `读取本地订阅失败：${error.message}`, '确认存储/主密钥可用');
+        }
+    }
+    // 5.5) W2 守护（仅当 fleet 走 daemon 客户端时检查；embedded 不引入新 SKIP，保持既有验收不变）
+    if (config.daemon?.endpoint !== undefined) {
+        try {
+            const res = await fetch(`${config.daemon.endpoint.replace(/\/+$/, '')}/healthz`);
+            add('守护', res.ok ? 'PASS' : 'FAIL', `${config.daemon.endpoint}（HTTP ${res.status}）`, res.ok ? undefined : '确认 mebular serve 已启动（mebular service install mebular-serve）');
+        }
+        catch (error) {
+            add('守护', 'FAIL', `${config.daemon.endpoint} 不可达`, `启动守护：mebular serve（${error.message}）`);
+        }
+    }
+    // 6) agent 注册表可解析
+    const agentErrors = validateFleetConfig({ ...config, agents: config.agents }).filter((e) => e.startsWith('agent'));
+    try {
+        buildRegistry(config.agents);
+        add('agent 注册表', agentErrors.length === 0 ? 'PASS' : 'FAIL', config.agents.map((a) => `${a.name}:${a.kind}`).join(','), '修正 agents 配置');
+    }
+    catch (error) {
+        add('agent 注册表', 'FAIL', error.message, '修正 agents 配置');
+    }
+    // 7) 同步已收敛（本地是否已见对端署名的任务事件）
+    if (encryption === null) {
+        add('同步已收敛', 'SKIP', '主密钥不可用，跳过');
+    }
+    else {
+        try {
+            const m = new Mebular({ storagePath: config.storagePath, deviceId: config.device, encryption, network: { enabled: false } });
+            await m.initialize();
+            const nodes = (await m.graph.listNodes({ type: 'task_event' }));
+            await m.shutdown();
+            const taskNodes = nodes.filter((n) => n.namespace === config.namespace);
+            if (taskNodes.length === 0) {
+                add('同步已收敛', 'SKIP', '尚无任务事件，无法判断（可在派活后重跑 doctor）');
+            }
+            else {
+                const peerDevices = new Set(config.peers.map((p) => p.device));
+                const authors = taskNodes
+                    .map((n) => n.content?.actor?.device ?? n.content?.author)
+                    .filter((a) => typeof a === 'string');
+                const seen = new Set(authors.filter((a) => peerDevices.has(a)));
+                add('同步已收敛', seen.size > 0 ? 'PASS' : 'FAIL', `对端署名事件：${seen.size}/${peerDevices.size}`, '确认对端在线、已授权且已产生同步');
+            }
+        }
+        catch (error) {
+            add('同步已收敛', 'FAIL', `读取本地状态失败：${error.message}`);
+        }
+    }
+    // 7.4) 2c 重入状态：本机是否已声明某分区重置（图外标记，不同步）。恒 PASS，供审计。
+    const rejoinMarker = `${config.storagePath}.rejoin.${config.namespace}.json`;
+    add('重入状态', 'PASS', (await exists(rejoinMarker)) ? `namespace=${config.namespace} reset=true（已声明重置；下次同步将从零拉取）` : 'reset=false');
+    // 7.5) 2b 交接状态：存在未完成意图（图外 sidecar）→ FAIL（重跑 `fleet leave` 幂等续跑）。
+    const intentPath = `${config.storagePath}.handoff.json`;
+    if (await exists(intentPath)) {
+        add('交接状态', 'FAIL', `存在未完成交接意图：${intentPath}`, '重跑 `fleet leave --successor <id>`（幂等续跑）');
+    }
+    else {
+        add('交接状态', 'PASS', '无未完成交接');
+    }
+    // 8) 服务已注册（D4）：是否有常驻服务**指向本目录**（读 manifest，dir-scoped，temp 目录可复现）。
+    const registered = registeredServicesForDir(dir);
+    if (registered.length === 0) {
+        add('服务已注册', 'SKIP', '未安装常驻服务', 'fleet service install fleet-node|fleet-worker（或 mebular service install）');
+    }
+    else {
+        add('服务已注册', 'PASS', `services=[${registered.join(', ')}]`);
+    }
+    // 9) 心跳新鲜（D4）：process 写 `<dir>/service.heartbeat`；无文件 → SKIP，陈旧 → FAIL。
+    const heartbeat = readHeartbeat(dir);
+    if (heartbeat === null) {
+        add('心跳新鲜', 'SKIP', '无 service.heartbeat（服务未运行/未安装）');
+    }
+    else if (isHeartbeatFresh(dir)) {
+        add('心跳新鲜', 'PASS', `role=${heartbeat.role} pid=${heartbeat.pid} age=${Date.now() - heartbeat.ts}ms sha=${heartbeat.sha}`);
+    }
+    else {
+        add('心跳新鲜', 'FAIL', `心跳陈旧 age=${Date.now() - heartbeat.ts}ms（role=${heartbeat.role} pid=${heartbeat.pid}）`, '服务可能已崩溃：`fleet service status` / `fleet service logs`');
+    }
+    const skipped = checks.filter((c) => c.status === 'SKIP').map((c) => c.name);
+    return { ok: !checks.some((c) => c.status === 'FAIL'), device: config.device, checks, skipped };
+}
+//# sourceMappingURL=onboard.js.map

package/dist/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../src/onboard.ts"],"names":[],"mappings":"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"}

package/dist/protocol/envelope.d.ts

@@ -0,0 +1,94 @@
+/** 协议版本（envelope 线格式版本；改动 = 破坏性，需全端同版本）。 */
+export declare const FLEET_PROTOCOL_VERSION: 1;
+/**
+ * 任务状态（**单调秩**，用于并发/乱序下的确定性收敛）：
+ * - `queued` → `claimed` → `running` → `done` | `failed`
+ * - `done` / `failed` 为**终态**（同秩，平局由 `TERMINAL_PRECEDENCE` 兜底）。
+ */
+export declare const TASK_STATUSES: readonly ["queued", "claimed", "running", "done", "failed"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+/** 状态秩：`done`/`failed` 同秩（终态），其余严格递增。 */
+export declare const STATUS_RANK: Readonly<Record<TaskStatus, number>>;
+/** 终态平局裁决：数值大者胜（确定性）。 */
+export declare const TERMINAL_PRECEDENCE: Readonly<Record<TaskStatus, number>>;
+/** 任务树预算（**W1**）：随树单调递减；root 声明，子任务 ≤ 父剩余。 */
+export interface TaskBudget {
+    /** 允许的最大深度（root 深度 0；链长 = 祖先数） */
+    maxDepth: number;
+    /** 每个父任务可派生的直接子任务上限 */
+    maxChildren: number;
+    /** 整个子树的任务总数上限（含 root） */
+    maxTasks: number;
+}
+/** root 级派发策略：`children-ok`（默认，可派生）| `root-only`（执行者只能干、不得再派）。 */
+export declare const DISPATCH_POLICIES: readonly ["children-ok", "root-only"];
+export type TaskDispatch = (typeof DISPATCH_POLICIES)[number];
+/** root 预算默认值（W1 上界，可由 root 收紧）。 */
+export declare const DEFAULT_ROOT_BUDGET: Readonly<TaskBudget>;
+/** 预算合法性（非负整数；越界由树不变式判定，这里只做形状）。 */
+export declare function isTaskBudget(value: unknown): value is TaskBudget;
+/** 派发策略守卫。 */
+export declare function isTaskDispatch(value: unknown): value is TaskDispatch;
+/** 端标识：设备 + 该设备上的 Agent 名。 */
+export interface FleetEndpoint {
+    device: string;
+    agent: string;
+}
+/** 因果追踪：`causedBy` 指向触发本任务/迁移的父任务；`chain` 为祖先链（去重、有序）。 */
+export interface FleetTrace {
+    causedBy?: string;
+    chain: string[];
+}
+/** 任务 envelope（图上一类记忆的规范化负载）。 */
+export interface TaskEnvelope {
+    /** 协议版本 */
+    v: number;
+    /** 任务唯一 ID（内容寻址前的逻辑 id；由发起方生成） */
+    taskId: string;
+    /** 发起端 */
+    from: FleetEndpoint;
+    /** 目标端（`to.agent` 为 `*` 表示该设备任一 Agent 可领取） */
+    to: FleetEndpoint;
+    /** 意图/指令（人可读；执行语义由执行器解释） */
+    intent: string;
+    /** 负载引用（如 Blob/记忆节点 id；不在 envelope 内联大对象） */
+    payloadRef?: string;
+    /** 当前权威状态（显式状态事件驱动） */
+    status: TaskStatus;
+    /** 已尝试次数（至少一次投递 + 幂等应用；见 M1） */
+    attempts: number;
+    /** **软约定**：仅影响本机任务板展示；不参与跨端状态判定 */
+    expiresAt?: number;
+    /** 因果链 */
+    trace: FleetTrace;
+}
+/** 校验结果。 */
+export interface EnvelopeValidation {
+    ok: boolean;
+    errors: string[];
+}
+/** 端标识守卫（`{device,agent}` 均为非空字符串）。 */
+export declare function isFleetEndpoint(value: unknown): value is FleetEndpoint;
+/** 状态判定。 */
+export declare function isTaskStatus(value: unknown): value is TaskStatus;
+/** 终态判定。 */
+export declare function isTerminal(status: TaskStatus): boolean;
+/**
+ * 确定性状态裁决：返回 `a` / `b` 中更靠后的那个（收敛用，与到达顺序无关）。
+ * 先比 `STATUS_RANK`；同秩（终态）比 `TERMINAL_PRECEDENCE`；再平局取字典序大的状态名。
+ */
+export declare function resolveStatus(a: TaskStatus, b: TaskStatus): TaskStatus;
+/**
+ * 合法迁移表（显式，避免跳级；与 `protocol/state-machine.json` 一致）。
+ * 非法迁移必须被拒绝（M1 负例）。
+ */
+export declare const TASK_TRANSITIONS: Readonly<Record<TaskStatus, readonly TaskStatus[]>>;
+/** 状态是否可迁移（`from === to` 视为幂等自迁移）。 */
+export declare function canTransition(from: TaskStatus, to: TaskStatus): boolean;
+/** 校验一个未知输入是否为合法 `TaskEnvelope`（不做数值语义裁决）。 */
+export declare function validateEnvelope(input: unknown): EnvelopeValidation;
+/** 序列化为**确定序** JSON（同一 envelope → 同一字节串）。 */
+export declare function serializeEnvelope(envelope: TaskEnvelope): string;
+/** 解析并校验；非法输入抛错（错误信息含全部违规项）。 */
+export declare function parseEnvelope(json: string): TaskEnvelope;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/protocol/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/protocol/envelope.ts"],"names":[],"mappings":"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"}