@starlove/orbit 1.1.1 → 1.1.11

package/dist/full/{styles.836872e7.css → styles.273fc37a.css}

@@ -321,7 +321,7 @@ textarea:focus {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  [data-theme="dark"] .topbar {
+  :root:not([data-motion="full"])[data-theme="dark"] .topbar {
     transition: none;
   }
 }
@@ -1037,8 +1037,8 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .create-flyout,
-  .create-flyout-backdrop {
+  :root:not([data-motion="full"]) .create-flyout,
+  :root:not([data-motion="full"]) .create-flyout-backdrop {
     transition: none;
   }
 }
@@ -1347,7 +1347,7 @@ h1 {
 }
 
 @media (hover: hover) and (pointer: fine) and (prefers-reduced-motion: reduce) {
-  .add-card-phantom {
+  :root:not([data-motion="full"]) .add-card-phantom {
     transition:
       color 160ms ease,
       border-color 160ms ease,
@@ -1402,7 +1402,7 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .agent-dot {
+  :root:not([data-motion="full"]) .agent-dot {
     animation: none;
   }
 }
@@ -1443,7 +1443,7 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .card-unread-dot {
+  :root:not([data-motion="full"]) .card-unread-dot {
     animation: none;
   }
 }
@@ -1691,7 +1691,7 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .card {
+  :root:not([data-motion="full"]) .card {
     animation: none;
   }
 }
@@ -1823,8 +1823,10 @@ h1 {
 [data-theme="dark"] .card {
   border-color: rgba(var(--starlight-rgb),0.12);
   box-shadow: 0 8px 20px rgba(0, 0, 0, 0.25);
-  backdrop-filter: blur(16px);
-  -webkit-backdrop-filter: blur(16px);
+  /* No backdrop-filter: --card is 85% opaque so the blur showed through ~15%
+     (near-invisible) yet forced every card to re-blur the animated starfield
+     behind it on every frame — the page's biggest GPU cost. The opaque fill
+     carries the surface; the starfield still animates in the gaps. */
 }
 
 [data-theme="dark"] .card.type-epic {
@@ -2134,7 +2136,7 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .priority-pill-urgent {
+  :root:not([data-motion="full"]) .priority-pill-urgent {
     animation: none;
   }
 }
@@ -2165,11 +2167,17 @@ h1 {
 }
 
 @media (prefers-reduced-motion: no-preference) {
-  [data-theme="dark"] .priority-pill-urgent {
+  :root:not([data-motion="reduce"])[data-theme="dark"] .priority-pill-urgent {
     box-shadow: 0 0 0 1px rgba(var(--coral-rgb),0.35), 0 4px 10px rgba(var(--coral-rgb),0.3);
   }
 }
 
+/* Full-motion escape hatch: show the urgent glow even when the OS prefers
+   reduced motion but the user forced full motion. */
+:root[data-motion="full"][data-theme="dark"] .priority-pill-urgent {
+  box-shadow: 0 0 0 1px rgba(var(--coral-rgb),0.35), 0 4px 10px rgba(var(--coral-rgb),0.3);
+}
+
 .card-expand-trigger {
   display: flex;
   align-items: center;
@@ -2339,8 +2347,8 @@ h1 {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .drawer,
-  .drawer-backdrop {
+  :root:not([data-motion="full"]) .drawer,
+  :root:not([data-motion="full"]) .drawer-backdrop {
     transition: none;
   }
 }
@@ -3671,16 +3679,13 @@ details.section > summary .mcp-title-row {
   min-height: 2rem;
 }
 
-/* Board Notes is the long-form home for project guidance; reserve a textarea
-   sized landing area so it doesn't collapse to a one-liner when empty. */
-.settings-notes-body {
+/* Long-form settings fields reserve textarea-sized landing areas so they don't
+   collapse to one-liners when empty. */
+.settings-notes-body,
+.settings-agent-instructions-body {
   min-height: 11rem;
 }
 
-.ai-context-setup textarea[name="agent_instructions"] {
-  min-height: 9rem;
-}
-
 .ai-context-setup > .description {
   margin-bottom: 0.7rem;
 }
@@ -5170,8 +5175,8 @@ button:disabled,
 .toast-error .toast-icon { color: #ef4444; }
 
 @media (prefers-reduced-motion: reduce) {
-  .toast-enter { animation: none; opacity: 1; transform: none; }
-  .toast-exit  { animation: none; }
+  :root:not([data-motion="full"]) .toast-enter { animation: none; opacity: 1; transform: none; }
+  :root:not([data-motion="full"]) .toast-exit  { animation: none; }
 }
 
 [data-theme="dark"] .toast {
@@ -5332,8 +5337,8 @@ button:disabled,
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .orbit-dialog,
-  .orbit-dialog::backdrop {
+  :root:not([data-motion="full"]) .orbit-dialog,
+  :root:not([data-motion="full"]) .orbit-dialog::backdrop {
     animation: none;
   }
 }
@@ -5669,40 +5674,75 @@ button:disabled,
   }
 }
 
+/* Reduced motion — Starscape v3 `data-motion` contract (migrated from the
+ * legacy `data-reduced-motion="reduce|allow"`):
+ *   • OS path: reduce when the OS asks, unless the user forces full motion.
+ *   • Explicit path: `data-motion="reduce"` reduces regardless of OS.
+ *   • `data-motion="full"` opts out of the OS path (full motion even on OS reduce). */
 @media (prefers-reduced-motion: reduce) {
-  [data-theme="dark"] .starfield,
-  [data-theme="dark"] .milky-way,
-  [data-theme="dark"] .grain::before,
-  [data-theme="dark"] .grain::after,
-  [data-theme="dark"] .signature-star {
+  :root:not([data-motion="full"]) *,
+  :root:not([data-motion="full"]) *::before,
+  :root:not([data-motion="full"]) *::after {
+    scroll-behavior: auto !important;
+    transition-duration: 0.01ms !important;
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+  }
+
+  :root:not([data-motion="full"])[data-theme="dark"] .starfield,
+  :root:not([data-motion="full"])[data-theme="dark"] .milky-way,
+  :root:not([data-motion="full"])[data-theme="dark"] .grain::before,
+  :root:not([data-motion="full"])[data-theme="dark"] .grain::after,
+  :root:not([data-motion="full"])[data-theme="dark"] .signature-star {
     animation: none;
   }
-  [data-theme="dark"] .meteor {
+
+  :root:not([data-motion="full"])[data-theme="dark"] .meteor {
     display: none;
   }
 }
 
-[data-reduced-motion="reduce"] *,
-[data-reduced-motion="reduce"] *::before,
-[data-reduced-motion="reduce"] *::after {
+[data-motion="reduce"] *,
+[data-motion="reduce"] *::before,
+[data-motion="reduce"] *::after {
   scroll-behavior: auto !important;
   transition-duration: 0.01ms !important;
   animation-duration: 0.01ms !important;
   animation-iteration-count: 1 !important;
 }
 
-[data-reduced-motion="reduce"][data-theme="dark"] .starfield,
-[data-reduced-motion="reduce"][data-theme="dark"] .milky-way,
-[data-reduced-motion="reduce"][data-theme="dark"] .grain::before,
-[data-reduced-motion="reduce"][data-theme="dark"] .grain::after,
-[data-reduced-motion="reduce"][data-theme="dark"] .signature-star {
+[data-motion="reduce"][data-theme="dark"] .starfield,
+[data-motion="reduce"][data-theme="dark"] .milky-way,
+[data-motion="reduce"][data-theme="dark"] .grain::before,
+[data-motion="reduce"][data-theme="dark"] .grain::after,
+[data-motion="reduce"][data-theme="dark"] .signature-star {
   animation: none;
 }
 
-[data-reduced-motion="reduce"][data-theme="dark"] .meteor {
+[data-motion="reduce"][data-theme="dark"] .meteor {
   display: none;
 }
 
+/* Empty-lane icon micro-motion — a low-amplitude exception to the OS reduced-
+ * motion reset above. These are small (64px), slow, localized loops, not the
+ * large-area/parallax motion that triggers vestibular discomfort, so they
+ * survive an *OS-level* reduced-motion preference. They are still fully stopped
+ * by an *explicit* in-app choice (data-motion="reduce") — a deliberate "calm it
+ * down" wins over the ambient OS default. The !important + selector specificity
+ * is what overrides the universal `* { animation-duration: 0.01ms !important }`
+ * reset for just these elements. */
+@media (prefers-reduced-motion: reduce) {
+  :root:not([data-motion="reduce"]) .empty-state-icon.star {
+    animation: star-pulse 4s ease-in-out infinite !important;
+  }
+  :root:not([data-motion="reduce"]) .empty-state-icon.ai-sparkle {
+    animation: ai-float 6s ease-in-out infinite !important;
+  }
+  :root:not([data-motion="reduce"]) .empty-state-icon.orbit .satellite {
+    animation: orbit-rotate 10s linear infinite !important;
+  }
+}
+
 [data-theme="dark"] {
   /* Tells the browser to render native widgets (dropdowns, scrollbars,
      date pickers, etc.) in their dark variant so option popups match. */

package/dist/full/version.json

@@ -1,6 +1,6 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.1.1",
+  "version": "1.1.11",
   "edition": "full",
-  "builtAt": "2026-05-26T05:55:12.573Z"
+  "builtAt": "2026-05-29T22:34:33.369Z"
 }

package/docs/AGENT_PROTOCOL.md

@@ -72,7 +72,7 @@ Returns the first schedulable `AI Ready` ticket. The scheduler skips tickets blo
 
 By default, `claim-next` skips `epic` cards because they are index/planning cards. To claim an epic for planning, pass `"type": "epic"` or `"include_epics": true`.
 
-The response shape is `{ claimed: true, ticket_id, context }` where `context` is the lightweight `board_read_ticket` pack (`ticket` with title/description/labels/state and the `board_manual`). Ticket comments are not included in the default claim context; call `GET /api/tickets/:id/comments` (or MCP `board_read_comments`) when an explicit chat/comment surface needs them. For the heavier ticket pack with relations, blockers, implementation fields, and child cards, call `GET /api/tickets/:id/context` (or MCP `board_get_ticket_context`).
+The response shape is `{ claimed: true, ticket_id, context }` where `context` is the lightweight `board_read_ticket` pack (`ticket` with title/description/labels/state and the `board_manual`). Ticket comments are not included in the default claim context; call `GET /api/tickets/:id/comments` (or MCP `board_read_comments`) when an explicit chat/comment surface needs them. For the lean ticket relationship pack, call `GET /api/tickets/:id/context` (or MCP `board_get_ticket_context`). For the historical heavy pack with board manual/journal attached, call `GET /api/tickets/:id/context/full` (or MCP `board_get_ticket_context_full`).
 
 ### Read Lightweight Ticket
 
@@ -86,7 +86,7 @@ MCP equivalent: `board_read_ticket`.
 
 Returns the lightweight agent read shape: `ticket` with identity, title, description, labels, state/type/priority, plus `board_manual`. Ticket comments, relations, blockers, child cards, and implementation fields are intentionally omitted. Use this for quick orientation and claim context. The `lookup` form is exact by per-board ticket number or exact title; it does not use fuzzy search or comment/implementation indexes.
 
-### Get Context Pack
+### Get Lean Ticket Context Pack
 
 ```http
 GET /api/tickets/:id/context?depth=1
@@ -94,15 +94,31 @@ GET /api/tickets/:id/context?depth=1
 
 Returns:
 
-- Ticket, board, state, labels.
-- The board manual (`board_manual`), including `agent_instructions` and `project_notes`.
+- Ticket, board identity, state, labels.
 - Dedicated implementation fields: `ai_plan`, `implementation_summary`, and `implementation_updates`.
 - Parent epic/story ticket when present.
 - Child feature cards when the ticket is an epic/story.
 - Related tickets.
 - Blockers and blocking tickets.
 
-Ticket comments are intentionally omitted from this default agent context. Explicit comment/chat consumers should call:
+Project manual/journal (`agent_instructions`, `project_notes`, and board entries) and ticket comments are intentionally omitted from this default agent context. Fetch project context and comments explicitly when needed:
+
+```http
+GET /api/boards/:board_id/context?include_struck=false
+GET /api/tickets/:id/comments
+```
+
+MCP equivalents: `board_context` and `board_read_comments`.
+
+### Get Full Ticket Context Pack
+
+```http
+GET /api/tickets/:id/context/full?depth=1
+```
+
+MCP equivalent: `board_get_ticket_context_full`.
+
+Returns the historical heavy context shape: everything in the lean ticket context plus the full board row and `board_manual` / journal. Comments are still intentionally omitted; explicit comment/chat consumers should call:
 
 ```http
 GET /api/tickets/:id/comments
@@ -176,7 +192,7 @@ Searches ticket titles, descriptions, and comments.
 GET /api/boards/:board_id/context?include_struck=false
 ```
 
-Returns the same shape as MCP `board_context`: a trimmed `board` (`name`, `agent_instructions`, `updated_at`), `entries` (journal / decisions / lessons), and `deployment` paths. Use `include_struck=true` to include struck journal rows (default off).
+Returns the same shape as MCP `board_context`: board metadata (`agent_instructions`, `project_notes`, repository paths, default branch), `entries` (journal / decisions / lessons), and `deployment` paths. Use `include_struck=true` to include struck journal rows (default off).
 
 MCP: `board_context` with optional `board_id` / `board_slug` / `board` and optional `include_struck`.
 

package/docs/ORBIT_DISPATCH.md

@@ -44,6 +44,11 @@ orbit dispatch --board my-app --ticket 12 --profile agent --worktree --foregroun
 orbit dispatch --board my-app --ticket 12 --profile agent --worktree \
   --branch orbit/my-app-12-search \
   --worktree-path .worktrees/my-app-12-search
+
+# Declare ticket-specific verification expectations in the handoff/run record.
+orbit dispatch --board my-app --ticket 12 --profile agent --worktree \
+  --verify-command "node --test test/orbit-cli.test.mjs" \
+  --verify-command "git diff --check"
 ```
 
 ## Preflight order
@@ -55,8 +60,9 @@ Before any filesystem writes, worktree creation, ticket mutation, or agent spawn
 3. Resolves the ticket from `--ticket` by number or id.
 4. Refuses archived tickets.
 5. Refuses blocked tickets unless `--force` is passed.
-6. For spawn mode, checks that the Hermes binary exists and the requested profile is plausible.
-7. Handles `--dry-run` as a true no-write preview.
+6. Rejects missing or flag-looking `--verify-command` values during CLI argument parsing.
+7. For spawn mode, checks that the Hermes binary exists and the requested profile is plausible.
+8. Handles `--dry-run` as a true no-write preview.
 
 Only after those checks does dispatch create run artifacts/worktrees, write the handoff/comment, move the ticket, or spawn Hermes.
 
@@ -67,14 +73,65 @@ In normal spawn mode:
 1. Builds a run id such as `orbit-12-agent-abc123def0`.
 2. Creates `.orbit/dispatch-runs/<run-id>/` for run metadata and policy wrappers.
 3. Creates and preserves a git worktree/branch when `--worktree` is used.
-4. Generates a full agent handoff and writes the canonical copy to the ticket's **AI Written-Plan** (`ai_plan`) field.
-5. Moves the ticket to **In Progress**.
-6. Starts Hermes.
-7. Comments a run record back onto the ticket.
+4. Generates a full agent handoff.
+5. Writes an initial durable `run-record.json` with status `prepared` before ticket mutation or agent spawn.
+6. Writes the canonical handoff copy to the ticket's **AI Written-Plan** (`ai_plan`) field.
+7. Moves the ticket to **In Progress**.
+8. Starts Hermes.
+9. Updates `run-record.json` to status `launched` with the child process id.
+10. Comments a run record back onto the ticket.
+
+In `--no-spawn` mode, dispatch writes the handoff, initial `run-record.json`, and run-record comment but leaves the ticket in its current lane.
+
+The run record includes profile, policy, ticket, branch, worktree, base commit, policy-bin path, child process id, command, declared verification commands, mode, and a `run-record.json` path. This makes the card the visible cockpit for the run while preserving a machine-readable artifact for later review/repair automation.
+
+## Structured run record
+
+Every non-dry-run dispatch writes `<DATA_DIR>/dispatch-runs/<board>/<run-id>/run-record.json` with schema `orbit.dispatch.run.v1`.
+
+The JSON record currently captures:
+
+- run id, board id/slug, ticket id/number, profile, policy, mode, and status (`prepared` for `--no-spawn`, `launched` for spawned runs)
+- prompt/handoff path, repo root, worktree, branch, and base commit
+- process id when a Hermes child was spawned
+- declared verification commands
+- empty `commit_shas` and `residual_risks` arrays for completion/review tooling to fill in later slices
+- a small environment-variance snapshot: platform, Node version, cwd, path format, and relevant `HOME`, `PROJECT_ROOT`, `DATA_DIR`, and `ORBIT_*` env vars
+
+URL-bearing values are presence-only redacted in `run-record.json`. `ORBIT_API_URL`, `ORBIT_SERVER_URL`, and the top-level `server_url` field are recorded as `[redacted-url-present]` when present, rather than persisting usernames, passwords, query tokens, fragments, hostnames, or paths. Non-URL environment checklist values such as `HOME`, `PROJECT_ROOT`, `DATA_DIR`, `ORBIT_MODE`, and `ORBIT_DEFAULT_BOARD` remain visible for variance debugging.
+
+Operators can override the default verification contract by repeating `--verify-command <cmd>` or using `--verify-command=<cmd>`. Bare `--verify-command`, `--verify-command=` and `--verify-command` followed by another flag are rejected before dispatch side effects. If omitted, dispatch declares the standard local-safe checklist: `npm test`, conditional `npm run build`, `node src/cli/orbit.js dispatch --help`, `git diff --check`, and `git diff --cached --check before commit`.
+
+## Structured review verdict records
 
-In `--no-spawn` mode, dispatch writes the handoff and run-record comment but leaves the ticket in its current lane.
+Sentinel/agent review results are first-class board data in `review_verdicts`, not prose-only comments. Each record belongs to one ticket and stores:
 
-The run record includes profile, policy, ticket, branch, worktree, policy-bin path, child process id, command, and mode. This makes the card the visible cockpit for the run.
+- `verdict`: one of `PASS`, `BLOCK`, or `QUESTION`
+- `blocking_findings`: JSON array for issues that must be repaired before approval
+- `optional_findings`: JSON array for non-blocking review notes
+- `evidence_commands`: JSON array of commands or probes the reviewer used as evidence
+- `reviewer_profile` and `reviewer_session_id`: optional reviewer identity/session metadata
+- `reviewed_commit_sha`: optional commit SHA under review
+- `dispatch_run_id`: optional dispatch run id tying the verdict back to `run-record.json`
+- `supersedes_prior_review_id`: optional link to an earlier verdict on the same ticket
+
+HTTP API:
+
+```text
+POST /api/tickets/:ticket_id/review-verdicts
+GET  /api/tickets/:ticket_id/review-verdicts?limit=50
+GET  /api/review-verdicts/:review_id?board=<slug-or-id>
+```
+
+MCP tools:
+
+```text
+board_create_review_verdict
+board_list_review_verdicts
+board_get_review_verdict
+```
+
+Comments may mirror verdict summaries for human scanning, but comments are not the source of truth for review automation. Later repair and re-review tooling should read these records directly.
 
 ## The AI Written-Plan handoff
 
@@ -91,10 +148,13 @@ Dispatch stores the generated handoff in the ticket's AI Written-Plan field. It
 - unresolved blockers
 - scope boundaries
 - autonomous policy
+- declared verification commands and environment-variance checklist
 - completion protocol
 
 The short prompt passed to `hermes chat -q` is intentionally small. The ticket is the source of truth; the CLI argument is only a bootstrap pointer.
 
+Board journal entries are framed as project constraints and lessons, not persona or roleplay instructions. Keep durable board entries focused on mechanisms, architectural/product boundaries, workflow invariants, public-product implications, and reusable pitfalls; use ticket fields/comments for run-specific chronology.
+
 ## Preserved worktrees
 
 Use `--worktree` when the agent will edit code. Dispatch creates a normal git worktree under `.worktrees/` by default and gives the agent that directory as its working directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.1.1",
+  "version": "1.1.11",
   "description": "Starscape Orbit ??? zero-dependency, pretty, human-ai-first kanban system.",
   "license": "AGPL-3.0",
   "type": "module",

package/public/index.html

@@ -15,9 +15,129 @@
             sizes="180x180"
             href="./apple-touch-icon.png"
         />
+        <!-- Apply the stored theme + motion preference before first paint, so
+             the app underneath the splash paints in the right theme (no flash)
+             and the splash respects an explicit reduce-motion choice. Mirrors
+             theme-preference.js (mab_theme) and motion-preference.js
+             (mab_reduce_motion → data-motion); main.js reconciles on load. -->
+        <script>
+            try {
+                var t = localStorage.getItem("mab_theme");
+                if (t === "light" || t === "dark")
+                    document.documentElement.setAttribute("data-theme", t);
+                var rm = localStorage.getItem("mab_reduce_motion");
+                if (rm === "true")
+                    document.documentElement.setAttribute("data-motion", "reduce");
+                else if (rm === "false")
+                    document.documentElement.setAttribute("data-motion", "full");
+            } catch (e) {}
+        </script>
+        <link rel="preload" as="image" href="./orbits-logo.png" />
         <link rel="stylesheet" href="/styles.css" />
+        <!-- Boot splash — the canonical ss-ui loading screen (see the package's
+             components/loader.css). Inline critical CSS so it paints before
+             /js/main.js loads. The logo grows in then breathes; no spinner.
+             Keyframes namespaced `ss-loader-*`. Under reduced motion the grow-in
+             is dropped and the dot grid stops; the gentle breathe stays. -->
+        <style>
+            .ss-loader {
+                position: fixed;
+                inset: 0;
+                z-index: 99999;
+                display: flex;
+                flex-direction: column;
+                align-items: center;
+                justify-content: center;
+                gap: 2rem;
+                overflow: hidden;
+                background: linear-gradient(
+                    135deg,
+                    #1a1a2e 0%,
+                    #16213e 50%,
+                    #0f3460 100%
+                );
+                transition: opacity 0.4s ease;
+                font-family: -apple-system, BlinkMacSystemFont, "Segoe UI",
+                    Roboto, "Helvetica Neue", Arial, sans-serif;
+            }
+            .ss-loader::before {
+                content: "";
+                position: absolute;
+                width: 200%;
+                height: 200%;
+                background-image: radial-gradient(
+                    circle,
+                    rgba(168, 192, 255, 0.15) 1px,
+                    transparent 1px
+                );
+                background-size: 50px 50px;
+                will-change: transform;
+                animation: ss-loader-drift 20s linear infinite;
+            }
+            .ss-loader.is-hiding {
+                opacity: 0;
+                pointer-events: none;
+            }
+            .ss-loader__logo {
+                width: 120px;
+                height: 120px;
+                object-fit: contain;
+                filter: drop-shadow(0 0 20px rgba(255, 255, 255, 0.3));
+                transform-origin: center;
+                will-change: transform;
+                animation:
+                    ss-loader-grow 0.6s cubic-bezier(0.22, 1, 0.36, 1) both,
+                    ss-loader-breathe 3s ease-in-out 0.6s infinite;
+            }
+            .ss-loader__label {
+                margin: 0;
+                color: #fff;
+                font-size: 1.25rem;
+                font-weight: 600;
+                letter-spacing: 0.5px;
+                text-shadow: 0 2px 10px rgba(0, 0, 0, 0.3);
+            }
+            @keyframes ss-loader-drift {
+                from { transform: translate(0, 0); }
+                to { transform: translate(-50px, -50px); }
+            }
+            @keyframes ss-loader-grow {
+                from { transform: scale(0); opacity: 0; }
+                to { transform: scale(1); opacity: 1; }
+            }
+            @keyframes ss-loader-breathe {
+                0%, 100% { transform: scale(1); }
+                50% { transform: scale(1.06); }
+            }
+            @media (prefers-reduced-motion: reduce) {
+                :root:not([data-motion="full"]) .ss-loader::before {
+                    animation: none;
+                }
+                :root:not([data-motion="full"]) .ss-loader__logo {
+                    animation: ss-loader-breathe 3s ease-in-out infinite;
+                }
+            }
+            [data-motion="reduce"] .ss-loader::before {
+                animation: none;
+            }
+            [data-motion="reduce"] .ss-loader__logo {
+                animation: ss-loader-breathe 3s ease-in-out infinite;
+            }
+        </style>
     </head>
     <body>
+        <!-- Boot splash - shown immediately, removed once the app is ready. -->
+        <div id="ss-loader" class="ss-loader" role="status" aria-live="polite">
+            <img
+                class="ss-loader__logo"
+                src="./orbits-logo.png"
+                alt="Orbit"
+                width="120"
+                height="120"
+            />
+            <p class="ss-loader__label">Loading Orbit…</p>
+        </div>
+
         <div class="grain">
             <div class="milky-way" aria-hidden="true"></div>
         </div>
@@ -170,19 +290,10 @@
         ></div>
         <aside id="drawer" class="drawer" hidden aria-label="Panel">
             <header class="drawer-header">
-                <div class="drawer-title-block">
-                    <span
-                        id="drawerEyebrow"
-                        class="drawer-eyebrow"
-                        hidden
-                    ></span>
-                    <h2 id="drawerTitle" class="drawer-title-text"></h2>
-                    <div
-                        id="drawerSubtitle"
-                        class="drawer-subtitle"
-                        hidden
-                    ></div>
-                </div>
+                <div
+                    id="drawerTitleBlock"
+                    class="drawer-title-block"
+                ></div>
                 <nav
                     id="drawerTabs"
                     class="drawer-tabs"
@@ -310,5 +421,39 @@
         </dialog>
 
         <script src="/js/main.js" type="module"></script>
+        <!-- Fade out the boot splash once the DOM is ready. The /js/main.js
+             module runs before DOMContentLoaded, so theme/motion + wiring are
+             already applied by the time this fires. -->
+        <script>
+            (function () {
+                function hideSplash() {
+                    var splash = document.getElementById("ss-loader");
+                    if (!splash) return;
+                    // Keep the splash up for a minimum of 786ms (measured from
+                    // navigation start) so a fast load doesn't flash it in and out.
+                    var wait = Math.max(0, 786 - performance.now());
+                    setTimeout(function () {
+                        splash.classList.add("is-hiding");
+                        splash.addEventListener(
+                            "transitionend",
+                            function () {
+                                splash.remove();
+                            },
+                            { once: true }
+                        );
+                        setTimeout(function () {
+                            splash.remove();
+                        }, 600);
+                    }, wait);
+                }
+                if (document.readyState === "loading") {
+                    document.addEventListener("DOMContentLoaded", hideSplash, {
+                        once: true
+                    });
+                } else {
+                    hideSplash();
+                }
+            })();
+        </script>
     </body>
 </html>