Give a reader their own events back

An event of theirs that had ended was on no surface at all. Every list and
the board drop a row once its end has passed, and settings only counted the
events a game held rather than naming them — so a one-off became unreachable
the day it finished: impossible to edit, and impossible to delete out of a
store nothing else can see. Repeating events escaped only because their
occurrences roll forward.

Settings names them now, under the game they were filed against, each row
opening the same detail sheet a row on the front page does. Nothing about
how they are managed changes; what was missing was the way back to them.

Resolution lives in displayEventFor, with the rule itself as the floor, so a
stored id always names something the reader can edit and delete — including
a rule that generates nothing at all, which review found opening nothing at
all. It is exported rather than inlined because no test in this project
renders the app or can click, which is exactly how a dead button reached
review in the first place.

Each row says why it is not on the front page: ended and when, stopped and
when, or its cadence.

1032 tests.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>

README.md

@@ -210,6 +210,11 @@ carry no source link because there is no page to send a sceptic to, and they
 travel in your export. Like everything else here, your browser holds the only
 copy.
 
+Settings lists everything you have added, whatever state it is in, and opens
+the same panel a row does. Every other surface drops an event once it has
+ended, so that list is the only way back to a one-off of yours after its end
+date passes — to edit it, or to get rid of it.
+
 ### How often it comes round
 
 An event you add states its **cadence** — asked before any date, because the

docs/PRD.md

@@ -317,6 +317,13 @@ Four constraints, each protecting something that already exists:
 - **Their events never touch the ingest pipeline.** `sanitize.ts` and `merge.ts` exist for pages we
   do not control; a reader's own typing is neither untrusted markup nor a second opinion to
   reconcile. Nothing they enter is fetched, parsed, merged, scored or quarantined.
+- **They are reachable whenever the app is.** Settings lists every event the reader has made,
+  whatever state it is in, and opens the same detail sheet a row does. "Whenever the app is" is
+  literal: settings renders on the ready path, so a feed that fails to load takes the whole panel
+  with it — a pre-existing limit worth naming rather than implying otherwise. Every other surface drops an event once it has
+  ended, so without this list a one-off of their own became unreachable the day it finished —
+  impossible to edit, and impossible to delete out of a store nothing else can see. Events filed
+  under a game we track are listed too; the form allows that, so the index has to.
 - **Their IDs live in their own key space.** Never `${game}:${slug}:${date}` — see
   `docs/DATA-MODEL.md` § Reader-authored key spaces.
 - **They are in the backup.** An export that omitted hand-entered events would be a lossy backup,

src/client/App.tsx

@@ -30,12 +30,12 @@ import {
 } from "./state/lens.ts";
 import { clockFor, formatRemaining } from "../shared/time.ts";
 import { dailySummary, isDaily, resolveDaily } from "../shared/daily.ts";
