Fix mobile agent timeline catch-up

2026-05-29 09:31:16 +07:00
parent 2e1b907c63
commit 65ace20880
11 changed files with 410 additions and 77 deletions
@@ -0,0 +1,102 @@
+import { describe, expect, test } from "vitest";
+import { TIMELINE_FETCH_PAGE_SIZE } from "@/timeline/timeline-fetch-policy";
+import {
+  isTimelineCatchUpComplete,
+  planInitialAgentTimelineSync,
+  planResumeTimelineSync,
+  planTimelineCatchUpFollowUp,
+  planTimelineOlderFetch,
+} from "./timeline-sync-plan";
+
+describe("timeline sync planning", () => {
+  test("initial open without an authoritative cursor loads a bounded tail page", () => {
+    const plan = planInitialAgentTimelineSync({
+      cursor: undefined,
+      hasAuthoritativeHistory: false,
+    });
+
+    expect(plan).toEqual({
+      direction: "tail",
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("initial open with an authoritative cursor catches up after the cursor", () => {
+    const plan = planInitialAgentTimelineSync({
+      cursor: { epoch: "epoch-1", startSeq: 1, endSeq: 42 },
+      hasAuthoritativeHistory: true,
+    });
+
+    expect(plan).toEqual({
+      direction: "after",
+      cursor: { epoch: "epoch-1", seq: 42 },
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("resume with a cursor catches up after the cursor", () => {
+    const plan = planResumeTimelineSync({
+      cursor: { epoch: "epoch-1", startSeq: 1, endSeq: 100 },
+    });
+
+    expect(plan).toEqual({
+      direction: "after",
+      cursor: { epoch: "epoch-1", seq: 100 },
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("resume without a cursor loads a bounded tail page", () => {
+    const plan = planResumeTimelineSync({ cursor: undefined });
+
+    expect(plan).toEqual({
+      direction: "tail",
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("older history loads one bounded page before the start cursor", () => {
+    const plan = planTimelineOlderFetch({ epoch: "epoch-1", seq: 25 });
+
+    expect(plan).toEqual({
+      direction: "before",
+      cursor: { epoch: "epoch-1", seq: 25 },
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("catch-up keeps paging while the daemon reports newer rows", () => {
+    const plan = planTimelineCatchUpFollowUp({
+      direction: "after",
+      hasNewer: true,
+      endCursor: { epoch: "epoch-1", seq: 200 },
+      error: null,
+    });
+
+    expect(plan).toEqual({
+      direction: "after",
+      cursor: { epoch: "epoch-1", seq: 200 },
+      limit: TIMELINE_FETCH_PAGE_SIZE,
+      projection: "canonical",
+    });
+  });
+
+  test("catch-up finishes when the daemon reports no newer rows", () => {
+    const plan = planTimelineCatchUpFollowUp({
+      direction: "after",
+      hasNewer: false,
+      endCursor: { epoch: "epoch-1", seq: 200 },
+      error: null,
+    });
+
+    expect(plan).toBeNull();
+    expect(isTimelineCatchUpComplete({ direction: "after", hasNewer: false, error: null })).toBe(
+      true,
+    );
+  });
+});