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:
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:
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:
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:
{
"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:
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:
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:
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:
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:
119 {rest.map((event) => (
git show 1ceae52c7896:apps/oshun/web/src/app/nyx/tonight/page.tsx, lines 164 to 168:
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:
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:
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:
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:
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:
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:
263 const eventActionStateStore =
264 options.eventActionStateStore ?? (isProductionRuntime() ? null : nyxEventActionStateStore);
git show 1ceae52c7896:apps/oshun/bff/src/routes/nyx.ts, lines 728 to 732:
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:
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:
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:
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:
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:
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:
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:
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:
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:
{
"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.