Keep the central KeyLoad mark sharp as native SVG

Author: KSemenenko

AGENTS.md

@@ -408,6 +408,7 @@ For changes outside existing owner authorization, obtain direction before changi
 - KeyLoad's visual style is serious, adult Apple-style Liquid Glass in the Managed Code family: editorial off-white surfaces, bold black typography and Managed Code's pastel iridescent accent (peach → lilac → periwinkle), plus Prostir graphite. Do not use green or lime as the brand accent, and do not return to the rejected light-blue look. No Material Design, colour blobs, rainbow logos or playful decoration. The `/admin` console and the public site share it (owner direction 2026-10-02).
 - The public landing must be a radically better product page for KeyLoad as the database for AI agents, on .NET and Orleans. Its Three.js scene must be live and moving as soon as it loads, except under reduced-motion preferences, within the scene lifecycle, budget and honesty contracts.
 - Every public KeyLoad page ends with "Developed by Managed Code" and a normal followed (dofollow) link to https://www.managed-code.com/.
+- The central KeyLoad K MUST use the canonical true SVG outside the bounded 3D raster buffer so it stays sharp on Retina displays. An SVG wrapper around a bitmap or a CanvasTexture logo does not satisfy this requirement (repeated owner correction 2026-10-03).
 ### Dislikes
 - Repeated permission questions for already authorized work.
 - Fake production readiness, power-loss claims from process-kill tests, or unsupported performance supremacy.

docs/Features/BenchmarkComparisons/VectorAssets.md

@@ -1,18 +1,19 @@
 # BenchmarkComparisons vector assets
 
 Continuation of [BenchmarkComparisons](../BenchmarkComparisons.md), existing
-REQ-BC-012/013/016/017/025/029. [Acceptance](../../../vector-assets.acceptance.md)
-is the precise AC-VEC-001..005 test matrix; [plan](../../../vector-assets.plan.md)
-records task ownership, ordered checks and evidence. Decision: ADR-053 vector
-repair continuation; no database/public API/persistence boundary changes.
+REQ-BC-012/013/016/017/025/029. The acceptance matrix below is the durable contract;
+the ignored root vector-assets acceptance/plan files retain local task planning.
+Decision: [ADR-053](../../ADR/ADR-053-unified-visual-identity.md) vector repair
+continuation and [ADR-040](../../ADR/ADR-040-static-site-threejs-evidence.md) manual
+visual review; no database/public API/persistence boundary changes.
 
 - REQ-VEC-001 → AC-VEC-001: replace the raster-in-SVG poster with real geometry.
 - REQ-VEC-002 → AC-VEC-002/003: project the canonical vector logo outside the
   bounded GPU buffer and keep it subordinate to scene lifecycle.
 - REQ-VEC-003 → AC-VEC-004/005: retain resource, accessibility, brand, real build,
   provenance and GitHub-only qualification contracts.
 
-Slice ownership: site/Features/BenchmarkComparisons owns HTML, poster, scene
+Slice ownership: site/Features/BenchmarkComparisons owns HTML, desktop/mobile posters, scene
 geometry/lifecycle/observer and CSS; tests/KeyLoad.SiteTests/Features/BenchmarkComparisons
 owns actual-source XML and real Chrome assertions. Shared favicon remains the
 unchanged byte-identical mirror of the AdminDashboard canonical logo. Backend,
