# The other rooms · chapter 3 · Nyx observe loop · evidence · 8 October 2026

Pinned excerpts and command output behind the rewritten chapter (Eve presentation
document `c0c7b61f-d816-8d5e-8994-248f385e3322`, guide `nyx-observe-loop`) and its
brief. Every excerpt is the repository at commit `1ceae52c7896a59ac74a4429d410f3218f0b91c6`, copied by the command
shown above it. Nothing was run against a service for this rewrite. The five
captures are the chapter's own, taken on 9 September 2026 at the same commit;
their record is copied at the end.

## Why this pin

The chapter is read at `1ceae52c7896a59ac74a4429d410f3218f0b91c6`: the commit it was first written at, the one its
five captures were taken at, and the source revision of the library's inventory.
The assignment file `assignments/v1-nyx-observe-loop.json` binds 22 units of the
Nyx handbook, `V1/features/domain-nyx.md`, to slides of this chapter at the
inventory's revision, and the assessment refuses a slide that cites another
revision (`presentation_inventory.assess_assignments`: "slide cites a different
source revision from this inventory"). The handbook is a file in Git at this pin;
it left the repository on 2026-09-22 (commit `d092109ae62`).

The other Phase D chapters use pin `b6f1ccf1c111`. Between the two pins, of the
39 files this chapter cites, `git diff --stat 1ceae52c7896 b6f1ccf1c111` shows two changed:

```text
apps/oshun/bff/src/server.ts                      | 555 ++++++++++++++++++++--
 apps/oshun/mobile/src/network/oshun-bff-client.ts | 113 ++++-
 2 files changed, 615 insertions(+), 53 deletions(-)
```

`check-data.py` was run at both pins and gave the same 28 equal comparisons, so
nothing the slides state depends on those two changes.

Commits on main after the pin that touch the BFF's Nyx stores, routes or reminder
bridge (`git log 1ceae52c7896..4b3123d926e4 -- apps/oshun/bff/src/nyx apps/oshun/bff/src/routes/nyx.ts apps/oshun/bff/src/reminders/nyx-reminder-bridge.ts`).
The chapter describes the pin and says, on the slides concerned, that saved event
actions and their reminders have since moved into the durable member state:

```text
cb2098d367c 2026-09-27T07:11:58+00:00 fix(oshun): event-action reminders reach the http nyx reader and toggle by their listed id (p5.a)
80d4213b16a 2026-09-25T17:01:45+00:00 fix(oshun): nyx event actions persist in the member state the reminder worker reads
be8d42dc82b 2026-09-25T16:06:28+00:00 fix(oshun): reminders honour the member's push, in-app and reminder-kind toggles at send time
```

## Values read from the code at the pin

Produced by `check-data.py` in
`docs/audits/presentation-center-eve-redesign-nyx-observe-loop/2026-10-08/`, which
reads each value with `git show 1ceae52c7896:<path>` or `git grep <pattern> 1ceae52c7896`
(test files excluded) and compares it with the words on the slides. All
28 comparisons were equal:

```text
ok   eleven exported functions, twenty checks in eight groups, six book examples
ok   the three horizon heights are the file’s constants
ok   every pinned figure on the sky slides is in the test file
ok   eight phase names; sidereal rate as stated
ok   the room takes the Moon at the request, the almanac at the day’s start, and the comment says day’s start
ok   four card events, moonrise the only accent, links only on the rest
ok   Greenwich by default, UTC because no zone is passed, a constant label, no invented sky
ok   nineteen calculators, twenty test files, ten on the page, six with no caller
ok   the links: the room’s menu leaves /nyx or stays; Tonight, Events and the form link among themselves; nothing links to the almanac
ok   five member pages, twenty deep pages, the deep log calls nothing
ok   the phone: three sections, two samples, highlights and actions at the service, no observation write, V1.1
ok   eleven families, 27 types, six eclipses, five seasonal markers, nine families that depend on place
ok   the event record: nineteen fields, windows to 200, sources to 20, place not compared
ok   excellent: the three conditions and the message
ok   eleven source kinds, two that back nothing, the position service backs eight and alone backs a conjunction
ok   the full observation: sixteen fields and the contradiction rule
ok   the calendar record: 25 fields, four providers, five states, eight reminders
ok   no app parses the contract; a registry lists it; the excellent rule runs in one library file behind an unconfigured route; one pipeline app imports the events library
ok   the note: three guards, one rule, owner from sign-in, limits in the browser, nothing kept locally
ok   the second row: padded, the target in the type column, never read back
ok   the log: seventeen fields, one key, queued first, no replay, stand-ins and samples
ok   actions at the pin: memory in development, refusal in production, defaults as stated
ok   delivery reads the member state and not the action store
ok   the agenda: five kinds, five written entries with no source field, a year and 36
ok   each of the five helpers has a caller under apps
ok   the five captures are the recorded ones, by digest and size
ok   the capture record: three links, four sections and fourteen rows, 36 events, four conditions
ok   the slides say what the code says
```

The values it read:

```json
{
 "ephemeris": {
  "exportedFunctions": [
   "toJulianDay",
   "julianCenturies",
   "sunPosition",
   "moonPosition",
   "moonIllumination",
   "computeNightSky",
   "greenwichMeanSiderealTime",
   "localSiderealTime",
   "equatorialToHorizontal",
   "riseTransitSet",
   "computeTonight"
  ],
  "testCases": 20,
  "testGroups": 8,
  "meeusExamples": [
   "12.a",
   "13.b",
   "25.b",
   "47.a",
   "48.a",
   "7.a"
  ],
  "standardAltitude": {
   "sun": "-0.8333",
   "moon": "0.125",
   "star": "-0.5667"
  },
  "siderealRate": true,
  "tonightPassesPositionAtRequest": true,
  "almanacTakesPositionAtDayStart": true,
  "riseSetCommentSaysDayStart": true,
  "phaseNames": 8
 },
 "tonightCard": {
  "eventIds": [
   "sunset",
   "moonrise",
   "moonset",
   "sunrise"
  ],
  "accentTrue": [
   "moonrise"
  ],
  "serviceCallPassesNoZone": true,
  "defaultObserver": [
   "51.4779",
   "0"
  ],
  "roomLabelIsAConstant": true,
  "unavailableHeadline": true,
  "tonightLinksOnlyOnRest": true,
  "leadIsAccent": true,
  "formPageReadsEventId": true,
  "formSendsEventId": true
 },
 "depth": {
  "calculators": [
   "astronomical-night.ts",
   "chart-angles.ts",
   "daylight-extremes.ts",
   "equation-of-time.ts",
   "lunar-horizon-points.ts",
   "lunar-nodes.ts",
   "lunar-phase-calendar.ts",
   "moon-distance.ts",
   "moon-phase-detail.ts",
   "object-transit.ts",
   "planetary-hours.ts",
   "solar-horizon-points.ts",
   "solar-noon.ts",
   "solar-season-markers.ts",
   "solar-terms.ts",
   "sun-distance.ts",
   "twilight-phase-now.ts",
   "twilight-schedule.ts",
   "zodiac-position.ts"
  ],
  "testFiles": 20,
  "pageImports": [
   "astronomical-night",
   "chart-angles",
   "equation-of-time",
   "lunar-horizon-points",
   "moon-distance",
   "moon-phase-detail",
   "solar-horizon-points",
   "solar-noon",
   "twilight-phase-now",
   "zodiac-position"
  ],
  "headerSays19": true,
  "idleCallers": {
   "objectTransit": [],
   "sunDistanceDetail": [],
   "lunarNodes": [],
   "planetaryHours": [],
   "daylightExtremes": [],
   "solarTerms": []
  },
  "upcomingUses": [
   "lunarPhaseCalendar",
   "solarSeasonMarkers"
  ]
 },
 "links": {
  "roomMenu": [
   "/nyx",
   "/domains/nyx/satellites",
   "/domains/nyx/events?filter=meteor",
   "/domains/nyx/observation-log"
  ],
  "tonightLinks": [
   "/nyx",
   "/nyx/events",
   "/nyx/observation"
  ],
  "eventsLinks": [
   "/nyx",
   "/nyx/tonight"
  ],
  "eventsRowLinksToForm": true,
  "formLinks": [
   "/nyx/tonight"
  ],
  "linksToAlmanac": [],
  "linksToInnerPagesOutsideThem": [
   "apps/oshun/web/src/app/nyx/events/page.tsx",
   "apps/oshun/web/src/app/nyx/observation/NyxLogObservationForm.tsx",
   "apps/oshun/web/src/app/nyx/tonight/page.tsx",
   "apps/oshun/web/src/components/nyx/EventList.tsx"
  ]
 },
 "pages": {
  "memberPages": [
   "apps/oshun/web/src/app/nyx/events/page.tsx",
   "apps/oshun/web/src/app/nyx/observation/page.tsx",
   "apps/oshun/web/src/app/nyx/page.tsx",
   "apps/oshun/web/src/app/nyx/sky-almanac/page.tsx",
   "apps/oshun/web/src/app/nyx/tonight/page.tsx"
  ],
  "deepPages": 20,
  "deepLogHasNoServiceCall": true
 },
 "mobile": {
  "handlesNyxSections": true,
  "sampleLogs": 2,
  "readsHighlights": true,
  "eventActions": 2,
  "noObservationWrite": true,
  "nativeRelease": "V1.1",
  "currentRelease": "V1.0",
  "deferred": [
   "veritas",
   "metis"
  ]
 },
 "contract": {
  "families": 11,
  "types": 27,
  "perFamily": {
   "meteor-shower": 1,
   "eclipse": 6,
   "conjunction": 3,
   "occultation": 3,
   "transit": 3,
   "comet": 1,
   "aurora": 1,
   "satellite-pass": 2,
   "supermoon": 1,
   "seasonal-marker": 5,
   "deep-sky-peak": 1
  },
  "locationDependentFamilies": 9,
  "locationNotCompared": true,
  "eventFields": 19,
  "windowsMax": true,
  "sourcesMax": true,
  "excellentRule": true,
  "excellentMessage": true,
  "qualityBands": [
   "excellent",
   "good",
   "fair",
   "poor",
   "not-visible"
  ],
  "sourceKinds": 11,
  "contextOnly": [
   "bortle-light-pollution-atlas",
   "weather-provider"
  ],
  "horizonsBacks": 8,
  "conjunctionBackers": [
   "nasa-jpl-horizons"
  ],
  "loggedFields": 16,
  "contradictionRule": true,
  "contradictionMessage": true,
  "calendarFields": 25,
  "providers": [
   "google",
   "apple",
   "outlook",
   "ics-file"
  ],
  "syncStates": [
   "pending",
   "synced",
   "conflict",
   "disabled",
   "deleted"
  ],
  "remindersMax8": true,
  "appsThatParseIt": [],
  "excellentRuleRunsIn": [
   "libs/oshun/domain-nyx/src/sky-tonight-push.ts",
   "libs/oshun/persistence/src/contract-persistence-registry.ts"
  ],
  "eventsLibraryAppImporters": [
   "apps/nyx/pipelines/src/event-calculator.ts",
   "apps/nyx/pipelines/vitest.config.ts"
  ],
  "skyTonightRouteRefusesUnconfigured": true,
  "skyTonightSourceInServer": []
 },
 "note": {
  "guards": true,
  "onlyRule": true,
  "refusalWords": true,
  "ownerFromSignIn": true,
  "formLimits": [
   true,
   true
  ],
  "formKeepsNothingLocal": true,
  "pageSaysEyesOnly": true,
  "pageMarkedPrivate": true,
  "dualWrite": true,
  "paddedSite": true,
  "commentSaysNeutral": true,
  "eventTypeReceivesTarget": true,
  "listReadsShortRow": true,
  "lightDomeBecomesNotVisible": true
 },
 "log": {
  "recordFields": 17,
  "storageKey": true,
  "syncStates": "'local' | 'synced' | 'queued'",
  "savesQueuedFirst": true,
  "noReplay": true,
  "standIn": true,
  "samplesAppended": true,
  "compression": true
 },
 "actions": {
  "browserKey": true,
  "devDefaultMemory": true,
  "productionRefuses": true,
  "commentSaysNoFallback": true,
  "defaults": {
   "lead": "120",
   "cap": "2000",
   "cadence": true,
   "id": true
  },
  "deliveryTargets": [
   "mobile-push",
   "email",
   "sms",
   "calendar-sync"
  ],
  "bridgeReadsMemberState": true,
  "adapterDoesNotReadActionStore": true,
  "memberStateDurable": true,
  "requiredAtStart": true,
  "bridge": {
   "doesNotCreate": true,
   "failSoft": true,
   "sessionId": true,
   "address": true,
   "calledFromServer": true
  }
 },
 "agenda": {
  "kinds": [
   "lunar-phase",
   "solar-season",
   "meteor-shower",
   "solar-eclipse",
   "lunar-eclipse"
  ],
  "writtenEntries": 5,
  "writtenHaveNoSource": true,
  "routeOptions": [
   true,
   true
  ],
  "icsRoute": true
 },
 "neighbours": {
  "callers": {
   "resolveNyxTaraPerspectiveRelationship": [
    "apps/oshun/web/src/components/domains/nyx/nyxEventPageModels.ts"
   ],
   "buildNyxNisabaCosmologyOverlay": [
    "apps/oshun/mobile/src/navigation/mobileNyxObservationCompanion.ts",
    "apps/oshun/web/src/components/domains/nyx/nyxEventPageModels.ts"
   ],
   "buildNyxMetisStudyRelationships": [
    "apps/oshun/mobile/src/navigation/mobileNyxObservationCompanion.ts",
    "apps/oshun/web/src/components/domains/nyx/nyxEventPageModels.ts"
   ],
   "buildNyxVeritasGroundedExplainers": [
    "apps/oshun/web/src/components/domains/nyx/nyxEventPageModels.ts"
   ],
   "buildNyxEventAssistantExplainers": [
    "apps/oshun/web/src/components/domains/nyx/NyxEventDetailWorkspace.tsx"
   ]
  }
 },
 "captures": {
  "compact-observation.png": {
   "sha256": "a47cdb3e38874b1b9630f5f00f227d74e3b30db02ebada8e5ac81d0dd455666a",
   "size": [
    640,
    980
   ]
  },
  "computed-room.png": {
   "sha256": "a5cab519c8a7c0f6bfee40fffb102f9c0c8a56987accdf5b2a1bae336013fe67",
   "size": [
    1440,
    836
   ]
  },
  "sky-almanac.png": {
   "sha256": "3bd1ed3d339752b3f9b37a244b583c0fa60cbc291cfc610150747fb4f402a71f",
   "size": [
    880,
    980
   ]
  },
  "tonight-timeline.png": {
   "sha256": "3f767b2b82f82185fb81a6a9b808e3c0c441d17216c23153ff82013094cfa2fb",
   "size": [
    880,
    931
   ]
  },
  "upcoming-events.png": {
   "sha256": "a6f429cc7c7fb44e5f1243b21192e815dce8ad83d50926275e0fe52586905ad9",
   "size": [
    880,
    980
   ]
  }
 },
 "captureRecord": {
  "Consumer room renders the BFF-computed sky instead of its unavailable state": {
   "bff": "local actual service",
   "unavailable": false,
   "observer": "default Greenwich"
  },
  "Tonight orders computed events and gives each later event an observation handoff": {
   "logLinks": 3,
   "target": "/nyx/observation?eventId=…"
  },
  "Sky Almanac renders the computed depth-page view model": {
   "available": true,
   "sections": 4,
   "rows": 14
  },
  "Compact observation route renders an event-anchored private service-write form": {
   "eventId": "moonrise",
   "conditionChoices": 4,
   "defaultCondition": "clear"
  },
  "Upcoming-events route filters to Nyx and exposes the mixed computed/authored ICS feed": {
   "eventCount": 36,
   "domains": [
    "nyx"
   ],
   "calendar": "/v1/nyx/events.ics"
  }
 }
}
```

## Two moonrises: where each page takes the Moon's position

The rise and set function, and its comment:

`git show 1ceae52c7896:libs/oshun/domain-nyx/src/ephemeris.ts`, lines 475 to 488:

```text
  475  /**
  476   * Rise / transit / set times (UT) for a body of given apparent position on the
  477   * date, for an observer (Meeus ch. 15, single-date approximation: the body's
  478   * position is taken at 0h UT — accurate to ~a minute for the Sun, more for the
  479   * fast-moving Moon).
  480   */
  481  export function riseTransitSet(
  482    position: Pick<EquatorialPosition, 'rightAscension' | 'declination'>,
  483    date: Date,
  484    latitude: number,
  485    longitudeEast: number,
  486    standardAltitude: number
  487  ): RiseTransitSet {
  488    const day0 = startOfUtcDay(date);
```

The tonight calculation passes the position computed for the request instant (`core` is `computeNightSky(date)`):

`git show 1ceae52c7896:libs/oshun/domain-nyx/src/ephemeris.ts`, lines 550 to 581:

```text
  550  export function computeTonight(date: Date, location: ObserverLocation): TonightSky {
  551    const core = computeNightSky(date);
  552    return {
  553      ...core,
  554      location,
  555      sunHorizontal: equatorialToHorizontal(
  556        core.sun,
  557        core.julianDay,
  558        location.latitude,
  559        location.longitudeEast
  560      ),
  561      moonHorizontal: equatorialToHorizontal(
  562        core.moon,
  563        core.julianDay,
  564        location.latitude,
  565        location.longitudeEast
  566      ),
  567      sunRiseTransitSet: riseTransitSet(
  568        core.sun,
  569        date,
  570        location.latitude,
  571        location.longitudeEast,
  572        STANDARD_ALTITUDE.sun
  573      ),
  574      moonRiseTransitSet: riseTransitSet(
  575        core.moon,
  576        date,
  577        location.latitude,
  578        location.longitudeEast,
  579        STANDARD_ALTITUDE.moon
  580      ),
  581    };
```

The almanac's Moon points take the position at the start of the UTC day:

`git show 1ceae52c7896:libs/oshun/domain-nyx/src/depth/lunar-horizon-points.ts`, lines 44 to 54:

```text
   44  export function lunarHorizonPoints(date: Date, location: ObserverLocation): LunarHorizonPoints {
   45    const day0 = startOfUtcDay(date);
   46    const moon = moonPosition(toJulianDay(day0));
   47    const rts = riseTransitSet(
   48      moon,
   49      day0,
   50      location.latitude,
   51      location.longitudeEast,
   52      STANDARD_ALTITUDE.moon
   53    );
   54  
```

## Tonight: the lead event and the links

`git show 1ceae52c7896:apps/oshun/web/src/app/nyx/tonight/page.tsx`, lines 35 to 36:

```text
   35    const headline = data.events.find((event) => event.accent) ?? data.events[0];
   36    const rest = data.events.filter((event) => event.id !== headline?.id);
```

`git show 1ceae52c7896:apps/oshun/web/src/app/nyx/tonight/page.tsx`, lines 119 to 119:

```text
  119              {rest.map((event) => (
```

`git show 1ceae52c7896:apps/oshun/web/src/app/nyx/tonight/page.tsx`, lines 164 to 168:

```text
  164                  </div>
  165                  <Link
  166                    href={`/nyx/observation?eventId=${encodeURIComponent(event.id)}`}
  167                    style={{
  168                      fontFamily: MONO_L,
```

`git show 1ceae52c7896:apps/oshun/web/src/app/nyx/tonight/page.tsx`, lines 190 to 200:

```text
  190            }}
  191          >
  192            <LBtn kind="ghost" size="md" href="/nyx">
  193              ← Back to Nyx
  194            </LBtn>
  195            <LBtn kind="ghost" size="md" href="/nyx/events">
  196              Upcoming events
  197            </LBtn>
  198            <LBtn kind="primary" size="md" href="/nyx/observation">
  199              Plan an observation
  200            </LBtn>
```

The card marks one event as the accent:

`git show 1ceae52c7896:libs/oshun/domain-nyx/src/tonight-card.ts`, lines 139 to 146:

```text
  139        event: {
  140          id: 'moonrise',
  141          name: `Moonrise — ${phaseLabel.toLowerCase()} moon`,
  142          detail: `${phaseLabel} moon, ${illuminatedPct}% illuminated, rises (${zone}).`,
  143          accent: true,
  144        },
  145      },
  146      {
```

## The note: guards, the one rule, and the two rows

`git show 1ceae52c7896:apps/oshun/bff/src/routes/domain-stubs.ts`, lines 2358 to 2380:

```text
 2358      '/v1/nyx/observations',
 2359      { preHandler: [originGuard, csrfGuard, collectionsAuthGuard] },
 2360      async (request, reply) => {
 2361        reply.header('cache-control', 'no-store');
 2362        const body = request.body ?? {};
 2363        const target = (body.targetLabel ?? '').trim();
 2364        if (target.length < 2) {
 2365          return reply.code(422).send({
 2366            code: 'observation_target_missing',
 2367            message: 'Tell Nyx what you looked at — a planet, a constellation, a satellite.',
 2368          });
 2369        }
 2370        const stored = await domainStubsStore.observations.add({
 2371          targetLabel: target,
 2372          eventId: body.eventId ?? null,
 2373          observedAtIso: body.observedAtIso ?? new Date().toISOString(),
 2374          conditions: body.conditions ?? 'clear',
 2375          note: (body.note ?? '').trim() || null,
 2376          ownerUserId: requireGuardedAuthContext(request).userId,
 2377        });
 2378        return reply.code(202).send({
 2379          generatedAt: new Date().toISOString(),
 2380          observationId: stored.observationId,
```

`git show 1ceae52c7896:apps/oshun/bff/src/routes/domain-stubs-postgres.ts`, lines 1352 to 1418:

```text
 1352          // Canonical v1_nyx_logged_observation dual-write. The canonical schema
 1353          // is much richer than the stub (full site + sky-condition + equipment
 1354          // + attachments). Where the stub doesn't carry a field we populate
 1355          // with the safest neutral value so the canonical row still parses.
 1356          const skyCondition = {
 1357            bortleClass: null,
 1358            seeing: null,
 1359            transparency: null,
 1360            weather: null,
 1361            cloudCoverPercent:
 1362              input.conditions === 'clear'
 1363                ? 0
 1364                : input.conditions === 'partial'
 1365                  ? 50
 1366                  : input.conditions === 'overcast'
 1367                    ? 100
 1368                    : null,
 1369            moonPhasePercent: null,
 1370          };
 1371          const site = {
 1372            latitude: 0,
 1373            longitude: 0,
 1374            elevationMeters: 0,
 1375            timezone: 'UTC',
 1376            regionName: 'unspecified',
 1377            geohash: null,
 1378          };
 1379          const qualityRating =
 1380            input.conditions === 'clear'
 1381              ? 'good'
 1382              : input.conditions === 'partial'
 1383                ? 'fair'
 1384                : input.conditions === 'overcast'
 1385                  ? 'poor'
 1386                  : 'not-visible';
 1387          const canonicalPayload = {
 1388            id,
 1389            eventId: input.eventId,
 1390            targetLabel: input.targetLabel,
 1391            observedAt: input.observedAtIso,
 1392            conditions: input.conditions,
 1393            note: input.note,
 1394          };
 1395          await pool.query(
 1396            `INSERT INTO v1_nyx_logged_observation
 1397               (id, attachments, duration_minutes, equipment, event_id, event_type,
 1398                notes, observed_at, quality_rating, shared_scope, site, sky_condition,
 1399                source_client, timestamps, user_id, visibility_scope,
 1400                tenant_id, contract_schema, contract_version, source_record_id, payload_hash)
 1401             VALUES ($1, '[]'::jsonb, 0, NULL, $2, $3,
 1402                     $4, $5, $6, 'private', $7::jsonb, $8::jsonb,
 1403                     'web-app', $9::jsonb, $12, 'local',
 1404                     $10, 'v1.nyx.logged-observation', '1.0.0', $1, $11)
 1405             ON CONFLICT (tenant_id, contract_schema, source_record_id) DO NOTHING`,
 1406            [
 1407              id,
 1408              input.eventId,
 1409              input.targetLabel,
 1410              input.note,
 1411              input.observedAtIso,
 1412              qualityRating,
 1413              JSON.stringify(site),
 1414              JSON.stringify(skyCondition),
 1415              JSON.stringify({ createdAt: now, updatedAt: now }),
 1416              HOUSE_TENANT_ID,
 1417              payloadHashHex(canonicalPayload),
 1418              input.ownerUserId,
```

## The two stores at the pin

`git show 1ceae52c7896:apps/oshun/bff/src/routes/nyx.ts`, lines 112 to 119:

```text
  112  export interface RegisterNyxRoutesOptions {
  113    /**
  114     * Canonical owner for the legacy aggregate event-action projection.
  115     * Production does not fall back to the replica-local compatibility store.
  116     */
  117    readonly eventActionStateStore?: NyxEventActionStateStore;
  118  }
  119  
```

`git show 1ceae52c7896:apps/oshun/bff/src/routes/nyx.ts`, lines 263 to 264:

```text
  263    const eventActionStateStore =
  264      options.eventActionStateStore ?? (isProductionRuntime() ? null : nyxEventActionStateStore);
```

`git show 1ceae52c7896:apps/oshun/bff/src/routes/nyx.ts`, lines 728 to 732:

```text
  728      if (!eventActionStateStore) {
  729        reply.code(503).send({
  730          message: 'The Nyx event-action authority is unavailable.',
  731          reason: 'nyx_event_action_authority_not_configured',
  732        });
```

`git show 1ceae52c7896:apps/oshun/bff/src/nyx/in-process-adapter.ts`, lines 389 to 391:

```text
  389      async getEventReminders(input): Promise<NyxEventReminder[]> {
  390        return nyxMemberStateStore.listReminders(input.userId).map(reminderToPayload);
  391      },
```

`git show 1ceae52c7896:apps/oshun/bff/src/reminders/nyx-reminder-bridge.ts`, lines 1 to 15:

```text
    1  // ---------------------------------------------------------------------------
    2  // Nyx event-reminder DELIVERY bridge.
    3  //
    4  // Nyx has its own opt-in event-reminder subsystem (users set reminders via the
    5  // Nyx service: getEventReminders / setEventReminder / toggleEventReminder). This
    6  // bridge does NOT create reminders — it DELIVERS the ones users already opted
    7  // into, through the BFF's in-app reminder pipeline. Each delivery worker tick
    8  // sweeps the BFF's known users, reads their enabled Nyx reminders, and schedules
    9  // an in-app reminder per event (deduped by a stable per-user/per-reminder
   10  // session id, so re-emitting every tick is a no-op). In-app delivery is additive
   11  // to Nyx's own push/email/sms/calendar channels, never a duplicate of them.
   12  //
   13  // Fail-soft per user: a Nyx read that throws skips that user, never aborts the
   14  // sweep.
   15  // ---------------------------------------------------------------------------
```

`git show 1ceae52c7896:apps/oshun/bff/src/reminders/nyx-reminder-bridge.ts`, lines 36 to 62:

```text
   36  ): Promise<ScheduledReminder[]> {
   37    const sessions: UpcomingV3Session[] = [];
   38    for (const userId of input.userIds) {
   39      let reminders: readonly NyxEventReminder[];
   40      try {
   41        reminders = await input.getEventReminders(userId);
   42      } catch {
   43        continue; // fail-soft: a Nyx outage for one user never aborts the sweep
   44      }
   45      for (const reminder of reminders) {
   46        if (!reminder.enabled) continue;
   47        sessions.push({
   48          recipientId: userId,
   49          recipient: {}, // in-app delivery is keyed by recipientId; no external target needed
   50          channel: 'push',
   51          tenantId: '',
   52          tenantLabel: 'Oshun',
   53          sessionId: `nyx-event:${userId}:${reminder.reminderId}`,
   54          title: reminder.eventTitle,
   55          startsAtIso: reminder.reminderTime,
   56          canonicalHttpsUrl: `https://oshun.app/nyx/events/${reminder.eventId}`,
   57        });
   58      }
   59    }
   60    return produceV3SessionReminders(sessions);
   61  }
   62  
