mirror of
https://github.com/aaddrick/claude-desktop-debian.git
synced 2026-05-17 08:36:35 +03:00
e86f17bb3e
Phase 5 docs follow-up to #493. The plan doc was deleted in #511; this replaces it with a learnings file aimed at future maintainers (and future-me) rather than a design spec. docs/learnings/apt-worker-architecture.md covers: - The problem (100MB push cap) and why other fixes were rejected - Redirect chains for both legacy github.io users and direct pkg.<domain> users - Why raw.githubusercontent.com is the origin (Pages 301 loop) - Why Pages emits http:// (no cert, and why the cert can't be had) - File map (worker source, wrangler.toml, deploy workflow, heartbeat) - Credential ownership (Cloudflare account, registrar, API token scopes) - Heartbeat failure runbook — 5 ordered steps to work through - Rollback paths and documented fallbacks if Cloudflare becomes unavailable - Known gotchas including the smoke-test-URL-is-intentionally-github.io note so future cleanup passes don't "fix" it CLAUDE.md gains: - Link to the new learnings file in the Learnings list - New "Distribution" section under CI/CD with a one-paragraph summary and pointers to the key files Refs #493