From 6215d3573bc52b0106a4e8225ef4582d79ec12a2 Mon Sep 17 00:00:00 2001
From: giles <giles.bradshaw@rose-ash.com>
Date: Sat, 7 Mar 2026 08:35:20 +0000
Subject: [PATCH 1/3] Send content expression component deps in SX responses
 for client routing

When a page has a content expression but no data dependency, compute its
transitive component deps and pass them as extra_component_names to
sx_response(). This ensures the client has all component definitions
needed for future client-side route rendering.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 shared/sx/helpers.py | 22 +++++++++++++++++++---
 shared/sx/pages.py   | 14 +++++++++++++-
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/shared/sx/helpers.py b/shared/sx/helpers.py
index 3174184..659ac9f 100644
--- a/shared/sx/helpers.py
+++ b/shared/sx/helpers.py
@@ -456,7 +456,8 @@ def sx_call(component_name: str, **kwargs: Any) -> str:
 
 
 
-def components_for_request(source: str = "") -> str:
+def components_for_request(source: str = "",
+                           extra_names: set[str] | None = None) -> str:
     """Return defcomp/defmacro source for definitions the client doesn't have yet.
 
     Reads the ``SX-Components`` header (comma-separated component names
@@ -464,6 +465,10 @@ def components_for_request(source: str = "") -> str:
     is missing.  If *source* is provided, only sends components needed
     for that source (plus transitive deps).  If the header is absent,
     returns all needed defs.
+
+    *extra_names* — additional component names (``~foo``) to include
+    beyond what *source* references.  Used by ``execute_page`` to send
+    components the page's content expression needs for client-side routing.
     """
     from quart import request
     from .jinja_bridge import _COMPONENT_ENV
@@ -477,6 +482,12 @@ def components_for_request(source: str = "") -> str:
     else:
         needed = None  # all
 
+    # Merge in extra names (e.g. from page content expression deps)
+    if extra_names and needed is not None:
+        needed = needed | extra_names
+    elif extra_names:
+        needed = extra_names
+
     loaded_raw = request.headers.get("SX-Components", "")
     loaded = set(loaded_raw.split(",")) if loaded_raw else set()
 
@@ -510,7 +521,8 @@ def components_for_request(source: str = "") -> str:
 
 
 def sx_response(source: str, status: int = 200,
-                   headers: dict | None = None):
+                   headers: dict | None = None,
+                   extra_component_names: set[str] | None = None):
     """Return an s-expression wire-format response.
 
     Takes a raw sx string::
@@ -520,6 +532,10 @@ def sx_response(source: str, status: int = 200,
     For SX requests, missing component definitions are prepended as a
     ``<script type="text/sx" data-components>`` block so the client
     can process them before rendering OOB content.
+
+    *extra_component_names* — additional component names to include beyond
+    what *source* references.  Used by defpage to send components the page's
+    content expression needs for client-side routing.
     """
     from quart import request, Response
 
