feat: ci docs #3

Merged
Noel merged 9 commits from feat/ci-docs into main 2026-11-14 08:34:35 +00:00
9 Commits
Author SHA1 Message Date
Noel 4c9d271f61 Merge branch 'main' into feat/ci-docs
ci / check (push) Successful in 54s
ci / check (pull_request) Successful in 59s
2026-11-14 08:32:27 +00:00
Noel Sabia f4693af748 ci: fix setup-go cache and refresh docs
ci / check (push) Successful in 54s
ci / check (pull_request) Successful in 56s
setup-go@v5 aborts when go.sum is missing, and this stdlib-only module has none. Disable the action cache and cap the job at 10 minutes.

Lead the README with what the service does and a runnable quick start, fix stale contract and cache comments, and remove comments that only restate the code.
2026-11-14 09:14:09 +01:00
Noel Sabia 80c8eeb0b9 merge: train e2e, 120-client SSE load, fallback 2026-11-14 07:39:11 +01:00
Noel Sabia 8a13257a6e chore: normalize load timestamps and mark local test credentials 2026-11-14 06:44:44 +01:00
Noel Sabia b3146e0862 docs: record 120-client SSE load, train and fallback results
Add staffing timing to the integration harness and commit the verified
run: small train 171ms, forecast train 3.6s, SSE propagation 15ms,
120/120 clients for 300s with 0 drops and p95 5.6ms, 20 heartbeats at
15s, FastAPI-down fallback from the snapshot, and recovery in 1.6s.
2026-11-14 06:43:30 +01:00
Noel Sabia ac7ceca7ec test: repeatable integration harness and 120-client SSE load tool
Add scripts/integration.sh, which starts the real FastAPI and Go API,
trains small and forecast through POST /api/train, checks SSE scenario
propagation, heartbeat, reconnect, then kills FastAPI to verify snapshot
and last-good forecast fallback before restarting it for recovery.

Add scripts/sse-load, a standard-library load generator that holds 120
concurrent SSE streams for five minutes, posts scenario changes, records
p50/p95/p99 event latency, drops and heartbeat cadence, and exits
non-zero when a contract threshold is missed. Add unit tests, make
targets and README documentation.
2026-11-14 06:33:29 +01:00
Noel Sabia e9f80b9ce7 merge: runtime snapshot cache with exponential backoff 2026-11-14 06:15:06 +01:00
Noel Sabia aa6bb23e24 feat: runtime bootstrap snapshot cache with backoff 2026-11-14 06:08:53 +01:00
Noel Sabia 08f60a14d1 merge: CI checks and numeric runtime user 2026-11-14 05:44:44 +01:00