```

## The contract rules the slides quote

`git show 1ceae52c7896:libs/contracts/src/nyx/index.ts`, lines 279 to 294:

```text
  279      if (
  280        window.qualityBand === 'excellent' &&
  281        (window.qualityInputs.bortleClass > 4 ||
  282          window.qualityInputs.cloudCoverPercent > 25 ||
  283          !['astronomical-twilight', 'night'].includes(window.qualityInputs.astronomicalTwilight))
  284      ) {
  285        ctx.addIssue({
  286          code: z.ZodIssueCode.custom,
  287          message: 'Excellent windows require dark enough skies, low clouds, and night conditions.',
  288          path: ['qualityBand'],
  289        });
  290      }
  291    });
  292  export type ObservationWindow = z.infer<typeof ObservationWindowSchema>;
  293  
  294  export const CelestialBodyRefSchema = z.object({
```

`git show 1ceae52c7896:libs/contracts/src/nyx/index.ts`, lines 815 to 826:

```text
  815      if (
  816        observation.qualityRating === 'not-visible' &&
  817        observation.skyCondition.cloudCoverPercent !== null &&
  818        observation.skyCondition.cloudCoverPercent < 20
  819      ) {
  820        ctx.addIssue({
  821          code: z.ZodIssueCode.custom,
  822          message: 'qualityRating "not-visible" is inconsistent with clear-sky cloud cover.',
  823          path: ['qualityRating'],
  824        });
  825      }
  826    });