@@ -535,7 +551,7 @@ def sx_response(source: str, status: int = 200,
     # For SX requests, prepend missing component definitions
     comp_defs = ""
     if request.headers.get("SX-Request"):
-        comp_defs = components_for_request(source)
+        comp_defs = components_for_request(source, extra_names=extra_component_names)
         if comp_defs:
             body = (f'<script type="text/sx" data-components>'
                     f'{comp_defs}</script>\n{body}')
diff --git a/shared/sx/pages.py b/shared/sx/pages.py
index 8912808..2c1ee1a 100644
--- a/shared/sx/pages.py
+++ b/shared/sx/pages.py
@@ -279,13 +279,25 @@ async def execute_page(
     is_htmx = is_htmx_request()
 
     if is_htmx:
+        # Compute content expression deps so the server sends component
+        # definitions the client needs for future client-side routing
+        extra_deps: set[str] | None = None
+        if page_def.content_expr is not None and page_def.data_expr is None:
+            from .deps import components_needed
+            from .parser import serialize
+            try:
+                content_src = serialize(page_def.content_expr)
+                extra_deps = components_needed(content_src, get_component_env())
+            except Exception:
+                pass  # non-critical — client will just fall back to server
+
         return sx_response(await oob_page_sx(
             oobs=oob_headers if oob_headers else "",
             filter=filter_sx,
             aside=aside_sx,
             content=content_sx,
             menu=menu_sx,
-        ))
+        ), extra_component_names=extra_deps)
     else:
         return await full_page_sx(
             tctx,

From feb368f7fbb93678e897a3e5d0732de52b0903ae Mon Sep 17 00:00:00 2001
From: giles <giles.bradshaw@rose-ash.com>
Date: Sat, 7 Mar 2026 08:35:27 +0000
Subject: [PATCH 2/3] Add plans audit: status overview + fragment protocol,
 glue decoupling, social sharing pages

Audit all plan files and create documentation pages for what remains:
- Status overview with green/amber/stone badges for all 15 plans
- Fragment Protocol: what exists (GET), what remains (POST sexp, structured response)
- Glue Decoupling: 25+ cross-app imports to eliminate via glue service layer
- Social Sharing: 6-phase OAuth-based sharing to major platforms

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 sx/sx/nav-data.sx    |  10 +-
 sx/sx/plans.sx       | 277 +++++++++++++++++++++++++++++++++++++++++++
 sx/sxc/pages/docs.sx |   4 +
 3 files changed, 290 insertions(+), 1 deletion(-)

diff --git a/sx/sx/nav-data.sx b/sx/sx/nav-data.sx
index 29f34eb..998db1b 100644
--- a/sx/sx/nav-data.sx
+++ b/sx/sx/nav-data.sx
@@ -109,10 +109,18 @@
   (dict :label "Routing Analyzer" :href "/isomorphism/routing-analyzer")))
 
 (define plans-nav-items (list
+  (dict :label "Status" :href "/plans/status"
+        :summary "Audit of all plans — what's done, what's in progress, and what remains.")
   (dict :label "Reader Macros" :href "/plans/reader-macros"
         :summary "Extensible parse-time transformations via # dispatch — datum comments, raw strings, and quote shorthand.")
   (dict :label "SX-Activity" :href "/plans/sx-activity"
-        :summary "A new web built on SX — executable content, shared components, parsers, and logic on IPFS, provenance on Bitcoin, all running within your own security context.")))
+        :summary "A new web built on SX — executable content, shared components, parsers, and logic on IPFS, provenance on Bitcoin, all running within your own security context.")
+  (dict :label "Fragment Protocol" :href "/plans/fragment-protocol"
+        :summary "Structured sexp request/response for cross-service component transfer.")
+  (dict :label "Glue Decoupling" :href "/plans/glue-decoupling"
+        :summary "Eliminate all cross-app model imports via glue service layer.")
+  (dict :label "Social Sharing" :href "/plans/social-sharing"
+        :summary "OAuth-based sharing to Facebook, Instagram, Threads, Twitter/X, LinkedIn, and Mastodon.")))
 
 (define bootstrappers-nav-items (list
   (dict :label "Overview" :href "/bootstrappers/")
diff --git a/sx/sx/plans.sx b/sx/sx/plans.sx
index 059977d..17a7338 100644
--- a/sx/sx/plans.sx
+++ b/sx/sx/plans.sx
@@ -594,6 +594,283 @@
               (td :class "px-3 py-2 text-stone-700" "Content addressing — shared with component CIDs")
               (td :class "px-3 py-2 text-stone-600" "2, 3"))))))))
 
