Local dev harness: snapshot all data sources to S3 and replay them offline #128

New issue

Closed

opened 2026-07-21 03:04:27 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-07-21 03:04:27 +00:00

Member

Kai asked for a local dev harness: take a snapshot of every eco-app data source, push it to S3, and pull it back down to iterate against without touching the live game server.

Shape landed:

src/eco_snapshot/ - capture pulls every upstream endpoint the app consumes (catalog-driven fan-out over /datasets/flatlist series + action CSVs and /api/v1/exporter/specieslist, plus the static civics/map/users surfaces and the jobs/stores/replay mod endpoints) into a manifest-indexed snapshot dir, byte-for-byte. serve replays it as a localhost fixture eco server, with significant-param matching so volatile day windows still hit the captured series.
Makefile / ward verbs - snapshot-capture, snapshot-push, snapshot-pull, snapshot-serve, http-offline. Push/pull move tarballs through s3://kai-game-backups/eco-app/snapshots/ (timestamped + latest).
Verified end-to-end against the live server (cycle 14 day 17, 317 responses): capture, push, pull on a wiped dir, fixture serve, fused app fully offline with real KPIs and player data.

Docs: docs/snapshot-harness.md.

Kai asked for a local dev harness: take a snapshot of every eco-app data source, push it to S3, and pull it back down to iterate against without touching the live game server. Shape landed: * `src/eco_snapshot/` - `capture` pulls every upstream endpoint the app consumes (catalog-driven fan-out over `/datasets/flatlist` series + action CSVs and `/api/v1/exporter/specieslist`, plus the static civics/map/users surfaces and the jobs/stores/replay mod endpoints) into a manifest-indexed snapshot dir, byte-for-byte. `serve` replays it as a localhost fixture eco server, with significant-param matching so volatile day windows still hit the captured series. * Makefile / ward verbs - `snapshot-capture`, `snapshot-push`, `snapshot-pull`, `snapshot-serve`, `http-offline`. Push/pull move tarballs through `s3://kai-game-backups/eco-app/snapshots/` (timestamped + `latest`). * Verified end-to-end against the live server (cycle 14 day 17, 317 responses): capture, push, pull on a wiped dir, fixture serve, fused app fully offline with real KPIs and player data. Docs: `docs/snapshot-harness.md`.

coilyco-ops referenced this issue from a commit

2026-07-21 03:05:45 +00:00

feat: snapshot dev harness - capture eco data sources, S3 push/pull, offline fixture server (closes #128)

coilyco-ops closed this issue

2026-07-21 03:05:45 +00:00

coilyco-ops referenced this issue

2026-07-21 03:06:01 +00:00

Retired coily CLI still referenced by make http and resolve-eco-target.sh #129

coilyco-ops referenced this issue

2026-07-21 03:06:06 +00:00

Snapshot capture depth: full worldlayer rasters and replay events beyond the first 1000 #130

coilyco-ops referenced this issue