chore: retire macos-demo (retire-macos-demo)

CLAUDE.md

@@ -24,7 +24,7 @@ apps/
     web-react/           # Trace Explorer — execution timeline debugger
   react-demo/            # Expedition React browser demo (adopted from Traverse)
   browser-consumer/      # Browser consumer façade
-  macos-demo/            # Expedition macOS demo
+  android-demo/          # Expedition Android demo
   youaskm3-starter-kit/  # Downstream browser starter kit
 fixtures/                # Shared UI demo fixtures
 .agents/skills/

README.md

@@ -28,7 +28,6 @@ UI examples for [Traverse](https://github.com/traverse-framework/Traverse).
 | Demo | Path |
 |---|---|
 | React browser demo | [`apps/react-demo/`](apps/react-demo/) |
-| macOS demo | [`apps/macos-demo/`](apps/macos-demo/) |
 | Browser consumer façade | [`apps/browser-consumer/`](apps/browser-consumer/) |
 | youaskm3 starter kit | [`apps/youaskm3-starter-kit/`](apps/youaskm3-starter-kit/) |
 
@@ -37,6 +36,7 @@ UI examples for [Traverse](https://github.com/traverse-framework/Traverse).
 | Path | Retired | Notes |
 |---|---|---|
 | `apps/android-demo` | 2026-08-12 | Spec 004 retire ([#251](https://github.com/traverse-framework/reference-apps/pull/251)); use primary Android Compose shells |
+| `apps/macos-demo` | 2026-08-12 | Spec 004 retire ([#252](https://github.com/traverse-framework/reference-apps/pull/252)); use primary SwiftUI shells |
 
 ---
 

docs/adopted-platform-clients.md

@@ -18,7 +18,7 @@ Ownership boundary (Traverse [#703](https://github.com/traverse-framework/Traver
 |---|---|---|
 | `apps/android-demo/` | Reference Apps | **Retired** 2026-08-12 (`retire-android-demo`) — use primary Android Compose shells |
 | `apps/browser-consumer/` | Reference Apps | [`apps/browser-consumer/`](../apps/browser-consumer/) |
-| `apps/macos-demo/` | Reference Apps | [`apps/macos-demo/`](../apps/macos-demo/) |
+| `apps/macos-demo/` | Reference Apps | **Retired** 2026-08-12 (`retire-macos-demo`) — use primary SwiftUI shells |
 | `apps/react-demo/` | Reference Apps | [`apps/react-demo/`](../apps/react-demo/) |
 | `apps/youaskm3-starter-kit/` | Reference Apps | [`apps/youaskm3-starter-kit/`](../apps/youaskm3-starter-kit/) |
 | `apps/llm-mcp-reference/` (new) | Reference Apps | [`apps/llm-mcp-reference/`](../apps/llm-mcp-reference/) — LLM MCP façades; [`llm-reference-apps-plan.md`](llm-reference-apps-plan.md) |
@@ -30,7 +30,7 @@ Shared fixture for remaining native demos: [`fixtures/expedition-runtime-session
 
 | Artifact | Command |
 |---|---|
-| macOS demo | `bash scripts/ci/macos_demo_smoke.sh` |
+| Android demo | `bash scripts/ci/android_demo_smoke.sh` |
 | React demo | `bash scripts/ci/react_demo_smoke.sh` |
 | youaskm3 starter | `bash scripts/ci/youaskm3_starter_kit_smoke.sh` |
 | LLM MCP reference | `bash scripts/ci/llm_mcp_reference_smoke.sh` |

docs/demo-inventory.md

@@ -12,7 +12,9 @@ Reconciled against `find apps -maxdepth 1 -type d` on 2026-08-11. Primaries are
 | `apps/trace-explorer` | already-primary | Debugger companion (web-only by design) | — |
 | `apps/react-demo` | retire | Expedition browser sample; Spec 004 non-goal as production pattern; primaries own Web UX | `retire-react-demo` |
 | `apps/android-demo` | retire (done) | Removed 2026-08-12; superseded by primary Android Compose shells | `retire-android-demo` |
-| `apps/macos-demo` | retire | Expedition macOS sample; superseded by primary SwiftUI shells | `retire-macos-demo` |
+| `apps/macos-demo` | retire (done) | Removed 2026-08-12; superseded by primary SwiftUI shells | `retire-macos-demo` |
+| `apps/android-demo` | retire | Expedition Android sample; superseded by primary Android Compose shells | `retire-android-demo` |
+| `apps/macos-demo` | retire (done) | Removed 2026-08-12; superseded by primary SwiftUI shells | `retire-macos-demo` |
 | `apps/browser-consumer` | upgrade | Keep as downstream browser façade; align to Specs 001/002 and stop depending on `react-demo` once that path retires | `upgrade-browser-consumer-events` |
 | `apps/youaskm3-starter-kit` | upgrade | Keep as downstream getting-started kit; point at embedded/public surfaces + Specs 001/002 vocabulary | `upgrade-youaskm3-starter-kit-events` |
 | `apps/llm-mcp-reference` | upgrade | Active secondary LLM MCP façades; keep and align workflow docs to event presentation contract | `upgrade-llm-mcp-reference-events` |

docs/production-playbook.md

@@ -39,7 +39,8 @@ Rules:
 | App | Status |
 |---|---|
 | trace-explorer | **Debugger** — embedded Trace API (`embedded-trace-api/1.0.0`); not a secondary “product” kit |
-| react-demo, macos-demo, youaskm3-starter-kit, browser-consumer | **Adopted / secondary** demos & kits — lighter maintenance; not merge-blocking `embedded_smoke` targets — see [`adopted-platform-clients.md`](adopted-platform-clients.md) (`android-demo` retired) |
+| react-demo, youaskm3-starter-kit, browser-consumer | **Adopted / secondary** demos & kits — lighter maintenance; not merge-blocking `embedded_smoke` targets — see [`adopted-platform-clients.md`](adopted-platform-clients.md) (`android-demo`/`macos-demo` retired) (`android-demo` retired) |
+| react-demo, youaskm3-starter-kit, browser-consumer | **Adopted / secondary** demos & kits — lighter maintenance; not merge-blocking `embedded_smoke` targets — see [`adopted-platform-clients.md`](adopted-platform-clients.md) (`android-demo`/`macos-demo` retired) |
 
 ---
 

docs/production-reference-plan.md

@@ -44,7 +44,8 @@ Related:
 | Tier | Apps | Smoke / CI bar |
 |---|---|---|
 | **Primary product shells** | `traverse-starter`, `doc-approval`, `meeting-notes` | Production DoD; Linux-runnable `embedded_smoke` hard-fail |
-| **Adopted / secondary** | `react-demo`, `macos-demo`, `browser-consumer`, `youaskm3-starter-kit`, `llm-mcp-reference` | Lighter demo smokes only — **not** merge-blocking `embedded_smoke` targets (`android-demo` retired) |
+| **Adopted / secondary** | `react-demo`, `browser-consumer`, `youaskm3-starter-kit`, `llm-mcp-reference` | Lighter demo smokes only — **not** merge-blocking `embedded_smoke` targets (`android-demo`/`macos-demo` retired) |
+| **Adopted / secondary** | `react-demo`, `browser-consumer`, `youaskm3-starter-kit`, `llm-mcp-reference` | Lighter demo smokes only — **not** merge-blocking `embedded_smoke` targets |
 | **Debugger** | `trace-explorer` | Embedded Trace API companion — not a product shell to copy |
 
 Canonical narrative: [`adopted-platform-clients.md`](adopted-platform-clients.md) · front door: root `README.md`.