+;; ---------------------------------------------------------------------------
+;; Plan Status Overview
+;; ---------------------------------------------------------------------------
+
+(defcomp ~plan-status-content ()
+  (~doc-page :title "Plan Status"
+
+    (p :class "text-lg text-stone-600 mb-6"
+      "Audit of all plans across the SX language and Rose Ash platform. Last updated March 2026.")
+
+    ;; -----------------------------------------------------------------------
+    ;; Completed
+    ;; -----------------------------------------------------------------------
+
+    (~doc-section :title "Completed" :id "completed"
+
+      (div :class "space-y-4"
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (span :class "font-semibold text-stone-800" "Split Cart into Microservices"))
+          (p :class "text-sm text-stone-600" "Cart decomposed into 4 services: relations (internal, owns ContainerRelation), likes (internal, unified generic likes), orders (public, owns Order/OrderItem + SumUp checkout), and cart (thin CartItem CRUD). All three new services deployed with dedicated databases."))
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (span :class "font-semibold text-stone-800" "Ticket Purchase Through Cart"))
+          (p :class "text-sm text-stone-600" "Tickets flow through the cart like products: state=pending in cart, reserved at checkout, confirmed on payment. TicketDTO, CartSummaryDTO with ticket_count/ticket_total, CalendarService protocol methods all implemented."))
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (span :class "font-semibold text-stone-800" "Ticket UX Improvements"))
+          (p :class "text-sm text-stone-600" "+/- quantity buttons on entry pages and cart. Tickets grouped by event in cart display. Adjust quantity route, sold/basket counts, matching product card UX pattern."))
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (a :href "/isomorphism/" :class "font-semibold text-green-800 underline" "Isomorphic Phase 1: Dependency Analysis"))
+          (p :class "text-sm text-stone-600" "Per-page component bundles via deps.sx. Transitive closure, scan-refs, components-needed, page-css-classes. 15 tests, bootstrapped to both hosts."))
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (a :href "/isomorphism/" :class "font-semibold text-green-800 underline" "Isomorphic Phase 2: IO Detection"))
+          (p :class "text-sm text-stone-600" "Automatic IO classification. scan-io-refs, transitive-io-refs, compute-all-io-refs. Server expands IO components, serializes pure ones for client."))
+
+        (div :class "rounded border border-green-200 bg-green-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-green-600 text-white uppercase" "Complete")
+            (a :href "/isomorphism/" :class "font-semibold text-green-800 underline" "Isomorphic Phase 3: Client-Side Routing"))
+          (p :class "text-sm text-stone-600" "router.sx spec, page registry via <script type=\"text/sx-pages\">, client route matching, try-first/fallback to server. Pure pages render without server roundtrips."))))
+
+    ;; -----------------------------------------------------------------------
+    ;; In Progress / Partial
+    ;; -----------------------------------------------------------------------
+
+    (~doc-section :title "In Progress" :id "in-progress"
+
+      (div :class "space-y-4"
+
+        (div :class "rounded border border-amber-200 bg-amber-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-amber-600 text-white uppercase" "Partial")
+            (a :href "/plans/fragment-protocol" :class "font-semibold text-amber-900 underline" "Fragment Protocol"))
+          (p :class "text-sm text-stone-600" "Fragment GET infrastructure works. The planned POST/sexp structured protocol for transferring component definitions between services is not yet implemented. Fragment endpoints still use legacy GET + X-Fragment-Request headers."))
+
+        (div :class "rounded border border-amber-200 bg-amber-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-amber-600 text-white uppercase" "Partial")
+            (a :href "/isomorphism/" :class "font-semibold text-amber-900 underline" "Isomorphic Phase 4: Client Async & IO Bridge"))
+          (p :class "text-sm text-stone-600" "Some async evaluation infrastructure exists (helpers.py, async_eval.py). The io-bridge.sx spec file for client-side IO primitives (query -> REST, frag -> fetch) does not exist yet."))))
+
+    ;; -----------------------------------------------------------------------
+    ;; Not Started
+    ;; -----------------------------------------------------------------------
+
+    (~doc-section :title "Not Started" :id "not-started"
+
+      (div :class "space-y-4"
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/plans/reader-macros" :class "font-semibold text-stone-800 underline" "Reader Macros"))
+          (p :class "text-sm text-stone-600" "# dispatch character for datum comments (#;), raw strings (#|...|), and quote shorthand (#'). Fully designed but no implementation in parser.sx or parser.py.")
+          (p :class "text-sm text-stone-500 mt-1" "Remaining: spec in parser.sx, Python in parser.py, rebootstrap both targets."))
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/plans/sx-activity" :class "font-semibold text-stone-800 underline" "SX-Activity"))
+          (p :class "text-sm text-stone-600" "Federated SX over ActivityPub — 6 phases from SX wire format for activities to the evaluable web on IPFS. Existing AP infrastructure provides the foundation but no SX-specific federation code exists.")
+          (p :class "text-sm text-stone-500 mt-1" "Remaining: shared/sx/activity.py (SX<->JSON-LD), shared/sx/ipfs.py, shared/sx/ref/ipfs-resolve.sx, shared/sx/registry.py, shared/sx/anchor.py."))
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/plans/glue-decoupling" :class "font-semibold text-stone-800 underline" "Cross-App Decoupling via Glue"))
+          (p :class "text-sm text-stone-600" "Eliminate all cross-app model imports by routing through a glue service layer. No glue/ directory exists. Apps are currently decoupled via HTTP interfaces and DTOs instead.")
+          (p :class "text-sm text-stone-500 mt-1" "Remaining: glue/services/ for pages, page_config, calendars, marketplaces, cart_items, products, post_associations. 25+ cross-app imports to eliminate."))
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/plans/social-sharing" :class "font-semibold text-stone-800 underline" "Social Network Sharing"))
+          (p :class "text-sm text-stone-600" "OAuth-based sharing to Facebook, Instagram, Threads, Twitter/X, LinkedIn, and Mastodon via the account service. No models, blueprints, or platform clients created.")
+          (p :class "text-sm text-stone-500 mt-1" "Remaining: SocialConnection model, social_crypto.py, platform OAuth clients (6), account/bp/social/ blueprint, share button fragment."))
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/isomorphism/" :class "font-semibold text-stone-800 underline" "Isomorphic Phase 5: Streaming & Suspense"))
+          (p :class "text-sm text-stone-600" "Server streams partially-evaluated SX as IO resolves. Client renders available subtrees immediately, fills in suspended parts. No suspense.sx spec or chunked transfer implementation.")
+          (p :class "text-sm text-stone-500 mt-1" "Depends on: Phase 4 (client async)."))
+
+        (div :class "rounded border border-stone-200 bg-stone-50 p-4"
+          (div :class "flex items-center gap-2 mb-1"
+            (span :class "inline-block px-2 py-0.5 rounded text-xs font-bold bg-stone-500 text-white uppercase" "Not Started")
+            (a :href "/isomorphism/" :class "font-semibold text-stone-800 underline" "Isomorphic Phase 6: Full Isomorphism"))
+          (p :class "text-sm text-stone-600" "Runtime boundary optimizer, affinity annotations, offline data layer via Service Worker + IndexedDB, isomorphic testing harness.")
+          (p :class "text-sm text-stone-500 mt-1" "Depends on: all previous phases."))))))
+
+;; ---------------------------------------------------------------------------
+;; Fragment Protocol
+;; ---------------------------------------------------------------------------
+
+(defcomp ~plan-fragment-protocol-content ()
+  (~doc-page :title "Fragment Protocol"
+
+    (~doc-section :title "Context" :id "context"
+      (p "Fragment endpoints return raw sexp source (e.g., " (code "(~blog-nav-wrapper :items ...)") "). The consuming service embeds this in its page sexp, which the client evaluates. But service-specific components like " (code "~blog-nav-wrapper") " are only in that service's component env — not in the consumer's. So the consumer's " (code "client_components_tag()") " never sends them to the client, causing \"Unknown component\" errors.")
+      (p "The fix: transfer component definitions alongside fragments. Services tell the provider what they already have; the provider sends only what's missing."))
+
+    (~doc-section :title "What exists" :id "exists"
+      (div :class "rounded border border-green-200 bg-green-50 p-4"
+        (ul :class "list-disc pl-5 text-stone-700 space-y-1"
+          (li "Fragment GET infrastructure works (" (code "shared/infrastructure/fragments.py") ")")
+          (li (code "X-Fragment-Request") " header protocol for internal service calls")
+          (li "Content type negotiation for text/html and text/sx responses")
+          (li "Fragment caching and composition in page rendering"))))
+
+    (~doc-section :title "What remains" :id "remains"
+      (div :class "rounded border border-amber-200 bg-amber-50 p-4"
+        (ul :class "list-disc pl-5 text-stone-700 space-y-1"
+          (li (strong "POST sexp protocol: ") "Switch from GET to POST with structured sexp body containing " (code ":components") " list of what consumer already has")
+          (li (strong "Structured response: ") (code "(fragment-response :defs (...) :content (...))") " — provider sends only missing component defs")
+          (li (strong (code "fragment_response()") " builder: ") "New function in helpers.py that diffs provider's component env against consumer's list")
+          (li (strong "Register received defs: ") "Consumer parses " (code ":defs") " from response and registers into its " (code "_COMPONENT_ENV"))
+          (li (strong "Shared blueprint factory: ") (code "create_fragment_blueprint(handlers)") " to deduplicate the identical fragment endpoint pattern across 8 services"))))
+
+    (~doc-section :title "Files to modify" :id "files"
+      (div :class "overflow-x-auto rounded border border-stone-200"
+        (table :class "w-full text-left text-sm"
+          (thead (tr :class "border-b border-stone-200 bg-stone-100"
+            (th :class "px-3 py-2 font-medium text-stone-600" "File")
+            (th :class "px-3 py-2 font-medium text-stone-600" "Change")))
+          (tbody
+            (tr :class "border-b border-stone-100"
+              (td :class "px-3 py-2 font-mono text-sm text-violet-700" "shared/infrastructure/fragments.py")
+              (td :class "px-3 py-2 text-stone-700" "POST sexp body, parse response, register defs"))
+            (tr :class "border-b border-stone-100"
+              (td :class "px-3 py-2 font-mono text-sm text-violet-700" "shared/sx/helpers.py")
+              (td :class "px-3 py-2 text-stone-700" "fragment_response() builder"))
+            (tr :class "border-b border-stone-100"
+              (td :class "px-3 py-2 font-mono text-sm text-violet-700" "shared/infrastructure/fragment_endpoint.py")
+              (td :class "px-3 py-2 text-stone-700" "NEW — shared blueprint factory"))
+            (tr :class "border-b border-stone-100"
+              (td :class "px-3 py-2 font-mono text-sm text-violet-700" "*/bp/fragments/routes.py")
+              (td :class "px-3 py-2 text-stone-700" "All 8 services: use create_fragment_blueprint"))))))))
+
+;; ---------------------------------------------------------------------------
+;; Glue Decoupling
+;; ---------------------------------------------------------------------------
+
+(defcomp ~plan-glue-decoupling-content ()
+  (~doc-page :title "Cross-App Decoupling via Glue Services"
+
+    (~doc-section :title "Context" :id "context"
+      (p "All cross-domain FK constraints have been dropped (with pragmatic exceptions for OrderItem.product_id and CartItem). Cross-domain writes go through internal HTTP and activity bus. However, " (strong "25+ cross-app model imports remain") " — apps still import from each other's models/ directories. This means every app needs every other app's code on disk to start.")
+      (p "The goal: eliminate all cross-app model imports. Every app only imports from its own models/, from shared/, and from a new glue/ service layer."))
+
+    (~doc-section :title "Current state" :id "current"
+      (p "Apps are partially decoupled via HTTP interfaces (fetch_data, call_action, send_internal_activity) and DTOs. The Cart microservice split (relations, likes, orders) is complete. But direct model imports persist in:")
+      (ul :class "list-disc pl-5 text-stone-700 space-y-1"
+        (li (strong "Cart") " — 9 files importing from market, events, blog")
+        (li (strong "Blog") " — 8 files importing from cart, events, market")
+        (li (strong "Events") " — 5 files importing from blog, market, cart")
+        (li (strong "Market") " — 1 file importing from blog")))
+
+    (~doc-section :title "What remains" :id "remains"
+      (div :class "space-y-3"
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "1. glue/services/pages.py")
+          (p :class "text-sm text-stone-600" "Dict-based Post access for non-blog apps: get_page_by_slug, get_page_by_id, get_pages_by_ids, page_exists, search_posts."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "2. glue/services/page_config.py")
+          (p :class "text-sm text-stone-600" "PageConfig CRUD: get_page_config, get_or_create_page_config, get_page_configs_by_ids."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "3. glue/services/calendars.py")
+          (p :class "text-sm text-stone-600" "Calendar queries + entry associations (from blog): get_calendars_for_page, toggle_entry_association, get_associated_entries."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "4. glue/services/marketplaces.py")
+          (p :class "text-sm text-stone-600" "MarketPlace CRUD (from blog+events): get_marketplaces_for_page, create_marketplace, soft_delete_marketplace."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "5. glue/services/cart_items.py")
+          (p :class "text-sm text-stone-600" "CartItem/CalendarEntry queries for cart: get_cart_items, find_or_create_cart_item, clear_cart_for_order."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "6. glue/services/products.py")
+          (p :class "text-sm text-stone-600" "Minimal Product access for cart orders: get_product."))
+        (div :class "rounded border border-stone-200 p-3"
+          (h4 :class "font-semibold text-stone-700" "7. Model registration + cleanup")
+          (p :class "text-sm text-stone-600" "register_models() in glue/setup.py, update all app.py files, delete moved service files."))))
+
+    (~doc-section :title "Docker consideration" :id "docker"
+      (p :class "text-stone-600" "For glue services to work in Docker (single app per container), model files from other apps must be importable. Recommended: try/except at import time — glue services that can't import a model raise ImportError at call time, which only happens if called from the wrong app."))))
+
+;; ---------------------------------------------------------------------------
+;; Social Sharing
+;; ---------------------------------------------------------------------------
+
+(defcomp ~plan-social-sharing-content ()
+  (~doc-page :title "Social Network Sharing"
+
+    (~doc-section :title "Context" :id "context"
+      (p "Rose Ash already has ActivityPub for federated social sharing. This plan adds OAuth-based sharing to mainstream social networks — Facebook, Instagram, Threads, Twitter/X, LinkedIn, and Mastodon.")
+      (p "All social logic lives in the " (strong "account") " microservice. Content apps get a share button that opens the account share page."))
+
+    (~doc-section :title "What remains" :id "remains"
+      (~doc-note "Nothing has been implemented. This is the full scope of work.")
+
+      (div :class "space-y-4"
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 1: Data Model + Encryption")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li (code "shared/models/social_connection.py") " — SocialConnection model (user_id, platform, tokens, scopes, extra_data)")
+            (li (code "shared/infrastructure/social_crypto.py") " — Fernet encrypt/decrypt for tokens")
+            (li "Alembic migration for social_connections table")
+            (li "Environment variables for per-platform OAuth credentials")))
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 2: Platform OAuth Clients")
+          (p :class "text-sm text-stone-600 mb-2" "All in " (code "account/services/social_platforms/") ":")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li (code "base.py") " — SocialPlatform ABC, OAuthResult, ShareResult")
+            (li (code "meta.py") " — Facebook + Instagram + Threads (Graph API)")
+            (li (code "twitter.py") " — OAuth 2.0 with PKCE")
+            (li (code "linkedin.py") " — LinkedIn Posts API")
+            (li (code "mastodon.py") " — Dynamic app registration per instance")))
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 3: Account Blueprint")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li (code "account/bp/social/routes.py") " — /social/ list, /social/connect/<platform>/, /social/callback/<platform>/, /social/share/")
+            (li "Register before account blueprint (account has catch-all /<slug>/ route)")))
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 4: Templates")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li "Social panel — platform cards, connect/disconnect")
+            (li "Share panel — content preview, account checkboxes, share button")
+            (li "Share result — per-platform success/failure with links")))
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 5: Share Button in Content Apps")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li "share-button fragment from account service")
+            (li "Blog, events, market detail pages fetch and render the fragment")))
+
+        (div :class "rounded border border-stone-200 p-4"
+          (h4 :class "font-semibold text-stone-700 mb-2" "Phase 6: Token Refresh + Share History")
+          (ul :class "list-disc pl-5 text-stone-700 space-y-1 text-sm"
+            (li "Automatic token refresh before posting")
+            (li "Optional social_shares table for history and duplicate prevention")))))))
+
 ;; ---------------------------------------------------------------------------
 ;; Isomorphic Architecture Roadmap
 ;; ---------------------------------------------------------------------------