@@ -30,9 +31,23 @@ flowchart LR
 ```
 
 Tests must reject raster/executable/external poster payloads and exercise real
-ready/resize/pointer/reduced-motion/offscreen/restoration flows at DPR2. Full
+ready/resize/pointer/reduced-motion/offscreen/restoration flows at DPR2.
+An actual favicon404 keeps the poster; both mobile and desktop retain all model cards.
+The complete
 GitHub SiteTests, native coverage, parity/build and existing renderer assertions
 remain mandatory. Design judgment uses the existing ADR-040 manual exception;
 static builds and screenshots do not establish GitHub qualification/publication.
 Keep source and measured revisions separate. Rollback restores the coherent
 presentation source, never archived reports or database formats.
+
+| Acceptance | Pass/fail contract | Verification |
+|---|---|---|
+| AC-VEC-001 | Both posters contain true SVG paths/text, the canonical K geometry and all eight model labels. Embedded raster, executable/external content or clipped mobile models fails. | SiteVectorAssetTests validates actual XML, local references, labels and canonical path attributes; ADR-040 manual desktop/mobile review judges fitting and sharpness. |
+| AC-VEC-002 | Exactly one decorative live image loads the unchanged favicon outside the GPU buffer, with contained central bounds and projected CSS sizing. Missing, duplicated, unloaded or oversized rasterized logo fails. | Real Chrome ready/pointer/resize assertions at DPR2; manual sharpness review. |
+| AC-VEC-003 | Loading/no-JS/error/zero-size/offscreen/disposed retains the poster and hides the live image; ready shows the loaded SVG. Favicon404 never reaches ready. Pause/reduced motion/restoration preserves the lifecycle. | Existing real browser lifecycle flow, Retina resize/pose checks and SiteVectorAssetBrowserTests actual HTTP404 failure. Hardware device-loss qualification remains open. |
+| AC-VEC-004 | Existing DPR1.5/1M-pixel/30-draw/5K-triangle budgets, movement, accessibility and responsive overflow bounds hold. | Existing real renderer/responsive assertions plus recorded manual GPU observations. |
+| AC-VEC-005 | The real builder emits both posters and canonical assets with unchanged brand parity and benchmark provenance. | Complete SiteTests, source/output byte parity, native coverage and Pages gates in GitHub at the exact source revision. |
+
+GitHub-only TUnit/MTP qualification remains required for every automated criterion.
+The [implementation evidence](../../implementation/vector-assets.json) records
+development checks and manual preview separately from the blocked publication.

docs/implementation/vector-assets.json

@@ -0,0 +1,95 @@
+{
+  "schemaVersion": 1,
+  "scope": "BenchmarkComparisons vector assets",
+  "sourceBaseRevision": "9b3bd8ed64b42e7e3bd37d454face7984dfc6b5f",
+  "workingTree": true,
+  "requirements": [
+    "REQ-VEC-001",
+    "REQ-VEC-002",
+    "REQ-VEC-003"
+  ],
+  "acceptance": "vector-assets.acceptance.md",
+  "plan": "vector-assets.plan.md",
+  "sourceHashes": {
+    "site/favicon.svg": "7d93c0d681b1b2a0c29708bcf6055242b8d57d3931282ef11a203ed5988ce459",
+    "src/KeyLoad.Server/Features/AdminDashboard/Assets/logo.svg": "7d93c0d681b1b2a0c29708bcf6055242b8d57d3931282ef11a203ed5988ce459",
+    "site/Features/BenchmarkComparisons/assets/cluster-poster.svg": "ef787a7eaec235cf47aa240dc64239eccccfb3a503aefd857367867fd2af8ac0",
+    "site/Features/BenchmarkComparisons/assets/cluster-poster-mobile.svg": "68e303d0b94e0471926bfdb416f590cb053b88a8c3cbdf4f191a792e5521bfb9",
+    "site/Features/BenchmarkComparisons/scene-geometry.mjs": "5db7511e529813f466012a8edc7ebe7ac9e3f8b96371525c3fba81da36c8ebf1",
+    "site/Features/BenchmarkComparisons/scene-lifecycle.mjs": "60ecc385a394b963be18c09a9e14e9756bdbf304927463f1a133d03d012996fa"
+  },
+  "developmentChecks": {
+    "siteTestsBuild": {
+      "exitCode": 0,
+      "warnings": 0,
+      "errors": 0,
+      "log": "/private/tmp/keyload-vector-build-verified.log"
+    },
+    "scopedFormat": {
+      "exitCode": 0,
+      "log": "/private/tmp/keyload-vector-format-verified.log"
+    },
+    "javascriptSyntax": "passed",
+    "staticGovernance": {
+      "exitCode": 0,
+      "log": "/private/tmp/keyload-vector-governance.log"
+    },
+    "localTestsExecuted": false
+  },
+  "manualPreview": {
+    "qualification": false,
+    "mode": "local_preview",
+    "measuredSource": "9c570f8c33a7a9667507a8e1c0ca68860de3be45",
+    "measuredRun": "https://github.com/managedcode/KeyLoad/actions/runs/36926803549",
+    "javascriptGzipBytes": 40804,
+    "cssGzipBytes": 9700,
+    "devices": [
+      {
+        "width": 1440,
+        "dpr": 2,
+        "backend": "webgpu",
+        "bufferPixels": 999044,
+        "drawCalls": 18,
+        "triangles": 35,
+        "markLoaded": true,
+        "svg": "/favicon.svg",
+        "contained": true,
+        "overflow": false
+      },
+      {
+        "width": 390,
+        "dpr": 2,
+        "backend": "webgpu",
+        "bufferPixels": 226884,
+        "drawCalls": 18,
+        "triangles": 35,
+        "markLoaded": true,
+        "svg": "/favicon.svg",
+        "contained": true,
+        "overflow": false
+      }
+    ],
+    "noJavascriptMobilePoster": "cluster-poster-mobile.svg",
+    "desktopScreenshot": "/private/tmp/keyload-vector-final-preview.png",
+    "mobileNoJavascriptScreenshot": "/private/tmp/keyload-vector-mobile-no-js.png"
+  },
+  "gitHubQualification": {
+    "state": "blocked_before_site_checkout",
+    "runId": 37112008157,
+    "sourceRevision": "9b3bd8ed64b42e7e3bd37d454face7984dfc6b5f",
+    "runUrl": "https://github.com/managedcode/KeyLoad/actions/runs/37112008157",
+    "artifactId": 11270013705,
+    "artifactName": "site-qualification-9b3bd8ed64b42e7e3bd37d454face7984dfc6b5f-1",
+    "reason": "Isolated Pages GitHub evidence rejected.",
+    "siteTestsExecuted": false,
+    "nativeCoverageQualified": false,
+    "published": false
+  },
+  "acceptanceState": {
+    "AC-VEC-001": "source and manual preview implemented; GitHub tests pending",
+    "AC-VEC-002": "source and DPR2 manual preview implemented; GitHub browser tests pending",
+    "AC-VEC-003": "source and manual fallback implemented; real HTTP404 regression written but unexecuted",
+    "AC-VEC-004": "development checks and manual renderer budgets pass; GitHub gates pending",
+    "AC-VEC-005": "publication blocked by rejected isolated evidence"
+  }
+}

site/Features/BenchmarkComparisons/assets/cluster-poster-mobile.svg

@@ -18,7 +18,8 @@ const BUILD = Object.freeze({
     'isolated-report-validation.mjs', 'isolated-http.mjs', 'isolated-loader.mjs',
     'isolated-measurements.mjs', 'isolated-view.mjs', 'isolated-controls.mjs', 'isolated-lab.mjs', 'contracts.mjs', 'bootstrap.mjs', 'measurements.mjs', 'measurement-loader.mjs',
     'benchmark-lab.mjs', 'benchmark-chart.mjs', 'benchmark-profiles.mjs', 'cluster-scene.mjs',
-    'scene-geometry.mjs', 'scene-lifecycle.mjs', 'scene-observers.mjs', 'styles.css', 'brand.css', 'tokens.css', 'scene.css', 'assets/cluster-poster.svg'],
+    'scene-geometry.mjs', 'scene-lifecycle.mjs', 'scene-observers.mjs', 'styles.css', 'brand.css', 'tokens.css', 'scene.css',
+    'assets/cluster-poster.svg', 'assets/cluster-poster-mobile.svg'],
   vendorFiles: ['three.webgpu.js', 'three.core.js', 'LICENSE'],
   vendorHashes: ['15cfce5c653541704fd9a3463c39d3e8b854bb6265ccd854d7cfe74090625cc6',
     '9edde002b066a9a05676a6127f67735b62baf399bdea529f2f7e31657da769e6',

site/Features/BenchmarkComparisons/build-site.mjs

@@ -48,7 +48,10 @@ <h1 id="page-title">The database <span class="h1-break">for <span class="kl-mark
       </div>
       <figure class="stage" aria-labelledby="scene-caption">
         <div class="scene-frame" id="cluster-scene" aria-label="Conceptual view of one engine holding every data shape an agent needs">
-          <img class="cluster-poster" src="./Features/BenchmarkComparisons/assets/cluster-poster.svg" alt="Conceptual illustration: cards for SQL, documents, graphs, events, vectors, queues, time series and blobs circle one KeyLoad engine.">
+          <picture>
+            <source media="(max-width: 760px)" srcset="./Features/BenchmarkComparisons/assets/cluster-poster-mobile.svg">
+            <img class="cluster-poster" src="./Features/BenchmarkComparisons/assets/cluster-poster.svg" alt="Conceptual illustration: cards for SQL, documents, graphs, events, vectors, queues, time series and blobs circle one KeyLoad engine.">
+          </picture>
           <img class="cluster-core" src="./favicon.svg" alt="" aria-hidden="true" hidden>
           <span class="scene-status" data-scene-status role="status">Static illustration.</span>
         </div>