@rubytech/create-realagent-code 0.1.604 → 0.1.605

package/payload/platform/plugins/email/mcp/dist/sampler/__tests__/retention.test.js

@@ -0,0 +1,233 @@
+import { describe, it, expect, vi } from "vitest";
+import { resolveRetentionDays, cutoffIso, interestedSets, partitionAged, runRetention, sweepAccount, RETENTION_CANDIDATE_CAP, RETENTION_MAX_DAYS, } from "../retention.js";
+describe("resolveRetentionDays", () => {
+    it("returns null when unset", () => {
+        expect(resolveRetentionDays({})).toBeNull();
+    });
+    it("returns null for zero, negative, fractional and unparseable values", () => {
+        for (const v of ["0", "-1", "30.5", "abc", "", " "]) {
+            expect(resolveRetentionDays({ EMAIL_RETENTION_DAYS: v })).toBeNull();
+        }
+    });
+    it("returns the positive integer day count", () => {
+        expect(resolveRetentionDays({ EMAIL_RETENTION_DAYS: "30" })).toBe(30);
+    });
+    it("refuses a period large enough to overflow the cutoff date", () => {
+        expect(resolveRetentionDays({ EMAIL_RETENTION_DAYS: "100000000000" })).toBeNull();
+        expect(resolveRetentionDays({ EMAIL_RETENTION_DAYS: String(RETENTION_MAX_DAYS + 1) })).toBeNull();
+        expect(resolveRetentionDays({ EMAIL_RETENTION_DAYS: String(RETENTION_MAX_DAYS) })).toBe(RETENTION_MAX_DAYS);
+    });
+    it("keeps every accepted period inside the range cutoffIso can express", () => {
+        expect(() => cutoffIso(new Date("2026-08-13T09:00:00.000Z"), RETENTION_MAX_DAYS)).not.toThrow();
+    });
+});
+describe("cutoffIso", () => {
+    it("subtracts whole days from the clock in the ISO shape createdAt uses", () => {
+        expect(cutoffIso(new Date("2026-08-13T09:00:00.000Z"), 30)).toBe("2026-07-14T09:00:00.000Z");
+    });
+});
+describe("interestedSets", () => {
+    const args = (checks) => JSON.stringify({ eventId: "ignored", checks });
+    it("splits routines by the label their graph-unflagged check names", () => {
+        const rows = [
+            { eventId: "ev-sec", gateArgs: args([{ type: "graph-unflagged", label: "Section" }]) },
+            { eventId: "ev-arc", gateArgs: args([{ type: "graph-unflagged", label: "ConversationArchive" }]) },
+        ];
+        expect(interestedSets(rows)).toEqual({ section: ["ev-sec"], archive: ["ev-arc"] });
+    });
+    it("puts a routine holding both checks in both sets", () => {
+        const rows = [
+            {
+                eventId: "ev-both",
+                gateArgs: args([
+                    { type: "graph-unflagged", label: "Section" },
+                    { type: "graph-unflagged", label: "ConversationArchive" },
+                ]),
+            },
+        ];
+        expect(interestedSets(rows)).toEqual({ section: ["ev-both"], archive: ["ev-both"] });
+    });
+    it("ignores checks of other types and labels outside the accepted pair", () => {
+        const rows = [
+            { eventId: "ev-mail", gateArgs: args([{ type: "mail", mailbox: "a@b.c" }]) },
+            { eventId: "ev-odd", gateArgs: args([{ type: "graph-unflagged", label: "Person" }]) },
+        ];
+        expect(interestedSets(rows)).toEqual({ section: [], archive: [] });
+    });
+    it("contributes nothing and does not throw on absent or malformed gateArgs", () => {
+        const rows = [
+            { eventId: "ev-null", gateArgs: null },
+            { eventId: "ev-bad", gateArgs: "{not json" },
+            { eventId: "ev-nochecks", gateArgs: JSON.stringify({ eventId: "x" }) },
+            { eventId: "ev-checksnotarray", gateArgs: JSON.stringify({ checks: "Section" }) },
+        ];
+        expect(interestedSets(rows)).toEqual({ section: [], archive: [] });
+    });
+    it("names a routine once per set even when it repeats the same check", () => {
+        const rows = [
+            {
+                eventId: "ev-dup",
+                gateArgs: args([
+                    { type: "graph-unflagged", label: "Section" },
+                    { type: "graph-unflagged", label: "Section" },
+                ]),
+            },
+        ];
+        expect(interestedSets(rows)).toEqual({ section: ["ev-dup"], archive: [] });
+    });
+});
+describe("partitionAged", () => {
+    const aged = (over = {}) => ({
+        id: "s1",
+        processedBy: [],
+        parentProcessedBy: [],
+        ...over,
+    });
+    it("prunes a section every interested routine has flagged", () => {
+        const rows = [aged({ processedBy: ["ev-a", "ev-b"], parentProcessedBy: ["ev-c"] })];
+        expect(partitionAged(rows, { section: ["ev-a", "ev-b"], archive: ["ev-c"] })).toEqual({
+            prunable: ["s1"],
+            keptOutstanding: 0,
+        });
+    });
+    it("keeps a section with one section-gated routine still outstanding", () => {
+        const rows = [aged({ processedBy: ["ev-a"] })];
+        expect(partitionAged(rows, { section: ["ev-a", "ev-b"], archive: [] })).toEqual({
+            prunable: [],
+            keptOutstanding: 1,
+        });
+    });
+    it("keeps a fully section-flagged node whose parent archive is outstanding", () => {
+        const rows = [aged({ processedBy: ["ev-a"], parentProcessedBy: [] })];
+        expect(partitionAged(rows, { section: ["ev-a"], archive: ["ev-c"] })).toEqual({
+            prunable: [],
+            keptOutstanding: 1,
+        });
+    });
+    it("keeps a section that has no parent archive", () => {
+        const rows = [aged({ processedBy: ["ev-a"], parentProcessedBy: null })];
+        expect(partitionAged(rows, { section: ["ev-a"], archive: [] })).toEqual({
+            prunable: [],
+            keptOutstanding: 1,
+        });
+    });
+    it("ignores a flag from a routine that is not interested", () => {
+        const rows = [aged({ processedBy: ["ev-a", "ev-stale"] })];
+        expect(partitionAged(rows, { section: ["ev-a"], archive: [] })).toEqual({
+            prunable: ["s1"],
+            keptOutstanding: 0,
+        });
+    });
+});
+const NOW = new Date("2026-08-13T09:00:00.000Z");
+function deps(over = {}) {
+    return {
+        listEmailAccountIds: vi.fn(async () => ["acc-1"]),
+        listGateArgs: vi.fn(async () => []),
+        listAgedSections: vi.fn(async () => []),
+        pruneSections: vi.fn(async () => ({ repaired: 0, pruned: 0 })),
+        now: () => NOW,
+        log: vi.fn(),
+        ...over,
+    };
+}
+const lines = (d) => d.log.mock.calls.map((c) => c[0]);
+const sectionGate = (eventId) => ({
+    eventId,
+    gateArgs: JSON.stringify({ checks: [{ type: "graph-unflagged", label: "Section" }] }),
+});
+describe("runRetention", () => {
+    it("prunes nothing and names the period unset when EMAIL_RETENTION_DAYS is absent", async () => {
+        const d = deps();
+        await runRetention(d, {});
+        expect(d.listEmailAccountIds).not.toHaveBeenCalled();
+        expect(lines(d)).toEqual([
+            "op=email-retention account=- interested=0 pruned=0 kept-outstanding=0 repaired=0 ageDays=unset",
+        ]);
+    });
+    it("sweeps every account holding email sections when a period is set", async () => {
+        const d = deps({ listEmailAccountIds: vi.fn(async () => ["acc-1", "acc-2"]) });
+        await runRetention(d, { EMAIL_RETENTION_DAYS: "30" });
+        expect(d.listGateArgs).toHaveBeenCalledTimes(2);
+    });
+    it("reports one account's failure and continues to the next", async () => {
+        const d = deps({
+            listEmailAccountIds: vi.fn(async () => ["acc-1", "acc-2"]),
+            listGateArgs: vi.fn(async (accountId) => {
+                if (accountId === "acc-1")
+                    throw new Error("neo4j down");
+                return [];
+            }),
+        });
+        await runRetention(d, { EMAIL_RETENTION_DAYS: "30" });
+        expect(lines(d)[0]).toBe("op=email-retention-error account=acc-1 detail=neo4j down");
+        expect(lines(d)[1]).toBe("op=email-retention account=acc-2 interested=0 pruned=0 kept-outstanding=0 repaired=0 ageDays=30");
+    });
+});
+describe("sweepAccount", () => {
+    it("deletes nothing and reports interested=0 when no routine holds the check", async () => {
+        const d = deps({ listGateArgs: vi.fn(async () => [{ eventId: "ev-1", gateArgs: null }]) });
+        await sweepAccount(d, "acc-1", 30);
+        expect(d.listAgedSections).not.toHaveBeenCalled();
+        expect(d.pruneSections).not.toHaveBeenCalled();
+        expect(lines(d)).toEqual([
+            "op=email-retention account=acc-1 interested=0 pruned=0 kept-outstanding=0 repaired=0 ageDays=30",
+        ]);
+    });
+    it("prunes only the flagged section and reports every count", async () => {
+        const d = deps({
+            listGateArgs: vi.fn(async () => [sectionGate("ev-a")]),
+            listAgedSections: vi.fn(async () => [
+                { id: "s1", processedBy: ["ev-a"], parentProcessedBy: [] },
+                { id: "s2", processedBy: [], parentProcessedBy: [] },
+            ]),
+            pruneSections: vi.fn(async () => ({ repaired: 2, pruned: 1 })),
+        });
+        await sweepAccount(d, "acc-1", 30);
+        expect(d.listAgedSections.mock.calls[0]).toEqual([
+            "acc-1",
+            "2026-07-14T09:00:00.000Z",
+            RETENTION_CANDIDATE_CAP,
+        ]);
+        expect(d.pruneSections).toHaveBeenCalledWith("acc-1", ["s1"]);
+        expect(lines(d)).toEqual([
+            "op=email-retention account=acc-1 interested=1 pruned=1 kept-outstanding=1 repaired=2 ageDays=30",
+        ]);
+    });
+    it("reports repaired=0 beside a non-zero prune, the broken-chain signature", async () => {
+        const d = deps({
+            listGateArgs: vi.fn(async () => [sectionGate("ev-a")]),
+            listAgedSections: vi.fn(async () => [
+                { id: "s1", processedBy: ["ev-a"], parentProcessedBy: [] },
+            ]),
+            pruneSections: vi.fn(async () => ({ repaired: 0, pruned: 1 })),
+        });
+        await sweepAccount(d, "acc-1", 30);
+        expect(lines(d)[0]).toContain("pruned=1 kept-outstanding=0 repaired=0");
+    });
+    it("skips the repair and the delete when nothing is prunable", async () => {
+        const d = deps({
+            listGateArgs: vi.fn(async () => [sectionGate("ev-a")]),
+            listAgedSections: vi.fn(async () => [{ id: "s1", processedBy: [], parentProcessedBy: [] }]),
+        });
+        await sweepAccount(d, "acc-1", 30);
+        expect(d.pruneSections).not.toHaveBeenCalled();
+        expect(lines(d)).toEqual([
+            "op=email-retention account=acc-1 interested=1 pruned=0 kept-outstanding=1 repaired=0 ageDays=30",
+        ]);
+    });
+    it("names a capped candidate batch so a truncated sweep is never silent", async () => {
+        const rows = Array.from({ length: RETENTION_CANDIDATE_CAP }, (_, i) => ({
+            id: `s${i}`,
+            processedBy: [],
+            parentProcessedBy: [],
+        }));
+        const d = deps({
+            listGateArgs: vi.fn(async () => [sectionGate("ev-a")]),
+            listAgedSections: vi.fn(async () => rows),
+        });
+        await sweepAccount(d, "acc-1", 30);
+        expect(lines(d)[0]).toContain("capped=true");
+    });
+});
+//# sourceMappingURL=retention.test.js.map

