From 67a688a699cda768a42ac12af1c941a853184998 Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:10:43 +0000
Subject: [PATCH 1/6] feat: complete V8 control room upgrade

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 LOGISDATA/.env.example                        |   3 +-
 LOGISDATA/next.config.ts                      |   7 +-
 LOGISDATA/src/app/api/health/route.ts         |   5 +-
 LOGISDATA/src/app/globals.css                 |  45 ++-
 LOGISDATA/src/components/HandoutView.tsx      |   3 +-
 LOGISDATA/src/components/Presentation.tsx     |  18 +-
 .../src/components/archived/IntroScreen.tsx   |   2 +-
 .../src/components/sections/AuditSection.tsx  |  18 +-
 .../src/components/sections/DemandSection.tsx |   2 +-
 .../src/components/sections/HeroSection.tsx   |   8 +-
 .../src/components/sections/RoutesSection.tsx |  13 +-
 .../components/sections/WarehouseSection.tsx  |   2 +-
 LOGISDATA/src/components/ui/AudioToggle.tsx   |   2 +-
 LOGISDATA/src/components/ui/DatasetExport.tsx |  14 +-
 LOGISDATA/src/components/ui/KeyboardHelp.tsx  |  21 +-
 .../src/components/ui/LiveTelemetryFeed.tsx   |  54 ++-
 .../src/components/ui/NodeInspectorModal.tsx  |  27 +-
 .../src/components/ui/RecoveryCalculator.tsx  |  15 +-
 .../src/components/ui/ScenarioSwitcher.tsx    |  74 ++--
 LOGISDATA/src/lib/export.ts                   | 153 +++++---
 LOGISDATA/src/lib/i18n.ts                     |  28 +-
 LOGISDATA/src/lib/keyboard.ts                 |  41 ++
 LOGISDATA/src/lib/metrics.ts                  |  12 +-
 LOGISDATA/src/lib/sound.ts                    |   2 +
 LOGISDATA/src/lib/useNativeDialog.ts          |  48 +++
 LOGISDATA/tests/e2e/navigation.spec.ts        |  25 +-
 LOGISDATA/tests/setup.ts                      |   9 +-
 LOGISDATA/tests/unit/components.test.tsx      |  17 +-
 LOGISDATA/tests/unit/db.test.ts               |  21 +-
 LOGISDATA/tests/unit/export.test.ts           |  46 ++-
 LOGISDATA/tests/unit/health.test.ts           |  43 +++
 LOGISDATA/tests/unit/keyboard.test.ts         |  50 +++
 LOGISDATA/tests/unit/metrics.test.ts          |   8 +
 LOGISDATA/tests/unit/newComponents.test.tsx   | 223 ++++++++---
 .../tests/unit/sectionComponents.test.tsx     |  50 +++
 LOGISDATA/tests/unit/simulation.test.ts       |  33 +-
 LOGISDATA/tests/unit/sound.test.ts            |  11 +-
 README.md                                     |  87 +++--
 UPGRADE_LOG.md                                | 349 ++++++++++++++++++
 docs/ARCHITECTURE.md                          |  48 +--
 docs/UPGRADE.md                               |  51 ++-
 41 files changed, 1389 insertions(+), 299 deletions(-)
 create mode 100644 LOGISDATA/src/lib/keyboard.ts
 create mode 100644 LOGISDATA/src/lib/useNativeDialog.ts
 create mode 100644 LOGISDATA/tests/unit/health.test.ts
 create mode 100644 LOGISDATA/tests/unit/keyboard.test.ts
 create mode 100644 UPGRADE_LOG.md

diff --git a/LOGISDATA/.env.example b/LOGISDATA/.env.example
index d8e1af3..19f63bb 100644
--- a/LOGISDATA/.env.example
+++ b/LOGISDATA/.env.example
@@ -9,7 +9,8 @@
 NEXT_PUBLIC_SITE_URL=http://localhost:3000
 
 # Version string reported by GET /api/health.
-NEXT_PUBLIC_APP_VERSION=3.0.0
+# Optional deployment build identifier; defaults to package.json version.
+NEXT_PUBLIC_APP_VERSION=3.1.0
 
 # ---------------------------------------------------------------------
 # Database (optional). Only needed if you add database-backed features.