diff --git a/sx/sxc/pages/docs.sx b/sx/sxc/pages/docs.sx
index fefb84d..d1a04b6 100644
--- a/sx/sxc/pages/docs.sx
+++ b/sx/sxc/pages/docs.sx
@@ -475,6 +475,10 @@
                :current (find-current plans-nav-items slug))
     :selected (or (find-current plans-nav-items slug) ""))
   :content (case slug
+    "status" (~plan-status-content)
     "reader-macros" (~plan-reader-macros-content)
     "sx-activity" (~plan-sx-activity-content)
+    "fragment-protocol" (~plan-fragment-protocol-content)
+    "glue-decoupling" (~plan-glue-decoupling-content)
+    "social-sharing" (~plan-social-sharing-content)
     :else (~plans-index-content)))

From 2b0a45b3379f6eabe18f31af1f24570ec100476d Mon Sep 17 00:00:00 2001
From: giles <giles.bradshaw@rose-ash.com>
Date: Sat, 7 Mar 2026 08:35:33 +0000
Subject: [PATCH 3/3] Fix code block rendering: escape newlines/tabs in syntax
 highlighter output

highlight_sx/python/bash produced SX string literals with literal newline
and tab characters, breaking the wire format parser. Add centralized
_escape() helper that properly escapes \n, \t, \r (plus existing \\ and
" escaping). Code blocks now render with correct indentation and syntax
highlighting in both server and client renders.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 sx/content/highlight.py | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/sx/content/highlight.py b/sx/content/highlight.py
index 40e0615..1515eb5 100644
--- a/sx/content/highlight.py
+++ b/sx/content/highlight.py
@@ -8,12 +8,22 @@ from __future__ import annotations
 import re
 
 
+def _escape(text: str) -> str:
+    """Escape a token for embedding in an SX string literal."""
+    return (text
+            .replace("\\", "\\\\")
+            .replace('"', '\\"')
+            .replace("\n", "\\n")
+            .replace("\t", "\\t")
+            .replace("\r", "\\r"))
+
+
 def highlight_sx(code: str) -> str:
     """Highlight s-expression source code as sx with Tailwind spans."""
     tokens = _tokenize_sx(code)
     parts = []
     for kind, text in tokens:
-        escaped = text.replace("\\", "\\\\").replace('"', '\\"')
+        escaped = _escape(text)
         if kind == "comment":
             parts.append(f'(span :class "text-stone-400 italic" "{escaped}")')
         elif kind == "string":
@@ -94,7 +104,7 @@ def highlight_python(code: str) -> str:
     tokens = _tokenize_python(code)
     parts = []
     for kind, text in tokens:
-        escaped = text.replace("\\", "\\\\").replace('"', '\\"')
+        escaped = _escape(text)
         if kind == "comment":
             parts.append(f'(span :class "text-stone-400 italic" "{escaped}")')
         elif kind == "string":
@@ -176,7 +186,7 @@ def highlight_bash(code: str) -> str:
     tokens = _tokenize_bash(code)
     parts = []
     for kind, text in tokens:
-        escaped = text.replace("\\", "\\\\").replace('"', '\\"')
+        escaped = _escape(text)
         if kind == "comment":
             parts.append(f'(span :class "text-stone-400 italic" "{escaped}")')
         elif kind == "string":