Document the program evidence visual system

docs/assets/screenshots/PROVENANCE.txt

@@ -2,11 +2,18 @@ Screenshot provenance
 =====================
 
 All screenshots below are rendered from OpenAdapt's own tooling in local /
-mock mode. None are mocked-up or hand-drawn. Each capture that shows product
-chrome is a byte-identical copy of a file in OpenAdaptAI/openadapt-web, which
-owns the published visual record for every OpenAdapt surface;
+mock mode. None are mocked-up or hand-drawn.
+
+Most captures that show product chrome are byte-identical copies of a file in
+OpenAdaptAI/openadapt-web, which owns the published visual record. The four
+program-view captures are the exception: openadapt-web publishes those surfaces
+as live components rather than as stills, so these are captured here and their
+entry names the upstream repository and commit instead.
+
 docs/assets/visual-palette.json records the measured dominant colours of every
-image on this site.
+image on this site, and tests/test_design_tokens.py refuses a warm ground. An
+image on a retired palette is not something a reader can see, so a capture from
+a build that predates the palette move is caught by measurement or not at all.
 
 program-graph-cloud.png
   The compiled-program visualizer in the OpenAdapt Cloud workspace
@@ -18,6 +25,36 @@ program-graph-cli.png
   visualizer) for the OpenEMR showcase bundle, headless-Chrome capture of the
   self-contained page. Used on concepts/program-visualizer.md.
 