-import { occurrenceForId, strandedOccurrences } from "../shared/recurrence.ts";
+import { strandedOccurrences } from "../shared/recurrence.ts";
 import { orderGames } from "./state/gameOrder.ts";
 import { GameMetaProvider, type MetaResolver } from "./state/gameMeta.tsx";
 import { metaOnTheme, useTheme } from "./state/theme.ts";
 import {
-  asOccurrenceEvent,
+  displayEventFor,
   recordFor,
   type CustomEvents,
   type CustomGames,
@@ -369,11 +369,8 @@ export function App() {
   const openRow = (() => {
     const hit = allRows.find((r) => r.event.id === openId) ?? null;
     if (hit !== null || openId === null) return hit;
-    const record = recordFor(custom.events, openId);
-    if (record === undefined) return null;
-    const occurrence = occurrenceForId(record, openId);
-    if (occurrence === null) return null;
-    const event = asOccurrenceEvent(record, occurrence);
+    const event = displayEventFor(custom.events, openId, now);
+    if (event === null) return null;
     return { event, clock: clockFor(event, prefs.region, now) };
   })();
 
@@ -650,6 +647,14 @@ export function App() {
           onEditGame: custom.editGame,
           onRemoveGame: custom.removeGame,
           onAddEvent: custom.addEvent,
+          now,
+          // The index lists rules; the sheet opens rows. A repeating rule's
+          // own id is never a row — the lists hold its occurrences — so it is
+          // resolved to whichever occurrence is nearest before opening.
+          // The stored id is enough: `displayEventFor` resolves a rule to
+          // whichever occurrence the sheet can show, and to the rule itself
+          // when it has none.
+          onOpen: setOpenId,
         }}
         onExport={() =>
           exportProgress(prog.progress, daily.logs, ignored.marks, prefs, {

src/client/components/YourOwn.tsx

@@ -1,16 +1,56 @@
 import { useState } from "react";
-import type { CustomEvents, CustomGames, LaneId } from "../../shared/custom.ts";
+import type { CustomEvent, CustomEvents, CustomGames, LaneId } from "../../shared/custom.ts";
+import { formatAbsolute } from "../../shared/time.ts";
 import type { EventDraft } from "../state/useCustom.ts";
-import { EventForm, GameForm } from "./CustomForms.tsx";
+import { useGameMeta } from "../state/gameMeta.tsx";
+import { cadenceLabel, EventForm, GameForm } from "./CustomForms.tsx";
 
 /**
  * The reader's own games and events — a group of the settings panel (PRD F13).
  *
- * Their events are managed from the event itself — open it and the detail sheet
- * offers edit and delete, exactly where you would look for them. What has no
- * other home is the list of games they invented, and the way in to adding the
- * first event, so both live here.
+ * Their events are still *managed* from the event itself — open one and the
+ * detail sheet offers edit and delete, exactly where you would look for them.
+ * What lives here is the way back **to** it, which the rest of the app cannot
+ * offer: every list and the board drop an event once it has ended, so a
+ * one-off of the reader's own became unreachable the day it finished —
+ * impossible to edit, and impossible to delete out of a store nothing else can
+ * reach. This index is the only surface that shows an event whatever state it
+ * is in.
  */
+
+/**
+ * What a row says about itself, beyond its title.
+ *
+ * The job is to explain why an event is not on any other surface, because a
+ * list of bare titles leaves the reader guessing which of two entries is the
+ * dead one. A repeating event says how often instead of when: its dates roll
+ * forward, so printing one would disagree with the row they would find if they
+ * went looking.
+ */
+export function eventCaption(event: CustomEvent, nowMs: number): string {
+  const cadence = cadenceLabel(event.repeat);
+  if (cadence !== null) {
+    // A series that has stopped is exactly what this list exists to explain,
+    // and a healthy-looking cadence explains nothing: the reader would see
+    // "on a weekly cycle" and no reason it is missing from the board.
+    const until = event.repeat?.until ?? null;
+    if (until !== null && Date.parse(until) < nowMs) {
+      return `stopped ${formatAbsolute(Date.parse(until), false)}`;
+    }
+    return cadence;
+  }
+
+  if (event.endsAt !== null && Date.parse(event.endsAt) < nowMs) {
+    return `ended ${formatAbsolute(Date.parse(event.endsAt), false)}`;
+  }
+  if (Date.parse(event.startsAt) > nowMs) {
+    return `starts ${formatAbsolute(Date.parse(event.startsAt), false)}`;
+  }
+  return event.endsAt === null
+    ? "no end date"
+    : `until ${formatAbsolute(Date.parse(event.endsAt), false)}`;
+}
+
 export function YourOwn({
   games,
   events,
@@ -19,6 +59,8 @@ export function YourOwn({
   onEditGame,
   onRemoveGame,
   onAddEvent,
+  now,
+  onOpen,
 }: {
   games: CustomGames;
   events: CustomEvents;
@@ -28,12 +70,30 @@ export function YourOwn({
   onEditGame: (id: string, name: string, hue: string) => void;
   onRemoveGame: (id: string) => { removed: boolean; blockedBy: number };
   onAddEvent: (draft: EventDraft) => void;
+  now: number;
+  /**
+   * Open one of their events. Takes the stored id — a rule's, not an
+   * occurrence's — and the caller resolves it to whichever row the sheet can
+   * actually show.
+   */
+  onOpen: (id: string) => void;
 }) {
+  const gameMeta = useGameMeta();
   const [adding, setAdding] = useState<"game" | "event" | null>(null);
   const [editing, setEditing] = useState<string | null>(null);
   const [refusal, setRefusal] = useState<string | null>(null);
 
   const list = Object.values(games);
+  // An event may be filed under a game we track — a source can miss one — and
+  // those have no row above to nest under. Listing them separately is what
+  // keeps this index complete: an ended event under Genshin is on no other
+  // surface either, and would be just as stuck. It also catches an event whose
+  // own lane has since gone, which `removeGame` refuses to cause but an import
+  // can still deliver — hence "another game" rather than "a game we track",
+  // which would be false for exactly that row.
+  const underTracked = Object.values(events).filter(
+    (e) => games[e.game] === undefined,
+  );
 
   return (
     // No heading or rule of its own: this is the body of a settings group that
@@ -48,9 +108,8 @@ export function YourOwn({
       {list.length > 0 && (
         <ul className="mt-3 flex flex-col gap-1.5">
           {list.map((game) => {
-            const held = Object.values(events).filter(
-              (e) => e.game === game.id,
-            ).length;
+            const mine = Object.values(events).filter((e) => e.game === game.id);
+            const held = mine.length;
             return (
               <li key={game.id}>
                 <div className="flex items-center gap-2">
@@ -95,6 +154,31 @@ export function YourOwn({
                   </button>
                 </div>
 
+                {/* Indented under its game rather than in one flat list,
+                    because the games are already the structure here and a
+                    reader looking for an event of theirs knows which game they
+                    filed it under. */}
+                {mine.length > 0 && (
+                  <ul className="mt-1 flex flex-col gap-1 border-l border-hairline pl-3">
+                    {mine.map((event) => (
+                      <li key={event.id}>
+                        <button
+                          type="button"
+                          onClick={() => onOpen(event.id)}
+                          className="flex w-full items-baseline gap-2 text-left transition-colors hover:text-ink"
+                        >
+                          <span className="min-w-0 flex-1 truncate text-sm text-muted">
+                            {event.title}
+                          </span>
+                          <span className="shrink-0 text-xs text-faint">
+                            {eventCaption(event, now)}
+                          </span>
+                        </button>
+                      </li>
+                    ))}
+                  </ul>
+                )}
+
                 {editing === game.id && (
                   <GameForm
                     initial={{ name: game.name, hue: game.hue }}
@@ -111,6 +195,35 @@ export function YourOwn({
         </ul>
       )}
 
+      {/* Its own heading rather than trailing the list above, which read as
+          though these belonged to whichever game happened to be last. */}
+      {underTracked.length > 0 && (
+        <p className="mt-4 text-xs text-faint">Filed under another game</p>
+      )}
+      {underTracked.length > 0 && (
+        <ul className="mt-1.5 flex flex-col gap-1">
+          {underTracked.map((event) => (
+            <li key={event.id}>
+              <button
+                type="button"
+                onClick={() => onOpen(event.id)}
+                className="flex w-full items-baseline gap-2 text-left transition-colors hover:text-ink"
+              >
+                <span className="shrink-0 text-xs text-faint">
+                  {gameMeta(event.game).short}
+                </span>
+                <span className="min-w-0 flex-1 truncate text-sm text-muted">
+                  {event.title}
+                </span>
+                <span className="shrink-0 text-xs text-faint">
+                  {eventCaption(event, now)}
+                </span>
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+
       {refusal !== null && (
         <p className="mt-2 text-xs leading-relaxed text-critical">{refusal}</p>
       )}

src/shared/custom.ts

@@ -1,5 +1,12 @@
 import { z } from "zod";
-import { comesRoundEarly, Repeat, ruleIdOf } from "./recurrence.ts";
+import {
+  comesRoundEarly,
+  isOccurrenceId,
+  nearestOccurrence,
+  occurrenceForId,
+  Repeat,
+  ruleIdOf,
+} from "./recurrence.ts";
 import type { Occurrence } from "./recurrence.ts";
 import { EventType, GachaEvent, Precision, slugify } from "./schema.ts";
 
@@ -289,3 +296,40 @@ export function recordFor(
 ): CustomEvent | undefined {
   return events[ruleIdOf(rowId)];
 }
+
+/**
+ * The row an id names, for anything the reader entered themselves.
+ *
+ * The detail sheet opens rows, and an id reaches it from three places that do
+ * not agree about shape: a list row carries an occurrence id, the settings
+ * index carries a stored rule id, and a plain event's id is both at once.
+ * This is the one place that reconciles them, and it is exported rather than
+ * inlined because nothing in this project can click: no test renders the app,
+ * so an id the sheet cannot resolve was invisible to the whole suite until it
+ * had already shipped as a button that does nothing.
+ *
+ * **The last branch is a floor, not a nicety.** A rule can legitimately
+ * produce no occurrence at all — `until` earlier than `startsAt` parses fine
+ * and is reachable by import — which puts it on no list, no board and no
+ * timeline. Returning null for it would leave the settings index opening
+ * nothing for exactly the record that index exists to rescue. Falling back to
+ * the rule itself means a stored id always names something the reader can
+ * edit and delete.
+ */
+export function displayEventFor(
+  events: CustomEvents,
+  rowId: string,
+  nowMs: number,
+): DisplayEvent | null {
+  const record = recordFor(events, rowId);
+  if (record === undefined) return null;
+
+  if (record.repeat === null) return asDisplayEvent(record);
+
+  const occurrence = isOccurrenceId(rowId)
+    ? occurrenceForId(record, rowId)
+    : nearestOccurrence(record, nowMs);
+  return occurrence === null
+    ? asDisplayEvent(record)
+    : asOccurrenceEvent(record, occurrence);
+}

src/shared/recurrence.ts

@@ -474,6 +474,38 @@ export function nextOccurrences(
   return occurrencesOf(event, nowMs, horizon, count);
 }
 
+/**
+ * The occurrence to open when the reader asks for the rule itself.
+ *
+ * The settings index lists rules, but the detail sheet opens rows, and a
+ * rule's own id is never a row — the lists hold its occurrences, keyed
+ * `myevent:<token>#<date>`. This is the bridge between the two.
+ *
+ * Running or next where there is one. Where there is not — a series whose
+ * `until` has passed — it falls back to the first occurrence rather than
+ * giving up, and that fallback is the point rather than a nicety: a finished
+ * rule with no future occurrence would otherwise be exactly as unreachable as
+ * the ended one-off this index exists to rescue, and just as impossible to
+ * delete. Which time round it lands on does not matter, because the reader
+ * has come to edit or delete the rule, not to inspect an occurrence.
+ *
+ * Null only when nothing repeats, and the caller has a row already: a
+ * non-repeating event's own id is in the lists unchanged.
+ */
+export function nearestOccurrence(
+  event: RepeatingEvent,
+  nowMs: number,
+): Occurrence | null {
+  if (event.repeat === null) return null;
+
+  const upcoming = nextOccurrences(event, nowMs, 1);
+  if (upcoming.length > 0) return upcoming[0]!;
+
+  const anchor = Date.parse(event.startsAt);
+  if (Number.isNaN(anchor)) return null;
+  return occurrencesOf(event, anchor, anchor, 1)[0] ?? null;
+}
+
 /**
  * How many of a rule's ids the reader has actually recorded something
  * against — what a schedule edit that re-keys ids would strand.

test/controls.test.tsx

@@ -52,6 +52,8 @@ function render(prefs: Prefs, ignoredCount = 0): string {
           games: {},
           events: {},
           lanes: ["genshin", "hsr"],
+          now: 0,
+          onOpen: () => {},
           onAddGame: () => {},
           onEditGame: () => {},
           onRemoveGame: () => ({ removed: true, blockedBy: 0 }),

test/custom-ui.test.tsx

@@ -9,7 +9,7 @@ import {
   repeatFrom,
   strandedNotice,
 } from "../src/client/components/CustomForms.tsx";
-import { YourOwn } from "../src/client/components/YourOwn.tsx";
+import { eventCaption, YourOwn } from "../src/client/components/YourOwn.tsx";
 import { EventRow } from "../src/client/components/EventRow.tsx";
 import { EventDetail } from "../src/client/components/EventDetail.tsx";
 import { AUTHOR, Colophon, REPO_URL } from "../src/client/components/Colophon.tsx";
@@ -75,6 +75,8 @@ describe("YourOwn", () => {
     onEditGame: noop,
     onRemoveGame: () => ({ removed: true, blockedBy: 0 }),
     onAddEvent: noop,
+    now: Date.parse("2026-10-01T12:00:00.000Z"),
+    onOpen: noop,
   };
 
   test("lists a reader's game with the events it holds", () => {
@@ -883,3 +885,144 @@ describe("repeatOf", () => {
     ).toBe(null);
   });
 });
+
+describe("eventCaption", () => {
+  // What each row in the settings index says about itself. The point is to
+  // explain why an event is not on the front page — a list of bare titles
+  // leaves the reader guessing which of two entries is the dead one.
+  const NOW = Date.parse("2026-10-01T12:00:00.000Z");
+  const at = (over: Record<string, unknown>) =>
+    CustomEvent.parse({
+      id: "myevent:k3f9qa2m01",
+      game: "mygame:limbus-company",
+      title: "Season 7",
+      type: "story",
+      summary: null,
+      startsAt: "2026-09-01T00:00:00.000Z",
+      startPrecision: "day",
+      endsAt: "2026-09-08T00:00:00.000Z",
+      endPrecision: "day",
+      repeat: null,
+      at: AT,
+      updatedAt: AT,
+      ...over,
+    });
+
+  test("a repeating event says how often, not when", () => {
+    // Its dates roll forward, so a date would be out of step with the row the
+    // reader would find if they went looking on the front page.
+    expect(
+      eventCaption(at({ repeat: { unit: "weeks", interval: 1, until: null } }), NOW),
+    ).toBe("on a weekly cycle");
+  });
+
+  test("an event whose end has passed says so", () => {
+    // The whole reason this index exists: this one is on no other surface.
+    expect(eventCaption(at({}), NOW)).toContain("ended");
+  });
+
+  test("an event still to come says when it starts", () => {
+    // Asserted on what it says, not on what it avoids saying: `not.toContain`
+    // passed even with this whole branch deleted, because the ended branch was
+    // never the thing at risk.
+    expect(
+      eventCaption(
+        at({ startsAt: "2026-11-01T00:00:00.000Z", endsAt: "2026-11-08T00:00:00.000Z" }),
+        NOW,
+      ),
+    ).toContain("starts");
+  });
+
+  test("an unannounced end says so rather than reading as passed", () => {
+    // Date.parse(null) is NaN and NaN < now is false, so the null guard was
+    // unobservable through a `not.toContain("ended")` assertion.
+    expect(eventCaption(at({ endsAt: null, endPrecision: "unknown" }), NOW)).toBe(
+      "no end date",
+    );
+  });
+
+  test("a repeating series that has stopped says so, not just how often", () => {
+    // This list's whole job is explaining why an event is on no other surface.
+    // A finished series that reports a healthy cadence explains nothing.
+    const caption = eventCaption(
+      at({
+        endsAt: null,
+        endPrecision: "unknown",
+        repeat: { unit: "weeks", interval: 1, until: "2026-09-20T00:00:00.000Z" },
+      }),
+      NOW,
+    );
+    expect(caption).toContain("stopped");
+  });
+});
+
+describe("the settings index of your own events", () => {
+  test("lists an ended event that no other surface shows", () => {
+    const ended = CustomEvent.parse({
+      id: "myevent:seasonseven",
+      game: "mygame:limbus-company",
+      title: "Season 7",
+      type: "story",
+      summary: null,
+      startsAt: "2026-09-01T00:00:00.000Z",
+      startPrecision: "day",
+      endsAt: "2026-09-08T00:00:00.000Z",
+      endPrecision: "day",
+      repeat: null,
+      at: AT,
+      updatedAt: AT,
+    });
+    const html = render(
+      <YourOwn
+        games={GAMES}
+        events={{ [ended.id]: ended }}
+        lanes={["mygame:limbus-company"]}
+        now={Date.parse("2026-10-01T12:00:00.000Z")}
+        onAddGame={() => {}}
+        onEditGame={() => {}}
+        onRemoveGame={() => ({ removed: true, blockedBy: 0 })}
+        onAddEvent={() => {}}
+        onOpen={() => {}}
+      />,
+    );
+    expect(html).toContain("Season 7");
+    expect(html).toContain("ended");
+  });
+});
+
+describe("the index covers events filed under a tracked game", () => {
+  test("an event under Genshin is listed too", () => {
+    // The form deliberately allows this — a source can miss an event — so an
+    // index that only walked the reader's own games would leave exactly the
+    // same hole it exists to close.
+    const own = CustomEvent.parse({
+      id: "myevent:undergenshin",
+      game: "genshin",
+      title: "Something the wiki missed",
+      type: "other",
+      summary: null,
+      startsAt: "2026-09-01T00:00:00.000Z",
+      startPrecision: "day",
+      endsAt: "2026-09-08T00:00:00.000Z",
+      endPrecision: "day",
+      repeat: null,
+      at: AT,
+      updatedAt: AT,
+    });
+    const html = render(
+      <YourOwn
+        games={GAMES}
+        events={{ [own.id]: own }}
+        lanes={["genshin", "mygame:limbus-company"]}
+        now={Date.parse("2026-10-01T12:00:00.000Z")}
+        onAddGame={() => {}}
+        onEditGame={() => {}}
+        onRemoveGame={() => ({ removed: true, blockedBy: 0 })}
+        onAddEvent={() => {}}
+        onOpen={() => {}}
+      />,
+    );
+    expect(html).toContain("Something the wiki missed");
+    expect(html).toContain("ended");
+  });
+});

test/custom.test.ts

@@ -10,6 +10,7 @@ import {
   mintCustomEventId,
   mintCustomGameId,
   precisionOf,
+  displayEventFor,
   recordFor,
   RESERVED_ID_SEGMENTS,
   type CustomGames,
@@ -640,3 +641,60 @@ describe("recordFor", () => {
     expect(recordFor({}, "myevent:k3f9qa2m01#2026-09-15")).toBeUndefined();
   });
 });
+
+describe("displayEventFor", () => {
+  // The resolution chain the detail sheet depends on, pulled out of App so it
+  // can be tested without a DOM. Nothing in this project can click, and no
+  // test renders App at all, so a row that sets an id the sheet cannot resolve
+  // was invisible to the whole suite — which is exactly how a settings row
+  // that opens nothing got shipped.
+  const plain = ownEvent({ id: "myevent:plain00001", repeat: null });
+  const repeating = ownEvent({
+    id: "myevent:k3f9qa2m01",
+    startsAt: new Date("2026-09-01T09:00:00").toISOString(),
+    startPrecision: "exact",
+    endsAt: new Date("2026-09-08T09:00:00").toISOString(),
+    endPrecision: "exact",
+    repeat: { unit: "weeks", interval: 2, until: null },
+  });
+  // Reachable only by import: nothing in the form can set `until` at all, and
+  // `CustomEvent` does not tie it to `startsAt`. It yields no occurrences, so
+  // it is on no list, no board and no timeline.
+  const stillborn = ownEvent({
+    id: "myevent:stillborn1",
+    startsAt: new Date("2026-09-01T09:00:00").toISOString(),
+    startPrecision: "exact",
+    endsAt: null,
+    endPrecision: "unknown",
+    repeat: { unit: "weeks", interval: 2, until: "2020-01-01T00:00:00.000Z" },
+  });
+  const store = {
+    [plain.id]: plain,
+    [repeating.id]: repeating,
+    [stillborn.id]: stillborn,
+  };
+  const NOW = new Date("2026-09-03T12:00:00").getTime();
+
+  test("a plain event resolves to itself", () => {
+    expect(displayEventFor(store, "myevent:plain00001", NOW)?.id).toBe("myevent:plain00001");
+  });
+
+  test("an occurrence id resolves to that occurrence", () => {
+    const row = displayEventFor(store, "myevent:k3f9qa2m01#2026-09-15", NOW);
+    expect(row?.id).toBe("myevent:k3f9qa2m01#2026-09-15");
+  });
+
+  test("a rule id resolves even when the rule produces no occurrence", () => {
+    // The finding. Its series ended before it began, so `nearestOccurrence`
+    // has nothing to offer — and without a floor here the settings row that
+    // exists to rescue this record opens nothing at all, which is worse than
+    // no button.
+    const row = displayEventFor(store, "myevent:stillborn1", NOW);
+    expect(row?.id).toBe("myevent:stillborn1");
+  });
+
+  test("an id belonging to nobody resolves to nothing", () => {
+    expect(displayEventFor(store, "genshin:some-event:2026-09-01", NOW)).toBe(null);
+    expect(displayEventFor({}, "myevent:plain00001", NOW)).toBe(null);
+  });
+});

test/recurrence.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { addUnits, comesRoundEarly, Repeat, repeatSpanning, repeatModeOf, cadenceOf, isOccurrenceId, occurrenceId, occurrenceForId, ruleIdOf, movesOccurrences, nextOccurrences, occurrencesOf, strandedOccurrences, type RepeatingEvent } from "../src/shared/recurrence.ts";
+import { addUnits, comesRoundEarly, Repeat, repeatSpanning, repeatModeOf, cadenceOf, nearestOccurrence, isOccurrenceId, occurrenceId, occurrenceForId, ruleIdOf, movesOccurrences, nextOccurrences, occurrencesOf, strandedOccurrences, type RepeatingEvent } from "../src/shared/recurrence.ts";
 import { CustomEventId, isCustomEventId } from "../src/shared/custom.ts";
 
 // Pinned so the DST cases mean something. Copenhagen is UTC+1 in winter and
@@ -590,3 +590,46 @@ describe("cadenceOf", () => {
     ).toBe("custom");
   });
 });
+
+describe("nearestOccurrence", () => {
+  // The settings index lists rules, but the detail sheet opens rows, and a
+  // rule's own id is never a row — `allRows` holds its occurrences. This is
+  // the bridge, and it has to answer for a dead series too: a rule whose
+  // `until` has passed has no future occurrence at all, and without an answer
+  // it would be exactly as unreachable as the ended one-off this fixes.
+  const rule = (over: Partial<RepeatingEvent> = {}): RepeatingEvent => ({
+    id: "myevent:k3f9qa2m01",
+    startsAt: new Date("2026-09-01T09:00:00").toISOString(),
+    startPrecision: "exact",
+    endsAt: new Date("2026-09-08T09:00:00").toISOString(),
+    endPrecision: "exact",
+    repeat: { unit: "weeks", interval: 2, until: null },
+    ...over,
+  });
+
+  test("a running occurrence is the nearest one", () => {
+    const got = nearestOccurrence(rule(), new Date("2026-09-03T12:00:00").getTime());
+    expect(got?.id).toBe("myevent:k3f9qa2m01#2026-09-01");
+  });
+
+  test("between cycles it is the one about to open", () => {
+    const got = nearestOccurrence(rule(), new Date("2026-09-10T12:00:00").getTime());
+    expect(got?.id).toBe("myevent:k3f9qa2m01#2026-09-15");
+  });
+
+  test("a finished series still resolves, so it can still be reached", () => {
+    // Any occurrence will do here: the reader has come to edit or delete the
+    // rule, not to inspect a particular time round. The first always exists,
+    // which is what makes this total.
+    const dead = rule({
+      repeat: { unit: "weeks", interval: 2, until: new Date("2026-09-02T00:00:00").toISOString() },
+    });
+    const got = nearestOccurrence(dead, new Date("2027-06-01T12:00:00").getTime());
+    expect(got?.id).toBe("myevent:k3f9qa2m01#2026-09-01");
+  });
+
+  test("an event that does not repeat has no occurrence to find", () => {
+    // Its own id is already a row, so the caller opens it directly.
+    expect(nearestOccurrence(rule({ repeat: null }), Date.now())).toBe(null);
+  });
+});