@mclawnet/swarm 0.1.11 → 0.1.13

package/dist/__tests__/sync-plan-status.test.js

@@ -0,0 +1,198 @@
+/**
+ * PR#1 — replaced subject-prefix heuristic with explicit planTaskId foreign
+ * key. SwarmCoordinator.syncPlanStatusFromTasks now groups live tasks by
+ * planTaskId and uses pickStrongestStatus to fold many→one. Live tasks with
+ * no planTaskId are ignored (don't influence plan); plan nodes with no
+ * matching live task keep queen's original status (no break for in-flight
+ * swarms where queen hasn't called task_create yet, or hasn't been retrained
+ * to pass planTaskId).
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+vi.mock("@mclawnet/logger", () => ({
+    createLogger: () => ({
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    }),
+}));
+const saveSwarmSnapshotMock = vi.fn();
+vi.mock("../persistence.js", () => ({
+    saveSwarmSnapshot: (...args) => saveSwarmSnapshotMock(...args),
+    deleteSwarmSnapshot: vi.fn(),
+    appendMessageLog: vi.fn(),
+    loadSwarmSnapshot: vi.fn(),
+    listRecoverableSwarmIds: vi.fn(() => []),
+    readMessageLog: vi.fn(() => []),
+}));
+vi.mock("../retrospective.js", () => ({
+    runRetrospective: vi.fn(async () => ({})),
+}));
+import { SwarmCoordinator } from "../swarm-coordinator.js";
+function makeAdapter() {
+    return {
+        createSession: vi.fn(async (options) => `proc-${options.sessionId}`),
+        sendInput: vi.fn(),
+        closeSession: vi.fn(async () => { }),
+    };
+}
+/** Fake TaskStore mirroring the listBySwarm shape used by the coordinator. */
+function makeTaskStore(tasks) {
+    return {
+        listBySwarm: vi.fn((swarmId) => tasks.filter((t) => t.swarmId === swarmId)),
+    };
+}
+describe("SwarmCoordinator — syncPlanStatusFromTasks via planTaskId (PR#1)", () => {
+    let tmpHome;
+    let hub;
+    beforeEach(() => {
+        tmpHome = mkdtempSync(join(tmpdir(), "clawnet-test-"));
+        process.env.CLAWNET_HOME = tmpHome;
+        saveSwarmSnapshotMock.mockReset();
+        hub = { send: vi.fn() };
+    });
+    afterEach(() => {
+        delete process.env.CLAWNET_HOME;
+        rmSync(tmpHome, { recursive: true, force: true });
+    });
+    async function makeCoord(swarmId, taskStore) {
+        const coordinator = new SwarmCoordinator(makeAdapter(), hub, () => taskStore);
+        await coordinator.create(swarmId, {
+            workDir: `/tmp/${swarmId}`,
+            roles: [{ roleName: "queen", count: 1, eager: true }],
+            task: "test",
+        });
+        return coordinator;
+    }
+    it("syncs plan.status from live tasks joined by planTaskId", async () => {
+        const swarmId = "sw-fk-basic";
+        const taskStore = makeTaskStore([
+            { swarmId, planTaskId: "t1", status: "completed" },
+            { swarmId, planTaskId: "t2", status: "in_progress" },
+            { swarmId, planTaskId: "t3", status: "pending" },
+        ]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = {
+            phases: [
+                {
+                    name: "p",
+                    tasks: [
+                        { id: "t1", status: "pending" },
+                        { id: "t2", status: "pending" },
+                        { id: "t3", status: "pending" },
+                    ],
+                },
+            ],
+        };
+        coordinator.persistSwarm(swarm);
+        const saved = saveSwarmSnapshotMock.mock.calls[0][0];
+        const tasks = saved.plan.phases[0].tasks;
+        expect(tasks[0].status).toBe("completed");
+        expect(tasks[1].status).toBe("in_progress");
+        expect(tasks[2].status).toBe("pending");
+    });
+    it("ignores live tasks without planTaskId (backward compat for ad-hoc tasks)", async () => {
+        const swarmId = "sw-fk-noid";
+        const taskStore = makeTaskStore([
+            // Queen forgot to set planTaskId — sync must NOT silently match by
+            // subject prefix. Plan node t1 should keep its original "pending".
+            { swarmId, status: "completed", subject: "t1 done somehow" },
+        ]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = {
+            phases: [{ name: "p", tasks: [{ id: "t1", status: "pending" }] }],
+        };
+        coordinator.persistSwarm(swarm);
+        const tasks = saveSwarmSnapshotMock.mock.calls[0][0].plan.phases[0].tasks;
+        expect(tasks[0].status).toBe("pending");
+    });
+    it("folds many live tasks per plan id with pickStrongestStatus", async () => {
+        const swarmId = "sw-fk-fold";
+        const taskStore = makeTaskStore([
+            // Queen retried t1 twice: one cancelled, one in_progress.
+            // Strongest wins → in_progress.
+            { swarmId, planTaskId: "t1", status: "cancelled" },
+            { swarmId, planTaskId: "t1", status: "in_progress" },
+            // Any completed dominates.
+            { swarmId, planTaskId: "t2", status: "pending" },
+            { swarmId, planTaskId: "t2", status: "completed" },
+        ]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = {
+            phases: [
+                {
+                    name: "p",
+                    tasks: [
+                        { id: "t1", status: "pending" },
+                        { id: "t2", status: "pending" },
+                    ],
+                },
+            ],
+        };
+        coordinator.persistSwarm(swarm);
+        const tasks = saveSwarmSnapshotMock.mock.calls[0][0].plan.phases[0].tasks;
+        expect(tasks[0].status).toBe("in_progress");
+        expect(tasks[1].status).toBe("completed");
+    });
+    it("leaves plan node untouched when no live task matches the planTaskId", async () => {
+        const swarmId = "sw-fk-nomatch";
+        const taskStore = makeTaskStore([
+            { swarmId, planTaskId: "t1", status: "completed" },
+            // t2 not yet created.
+        ]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = {
+            phases: [
+                {
+                    name: "p",
+                    tasks: [
+                        { id: "t1", status: "pending" },
+                        { id: "t2", status: "pending" },
+                    ],
+                },
+            ],
+        };
+        coordinator.persistSwarm(swarm);
+        const tasks = saveSwarmSnapshotMock.mock.calls[0][0].plan.phases[0].tasks;
+        expect(tasks[0].status).toBe("completed");
+        expect(tasks[1].status).toBe("pending");
+    });
+    it("is a no-op when swarm.plan is null", async () => {
+        const swarmId = "sw-fk-noplan";
+        const taskStore = makeTaskStore([]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = null;
+        saveSwarmSnapshotMock.mockClear();
+        expect(() => coordinator.persistSwarm(swarm)).not.toThrow();
+        expect(saveSwarmSnapshotMock).toHaveBeenCalledTimes(1);
+        expect(saveSwarmSnapshotMock.mock.calls[0][0].plan).toBeNull();
+    });
+    it("syncs across multiple phases", async () => {
+        const swarmId = "sw-fk-multiphase";
+        const taskStore = makeTaskStore([
+            { swarmId, planTaskId: "t1", status: "completed" },
+            { swarmId, planTaskId: "t2", status: "in_progress" },
+        ]);
+        const coordinator = await makeCoord(swarmId, taskStore);
+        const swarm = coordinator.swarms.get(swarmId);
+        swarm.plan = {
+            phases: [
+                { name: "p1", tasks: [{ id: "t1", status: "pending" }] },
+                { name: "p2", tasks: [{ id: "t2", status: "pending" }] },
+            ],
+        };
+        coordinator.persistSwarm(swarm);
+        const phases = saveSwarmSnapshotMock.mock.calls[0][0].plan.phases;
+        expect(phases[0].tasks[0].status).toBe("completed");
+        expect(phases[1].tasks[0].status).toBe("in_progress");
+    });
+});
+//# sourceMappingURL=sync-plan-status.test.js.map

package/dist/__tests__/sync-plan-status.test.js.map

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

package/dist/__tests__/template-loader-editor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template-loader-editor.test.d.ts.map

package/dist/__tests__/template-loader-editor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader-editor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/template-loader-editor.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/template-loader-editor.test.js

@@ -0,0 +1,156 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { listTemplatesWithSource, getTemplateSource, getTemplateRaw, saveTemplate, deleteTemplate, } from "../templates/template-loader.js";
+describe("template-loader editor API", () => {
+    let tmp;
+    let prevHome;
+    const validRaw = `---
+name: alpha
+displayName: Alpha
+description: Alpha template
+roles:
+  - roleName: queen
+    count: 1
+    eager: true
+---
+
+Body.`;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "clawnet-tpl-"));
+        prevHome = process.env.CLAWNET_HOME;
+        process.env.CLAWNET_HOME = tmp;
+        mkdirSync(join(tmp, "templates"), { recursive: true });
+    });
+    afterEach(() => {
+        if (prevHome === undefined)
+            delete process.env.CLAWNET_HOME;
+        else
+            process.env.CLAWNET_HOME = prevHome;
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    describe("listTemplatesWithSource", () => {
+        it("tags user-only templates as 'user' and presets as 'preset'", () => {
+            writeFileSync(join(tmp, "templates", "myteam.md"), validRaw, "utf-8");
+            const items = listTemplatesWithSource();
+            const my = items.find((i) => i.name === "myteam");
+            expect(my).toEqual({ name: "myteam", source: "user" });
+            const dev = items.find((i) => i.name === "dev-team");
+            expect(dev?.source).toBe("preset");
+        });
+        it("a user file shadowing a preset wins and is flagged shadowsPreset (legacy / stale state — saveTemplate now refuses such writes)", () => {
+            const overrideRaw = validRaw.replace("name: alpha", "name: dev-team");
+            writeFileSync(join(tmp, "templates", "dev-team.md"), overrideRaw, "utf-8");
+            const items = listTemplatesWithSource();
+            const dev = items.find((i) => i.name === "dev-team");
+            expect(dev?.source).toBe("user");
+            expect(dev?.shadowsPreset).toBe(true);
+        });
+        it("user-only entries do not set shadowsPreset", () => {
+            writeFileSync(join(tmp, "templates", "myteam.md"), validRaw, "utf-8");
+            const items = listTemplatesWithSource();
+            const my = items.find((i) => i.name === "myteam");
+            expect(my?.shadowsPreset).toBeUndefined();
+        });
+    });
+    describe("getTemplateSource", () => {
+        it("returns null for unknown names", () => {
+            expect(getTemplateSource("does-not-exist-xyz")).toBeNull();
+        });
+        it("returns 'preset' for built-ins", () => {
+            expect(getTemplateSource("dev-team")).toBe("preset");
+        });
+        it("returns 'user' when a user file shadows a preset name (legacy state)", () => {
+            const overrideRaw = validRaw.replace("name: alpha", "name: dev-team");
+            writeFileSync(join(tmp, "templates", "dev-team.md"), overrideRaw, "utf-8");
+            expect(getTemplateSource("dev-team")).toBe("user");
+        });
+    });
+    describe("saveTemplate", () => {
+        it("writes a valid template and reports source", () => {
+            const src = saveTemplate("beta", validRaw.replace("alpha", "beta"));
+            expect(src).toBe("user");
+            expect(existsSync(join(tmp, "templates", "beta.md"))).toBe(true);
+        });
+        it("rejects invalid YAML before writing", () => {
+            expect(() => saveTemplate("bad", "no frontmatter")).toThrow(/missing YAML frontmatter/);
+            expect(existsSync(join(tmp, "templates", "bad.md"))).toBe(false);
+        });
+        it("rejects bad names", () => {
+            expect(() => saveTemplate("../escape", validRaw)).toThrow(/Invalid/);
+            expect(() => saveTemplate("with space", validRaw)).toThrow(/Invalid/);
+        });
+        it("rejects name longer than 64 chars", () => {
+            const long = "a".repeat(65);
+            expect(() => saveTemplate(long, validRaw)).toThrow(/Invalid/);
+        });
+        it("rejects frontmatter name mismatch", () => {
+            expect(() => saveTemplate("beta", validRaw)).toThrow(/does not match/);
+        });
+        it("refuses to save under a preset name (presets are immutable)", () => {
+            const overrideRaw = validRaw.replace("name: alpha", "name: dev-team");
+            expect(() => saveTemplate("dev-team", overrideRaw)).toThrow(/conflicts with a built-in preset/);
+            // File never touched
+            expect(existsSync(join(tmp, "templates", "dev-team.md"))).toBe(false);
+        });
+    });
+    describe("getTemplateRaw", () => {
+        it("returns preset raw when only a preset exists", () => {
+            const raw = getTemplateRaw("dev-team");
+            expect(raw).toContain("name: dev-team");
+        });
+        it("returns user raw when a user file shadows the preset (legacy state)", () => {
+            const overrideRaw = validRaw.replace("name: alpha", "name: dev-team");
+            writeFileSync(join(tmp, "templates", "dev-team.md"), overrideRaw, "utf-8");
+            expect(getTemplateRaw("dev-team")).toBe(overrideRaw);
+        });
+        it("returns null for unknown", () => {
+            expect(getTemplateRaw("nope-xyz")).toBeNull();
+        });
+    });
+    describe("deleteTemplate", () => {
+        it("removes user file and reports preset fallback availability", () => {
+            saveTemplate("beta", validRaw.replace("alpha", "beta"));
+            const r1 = deleteTemplate("beta");
+            expect(r1.fellBackToPreset).toBe(false);
+            expect(existsSync(join(tmp, "templates", "beta.md"))).toBe(false);
+        });
+        it("deleting a legacy user-shadow file exposes the preset again", () => {
+            // Simulate a stale user copy left over from the old seed behaviour.
+            const overrideRaw = validRaw.replace("name: alpha", "name: dev-team");
+            writeFileSync(join(tmp, "templates", "dev-team.md"), overrideRaw, "utf-8");
+            const r = deleteTemplate("dev-team");
+            expect(r.fellBackToPreset).toBe(true);
+            const presetRaw = getTemplateRaw("dev-team");
+            expect(presetRaw).not.toBe(overrideRaw);
+            expect(presetRaw).toContain("name: dev-team");
+        });
+        it("deleting a non-existent user file is a no-op", () => {
+            const r = deleteTemplate("never-existed-xyz");
+            expect(r.fellBackToPreset).toBe(false);
+        });
+    });
+    describe("path traversal hardening", () => {
+        it.each([
+            "../",
+            "..",
+            "../escape",
+            "/etc/passwd",
+            "with space",
+            "name\0null",
+            "",
+        ])("rejects %s on get / source / delete", (bad) => {
+            expect(() => getTemplateSource(bad)).toThrow();
+            expect(() => getTemplateRaw(bad)).toThrow();
+            expect(() => deleteTemplate(bad)).toThrow();
+        });
+        it("rejects non-string names", () => {
+            // @ts-expect-error
+            expect(() => getTemplateSource(null)).toThrow();
+            // @ts-expect-error
+            expect(() => deleteTemplate(42)).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=template-loader-editor.test.js.map

package/dist/__tests__/template-loader-editor.test.js.map

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

package/dist/__tests__/wakeup-end-to-end.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wakeup-end-to-end.test.d.ts.map

package/dist/__tests__/wakeup-end-to-end.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup-end-to-end.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/wakeup-end-to-end.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/wakeup-end-to-end.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect, vi } from "vitest";
+import { mkdtempSync, utimesSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { projectRoot } from "@mclawnet/task";
+import { InboxStore } from "../inbox-store.js";
+import { InboxWatcher } from "../inbox-watcher.js";
+import { WakeupScheduler } from "../wakeup-scheduler.js";
+// M5 hotfix I2: every link in the cross-process wake path had a unit test
+// but the chain didn't. A future refactor that breaks the notBefore filter
+// or the InboxWatcher debounce wouldn't be caught. This drives the real
+// classes end-to-end with real timers, real fs.watch, real utimesSync.
+//
+// Spec: scheduler timer fires -> touch mtime -> InboxWatcher (50ms debounce)
+//       -> relay.deliver picks up the notBefore-now-due message.
+describe("self-wakeup end-to-end (cross-class)", () => {
+    // fs.watch({recursive:true}) is unreliable on Linux pre-20 (shallow watch);
+    // and even on supported platforms CI throughput can race the 600ms budget.
+    // Skip on Linux to keep this test deterministic. macOS / Windows exercise
+    // the full chain; that's enough to catch regressions in InboxWatcher /
+    // InboxRelay / notBefore filter coordination.
+    const maybeIt = process.platform === "linux" ? it.skip : it;
+    maybeIt("scheduler -> touch -> InboxWatcher -> relay.deliver chain", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wue2e-"));
+        process.env.CLAWNET_HOME = home;
+        const swarmId = "s1";
+        const instanceId = "w0";
+        const workDir = mkdtempSync(join(tmpdir(), "wue2e-wd-"));
+        try {
+            // 1. Seed a notBefore-future inbox message
+            const store = new InboxStore(workDir, swarmId, home);
+            const notBefore = Date.now() + 200;
+            await store.append(instanceId, {
+                id: "m1", from: "self", type: "wakeup", data: "ping",
+                timestamp: Date.now(), delivered: false, notBefore,
+            });
+            // 2. Real InboxWatcher with a deliver spy that drains undelivered
+            const delivered = [];
+            const deliver = vi.fn(async (s, i) => {
+                delivered.push([s, i]);
+                const st = new InboxStore(workDir, swarmId, home);
+                const msgs = await st.readUndelivered(i);
+                if (msgs.length > 0)
+                    await st.markDelivered(i, msgs.map(m => m.id));
+            });
+            const watcher = new InboxWatcher({ deliver });
+            watcher.watch(swarmId, workDir);
+            // 3. Real touch-relay (inline; 3-line equivalent of InboxTouchRelay so
+            //    swarm pkg doesn't reverse-depend on mcp-server)
+            const touchRelay = {
+                deliver: (s, i) => {
+                    const fp = join(projectRoot(workDir, home), "swarms", s, "inboxes", `${i}.json`);
+                    const now = new Date();
+                    try {
+                        utimesSync(fp, now, now);
+                    }
+                    catch { /* best-effort */ }
+                },
+            };
+            // 4. Real scheduler -> register the future wakeup
+            const scheduler = new WakeupScheduler(touchRelay);
+            scheduler.register(swarmId, instanceId, notBefore);
+            // 5. Wait past notBefore + InboxWatcher debounce (50ms) + margin.
+            //    Real timers — no fakes — because fs.watch and setTimeout must run
+            //    in the same real-time domain to produce a deterministic chain.
+            await new Promise(r => setTimeout(r, 600));
+            expect(deliver).toHaveBeenCalled();
+            expect(delivered.some(([s, i]) => s === swarmId && i === instanceId)).toBe(true);
+            // Sanity: the message should now be marked delivered
+            const remaining = await new InboxStore(workDir, swarmId, home).readUndelivered(instanceId);
+            expect(remaining).toHaveLength(0);
+            watcher.close();
+            scheduler.dispose();
+        }
+        finally {
+            delete process.env.CLAWNET_HOME;
+        }
+    }, 5_000);
+});
+//# sourceMappingURL=wakeup-end-to-end.test.js.map

package/dist/__tests__/wakeup-end-to-end.test.js.map

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

package/dist/__tests__/wakeup-scheduler-restore-fires.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wakeup-scheduler-restore-fires.test.d.ts.map

package/dist/__tests__/wakeup-scheduler-restore-fires.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup-scheduler-restore-fires.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/wakeup-scheduler-restore-fires.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/wakeup-scheduler-restore-fires.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { WakeupScheduler } from "../wakeup-scheduler.js";
+// M5 hotfix C1 regression: not only that restoreFromInbox re-registers a
+// timer, but that the timer then actually invokes the passed relay.deliver.
+// This proves the agent-side wiring path delivers a notBefore-future message
+// without waiting for an external fs event.
+describe("WakeupScheduler.restoreFromInbox — timer fires into real relay", () => {
+    beforeEach(() => { vi.useFakeTimers(); });
+    afterEach(() => { vi.useRealTimers(); });
+    it("fires relay.deliver(swarmId, instanceId) after notBefore elapses", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wsrf-"));
+        const inboxDir = join(home, ".clawnet", "projects", "wd-encoded", "swarms", "s1", "inboxes");
+        mkdirSync(inboxDir, { recursive: true });
+        const future = Date.now() + 5_000;
+        writeFileSync(join(inboxDir, "w0.json"), JSON.stringify([
+            { id: "m1", from: "self", type: "wakeup", data: "x", timestamp: 0, delivered: false, notBefore: future },
+        ]));
+        const deliver = vi.fn();
+        const sched = new WakeupScheduler({ deliver });
+        await sched.restoreFromInbox(home, [{ swarmId: "s1", workDir: "/wd/src" }], {
+            projectRootFor: () => join(home, ".clawnet", "projects", "wd-encoded"),
+        });
+        expect(sched.size()).toBe(1);
+        expect(deliver).not.toHaveBeenCalled();
+        await vi.advanceTimersByTimeAsync(5_001);
+        expect(deliver).toHaveBeenCalledWith("s1", "w0");
+        sched.dispose();
+    });
+});
+//# sourceMappingURL=wakeup-scheduler-restore-fires.test.js.map

package/dist/__tests__/wakeup-scheduler-restore-fires.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup-scheduler-restore-fires.test.js","sourceRoot":"","sources":["../../src/__tests__/wakeup-scheduler-restore-fires.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,4CAA4C;AAC5C,QAAQ,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC9E,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7F,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAClC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YACtD,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE;SACzG,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE;YAC1E,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC;SACvE,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAEvC,MAAM,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/wakeup-scheduler-restore.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wakeup-scheduler-restore.test.d.ts.map

package/dist/__tests__/wakeup-scheduler-restore.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup-scheduler-restore.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/wakeup-scheduler-restore.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/wakeup-scheduler-restore.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, vi } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { WakeupScheduler } from "../wakeup-scheduler.js";
+describe("WakeupScheduler.restoreFromInbox", () => {
+    it("re-registers timers for future notBefore messages on disk", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wsr-"));
+        const inboxDir = join(home, ".clawnet", "projects", "wd-encoded", "swarms", "s1", "inboxes");
+        mkdirSync(inboxDir, { recursive: true });
+        const future = Date.now() + 60_000;
+        writeFileSync(join(inboxDir, "w0.json"), JSON.stringify([
+            { id: "m1", from: "self", type: "wakeup", data: "x", timestamp: 0, delivered: false, notBefore: future },
+            { id: "m2", from: "self", type: "wakeup", data: "y", timestamp: 0, delivered: false, notBefore: Date.now() - 1000 },
+            { id: "m3", from: "self", type: "wakeup", data: "z", timestamp: 0, delivered: true, notBefore: future },
+        ]));
+        const sched = new WakeupScheduler({ deliver: vi.fn() });
+        await sched.restoreFromInbox(home, [{ swarmId: "s1", workDir: "/wd/src" }], {
+            projectRootFor: () => join(home, ".clawnet", "projects", "wd-encoded"),
+        });
+        expect(sched.size()).toBe(1);
+        sched.dispose();
+    });
+    it("does nothing when inbox directory is missing", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wsr-"));
+        const sched = new WakeupScheduler({ deliver: vi.fn() });
+        await sched.restoreFromInbox(home, [{ swarmId: "missing", workDir: "/no/such" }], {
+            projectRootFor: () => join(home, ".clawnet", "projects", "missing"),
+        });
+        expect(sched.size()).toBe(0);
+        sched.dispose();
+    });
+    it("skips corrupt JSON inbox files", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wsr-"));
+        const inboxDir = join(home, ".clawnet", "projects", "wd-encoded", "swarms", "s1", "inboxes");
+        mkdirSync(inboxDir, { recursive: true });
+        writeFileSync(join(inboxDir, "broken.json"), "{not json");
+        const sched = new WakeupScheduler({ deliver: vi.fn() });
+        await sched.restoreFromInbox(home, [{ swarmId: "s1", workDir: "/x" }], {
+            projectRootFor: () => join(home, ".clawnet", "projects", "wd-encoded"),
+        });
+        expect(sched.size()).toBe(0);
+        sched.dispose();
+    });
+    // Defensive: external/malformed inbox files must not crash startup.
+    it("skips non-array JSON, non-object entries, and pathological .json filename", async () => {
+        const home = mkdtempSync(join(tmpdir(), "wsr-"));
+        const inboxDir = join(home, ".clawnet", "projects", "wd-encoded", "swarms", "s1", "inboxes");
+        mkdirSync(inboxDir, { recursive: true });
+        writeFileSync(join(inboxDir, "object.json"), JSON.stringify({ not: "an array" }));
+        writeFileSync(join(inboxDir, "nullarr.json"), JSON.stringify([null, 42, "string"]));
+        writeFileSync(join(inboxDir, ".json"), JSON.stringify([{ delivered: false, notBefore: Date.now() + 1000 }]));
+        writeFileSync(join(inboxDir, "noext.txt"), "ignored");
+        const sched = new WakeupScheduler({ deliver: vi.fn() });
+        await sched.restoreFromInbox(home, [{ swarmId: "s1", workDir: "/x" }], {
+            projectRootFor: () => join(home, ".clawnet", "projects", "wd-encoded"),
+        });
+        expect(sched.size()).toBe(0); // every file got rejected defensively
+        sched.dispose();
+    });
+});
+//# sourceMappingURL=wakeup-scheduler-restore.test.js.map

package/dist/__tests__/wakeup-scheduler-restore.test.js.map

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

package/dist/__tests__/wakeup-scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wakeup-scheduler.test.d.ts.map

package/dist/__tests__/wakeup-scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeup-scheduler.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/wakeup-scheduler.test.ts"],"names":[],"mappings":""}