Skip to content

feat(path): add live PATH rail coverage - #25

Merged
joncrangle merged 1 commit into
mainfrom
feat/path-transit
Nov 14, 2026
Merged

joncrangle merged 1 commit into
mainfrom
feat/path-transit

Conversation

@joncrangle

Copy link
Copy Markdown
Owner

Summary

Add PATH as an experimental rail agency with live station countdowns, five current service patterns, 13 drawn stations and 29 seeded boarding stops.

Official network countdown board
  → declared station/service/direction mappings
  → observation-anchored live departures
  → PATH schematic and registered partner transfers

Incident messages + CMS station notes + planned-service fragments
  → shared TypeScript/Rust normalizers
  → scoped advisories with failure-aware freshness

The generic station-board adapter now supports network documents and numeric-string countdowns. Polls share the document across platforms; cached reads preserve absolute predictions and recheck observation age. Synthetic observation identities do not depend on array positions or claim to identify a physical train. PATH publishes no verified GPS source.

Closes #15.

Evidence

  • Before: PATH was absent. Its board uses native station codes and service colors, without GTFS trip identities.
    After: Live Newark, Newport and 33 Street boards show source-timed departures with the correct destinations through Worker and self-hosted endpoints. The overnight blue/orange combination maps to the published via-Hoboken service.
  • Static GTFS downloaded November 13, 2026 still ends its timetable on June 1, 2026. It is used for verified topology only. The current official maps and rider configuration confirm the five service patterns; two archived shuttle routes are excluded. No timetable times become live predictions.
  • The complete advisory contract produces 11 notices. Both served runtimes were observed live after an upstream recovery. The official incident endpoint also intermittently timed out during verification; snapshots correctly became stale while the other sources remained available. Forced total failure returns failure, never all-clear.
  • Independent Terra Standards and Spec reviews found validation differences and mixed recovery/delay attribution. Fixed both with shared parity fixtures and a regression proving that recovery on one route cannot clear another route's continuing delay.
  • Seeded SQLite and local D1. All 29 boarding stops fall inside coverage; Automatic selection remains unchanged at 146,543 existing regional stop points.
  • Explicit transfers preserve Penn's existing facilities and boarding identities. The Penn walking node opens the real LIRR card, including separate partner departure groups, and switches to LIRR. The final interchange regeneration reports zero changed rows, no walking fallbacks and only the 149 pre-existing conflicts on unrelated maps.
  • Inspected the original schematic at readable desktop/mobile zoom, including termini, central branches and full/compact interchange presentation. Accessibility comes from the operator's current station configuration.
  • Passed 4,555 unit tests, 107 integration tests and 112 Rust tests; TypeScript, lint, formatting, production build, Clippy, Rust formatting, agency/docs/attribution/alert identity/coverage geography checks.

Sources checked November 13, 2026: live board, official alerts, planned changes, current rider configuration, weekday map, weekend map. Map revision 236_26 v1_r2. City presets use the corresponding GTFS parent coordinates for Newark, Journal Square, Hoboken, WTC and 33 Street.

Merge Danger

Door: Two-way

No schema migration. PATH is seeded locally only; production needs its initial targeted seed after deployment and review.

Blast Radius: Feeds

Network station mappings and new advisory parsers are opt-in. Shared mapped-board caching now stores the wire document and validates source age on each read. The operator's intermittent incident-endpoint failures remain visible as stale snapshots.

@joncrangle
joncrangle marked this pull request as ready for review November 14, 2026 01:06
@joncrangle
joncrangle merged commit 037bbbd into main Nov 14, 2026
2 checks passed
@joncrangle
joncrangle deleted the feat/path-transit branch November 14, 2026 01:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add PATH as an experimental rail agency

1 participant