```

`git show 1ceae52c7896:libs/contracts/src/nyx/index.ts`, lines 722 to 743:

```text
  722  const predictionSourceFamilySupport: Record<PredictionSourceKind, readonly SkyEventFamily[]> = {
  723    'nasa-jpl-horizons': [
  724      'eclipse',
  725      'conjunction',
  726      'occultation',
  727      'transit',
  728      'comet',
  729      'supermoon',
  730      'seasonal-marker',
  731      'deep-sky-peak',
  732    ],
  733    'nasa-jpl-small-body-db': ['comet', 'occultation'],
  734    'imo-meteor-calendar': ['meteor-shower'],
  735    'iers-bulletin-a': ['eclipse', 'occultation', 'transit', 'seasonal-marker'],
  736    'noaa-swpc-geomagnetic-forecast': ['aurora'],
  737    'weather-provider': [],
  738    'bortle-light-pollution-atlas': [],
  739    'tle-provider': ['satellite-pass'],
  740    'minor-planet-center': ['comet', 'occultation'],
  741    'usno-astronomical-applications': ['eclipse', 'supermoon', 'seasonal-marker'],
  742    'gaia-catalog': ['occultation', 'deep-sky-peak'],
  743  };
```

`git show 1ceae52c7896:libs/contracts/src/nyx/index.ts`, lines 710 to 720:

```text
  710  const locationDependentFamilies = new Set<SkyEventFamily>([
  711    'meteor-shower',
  712    'eclipse',
  713    'conjunction',
  714    'occultation',
  715    'transit',
  716    'comet',
  717    'aurora',
  718    'satellite-pass',
  719    'deep-sky-peak',
  720  ]);