package/payload/platform/plugins/email/mcp/dist/sampler/__tests__/retention.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.test.js","sourceRoot":"","sources":["../../../src/sampler/__tests__/retention.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,GAInB,MAAM,iBAAiB,CAAC;AAEzB,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClF,MAAM,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClG,MAAM,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACrF,kBAAkB,CACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,IAAI,GAAG,CAAC,MAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAc;YACtB,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE;YACtF,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC,EAAE;SACnG,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAc;YACtB;gBACE,OAAO,EAAE,SAAS;gBAClB,QAAQ,EAAE,IAAI,CAAC;oBACb,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;oBAC7C,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,qBAAqB,EAAE;iBAC1D,CAAC;aACH;SACF,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,IAAI,GAAc;YACtB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;YAC5E,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE;SACtF,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,IAAI,GAAc;YACtB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE;YAC5C,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;YACtE,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;SAClF,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,IAAI,GAAc;YACtB;gBACE,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,IAAI,CAAC;oBACb,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;oBAC7C,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE;iBAC9C,CAAC;aACH;SACF,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,IAAI,GAAG,CAAC,OAA6B,EAAE,EAAe,EAAE,CAAC,CAAC;QAC9D,EAAE,EAAE,IAAI;QACR,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,EAAE;QACrB,GAAG,IAAI;KACR,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpF,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5E,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtE,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtE,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAEjD,SAAS,IAAI,CAAC,OAA+B,EAAE;IAC7C,OAAO;QACL,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACnC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACvC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG;QACd,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;QACZ,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAE,CAAC,CAAC,GAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO;IACP,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACtF,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;QACjB,MAAM,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,mBAA0B,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,gGAAgG;SACjG,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/E,MAAM,YAAY,CAAC,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,YAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1D,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,SAAiB,EAAE,EAAE;gBAC9C,IAAI,SAAS,KAAK,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;gBACzD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;SACH,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACrF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACtB,iGAAiG,CAClG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,MAAM,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,gBAAuB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzD,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,iGAAiG;SAClG,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE;gBAC1D,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;aACrD,CAAC;YACF,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAE,CAAC,CAAC,gBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACxD,OAAO;YACP,0BAA0B;YAC1B,uBAAuB;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,iGAAiG;SAClG,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE;aAC3D,CAAC;YACF,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;SAC5F,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,iGAAiG;SAClG,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,EAAc;YAC3B,iBAAiB,EAAE,EAAc;SAClC,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/payload/platform/plugins/email/mcp/dist/sampler/main.js

