Edge Feed Snapshot Health Update

This update makes the Cloudflare Worker edge snapshot fallback easier to diagnose and harder to deploy incorrectly.

Visual overview

Primary diagram

System map

This update makes the Cloudflare Worker edge snapshot fallback easier to diagnose and harder to deploy incorrectly.

Render the repository-owned system map when you need it.

Diagram is not rendered yet.

View as text

Edge Feed Snapshot Health Update

This update makes the Cloudflare Worker edge snapshot fallback easier to diagnose and harder to deploy incorrectly.

flowchart TB
  accTitle: Edge Feed Snapshot Health Update
  accDescr {
    This update makes the Cloudflare Worker edge snapshot fallback easier to diagnose and harder to deploy incorrectly.
  }
  A["Edge Feed Snapshot Health Update"] --> B["updates/README_EDGE_FEED_SNAPSHOT_HEALTH_UPDATE.md"]
  B --> C["Auto-generated placeholder diagram"]

Edge Feed Snapshot Health Update

This update makes the Cloudflare Worker edge snapshot fallback easier to diagnose and harder to deploy incorrectly.

Changes

/public-feed-snapshot/status now returns an inspectable JSON status payload with:
- ready
- kvBound
- configured
- enabled
- status
- articleCount
- ageSeconds
- version
- message
The status endpoint returns HTTP 200 for dashboard inspection, even when the fallback is not ready.
The actual fallback feed endpoint still returns an error when KV is missing or no snapshot exists.
Wrangler config generation now requires NUTSNEWS_KV_NAMESPACE_ID.
Worker CI provides a fake KV namespace id for type/config checks.
A scheduled/manual GitHub Action checks the live Worker status endpoint and feed payload.

Healthy status

Expected healthy payload:

{
  "ready": true,
  "kvBound": true,
  "status": "hit",
  "articleCount": 120,
  "version": 1
}

Recovery

If status shows status: "unbound":

Export NUTSNEWS_KV_NAMESPACE_ID.
Regenerate Wrangler configs.
Deploy the Worker shards.
Run one Worker refresh to publish a new edge snapshot.
Recheck /public-feed-snapshot/status.