```

## The agenda's written entries

`git show 1ceae52c7896:libs/oshun/domain-nyx/src/upcoming-events.ts`, lines 63 to 109:

```text
   63  const FEATURED_UPCOMING_EVENTS: readonly FeaturedUpcomingEventTemplate[] = [
   64    {
   65      id: 'total-lunar-eclipse-2026-03-03',
   66      kind: 'lunar-eclipse',
   67      title: 'Total lunar eclipse',
   68      startIso: '2026-03-03T09:50:00.000Z',
   69      endIso: '2026-03-03T13:17:00.000Z',
   70      summary:
   71        'The Moon passes through Earth shadow, with totality visible across western North America, Australia, New Zealand, and East Asia.',
   72    },
   73    {
   74      id: 'total-solar-eclipse-2026-08-12',
   75      kind: 'solar-eclipse',
   76      title: 'Total solar eclipse',
   77      startIso: '2026-08-12T17:02:00.000Z',
   78      endIso: '2026-08-12T18:32:00.000Z',
   79      summary:
   80        'Totality crosses Greenland, Iceland, Spain, Russia, and a small part of Portugal; partial phases reach a wider region.',
   81    },
   82    {
   83      id: 'partial-lunar-eclipse-2026-08-28',
   84      kind: 'lunar-eclipse',
   85      title: 'Partial lunar eclipse',
   86      startIso: '2026-08-28T04:12:00.000Z',
   87      endIso: '2026-08-28T07:01:00.000Z',
   88      summary:
   89        'A deep partial lunar eclipse is visible from the East Pacific, the Americas, Europe, Africa, and western Asia.',
   90    },
   91    {
   92      id: 'perseid-meteor-shower-peak-2026',
   93      kind: 'meteor-shower',
   94      title: 'Perseid meteor shower peak',
   95      startIso: '2026-08-12T22:00:00.000Z',
   96      endIso: '2026-08-13T05:00:00.000Z',
   97      summary:
   98        'A reliable summer meteor display, best after midnight from dark northern skies with no optical aid required.',
   99    },
  100    {
  101      id: 'geminid-meteor-shower-peak-2026',
  102      kind: 'meteor-shower',
  103      title: 'Geminid meteor shower peak',
  104      startIso: '2026-12-14T22:00:00.000Z',
  105      endIso: '2026-12-15T05:00:00.000Z',
  106      summary:
  107        'Often the strongest annual shower, with bright meteors and a cold-weather observing window.',
  108    },
  109  ];