@@ -5,6 +5,8 @@ import { fetchSinceUid, resolveDefaultRecipients } from "../lib/imap.js";
 import { dispatchEmailMessagesToConversationArchive } from "../lib/conversation-archive-dispatch.js";
 import { listAllImapAccounts, readSamplerCursor, advanceSamplerCursor } from "../lib/credentials.js";
 import { sampleMailbox } from "./sample-mailbox.js";
+import { runRetention } from "./retention.js";
+import { retentionSources } from "./retention-sources.js";
 // The standing email-sampler (Task 2682): a per-brand systemd user unit that
 // each cycle enumerates every IMAP mailbox on the install and writes new
 // inbound messages to the graph via the plugin's own dispatch, independent of
@@ -46,6 +48,23 @@ const deps = {
 async function cycle() {
     await imapArm();
     await outlookArm();
+    await retentionPass();
+}
+/**
+ * The retention sweep (Task 2685). Runs AFTER both arms so a cycle never deletes
+ * before it has written, and in its own try for the reason each arm has one: a
+ * retention failure must cost no ingest.
+ *
+ * `runRetention` reads `EMAIL_RETENTION_DAYS` itself and prunes nothing when it
+ * is unset, which is every install until an operator sets it.
+ */
+async function retentionPass() {
+    try {
+        await runRetention(retentionSources(() => new Date(), logLine), process.env);
+    }
+    catch (e) {
+        logLine(`op=email-retention-error account=<sweep> detail=${e instanceof Error ? e.message : String(e)}`);
+    }
 }
 /** The IMAP arm (Task 2682). An enumeration failure ends this arm only; the
  *  Outlook arm reads a different store and must still run. */

package/payload/platform/plugins/email/mcp/dist/sampler/main.js.map

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

package/payload/platform/plugins/email/mcp/dist/sampler/retention-sources.d.ts

@@ -0,0 +1,3 @@
+import type { RetentionDeps } from "./retention.js";
+export declare function retentionSources(now: () => Date, log: (line: string) => void): RetentionDeps;
+//# sourceMappingURL=retention-sources.d.ts.map

package/payload/platform/plugins/email/mcp/dist/sampler/retention-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-sources.d.ts","sourceRoot":"","sources":["../../src/sampler/retention-sources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAwB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuB1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,CAkJ5F"}

package/payload/platform/plugins/email/mcp/dist/sampler/retention-sources.js

@@ -0,0 +1,146 @@
+import neo4j from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+// The real graph behind `RetentionDeps` (Task 2685). Split from `retention.ts`
+// so the predicate, the parsing and the sweep stay testable without Neo4j —
+// the same division `scheduling-gate.ts` draws between its probe and
+// `REAL_SOURCES`.
+/**
+ * The longest deleted span the chain repair walks. A bound rather than `*0..`
+ * because an unbounded variable-length match over a long conversation is the one
+ * statement here that can run away; a span longer than this leaves the chain
+ * broken, which costs a later ingest a wrong tail and never costs data.
+ */
+const RETENTION_CHAIN_HOPS = 500;
+/** Neo4j returns list properties as-is; this narrows a `gateProcessedBy` value
+ *  to the string list the predicate expects, treating an absent or wrong-typed
+ *  property as "flagged by nobody". */
+function flagList(value) {
+    return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+export function retentionSources(now, log) {
+    return {
+        now,
+        log,
+        listEmailAccountIds: async () => {
+            const session = getSession();
+            try {
+                const res = await session.run(`MATCH (s:Section)
+           WHERE s.source = 'email' AND s.accountId IS NOT NULL
+           RETURN DISTINCT s.accountId AS accountId`);
+                return res.records.map((r) => r.get("accountId"));
+            }
+            finally {
+                await session.close();
+            }
+        },
+        // Every gate-bearing :Event on the account, enabled or suspended. A
+        // suspended routine counts as interested (operator decision 2026-08-13), so
+        // enabling a parked routine never finds its backlog already deleted — hence
+        // no `eventStatus` predicate here.
+        //
+        // `e.eventId`, never `elementId(e)`: the dispatcher passes the eventId
+        // PROPERTY as the flag key (agent-turn-dispatch.ts:506), so joining on the
+        // element id would compare against a value `gateProcessedBy` never holds and
+        // every section would look outstanding for ever.
+        listGateArgs: async (accountId) => {
+            const session = getSession();
+            try {
+                const res = await session.run(`MATCH (e:Event)
+           WHERE e.accountId = $accountId AND e.gateArgs IS NOT NULL
+           RETURN e.eventId AS eventId, e.gateArgs AS gateArgs`, { accountId });
+                return res.records
+                    .filter((r) => typeof r.get("eventId") === "string")
+                    .map((r) => ({
+                    eventId: r.get("eventId"),
+                    gateArgs: r.get("gateArgs") ?? null,
+                }));
+            }
+            finally {
+                await session.close();
+            }
+        },
+        // `s.createdAt < $cutoff` is lexical, which equals chronological because
+        // every value on both sides is a `toISOString()` string of fixed width. A
+        // createdAt of any other type compares as null in Cypher, so the row drops
+        // out of the candidate set and the section is KEPT.
+        listAgedSections: async (accountId, cutoff, limit) => {
+            const session = getSession();
+            try {
+                const res = await session.run(`MATCH (s:Section)
+           WHERE s.accountId = $accountId AND s.source = 'email'
+             AND s.createdAt < $cutoff
+           OPTIONAL MATCH (a:ConversationArchive)-[:HAS_SECTION]->(s)
+           RETURN elementId(s) AS id,
+                  s.gateProcessedBy AS processedBy,
+                  CASE WHEN a IS NULL THEN NULL ELSE coalesce(a.gateProcessedBy, []) END
+                    AS parentProcessedBy
+           ORDER BY s.createdAt ASC
+           LIMIT $limit`, { accountId, cutoff, limit: neo4j.int(limit) });
+                return res.records.map((r) => {
+                    const parent = r.get("parentProcessedBy");
+                    return {
+                        id: r.get("id"),
+                        processedBy: flagList(r.get("processedBy")),
+                        parentProcessedBy: parent === null || parent === undefined ? null : flagList(parent),
+                    };
+                });
+            }
+            finally {
+                await session.close();
+            }
+        },
+        // The repair and the delete, in ONE write transaction.
+        //
+        // Sections are chained by :NEXT, and the next ingest finds the tail by
+        // looking for one with no outgoing :NEXT, LIMIT 1
+        // (memory-ingest.ts:1734-1742). Deleting from the middle of a chain leaves
+        // TWO such nodes, so a later ingest could chain new content onto a middle
+        // section. The repair connects each surviving predecessor to the first
+        // surviving section after the deleted span, shortest span first.
+        //
+        // It must run BEFORE the delete, because it walks the very edges the delete
+        // removes — and therefore inside the same transaction as the delete, because
+        // between the two the predecessor holds an edge to the doomed section AND
+        // its new edge to the target. A failure between them would leave that fork
+        // committed, and a routine added before the next cycle would make the
+        // sections outstanding again, so nothing would ever come back to repair it.
+        //
+        // Both statements carry `accountId` beside the element ids, the way
+        // `flagProcessedNodes` does (scheduling/mcp/src/lib/gate-flag.ts:100-104).
+        // The ids are already account-scoped by `listAgedSections`; the predicate is
+        // here so the scope is a property of the DELETE itself and not of the
+        // caller's discipline.
+        pruneSections: async (accountId, ids) => {
+            const session = getSession();
+            try {
+                return await session.executeWrite(async (tx) => {
+                    const repair = await tx.run(`MATCH (p:Section)-[:NEXT]->(first:Section)
+             WHERE first.accountId = $accountId
+               AND elementId(first) IN $ids AND NOT elementId(p) IN $ids
+             MATCH path = (first)-[:NEXT*0..${RETENTION_CHAIN_HOPS}]->(q:Section)
+             WHERE NOT elementId(q) IN $ids
+               AND all(n IN nodes(path)[0..-1] WHERE elementId(n) IN $ids)
+             WITH p, q, length(path) AS len
+             ORDER BY len ASC
+             WITH p, head(collect(q)) AS target
+             MERGE (p)-[r:NEXT]->(target)
+             ON CREATE SET r.createdByAgent = 'email-retention', r.createdAt = $now
+             RETURN count(r) AS repaired`, { accountId, ids, now: now().toISOString() });
+                    const del = await tx.run(`MATCH (s:Section)
+             WHERE s.accountId = $accountId AND s.source = 'email'
+               AND elementId(s) IN $ids
+             DETACH DELETE s
+             RETURN count(s) AS pruned`, { accountId, ids });
+                    return {
+                        repaired: repair.records[0]?.get("repaired")?.toNumber?.() ?? 0,
+                        pruned: del.records[0]?.get("pruned")?.toNumber?.() ?? 0,
+                    };
+                });
+            }
+            finally {
+                await session.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=retention-sources.js.map

package/payload/platform/plugins/email/mcp/dist/sampler/retention-sources.js.map

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

package/payload/platform/plugins/email/mcp/dist/sampler/retention.d.ts

@@ -0,0 +1,150 @@
+/**
+ * The configured retention period in whole days, or null.
+ *
+ * Null means PRUNE NOTHING, and every unreadable value resolves to it: unset,
+ * empty, zero, negative, fractional, non-numeric. Deletion is a thing the
+ * operator turns on per install, never a default, because the failure direction
+ * here is unrecoverable — the 2026-04-20 incident that ended autonomous graph
+ * hygiene rules is recorded at `memory/mcp/src/lib/graph-prune.ts:6`.
+ */
+export declare function resolveRetentionDays(env: NodeJS.ProcessEnv): number | null;
+/**
+ * The largest period this accepts, a hundred years.
+ *
+ * An upper bound and not only a lower one, because `cutoffIso` subtracts
+ * `days * 86_400_000` milliseconds and a value past the ±8.64e15 Date range
+ * yields an Invalid Date whose `toISOString()` throws. Without this, a fat-finger
+ * `EMAIL_RETENTION_DAYS` passes the integer guard and then throws once per
+ * account per cycle for ever, reported as a retention error rather than as the
+ * bad configuration it is. Anything beyond a century is a typo, and refusing it
+ * here prunes nothing, which is the same safe direction as every other
+ * unreadable value.
+ */
+export declare const RETENTION_MAX_DAYS = 36500;
+/**
+ * The instant a section must predate to be old enough to prune.
+ *
+ * Emitted through `toISOString()` because every `:Section.createdAt` is written
+ * the same way through a writer-owned key the ingest's reserved list forbids
+ * content from setting (`memory/mcp/src/tools/memory-ingest.ts:222-238`). Both
+ * sides therefore have the same fixed-width shape, which is what makes the
+ * lexical comparison in the Cypher equal to a chronological one.
+ */
+export declare function cutoffIso(now: Date, days: number): string;
+/** One routine's gate as the graph holds it. `gateArgs` is the JSON the gate
+ *  tool receives, `{"eventId":…,"checks":[…]}`. */
+export interface GateRow {
+    eventId: string;
+    gateArgs: string | null;
+}
+/** The routines watching each grain, by the `eventId` their flags carry. */
+export interface InterestedSets {
+    section: string[];
+    archive: string[];
+}
+/**
+ * Which routines are interested in this account's email nodes, split by grain.
+ *
+ * A routine gated on `ConversationArchive` counts as interested in the sections
+ * underneath that archive (operator decision 2026-08-13): it reads them, so
+ * pruning one it has not flagged would strip content out from under a routine
+ * that never saw it. The two sets are consulted at different grains because that
+ * is where the dispatcher writes their flags — a `Section`-gated routine's id
+ * lands on the section, a `ConversationArchive`-gated routine's on the parent.
+ *
+ * A gate this cannot read contributes NOTHING and never throws. That is the safe
+ * direction in both halves: an unreadable gate shrinks the interested set, and a
+ * smaller set can only make MORE sections prunable — so it is paired with the
+ * empty-set rule in `sweepAccount`, which refuses to prune on a set of nobody.
+ */
+export declare function interestedSets(rows: GateRow[]): InterestedSets;
+/**
+ * One candidate: a section already filtered to `source:'email'` and to an age
+ * past the cutoff, carried with the two flag lists that decide it.
+ * `parentProcessedBy` is null when the section has no `:ConversationArchive`
+ * parent, which is a shape this sweep did not write and therefore keeps.
+ */
+export interface AgedSection {
+    id: string;
+    processedBy: string[];
+    parentProcessedBy: string[] | null;
+}
+/**
+ * Split aged candidates into the ones every interested routine has finished with
+ * and a count of the ones still outstanding for somebody.
+ *
+ * Age is NOT re-checked here: the caller's Cypher filtered on the cutoff, so a
+ * row reaching this function is old enough by construction. The predicate is
+ * membership only.
+ *
+ * A flag from a routine that is no longer interested is ignored rather than
+ * required, because the set is derived from the gates that exist NOW. A deleted
+ * routine must not pin the archive for ever.
+ */
+export declare function partitionAged(rows: AgedSection[], sets: InterestedSets): {
+    prunable: string[];
+    keptOutstanding: number;
+};
+/**
+ * The most candidates one account's sweep pulls per cycle.
+ *
+ * Bounded because this runs inside the sampler's 60-second loop and the aged set
+ * does not shrink on its own: only PRUNABLE rows leave it, so an account whose
+ * routines have stalled would otherwise grow an unbounded fetch for ever. The
+ * batch is ordered oldest-first, and a capped sweep drains across cycles.
+ * `capped=true` on the log line is what stops a truncated pass reading as a
+ * complete one.
+ */
+export declare const RETENTION_CANDIDATE_CAP = 5000;
+/**
+ * The graph operations the sweep needs, injected exactly as `SamplerDeps` is, so
+ * every branch above is testable without Neo4j and the Cypher lives in one place.
+ */
+export interface RetentionDeps {
+    /** Distinct accountIds holding at least one `:Section {source:'email'}`. */
+    listEmailAccountIds: () => Promise<string[]>;
+    /** Every `:Event` on the account that carries a gate, enabled or suspended. */
+    listGateArgs: (accountId: string) => Promise<GateRow[]>;
+    /** Email sections older than `cutoff`, oldest first, with their flag lists. */
+    listAgedSections: (accountId: string, cutoff: string, limit: number) => Promise<AgedSection[]>;
+    /**
+     * Repair the `:NEXT` chain across the span and delete it, as ONE unit.
+     *
+     * A single call rather than a repair and a delete the sweep sequences itself,
+     * because the repair MERGEs `(p)-[:NEXT]->(target)` while `p`'s edge to the
+     * first doomed section still exists and relies on the delete to remove it. Two
+     * calls means a delete failure leaves `p` with two outgoing `:NEXT` edges and
+     * the reading order forked. Retrying next cycle recovers it only while the
+     * sections stay prunable, and a routine added in between makes them
+     * outstanding again, so the fork would persist with nothing left to fix it.
+     */
+    pruneSections: (accountId: string, ids: string[]) => Promise<{
+        repaired: number;
+        pruned: number;
+    }>;
+    now: () => Date;
+    log: (line: string) => void;
+}
+/**
+ * Sweep one account.
+ *
+ * The empty interested set is the load-bearing branch: it deletes NOTHING and
+ * says so. Read literally, "flagged by every interested routine" is vacuously
+ * true over an empty set, which on every install today — no shipped routine
+ * carries a `graph-unflagged` check until Task 2686 — would delete the whole
+ * email archive older than N on the first sweep. An empty set means nobody has
+ * consented to this data being processed, not that everybody has.
+ */
+export declare function sweepAccount(deps: RetentionDeps, accountId: string, days: number): Promise<void>;
+/**
+ * One retention pass over every account holding email sections.
+ *
+ * Accounts come from the DATA, not from the routine set: an account holding
+ * email and no routine is exactly the one whose `interested=0` line the operator
+ * needs to see, and enumerating from routines would make it invisible.
+ *
+ * One account's failure is named and never stops the next, matching the arms in
+ * `main.ts`.
+ */
+export declare function runRetention(deps: RetentionDeps, env: NodeJS.ProcessEnv): Promise<void>;
+//# sourceMappingURL=retention.d.ts.map

package/payload/platform/plugins/email/mcp/dist/sampler/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/sampler/retention.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAM1E;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;mDACmD;AACnD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CAqB9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EAAE,EACnB,IAAI,EAAE,cAAc,GACnB;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAcjD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,+EAA+E;IAC/E,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/F;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnG,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf"}