+program-state-live-relation.png
+  The public synthetic Program State Console in openadapt-web at the final
+  event of its exact retained trace. It compares synthetic recorded and current
+  frames. Used on concepts/program-visualizer.md. SHA-256:
+  676f0e57c4a19a490d4c9ee9bfccaecfb44dfe99d83febf24fc4f00c2fc1ae13.
+
+program-workbench-cloud.png
+  The public-safe Program map in openadapt-cloud local mock mode. The graph
+  contains exact emitted edges and generic synthetic labels. Used on
+  concepts/program-visualizer.md. SHA-256:
+  0f77308464f618efcb04814b411eb322af779699d33298ea9f0e57f7edab6d6e.
+
+program-workbench-cli.png
+  A public-synthetic openadapt-flow HTML export for a loop program. The page is
+  self-contained and was captured in a local browser. Used on
+  concepts/program-visualizer.md. SHA-256:
+  aa5ff1e1455b0444f234f398e3f645490b974c3b48c5e38156fd041964fec4d2.
+
+program-workbench-desktop.png
+  The development-only OpenAdapt Desktop preview that renders the production
+  qualification workbench with a public synthetic graph. It has no bound live
+  trace. Captured at 1440x1000 with Playwright Chromium from
+  http://localhost:1421/?surface=program-workbench-preview, against `npm run
+  dev` in OpenAdaptAI/openadapt-desktop at exact commit
+  ebc10b037533f7adc0b12e0664d718d373245108. That is the first commit carrying
+  the canonical design tokens, which matters: the first version of this capture
+  came from a build before that merge and grounded on the retired #f2f1ed.
+  Used on concepts/program-visualizer.md. SHA-256:
+  4fbc62dd9ee5b48f758aca0ed5a13e072b3e0a4b6fc391847202297673f12e3f.
+
 workflow-catalog.png
   The workflow catalog and step-level halt map in the OpenAdapt Cloud
   workspace, headless-Chrome capture in local mock mode. Used on
@@ -36,11 +73,11 @@ settings-governance.png
 
 dashboard-overview.png
   The /dashboard overview of the OpenAdapt Cloud workspace at exact commit
-  021a9caf99a6832bff9f32e14b1b34d42ec2e290, captured at 2560x1440 with
+  ee84df868c56f099f14c3c5cb39c1eef724ba762, captured at 2560x1440 with
   Playwright Chromium through openadapt-cloud scripts/capture-public-previews.mjs
   against the local Cloud mock UI. The runtime-mode banner and the account chip
   are hidden during capture because both report the environment the capture ran
   in, not the product. The fixture is synthetic OpenEMR patient registration.
   Byte-identical source: OpenAdaptAI/openadapt-web,
   public/product-preview/dashboard-workflows.png. SHA-256:
-  f9f894a60e44b266f16b8d138d8747e1a1fb639bf92370db6adbf4d4aab5bde4.
+  d93431712b5b36addf77fb5600e8b5f208291b80776940c1c76f9c7b4f6b4679.

docs/assets/visual-palette.json

@@ -28,13 +28,13 @@
     "screenshots/dashboard-overview.png": {
       "source_repository": "OpenAdaptAI/openadapt-web",
       "source_path": "public/product-preview/dashboard-workflows.png",
-      "sha256": "f9f894a60e44b266f16b8d138d8747e1a1fb639bf92370db6adbf4d4aab5bde4",
+      "sha256": "d93431712b5b36addf77fb5600e8b5f208291b80776940c1c76f9c7b4f6b4679",
       "width": 2560,
       "height": 1440,
       "dominant_colors": [
         {
           "hex": "#ffffff",
-          "share_percent": 46.48
+          "share_percent": 46.49
         },
         {
           "hex": "#f5f7fa",
@@ -216,6 +216,94 @@
           "share_percent": 11.5
         }
       ]
+    },
+    "screenshots/program-state-live-relation.png": {
+      "source_repository": "OpenAdaptAI/openadapt-web",
+      "source_path": null,
+      "note": "The public-synthetic Program State Console, captured for these docs rather than vendored: openadapt-web publishes the component, not a still of it. The console is built from the canonical tokens, so its ground is cool by construction.",
+      "sha256": "676f0e57c4a19a490d4c9ee9bfccaecfb44dfe99d83febf24fc4f00c2fc1ae13",
+      "width": 1440,
+      "height": 1000,
+      "dominant_colors": [
+        {
+          "hex": "#f6f7fb",
+          "share_percent": 23.08
+        },
+        {
+          "hex": "#f9fafc",
+          "share_percent": 7.55
+        },
+        {
+          "hex": "#0c1220",
+          "share_percent": 3.92
+        }
+      ]
+    },
+    "screenshots/program-workbench-cloud.png": {
+      "source_repository": "OpenAdaptAI/openadapt-cloud",
+      "source_path": null,
+      "note": "The remote-safe Program map in Cloud local mock mode, captured for these docs. The workbench canvas is the canonical dark inset, which is why the dominant colour is #0c1220 rather than a page ground.",
+      "sha256": "0f77308464f618efcb04814b411eb322af779699d33298ea9f0e57f7edab6d6e",
+      "width": 1280,
+      "height": 720,
+      "dominant_colors": [
+        {
+          "hex": "#0c1220",
+          "share_percent": 19.7
+        },
+        {
+          "hex": "#f6f7fb",
+          "share_percent": 13.78
+        },
+        {
+          "hex": "#121a27",
+          "share_percent": 11.0
+        }
+      ]
+    },
+    "screenshots/program-workbench-cli.png": {
+      "source_repository": "OpenAdaptAI/openadapt-flow",
+      "source_path": null,
+      "note": "A self-contained `openadapt flow visualize` HTML export. It is generated output rather than product chrome, and its ground is plain white.",
+      "sha256": "aa5ff1e1455b0444f234f398e3f645490b974c3b48c5e38156fd041964fec4d2",
+      "width": 1280,
+      "height": 720,
+      "dominant_colors": [
+        {
+          "hex": "#ffffff",
+          "share_percent": 26.46
+        },
+        {
+          "hex": "#0c1220",
+          "share_percent": 14.34
+        },
+        {
+          "hex": "#131b28",
+          "share_percent": 9.43
+        }
+      ]
+    },
+    "screenshots/program-workbench-desktop.png": {
+      "source_repository": "OpenAdaptAI/openadapt-desktop",
+      "source_path": null,
+      "note": "The development-only qualification workbench preview at ?surface=program-workbench-preview, captured at 1440x1000 from openadapt-desktop ebc10b037533f7adc0b12e0664d718d373245108, which is the first commit carrying the canonical tokens (its #139). The first capture came from a build before that merge and grounded on the retired #f2f1ed.",
+      "sha256": "4fbc62dd9ee5b48f758aca0ed5a13e072b3e0a4b6fc391847202297673f12e3f",
+      "width": 1440,
+      "height": 1000,
+      "dominant_colors": [
+        {
+          "hex": "#f5f7fa",
+          "share_percent": 35.05
+        },
+        {
+          "hex": "#ffffff",
+          "share_percent": 13.71
+        },
+        {
+          "hex": "#0b1220",
+          "share_percent": 11.29
+        }
+      ]
     }
   }
 }