```

## The capture record (9 September 2026)

`assets/nyx-observe-loop/capture.json`, as the publication holds it:

```json
{
 "completed": true,
 "sourceRevision": "1ceae52c7896a59ac74a4429d410f3218f0b91c6",
 "host": {
  "kind": "actual-next-and-bff-development-routes",
  "origin": "http://127.0.0.1:3077",
  "bffOrigin": "http://127.0.0.1:4077",
  "bffPersistence": "development configuration",
  "peripheralConsentOverlaySuppressed": true
 },
 "checks": [
  {
   "name": "Consumer room renders the BFF-computed sky instead of its unavailable state",
   "passed": true,
   "observed": {
    "bff": "local actual service",
    "unavailable": false,
    "observer": "default Greenwich"
   }
  },
  {
   "name": "Tonight orders computed events and gives each later event an observation handoff",
   "passed": true,
   "observed": {
    "logLinks": 3,
    "target": "/nyx/observation?eventId=…"
   }
  },
  {
   "name": "Sky Almanac renders the computed depth-page view model",
   "passed": true,
   "observed": {
    "available": true,
    "sections": 4,
    "rows": 14
   }
  },
  {
   "name": "Compact observation route renders an event-anchored private service-write form",
   "passed": true,
   "observed": {
    "eventId": "moonrise",
    "conditionChoices": 4,
    "defaultCondition": "clear"
   }
  },
  {
   "name": "Upcoming-events route filters to Nyx and exposes the mixed computed/authored ICS feed",
   "passed": true,
   "observed": {
    "eventCount": 36,
    "domains": [
     "nyx"
    ],
    "calendar": "/v1/nyx/events.ics"
   }
  }
 ],
 "images": [
  {
   "src": "assets/nyx-observe-loop/computed-room.png",
   "file": "computed-room.png",
   "width": 1440,
   "height": 836,
   "sha256": "a5cab519c8a7c0f6bfee40fffb102f9c0c8a56987accdf5b2a1bae336013fe67",
   "caption": "Actual `/nyx` route · local BFF · ephemeris-computed default-observer sky.",
   "alt": "Nyx consumer room with a dark sky chart, computed lunar state, an ordered event rail and a Nisaba cross-link."
  },
  {
   "src": "assets/nyx-observe-loop/tonight-timeline.png",
   "file": "tonight-timeline.png",
   "width": 880,
   "height": 931,
   "sha256": "3f767b2b82f82185fb81a6a9b808e3c0c441d17216c23153ff82013094cfa2fb",
   "caption": "Actual `/nyx/tonight` route · computed event order · observation handoff links verified.",
   "alt": "Nyx tonight timeline with a highlighted lead event, later sky events and Log it links into the compact observation form."
  },
  {
   "src": "assets/nyx-observe-loop/sky-almanac.png",
   "file": "sky-almanac.png",
   "width": 880,
   "height": 980,
   "sha256": "3bd1ed3d339752b3f9b37a244b583c0fa60cbc291cfc610150747fb4f402a71f",
   "caption": "Actual `/nyx/sky-almanac` route · four computed sections · fourteen rows.",
   "alt": "Nyx Sky Almanac showing computed Sun, Moon, chart-angle and darkness sections for the default observer."
  },
  {
   "src": "assets/nyx-observe-loop/compact-observation.png",
   "file": "compact-observation.png",
   "width": 640,
   "height": 980,
   "sha256": "a47cdb3e38874b1b9630f5f00f227d74e3b30db02ebada8e5ac81d0dd455666a",
   "caption": "Actual `/nyx/observation?eventId=moonrise` route · private compact service-write form.",
   "alt": "Nyx compact private observation form with target, time, four condition choices, optional note and log action."
  },
  {
   "src": "assets/nyx-observe-loop/upcoming-events.png",
   "file": "upcoming-events.png",
   "width": 880,
   "height": 980,
   "sha256": "a6f429cc7c7fb44e5f1243b21192e815dce8ad83d50926275e0fe52586905ad9",
   "caption": "Actual `/nyx/events` route · ephemeris-solved plus authored featured agenda · ICS action verified.",
   "alt": "Nyx upcoming-events agenda with astronomical event rows and a Subscribe dot-ICS action."
  }
 ],
 "accessibility": [
  {
   "label": "Nyx computed consumer room",
   "violations": [],
   "passes": 9
  },
  {
   "label": "Nyx tonight timeline",
   "violations": [],
   "passes": 5
  },
  {
   "label": "Nyx computed Sky Almanac",
   "violations": [],
   "passes": 9
  },
  {
   "label": "Nyx compact observation form",
   "violations": [],
   "passes": 16
  },
  {
   "label": "Nyx upcoming events",
   "violations": [],
   "passes": 5
  }
 ],
 "errors": [],
 "scope": "Actual Next and BFF development routes at the pinned Nyx implementation, using the BFF default Greenwich observer and the capture date. The images prove route rendering and local service behavior, not deployed-service, cross-device, provider-OAuth or human acceptance."
}
```

## Draft render

`render.py` rendered the 51 slides with the builder's own functions against
publication `42735307-5dde-8345-bbcb-82b9e750d081`. At 1280x720 the whole Narrate
control is inside the viewport on 51 of 51 slides, and at 320 px no slide scrolls
sideways on 51 of 51, under both font profiles (the host's, and DejaVu faces in
place of Arial and Georgia). axe-core 4.11.4 found no violation in 102 scans (51
slides at two widths). The chapter budget guard measures 6 table-like slides of 51,
12 diagram slides, 5 captures, no title over nine words, a cover first and a close last.

## What is not shown here

No page was opened and no service was run for this rewrite. Which moonrise time is
nearer the true one was not worked out. The phone app was read, not run. The
seventeen deep tools other than the observation log and the event page were not read.
