From e6dd3508424c44c2c2d6e896c5081cd13abfb376 Mon Sep 17 00:00:00 2001
From: Jess Sullivan <jess@sulliwood.org>
Date: Tue, 19 May 2026 07:20:11 -0400
Subject: [PATCH] docs(blog): clarify production and shadow consumers

---
 README.md                   | 10 ++++++----
 docs/blog-shadow-preview.md | 13 ++++++++-----
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index afacac1..c6b28c9 100644
--- a/README.md
+++ b/README.md
@@ -3,8 +3,8 @@ Hi! This is just my boring personal static blog ^w^
 
 | Surface | Route |
 | --- | --- |
-| Production | `https://transscendsurvival.org` |
-| Cloudflare Pages shadow | `https://tss.tinyland.dev` |
+| Production | `https://transscendsurvival.org` (current production, GitHub Pages) |
+| Cloudflare Pages shadow | `https://tss.tinyland.dev` (development shadow) |
 | Alternate Cloudflare shadow | `https://tss.ephemera.tinyland.dev` |
 | Tailnet-only shadow | `https://jesssullivan-blog-shadow.taila4c78d.ts.net` |
 | Tailnet vanity target | `https://jesssullivan-blog-shadow.tailnet.tinyland.dev` |
@@ -15,7 +15,9 @@ Hi! This is just my boring personal static blog ^w^
 The build produces a static SvelteKit artifact. Tinyland snapshots and local
 Markdown remain first-paint, no-JS, and regression fixtures; canonical blog and
 Pulse display hydrates in the browser from the public Tinyland broker when it is
-available.
+available. `transscendsurvival.org` is the production consumer today even while
+it is still served by GitHub Pages; `tss.tinyland.dev` is the Cloudflare Pages
+development shadow until the production cutover is explicitly proven.
 
 ```mermaid
 flowchart LR
@@ -131,7 +133,7 @@ primary authoring path for Tinyland-managed posts.
 flowchart TB
     TinylandEditor["tinyland.dev blog editor"] --> Greymatter["content/users/jesssullivan greymatter"]
     Greymatter --> BlogBroker["hub.tinyland.dev blog broker stream"]
-    BlogBroker --> BlogRuntime["CF Pages /blog and /blog/[slug] runtime display"]
+    BlogBroker --> BlogRuntime["production + shadow /blog and /blog/[slug] runtime display"]
 
     PulseBroker["Tinyland Pulse broker/public policy"] --> PulseSnapshot["hub.tinyland.dev Pulse public snapshot"]
     PulseSnapshot --> PulseRuntime["CF Pages /pulse runtime refresh"]
diff --git a/docs/blog-shadow-preview.md b/docs/blog-shadow-preview.md
index 71822c4..ca423ed 100644
--- a/docs/blog-shadow-preview.md
+++ b/docs/blog-shadow-preview.md
@@ -67,11 +67,14 @@ uses the `tinyland-dind` ARC runner by default and accepts the same
 `.github/workflows/cloudflare-pages-shadow.yml` builds the same static
 SvelteKit output and can publish it to Cloudflare Pages by Direct Upload.
 
-This is a shadow lane for moving `transscendsurvival.org` toward the Tinyland
-static-spoke edge posture. It does not cut over DNS or replace GitHub Pages
-production. The built site is still static, but current `/blog`, `/blog/[slug]`,
-and `/pulse` client code may hydrate from public `hub.tinyland.dev` broker
-endpoints at runtime when those endpoints are available.
+This is a development shadow lane for moving `transscendsurvival.org` toward the
+Tinyland static-spoke edge posture. It does not cut over DNS or replace the
+current GitHub Pages production surface. Production remains
+`https://transscendsurvival.org`; `https://tss.tinyland.dev` is the Cloudflare
+Pages shadow. The built site is still static, but current `/blog`,
+`/blog/[slug]`, and `/pulse` client code may hydrate from public
+`hub.tinyland.dev` broker endpoints at runtime when those endpoints are
+available.
 
 Required repository secrets: