Issue 104 Edge Feed Snapshot Fallback Update

This update implements GitHub issue #104.

Visual overview

Primary diagram

System map

This update implements GitHub issue #104.

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

Diagram is not rendered yet.

View as text

Issue 104 Edge Feed Snapshot Fallback Update

This update implements GitHub issue #104.

flowchart TB
  accTitle: Issue 104 Edge Feed Snapshot Fallback Update
  accDescr {
    This update implements GitHub issue #104.
  }
  A["Issue 104 Edge Feed Snapshot Fallback Update"] --> B["updates/README_ISSUE_104_EDGE_FEED_SNAPSHOT_FALLBACK.md"]
  B --> C["Auto-generated placeholder diagram"]

Issue 104 Edge Feed Snapshot Fallback Update

This update implements GitHub issue #104.

Added

Worker /public-feed-snapshot endpoint backed by Cloudflare KV
Worker /public-feed-snapshot/status endpoint
Worker KV publish step after refresh_public_feed_snapshot
Web fallback from /api/articles to the Worker edge snapshot
Homepage initial feed and category-section fallback helpers
/admin/edge-snapshot status dashboard
Response headers for edge snapshot age, version, and article count
Offline web E2E coverage for Supabase outage recovery through edge snapshot

Required config

Web:

NUTSNEWS_EDGE_FEED_SNAPSHOT_URL="https://nutsnews-worker-0.nutsnews.workers.dev"

Worker:

NUTSNEWS_KV_NAMESPACE_ID="paste_namespace_id_here"
PUBLIC_FEED_EDGE_SNAPSHOT_LIMIT=120
PUBLIC_FEED_EDGE_SNAPSHOT_TTL_SECONDS=604800

Docs

Main runbook:

docs/PUBLIC_FEED_SNAPSHOT.md