Blog: Putting apps to sleep, and waking them in under two seconds

[ClaydeCode]

Adds the blog post about the PAUSED+PAGED app tier (shard_core 0.40.0, tracker FreeshardBase/freeshard#81), plus its cover image. Picks up one unrelated agents.md fix as a byproduct.

Contents

• docs/blog/posts/2026-07-25_app_sleep_fast_wake/main.md — the post. Dated 2026-07-25, draft: false, author max. Structure: problem (self-hosted apps eat a 2 GB VPS, cold starts take 30s+), rejected alternatives (CRIU/docker checkpoint, Podman migration, Sablier), the implementation (cgroup freezer via docker compose pause + memory.reclaim to swap, three-state Running → Paused+Paged → Stopped with PSI-driven LRU demotion), the swap story (RAM-sized swapfile + zswap), and what it means for shard owners.
• docs/blog/posts/2026-07-25_app_sleep_fast_wake/cover.png — 1600×896, generated with Flux 1.1 Pro Ultra.
• agents.md — the documented commands were bare pip install / mkdocs serve; the repo is built with uv. Updated to uv venv / uv pip install -r requirements.txt / uv run mkdocs build, which is what this PR's output was actually built and verified with.

No mkdocs.yml change needed — the blog plugin picks up post directories automatically.

Notes for review

• The closing CTA asks readers to report anything misbehaving, not just wake-time annoyances, matching the newsletter going out alongside this post.
• The post says real-world telemetry numbers aren't available yet, only the integration-test-asserted <2s unpause. That matches rollout state at drafting time; worth a re-check before merge in case the soak has produced numbers worth quoting.
• Cover art deliberately breaks the dark-dramatic register of the previous post's cover in favour of a bright-daylight one — same ligne claire treatment, same brand palette, inverted values. The scene (helpers folded up dozing on a bench, one stretching awake, one serving at the counter) maps to the three app states.
• draft: false means this publishes as soon as it lands on main.

Verification

uv run mkdocs build exits 0; the post renders at /blog/2026/07/25/putting-apps-to-sleep-and-waking-them-in-under-two-seconds/ and appears on the blog index with its cover and excerpt.

🤖 Generated with Claude Code