@mebular/fleet 0.0.0-stage → 0.1.0

package/dist/model.js

@@ -0,0 +1,158 @@
+// Fleet 任务模型（M1）：由**显式状态事件**确定性推导权威 `TaskState`。
+//
+// 关键性质（见 PROTOCOL-INVARIANTS.md）：
+// - **顺序无关收敛**：输入事件数组任意排列、任意重复，结果一致；
+// - **至少一次 + 幂等应用**：按 `eventId` 去重，重复投递不改变状态、不重复执行；
+// - **墙钟无关**：`at` / `expiresAt` 不参与权威判定（只做本机展示）。
+import { STATUS_RANK, TERMINAL_PRECEDENCE, isTerminal, canTransition, } from './protocol/envelope.js';
+/** 状态迁移是否合法（显式迁移表；`from === to` 视为幂等自迁移）。 */
+export function validateTaskTransition(from, to) {
+    return canTransition(from, to);
+}
+/** 非法迁移则抛错（本地发起侧用；负例测试）。 */
+export function assertTaskTransition(from, to) {
+    if (!validateTaskTransition(from, to)) {
+        throw new Error(`非法任务状态迁移：${from} → ${to}`);
+    }
+}
+/** 事件“更权威”判定（确定性全序）：状态秩 ↑，再终态平局裁决 ↑，再 `eventId` 字典序 ↑。 */
+function isStronger(a, b) {
+    const rankA = STATUS_RANK[a.toStatus];
+    const rankB = STATUS_RANK[b.toStatus];
+    if (rankA !== rankB)
+        return rankA > rankB;
+    const precA = TERMINAL_PRECEDENCE[a.toStatus];
+    const precB = TERMINAL_PRECEDENCE[b.toStatus];
+    if (precA !== precB)
+        return precA > precB;
+    return a.eventId > b.eventId;
+}
+/** 确定性序列化：对象键递归排序，保证结果与对象构造/解析顺序无关。 */
+function stableStringify(value) {
+    if (value === undefined)
+        return 'null';
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(',')}]`;
+    }
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(',')}}`;
+}
+/**
+ * 去重（按 `eventId`）。同一 `eventId` 对应**不同内容**时（违约/对抗输入），
+ * 按稳定序列化取字典序较大者做**确定性裁决**——使「去重后的集合」本身与输入
+ * 顺序无关，堵住同一 id 不同内容造成的顺序相关分叉（§2.1 顺序无关收敛）。
+ * 契约上 `eventId` 仍应内容寻址或全局唯一；本裁决只是兜底，不改变正常路径。
+ */
+export function dedupeEvents(events) {
+    const byId = new Map();
+    for (const event of events) {
+        const existing = byId.get(event.eventId);
+        if (existing === undefined) {
+            byId.set(event.eventId, event);
+            continue;
+        }
+        if (stableStringify(event) > stableStringify(existing)) {
+            byId.set(event.eventId, event);
+        }
+    }
+    return [...byId.values()];
+}
+/**
+ * 由事件集合推导权威状态（**顺序无关、幂等**）。无 `created` 事件 → 返回 `null`（任务未知）。
+ * 不读取 `at` / `now`（墙钟无关）。
+ */
+export function reduceTaskEvents(events) {
+    const unique = dedupeEvents(events);
+    if (unique.length === 0)
+        return null;
+    let created = null;
+    for (const event of unique) {
+        if (event.type !== 'created')
+            continue;
+        if (created === null || event.eventId < created.eventId)
+            created = event;
+    }
+    if (created === null)
+        return null;
+    let winner = unique[0];
+    for (const event of unique)
+        if (isStronger(event, winner))
+            winner = event;
+    const attempts = unique.reduce((n, e) => (e.type === 'claimed' ? n + 1 : n), 0);
+    const chainSet = new Set();
+    for (const event of unique)
+        for (const id of event.trace.chain)
+            chainSet.add(id);
+    if (created.trace.causedBy !== undefined)
+        chainSet.add(created.trace.causedBy);
+    const chain = [...chainSet].sort();
+    const status = winner.toStatus;
+    const state = {
+        taskId: created.taskId,
+        from: created.actor,
+        to: created.to ?? created.actor,
+        intent: created.intent ?? '',
+        status,
+        attempts,
+        trace: {
+            ...(created.trace.causedBy !== undefined ? { causedBy: created.trace.causedBy } : {}),
+            chain,
+        },
+        terminal: isTerminal(status),
+        lastEventId: winner.eventId,
+    };
+    if (created.payloadRef !== undefined)
+        state.payloadRef = created.payloadRef;
+    if (created.expiresAt !== undefined)
+        state.expiresAt = created.expiresAt;
+    if (winner.type === 'done' && winner.payloadRef !== undefined)
+        state.resultRef = winner.payloadRef;
+    if (winner.type === 'failed' && winner.reason !== undefined)
+        state.reason = winner.reason;
+    if (created.budget !== undefined)
+        state.budget = created.budget;
+    if (created.dispatch !== undefined)
+        state.dispatch = created.dispatch;
+    return state;
+}
+export class IdempotentTaskApplier {
+    byTask = new Map();
+    /** 应用一个事件（首次返回 applied=true；重复返回 applied=false）。 */
+    apply(event) {
+        let map = this.byTask.get(event.taskId);
+        if (map === undefined) {
+            map = new Map();
+            this.byTask.set(event.taskId, map);
+        }
+        if (map.has(event.eventId)) {
+            return { applied: false, state: reduceTaskEvents([...map.values()]) };
+        }
+        map.set(event.eventId, event);
+        return { applied: true, state: reduceTaskEvents([...map.values()]) };
+    }
+    hasApplied(taskId, eventId) {
+        return this.byTask.get(taskId)?.has(eventId) ?? false;
+    }
+    /** 是否应执行该事件对应的工作（非 `created` 且未应用过）——保证「重复投递不重复执行」。 */
+    shouldExecute(event) {
+        return event.type !== 'created' && !this.hasApplied(event.taskId, event.eventId);
+    }
+    eventsOf(taskId) {
+        return [...(this.byTask.get(taskId)?.values() ?? [])];
+    }
+    state(taskId) {
+        const events = this.byTask.get(taskId);
+        return events === undefined ? null : reduceTaskEvents([...events.values()]);
+    }
+    taskIds() {
+        return [...this.byTask.keys()].sort();
+    }
+}
+/** 本机展示用：是否已过期（**advisory**，不参与权威判定）。 */
+export function isExpiredLocally(expiresAt, now) {
+    return expiresAt !== undefined && now >= expiresAt;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/onboard.d.ts

@@ -0,0 +1,90 @@
+import { Mebular, type NamespaceHandoffPlan, type NamespaceHandoffResult, type NamespaceRejoinResult } from '@mebular/core';
+import { type FleetAgentConfig, type FleetConfig, type FleetEncryption, type OnboardInput, type OnboardResult } from './config.js';
+import { ExecutorRegistry } from './runtime/agent.js';
+/** 由 agent 配置构建执行器注册表（未知 kind 已在校验期拒绝）。 */
+export declare function buildRegistry(agents: readonly FleetAgentConfig[]): ExecutorRegistry;
+/** 由配置 + 加密材料构造 core `Mebular` 选项（订阅自主；对端自行声明）。 */
+export declare function mebularOptions(config: FleetConfig, encryption: FleetEncryption): Record<string, unknown>;
+/** 离线（不启网络）`Mebular` 选项：onboard/doctor/subscribe 用，只读写本地存储。 */
+export declare function offlineMebularOptions(config: FleetConfig, encryption: FleetEncryption): Record<string, unknown>;
+/** 生成/导入主密钥并写配置；幂等（重复执行不损坏身份）。 */
+export declare function onboardDevice(input: OnboardInput): Promise<OnboardResult>;
+/**
+ * 本机订阅/退订某记忆域（**只能改自己**；写 `namespace_subscription` 到 `__policy__`）。
+ * `active=false` 只退订，不清本地数据；退出并交接走 `leaveNamespace`。
+ *
+ * `mebular`：运行中 daemon 的 live app（可选）；提供时写入同一 EventLog，不另开离线实例。
+ */
+export declare function subscribeNamespace(dir: string, input: {
+    namespace?: string;
+    active?: boolean;
+    note?: string;
+    mebular?: Mebular;
+}): Promise<{
+    member: string;
+    namespace: string;
+    active: boolean;
+    eventId: string;
+}>;
+/** 某分区的 active 订阅者（只读）。 */
+export declare function namespaceSubscribers(dir: string, namespace?: string): Promise<string[]>;
+/** 某分区订阅视图（只读）。 */
+export declare function namespaceSubscriptions(dir: string, namespace?: string): Promise<{
+    active: boolean;
+    subscribers: string[];
+}>;
+/** 建域（零门槛）：写 `namespace_declare`；不自动订阅。`mebular` 为运行中 daemon 的 live app（可选）。 */
+export declare function declareNamespace(dir: string, input: {
+    namespace: string;
+    note?: string;
+    mebular?: Mebular;
+}): Promise<{
+    namespace: string;
+    eventId: string;
+}>;
+/** 恢复被移出的设备（写 `device_restore`；high 档证明由调用方给出）。 */
+export declare function restoreDevice(dir: string, input: {
+    subject: string;
+    note?: string;
+    nonce?: string;
+    cosign?: unknown;
+    breakGlass?: unknown;
+}): Promise<{
+    subject: string;
+    eventId: string;
+}>;
+/** 重订阅恢复（准入：曾订阅 ∧ 未被移出；写图外 reset 标记）。 */
+export declare function rejoinNamespace(dir: string, input?: {
+    namespace?: string;
+}): Promise<NamespaceRejoinResult>;
+/** 本机是否已声明某分区重置（读图外标记）。只读。 */
+export declare function rejoinReset(dir: string, namespace?: string): Promise<boolean>;
+/** 交接前置校验（只读）——继任者是否订阅且已 ack 本机在该分区的全部事件。 */
+export declare function planHandoff(dir: string, input: {
+    namespace?: string;
+    successor: string;
+}): Promise<NamespaceHandoffPlan>;
+/** 退出并交接（默认要求继任者全量 ack；`force` 仅本地 CLI，仍如实记录）。 */
+export declare function leaveNamespace(dir: string, input: {
+    namespace?: string;
+    successor: string;
+    force?: boolean;
+    note?: string;
+}): Promise<NamespaceHandoffResult>;
+/** `WARN` = 非致命告警（不使 `ok=false`），用于暴露加固/运维风险。 */
+export type DoctorStatus = 'PASS' | 'FAIL' | 'SKIP' | 'WARN';
+export interface DoctorCheck {
+    name: string;
+    status: DoctorStatus;
+    detail: string;
+    hint?: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    device: string;
+    checks: DoctorCheck[];
+    skipped: string[];
+}
+/** 逐项自检；默认脱敏（不含任何密钥材料）。 */
+export declare function doctor(dir: string): Promise<DoctorReport>;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/onboard.d.ts.map

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