diff --git a/LOGISDATA/next.config.ts b/LOGISDATA/next.config.ts
index 6fa6fe3..5d214d0 100644
--- a/LOGISDATA/next.config.ts
+++ b/LOGISDATA/next.config.ts
@@ -72,11 +72,8 @@ const nextConfig: NextConfig = {
     return [
       { source: "/(.*)", headers: securityHeaders },
       {
-        // Immutable hashed build assets.
-        source: "/_next/static/:path*",
-        headers: [{ key: "Cache-Control", value: "public, max-age=31536000, immutable" }],
-      },
-      {
+        // Next.js owns the immutable cache policy for hashed `/_next/static`
+        // assets. Overriding it here is redundant and triggers a build warning.
         source: "/api/:path*",
         headers: [{ key: "Cache-Control", value: "no-store, max-age=0" }],
       },
diff --git a/LOGISDATA/src/app/api/health/route.ts b/LOGISDATA/src/app/api/health/route.ts
index 935bbe0..7ddc29c 100644
--- a/LOGISDATA/src/app/api/health/route.ts
+++ b/LOGISDATA/src/app/api/health/route.ts
@@ -1,4 +1,5 @@
 import { sql } from "drizzle-orm";
+import packageMetadata from "../../../../package.json";
 import { getDb, isDatabaseConfigured } from "@/db";
 
 export const dynamic = "force-dynamic";
@@ -51,7 +52,9 @@ export async function GET(): Promise<Response> {
   const payload: HealthPayload = {
     ok: database !== "unavailable",
     service: "logisdata-control-room",
-    version: process.env.NEXT_PUBLIC_APP_VERSION ?? "3.0.0",
+    // Package metadata is the release source of truth. Deployments may
+    // override it with an immutable build identifier when required.
+    version: process.env.NEXT_PUBLIC_APP_VERSION?.trim() || packageMetadata.version,
     database,
     uptimeSeconds: Math.round(process.uptime()),
     timestamp: new Date().toISOString(),
diff --git a/LOGISDATA/src/app/globals.css b/LOGISDATA/src/app/globals.css
index 3edb0ac..632a962 100644
--- a/LOGISDATA/src/app/globals.css
+++ b/LOGISDATA/src/app/globals.css
@@ -871,6 +871,12 @@ button:focus-visible {
 .verdict-red { color: var(--red); background: rgba(251, 91, 91, 0.06); }
 .verdict-green { color: var(--emerald); background: rgba(77, 225, 193, 0.06); }
 
+.table-empty-state {
+  padding: 28px 16px !important;
+  color: var(--text-muted);
+  text-align: center;
+}
+
 .table-footnote {
   padding: 11px 17px;
   border-top: 1px solid var(--line);
@@ -2570,6 +2576,15 @@ html[data-theme="light"] {
   font-size: 0.68rem;
 }
 
+.telemetry-disclosure {
+  margin: 0;
+  padding: 8px 14px;
+  border-bottom: 1px solid var(--line);
+  color: var(--text-muted);
+  font-size: 0.62rem;
+  line-height: 1.5;
+}
+
 .telemetry-filters {
   display: flex;
   align-items: center;
@@ -2685,17 +2700,33 @@ html[data-theme="light"] {
 .inspector-overlay {
   position: fixed;
   inset: 0;
+  width: 100%;
+  max-width: none;
+  height: 100dvh;
+  max-height: none;
+  margin: 0;
+  border: 0;
   background: rgba(4, 12, 20, 0.75);
+  color: inherit;
   backdrop-filter: blur(8px);
   -webkit-backdrop-filter: blur(8px);
-  display: flex;
+  display: none;
   align-items: center;
   justify-content: center;
-  z-index: 100;
   padding: 18px;
   animation: overlay-fade 200ms ease both;
 }
 
+.calculator-overlay[open],
+.inspector-overlay[open] {
+  display: flex;
+}
+
+.calculator-overlay::backdrop,
+.inspector-overlay::backdrop {
+  background: transparent;
+}
+
 @keyframes overlay-fade {
   from { opacity: 0; }
   to { opacity: 1; }
@@ -2761,6 +2792,16 @@ html[data-theme="light"] {
   gap: 20px;
 }
 
+.calculator-disclosure {
+  margin: 0;
+  padding: 10px 12px;
+  border-inline-start: 2px solid var(--amber);
+  background: var(--surface-soft);
+  color: var(--text-muted);
+  font-size: 0.68rem;
+  line-height: 1.6;
+}
+
 .calculator-inputs {
   display: flex;
   flex-direction: column;
diff --git a/LOGISDATA/src/components/HandoutView.tsx b/LOGISDATA/src/components/HandoutView.tsx
index 115d1be..376a68d 100644
--- a/LOGISDATA/src/components/HandoutView.tsx
+++ b/LOGISDATA/src/components/HandoutView.tsx
@@ -80,7 +80,7 @@ function Handout() {
             aria-pressed={theme === "light"}
           >
             {theme === "dark" ? <Sun size={15} aria-hidden="true" /> : <Moon size={15} aria-hidden="true" />}
-            <span>{theme === "dark" ? "LIGHT" : "DARK"}</span>
+            <span>{t(theme === "dark" ? "themeLight" : "themeDark", language)}</span>
           </button>
           <button type="button" className="control-button" onClick={() => window.print()}>
             <Printer size={15} aria-hidden="true" />
@@ -287,6 +287,7 @@ function Handout() {
             <Calculator size={20} className="inline-icon" aria-hidden="true" />
             <strong className="handout-recovery-heading">{t("calculatorTitle", language)}</strong>
           </div>
+          <p className="calculator-disclosure">{t("calculatorDisclosure", language)}</p>
           <div className="handout-recovery-grid">
             <div className="handout-recovery-controls">
               <div className="input-group">
diff --git a/LOGISDATA/src/components/Presentation.tsx b/LOGISDATA/src/components/Presentation.tsx
index ac6c78c..834273c 100644
--- a/LOGISDATA/src/components/Presentation.tsx
+++ b/LOGISDATA/src/components/Presentation.tsx
@@ -21,6 +21,7 @@ import type { WebGLRenderer } from "three";
 import { presentationCopy } from "@/lib/data";
 import { downloadExecutiveReportJson } from "@/lib/export";
 import { t, text } from "@/lib/i18n";
+import { shouldIgnorePresentationShortcut } from "@/lib/keyboard";
 import { DURATION, transition } from "@/lib/motion";
 import { sound } from "@/lib/sound";
 import {
@@ -49,7 +50,6 @@ import { ScenarioSwitcher } from "@/components/ui/ScenarioSwitcher";
 
 const NEXT_KEYS = new Set(["ArrowDown", "ArrowRight", "PageDown", " ", "Spacebar"]);
 const PREV_KEYS = new Set(["ArrowUp", "ArrowLeft", "PageUp"]);
-const EDITABLE = "input, textarea, select, [contenteditable='true']";
 
 interface ScrollBridgeProps {
   onReady: (element: HTMLDivElement, fill: HTMLDivElement, fixed: HTMLDivElement) => void;
@@ -268,9 +268,11 @@ export function Presentation() {
       setPageVisible(document.visibilityState === "visible");
     };
     const onKeyDown = (event: KeyboardEvent) => {
-      const active = document.activeElement;
-      if (active && active.matches(EDITABLE)) return;
-      if (event.altKey || event.ctrlKey || event.metaKey) return;
+      if (shouldIgnorePresentationShortcut(
+        event,
+        document.activeElement,
+        Boolean(document.querySelector("dialog[open]")),
+      )) return;
 
       if (event.key === "?" || (event.key === "/" && event.shiftKey)) {
         event.preventDefault();
@@ -413,6 +415,8 @@ export function Presentation() {
             className={`control-button ${telemetryOpen ? "btn-active-glow" : ""}`}
             onClick={() => setTelemetryOpen((v) => !v)}
             aria-label={t("telemetryToggle", language)}
+            aria-controls="telemetry-panel"
+            aria-expanded={telemetryOpen}
           >
             <Activity size={15} aria-hidden="true" />
             <span>{t("telemetryToggle", language)}</span>
@@ -424,6 +428,7 @@ export function Presentation() {
             className="control-button"
             onClick={() => setCalculatorOpen(true)}
             aria-label={t("calculatorOpen", language)}
+            aria-haspopup="dialog"
           >
             <Calculator size={15} aria-hidden="true" />
             <span>{t("calculatorOpen", language)}</span>
@@ -433,7 +438,7 @@ export function Presentation() {
           <button
             type="button"
             className="control-button"
-            onClick={() => downloadExecutiveReportJson(language)}
+            onClick={() => downloadExecutiveReportJson(language, scenario)}
             aria-label={t("exportJson", language)}
             title={t("exportJson", language)}
           >
@@ -456,6 +461,7 @@ export function Presentation() {
             type="button"
             onClick={() => setHelpOpen(true)}
             aria-label={t("shortcuts", language)}
+            aria-haspopup="dialog"
           >
             <Keyboard size={15} aria-hidden="true" />
             <span aria-hidden="true">?</span>
@@ -481,7 +487,7 @@ export function Presentation() {
             aria-pressed={theme === "light"}
           >
             {theme === "dark" ? <Sun size={15} aria-hidden="true" /> : <Moon size={15} aria-hidden="true" />}
-            <span>{theme === "dark" ? "LIGHT" : "DARK"}</span>
+            <span>{t(theme === "dark" ? "themeLight" : "themeDark", language)}</span>
           </button>
         </div>
       </header>
diff --git a/LOGISDATA/src/components/archived/IntroScreen.tsx b/LOGISDATA/src/components/archived/IntroScreen.tsx
index 34a2323..0637253 100644
--- a/LOGISDATA/src/components/archived/IntroScreen.tsx
+++ b/LOGISDATA/src/components/archived/IntroScreen.tsx
@@ -58,7 +58,7 @@ export function IntroScreen({ onEnter }: IntroScreenProps) {
           aria-pressed={theme === "light"}
         >
           {theme === "dark" ? <Sun size={15} aria-hidden="true" /> : <Moon size={15} aria-hidden="true" />}
-          <span>{theme === "dark" ? "LIGHT" : "DARK"}</span>
+          <span>{t(theme === "dark" ? "themeLight" : "themeDark", language)}</span>
         </button>
       </div>
 
diff --git a/LOGISDATA/src/components/sections/AuditSection.tsx b/LOGISDATA/src/components/sections/AuditSection.tsx
index 66454ef..8175eb3 100644
--- a/LOGISDATA/src/components/sections/AuditSection.tsx
+++ b/LOGISDATA/src/components/sections/AuditSection.tsx
@@ -6,7 +6,6 @@ import { AlertTriangle, Check, FileCheck2, Filter, ScanLine, Search } from "luci
 import { presentationCopy } from "@/lib/data";
 import { getScenarioFreightRows } from "@/lib/simulation";
 import { integer, number, text, t } from "@/lib/i18n";
-import { auditSummary } from "@/lib/metrics";
 import { DURATION, STAGGER, staggerDelay, transition } from "@/lib/motion";
 import { SECTIONS } from "@/lib/sections";
 import { GlassCard } from "@/components/ui/GlassCard";
@@ -32,7 +31,10 @@ function AuditSectionImpl({ language, active, reduced, scenario = "active-audit"
     });
   }, [scenario, language, searchQuery, verdictFilter]);
 
-  const flaggedCount = rows.filter((r) => r.verdict === "red-flag").length;
+  const flaggedCount = rows.filter((row) => row.verdict === "red-flag").length;
+  const totalOverchargePct = rows
+    .filter((row) => row.verdict === "red-flag")
+    .reduce((sum, row) => sum + row.overchargePct, 0);
 
   return (
     <section
@@ -64,7 +66,7 @@ function AuditSectionImpl({ language, active, reduced, scenario = "active-audit"
                 {integer(flaggedCount, language)} / {integer(rows.length, language)}
               </p>
               <p className="summary-label">
-                {text(copy.redFlag, language)} · {number(auditSummary.totalOverchargePct, language, 1)}%{" "}
+                {text(copy.redFlag, language)} · {number(totalOverchargePct, language, 1)}%{" "}
                 {text(copy.tableHeaders.overcharge, language)}
               </p>
             </div>
@@ -115,7 +117,7 @@ function AuditSectionImpl({ language, active, reduced, scenario = "active-audit"
             </div>
 
             <div className="toolbar-actions">
-              <DatasetExport dataset="freight-audit" language={language} />
+              <DatasetExport dataset="freight-audit" language={language} scenario={scenario} />
             </div>
           </div>
 
@@ -133,7 +135,13 @@ function AuditSectionImpl({ language, active, reduced, scenario = "active-audit"
                 </tr>
               </thead>
               <tbody>
-                {rows.map((row, index) => {
+                {rows.length === 0 ? (
+                  <tr>
+                    <td className="table-empty-state" colSpan={6}>
+                      {t("noRecords", language)}
+                    </td>
+                  </tr>
+                ) : rows.map((row, index) => {
                   const isFlagged = row.verdict === "red-flag";
                   return (
                     <motion.tr
diff --git a/LOGISDATA/src/components/sections/DemandSection.tsx b/LOGISDATA/src/components/sections/DemandSection.tsx
index 3bd854d..3bd8672 100644
--- a/LOGISDATA/src/components/sections/DemandSection.tsx
+++ b/LOGISDATA/src/components/sections/DemandSection.tsx
@@ -79,7 +79,7 @@ function DemandSectionImpl({ language, active, reduced, scenario = "active-audit
                   <i className="legend-dot legend-audited" aria-hidden="true" />
                   {text(copy.chartAudited, language)}
                 </span>
-                <DatasetExport dataset="demand-signal" language={language} />
+                <DatasetExport dataset="demand-signal" language={language} scenario={scenario} />
               </div>
             </div>
 
diff --git a/LOGISDATA/src/components/sections/HeroSection.tsx b/LOGISDATA/src/components/sections/HeroSection.tsx
index 37a6f9f..609ab4a 100644
--- a/LOGISDATA/src/components/sections/HeroSection.tsx
+++ b/LOGISDATA/src/components/sections/HeroSection.tsx
@@ -6,7 +6,7 @@ import Image from "next/image";
 import { ArrowDown, Network, ShieldCheck } from "lucide-react";
 import { presentationCopy, supplyNodes } from "@/lib/data";
 import { getScenarioMetrics } from "@/lib/simulation";
-import { text } from "@/lib/i18n";
+import { t, text } from "@/lib/i18n";
 import { sound } from "@/lib/sound";
 import { DURATION, transition } from "@/lib/motion";
 import { SECTIONS } from "@/lib/sections";
@@ -95,7 +95,7 @@ function HeroSectionImpl({ language, active, reduced, scenario = "active-audit",
           </GlassCard>
 
           {/* Interactive Supply Nodes Quick Telemetry Bar */}
-          <div className="hero-nodes-bar" role="toolbar" aria-label="Supply chain node selector">
+          <div className="hero-nodes-bar" role="group" aria-label={t("nodeSelector", language)}>
             {supplyNodes.map((node) => {
               const isLeak = node.status === "leak";
               const isPhantom = node.status === "phantom";
@@ -106,7 +106,9 @@ function HeroSectionImpl({ language, active, reduced, scenario = "active-audit",
                   type="button"
                   className="hero-node-chip"
                   onClick={() => handleNodeClick(node.id)}
-                  title={`Inspect ${text(node.label, language)}`}
+                  aria-haspopup="dialog"
+                  aria-label={`${t("inspectNode", language)} ${text(node.label, language)}`}
+                  title={`${t("inspectNode", language)} ${text(node.label, language)}`}
                 >
                   <span className={`node-dot ${dotClass}`} aria-hidden="true" />
                   <span>{text(node.label, language)}</span>
diff --git a/LOGISDATA/src/components/sections/RoutesSection.tsx b/LOGISDATA/src/components/sections/RoutesSection.tsx
index f0b05bf..743d616 100644
--- a/LOGISDATA/src/components/sections/RoutesSection.tsx
+++ b/LOGISDATA/src/components/sections/RoutesSection.tsx
@@ -60,6 +60,9 @@ function RoutesSectionImpl({ language, active, reduced, scenario = "active-audit
     }
   };
 
+  const sortDirection = (field: RouteSortField): "ascending" | "descending" | "none" =>
+    sortField === field ? (sortAsc ? "ascending" : "descending") : "none";
+
   return (
     <section
       id={SECTIONS[3].domId}
@@ -112,7 +115,7 @@ function RoutesSectionImpl({ language, active, reduced, scenario = "active-audit
                 <i className="route-line route-line-red" aria-hidden="true" />
                 {text(copy.detour, language)}
               </span>
-              <DatasetExport dataset="route-intelligence" language={language} />
+              <DatasetExport dataset="route-intelligence" language={language} scenario={scenario} />
             </div>
           </div>
 
@@ -123,25 +126,25 @@ function RoutesSectionImpl({ language, active, reduced, scenario = "active-audit
                 <tr>
                   <th scope="col" aria-label="#">#</th>
                   <th scope="col">{text(copy.headers.region, language)}</th>
-                  <th scope="col">
+                  <th scope="col" aria-sort={sortDirection("waste")}>
                     <button type="button" className="sort-th-btn" onClick={() => toggleSort("waste")}>
                       <span>{text(copy.headers.waste, language)}</span>
                       <ArrowUpDown size={12} aria-hidden="true" />
                     </button>
                   </th>
-                  <th scope="col">
+                  <th scope="col" aria-sort={sortDirection("fuel")}>
                     <button type="button" className="sort-th-btn" onClick={() => toggleSort("fuel")}>
                       <span>{text(copy.headers.fuel, language)}</span>
                       <ArrowUpDown size={12} aria-hidden="true" />
                     </button>
                   </th>
-                  <th scope="col">
+                  <th scope="col" aria-sort={sortDirection("gps")}>
                     <button type="button" className="sort-th-btn" onClick={() => toggleSort("gps")}>
                       <span>{text(copy.headers.gps, language)}</span>
                       <ArrowUpDown size={12} aria-hidden="true" />
                     </button>
                   </th>
-                  <th scope="col">
+                  <th scope="col" aria-sort={sortDirection("savings")}>
                     <button type="button" className="sort-th-btn" onClick={() => toggleSort("savings")}>
                       <span>{text(copy.headers.savings, language)}</span>
                       <ArrowUpDown size={12} aria-hidden="true" />
diff --git a/LOGISDATA/src/components/sections/WarehouseSection.tsx b/LOGISDATA/src/components/sections/WarehouseSection.tsx
index 191c2db..2975db8 100644
--- a/LOGISDATA/src/components/sections/WarehouseSection.tsx
+++ b/LOGISDATA/src/components/sections/WarehouseSection.tsx
@@ -116,7 +116,7 @@ function WarehouseSectionImpl({ language, active, reduced, scenario = "active-au
             {text(copy.audited, language)} · {integer(auditedBinsCount, language)}
           </span>
           <span className="warehouse-footer-note">{text(presentationCopy.footer.statement, language)}</span>
-          <DatasetExport dataset="warehouse-control" language={language} />
+          <DatasetExport dataset="warehouse-control" language={language} scenario={scenario} />
         </motion.div>
         <p className="warehouse-illustrative">{text(presentationCopy.footer.illustrative, language)}</p>
       </div>
diff --git a/LOGISDATA/src/components/ui/AudioToggle.tsx b/LOGISDATA/src/components/ui/AudioToggle.tsx
index ebe11df..c85dedb 100644
--- a/LOGISDATA/src/components/ui/AudioToggle.tsx
+++ b/LOGISDATA/src/components/ui/AudioToggle.tsx
@@ -27,7 +27,7 @@ export function AudioToggle({ language }: AudioToggleProps) {
       aria-pressed={enabled}
     >
       {enabled ? <Volume2 size={15} aria-hidden="true" /> : <VolumeX size={15} aria-hidden="true" />}
-      <span>{enabled ? "SFX" : "MUTE"}</span>
+      <span>{t(enabled ? "soundShortOn" : "soundShortOff", language)}</span>
     </button>
   );
 }
diff --git a/LOGISDATA/src/components/ui/DatasetExport.tsx b/LOGISDATA/src/components/ui/DatasetExport.tsx
index d1b6753..dd7d9a4 100644
--- a/LOGISDATA/src/components/ui/DatasetExport.tsx
+++ b/LOGISDATA/src/components/ui/DatasetExport.tsx
@@ -4,11 +4,12 @@ import { useCallback, useState } from "react";
 import { Download } from "lucide-react";
 import { downloadDataset, type DatasetId } from "@/lib/export";
 import { t } from "@/lib/i18n";
-import type { Language } from "@/lib/types";
+import type { AuditScenario, Language } from "@/lib/types";
 
 interface DatasetExportProps {
   dataset: DatasetId;
   language: Language;
+  scenario?: AuditScenario;
   label?: string;
 }
 
@@ -16,14 +17,19 @@ interface DatasetExportProps {
  * One-click CSV export for the dataset behind a section's table. Numbers
  * shown on screen are now verifiable and reusable without re-keying.
  */
-export function DatasetExport({ dataset, language, label }: DatasetExportProps) {
+export function DatasetExport({
+  dataset,
+  language,
+  scenario = "active-audit",
+  label,
+}: DatasetExportProps) {
   const [done, setDone] = useState(false);
 
   const onClick = useCallback(() => {
-    if (!downloadDataset(dataset, language)) return;
+    if (!downloadDataset(dataset, language, scenario)) return;
     setDone(true);
     window.setTimeout(() => setDone(false), 2200);
-  }, [dataset, language]);
+  }, [dataset, language, scenario]);
 
   return (
     <button type="button" className="export-button" onClick={onClick} data-dataset={dataset}>
diff --git a/LOGISDATA/src/components/ui/KeyboardHelp.tsx b/LOGISDATA/src/components/ui/KeyboardHelp.tsx
index 03d6c56..89fbda3 100644
--- a/LOGISDATA/src/components/ui/KeyboardHelp.tsx
+++ b/LOGISDATA/src/components/ui/KeyboardHelp.tsx
@@ -1,8 +1,8 @@
 "use client";
 
-import { useEffect, useRef } from "react";
 import { X } from "lucide-react";
 import { t } from "@/lib/i18n";
+import { useNativeDialog } from "@/lib/useNativeDialog";
 import type { Language } from "@/lib/types";
 
 interface KeyboardHelpProps {
@@ -31,20 +31,19 @@ const SHORTCUTS = [
  * hand-rolled (and usually incorrect) JavaScript.
  */
 export function KeyboardHelp({ open, language, onClose }: KeyboardHelpProps) {
-  const dialogRef = useRef<HTMLDialogElement>(null);
-
-  useEffect(() => {
-    const dialog = dialogRef.current;
-    if (!dialog) return;
-    if (open && !dialog.open) dialog.showModal();
-    if (!open && dialog.open) dialog.close();
-  }, [open]);
+  const { dialogRef, closeDialog, handleDialogClose } = useNativeDialog(open, onClose);
 
   return (
-    <dialog ref={dialogRef} className="shortcut-dialog" onClose={onClose} aria-labelledby="shortcut-title">
+    <dialog ref={dialogRef} className="shortcut-dialog" onClose={handleDialogClose} aria-labelledby="shortcut-title">
       <div className="shortcut-dialog-head">
         <h2 id="shortcut-title">{t("shortcuts", language)}</h2>
-        <button type="button" className="control-button" onClick={onClose} aria-label={t("closeDialog", language)}>
+        <button
+          type="button"
+          className="control-button"
+          onClick={closeDialog}
+          aria-label={t("closeDialog", language)}
+          data-dialog-initial-focus
+        >
           <X size={15} aria-hidden="true" />
         </button>
       </div>
diff --git a/LOGISDATA/src/components/ui/LiveTelemetryFeed.tsx b/LOGISDATA/src/components/ui/LiveTelemetryFeed.tsx
index 6da8cba..18a78f7 100644
--- a/LOGISDATA/src/components/ui/LiveTelemetryFeed.tsx
+++ b/LOGISDATA/src/components/ui/LiveTelemetryFeed.tsx
@@ -13,13 +13,25 @@ interface LiveTelemetryFeedProps {
   language: Language;
 }
 
+type TelemetryFilter = "all" | TelemetrySeverity;
+
+const TELEMETRY_FILTERS = [
+  { value: "all", label: "allRecords" },
+  { value: "critical", label: "severityCritical" },
+  { value: "warning", label: "severityWarning" },
+  { value: "reconciled", label: "severityReconciled" },
+  { value: "optimized", label: "severityOptimized" },
+] as const;
+
 export function LiveTelemetryFeed({ open, onClose, language }: LiveTelemetryFeedProps) {
   const [events, setEvents] = useState<TelemetryEvent[]>(SAMPLE_TELEMETRY_EVENTS);
   const [isPaused, setIsPaused] = useState(false);
-  const [filterSeverity, setFilterSeverity] = useState<string>("all");
+  const [filterSeverity, setFilterSeverity] = useState<TelemetryFilter>("all");
 
   useEffect(() => {
-    if (isPaused) return;
+    // The drawer remains mounted so filter state survives closing, but a
+    // hidden simulation must not allocate timers or play notification audio.
+    if (!open || isPaused) return;
 
     const interval = setInterval(() => {
       const randomIdx = Math.floor(Math.random() * SAMPLE_TELEMETRY_EVENTS.length);
@@ -43,7 +55,7 @@ export function LiveTelemetryFeed({ open, onClose, language }: LiveTelemetryFeed
     }, 4500);
 
     return () => clearInterval(interval);
-  }, [isPaused]);
+  }, [open, isPaused]);
 
   if (!open) return null;
 
@@ -64,14 +76,16 @@ export function LiveTelemetryFeed({ open, onClose, language }: LiveTelemetryFeed
   };
 
   return (
-    <div className="telemetry-panel" role="region" aria-labelledby="telemetry-panel-title">
+    <div id="telemetry-panel" className="telemetry-panel" role="region" aria-labelledby="telemetry-panel-title">
       <div className="telemetry-header">
         <div className="telemetry-title-group">
           <Activity size={16} className="telemetry-pulse-icon" aria-hidden="true" />
           <h2 id="telemetry-panel-title" className="telemetry-title">
             {t("telemetryTitle", language)}
           </h2>
-          <span className="telemetry-live-badge">{t("livePulse", language)}</span>
+          <span className="telemetry-live-badge" role="status" aria-live="polite">
+            {t(isPaused ? "simulationPaused" : "livePulse", language)}
+          </span>
         </div>
         <div className="telemetry-controls">
           <button
@@ -94,18 +108,24 @@ export function LiveTelemetryFeed({ open, onClose, language }: LiveTelemetryFeed
         </div>
       </div>
 
-      <div className="telemetry-filters">
-        <span className="filter-label">{t("filter", language)}:</span>
-        {(["all", "critical", "warning", "reconciled", "optimized"] as const).map((sev) => (
-          <button
-            key={sev}
-            type="button"
-            className={`filter-chip ${filterSeverity === sev ? "filter-chip-active" : ""}`}
-            onClick={() => setFilterSeverity(sev)}
-          >
-            {sev.toUpperCase()}
-          </button>
-        ))}
+      <p className="telemetry-disclosure">{t("telemetryDisclosure", language)}</p>
+
+      <div className="telemetry-filters" role="group" aria-label={t("filter", language)}>
+        <span className="filter-label" aria-hidden="true">{t("filter", language)}:</span>
+        {TELEMETRY_FILTERS.map((filter) => {
+          const selected = filterSeverity === filter.value;
+          return (
+            <button
+              key={filter.value}
+              type="button"
+              className={`filter-chip ${selected ? "filter-chip-active" : ""}`}
+              aria-pressed={selected}
+              onClick={() => setFilterSeverity(filter.value)}
+            >
+              {t(filter.label, language)}
+            </button>
+          );
+        })}
       </div>
 
       <div className="telemetry-stream" role="log" aria-live="polite">
diff --git a/LOGISDATA/src/components/ui/NodeInspectorModal.tsx b/LOGISDATA/src/components/ui/NodeInspectorModal.tsx
index ca6d2fa..df8db6b 100644
--- a/LOGISDATA/src/components/ui/NodeInspectorModal.tsx
+++ b/LOGISDATA/src/components/ui/NodeInspectorModal.tsx
@@ -1,9 +1,10 @@
 "use client";
 
-import { useEffect, useId } from "react";
+import { useId } from "react";
 import { AlertTriangle, CheckCircle, Network, Radio, Shield, Truck, X } from "lucide-react";
 import { supplyNodeDetails } from "@/lib/simulation";
 import { integer, number, percent, text, t } from "@/lib/i18n";
+import { useNativeDialog } from "@/lib/useNativeDialog";
 import type { Language } from "@/lib/types";
 
 interface NodeInspectorModalProps {
@@ -14,24 +15,21 @@ interface NodeInspectorModalProps {
 
 export function NodeInspectorModal({ nodeId, onClose, language }: NodeInspectorModalProps) {
   const titleId = useId();
+  const node = nodeId ? supplyNodeDetails[nodeId] : undefined;
+  const { dialogRef, closeDialog, handleDialogClose } = useNativeDialog(Boolean(node), onClose);
 
-  useEffect(() => {
-    const onKey = (e: KeyboardEvent) => {
-      if (e.key === "Escape") onClose();
-    };
-    window.addEventListener("keydown", onKey);
-    return () => window.removeEventListener("keydown", onKey);
-  }, [onClose]);
-
-  if (!nodeId) return null;
-  const node = supplyNodeDetails[nodeId];
   if (!node) return null;
 
   const isLeak = node.status === "leak";
   const isPhantom = node.status === "phantom";
 
   return (
-    <div className="inspector-overlay" role="dialog" aria-modal="true" aria-labelledby={titleId}>
+    <dialog
+      ref={dialogRef}
+      className="inspector-overlay"
+      onClose={handleDialogClose}
+      aria-labelledby={titleId}
+    >
       <div className="inspector-modal">
         <div className="inspector-head">
           <div className="inspector-title-group">
@@ -44,8 +42,9 @@ export function NodeInspectorModal({ nodeId, onClose, language }: NodeInspectorM
           <button
             type="button"
             className="control-button"
-            onClick={onClose}
+            onClick={closeDialog}
             aria-label={t("closeDialog", language)}
+            data-dialog-initial-focus
           >
             <X size={15} aria-hidden="true" />
           </button>
@@ -98,6 +97,6 @@ export function NodeInspectorModal({ nodeId, onClose, language }: NodeInspectorM
           </div>
         </div>
       </div>
-    </div>
+    </dialog>
   );
 }
diff --git a/LOGISDATA/src/components/ui/RecoveryCalculator.tsx b/LOGISDATA/src/components/ui/RecoveryCalculator.tsx
index 71e3c02..94b59e9 100644
--- a/LOGISDATA/src/components/ui/RecoveryCalculator.tsx
+++ b/LOGISDATA/src/components/ui/RecoveryCalculator.tsx
@@ -5,6 +5,7 @@ import { Calculator, DollarSign, Sparkles, TrendingUp, X } from "lucide-react";
 import { calculateRecovery, DEFAULT_RECOVERY_PARAMS } from "@/lib/simulation";
 import { currency, integer, number, t } from "@/lib/i18n";
 import { sound } from "@/lib/sound";
+import { useNativeDialog } from "@/lib/useNativeDialog";
 import type { Language, RecoveryParameters } from "@/lib/types";
 
 interface RecoveryCalculatorProps {
@@ -16,6 +17,7 @@ interface RecoveryCalculatorProps {
 export function RecoveryCalculator({ open, onClose, language }: RecoveryCalculatorProps) {
   const [params, setParams] = useState<RecoveryParameters>(DEFAULT_RECOVERY_PARAMS);
   const titleId = useId();
+  const { dialogRef, closeDialog, handleDialogClose } = useNativeDialog(open, onClose);
 
   const results = useMemo(() => calculateRecovery(params), [params]);
 
@@ -27,7 +29,12 @@ export function RecoveryCalculator({ open, onClose, language }: RecoveryCalculat
   if (!open) return null;
 
   return (
-    <div className="calculator-overlay" role="dialog" aria-modal="true" aria-labelledby={titleId}>
+    <dialog
+      ref={dialogRef}
+      className="calculator-overlay"
+      onClose={handleDialogClose}
+      aria-labelledby={titleId}
+    >
       <div className="calculator-modal">
         <div className="calculator-head">
           <div className="calculator-title-group">
@@ -37,14 +44,16 @@ export function RecoveryCalculator({ open, onClose, language }: RecoveryCalculat
           <button
             type="button"
             className="control-button"
-            onClick={onClose}
+            onClick={closeDialog}
             aria-label={t("closeDialog", language)}
+            data-dialog-initial-focus
           >
             <X size={15} aria-hidden="true" />
           </button>
         </div>
 
         <div className="calculator-body">
+          <p className="calculator-disclosure">{t("calculatorDisclosure", language)}</p>
           <div className="calculator-inputs">
             <div className="input-group">
               <div className="input-header">
@@ -140,6 +149,6 @@ export function RecoveryCalculator({ open, onClose, language }: RecoveryCalculat
           </div>
         </div>
       </div>
-    </div>
+    </dialog>
   );
 }
diff --git a/LOGISDATA/src/components/ui/ScenarioSwitcher.tsx b/LOGISDATA/src/components/ui/ScenarioSwitcher.tsx
index ecd8ad2..5dee3de 100644
--- a/LOGISDATA/src/components/ui/ScenarioSwitcher.tsx
+++ b/LOGISDATA/src/components/ui/ScenarioSwitcher.tsx
@@ -1,6 +1,6 @@
 "use client";
 
-import { useId } from "react";
+import { useId, type KeyboardEvent } from "react";
 import { sound } from "@/lib/sound";
 import { t } from "@/lib/i18n";
 import type { AuditScenario, Language } from "@/lib/types";
@@ -11,6 +11,12 @@ interface ScenarioSwitcherProps {
   language: Language;
 }
 
+const SCENARIOS = [
+  { value: "baseline", label: "scenarioBaseline", activeClass: "scenario-active-baseline" },
+  { value: "active-audit", label: "scenarioActive", activeClass: "scenario-active-audit" },
+  { value: "mitigated", label: "scenarioMitigated", activeClass: "scenario-active-mitigated" },
+] as const;
+
 export function ScenarioSwitcher({ scenario, onScenarioChange, language }: ScenarioSwitcherProps) {
   const groupId = useId();
 
@@ -21,6 +27,27 @@ export function ScenarioSwitcher({ scenario, onScenarioChange, language }: Scena
     }
   };
 
+  const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>, currentIndex: number) => {
+    let nextIndex: number | null = null;
+    if (event.key === "ArrowRight" || event.key === "ArrowDown") {
+      nextIndex = (currentIndex + 1) % SCENARIOS.length;
+    } else if (event.key === "ArrowLeft" || event.key === "ArrowUp") {
+      nextIndex = (currentIndex - 1 + SCENARIOS.length) % SCENARIOS.length;
+    } else if (event.key === "Home") {
+      nextIndex = 0;
+    } else if (event.key === "End") {
+      nextIndex = SCENARIOS.length - 1;
+    }
+
+    if (nextIndex === null) return;
+    event.preventDefault();
+    const next = SCENARIOS[nextIndex];
+    handleSelect(next.value);
+    event.currentTarget.parentElement
+      ?.querySelector<HTMLButtonElement>(`[data-scenario="${next.value}"]`)
+      ?.focus();
+  };
+
   return (
     <div className="scenario-switcher" role="radiogroup" aria-labelledby={`${groupId}-label`}>
       <span id={`${groupId}-label`} className="scenario-label">
@@ -28,33 +55,24 @@ export function ScenarioSwitcher({ scenario, onScenarioChange, language }: Scena
         {t("scenarioLabel", language)}:
       </span>
       <div className="scenario-buttons">
-        <button
-          type="button"
-          role="radio"
-          aria-checked={scenario === "baseline"}
-          className={`scenario-btn ${scenario === "baseline" ? "scenario-active-baseline" : ""}`}
-          onClick={() => handleSelect("baseline")}
-        >
-          {t("scenarioBaseline", language)}
-        </button>
-        <button
-          type="button"
-          role="radio"
-          aria-checked={scenario === "active-audit"}
-          className={`scenario-btn ${scenario === "active-audit" ? "scenario-active-audit" : ""}`}
-          onClick={() => handleSelect("active-audit")}
-        >
-          {t("scenarioActive", language)}
-        </button>
-        <button
-          type="button"
-          role="radio"
-          aria-checked={scenario === "mitigated"}
-          className={`scenario-btn ${scenario === "mitigated" ? "scenario-active-mitigated" : ""}`}
-          onClick={() => handleSelect("mitigated")}
-        >
-          {t("scenarioMitigated", language)}
-        </button>
+        {SCENARIOS.map((option, index) => {
+          const selected = scenario === option.value;
+          return (
+            <button
+              key={option.value}
+              type="button"
+              role="radio"
+              aria-checked={selected}
+              tabIndex={selected ? 0 : -1}
+              data-scenario={option.value}
+              className={`scenario-btn ${selected ? option.activeClass : ""}`}
+              onClick={() => handleSelect(option.value)}
+              onKeyDown={(event) => handleKeyDown(event, index)}
+            >
+              {t(option.label, language)}
+            </button>
+          );
+        })}
       </div>
     </div>
   );
diff --git a/LOGISDATA/src/lib/export.ts b/LOGISDATA/src/lib/export.ts
index b1d647d..e79c7a0 100644
--- a/LOGISDATA/src/lib/export.ts
+++ b/LOGISDATA/src/lib/export.ts
@@ -1,18 +1,18 @@
+import { presentationCopy, warehouseSpecs } from "./data";
+import { selectors } from "./metrics";
 import {
-  auditMetrics,
-  demandTiers,
-  freightAuditRows,
-  presentationCopy,
-  routeRegions,
-  warehouseSpecs,
-} from "./data";
-import { auditSummary, demandSummary, routeSummary, warehouseSummary } from "./metrics";
-import type { Language } from "./types";
+  getScenarioDemandTiers,
+  getScenarioFreightRows,
+  getScenarioMetrics,
+  getScenarioRouteRegions,
+  getScenarioWarehouseBins,
+} from "./simulation";
+import type { AuditScenario, Language } from "./types";
 
 /**
  * Dataset export. An executive audit deck whose numbers cannot leave the
  * screen forces the audience to re-key figures by hand; every table in the
- * presentation is now exportable as RFC 4180 CSV, JSON, or Executive Markdown.
+ * presentation is now exportable as RFC 4180 CSV or executive JSON.
  */
 
 export type DatasetId = "freight-audit" | "demand-signal" | "route-intelligence" | "warehouse-control";
@@ -34,12 +34,16 @@ export function toCsv(rows: ReadonlyArray<ReadonlyArray<string | number>>): stri
   return rows.map((row) => row.map(csvField).join(",")).join("\r\n");
 }
 
-export function buildDataset(dataset: DatasetId, language: Language): Array<Array<string | number>> {
+export function buildDataset(
+  dataset: DatasetId,
+  language: Language,
+  scenario: AuditScenario = "active-audit",
+): Array<Array<string | number>> {
   switch (dataset) {
     case "freight-audit":
       return [
         ["id", "freight_type", "billed_km", "actual_km", "variance_km", "duplicate_billing_pct", "overcharge_pct", "verdict"],
-        ...freightAuditRows.map((row) => [
+        ...getScenarioFreightRows(scenario).map((row) => [
           row.id,
           row.freightType[language],
           row.billedMileage,
@@ -50,22 +54,24 @@ export function buildDataset(dataset: DatasetId, language: Language): Array<Arra
           row.verdict,
         ]),
       ];
-    case "demand-signal":
+    case "demand-signal": {
+      const tiers = getScenarioDemandTiers(scenario);
       return [
         ["id", "tier", "consumer_demand", "unaudited_signal", "audited_signal", "amplification_x"],
-        ...demandTiers.map((tier) => [
+        ...tiers.map((tier) => [
           tier.id,
           tier.label[language],
           tier.actual,
           tier.distorted,
           tier.audited,
-          Math.round((tier.distorted / (demandTiers[0].actual || 1)) * 100) / 100,
+          Math.round((tier.distorted / (tiers[0]?.actual || 1)) * 100) / 100,
         ]),
       ];
+    }
     case "route-intelligence":
       return [
         ["id", "region", "mileage_waste_pct", "fuel_loss_pct", "gps_deviation_pct", "optimized_savings_usd"],
-        ...routeRegions.map((region) => [
+        ...getScenarioRouteRegions(scenario).map((region) => [
           region.id,
           region.region[language],
           region.mileageWastePct,
@@ -92,26 +98,40 @@ export function buildDataset(dataset: DatasetId, language: Language): Array<Arra
   }
 }
 
-export function datasetToCsv(dataset: DatasetId, language: Language): string {
-  return toCsv(buildDataset(dataset, language));
+export function datasetToCsv(
+  dataset: DatasetId,
+  language: Language,
+  scenario: AuditScenario = "active-audit",
+): string {
+  return toCsv(buildDataset(dataset, language, scenario));
 }
 
-export function datasetFileName(dataset: DatasetId, language: Language, now: Date = new Date()): string {
-  return `logisdata-${dataset}-${language}-${now.toISOString().slice(0, 10)}.csv`;
+export function datasetFileName(
+  dataset: DatasetId,
+  language: Language,
+  now: Date = new Date(),
+  scenario: AuditScenario = "active-audit",
+): string {
+  const scenarioSuffix = scenario === "active-audit" ? "" : `-${scenario}`;
+  return `logisdata-${dataset}${scenarioSuffix}-${language}-${now.toISOString().slice(0, 10)}.csv`;
 }
 
 /**
  * Triggers a client-side download. Returns false when the environment
  * cannot download (SSR, locked-down browser) so callers can fall back.
  */
-export function downloadDataset(dataset: DatasetId, language: Language): boolean {
+export function downloadDataset(
+  dataset: DatasetId,
+  language: Language,
+  scenario: AuditScenario = "active-audit",
+): boolean {
   if (typeof document === "undefined" || typeof URL.createObjectURL !== "function") return false;
   // The BOM keeps Excel from mangling Arabic labels.
-  const blob = new Blob(["\uFEFF", datasetToCsv(dataset, language)], { type: "text/csv;charset=utf-8" });
+  const blob = new Blob(["\uFEFF", datasetToCsv(dataset, language, scenario)], { type: "text/csv;charset=utf-8" });
   const url = URL.createObjectURL(blob);
   const anchor = document.createElement("a");
   anchor.href = url;
-  anchor.download = datasetFileName(dataset, language);
+  anchor.download = datasetFileName(dataset, language, new Date(), scenario);
   anchor.rel = "noopener";
   document.body.append(anchor);
   anchor.click();
@@ -120,60 +140,83 @@ export function downloadDataset(dataset: DatasetId, language: Language): boolean
   return true;
 }
 
-/**
- * Exports complete executive audit package as JSON
- */
-export function downloadExecutiveReportJson(language: Language): boolean {
-  if (typeof document === "undefined" || typeof URL.createObjectURL !== "function") return false;
-  const data = {
+/** Builds the complete, scenario-consistent executive audit package. */
+export function buildExecutiveReport(
+  language: Language,
+  scenario: AuditScenario = "active-audit",
+  exportedAt: Date = new Date(),
+) {
+  const metrics = getScenarioMetrics(scenario);
+  const freightRows = getScenarioFreightRows(scenario);
+  const tiers = getScenarioDemandTiers(scenario);
+  const regions = getScenarioRouteRegions(scenario);
+  const bins = getScenarioWarehouseBins(scenario);
+
+  return {
     metadata: {
       project: "LOGISDATA Control Room",
       organization: "AAST Executive Data Lab",
       presenter: presentationCopy.hero.presenter,
       registration: presentationCopy.hero.registration,
-      exportedAt: new Date().toISOString(),
+      exportedAt: exportedAt.toISOString(),
       language,
+      scenario,
+      classification: "illustrative-simulation" as const,
+      disclosure: presentationCopy.footer.illustrative[language],
     },
     executiveSummary: {
-      metrics: auditMetrics.map((m) => ({
-        id: m.id,
-        label: m.label[language],
-        formattedValue: `${m.prefix}${m.value}${m.suffix}`,
-        note: m.note[language],
+      metrics: metrics.map((metric) => ({
+        id: metric.id,
+        label: metric.label[language],
+        formattedValue: `${metric.prefix}${metric.value}${metric.suffix}`,
+        note: metric.note[language],
       })),
-      auditSummary,
-      demandSummary,
-      routeSummary,
-      warehouseSummary,
+      auditSummary: selectors.summariseAudit(freightRows),
+      demandSummary: selectors.summariseDemand(tiers),
+      routeSummary: selectors.summariseRoutes(regions),
+      warehouseSummary: selectors.summariseWarehouse(bins),
     },
     theatres: {
-      freightAudit: freightAuditRows.map((r) => ({
-        ...r,
-        freightType: r.freightType[language],
+      freightAudit: freightRows.map((row) => ({
+        ...row,
+        freightType: row.freightType[language],
+      })),
+      demandTiers: tiers.map((tier) => ({
+        ...tier,
+        label: tier.label[language],
       })),
-      demandTiers: demandTiers.map((t) => ({
-        ...t,
-        label: t.label[language],
+      routeRegions: regions.map((region) => ({
+        ...region,
+        region: region.region[language],
       })),
-      routeRegions: routeRegions.map((r) => ({
-        ...r,
-        region: r.region[language],
+      warehouseBins: bins.map((bin) => ({
+        ...bin,
+        sku: bin.sku[language],
       })),
-      warehouseSpecs: warehouseSpecs.map((s) => ({
-        ...s,
-        title: s.title[language],
-        impact: s.impact[language],
-        cause: s.cause[language],
-        fix: s.fix[language],
+      warehouseSpecs: warehouseSpecs.map((spec) => ({
+        ...spec,
+        title: spec.title[language],
+        impact: spec.impact[language],
+        cause: spec.cause[language],
+        fix: spec.fix[language],
       })),
     },
   };
+}
 
+/** Exports the complete executive audit package as JSON. */
+export function downloadExecutiveReportJson(
+  language: Language,
+  scenario: AuditScenario = "active-audit",
+): boolean {
+  if (typeof document === "undefined" || typeof URL.createObjectURL !== "function") return false;
+  const data = buildExecutiveReport(language, scenario);
   const blob = new Blob([JSON.stringify(data, null, 2)], { type: "application/json" });
   const url = URL.createObjectURL(blob);
   const anchor = document.createElement("a");
+  const scenarioSuffix = scenario === "active-audit" ? "" : `-${scenario}`;
   anchor.href = url;
-  anchor.download = `logisdata-executive-audit-${language}-${new Date().toISOString().slice(0, 10)}.json`;
+  anchor.download = `logisdata-executive-audit${scenarioSuffix}-${language}-${new Date().toISOString().slice(0, 10)}.json`;
   anchor.rel = "noopener";
   document.body.append(anchor);
   anchor.click();
diff --git a/LOGISDATA/src/lib/i18n.ts b/LOGISDATA/src/lib/i18n.ts
index 6861e2c..50f9443 100644
--- a/LOGISDATA/src/lib/i18n.ts
+++ b/LOGISDATA/src/lib/i18n.ts
@@ -134,6 +134,8 @@ export const ui = {
   qualityHigh: { en: "High", ar: "عالية" },
   qualityMedium: { en: "Balanced", ar: "متوازنة" },
   qualityLow: { en: "Calm", ar: "هادئة" },
+  themeLight: { en: "LIGHT", ar: "فاتح" },
+  themeDark: { en: "DARK", ar: "داكن" },
 
   // Scenario engine strings
   scenarioLabel: { en: "Audit Mode", ar: "نمط التدقيق" },
@@ -141,16 +143,29 @@ export const ui = {
   scenarioActive: { en: "02 Active Audit Gate", ar: "٠٢ بوابة تدقيق نشطة" },
   scenarioMitigated: { en: "03 Closed-Loop Optim", ar: "٠٣ حلقة تحسين كاملة" },
 
-  // Live Telemetry
-  telemetryTitle: { en: "Live Audit Telemetry Stream", ar: "تدفق تليماتكس التدقيق اللحظي" },
-  telemetryToggle: { en: "Live Telemetry", ar: "التليماتكس المباشر" },
+  // Telemetry simulation
+  telemetryTitle: { en: "Audit Telemetry Simulation", ar: "محاكاة تليماتكس التدقيق" },
+  telemetryToggle: { en: "Telemetry Simulation", ar: "محاكاة التليماتكس" },
   telemetryPause: { en: "Pause", ar: "إيقاف مؤقت" },
   telemetryResume: { en: "Resume", ar: "استئناف" },
-  livePulse: { en: "STREAM ACTIVE", ar: "البث نشط" },
+  livePulse: { en: "SIMULATION RUNNING", ar: "المحاكاة قيد التشغيل" },
+  simulationPaused: { en: "SIMULATION PAUSED", ar: "المحاكاة متوقفة مؤقتًا" },
+  severityCritical: { en: "Critical", ar: "حرج" },
+  severityWarning: { en: "Warning", ar: "تحذير" },
+  severityReconciled: { en: "Reconciled", ar: "تمت المطابقة" },
+  severityOptimized: { en: "Optimized", ar: "محسّن" },
+  telemetryDisclosure: {
+    en: "Illustrative replay generated from local fixtures — not connected to operational systems.",
+    ar: "إعادة تشغيل توضيحية مولّدة من بيانات محلية افتراضية — غير متصلة بالأنظمة التشغيلية.",
+  },
 
   // Recovery Calculator
   calculatorTitle: { en: "Executive Margin Recovery Calculator", ar: "حاسبة استرداد الهامش التنفيذية" },
   calculatorOpen: { en: "ROI Calculator", ar: "حاسبة العائد" },
+  calculatorDisclosure: {
+    en: "Illustrative estimate, not a forecast. Fixed assumptions: 3.8% billing recovery, 4.2% route recovery, scaled inventory effects, and a $280k system cost. Validate with audited inputs before investment decisions.",
+    ar: "تقدير توضيحي وليس توقعًا. الافتراضات الثابتة: استرداد ٣٫٨٪ من الفوترة و٤٫٢٪ من المسارات، وتأثيرات مخزون متدرجة، وتكلفة نظام قدرها ٢٨٠ ألف دولار. تحقّق من المدخلات المدققة قبل قرارات الاستثمار.",
+  },
   annualFreightSpend: { en: "Annual Freight Spend", ar: "الإنفاق السنوي على الشحن" },
   annualOrderUnits: { en: "Annual Order Volume", ar: "حجم الطلبات السنوي" },
   skuCatalogSize: { en: "Catalog SKU Count", ar: "عدد أصناف الكتالوج" },
@@ -167,10 +182,15 @@ export const ui = {
   // Sound FX
   soundOn: { en: "AUDIO: ON", ar: "الصوت: مفعّل" },
   soundOff: { en: "AUDIO: MUTED", ar: "الصوت: صامت" },
+  soundShortOn: { en: "SFX", ar: "صوت" },
+  soundShortOff: { en: "MUTE", ar: "صامت" },
 
   // Node Inspector & Table Filters
   nodeInspection: { en: "Node Telemetry", ar: "تليماتكس العقدة" },
+  nodeSelector: { en: "Supply chain node selector", ar: "محدد عقد سلسلة الإمداد" },
+  inspectNode: { en: "Inspect", ar: "فحص" },
   allRecords: { en: "All", ar: "الكل" },
+  noRecords: { en: "No records match the current filters.", ar: "لا توجد سجلات تطابق عوامل التصفية الحالية." },
   search: { en: "Search...", ar: "بحث..." },
   filter: { en: "Filter", ar: "تصفية" },
   status: { en: "Status", ar: "الحالة" },
diff --git a/LOGISDATA/src/lib/keyboard.ts b/LOGISDATA/src/lib/keyboard.ts
new file mode 100644
index 0000000..caf4e8b
--- /dev/null
+++ b/LOGISDATA/src/lib/keyboard.ts
@@ -0,0 +1,41 @@
+const INTERACTIVE_SELECTOR = [
+  "a[href]",
+  "button",
+  "input:not([type='hidden'])",
+  "select",
+  "textarea",
+  "[contenteditable='true']",
+  "[role='button']",
+  "[role='checkbox']",
+  "[role='radio']",
+  "[role='slider']",
+  "[role='switch']",
+  "[role='tab']",
+].join(", ");
+
+interface ShortcutEventState {
+  defaultPrevented: boolean;
+  altKey: boolean;
+  ctrlKey: boolean;
+  metaKey: boolean;
+  isComposing: boolean;
+}
+
+/**
+ * Global presentation shortcuts must never steal keyboard input from a
+ * focused control, an IME composition, or a modal dialog. In particular,
+ * Space belongs to a focused button before it belongs to section navigation.
+ */
+export function shouldIgnorePresentationShortcut(
+  event: ShortcutEventState,
+  activeElement: Element | null,
+  modalOpen: boolean,
+): boolean {
+  return event.defaultPrevented
+    || event.altKey
+    || event.ctrlKey
+    || event.metaKey
+    || event.isComposing
+    || modalOpen
+    || Boolean(activeElement?.closest(INTERACTIVE_SELECTOR));
+}
diff --git a/LOGISDATA/src/lib/metrics.ts b/LOGISDATA/src/lib/metrics.ts
index 5b930ad..d59c96d 100644
--- a/LOGISDATA/src/lib/metrics.ts
+++ b/LOGISDATA/src/lib/metrics.ts
@@ -1,5 +1,5 @@
 import { demandTiers, freightAuditRows, routeRegions, warehouseBins } from "./data";
-import type { DemandTier, FreightAuditRow, RouteRegion } from "./types";
+import type { DemandTier, FreightAuditRow, RouteRegion, WarehouseBin } from "./types";
 
 /**
  * Derived, memoisable analytics selectors.
@@ -94,13 +94,13 @@ export interface WarehouseSummary {
   accuracy: number;
 }
 
-function summariseWarehouse(): WarehouseSummary {
-  const mismatches = warehouseBins.filter((bin) => bin.status === "mismatch").length;
+function summariseWarehouse(bins: readonly WarehouseBin[] = warehouseBins): WarehouseSummary {
+  const mismatches = bins.filter((bin) => bin.status === "mismatch").length;
   return {
-    total: warehouseBins.length,
+    total: bins.length,
     mismatches,
-    audited: warehouseBins.length - mismatches,
-    accuracy: warehouseBins.length === 0 ? 1 : round((warehouseBins.length - mismatches) / warehouseBins.length, 4),
+    audited: bins.length - mismatches,
+    accuracy: bins.length === 0 ? 1 : round((bins.length - mismatches) / bins.length, 4),
   };
 }
 
diff --git a/LOGISDATA/src/lib/sound.ts b/LOGISDATA/src/lib/sound.ts
index 8843b92..31058a7 100644
--- a/LOGISDATA/src/lib/sound.ts
+++ b/LOGISDATA/src/lib/sound.ts
@@ -115,6 +115,8 @@ class SoundSynthesizer {
   }
 
   public playSuccess(): void {
+    // Avoid allocating follow-up timers for muted telemetry events.
+    if (!this.enabled) return;
     this.playTone(523.25, 0.08, "sine", 0.04);
     setTimeout(() => this.playTone(659.25, 0.08, "sine", 0.04), 60);
     setTimeout(() => this.playTone(1046.5, 0.14, "sine", 0.05), 120);
diff --git a/LOGISDATA/src/lib/useNativeDialog.ts b/LOGISDATA/src/lib/useNativeDialog.ts
new file mode 100644
index 0000000..fe3de1b
--- /dev/null
+++ b/LOGISDATA/src/lib/useNativeDialog.ts
@@ -0,0 +1,48 @@
+"use client";
+
+import { useCallback, useEffect, useRef } from "react";
+
+/**
+ * Coordinates controlled React state with the platform's modal dialog.
+ * The browser supplies modality, Escape handling, and focus containment;
+ * this hook adds deterministic initial focus and restores the invoker.
+ */
+export function useNativeDialog(open: boolean, onClose: () => void) {
+  const dialogRef = useRef<HTMLDialogElement>(null);
+  const onCloseRef = useRef(onClose);
+
+  useEffect(() => {
+    onCloseRef.current = onClose;
+  }, [onClose]);
+
+  useEffect(() => {
+    const dialog = dialogRef.current;
+    if (!dialog) return;
+
+    if (!open) {
+      if (dialog.open) dialog.close();
+      return;
+    }
+
+    const invoker = document.activeElement instanceof HTMLElement
+      ? document.activeElement
+      : null;
+
+    if (!dialog.open) dialog.showModal();
+    dialog.querySelector<HTMLElement>("[data-dialog-initial-focus]")?.focus();
+
+    return () => {
+      if (invoker?.isConnected) invoker.focus();
+    };
+  }, [open]);
+
+  const closeDialog = useCallback(() => {
+    dialogRef.current?.close();
+  }, []);
+
+  const handleDialogClose = useCallback(() => {
+    onCloseRef.current();
+  }, []);
+
+  return { dialogRef, closeDialog, handleDialogClose };
+}
diff --git a/LOGISDATA/tests/e2e/navigation.spec.ts b/LOGISDATA/tests/e2e/navigation.spec.ts
index 9cb2510..c172d61 100644
--- a/LOGISDATA/tests/e2e/navigation.spec.ts
+++ b/LOGISDATA/tests/e2e/navigation.spec.ts
@@ -92,8 +92,29 @@ test.describe("preferences", () => {
   });
 });
 
-test.describe("keyboard help", () => {
-  test("opens with ? and closes with Escape", async ({ page }) => {
+test.describe("keyboard boundaries", () => {
+  test("focused controls and modal dialogs are protected from global navigation shortcuts", async ({ page }) => {
+    await enterControlRoom(page);
+    const html = page.locator("html");
+    const progress = page.getByRole("progressbar");
+    const theme = page.getByRole("button", { name: "Theme" });
+    const before = await html.getAttribute("data-theme");
+
+    await theme.focus();
+    await page.keyboard.press("Space");
+    await expect(html).toHaveAttribute("data-theme", before === "dark" ? "light" : "dark");
+    await expect(progress).toHaveAttribute("aria-valuenow", "1");
+
+    await page.getByRole("button", { name: "ROI Calculator" }).click();
+    const calculator = page.getByRole("dialog", { name: /Executive Margin Recovery Calculator/i });
+    await expect(calculator).toBeVisible();
+    await page.keyboard.press("End");
+    await expect(progress).toHaveAttribute("aria-valuenow", "1");
+    await page.keyboard.press("Escape");
+    await expect(calculator).toBeHidden();
+  });
+
+  test("keyboard help opens with ? and closes with Escape", async ({ page }) => {
     await enterControlRoom(page);
     await page.keyboard.press("?");
     const dialog = page.getByRole("dialog");
diff --git a/LOGISDATA/tests/setup.ts b/LOGISDATA/tests/setup.ts
index dd3452a..93b8999 100644
--- a/LOGISDATA/tests/setup.ts
+++ b/LOGISDATA/tests/setup.ts
@@ -7,7 +7,14 @@ afterEach(() => {
   window.localStorage.clear();
 });
 
-// jsdom implements neither of these; several components feature-detect them.
+// jsdom implements none of these browser capabilities. Provide quiet,
+// deterministic feature probes; individual tests can still spy on them.
+Object.defineProperty(HTMLCanvasElement.prototype, "getContext", {
+  configurable: true,
+  writable: true,
+  value: vi.fn(() => null),
+});
+
 if (!("matchMedia" in window)) {
   Object.defineProperty(window, "matchMedia", {
     writable: true,
diff --git a/LOGISDATA/tests/unit/components.test.tsx b/LOGISDATA/tests/unit/components.test.tsx
index d92e601..032a9d0 100644
--- a/LOGISDATA/tests/unit/components.test.tsx
+++ b/LOGISDATA/tests/unit/components.test.tsx
@@ -11,12 +11,21 @@ import { resetPreferenceStore } from "@/lib/preferenceStore";
 import { auditMetrics } from "@/lib/data";
 
 vi.mock("next/image", () => ({
-  default: ({ alt, ...props }: { alt: string }) => <img alt={alt} {...props} />,
+  default: ({ alt, priority: _priority, ...props }: { alt: string; priority?: boolean }) => (
+    <img alt={alt} {...props} />
+  ),
 }));
 vi.mock("next/link", () => ({
-  default: ({ href, children, ...props }: { href: string; children: React.ReactNode }) => (
-    <a href={href} {...props}>{children}</a>
-  ),
+  default: ({
+    href,
+    children,
+    prefetch: _prefetch,
+    ...props
+  }: {
+    href: string;
+    children: React.ReactNode;
+    prefetch?: boolean;
+  }) => <a href={href} {...props}>{children}</a>,
 }));
 
 beforeEach(() => {
diff --git a/LOGISDATA/tests/unit/db.test.ts b/LOGISDATA/tests/unit/db.test.ts
index 8baee66..dc2befe 100644
--- a/LOGISDATA/tests/unit/db.test.ts
+++ b/LOGISDATA/tests/unit/db.test.ts
@@ -1,9 +1,10 @@
 import { afterEach, describe, expect, it } from "vitest";
-import { isDatabaseConfigured, resolvePoolSettings } from "@/db";
+import { closeDb, getDb, getPool, isDatabaseConfigured, resolvePoolSettings } from "@/db";
 
 const ORIGINAL = { ...process.env };
 
-afterEach(() => {
+afterEach(async () => {
+  await closeDb();
   process.env = { ...ORIGINAL };
 });
 
@@ -34,6 +35,22 @@ describe("resolvePoolSettings", () => {
   });
 });
 
+describe("database lifecycle", () => {
+  it("reuses one lazy pool and Drizzle instance, then closes cleanly", async () => {
+    process.env.DATABASE_URL = "postgres://localhost:5432/logisdata_test";
+    process.env.DATABASE_POOL_MAX = "3";
+
+    const pool = getPool();
+    expect(getPool()).toBe(pool);
+    const db = getDb();
+    expect(getDb()).toBe(db);
+    expect(pool.options.max).toBe(3);
+
+    await closeDb();
+    expect(getPool()).not.toBe(pool);
+  });
+});
+
 describe("isDatabaseConfigured", () => {
   it("is a cheap, non-connecting check", () => {
     expect(isDatabaseConfigured({})).toBe(false);
diff --git a/LOGISDATA/tests/unit/export.test.ts b/LOGISDATA/tests/unit/export.test.ts
index 9c7ea84..a1dfab3 100644
--- a/LOGISDATA/tests/unit/export.test.ts
+++ b/LOGISDATA/tests/unit/export.test.ts
@@ -2,10 +2,12 @@ import { describe, expect, it, vi } from "vitest";
 import {
   DATASET_IDS,
   buildDataset,
+  buildExecutiveReport,
   csvField,
   datasetFileName,
   datasetToCsv,
   downloadDataset,
+  downloadExecutiveReportJson,
   toCsv,
 } from "@/lib/export";
 import { freightAuditRows } from "@/lib/data";
@@ -44,6 +46,19 @@ describe("buildDataset", () => {
     expect(arabic[1][1]).toBe(freightAuditRows[0].freightType.ar);
   });
 
+  it("exports the selected scenario rather than the static active-audit rows", () => {
+    const baselineFreight = buildDataset("freight-audit", "en", "baseline");
+    const mitigatedFreight = buildDataset("freight-audit", "en", "mitigated");
+    expect(baselineFreight[1][2]).toBeGreaterThan(freightAuditRows[0].billedMileage);
+    expect(mitigatedFreight[1][2]).toBe(freightAuditRows[0].actualMileage);
+    expect(mitigatedFreight[1][7]).toBe("passed");
+
+    const baselineDemand = buildDataset("demand-signal", "en", "baseline");
+    const mitigatedRoutes = buildDataset("route-intelligence", "en", "mitigated");
+    expect(baselineDemand.at(-1)?.[3]).toBeGreaterThan(baselineDemand.at(-1)?.[2] as number);
+    expect(mitigatedRoutes[1][5]).toBeGreaterThan(freightAuditRows[0].actualMileage);
+  });
+
   it("throws on an unknown dataset", () => {
     // @ts-expect-error -- deliberately invalid input
     expect(() => buildDataset("nope", "en")).toThrow(/Unknown dataset/);
@@ -59,9 +74,36 @@ describe("datasetToCsv", () => {
 });
 
 describe("datasetFileName", () => {
-  it("is deterministic and dated", () => {
-    expect(datasetFileName("route-intelligence", "ar", new Date("2026-02-06T10:00:00Z")))
+  it("is deterministic, dated, and labels non-default scenarios", () => {
+    const date = new Date("2026-02-06T10:00:00Z");
+    expect(datasetFileName("route-intelligence", "ar", date))
       .toBe("logisdata-route-intelligence-ar-2026-02-06.csv");
+    expect(datasetFileName("route-intelligence", "en", date, "mitigated"))
+      .toBe("logisdata-route-intelligence-mitigated-en-2026-02-06.csv");
+  });
+});
+
+describe("executive report", () => {
+  it("keeps summaries, rows, metadata, and disclosure on the selected scenario", () => {
+    const report = buildExecutiveReport("ar", "mitigated", new Date("2026-02-06T10:00:00Z"));
+
+    expect(report.metadata).toMatchObject({
+      exportedAt: "2026-02-06T10:00:00.000Z",
+      language: "ar",
+      scenario: "mitigated",
+      classification: "illustrative-simulation",
+    });
+    expect(report.metadata.disclosure).toMatch(/[\u0600-\u06FF]/);
+    expect(report.theatres.freightAudit.every((row) => row.verdict === "passed")).toBe(true);
+    expect(report.theatres.warehouseBins.every((bin) => bin.status === "audited")).toBe(true);
+    expect(report.executiveSummary.auditSummary.flagged).toBe(0);
+    expect(report.executiveSummary.warehouseSummary.accuracy).toBe(1);
+  });
+
+  it("returns false when an executive report cannot create an object URL", () => {
+    vi.stubGlobal("URL", { ...URL, createObjectURL: undefined });
+    expect(downloadExecutiveReportJson("en", "baseline")).toBe(false);
+    vi.unstubAllGlobals();
   });
 });
 
diff --git a/LOGISDATA/tests/unit/health.test.ts b/LOGISDATA/tests/unit/health.test.ts
new file mode 100644
index 0000000..e456dcc
--- /dev/null
+++ b/LOGISDATA/tests/unit/health.test.ts
@@ -0,0 +1,43 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import packageMetadata from "../../package.json";
+import { GET, HEAD } from "@/app/api/health/route";
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+});
+
+describe("health route", () => {
+  it("reports package metadata when no deployment version is configured", async () => {
+    vi.stubEnv("DATABASE_URL", "");
+    vi.stubEnv("NEXT_PUBLIC_APP_VERSION", "");
+
+    const response = await GET();
+    const body = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(response.headers.get("cache-control")).toBe("no-store, max-age=0");
+    expect(body).toMatchObject({
+      ok: true,
+      service: "logisdata-control-room",
+      version: packageMetadata.version,
+      database: "not-configured",
+    });
+    expect(Number.isFinite(body.uptimeSeconds)).toBe(true);
+    expect(Number.isNaN(Date.parse(body.timestamp))).toBe(false);
+  });
+
+  it("allows an immutable deployment version override", async () => {
+    vi.stubEnv("DATABASE_URL", "");
+    vi.stubEnv("NEXT_PUBLIC_APP_VERSION", "3.1.0+build.42");
+
+    const response = await GET();
+    expect((await response.json()).version).toBe("3.1.0+build.42");
+  });
+
+  it("provides a body-free liveness probe without touching the database", async () => {
+    const response = HEAD();
+    expect(response.status).toBe(204);
+    expect(await response.text()).toBe("");
+    expect(response.headers.get("cache-control")).toBe("no-store, max-age=0");
+  });
+});
diff --git a/LOGISDATA/tests/unit/keyboard.test.ts b/LOGISDATA/tests/unit/keyboard.test.ts
new file mode 100644
index 0000000..0fa53b1
--- /dev/null
+++ b/LOGISDATA/tests/unit/keyboard.test.ts
@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+import { shouldIgnorePresentationShortcut } from "@/lib/keyboard";
+
+const event = (overrides: Partial<Parameters<typeof shouldIgnorePresentationShortcut>[0]> = {}) => ({
+  defaultPrevented: false,
+  altKey: false,
+  ctrlKey: false,
+  metaKey: false,
+  isComposing: false,
+  ...overrides,
+});
+
+describe("presentation keyboard boundary", () => {
+  it.each([
+    "button",
+    "a",
+    "input",
+    "select",
+    "textarea",
+    "[contenteditable]",
+    "[role='radio']",
+  ])("protects focused interactive target %s", (selector) => {
+    document.body.innerHTML = `
+      <button><span>Button child</span></button>
+      <a href="/handout">Link</a>
+      <input>
+      <select><option>One</option></select>
+      <textarea></textarea>
+      <div contenteditable="true"></div>
+      <div role="radio" tabindex="0"></div>
+    `;
+    const target = selector === "button"
+      ? document.querySelector("button span")
+      : document.querySelector(selector);
+    expect(shouldIgnorePresentationShortcut(event(), target, false)).toBe(true);
+  });
+
+  it("protects native modal, handled, modified, and composing events", () => {
+    expect(shouldIgnorePresentationShortcut(event(), document.body, true)).toBe(true);
+    expect(shouldIgnorePresentationShortcut(event({ defaultPrevented: true }), document.body, false)).toBe(true);
+    expect(shouldIgnorePresentationShortcut(event({ altKey: true }), document.body, false)).toBe(true);
+    expect(shouldIgnorePresentationShortcut(event({ ctrlKey: true }), document.body, false)).toBe(true);
+    expect(shouldIgnorePresentationShortcut(event({ metaKey: true }), document.body, false)).toBe(true);
+    expect(shouldIgnorePresentationShortcut(event({ isComposing: true }), document.body, false)).toBe(true);
+  });
+
+  it("allows unmodified shortcuts from the document surface", () => {
+    expect(shouldIgnorePresentationShortcut(event(), document.body, false)).toBe(false);
+  });
+});
diff --git a/LOGISDATA/tests/unit/metrics.test.ts b/LOGISDATA/tests/unit/metrics.test.ts
index 9fa6f49..3460570 100644
--- a/LOGISDATA/tests/unit/metrics.test.ts
+++ b/LOGISDATA/tests/unit/metrics.test.ts
@@ -61,4 +61,12 @@ describe("warehouseSummary", () => {
     expect(warehouseSummary.accuracy).toBeCloseTo(warehouseSummary.audited / warehouseSummary.total, 3);
     expect(warehouseSummary.accuracy).toBeGreaterThan(0.5);
   });
+
+  it("accepts scenario-specific and empty bin sets", () => {
+    const audited = selectors.summariseWarehouse(
+      warehouseBins.map((bin) => ({ ...bin, status: "audited" as const })),
+    );
+    expect(audited).toMatchObject({ mismatches: 0, audited: warehouseBins.length, accuracy: 1 });
+    expect(selectors.summariseWarehouse([])).toEqual({ total: 0, mismatches: 0, audited: 0, accuracy: 1 });
+  });
 });
diff --git a/LOGISDATA/tests/unit/newComponents.test.tsx b/LOGISDATA/tests/unit/newComponents.test.tsx
index 3b8c524..faf3e1e 100644
--- a/LOGISDATA/tests/unit/newComponents.test.tsx
+++ b/LOGISDATA/tests/unit/newComponents.test.tsx
@@ -1,4 +1,5 @@
-import { cleanup, render, screen } from "@testing-library/react";
+import { useState } from "react";
+import { act, cleanup, fireEvent, render, screen, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { ScenarioSwitcher } from "@/components/ui/ScenarioSwitcher";
@@ -7,100 +8,234 @@ import { NodeInspectorModal } from "@/components/ui/NodeInspectorModal";
 import { LiveTelemetryFeed } from "@/components/ui/LiveTelemetryFeed";
 import { AudioToggle } from "@/components/ui/AudioToggle";
 import { downloadExecutiveReportJson } from "@/lib/export";
+import { sound } from "@/lib/sound";
 
 afterEach(() => {
   cleanup();
+  sound.setEnabled(false);
+  vi.useRealTimers();
+  vi.restoreAllMocks();
+  vi.unstubAllGlobals();
 });
 
 describe("ScenarioSwitcher", () => {
-  it("renders all three scenario options and handles selection", async () => {
+  it("renders all scenarios, changes selection, and ignores the active option", async () => {
     const user = userEvent.setup();
     const onChange = vi.fn();
-    render(<ScenarioSwitcher scenario="active-audit" onScenarioChange={onChange} language="en" />);
+    const { rerender } = render(
+      <ScenarioSwitcher scenario="active-audit" onScenarioChange={onChange} language="en" />,
+    );
 
     expect(screen.getByRole("radiogroup")).toBeInTheDocument();
-    const baselineBtn = screen.getByRole("radio", { name: /raw discrepancy/i });
-    expect(baselineBtn).toBeInTheDocument();
-
-    await user.click(baselineBtn);
+    expect(screen.getAllByRole("radio")).toHaveLength(3);
+    await user.click(screen.getByRole("radio", { name: /raw discrepancy/i }));
     expect(onChange).toHaveBeenCalledWith("baseline");
+
+    rerender(<ScenarioSwitcher scenario="baseline" onScenarioChange={onChange} language="en" />);
+    await user.click(screen.getByRole("radio", { name: /raw discrepancy/i }));
+    expect(onChange).toHaveBeenCalledTimes(1);
+  });
+
+  it("supports roving focus and radio-group arrow navigation", async () => {
+    const user = userEvent.setup();
+
+    function Harness() {
+      const [scenario, setScenario] = useState<"baseline" | "active-audit" | "mitigated">("active-audit");
+      return <ScenarioSwitcher scenario={scenario} onScenarioChange={setScenario} language="en" />;
+    }
+
+    render(<Harness />);
+    const active = screen.getByRole("radio", { name: /active audit gate/i });
+    const mitigated = screen.getByRole("radio", { name: /closed-loop optim/i });
+    expect(active).toHaveAttribute("tabindex", "0");
+    expect(mitigated).toHaveAttribute("tabindex", "-1");
+
+    active.focus();
+    await user.keyboard("{ArrowRight}");
+    expect(mitigated).toHaveAttribute("aria-checked", "true");
+    expect(mitigated).toHaveAttribute("tabindex", "0");
+    expect(mitigated).toHaveFocus();
+
+    await user.keyboard("{ArrowRight}");
+    expect(screen.getByRole("radio", { name: /raw discrepancy/i })).toHaveFocus();
+    await user.keyboard("{ArrowLeft}");
+    expect(mitigated).toHaveFocus();
+    await user.keyboard("{ArrowUp}");
+    expect(active).toHaveFocus();
+    await user.keyboard("{ArrowDown}");
+    expect(mitigated).toHaveFocus();
+    await user.keyboard("{Home}");
+    expect(screen.getByRole("radio", { name: /raw discrepancy/i })).toHaveFocus();
+    await user.keyboard("{End}");
+    expect(mitigated).toHaveFocus();
+    await user.keyboard("x");
+    expect(mitigated).toHaveFocus();
   });
 
-  it("renders Arabic labels when language is ar", () => {
+  it("renders Arabic labels", () => {
     render(<ScenarioSwitcher scenario="active-audit" onScenarioChange={() => {}} language="ar" />);
     expect(screen.getByText(/نمط التدقيق/i)).toBeInTheDocument();
   });
 });
 
 describe("RecoveryCalculator", () => {
-  it("renders calculator modal when open is true", () => {
-    render(<RecoveryCalculator open={true} onClose={() => {}} language="en" />);
-    expect(screen.getByRole("dialog")).toBeInTheDocument();
-    expect(screen.getByText(/Executive Margin Recovery Calculator/i)).toBeInTheDocument();
+  it("uses native modality, sets initial focus, and restores its invoker", async () => {
+    const user = userEvent.setup();
+
+    function Harness() {
+      const [open, setOpen] = useState(false);
+      return (
+        <>
+          <button type="button" onClick={() => setOpen(true)}>Open calculator</button>
+          <RecoveryCalculator open={open} onClose={() => setOpen(false)} language="en" />
+        </>
+      );
+    }
+
+    render(<Harness />);
+    const invoker = screen.getByRole("button", { name: "Open calculator" });
+    await user.click(invoker);
+
+    const dialog = screen.getByRole("dialog") as HTMLDialogElement;
+    expect(dialog.tagName).toBe("DIALOG");
+    expect(dialog.open).toBe(true);
+    const closeButton = within(dialog).getByRole("button", { name: "Close" });
+    expect(closeButton).toHaveFocus();
+
+    await user.click(closeButton);
+    expect(screen.queryByRole("dialog")).toBeNull();
+    expect(invoker).toHaveFocus();
+  });
+
+  it("renders transparent assumptions and updates all three model inputs", () => {
+    render(<RecoveryCalculator open onClose={() => {}} language="en" />);
+
+    const dialog = screen.getByRole("dialog");
+    expect(within(dialog).getByText(/Illustrative estimate, not a forecast/i)).toBeInTheDocument();
+    const ranges = within(dialog).getAllByRole("slider");
+    expect(ranges).toHaveLength(3);
+    fireEvent.change(ranges[0], { target: { value: "30000000" } });
+    fireEvent.change(ranges[1], { target: { value: "750000" } });
+    fireEvent.change(ranges[2], { target: { value: "18000" } });
+    expect(ranges[0]).toHaveValue("30000000");
+    expect(ranges[1]).toHaveValue("750000");
+    expect(ranges[2]).toHaveValue("18000");
   });
 
-  it("does not render when open is false", () => {
+  it("does not render while closed", () => {
     render(<RecoveryCalculator open={false} onClose={() => {}} language="en" />);
     expect(screen.queryByRole("dialog")).toBeNull();
   });
 
-  it("calls onClose when close button is clicked", async () => {
+  it("localizes content and closes from its labelled control", async () => {
     const user = userEvent.setup();
     const onClose = vi.fn();
-    render(<RecoveryCalculator open={true} onClose={onClose} language="en" />);
+    render(<RecoveryCalculator open onClose={onClose} language="ar" />);
 
-    const closeBtn = screen.getByRole("button", { name: /close/i });
-    await user.click(closeBtn);
-    expect(onClose).toHaveBeenCalled();
+    expect(screen.getByText(/تقدير توضيحي/)).toBeInTheDocument();
+    await user.click(screen.getByRole("button", { name: /إغلاق/i }));
+    expect(onClose).toHaveBeenCalledOnce();
   });
 });
 
 describe("NodeInspectorModal", () => {
-  it("renders node details for a valid nodeId", () => {
-    render(<NodeInspectorModal nodeId="port" onClose={() => {}} language="en" />);
-    expect(screen.getByRole("dialog")).toBeInTheDocument();
-    expect(screen.getByText(/Port Terminal Alpha/i)).toBeInTheDocument();
-    expect(screen.getByText(/Maritime Container Ingress/i)).toBeInTheDocument();
+  it.each([
+    ["port", /Port Terminal Alpha/i, /Verified/i],
+    ["yard", /Staging Yard Bravo/i, /Leak Risk/i],
+    ["crossdock", /Cross-Dock Gateway/i, /Phantom/i],
+  ])("renders the %s status without relying on color", (nodeId, label, status) => {
+    render(<NodeInspectorModal nodeId={nodeId} onClose={() => {}} language="en" />);
+    const dialog = screen.getByRole("dialog");
+    expect(within(dialog).getByText(label)).toBeInTheDocument();
+    expect(within(dialog).getAllByText(status).length).toBeGreaterThan(0);
   });
 
-  it("returns null when nodeId is null", () => {
-    render(<NodeInspectorModal nodeId={null} onClose={() => {}} language="en" />);
+  it("closes through the native dialog lifecycle and returns null for absent or unknown nodes", () => {
+    const onClose = vi.fn();
+    const { rerender } = render(<NodeInspectorModal nodeId="port" onClose={onClose} language="en" />);
+    (screen.getByRole("dialog") as HTMLDialogElement).close();
+    expect(onClose).toHaveBeenCalledOnce();
+
+    rerender(<NodeInspectorModal nodeId={null} onClose={onClose} language="en" />);
+    expect(screen.queryByRole("dialog")).toBeNull();
+    rerender(<NodeInspectorModal nodeId="unknown" onClose={onClose} language="en" />);
     expect(screen.queryByRole("dialog")).toBeNull();
   });
 });
 
 describe("LiveTelemetryFeed", () => {
-  it("renders live telemetry events when open", () => {
-    render(<LiveTelemetryFeed open={true} onClose={() => {}} language="en" />);
-    expect(screen.getByText(/Live Audit Telemetry Stream/i)).toBeInTheDocument();
-    expect(screen.getByText(/STREAM ACTIVE/i)).toBeInTheDocument();
+  it("labels fixture replay honestly and supports filtering, pause, and close", async () => {
+    const user = userEvent.setup();
+    const onClose = vi.fn();
+    render(<LiveTelemetryFeed open onClose={onClose} language="en" />);
+
+    expect(screen.getByText("Audit Telemetry Simulation")).toBeInTheDocument();
+    expect(screen.getByText("SIMULATION RUNNING")).toBeInTheDocument();
+    expect(screen.getByText(/not connected to operational systems/i)).toBeInTheDocument();
+    expect(screen.getAllByText(/INV-DUP-CLAIM-884|WMS-BIN-MISMATCH-C05/).length).toBeGreaterThan(0);
+
+    const warningFilter = screen.getByRole("button", { name: "Warning" });
+    expect(warningFilter).toHaveAttribute("aria-pressed", "false");
+    await user.click(warningFilter);
+    expect(warningFilter).toHaveAttribute("aria-pressed", "true");
+    expect(screen.getByText("GPS-CORR-DEV-19")).toBeInTheDocument();
+    expect(screen.queryByText("INV-DUP-CLAIM-884")).toBeNull();
+
+    await user.click(screen.getByRole("button", { name: "Pause" }));
+    expect(screen.getByText("SIMULATION PAUSED")).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Resume" })).toBeInTheDocument();
+    await user.click(screen.getByRole("button", { name: "Resume" }));
+    await user.click(screen.getByRole("button", { name: "Close" }));
+    expect(onClose).toHaveBeenCalledOnce();
   });
 
-  it("returns null when open is false", () => {
+  it("localizes severity controls in Arabic", () => {
+    render(<LiveTelemetryFeed open onClose={() => {}} language="ar" />);
+    expect(screen.getByRole("button", { name: "حرج" })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "تحذير" })).toBeInTheDocument();
+  });
+
+  it("does not run the replay timer while hidden", () => {
+    vi.useFakeTimers();
+    const timer = vi.spyOn(globalThis, "setInterval");
     render(<LiveTelemetryFeed open={false} onClose={() => {}} language="en" />);
-    expect(screen.queryByText(/Live Audit Telemetry Stream/i)).toBeNull();
+    expect(screen.queryByText("Audit Telemetry Simulation")).toBeNull();
+    expect(timer).not.toHaveBeenCalled();
+  });
+
+  it.each([
+    [0, "playAlert"],
+    [0.7, "playSuccess"],
+  ] as const)("routes generated fixture severity to %s audio", (random, method) => {
+    vi.useFakeTimers();
+    vi.spyOn(Math, "random").mockReturnValue(random);
+    const audio = vi.spyOn(sound, method).mockImplementation(() => {});
+    render(<LiveTelemetryFeed open onClose={() => {}} language="en" />);
+
+    act(() => vi.advanceTimersByTime(4_500));
+    expect(audio).toHaveBeenCalledOnce();
   });
 });
 
 describe("AudioToggle", () => {
-  it("renders audio toggle button and handles click", async () => {
+  it("exposes and persists both muted and enabled states", async () => {
     const user = userEvent.setup();
     render(<AudioToggle language="en" />);
-    const btn = screen.getByRole("button", { name: /audio/i });
-    expect(btn).toBeInTheDocument();
-    await user.click(btn);
+    const button = screen.getByRole("button", { name: /audio: muted/i });
+    expect(button).toHaveAttribute("aria-pressed", "false");
+    await user.click(button);
+    expect(screen.getByRole("button", { name: /audio: on/i })).toHaveAttribute("aria-pressed", "true");
   });
 });
 
 describe("Executive Report JSON Export", () => {
-  it("exports JSON package without error in browser-like environment", () => {
-    // In jsdom document and URL.createObjectURL mock may need verification
-    const originalCreateObjectURL = globalThis.URL.createObjectURL;
-    globalThis.URL.createObjectURL = vi.fn(() => "blob:mock-url");
-
-    const result = downloadExecutiveReportJson("en");
-    expect(result).toBe(true);
-
-    globalThis.URL.createObjectURL = originalCreateObjectURL;
+  it("downloads a scenario-labelled JSON package without navigation", () => {
+    const createObjectURL = vi.fn(() => "blob:mock-url");
+    vi.stubGlobal("URL", { ...URL, createObjectURL, revokeObjectURL: vi.fn() });
+    const click = vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => {});
+
+    expect(downloadExecutiveReportJson("en", "mitigated")).toBe(true);
+    expect(createObjectURL).toHaveBeenCalledOnce();
+    expect(click).toHaveBeenCalledOnce();
   });
 });
diff --git a/LOGISDATA/tests/unit/sectionComponents.test.tsx b/LOGISDATA/tests/unit/sectionComponents.test.tsx
index 95f171b..c05300e 100644
--- a/LOGISDATA/tests/unit/sectionComponents.test.tsx
+++ b/LOGISDATA/tests/unit/sectionComponents.test.tsx
@@ -49,6 +49,24 @@ describe.each(SECTION_CASES)("$name section", ({ Component, headingId, level })
   });
 });
 
+describe("HeroSection", () => {
+  it("opens the inspector for the selected network node", async () => {
+    const user = userEvent.setup();
+    const onSelectNode = vi.fn();
+    render(
+      <HeroSection
+        language="en"
+        active
+        reduced
+        scenario="mitigated"
+        onSelectNode={onSelectNode}
+      />,
+    );
+    await user.click(screen.getByRole("button", { name: /Inspect Port/i }));
+    expect(onSelectNode).toHaveBeenCalledWith("port");
+  });
+});
+
 describe("AuditSection", () => {
   it("renders every freight row with a row header and a verdict", () => {
     render(<AuditSection language="en" active reduced={false} />);
@@ -66,6 +84,22 @@ describe("AuditSection", () => {
     render(<AuditSection language="en" active reduced={false} />);
     expect(screen.getByRole("button", { name: /export csv/i })).toHaveAttribute("data-dataset", "freight-audit");
   });
+
+  it("filters by text and verdict and exposes a localized empty state", async () => {
+    const user = userEvent.setup();
+    render(<AuditSection language="en" active reduced scenario="baseline" />);
+
+    const search = screen.getByRole("textbox", { name: /search/i });
+    await user.type(search, "not-a-freight-type");
+    expect(screen.getByText("No records match the current filters.")).toBeInTheDocument();
+    expect(within(screen.getByRole("table")).getAllByRole("row")).toHaveLength(2);
+
+    await user.clear(search);
+    await user.click(screen.getByRole("button", { name: /passed/i }));
+    expect(screen.getByText("No records match the current filters.")).toBeInTheDocument();
+    await user.click(screen.getByRole("button", { name: /^all$/i }));
+    expect(screen.queryByText("No records match the current filters.")).toBeNull();
+  });
 });
 
 describe("DemandSection", () => {
@@ -82,6 +116,22 @@ describe("RoutesSection", () => {
     expect(within(screen.getByRole("table")).getAllByRole("rowheader")).toHaveLength(routeRegions.length);
     expect(screen.getByText(currency(routeSummary.totalSavings, "en"))).toBeInTheDocument();
   });
+
+  it("sorts every numeric column and announces direction", async () => {
+    const user = userEvent.setup();
+    render(<RoutesSection language="en" active reduced />);
+
+    for (const name of [/mileage waste/i, /fuel loss/i, /gps deviation/i, /optimized savings/i]) {
+      const header = screen.getByRole("columnheader", { name });
+      await user.click(within(header).getByRole("button"));
+      expect(screen.getByRole("columnheader", { name })).toHaveAttribute("aria-sort", "descending");
+    }
+
+    const savingsHeader = screen.getByRole("columnheader", { name: /optimized savings/i });
+    await user.click(within(savingsHeader).getByRole("button"));
+    expect(screen.getByRole("columnheader", { name: /optimized savings/i }))
+      .toHaveAttribute("aria-sort", "ascending");
+  });
 });
 
 describe("WarehouseSection", () => {
diff --git a/LOGISDATA/tests/unit/simulation.test.ts b/LOGISDATA/tests/unit/simulation.test.ts
index f01c748..f1fa29b 100644
--- a/LOGISDATA/tests/unit/simulation.test.ts
+++ b/LOGISDATA/tests/unit/simulation.test.ts
@@ -45,26 +45,39 @@ describe("simulation domain model", () => {
 
   it("adjusts freight rows according to scenario", () => {
     const baselineRows = getScenarioFreightRows("baseline");
+    const activeRows = getScenarioFreightRows("active-audit");
     const mitigatedRows = getScenarioFreightRows("mitigated");
 
     expect(baselineRows.every((r) => r.verdict === "red-flag")).toBe(true);
+    expect(activeRows).toBe(getScenarioFreightRows("active-audit"));
     expect(mitigatedRows.every((r) => r.verdict === "passed")).toBe(true);
   });
 
-  it("smooths demand tiers in mitigated scenario", () => {
-    const tiers = getScenarioDemandTiers("mitigated");
-    expect(tiers[tiers.length - 1].distorted).toBeLessThan(145);
+  it("models demand tiers across all scenarios", () => {
+    const baseline = getScenarioDemandTiers("baseline");
+    const active = getScenarioDemandTiers("active-audit");
+    const mitigated = getScenarioDemandTiers("mitigated");
+    expect(baseline.at(-1)?.distorted).toBeGreaterThan(active.at(-1)?.distorted as number);
+    expect(mitigated.at(-1)?.distorted).toBeLessThan(active.at(-1)?.distorted as number);
   });
 
-  it("reduces route waste and increases savings in mitigated scenario", () => {
-    const regions = getScenarioRouteRegions("mitigated");
-    expect(regions[0].mileageWastePct).toBeLessThan(5);
-    expect(regions[0].optimizedSavings).toBeGreaterThan(428000);
+  it("models route outcomes across all scenarios", () => {
+    const baseline = getScenarioRouteRegions("baseline");
+    const active = getScenarioRouteRegions("active-audit");
+    const mitigated = getScenarioRouteRegions("mitigated");
+    expect(baseline[0].mileageWastePct).toBeGreaterThan(active[0].mileageWastePct);
+    expect(mitigated[0].mileageWastePct).toBeLessThan(active[0].mileageWastePct);
+    expect(mitigated[0].optimizedSavings).toBeGreaterThan(active[0].optimizedSavings);
   });
 
-  it("resolves all warehouse bins to audited status in mitigated scenario", () => {
-    const bins = getScenarioWarehouseBins("mitigated");
-    expect(bins.every((b) => b.status === "audited")).toBe(true);
+  it("models warehouse status across all scenarios", () => {
+    const baseline = getScenarioWarehouseBins("baseline");
+    const active = getScenarioWarehouseBins("active-audit");
+    const mitigated = getScenarioWarehouseBins("mitigated");
+    expect(baseline.filter((bin) => bin.status === "mismatch").length).toBeGreaterThan(
+      active.filter((bin) => bin.status === "mismatch").length,
+    );
+    expect(mitigated.every((bin) => bin.status === "audited")).toBe(true);
   });
 
   it("contains rich supply node details for all 8 nodes", () => {
diff --git a/LOGISDATA/tests/unit/sound.test.ts b/LOGISDATA/tests/unit/sound.test.ts
index 15e2737..e7b078b 100644
--- a/LOGISDATA/tests/unit/sound.test.ts
+++ b/LOGISDATA/tests/unit/sound.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
 import { sound } from "@/lib/sound";
 
 describe("sound synthesizer engine", () => {
@@ -34,4 +34,13 @@ describe("sound synthesizer engine", () => {
     expect(() => sound.playAlert()).not.toThrow();
     expect(() => sound.playSuccess()).not.toThrow();
   });
+
+  it("does not allocate success-sequence timers while muted", () => {
+    vi.useFakeTimers();
+    const timeout = vi.spyOn(globalThis, "setTimeout");
+    sound.setEnabled(false);
+    sound.playSuccess();
+    expect(timeout).not.toHaveBeenCalled();
+    vi.useRealTimers();
+  });
 });
diff --git a/README.md b/README.md
index fe0088c..1913f3b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="LOGISDATA/public/og-image-animated.gif" alt="LOGISDATA — an audit gate sweeping across the live supply signal graph, leakage metrics and the five-stage audit rail" width="920">
+<img src="LOGISDATA/public/og-image-animated.gif" alt="LOGISDATA — an audit gate sweeping across a simulated supply signal graph, leakage metrics and the five-stage audit rail" width="920">
 
 <h1>LOGISDATA</h1>
 
@@ -41,8 +41,9 @@
 | **Initial JS on first paint** | zero Three.js | the engine is code-split and loaded only once the device is known to support WebGL |
 | **Runtime data fetches** | 0 on the critical path | the domain model is typed, static and tree-shaken |
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
-| **Source surface** | 26 TypeScript modules (~2.2k lines) + 1.7k lines of tokenized CSS | small enough to audit in an afternoon |
-| **Automated coverage** | 161 unit tests + 59 end-to-end checks | every major user flow is exercised, not just pure functions |
+| **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
+| **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
+| **Initial shell payload** | 202,528 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
 ---
@@ -105,13 +106,13 @@ flowchart LR
 
 ### Runtime boundaries
 
-The application is deliberately split into three cost tiers. Nothing from a heavier tier is downloaded, parsed or executed until the user has demonstrated intent.
+The application is deliberately split into three cost tiers. The 3D tier is requested only after the client capability probe confirms that WebGL is available; there is no cover-screen CTA or intent gate.
 
 | Tier | Boundary | Payload | Trigger |
 | :--- | :--- | :--- | :--- |
-| **T0 — Shell** | `page.tsx` → `PresentationShell` → `EngineLoader` | HTML, CSS, Framer Motion, two icons | first paint |
-| **T1 — Engine** | `dynamic(() => import("@/components/Presentation"), { ssr: false })` | React Three Fiber, drei, Three.js, all five scenes | hydration, once `probeDevice()` confirms a WebGL context |
-| **T2 — Data plane** | `getDb()` inside `api/health` | `pg` pool, Drizzle | an HTTP request *and* a configured `DATABASE_URL` |
+| **T0 — Shell** | `page.tsx` → `PresentationShell` → `EngineLoader` | Static HTML, CSS, React shell, small icon subset | first paint |
+| **T1 — Engine** | `dynamic(() => import("@/components/Presentation"), { ssr: false })` | React Three Fiber, drei, Three.js, Framer Motion, all five scenes | hydration, once the device probe confirms a WebGL context |
+| **T2 — Data plane** | `getDb()` inside `api/health` | `pg` pool, Drizzle | a readiness request *and* a configured `DATABASE_URL` |
 
 > [!IMPORTANT]
 > `ssr: false` is a correctness requirement, not an optimization. The scene graph reads `window`, `document.visibilityState` and `localStorage` during initialization; server-rendering it would produce a hydration mismatch and a flash of unthemed content.
@@ -124,22 +125,23 @@ Five operational models share **one** `<Canvas>`, **one** camera and **one** scr
 ScrollControls(pages = 5, damping = 0.12)
    │
    ├─ ScrollBridge ───────────► exposes scroll.el to React for programmatic nav
+   ├─ DeckOverlay portal ─────► 5 semantic <section> elements in the native scroller
    │
-   ├─ IndustrialScene ────────► per-frame rig (useFrame)
-   │     ├─ camera.position  lerp(CAMERA_TARGETS[i], [i+1]) → damp(1 - e^(-4.6·Δt))
-   │     ├─ camera.lookAt    lerp(LOOK_TARGETS[i],   [i+1]) → damp(1 - e^(-5.2·Δt))
-   │     └─ group[i]         scale 0.56 + focus·0.44 · depth (i − page)·2.2
-   │
-   └─ Scroll(html) ──────────► 5 semantic <section> elements, selectable + crawlable
+   └─ IndustrialScene ────────► per-frame rig (useFrame)
+         ├─ pagePosition     offset × (SECTION_COUNT − 1)
+         ├─ camera.position  lerp(CAMERA_TARGETS[i], [i+1]) → damp(1 - e^(-4.6·Δt))
+         ├─ camera.lookAt    lerp(LOOK_TARGETS[i],   [i+1]) → damp(1 - e^(-5.2·Δt))
+         └─ group[i]         scale 0.56 + focus·0.44 · depth (i − pagePosition)·2.2
 ```
 
 **The focus curve is the single source of truth for "how present is section _i_ right now".**
 
 ```ts
-focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
+pagePosition = clamp(offset, 0, 1) × (SECTION_COUNT − 1)
+focus(offset, i) = clamp(1 − |pagePosition − i| / 1.08, 0, 1)
 ```
 
-`IndustrialScene` applies it to mesh scale; `FocusFadeLabel` applies the identical curve to label opacity through [`lib/sceneFocus.ts`](LOGISDATA/src/lib/sceneFocus.ts). Because both consumers derive from one function, 3D geometry and its HTML annotations can never desynchronize — which is exactly the defect that produced overlapping labels from adjacent sections before the curve was extracted.
+`IndustrialScene` applies it to mesh scale; `FocusFadeLabel` applies the identical curve to label opacity through [`lib/sceneFocus.ts`](LOGISDATA/src/lib/sceneFocus.ts). Both consumers therefore stay aligned by construction—the regression tests lock the exact section peaks at offsets 0, 0.25, 0.5, 0.75, and 1.
 
 ### Module map
 
@@ -154,6 +156,8 @@ focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
 | [`src/components/sections/*`](LOGISDATA/src/components/sections) | Accessible HTML analytics for each theatre | Semantic tables; never canvas-only content |
 | [`src/lib/data.ts`](LOGISDATA/src/lib/data.ts) | The audit model: 3 metrics, 5 freight rows, 5 demand tiers, 5 route regions, 4 warehouse specs, 42 bins, 8 nodes, 10 edges | Every string is `{ en, ar }` |
 | [`src/lib/i18n.ts`](LOGISDATA/src/lib/i18n.ts) | `text` / `number` / `integer` / `currency` via `Intl` | `en-US` and `ar-EG` numeral systems |
+| [`src/lib/export.ts`](LOGISDATA/src/lib/export.ts) | Scenario-aware CSV and executive JSON evidence packages | Exported rows and summaries match the active scenario; JSON carries illustrative provenance |
+| [`src/lib/useNativeDialog.ts`](LOGISDATA/src/lib/useNativeDialog.ts) | Shared native modal lifecycle | Initial focus, Escape/platform close, and invoker-focus restoration |
 | [`src/lib/types.ts`](LOGISDATA/src/lib/types.ts) | Domain types | `LocalizedText` makes an untranslated string a compile error |
 | [`src/db/index.ts`](LOGISDATA/src/db/index.ts) | Lazy, bounded PostgreSQL pool | Never constructed at import time |
 | [`src/app/api/health/route.ts`](LOGISDATA/src/app/api/health/route.ts) | Liveness + optional readiness | Honest status codes — see [Operations](#-operations) |
@@ -173,7 +177,7 @@ focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
 <tr><td>01</td><td>Five-stage audit narrative</td><td><code>sections/*</code></td><td>Full-viewport sections bound to a shared section index</td><td>✅ Shipped</td></tr>
 <tr><td>02</td><td>Synchronized 3D models</td><td><code>three/*</code></td><td>Supply network, laser audit gate, demand matrix, route terrain, warehouse grid</td><td>✅ Shipped</td></tr>
 <tr><td>03</td><td>Cinematic camera choreography</td><td><code>IndustrialScene</code></td><td>Dual-target interpolation with frame-rate-independent damping</td><td>✅ Shipped</td></tr>
-<tr><td>04</td><td>Deferred engine boot</td><td><code>PresentationShell</code></td><td><code>next/dynamic</code> + <code>ssr:false</code> behind an explicit CTA</td><td>✅ Shipped</td></tr>
+<tr><td>04</td><td>Deferred engine boot</td><td><code>PresentationShell</code></td><td><code>next/dynamic</code> + <code>ssr:false</code> after the WebGL capability probe; no cover-screen CTA</td><td>✅ Shipped</td></tr>
 <tr><td>05</td><td>Animated metric counters</td><td><code>MetricCounter</code></td><td><code>IntersectionObserver</code> (0.35) → rAF cubic ease-out over 1250 ms</td><td>✅ Shipped</td></tr>
 
 <tr><td colspan="5"><b>Localization</b></td></tr>
@@ -190,7 +194,7 @@ focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
 
 <tr><td colspan="5"><b>Performance</b></td></tr>
 <tr><td>14</td><td>Background-tab suspension</td><td><code>Presentation</code></td><td><code>visibilitychange</code> → <code>frameloop="never"</code>: no GPU work when hidden</td><td>✅ Shipped</td></tr>
-<tr><td>15</td><td>Deterministic fill cost</td><td><code>Canvas</code></td><td><code>dpr={1}</code>, <code>alpha:false</code>, <code>powerPreference:"high-performance"</code></td><td>✅ Shipped</td></tr>
+<tr><td>15</td><td>Tiered fill cost</td><td><code>Canvas</code></td><td>Device-derived DPR clamp, adaptive regression while scrolling, <code>alpha:false</code>, <code>powerPreference:"high-performance"</code></td><td>✅ Shipped</td></tr>
 <tr><td>16</td><td>Allocation-free render loop</td><td><code>IndustrialScene</code></td><td>Module-level vectors + refs; no per-frame object churn</td><td>✅ Shipped</td></tr>
 <tr><td>17</td><td>React-free label updates</td><td><code>FocusFadeLabel</code></td><td>Opacity written straight to the DOM node inside <code>useFrame</code></td><td>✅ Shipped</td></tr>
 
@@ -199,8 +203,14 @@ focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
 <tr><td>19</td><td>Database-optional runtime</td><td><code>db/index.ts</code></td><td>Pool constructed lazily; importing the module never throws</td><td>✅ Shipped</td></tr>
 <tr><td>20</td><td>Bounded connection pool</td><td><code>db/index.ts</code></td><td><code>max</code> clamped to 1–50, 5 s connect timeout, 30 s idle reap</td><td>✅ Shipped</td></tr>
 <tr><td>21</td><td>Honest health contract</td><td><code>api/health</code></td><td><code>200</code> live · <code>503</code> only when a <i>configured</i> database is unreachable</td><td>✅ Shipped</td></tr>
-<tr><td>22</td><td>Production security headers</td><td><code>next.config.ts</code></td><td>7 headers incl. HSTS preload in production builds</td><td>✅ Shipped</td></tr>
+<tr><td>22</td><td>Production security headers</td><td><code>next.config.ts</code></td><td>CSP plus eight defense headers, including HSTS preload in production builds</td><td>✅ Shipped</td></tr>
 <tr><td>23</td><td>Animated social card</td><td><code>tools/og-image</code></td><td>Reproducible 1200×630 GIF + PNG fallback from design tokens</td><td>✅ Shipped</td></tr>
+<tr><td>24</td><td>Scenario-consistent evidence</td><td><code>lib/export.ts</code></td><td>CSV rows and executive JSON summaries derive from the selected scenario; JSON includes illustrative provenance</td><td>✅ Shipped</td></tr>
+<tr><td>25</td><td>Honest simulation state</td><td><code>LiveTelemetryFeed</code></td><td>Bilingual fixture-simulation disclosure; no interval or audio work while closed</td><td>✅ Shipped</td></tr>
+<tr><td>26</td><td>Native modal lifecycle</td><td><code>useNativeDialog</code></td><td>Platform modality and Escape handling, deterministic initial focus, invoker-focus restoration</td><td>✅ Shipped</td></tr>
+<tr><td>27</td><td>Calculator provenance</td><td><code>RecoveryCalculator</code> / <code>HandoutView</code></td><td>Bilingual fixed-assumption disclosure; illustrative, not a forecast</td><td>✅ Shipped</td></tr>
+<tr><td>28</td><td>Context-safe global shortcuts</td><td><code>lib/keyboard.ts</code></td><td>Section keys yield to focused controls, IME composition, handled events, modifiers, and open modals</td><td>✅ Shipped</td></tr>
+<tr><td>29</td><td>Accessible operating modes</td><td><code>ScenarioSwitcher</code> / <code>LiveTelemetryFeed</code></td><td>Roving radio focus, arrow/Home/End selection, localized pressed filters, and truthful running/paused status</td><td>✅ Shipped</td></tr>
 
 </tbody>
 </table>
@@ -211,7 +221,7 @@ focus(page, i) = clamp(1 − |page − (i + 0.5)| / 1.08, 0, 1)
 
 ### W-01 · Cold start and engine handoff
 
-First paint must be instant and must never depend on WebGL. The engine chunk is requested only after `probeDevice()` has confirmed the browser can actually create a rendering context, so a device that cannot run the deck never pays for the 1 MB Three.js chunk — it is served the `/handout` text briefing instead.
+First paint must not depend on WebGL. The engine chunk is requested only after the preference/device probe confirms that the browser can create a rendering context, so a device that cannot run the deck does not request the Three.js chunk—it is served the `/handout` text briefing instead.
 
 ```mermaid
 sequenceDiagram
@@ -230,7 +240,7 @@ sequenceDiagram
   D->>P: module resolved
   P->>G: create single Canvas context
   G-->>P: context ready
-  P-->>V: audit loop live at section 01
+  P-->>V: control room ready at section 01
   Note over S,P: Any throw inside P is caught by ExperienceBoundary →<br/>"Retry engine" panel instead of a blank document
 ```
 
@@ -243,22 +253,22 @@ flowchart LR
   classDef n fill:#0b1c2a,stroke:#4de1c1,color:#edf7fb
   classDef o fill:#10283a,stroke:#7dd3fc,color:#edf7fb
 
-  s["scroll.offset<br/>0 → 1"]:::n --> p["page = offset × 5"]:::n
-  p --> i["section = floor(page)<br/>local = page − section"]:::n
+  s["scroll.offset<br/>0 → 1"]:::n --> p["page = offset × (5 − 1)"]:::n
+  p --> i["current = floor(page)<br/>local = page − current"]:::n
   i --> t["transition = smoothstep(local)"]:::n
   t --> cam["camera position + lookAt<br/>lerp → exponential damp"]:::o
-  p --> f["focus = clamp(1 − abs(page − i − 0.5) ÷ 1.08)"]:::n
+  p --> f["focus = clamp(1 − abs(page − index) ÷ 1.08)"]:::n
   f --> sc["group scale 0.56 → 1.00"]:::o
   f --> lb["label opacity + visibility"]:::o
-  i --> ev["onSectionChange(i)<br/>fires only on change"]:::o
-  ev --> ui["nav highlight · progress dots · section entry animations"]:::o
+  s --> native["native scroll geometry<br/>sectionFromScrollTop"]:::n
+  native --> ui["hash · nav highlight · progress · live region"]:::o
 ```
 
 **Guarantees**
 
-- `onSectionChange` is edge-triggered (`lastSection` ref), so React state updates at most once per section crossing instead of once per frame.
-- Damping uses `1 − e^(−k·Δt)`, which is identical at 30, 60 and 144 Hz — no fast-machine/slow-machine divergence.
-- `goToSection()` scrolls the real DOM container obtained through `ScrollBridge`, so keyboard, nav-chip and progress-dot navigation all share one code path.
+- URL, navigation, progress, and live-region state derive from the native scroll event—not the GPU frame loop—so they remain correct when rendering is throttled or suspended.
+- Damping uses `1 − e^(−k·Δt)`, which is frame-rate independent across 30, 60, and 144 Hz.
+- `goToSection()` scrolls the real DOM container obtained through `ScrollBridge`, so keyboard, nav-chip, and progress-dot navigation all share one code path.
 
 ### W-03 · Bilingual inversion
 
@@ -401,10 +411,11 @@ curl -s localhost:3000/api/health | jq
 | `npm run lint` | ESLint flat config, Core Web Vitals | ✅ |
 | `npm run build` | Production compile + route collection | ✅ |
 | `npm audit` | Dependency advisories (currently **0**) | ✅ |
-| `npm run test` | 161 Vitest unit tests (85% statements, 90% lines) | ✅ |
-| `npm run test:e2e` | 59 Playwright checks across desktop, reduced-motion and mobile — including axe accessibility and an enforced performance budget | ✅ |
-| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling | ✅ |
-| `npm run check` | Types, lint and build in sequence — the pre-merge contract | ✅ |
+| `npm run test` | 213 Vitest tests in 16 files | ✅ |
+| `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
+| `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
+| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,528 B | ✅ |
+| `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
 ---
 
@@ -421,11 +432,15 @@ HEAD /api/health           # liveness  — 204, no body, no pool access
 {
   "ok": true,
   "service": "logisdata-control-room",
+  "version": "3.1.0",
   "database": "ready | unavailable | not-configured",
-  "timestamp": "2026-10-01T09:00:00.000Z"
+  "uptimeSeconds": 42,
+  "timestamp": "2026-10-02T19:42:00.000Z"
 }
 ```
 
+`version` defaults to `package.json` and can be replaced by a non-empty `NEXT_PUBLIC_APP_VERSION` deployment identifier.
+
 | Situation | `database` | HTTP | Interpretation |
 | :--- | :--- | :---: | :--- |
 | No `DATABASE_URL` | `not-configured` | `200` | Stateless deck — healthy |
@@ -434,16 +449,18 @@ HEAD /api/health           # liveness  — 204, no body, no pool access
 
 ### Security posture
 
-Applied to every route by [`next.config.ts`](LOGISDATA/next.config.ts).
+Applied to every route by [`next.config.ts`](LOGISDATA/next.config.ts). Production responses carry nine security headers; API responses additionally carry `Cache-Control: no-store, max-age=0`.
 
 | Header | Value | Threat addressed |
 | :--- | :--- | :--- |
+| `Content-Security-Policy` | self-origin defaults; objects/frames disabled; documented inline-script exception | Injection and embedding surface |
 | `X-Content-Type-Options` | `nosniff` | MIME confusion |
 | `X-Frame-Options` | `DENY` | Clickjacking |
 | `Referrer-Policy` | `strict-origin-when-cross-origin` | Referrer leakage |
 | `Permissions-Policy` | camera, microphone, geolocation, payment, usb = `()` | Silent capability acquisition |
 | `Cross-Origin-Opener-Policy` | `same-origin` | Cross-origin window tampering |
 | `Cross-Origin-Resource-Policy` | `same-origin` | Speculative cross-origin reads |
+| `X-DNS-Prefetch-Control` | `on` | Explicit DNS-prefetch policy |
 | `Strict-Transport-Security` | `max-age=63072000; includeSubDomains; preload` *(production only)* | Protocol downgrade |
 
 `poweredByHeader` is disabled, `compress` is enabled and `reactStrictMode` is on.
@@ -477,7 +494,7 @@ The Open Graph card is not a screenshot — it is **compiled**, from the same to
 | Motion | Mirrors | Product meaning |
 | :--- | :--- | :--- |
 | Emerald gate sweeping left → right | `AuditScanner` laser gate | The audit pass itself |
-| Metric digits scrambling, then a tick | `MetricCounter` | Live re-verification of a figure |
+| Metric digits scrambling, then a tick | `MetricCounter` | Simulated re-verification of an illustrative figure |
 | Packets travelling the node graph | `SupplyNetwork` (the real 8 nodes / 10 edges) | Signal flow between facilities |
 | Red and amber rings pulsing | `status: "leak" \| "phantom"` | Unverified nodes demanding attention |
 | Five-segment rail illuminating 01 → 05 | The five sections | The narrative spine of the deck |
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
new file mode 100644
index 0000000..22bd027
--- /dev/null
+++ b/UPGRADE_LOG.md
@@ -0,0 +1,349 @@
+# Autonomous Elite Upgrade Log
+
+- Date: 2026-10-02
+- Mode: UPGRADE
+- Autonomy: FULL
+- Target: repository root (`/home/user/LOGISDATA`), with the application in `LOGISDATA/`
+
+## Operator fields inferred
+
+| Field | Inference | Evidence |
+|---|---|---|
+| Intent | Make LOGISDATA a production-grade, bilingual executive supply-chain audit control room that communicates illustrative audit findings clearly and remains usable without WebGL. | Root `README.md`; `docs/ARCHITECTURE.md`; app metadata and handout route. |
+| Audience | AAST academic/executive reviewers, logistics decision-makers, and maintainers. | Branding, byline, audit copy, presentation controls, and architecture documentation. |
+| Preserve | AAST mark and attribution; English/Arabic parity; reported figures and conclusions; five-stage narrative; text handout; one-canvas synchronized 3D experience; optional database posture; CSV/JSON exports. | Existing source, tests, README, and DOCS pack hard stops. |
+| Constraints | Do not alter conclusions or illustrative data; do not alter protected brand marks; do not add dependencies without evidence; do not deploy/push/apply infrastructure; preserve public routes and accessibility; stay on Arena's fixed branch `arena/01a0fe14-logisdata`. | Universal/DOCS/DESIGN/INFRA hard stops plus workspace branch policy. |
+| Reference environment | Node 22, Next.js 16 App Router, React 19, evergreen Chromium/mobile, WCAG 2.2 AA target, optional PostgreSQL. | `.nvmrc`, `package.json`, Playwright config, source. |
+
+## Assumptions
+
+1. Blank operator fields authorize inference from the repository and direct implementation under FULL autonomy.
+2. The repository is already on the required checkpoint branch. Arena fixes this session to `arena/01a0fe14-logisdata`, so the prompt's generic instruction to create `upgrade/v7-*` is superseded; work remains on the fixed branch.
+3. All domain figures are illustrative and must remain unchanged. Improvements may strengthen labeling, validation, presentation, and engineering but not the author's findings.
+4. No external deployment, push, database connection, migration, tracking change, or paid service is authorized.
+5. The checked-in AAST logo is preserved as an existing project asset; license/brand authorization cannot be independently verified in this workspace and remains an owner responsibility.
+
+## W0 — classification and system map
+
+### Classification
+
+Loaded packs:
+
+- **WEB** — Next.js web presentation with static routes, client-side controls, WebGL, and downloadable exports.
+- **3D** — one React Three Fiber canvas with five synchronized operational scenes and a performance-sensitive frame loop.
+- **DESIGN** — presentation interface, visual tokens, responsive states, bilingual/RTL layouts, and protected institutional branding.
+- **DOCS** — accessible/printable handout plus extensive README and architecture documentation.
+- **BACKEND** — `/api/health` and lazy optional PostgreSQL access.
+- **SECURITY** — network-exposed application, security headers, download boundaries, environment-driven database access.
+- **INFRA** — Dockerfile and GitHub Actions CI.
+
+DATA-AI is not loaded: the typed literals are presentation content, not a data pipeline or model. QUANT is not loaded: financial-looking metrics are static illustrative findings, not a financial model or trading system.
+
+### System map
+
+- **Entrypoints:** `LOGISDATA/src/app/page.tsx`, `/handout`, `/api/health`, metadata routes.
+- **Client shell:** `PresentationShell` probes WebGL/device capability before dynamically loading `Presentation`.
+- **Experience:** `Presentation` owns navigation and binds one Drei scroll source to semantic HTML sections and `IndustrialScene`.
+- **State:** `PreferencesProvider` + `useSyncExternalStore`; persisted locale/theme; local sound preference.
+- **Domain content:** typed bilingual literals in `src/lib/data.ts`; derived summaries in `src/lib/metrics.ts`; exports in `src/lib/export.ts`.
+- **3D lifecycle:** one R3F canvas; tiered DPR/particle budgets; demand or suspended render loops; scene focus and scroll geometry are shared pure functions.
+- **Backend:** liveness/readiness route; PostgreSQL pool is lazy and optional.
+- **Quality tooling:** strict TypeScript, ESLint, Vitest coverage gates, Playwright/axe/e2e performance checks, payload budget, npm audit, CI matrix.
+- **Deployment:** multi-stage non-root standalone Next.js Docker image; CI validates but does not deploy.
+
+### Initial leverage queue
+
+Scores use `L = (Impact × Confidence × Reach) / (Effort × Risk)` and will be revised after baseline measurements.
+
+| Priority | Candidate | I | C | Reach | E | Risk | L | State |
+|---|---|---:|---:|---:|---:|---:|---:|---|
+| P0 | Run all existing checks and investigate every failure before changing behavior. | 5 | 1.0 | 3 | 2 | 1 | 7.50 | queued |
+| P1 | Reconcile source/docs/version drift and any false operational claims. | 4 | 0.9 | 3 | 2 | 1 | 5.40 | queued |
+| P1 | Audit application trust boundaries, metadata origins, database health semantics, exports, and external-link behavior. | 5 | 0.8 | 2 | 3 | 2 | 1.33 | queued |
+| P1 | Inspect responsive, keyboard, screen-reader, print, no-WebGL, and reduced-motion states; close high-confidence gaps. | 5 | 0.8 | 3 | 4 | 2 | 1.50 | queued |
+| P2 | Profile payload/frame-loop/static-shell behavior and remove provable waste without weakening budgets. | 4 | 0.8 | 3 | 4 | 2 | 1.20 | queued |
+| P2 | Consolidate maintainability hotspots only where tests can lock behavior. | 3 | 0.8 | 2 | 3 | 1 | 1.60 | queued |
+
+## W1 — deterministic baseline protocol
+
+Environment: Linux sandbox; Node and browser versions recorded by the commands below. This exact protocol will be rerun in W7.
+
+```bash
+cd LOGISDATA
+node --version
+npm --version
+npm ci
+npm run typecheck
+npm run lint
+npm run test:coverage
+npm run build
+npm audit --audit-level=high
+# then, when the production server is running:
+npm run budget -- --url http://127.0.0.1:3100
+npm run test:e2e
+```
+
+Initial environment observations:
+
+- Node: **v22.22.3 MEASURED** (`node --version`).
+- npm: **10.9.8 MEASURED** (`npm --version`).
+- Install: **557 packages added, 558 audited, 0 vulnerabilities MEASURED** (`npm ci`, 2026-10-02).
+- npm reported deprecation warnings in transitive tooling (`@esbuild-kit/*`) and for pinned ESLint 9.39.4; no change is made until dependency provenance and compatibility are verified.
+
+### Baseline results
+
+| Instrument | Baseline result | Status |
+|---|---|---|
+| TypeScript | **0 errors MEASURED** (`tsc --noEmit`, 7.7 s) | pass |
+| ESLint | **0 findings MEASURED** (`eslint .`, 7.6 s) | pass |
+| Unit tests | **185/185 assertions passed in 14 files MEASURED** (Vitest 5.0.3, 20.87 s) | assertions pass |
+| Coverage gate | Statements **79.94%** (594/743); branches **77.26%** (435/563); functions **75.60%** (189/250); lines **83.62%** (531/635), all MEASURED | **fail**: configured floors are 80/80/80/85 |
+| Unit runtime diagnostics | Repeated jsdom canvas diagnostics, invalid mocked `priority`/`prefetch` DOM attributes, and one simulated navigation warning, MEASURED from stderr | **fail**: suite exits red and is noisy |
+| Production build | **9 routes compiled/prerendered MEASURED** in 21.9 s | pass with one warning: redundant custom `Cache-Control` for `/_next/static` |
+| Dependency audit | **0 vulnerabilities MEASURED** across 558 installed packages (`npm audit --audit-level=high`) | pass |
+| Secret baseline | **0 matching key patterns; only `.env.example` tracked MEASURED** with the CI patterns | pass |
+| Initial shell payload | **201,725 B gzip MEASURED** by `scripts/bundle-budget.mjs` against `next start`, budget 205,000 B | pass, only 3,275 B headroom |
+| Static document | **14,151 B uncompressed MEASURED** by production response `Content-Length` | pass (<40,000 B test ceiling) |
+| Health route | HTTP 200, database `not-configured`, security headers present, MEASURED with `curl` | pass except reported app version is stale (`3.0.0` vs package `3.1.0`) |
+| E2E/a11y/performance | **UNMEASURED**: 2 request-only checks passed; 57 browser checks could not launch because Chromium is absent. A direct install retried five times and failed with `ECONNRESET` from `cdn.playwright.dev`. | environment-blocked, not treated as product failures |
+| Real-device CWV / frame time / GPU memory | **UNMEASURED**: no browser/GPU/real device in workspace | environment-blocked |
+| Docker image build | **UNMEASURED**: no Docker daemon check performed | environment-blocked |
+
+### Baseline P0 findings
+
+1. **The repository's enforced coverage job is red.** This is a real CI break, not an estimated risk. Assertions pass but Vitest exits non-zero because recently added production surfaces are included without enough behavioral coverage.
+2. **Scenario exports can disagree with the screen.** Audit/demand/route sections render scenario-derived rows while CSV and executive JSON export static active-audit data. This violates the export's stated “numbers shown on screen” contract.
+3. **Synthetic telemetry is presented as live.** Source comments identify replayed/randomized fixtures, while visible labels say “Live,” “STREAM ACTIVE,” and current-time timestamps. This violates truth labeling.
+4. **Health provenance is stale.** The package is `3.1.0`; `/api/health` and `.env.example` default to `3.0.0`.
+5. **Calculator inputs are illustrative, but the modal does not disclose its fixed formula assumptions at the point of use.** No formula or reported conclusion will be changed without explicit approval; the safe upgrade is transparent labeling only.
+
+### Revised leverage queue
+
+| Priority | Candidate | L | Decision |
+|---|---|---:|---|
+| P0 | Restore the existing coverage gate with behavioral tests; remove test-only diagnostics without suppressing real errors. | 7.50 | implement |
+| P0 | Make CSV/JSON exports scenario-consistent and regression-test every scenario. | 4.50 | implement |
+| P0 | Relabel replayed events as a telemetry simulation in both languages. | 6.00 | implement |
+| P0 | Derive the health version from package metadata and test the route contract. | 5.00 | implement |
+| P1 | Upgrade calculator/node dialogs to native modal semantics and add keyboard/focus regression coverage. | 2.00 | implement |
+| P1 | Add explicit table/filter empty state and accessible sort state. | 2.40 | implement |
+| P1 | Remove redundant static-asset cache override that adds a Next.js build warning. | 3.60 | implement |
+| P1 | Reconcile README/architecture/version/coverage claims with current measured behavior. | 5.40 | implement after final measurements |
+| P2 | Reduce initial payload. | 0.80 after baseline: high risk with only 3.2 kB budget headroom, but no isolated high-confidence removal yet | defer unless implementation creates a measured opportunity |
+
+## W4/W5 — form directions and Craft Contract
+
+### Divergence
+
+- **Evolved:** retain the industrial control-room identity; make truth state, simulation state, exports, and modal behavior exact and quiet.
+- **Distinctive:** foreground an “evidence rail” on every theatre, exposing provenance and assumptions beside each metric.
+- **Category-defining:** make scenario comparison the primary interaction, with baseline/current/mitigated deltas and exportable audit trails throughout.
+
+**Choice:** Evolved, with one evidence-oriented signature element: explicit simulation/illustrative provenance at the exact controls that generate synthetic output. It best preserves the five-theatre structure and author's conclusions, has the lowest cognitive and regression cost, and fixes the highest-confidence truth failures. The other directions would change the narrative hierarchy and financial interpretation too broadly under the preserve constraints.
+
+### Craft Contract
+
+- **Thesis:** every dramatic signal must remain operationally legible and visibly honest about whether it is measured, illustrative, or simulated.
+- **Audience/job:** an AAST reviewer or logistics decision-maker scans the audit, compares scenarios, exports evidence, and can always reach the same content without 3D.
+- **References:** industrial control-room alarm discipline; aviation-style state labeling; financial-model assumption transparency; WCAG native interaction semantics.
+- **Structure:** preserve the five-stage sequence; make current scenario and provenance unambiguous before adding detail.
+- **Voice:** concise executive English and Arabic, one term per concept, no inflated claims; LTR/RTL parity.
+- **Visual system:** preserve the existing semantic palette, Cairo type family, spacing rhythm, restrained transform/opacity motion, and reduced-motion behavior.
+- **Signature element:** scenario-consistent evidence export—what the operator sees is exactly what leaves the application.
+- **Forbidden:** fake-live language; unlabeled estimates; export/screen divergence; decorative UI additions; new gradients/glass; hidden state; data or conclusion changes.
+
+Baseline quality results, ledger, wave decisions, invariant gates, tribunal, and residual risks continue below.
+
+## W2 — truth, correctness, and interaction stabilization
+
+### Changes shipped
+
+- Made freight, demand, route, warehouse, and executive-report exports derive from the selected scenario. Added scenario, language, export-time, illustrative classification, and bilingual disclosure metadata; non-default scenario filenames are explicit.
+- Replaced stale health-version literals with the package version while preserving a trimmed deployment override; added GET/HEAD, package fallback, database-state, and cache-contract tests.
+- Reframed fixture-driven telemetry as an **audit telemetry simulation** in English and Arabic, disclosed that it is not connected to operational systems, and stopped its interval/audio work while closed.
+- Added point-of-use bilingual calculator assumptions and “illustrative estimate, not a forecast” disclosure to the interactive calculator and handout. Formulas, input bounds, data, and conclusions are unchanged.
+- Derived the audit summary from the rows currently displayed, added a localized empty-filter state, and exposed route-table sort direction with `aria-sort` on all sortable headers.
+- Converted the calculator, node inspector, and keyboard help to native modal dialogs with platform focus containment/Escape behavior, deterministic initial focus, and invoker-focus restoration.
+- Removed the redundant hashed-static cache override that caused the baseline build warning. Next.js remains responsible for immutable hashed-asset caching; API routes remain `no-store`.
+- Replaced noisy/inaccurate jsdom canvas and Next component mocks with deterministic capability and browser-semantic stubs.
+- Expanded behavioral coverage for scenarios, provenance, health, modal lifecycle/focus, telemetry lifecycle, calculator controls, node states, filters, sorting, database lifecycle, derived metrics, and simulation branches. No threshold was lowered and no production branch was special-cased for tests.
+
+### Invariant Gate
+
+| Invariant | Evidence | Result |
+|---|---|---|
+| Project identity and five-stage narrative preserved | No brand, stage, route, headline, or conclusion literals removed; handout and 3D shell remain. | pass |
+| Reported data/formulas preserved | Scenario transforms and calculator formulas are unchanged; tests lock all scenarios and calculator input behavior. | pass |
+| English/Arabic parity preserved | New simulation, provenance, assumption, and empty-state copy is bilingual; localized behavior tests pass. | pass |
+| Existing routes/capabilities preserved | Production build emits the same 9 routes; route probes return 200; CSV/JSON controls remain. | pass |
+| Accessibility/reduced-motion posture not weakened | Native dialogs, focus restoration, `aria-sort`, and explicit non-color status labels added; existing reduced-motion source remains. | pass within available instruments |
+| Security/privacy posture not weakened | Security headers remain present; API cache remains `no-store`; audit reports 0 known vulnerabilities. | pass |
+
+### W2 measured verification
+
+- TypeScript: **0 errors MEASURED**.
+- ESLint: **0 findings MEASURED**.
+- Unit/behavior suite: **201/201 tests passed in 15 files MEASURED**.
+- Coverage gate: statements **89.59% (689/769)**; branches **85.27% (498/584)**; functions **88.71% (228/257)**; lines **92.45% (613/663)** — **MEASURED PASS** against unchanged 80/80/80/85 floors.
+- Production build: **9 routes built MEASURED**, with the baseline cache warning removed.
+- Dependency audit: **0 vulnerabilities MEASURED** across 558 installed packages.
+- Production route probes: `/`, `/handout`, `/api/health`, `/robots.txt`, `/sitemap.xml`, and `/manifest.webmanifest` returned **HTTP 200 MEASURED**; health HEAD returned **204 with no body MEASURED**.
+- Health provenance: production response reports package version **3.1.0 MEASURED** and optional database state `not-configured`.
+- Security probe: CSP, HSTS, frame denial, MIME sniffing denial, referrer, permissions, COOP, and CORP headers remain present **MEASURED**; API cache is `no-store`.
+- Initial shell payload: **202,325 B gzip MEASURED** against the unchanged 205,000 B budget — pass with 2,675 B headroom; this is +600 B versus baseline.
+- Static document: **14,151 B uncompressed MEASURED**, unchanged and below the 40,000 B test ceiling.
+- Playwright request-only static-shell checks: **2/2 passed MEASURED**. Browser-rendered Playwright/axe/frame checks remain environment-blocked by the absent Chromium binary; no product result is inferred.
+
+### W2 wave decision
+
+The 600 B payload increase is accepted: it buys shared native-dialog lifecycle/focus behavior and remains within the pre-existing hard budget. Further bundle surgery is deferred because only 2,675 B of headroom remains and no isolated, low-risk removal was proven. The final wave is documentation reconciliation and same-protocol closeout; no new feature scope is opened.
+
+## W3 — documentation reconciliation and closeout
+
+### Reconciliation
+
+- Corrected README source/test counts, coverage floors/results, shell payload, runtime-boundary language, scroll/focus math, adaptive DPR behavior, security-header count, health payload, and `npm run check` description.
+- Removed obsolete references to an explicit cover-screen CTA/entry gate and documented the actual capability-gated automatic engine load.
+- Added scenario-evidence, simulation-truth, calculator-provenance, and native-dialog contracts to the feature/module maps.
+- Updated the architecture specification from the stale 11-file/161-test state to 15 files/201 tests, corrected the `getSectionFocus` signature and warehouse-bin summary, and distinguished source/unit confirmation from browser checks that were not re-measured.
+- Preserved `docs/UPGRADE.md` as a historical v2 → v3 measurement record, explicitly labeled its `3.0.0` scope, and added a current `3.1.0` V7 addendum instead of silently rewriting old results.
+- Removed one stale source comment claiming an unimplemented Executive Markdown export.
+
+### Final same-protocol comparison
+
+Environment stayed constant: Node **v22.22.3 MEASURED**, npm **10.9.8 MEASURED**. Final `npm ci` again installed 557 packages and audited 558 with 0 vulnerabilities. Deprecation notices for transitive `@esbuild-kit/*` and pinned ESLint 9.39.4 remain; no dependency was changed without compatibility evidence.
+
+| Instrument | Baseline | Final | Delta / verdict |
+|---|---|---|---|
+| TypeScript | 0 errors | 0 errors | preserved, pass |
+| ESLint | 0 findings | 0 findings | preserved, pass |
+| Unit/behavior suite | 185/185 in 14 files | 201/201 in 15 files | +16 tests; pass |
+| Statements | 79.94% (594/743), fail | 89.59% (689/769), pass | **+9.65 pp** |
+| Branches | 77.26% (435/563), fail | 85.27% (498/584), pass | **+8.01 pp** |
+| Functions | 75.60% (189/250), fail | 88.71% (228/257), pass | **+13.11 pp** |
+| Lines | 83.62% (531/635), fail | 92.45% (613/663), pass | **+8.83 pp** |
+| Production build | 9 routes, pass with redundant-cache warning | 9 routes, pass without that warning | improved |
+| Dependency audit | 0 vulnerabilities | 0 vulnerabilities | preserved |
+| Initial shell | 201,725 B gzip | 202,325 B gzip | +600 B (+0.30%); still below 205,000 B |
+| Static HTML | 14,151 B | 14,151 B | unchanged |
+| Health provenance | stale literal `3.0.0` | package-derived `3.1.0` | corrected |
+| Production route/security probes | pass | pass | preserved; API no-store and HEAD 204/body 0 verified |
+| Playwright | 2 request-only pass; 57 browser checks blocked | 2 request-only pass; 57 browser checks blocked | environment unchanged; no browser result claimed |
+
+### Seven-dimension scorecard
+
+Scores are **ESTIMATED expert judgments**, not instrument output. The rubric is 0–10, where 5 is functional but materially exposed, 8 is production-ready with bounded gaps, and 10 requires complete real-environment evidence.
+
+| Dimension | Baseline | Final | Basis |
+|---|---:|---:|---|
+| Correctness | 6.5 | 9.0 | Screen/export divergence and stale health provenance fixed; behavioral coverage is green. |
+| Purpose | 7.5 | 8.8 | Evidence leaving the control room now matches the selected audit scenario. |
+| Robustness | 6.0 | 8.6 | Health/database boundaries, hidden telemetry lifecycle, empty states, and native modal lifecycle are locked by tests. |
+| Efficiency | 8.0 | 8.2 | Closed telemetry does no timer/audio work; payload remains within budget despite a measured +600 B. |
+| Experience | 7.6 | 8.7 | Focus restoration, sort state, empty results, and bilingual point-of-use disclosures improve operation without changing identity. |
+| Maintainability | 6.8 | 8.7 | Shared modal hook, package-derived version, pure selectors, behavior tests, and reconciled docs reduce drift. |
+| Truth | 5.5 | 9.1 | Fake-live language, unlabeled estimates, stale version claims, and scenario-mismatched evidence are corrected. |
+| **Unweighted mean** | **6.8** | **8.7** | ESTIMATED; browser/GPU and human-language evidence cap the final score. |
+
+### Truth classification ledger
+
+**MEASURED**
+
+- Node/npm versions; install/audit counts; type/lint/test/coverage/build results.
+- Gzipped shell payload, static response size, route status codes, health body/version, HEAD body size, API cache policy, and security-header presence.
+- Source/test module and line counts used in reconciled documentation.
+- Two request-only Playwright checks passed; all 57 browser-dependent checks failed before product execution because the configured Chromium executable is absent.
+
+**ESTIMATED**
+
+- Seven-dimension expert scores and qualitative leverage/tribunal judgments.
+- The expected maintenance and operator-comprehension benefit of the selected Evolved direction.
+
+**UNMEASURED**
+
+- Browser-rendered WCAG/axe result for this exact revision; CLS, frame rate, scroll p95, real-device Core Web Vitals, and GPU memory.
+- Docker image build/runtime in a daemon.
+- Native-speaker freight-domain review of Arabic copy.
+- Authorization/licensing status of the preserved institutional mark.
+- Behavior against a real configured PostgreSQL service; unit tests cover lifecycle and error semantics, not an external database.
+
+### Final tribunal
+
+**Proponent.** The upgrade closes every repository-provable P0: the enforced coverage gate is green without relaxed thresholds; exported evidence follows scenario state; simulation and calculator provenance are visible in both languages; package/health versions agree; hidden telemetry stops work; native dialogs and table states are more accessible; the production build, audit, payload budget, routes, and security probes pass.
+
+**Skeptic.** The result is not fully browser-certified in this sandbox. Fifty-seven browser checks—including axe, responsive navigation, modal Escape in a real browser, downloads, CLS, and frame budgets—did not execute because Chromium is absent. Payload headroom is only 2,675 B. CSP retains the documented inline-script exception. The dataset remains illustrative, Arabic remains without domain-native review, and no real database or Docker daemon was exercised.
+
+**Judge.** **Ship the repository upgrade; do not represent it as browser-, device-, database-, or deployment-certified.** The code-level and production-server evidence is materially stronger, all changed behavior is reversible and covered, preserved conclusions are untouched, and the residual gaps are environment/human/provenance constraints rather than hidden product failures. A browser-equipped CI run is the first post-merge requirement.
+
+### Residual risk and deferral register
+
+| Risk / opportunity | Classification | Decision |
+|---|---|---|
+| Run all 59 Playwright/axe/performance checks in browser-equipped CI | UNMEASURED | required next; environment-blocked here after five Chromium CDN failures |
+| Real-device CWV, scroll frame gaps, and GPU memory | UNMEASURED | defer to representative hardware; do not substitute SwiftShader figures |
+| 2,675 B payload-budget headroom | MEASURED | monitor; no speculative bundle surgery without an isolated win |
+| CSP `unsafe-inline` | CONFIRMED residual | retain documented static-prerender trade-off; revisit only with a measured nonce architecture |
+| ESLint and `@esbuild-kit` deprecation notices | MEASURED residual | schedule compatibility-led dependency maintenance; no blind major upgrade |
+| Docker image and real PostgreSQL readiness | UNMEASURED | verify in authorized infrastructure |
+| Arabic domain terminology | UNMEASURED | obtain native freight-domain review |
+| Illustrative dataset / institutional mark | CONFIRMED / UNMEASURED authorization | preserve disclosure; owner must validate data and asset rights before external use |
+
+### Closeout
+
+- W0/W1 checkpoint commit: `89e6e61` (`docs: record v7 recon and measured baseline`).
+- W2 implementation commit: `9e2f6cd` (`feat: align evidence exports and simulation truth`).
+- Working branch: `arena/01a0fe14-logisdata`; no push, deployment, migration, secret access, paid service, or external publication was performed.
+- Documentation reconciliation and this closeout are recorded as the final atomic wave after a clean diff/status review.
+
+---
+
+## V8 continuation — 2026-10-02
+
+### W0/W1 route, assumptions, and checkpoint
+
+- **TARGET inferred:** repository root `/home/user/LOGISDATA`, application unit `LOGISDATA/`; the current clean commit `a563ea4` is the recoverable V8 checkpoint. Arena fixes work to `arena/01a0fe14-logisdata`, so no second branch is created.
+- **Intent/audience/preserve/constraints:** inherited from the still-current operator inference at the top of this log. No repository evidence justifies changing the five-theatre purpose, illustrative conclusions, bilingual identity, or authorization boundary.
+- **Primary domain:** WEB (delivery, interaction, accessibility). **Secondary:** 3D/SPATIAL, DESIGN, DOCS, BACKEND. **Specialist:** Spatial Engine for render-loop invariants only. **Cross-cutting:** TRUTH, ACCESSIBILITY, SECURITY, PERFORMANCE, MAINTAINABILITY. INFRA remains verification-only; DATA-AI, QUANT, GAME, MOBILE-native, and AUDIO-MEDIA are not activated as independent units.
+- **Baseline:** the same-protocol V7 final at checkpoint `a563ea4` is reused because source behavior is unchanged: 201/201 unit tests, coverage 89.59/85.27/88.71/92.45, 9-route build pass, 202,325 B gzip shell, 0 audit findings; 57 browser checks remain environment-blocked. These remain MEASURED checkpoint values, not re-estimates.
+- **V8 leverage queue:** (P0) stop global section shortcuts from stealing Space/arrows from focused controls or operating behind a modal; (P1) complete WAI radio keyboard behavior for scenario selection; (P1) make telemetry paused/filter state truthful, localized, and programmatically exposed; (P1) close remaining visible bilingual chrome gaps; (P2) avoid muted success-tone timeout allocation. Major visual redesign and speculative bundle surgery are rejected: the Evolved Craft Contract remains the strongest fit and payload headroom is narrow.
+
+### W2–W6 implementation and Invariant Gate
+
+- Added a shared keyboard-boundary predicate: handled/modifier/IME events, interactive descendants, and open native dialogs now own their keys before global presentation shortcuts. This fixes the material Space-key conflict on focused buttons and blocks background section movement behind modals.
+- Rebuilt the scenario switcher as a data-driven WAI radio group with one tab stop, arrow wraparound, and Home/End selection; selection still preserves scenario formulas and sound behavior.
+- Made telemetry state exact: running changes to paused visibly and through a live status; bilingual severity filters expose `aria-pressed`; the trigger exposes `aria-expanded`/`aria-controls`.
+- Localized remaining visible theme/audio/node-selector chrome in Arabic, changed the node collection from an unsupported toolbar pattern to a labeled group, and exposed node/calculator/help dialog intent.
+- Muted success events now return before allocating two follow-up timers.
+- Added pure keyboard-boundary tests, expanded scenario/telemetry/audio behavior tests, and added a browser regression for focused-control and modal shortcut isolation.
+
+Invariant Gate: project identity, routes, figures, formulas, scenario transforms, exports, English/Arabic structure, 3D ownership, security policy, and dependency set are unchanged. No cross-boundary file outside the repository target was touched. Build/tests remain green; payload remains bounded.
+
+### W7 final evidence
+
+| Instrument | V8 result | Status |
+|---|---|---|
+| TypeScript / ESLint | 0 errors / 0 findings | PASSED |
+| Unit/behavior suite | 213/213 in 16 files | PASSED |
+| Coverage | 89.78% statements (712/793); 85.83% branches (521/607); 89.57% functions (232/259); 92.55% lines (634/685) | PASSED unchanged floors |
+| Production build | 9 routes | PASSED |
+| Dependency audit | 0 vulnerabilities | PASSED |
+| Initial shell | 202,528 B gzip / 205,000 B | PASSED; +203 B from V7, 2,472 B headroom |
+| Static document | 14,151 B | PASSED; unchanged |
+| Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
+| Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
+
+### Material quality delta
+
+- **Robustness:** global shortcuts could override native control activation and operate behind modals → ownership is explicit and unit-tested.
+- **Experience/accessibility:** click-only custom scenario radios and unlabeled filter selection → WAI keyboard model, roving focus, pressed states, and expanded/controlled relationships.
+- **Truth:** a paused replay still said “SIMULATION RUNNING” → state now says and announces “SIMULATION PAUSED” in both languages.
+- **Efficiency:** muted optimized events allocated two timers → zero success-sequence timers while muted, locked by test.
+- **Maintainability:** three duplicated scenario controls and scattered keyboard exclusions → one option registry and one tested boundary predicate.
+
+### V8 tribunal, rejection, and residuals
+
+- **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
+- **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
+- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,472 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
+- **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index c9eb679..4865160 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -16,17 +16,17 @@ This document is written to be **sufficient to rebuild the application from scra
 | Framework | Next.js 16.3.7, App Router, Turbopack |
 | UI runtime | React 19.2.6 |
 | 3D | three ^0.185 · @react-three/fiber ^9.7 · @react-three/drei ^10.7 |
-| Animation | framer-motion ^12.43 (deck only — **not** the cover) |
+| Animation | framer-motion ^12.43 (deferred control-room bundle; the cover is archived and not shipped) |
 | Styling | Tailwind CSS 4.1 (CSS-first `@theme`) + a hand-written design layer in `globals.css` |
 | Data layer | drizzle-orm + `pg`, lazily instantiated and entirely optional |
 | Language | TypeScript 5.9, `strict` |
 | Runtime floor | Node.js 22 (`engines`, `.nvmrc`) |
-| Source size | ~4,300 lines under `src/`, ~1,700 lines under `tests/` |
+| Source size | 53 TypeScript/TSX modules / 7,016 lines under `src/`, plus 3,138 CSS lines; 22 TypeScript/TSX test modules / 2,349 lines (measured 2026-10-02) |
 
 **Definition of success** (the measurable contract this build is held to):
 
 1. A visitor on any device gets the full audit content — WebGL or not, motion or not, English or Arabic.
-2. The cover screen never pays for the 3D runtime.
+2. The static shell and no-WebGL fallback never request the deferred 3D runtime.
 3. Scene state and document state are provably the same state (locked by tests, not by eyeballing).
 4. Every quality property — types, lint, unit, e2e, accessibility, payload, dependency security — is machine-enforced in CI.
 
@@ -67,7 +67,7 @@ This document is written to be **sufficient to rebuild the application from scra
 └─────────────────────────┘                            └──────────────────────────┘
 ```
 
-**CONFIRMED.** `Presentation.tsx` is the sole importer of `three`, `@react-three/fiber`, `@react-three/drei` and `framer-motion` on the `/` route, and it is loaded through `next/dynamic` with `ssr: false`.
+**CONFIRMED.** `Presentation.tsx` is the deferred root for the module graph that imports Three.js, React Three Fiber, drei, and Framer Motion on `/`; `PresentationShell` loads that root through `next/dynamic` with `ssr: false`.
 
 There is **no cover screen**: the deck opens directly in the control room. The shell still holds the loader until the capability probe has run, so a device without WebGL is shown the text fallback without ever requesting the 1 MB 3D chunk. `tests/e2e/smoke.spec.ts` asserts that the server-rendered document stays a small static shell (< 40 kB, no `WebGLRenderer`), and `tests/e2e/performance.spec.ts` enforces the total JavaScript ceiling for the route.
 
@@ -90,12 +90,13 @@ export function pagePositionFromOffset(offset: number): number {
 ```ts
 // lib/sceneFocus.ts
 export const FOCUS_SPREAD = 1.08;
-export function getSectionFocus(pagePosition: number, index: number): number {
-  const distance = Math.abs(pagePosition - index);
-  return Math.max(0, 1 - distance / FOCUS_SPREAD);  // 1 at the section, 0 away
+export function getSectionFocus(scrollOffset: number, index: number): number {
+  const pagePosition = pagePositionFromOffset(scrollOffset);
+  const distance = Math.abs(pagePosition - clampSectionIndex(index));
+  return clamp01(1 - distance / FOCUS_SPREAD);  // 1 at the section, 0 away
 }
-export function getActiveSectionIndex(pagePosition: number): number {
-  return clampSectionIndex(Math.round(pagePosition));
+export function getActiveSectionIndex(scrollOffset: number): number {
+  return clampSectionIndex(Math.round(pagePositionFromOffset(scrollOffset)));
 }
 ```
 
@@ -161,14 +162,14 @@ This replaced three `useEffect`-into-`setState` patterns that the React 19 `reac
 
 ### 2.5 Data and derived metrics
 
-**CONFIRMED.** `lib/data.ts` holds typed bilingual literals (`{ en, ar }` for every string). `lib/metrics.ts` derives every headline number **once at module scope**, so no component recomputes a sum during render:
+**CONFIRMED.** `lib/data.ts` holds typed bilingual literals (`{ en, ar }` for every string). `lib/metrics.ts` computes the default summaries once at module scope and exports pure selectors for scenario-derived rows; components memoize scenario/filter calculations rather than recomputing them per animation frame:
 
 | Selector | Value in the shipped dataset |
 |---|---|
 | `auditSummary` | 5 rows, 3 flagged (60%), 4,032 km billed vs 3,898 actual, 134 km unverified |
 | `demandSummary` | peak amplification 3.45×, post-audit 1.45×, 81.6% distortion removed |
 | `routeSummary` | total optimised savings $1,822,000; worst region Gulf distribution (14.2% mileage waste) |
-| `warehouseSummary` | 4 zones audited, accuracy and mismatch counts derived from the zone rows |
+| `warehouseSummary` | 42 bins, 12 mismatches, 30 audited (71.43% accuracy), all derived from the bin rows |
 
 `selectors.summariseAudit` / `summariseDemand` **throw** on an empty input rather than returning `NaN` or `0` — a silent zero in an audit deck is worse than a crash. **CONFIRMED** by `tests/unit/metrics.test.ts`.
 
@@ -202,7 +203,7 @@ All verified against a running production server.
 
 ## 4. Interaction specification
 
-**CONFIRMED** (`tests/e2e/navigation.spec.ts`):
+**CONFIRMED by source and unit behavior; browser flows are encoded in `tests/e2e/navigation.spec.ts`:**
 
 | Input | Result |
 |---|---|
@@ -216,22 +217,26 @@ All verified against a running production server.
 | `?` | Open the shortcut dialog (native `<dialog>`) |
 | `Esc` | Close the dialog |
 
-Shortcuts are ignored while focus is inside an input or a `contenteditable` region.
+Global section/theme/language/help shortcuts are ignored when an event is already handled, uses Alt/Ctrl/Meta, belongs to IME composition, originates inside any interactive control, or a native modal dialog is open. This prevents Space from becoming “next section” when it should activate a focused button and prevents section travel behind a modal. Scenario radios implement the WAI keyboard model: one tab stop, arrows with wraparound, and Home/End.
 
 Deep linking is bidirectional: the hash seeds the initial scroll offset on load, and scrolling rewrites the hash with `history.replaceState` (no history spam).
 
+The keyboard-help sheet, recovery calculator, and node inspector use native `<dialog>` modality through `useNativeDialog`. Opening moves focus to the labelled close control; platform close/Escape calls the controlled-state callback; unmount restores focus to the invoker. The telemetry drawer is not modal and remains mounted to preserve its filter state, but starts no interval and emits no audio while closed.
+
 ### Export
 
-`lib/export.ts` emits RFC 4180 CSV (CRLF rows, quotes doubled, fields containing `"`/`,`/newline quoted) for four datasets — `freight-audit`, `demand-signal`, `route-intelligence`, `warehouse-control` — named `logisdata-<dataset>-<lang>-<YYYY-MM-DD>.csv`. Each `DatasetExport` button carries `data-dataset="<id>"` as a stable e2e hook.
+`lib/export.ts` emits RFC 4180 CSV (CRLF rows, quotes doubled, fields containing `"`/`,`/newline quoted) for four datasets—`freight-audit`, `demand-signal`, `route-intelligence`, `warehouse-control`. Rows derive from the active scenario. Active-audit filenames retain the backward-compatible `logisdata-<dataset>-<lang>-<YYYY-MM-DD>.csv` form; baseline and mitigated exports include the scenario before the language. The executive JSON report includes export time, language, scenario, `illustrative-simulation` classification, bilingual disclosure, scenario-derived summaries, and the rows for all five theatres. Each `DatasetExport` button carries `data-dataset="<id>"` as a stable e2e hook.
 
 ## 5. Accessibility specification
 
-**CONFIRMED** (`tests/e2e/accessibility.spec.ts` runs axe-core against WCAG 2.1 A + AA on the cover, the handout in both languages, and the control room):
+**CONFIRMED by source and unit behavior.** `tests/e2e/accessibility.spec.ts` is configured to run axe-core against WCAG 2.1 A + AA on the entry shell, the handout in both languages, and the control room. In the 2026-10-02 V8 run, browser-rendered checks were not re-measured because Chromium was unavailable; 2 request-only Playwright checks passed and 58 browser-dependent checks were blocked before product execution.
 
 - Skip link (`#presentation-content` on `/`, `#handout-main` on `/handout`) as the first focusable element; the target carries `tabIndex={-1}` so focus actually lands there.
 - Each section is `<section id="section-<slug>" aria-labelledby="<slug>-title">`; Hero's heading is the page `h1`, the rest are `h2`.
 - A `role="status"` live region announces the active section on change.
-- The nav exposes `role="progressbar"` with a correct `aria-valuenow`.
+- The nav exposes `role="progressbar"` with a correct `aria-valuenow`; sortable route headers expose `aria-sort`, and empty audit filters produce a localized table row.
+- Scenario selection uses a roving radio group with arrow/Home/End behavior; telemetry filters expose pressed state and localized labels, while running/paused simulation state is announced truthfully.
+- Calculator, inspector, and keyboard-help overlays are native modal dialogs with deterministic initial focus and invoker-focus restoration.
 - The canvas is `aria-hidden`; every number it visualises also exists as text or a table.
 - 3D labels below 5% focus get `visibility: hidden` and `aria-hidden="true"`, so screen readers never read four invisible scenes at once.
 - Reduced motion resolves counters to their final value immediately — the information is never gated behind an animation.
@@ -264,13 +269,14 @@ Cross-Origin-Resource-Policy: same-origin
 ```text
 npm run typecheck ──▶ tsc --noEmit (strict, includes tests)
 npm run lint      ──▶ eslint (next/core-web-vitals, react-hooks)
-npm run test      ──▶ vitest · 11 files · 161 tests · jsdom
-                      └ coverage thresholds: 85% lines, 80% stmt/fn/branch
-npm run test:e2e  ──▶ playwright · 3 projects
+npm run test      ──▶ vitest · 16 files · 213 tests · jsdom
+npm run test:coverage
+                   └▶ floors: 85% lines, 80% statements/functions/branches
+npm run test:e2e  ──▶ playwright · 60 checks · 3 projects
                       ├ desktop-chromium : all specs
                       ├ reduced-motion   : accessibility + handout
                       └ mobile (Pixel 7) : handout + smoke
-npm run budget    ──▶ gzip-measured cover payload vs a hard ceiling
+npm run budget    ──▶ gzip-measured initial shell vs 205,000 B hard ceiling
 npm audit         ──▶ fails on high/critical
 ```
 
@@ -279,6 +285,6 @@ npm audit         ──▶ fails on high/critical
 ## 8. Known limitations
 
 1. **CONFIRMED.** `script-src 'unsafe-inline'` remains, for the reason in §6.
-2. **CONFIRMED.** three.js is ~1.0 MB raw / ~250 KB gzipped. It is fully deferred behind the entry gate, but visitors who enter the control room do pay it. Lighter alternatives were rejected: they would change the deliverable.
+2. **CONFIRMED.** Three.js is a large deferred dependency. It sits behind the dynamic import and WebGL capability gate, but capable clients load it automatically because there is no cover-screen CTA. Lighter alternatives were rejected because they would change the deliverable.
 3. **CONFIRMED.** The figures are illustrative, not measured. See the data policy in the README.
 4. **INFERRED — PROBABLE.** The Arabic translations are presentation-grade but have not been reviewed by a domain-expert native speaker; terminology in the freight-audit table is the most likely place for a correction.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 2eb07bb..7b7ed0c 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -1,7 +1,9 @@
 # v2 → v3 — Audit, Upgrade and Verification Report
 
+> **Historical scope.** Sections 1–6 preserve the measured v2 → v3 record and its then-current package target (`3.0.0`). The current package is `3.1.0`; the 2026-10-02 V7 and V8 hardening results are summarized in §7–8 and recorded in full in [`UPGRADE_LOG.md`](../UPGRADE_LOG.md).
+
 Baseline: commit `9ae5a8a` ("LOGISDATA Supply Chain Control Room", package version 2.0.0).
-Target: this branch, package version 3.0.0.
+Historical target: the v3 branch at package version 3.0.0.
 
 > Follow-up hardening on this branch removes the remaining drei HTML portals / React 19
 > second-root failure mode. The readable deck now renders in the main React tree
@@ -61,7 +63,7 @@ Fixed by making one function the single source of truth (`pagePositionFromOffset
 1. **`/handout` — the deck as a readable document.** A statically prerendered, printable, screen-reader-first version of the entire audit: three data tables with captions and row headers, the warehouse findings, a table of contents and print styles. This is also what no-WebGL and reduced-motion visitors are pointed to. It makes the content crawlable and citable, which a canvas never is.
 2. **CSV export of every dataset on screen.** RFC 4180 output (CRLF, correct quoting), localised, date-stamped filenames. An audit deck whose numbers cannot leave the slide is not an audit deck.
 3. **Full keyboard control and deep linking.** Arrows / Page / Space / Home / End / `1`–`5` / `T` / `L` / `?`, a native `<dialog>` shortcut sheet, and bidirectional hash deep links so any section can be shared.
-4. **Ambient data-stream field — the visual upgrade.** 900 / 420 / 0 GPU-animated points (tier-dependent) drifting through the scene in **one draw call**, with all motion in a vertex shader so the CPU does nothing per frame. Off entirely under reduced motion. It reads as live telemetry moving through the facility rather than decoration.
+4. **Ambient data-stream field — the visual upgrade.** 900 / 420 / 0 GPU-animated points (tier-dependent) drifting through the scene in **one draw call**, with all motion in a vertex shader so the CPU does nothing per frame. Off entirely under reduced motion. It reads as a simulated operational signal moving through the facility rather than decoration; the current UI labels fixture telemetry explicitly as a simulation.
 5. **Adaptive quality tiering.** dpr clamp, antialiasing and particle budget all derived from cores / memory / viewport / Save-Data / connection type.
 6. **Theme and language persistence**, applied before first paint so neither flashes.
 
@@ -231,3 +233,48 @@ npm run test:e2e
 7. **Verifying the Docker image builds and runs.** *Reason:* no Docker daemon in this sandbox. The Dockerfile follows the documented Next.js standalone pattern and the build step it depends on (`NEXT_OUTPUT=standalone`) was exercised locally, but the image itself is unbuilt.
 
 Everything else that was identified has been implemented.
+
+---
+
+## 7. v3.1 V7 hardening addendum — 2026-10-02
+
+This addendum supersedes historical test counts and current-state claims above without rewriting the v2 → v3 measurement record.
+
+### Shipped
+
+- Scenario-selected freight, demand, route, warehouse, and executive evidence exports; executive JSON includes export time, language, scenario, illustrative classification, bilingual disclosure, summaries, and theatre rows.
+- Explicit bilingual fixture-simulation telemetry labels; the closed drawer schedules no interval and plays no audio.
+- Point-of-use bilingual calculator assumptions and “illustrative, not a forecast” disclosure, with formulas and reported conclusions unchanged.
+- Package-derived health version with optional deployment override; tested GET, HEAD, database-state, and no-store behavior.
+- Native modal lifecycle for calculator, node inspector, and keyboard help; deterministic initial focus and invoker-focus restoration.
+- Scenario/filter-derived audit summaries, localized empty results, and `aria-sort` on every sortable route header.
+- Removal of the redundant `/_next/static` cache override; Next.js owns immutable hashed-asset caching.
+
+### Current measured state
+
+| Gate | 2026-10-02 result |
+|---|---|
+| Package | `3.1.0` |
+| TypeScript / ESLint | 0 errors / 0 findings |
+| Unit suite | 201/201 passing in 15 files |
+| Coverage | 89.59% statements · 85.27% branches · 88.71% functions · 92.45% lines |
+| Production build | 9 routes, pass, no baseline cache warning |
+| Initial shell budget | 202,325 B gzip / 205,000 B, pass |
+| Static document | 14,151 B uncompressed, pass against 40,000 B ceiling |
+| Dependency audit | 0 known vulnerabilities across 558 installed packages |
+| Production probes | `/`, `/handout`, health, robots, sitemap, manifest: HTTP 200; health HEAD: 204 |
+| Playwright | 2/2 request-only checks pass; 57 browser checks unmeasured because Chromium is absent and CDN installation failed with `ECONNRESET` |
+
+The complete inference ledger, same-protocol baseline/final comparison, invariant gates, truth classifications, tribunal, and residual risks live in [`UPGRADE_LOG.md`](../UPGRADE_LOG.md).
+
+## 8. V8 interaction-boundary addendum — 2026-10-02
+
+V8 retained the visual system and corrected keyboard/state semantics that became visible after the native-dialog upgrade:
+
+- global section shortcuts now yield to focused controls, handled/modifier/IME events, and open modals, so Space activates a focused button instead of navigating and section keys cannot operate behind a dialog;
+- scenario selection now implements roving radio focus with arrow wraparound and Home/End;
+- telemetry running/paused state is truthful and announced, severity filters are bilingual and expose `aria-pressed`, and the drawer trigger exposes expanded/controlled state;
+- remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
+- muted success events no longer allocate follow-up audio timers.
+
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,528 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.

From 60dd09f80b53d26c548f8f7971d09ea23dc917e2 Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:22:36 +0000
Subject: [PATCH 2/6] fix: stabilize responsive browser interactions

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 LOGISDATA/src/app/globals.css               | 24 ++++++++++++++++++---
 LOGISDATA/src/components/Presentation.tsx   | 17 ++++++++++++++-
 LOGISDATA/src/components/ui/AudioToggle.tsx |  1 +
 LOGISDATA/tests/e2e/accessibility.spec.ts   | 19 +++++++++-------
 LOGISDATA/tests/e2e/navigation.spec.ts      |  1 +
 README.md                                   |  4 ++--
 UPGRADE_LOG.md                              |  4 ++--
 docs/UPGRADE.md                             |  2 +-
 8 files changed, 55 insertions(+), 17 deletions(-)

diff --git a/LOGISDATA/src/app/globals.css b/LOGISDATA/src/app/globals.css
index 632a962..9534532 100644
--- a/LOGISDATA/src/app/globals.css
+++ b/LOGISDATA/src/app/globals.css
@@ -1401,9 +1401,20 @@ button:focus-visible {
   unicode-bidi: isolate;
 }
 
-@media (max-width: 1180px) {
-  .brand-lockup,
-  .navigation-actions { min-width: 160px; }
+@media (max-width: 2100px) {
+  .navigation-actions { min-width: auto; }
+  .navigation-actions .control-button {
+    flex: 0 0 32px;
+    justify-content: center;
+    width: 32px;
+    padding: 0;
+  }
+  .navigation-actions .control-button > span { display: none; }
+}
+
+@media (max-width: 1700px) {
+  .top-navigation { padding-right: 20px; padding-left: 20px; }
+  .brand-lockup { min-width: 160px; }
   .section-nav { gap: 7px; }
   .section-nav-button { font-size: 0.55rem; }
   .section-nav-button span:last-child { display: none; }
@@ -1431,6 +1442,13 @@ button:focus-visible {
 }
 
 @media (max-width: 600px) {
+  .brand-text { display: none; }
+  .navigation-actions { gap: 3px; }
+  .navigation-actions .control-button {
+    flex-basis: 30px;
+    width: 30px;
+    min-height: 30px;
+  }
   .presentation-section { min-height: 690px; }
   .section-inner { padding: 91px 38px 30px 16px; }
   [dir="rtl"] .section-inner { padding-right: 16px; padding-left: 38px; }
diff --git a/LOGISDATA/src/components/Presentation.tsx b/LOGISDATA/src/components/Presentation.tsx
index 834273c..198fc05 100644
--- a/LOGISDATA/src/components/Presentation.tsx
+++ b/LOGISDATA/src/components/Presentation.tsx
@@ -145,6 +145,7 @@ export function Presentation() {
   const [canvasGeneration, setCanvasGeneration] = useState(0);
   const [scrollHost, setScrollHost] = useState<HTMLElement | null>(null);
   const contextCleanupRef = useRef<(() => void) | null>(null);
+  const rootRef = useRef<HTMLDivElement | null>(null);
 
   const scrollElement = useRef<HTMLDivElement | null>(null);
   const scrollHostRef = useRef<HTMLElement | null>(null);
@@ -311,9 +312,12 @@ export function Presentation() {
       }
     };
 
+    const root = rootRef.current;
     document.addEventListener("visibilitychange", onVisibilityChange);
     window.addEventListener("keydown", onKeyDown);
+    root?.setAttribute("data-interactive", "true");
     return () => {
+      root?.removeAttribute("data-interactive");
       document.removeEventListener("visibilitychange", onVisibilityChange);
       window.removeEventListener("keydown", onKeyDown);
     };
@@ -357,6 +361,7 @@ export function Presentation() {
 
   return (
     <motion.div
+      ref={rootRef}
       className="presentation-root"
       data-theme={theme}
       data-tier={device.tier}
@@ -415,6 +420,7 @@ export function Presentation() {
             className={`control-button ${telemetryOpen ? "btn-active-glow" : ""}`}
             onClick={() => setTelemetryOpen((v) => !v)}
             aria-label={t("telemetryToggle", language)}
+            title={t("telemetryToggle", language)}
             aria-controls="telemetry-panel"
             aria-expanded={telemetryOpen}
           >
@@ -428,6 +434,7 @@ export function Presentation() {
             className="control-button"
             onClick={() => setCalculatorOpen(true)}
             aria-label={t("calculatorOpen", language)}
+            title={t("calculatorOpen", language)}
             aria-haspopup="dialog"
           >
             <Calculator size={15} aria-hidden="true" />
@@ -450,7 +457,12 @@ export function Presentation() {
           <AudioToggle language={language} />
 
           {/* Handout View Link */}
-          <a className="control-button" href="/handout">
+          <a
+            className="control-button"
+            href="/handout"
+            aria-label={t("openHandout", language)}
+            title={t("openHandout", language)}
+          >
             <FileText size={15} aria-hidden="true" />
             <span>{t("openHandout", language)}</span>
           </a>
@@ -461,6 +473,7 @@ export function Presentation() {
             type="button"
             onClick={() => setHelpOpen(true)}
             aria-label={t("shortcuts", language)}
+            title={t("shortcuts", language)}
             aria-haspopup="dialog"
           >
             <Keyboard size={15} aria-hidden="true" />
@@ -473,6 +486,7 @@ export function Presentation() {
             type="button"
             onClick={toggleLanguage}
             aria-label={text(presentationCopy.nav.language, language)}
+            title={text(presentationCopy.nav.language, language)}
           >
             <Languages size={15} aria-hidden="true" />
             <span>{language === "en" ? "AR" : "EN"}</span>
@@ -484,6 +498,7 @@ export function Presentation() {
             type="button"
             onClick={toggleTheme}
             aria-label={text(presentationCopy.nav.theme, language)}
+            title={text(presentationCopy.nav.theme, language)}
             aria-pressed={theme === "light"}
           >
             {theme === "dark" ? <Sun size={15} aria-hidden="true" /> : <Moon size={15} aria-hidden="true" />}
diff --git a/LOGISDATA/src/components/ui/AudioToggle.tsx b/LOGISDATA/src/components/ui/AudioToggle.tsx
index c85dedb..cd6f4c0 100644
--- a/LOGISDATA/src/components/ui/AudioToggle.tsx
+++ b/LOGISDATA/src/components/ui/AudioToggle.tsx
@@ -24,6 +24,7 @@ export function AudioToggle({ language }: AudioToggleProps) {
       className={`control-button audio-toggle-btn ${enabled ? "audio-on" : ""}`}
       onClick={handleToggle}
       aria-label={enabled ? t("soundOn", language) : t("soundOff", language)}
+      title={enabled ? t("soundOn", language) : t("soundOff", language)}
       aria-pressed={enabled}
     >
       {enabled ? <Volume2 size={15} aria-hidden="true" /> : <VolumeX size={15} aria-hidden="true" />}
diff --git a/LOGISDATA/tests/e2e/accessibility.spec.ts b/LOGISDATA/tests/e2e/accessibility.spec.ts
index 98961cf..aa6c30a 100644
--- a/LOGISDATA/tests/e2e/accessibility.spec.ts
+++ b/LOGISDATA/tests/e2e/accessibility.spec.ts
@@ -1,11 +1,17 @@
 import AxeBuilder from "@axe-core/playwright";
-import { expect, test } from "@playwright/test";
+import { expect, test, type Page } from "@playwright/test";
 
 const WCAG = ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"];
 
+async function enterControlRoom(page: Page) {
+  await page.goto("/");
+  await expect(page.locator("canvas")).toBeVisible({ timeout: 30_000 });
+  await expect(page.locator(".presentation-root")).toHaveAttribute("data-interactive", "true");
+}
+
 test.describe("accessibility", () => {
   test("the control room entry has no WCAG 2.1 AA violations", async ({ page }) => {
-    await page.goto("/");
+    await enterControlRoom(page);
     const results = await new AxeBuilder({ page }).withTags(WCAG).analyze();
     expect(results.violations).toEqual([]);
   });
@@ -22,8 +28,7 @@ test.describe("accessibility", () => {
   });
 
   test("the control room has no WCAG 2.1 AA violations outside the canvas", async ({ page }) => {
-    await page.goto("/");
-    await expect(page.locator("canvas")).toBeVisible({ timeout: 30_000 });
+    await enterControlRoom(page);
     const results = await new AxeBuilder({ page })
       .withTags(WCAG)
       // The WebGL canvas itself cannot be audited; its content is mirrored
@@ -56,15 +61,13 @@ test.describe("accessibility", () => {
 
   test("reduced-motion visitors still get a complete, static deck", async ({ page }) => {
     await page.emulateMedia({ reducedMotion: "reduce" });
-    await page.goto("/");
-    await expect(page.locator("canvas")).toBeVisible({ timeout: 30_000 });
+    await enterControlRoom(page);
     // Metric counters must be at their final value immediately, not at 0.
     await expect(page.locator(".metric-counter-value").first()).not.toHaveText(/^\$?0(\.0)?/);
   });
 
   test("the active section is announced to assistive technology", async ({ page }) => {
-    await page.goto("/");
-    await expect(page.locator("canvas")).toBeVisible({ timeout: 30_000 });
+    await enterControlRoom(page);
     const status = page.locator("[role='status'][aria-live='polite']").first();
     await expect(status).toContainText("Hidden cost");
     await page.keyboard.press("End");
diff --git a/LOGISDATA/tests/e2e/navigation.spec.ts b/LOGISDATA/tests/e2e/navigation.spec.ts
index c172d61..f49c249 100644
--- a/LOGISDATA/tests/e2e/navigation.spec.ts
+++ b/LOGISDATA/tests/e2e/navigation.spec.ts
@@ -4,6 +4,7 @@ import { expect, test, type Page } from "@playwright/test";
 async function enterControlRoom(page: Page, url = "/") {
   await page.goto(url);
   await expect(page.locator("canvas")).toBeVisible({ timeout: 30_000 });
+  await expect(page.locator(".presentation-root")).toHaveAttribute("data-interactive", "true");
 }
 
 test.describe("section navigation", () => {
diff --git a/README.md b/README.md
index 1913f3b..bda0174 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
 | **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
 | **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
-| **Initial shell payload** | 202,528 B gzip | measured against the 205,000 B production budget |
+| **Initial shell payload** | 202,616 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
 ---
@@ -414,7 +414,7 @@ curl -s localhost:3000/api/health | jq
 | `npm run test` | 213 Vitest tests in 16 files | ✅ |
 | `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
 | `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
-| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,528 B | ✅ |
+| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,616 B | ✅ |
 | `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
 ---
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
index 22bd027..9df3b68 100644
--- a/UPGRADE_LOG.md
+++ b/UPGRADE_LOG.md
@@ -327,7 +327,7 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 | Coverage | 89.78% statements (712/793); 85.83% branches (521/607); 89.57% functions (232/259); 92.55% lines (634/685) | PASSED unchanged floors |
 | Production build | 9 routes | PASSED |
 | Dependency audit | 0 vulnerabilities | PASSED |
-| Initial shell | 202,528 B gzip / 205,000 B | PASSED; +203 B from V7, 2,472 B headroom |
+| Initial shell | 202,616 B gzip / 205,000 B | PASSED; +291 B from V7, 2,384 B headroom |
 | Static document | 14,151 B | PASSED; unchanged |
 | Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
 | Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
@@ -344,6 +344,6 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 
 - **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
 - **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
-- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,472 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,384 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
 - **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
 - **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 7b7ed0c..0f3e7ab 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -277,4 +277,4 @@ V8 retained the visual system and corrected keyboard/state semantics that became
 - remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
 - muted success events no longer allocate follow-up audio timers.
 
-Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,528 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,616 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.

From 8b4ed2ca98754f13d2749021ccb885761a4c320e Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:28:14 +0000
Subject: [PATCH 3/6] fix: keep shortcut navigation aligned with scroll intent

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 LOGISDATA/src/components/Presentation.tsx | 20 ++++++++++++++++----
 README.md                                 |  4 ++--
 UPGRADE_LOG.md                            |  4 ++--
 docs/UPGRADE.md                           |  2 +-
 4 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/LOGISDATA/src/components/Presentation.tsx b/LOGISDATA/src/components/Presentation.tsx
index 198fc05..2e010fe 100644
--- a/LOGISDATA/src/components/Presentation.tsx
+++ b/LOGISDATA/src/components/Presentation.tsx
@@ -180,6 +180,10 @@ export function Presentation() {
       };
 
       const sync = () => {
+        // Content can expand without resizing the scroll viewport, so refresh
+        // scrollHeight on every native scroll rather than trusting an earlier
+        // ResizeObserver snapshot.
+        measure();
         const metrics = scrollMetricsRef.current;
         setActiveSection(
           sectionFromScrollTop(element.scrollTop, metrics.scrollHeight, metrics.clientHeight),
@@ -189,7 +193,6 @@ export function Presentation() {
       const observer =
         typeof ResizeObserver === "function"
           ? new ResizeObserver(() => {
-              measure();
               sync();
             })
           : null;
@@ -246,7 +249,11 @@ export function Presentation() {
       pendingSection.current = index;
       return;
     }
-    const metrics = scrollMetricsRef.current;
+    const metrics = {
+      scrollHeight: element.scrollHeight,
+      clientHeight: element.clientHeight,
+    };
+    scrollMetricsRef.current = metrics;
     const targetTop = scrollTopForSection(index, metrics.scrollHeight, metrics.clientHeight);
     element.scrollTo({ top: targetTop, behavior: "smooth" });
     const targetHash = hashFromSectionIndex(index);
@@ -293,9 +300,14 @@ export function Presentation() {
 
       let destination: number | null = null;
       const element = scrollElement.current;
-      const from = element
+      // The hash records the latest requested destination synchronously,
+      // while smooth scrolling may still be moving through intermediate
+      // offsets. Prefer that intent so rapid repeated arrows advance once per
+      // press instead of requesting the same section again.
+      const requestedSection = sectionIndexFromHash(window.location.hash);
+      const from = requestedSection ?? (element
         ? sectionFromScrollTop(element.scrollTop, element.scrollHeight, element.clientHeight)
-        : (pendingSection.current ?? activeSection);
+        : (pendingSection.current ?? activeSection));
 
       if (NEXT_KEYS.has(event.key)) destination = from + 1;
       else if (PREV_KEYS.has(event.key)) destination = from - 1;
diff --git a/README.md b/README.md
index bda0174..9fc7997 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
 | **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
 | **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
-| **Initial shell payload** | 202,616 B gzip | measured against the 205,000 B production budget |
+| **Initial shell payload** | 202,619 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
 ---
@@ -414,7 +414,7 @@ curl -s localhost:3000/api/health | jq
 | `npm run test` | 213 Vitest tests in 16 files | ✅ |
 | `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
 | `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
-| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,616 B | ✅ |
+| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,619 B | ✅ |
 | `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
 ---
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
index 9df3b68..a58e40f 100644
--- a/UPGRADE_LOG.md
+++ b/UPGRADE_LOG.md
@@ -327,7 +327,7 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 | Coverage | 89.78% statements (712/793); 85.83% branches (521/607); 89.57% functions (232/259); 92.55% lines (634/685) | PASSED unchanged floors |
 | Production build | 9 routes | PASSED |
 | Dependency audit | 0 vulnerabilities | PASSED |
-| Initial shell | 202,616 B gzip / 205,000 B | PASSED; +291 B from V7, 2,384 B headroom |
+| Initial shell | 202,619 B gzip / 205,000 B | PASSED; +294 B from V7, 2,381 B headroom |
 | Static document | 14,151 B | PASSED; unchanged |
 | Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
 | Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
@@ -344,6 +344,6 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 
 - **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
 - **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
-- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,384 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,381 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
 - **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
 - **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 0f3e7ab..3f4045f 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -277,4 +277,4 @@ V8 retained the visual system and corrected keyboard/state semantics that became
 - remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
 - muted success events no longer allocate follow-up audio timers.
 
-Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,616 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,619 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.

From 0c8f320d5bb303b96c42629e9facc8bc53218a07 Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:33:04 +0000
Subject: [PATCH 4/6] fix: keep global shortcut listener stable

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 LOGISDATA/src/components/Presentation.tsx | 24 +++++++++++++++++------
 README.md                                 |  4 ++--
 UPGRADE_LOG.md                            |  4 ++--
 docs/UPGRADE.md                           |  2 +-
 4 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/LOGISDATA/src/components/Presentation.tsx b/LOGISDATA/src/components/Presentation.tsx
index 2e010fe..96f6e7c 100644
--- a/LOGISDATA/src/components/Presentation.tsx
+++ b/LOGISDATA/src/components/Presentation.tsx
@@ -146,6 +146,9 @@ export function Presentation() {
   const [scrollHost, setScrollHost] = useState<HTMLElement | null>(null);
   const contextCleanupRef = useRef<(() => void) | null>(null);
   const rootRef = useRef<HTMLDivElement | null>(null);
+  const activeSectionRef = useRef(activeSection);
+  const toggleLanguageRef = useRef(toggleLanguage);
+  const toggleThemeRef = useRef(toggleTheme);
 
   const scrollElement = useRef<HTMLDivElement | null>(null);
   const scrollHostRef = useRef<HTMLElement | null>(null);
@@ -185,9 +188,13 @@ export function Presentation() {
         // ResizeObserver snapshot.
         measure();
         const metrics = scrollMetricsRef.current;
-        setActiveSection(
-          sectionFromScrollTop(element.scrollTop, metrics.scrollHeight, metrics.clientHeight),
+        const nextSection = sectionFromScrollTop(
+          element.scrollTop,
+          metrics.scrollHeight,
+          metrics.clientHeight,
         );
+        activeSectionRef.current = nextSection;
+        setActiveSection(nextSection);
       };
 
       const observer =
@@ -262,6 +269,11 @@ export function Presentation() {
     }
   }, []);
 
+  useEffect(() => {
+    toggleLanguageRef.current = toggleLanguage;
+    toggleThemeRef.current = toggleTheme;
+  }, [toggleLanguage, toggleTheme]);
+
   useEffect(() => {
     const onHashChange = () => {
       const target = sectionIndexFromHash(window.location.hash);
@@ -289,12 +301,12 @@ export function Presentation() {
       }
       if (event.key.toLowerCase() === "t") {
         event.preventDefault();
-        toggleTheme();
+        toggleThemeRef.current();
         return;
       }
       if (event.key.toLowerCase() === "l") {
         event.preventDefault();
-        toggleLanguage();
+        toggleLanguageRef.current();
         return;
       }
 
@@ -307,7 +319,7 @@ export function Presentation() {
       const requestedSection = sectionIndexFromHash(window.location.hash);
       const from = requestedSection ?? (element
         ? sectionFromScrollTop(element.scrollTop, element.scrollHeight, element.clientHeight)
-        : (pendingSection.current ?? activeSection));
+        : (pendingSection.current ?? activeSectionRef.current));
 
       if (NEXT_KEYS.has(event.key)) destination = from + 1;
       else if (PREV_KEYS.has(event.key)) destination = from - 1;
@@ -333,7 +345,7 @@ export function Presentation() {
       document.removeEventListener("visibilitychange", onVisibilityChange);
       window.removeEventListener("keydown", onKeyDown);
     };
-  }, [activeSection, goToSection, toggleLanguage, toggleTheme]);
+  }, [goToSection]);
 
   const frameloop = !pageVisible ? "never" : reduced ? "demand" : "always";
   const progress = SECTION_COUNT > 1 ? activeSection / (SECTION_COUNT - 1) : 1;
diff --git a/README.md b/README.md
index 9fc7997..f98a09c 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
 | **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
 | **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
-| **Initial shell payload** | 202,619 B gzip | measured against the 205,000 B production budget |
+| **Initial shell payload** | 202,613 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
 ---
@@ -414,7 +414,7 @@ curl -s localhost:3000/api/health | jq
 | `npm run test` | 213 Vitest tests in 16 files | ✅ |
 | `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
 | `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
-| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,619 B | ✅ |
+| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,613 B | ✅ |
 | `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
 ---
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
index a58e40f..727a3eb 100644
--- a/UPGRADE_LOG.md
+++ b/UPGRADE_LOG.md
@@ -327,7 +327,7 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 | Coverage | 89.78% statements (712/793); 85.83% branches (521/607); 89.57% functions (232/259); 92.55% lines (634/685) | PASSED unchanged floors |
 | Production build | 9 routes | PASSED |
 | Dependency audit | 0 vulnerabilities | PASSED |
-| Initial shell | 202,619 B gzip / 205,000 B | PASSED; +294 B from V7, 2,381 B headroom |
+| Initial shell | 202,613 B gzip / 205,000 B | PASSED; +288 B from V7, 2,387 B headroom |
 | Static document | 14,151 B | PASSED; unchanged |
 | Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
 | Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
@@ -344,6 +344,6 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 
 - **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
 - **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
-- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,381 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,387 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
 - **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
 - **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 3f4045f..6ae7171 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -277,4 +277,4 @@ V8 retained the visual system and corrected keyboard/state semantics that became
 - remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
 - muted success events no longer allocate follow-up audio timers.
 
-Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,619 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,613 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.

From 04c2c400e38e73232fa80c25f77dec1685f29be7 Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:37:24 +0000
Subject: [PATCH 5/6] fix: preserve navigation intent before scroll startup

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 LOGISDATA/src/components/Presentation.tsx | 11 +++++++----
 README.md                                 |  4 ++--
 UPGRADE_LOG.md                            |  4 ++--
 docs/UPGRADE.md                           |  2 +-
 4 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/LOGISDATA/src/components/Presentation.tsx b/LOGISDATA/src/components/Presentation.tsx
index 96f6e7c..2fb8548 100644
--- a/LOGISDATA/src/components/Presentation.tsx
+++ b/LOGISDATA/src/components/Presentation.tsx
@@ -251,8 +251,15 @@ export function Presentation() {
   const goToSection = useCallback((targetIndex: number) => {
     sound.playClick();
     const index = clampSectionIndex(targetIndex);
+    const targetHash = hashFromSectionIndex(index);
+    if (window.location.hash !== targetHash) {
+      window.history.replaceState(null, "", targetHash);
+    }
+
     const element = scrollElement.current;
     if (!element) {
+      // Preserve the operator's intent during the short WebGL/scroll bridge
+      // startup window; onScrollReady consumes this destination.
       pendingSection.current = index;
       return;
     }
@@ -263,10 +270,6 @@ export function Presentation() {
     scrollMetricsRef.current = metrics;
     const targetTop = scrollTopForSection(index, metrics.scrollHeight, metrics.clientHeight);
     element.scrollTo({ top: targetTop, behavior: "smooth" });
-    const targetHash = hashFromSectionIndex(index);
-    if (window.location.hash !== targetHash) {
-      window.history.replaceState(null, "", targetHash);
-    }
   }, []);
 
   useEffect(() => {
diff --git a/README.md b/README.md
index f98a09c..bda0174 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
 | **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
 | **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
-| **Initial shell payload** | 202,613 B gzip | measured against the 205,000 B production budget |
+| **Initial shell payload** | 202,616 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
 ---
@@ -414,7 +414,7 @@ curl -s localhost:3000/api/health | jq
 | `npm run test` | 213 Vitest tests in 16 files | ✅ |
 | `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
 | `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
-| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,613 B | ✅ |
+| `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,616 B | ✅ |
 | `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
 ---
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
index 727a3eb..9df3b68 100644
--- a/UPGRADE_LOG.md
+++ b/UPGRADE_LOG.md
@@ -327,7 +327,7 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 | Coverage | 89.78% statements (712/793); 85.83% branches (521/607); 89.57% functions (232/259); 92.55% lines (634/685) | PASSED unchanged floors |
 | Production build | 9 routes | PASSED |
 | Dependency audit | 0 vulnerabilities | PASSED |
-| Initial shell | 202,613 B gzip / 205,000 B | PASSED; +288 B from V7, 2,387 B headroom |
+| Initial shell | 202,616 B gzip / 205,000 B | PASSED; +291 B from V7, 2,384 B headroom |
 | Static document | 14,151 B | PASSED; unchanged |
 | Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
 | Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
@@ -344,6 +344,6 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 
 - **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
 - **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
-- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,387 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,384 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
 - **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
 - **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 6ae7171..0f3e7ab 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -277,4 +277,4 @@ V8 retained the visual system and corrected keyboard/state semantics that became
 - remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
 - muted success events no longer allocate follow-up audio timers.
 
-Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,613 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,616 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.

From 097777c8b0e4c8ecb73626c925d95917b5c201df Mon Sep 17 00:00:00 2001
From: YASLOGIST <265797509+YASLOGIST@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:41:03 +0000
Subject: [PATCH 6/6] docs: record complete browser CI verification

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 README.md            | 6 +++---
 UPGRADE_LOG.md       | 7 ++++---
 docs/ARCHITECTURE.md | 4 ++--
 docs/UPGRADE.md      | 2 +-
 4 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index bda0174..9b1c73a 100644
--- a/README.md
+++ b/README.md
@@ -41,8 +41,8 @@
 | **Initial JS on first paint** | zero Three.js | the engine is code-split and loaded only once the device is known to support WebGL |
 | **Runtime data fetches** | 0 on the critical path | the domain model is typed, static and tree-shaken |
 | **Database** | optional | the presentation is fully functional with no `DATABASE_URL` |
-| **Source surface** | 53 TypeScript/TSX modules (7,016 lines) + 3,138 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
-| **Automated coverage** | 213 passing unit tests + 60 configured Playwright checks | unit gates pass locally; browser checks run when Chromium is available |
+| **Source surface** | 53 TypeScript/TSX modules (7,059 lines) + 3,156 lines of tokenized CSS | measured from `src/` on 2026-10-02 |
+| **Automated coverage** | 213 passing unit tests + 60 passing Playwright checks | unit gates pass locally; the complete browser suite passes in CI |
 | **Initial shell payload** | 202,616 B gzip | measured against the 205,000 B production budget |
 | **Known vulnerabilities** | 0 (`npm audit`) | pinned toolchain plus an `esbuild` override |
 
@@ -413,7 +413,7 @@ curl -s localhost:3000/api/health | jq
 | `npm audit` | Dependency advisories (currently **0**) | ✅ |
 | `npm run test` | 213 Vitest tests in 16 files | ✅ |
 | `npm run test:coverage` | 80% statements/branches/functions and 85% lines; current measured result 89.78% / 85.83% / 89.57% / 92.55% | ✅ |
-| `npm run test:e2e` | 60 configured Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ when browser is available |
+| `npm run test:e2e` | 60 Playwright checks across desktop, reduced-motion and mobile—including axe accessibility and performance budgets; requires Chromium | ✅ 60/60 in CI |
 | `npm run budget` | Gzipped landing payload against a 205,000 B ceiling; current measured result 202,616 B | ✅ |
 | `npm run check` | Types, lint, unit tests, and production build in sequence | ✅ |
 
diff --git a/UPGRADE_LOG.md b/UPGRADE_LOG.md
index 9df3b68..a23f9d2 100644
--- a/UPGRADE_LOG.md
+++ b/UPGRADE_LOG.md
@@ -315,6 +315,7 @@ Scores are **ESTIMATED expert judgments**, not instrument output. The rubric is
 - Localized remaining visible theme/audio/node-selector chrome in Arabic, changed the node collection from an unsupported toolbar pattern to a labeled group, and exposed node/calculator/help dialog intent.
 - Muted success events now return before allocating two follow-up timers.
 - Added pure keyboard-boundary tests, expanded scenario/telemetry/audio behavior tests, and added a browser regression for focused-control and modal shortcut isolation.
+- Browser-equipped PR CI exposed narrow-header overflow and startup races between shortcut intent and the async scroll bridge. Compact responsive controls, a stable interactivity marker/listener, fresh scroll geometry, and synchronous hash intent closed those defects; the final browser run passed 60/60 without retries.
 
 Invariant Gate: project identity, routes, figures, formulas, scenario transforms, exports, English/Arabic structure, 3D ownership, security policy, and dependency set are unchanged. No cross-boundary file outside the repository target was touched. Build/tests remain green; payload remains bounded.
 
@@ -330,7 +331,7 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 | Initial shell | 202,616 B gzip / 205,000 B | PASSED; +291 B from V7, 2,384 B headroom |
 | Static document | 14,151 B | PASSED; unchanged |
 | Routes / health / security | six production routes probed at 200; health HEAD 204/body 0; CSP/HSTS/frame/MIME/no-store present | PASSED |
-| Playwright | 60 configured: 2 request-only pass, 58 browser-dependent launch failures | BLOCKED by absent Chromium before product execution |
+| Playwright | 60/60 across desktop Chromium, reduced-motion, and mobile; functional, axe, download, layout-shift, and frame checks included | PASSED in browser-equipped PR CI |
 
 ### Material quality delta
 
@@ -344,6 +345,6 @@ Invariant Gate: project identity, routes, figures, formulas, scenario transforms
 
 - **Target user/domain master:** keyboard operation now follows control intent; audit scenarios and telemetry state are more legible without changing the narrative or data.
 - **Principal architect/efficiency:** the two small shared structures justify their measured +202 B shell cost; no dependency or new asset was added.
-- **Risk/hostile review:** the newly configured browser regression could not execute here, nor could axe, responsive, download, or real frame tests. The 2,384 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
+- **Risk/hostile review:** all configured browser checks now pass in CI, but representative-device CWV/GPU behavior remains unmeasured and the 2,384 B shell headroom is narrow. Existing CSP, Arabic-review, Docker, database, asset-rights, and illustrative-data residuals remain as recorded above.
 - **Owner judgment:** ship this bounded continuation. Rejected: visual redesign, native-input restyling, dependency churn, and speculative bundle surgery; each carried more regression risk than demonstrated value.
-- **Next moves:** run all 60 Playwright checks in browser-equipped CI; measure representative-device CWV/frame behavior; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
+- **Next moves:** measure representative-device CWV/GPU behavior; exercise Docker and real PostgreSQL readiness; obtain authorized Arabic/domain and asset review. No other high-confidence local work exceeds preservation value.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 4865160..703f638 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -21,7 +21,7 @@ This document is written to be **sufficient to rebuild the application from scra
 | Data layer | drizzle-orm + `pg`, lazily instantiated and entirely optional |
 | Language | TypeScript 5.9, `strict` |
 | Runtime floor | Node.js 22 (`engines`, `.nvmrc`) |
-| Source size | 53 TypeScript/TSX modules / 7,016 lines under `src/`, plus 3,138 CSS lines; 22 TypeScript/TSX test modules / 2,349 lines (measured 2026-10-02) |
+| Source size | 53 TypeScript/TSX modules / 7,059 lines under `src/`, plus 3,156 CSS lines; 22 TypeScript/TSX test modules / 2,353 lines (measured 2026-10-02) |
 
 **Definition of success** (the measurable contract this build is held to):
 
@@ -229,7 +229,7 @@ The keyboard-help sheet, recovery calculator, and node inspector use native `<di
 
 ## 5. Accessibility specification
 
-**CONFIRMED by source and unit behavior.** `tests/e2e/accessibility.spec.ts` is configured to run axe-core against WCAG 2.1 A + AA on the entry shell, the handout in both languages, and the control room. In the 2026-10-02 V8 run, browser-rendered checks were not re-measured because Chromium was unavailable; 2 request-only Playwright checks passed and 58 browser-dependent checks were blocked before product execution.
+**MEASURED in browser-equipped CI.** `tests/e2e/accessibility.spec.ts` runs axe-core against WCAG 2.1 A + AA on the entry shell, the handout in both languages, and the control room. On 2026-10-02, all 60 configured Playwright checks passed across desktop Chromium, reduced-motion, and mobile projects, including functional, accessibility, download, layout-shift, and frame-budget checks.
 
 - Skip link (`#presentation-content` on `/`, `#handout-main` on `/handout`) as the first focusable element; the target carries `tabIndex={-1}` so focus actually lands there.
 - Each section is `<section id="section-<slug>" aria-labelledby="<slug>-title">`; Hero's heading is the page `h1`, the rest are `h2`.
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index 0f3e7ab..148498b 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -277,4 +277,4 @@ V8 retained the visual system and corrected keyboard/state semantics that became
 - remaining visible theme, audio, and node-inspection chrome is localized; node triggers announce their dialog behavior;
 - muted success events no longer allocate follow-up audio timers.
 
-Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,616 B gzip** against the unchanged 205,000 B shell budget. Playwright now defines 60 checks: 2 request-only checks pass here and 58 browser checks remain blocked by the absent Chromium executable.
+Measured final state: **213/213 unit tests in 16 files**, coverage **89.78% statements / 85.83% branches / 89.57% functions / 92.55% lines**, 9-route production build pass, 0 audit findings, and **202,616 B gzip** against the unchanged 205,000 B shell budget. All **60/60 Playwright checks pass in browser-equipped CI** across desktop Chromium, reduced-motion, and mobile projects; local browser execution remains unavailable because the Chromium CDN resets connections in this sandbox.