Distinguish main matches from related suggestions and ship 0.1.9

docs/MEDIA-FINAL-QUALITY.md

@@ -134,3 +134,26 @@ Existing image evidence and video scene sampling are retained. Spoken timing
 and recovery are recorded separately in SPEECH-FINAL-QUALITY.md. Media remains
 usable with explicit limits; this bounded pass does not invent a new overall
 quality rating or extend the agreed release scope.
+
+## 0.1.9: primary matches and related suggestions
+
+The frozen shared-engine presentation rule now keeps weaker semantic neighbors
+under expandable **Related suggestions** instead of promoting every nearest
+neighbor as a primary match. It preserves exact filename/keyword matches and
+access to lower-scoring genuine sources. See [semantic evidence](SEMANTIC-EVIDENCE.md)
+for the frozen policy and [blind results](../fixtures/absence-v3/evaluation-summary.json).
+
+Actual Google CPU evaluation covered all 36 assets without extraction or
+semantic/speech failures. Primary false neighbors on absent requests fell from
+16/16 to 4/16 against the previous-rule replay. All 16 positive requests retained
+their expected source within five accessible results, but only 10/16 had a
+correct primary first result; five required expanding related suggestions.
+Both music identity requests still ranked the wrong recording first in raw
+retrieval. Related grouping makes this uncertainty visible; it does not fix
+music recognition, infer precise words/timestamps or prove requested facts exist.
+All absent requests still retained related candidates.
+
+The policy was frozen before blind evaluation and was not retuned on the result.
+Small corpus, publisher-based media labels and one independent AI annotator
+limit generalization. Package/startup verification for 0.1.9 passed; final public verification is
+recorded in ROADMAP.md.

docs/NATIVE-FINAL-VALIDATION.md

@@ -5,8 +5,8 @@ Windows uninstall/reinstall path, alongside a modest media relevance improvement
 No intermediate release or push is permitted. This report distinguishes actual
 native observations from process, source and automated frontend checks.
 
-Current delivery is 0.1.8. See the final startup-writer correction and corrected
-Windows/Linux package sections below for authoritative hashes and checks.
+Current installed correction is 0.1.9. Its package checks below supersede the
+0.1.8 startup-writer delivery; earlier sections retain their historical evidence.
 Earlier local candidates are retained as historical prechecks and were not
 published. Final native capture/input remains unavailable; process startup,
 accessibility observation and software screenshots do not replace that gate.
@@ -264,6 +264,47 @@ Final evidence: `.searchi/qa/linux-final-018-lockfix-build.json`, matching build
 log, and `.searchi/qa/linux-final-018-lockfix-startup.json`. All owned Linux
 build/test/startup processes have finished. No package was published here.
 
+## Linux 0.1.9 graded-result package validation
+
+The renewed semantic-evidence change was frozen with current tracked and
+nonignored new source, tests, fixtures/policy and built frontend: 685 files,
+source HEAD `a8ba594d0e7e6ba15c3ebb38c48aab8a6a8258ea` plus documented
+uncommitted changes. Source archive SHA-256:
+`c6fa2f6ec66a153318907ce5f3eb6ba820ece3d059247989260be073750dde32`.
+Raw per-file manifest: `.searchi/qa/linux-final-019-source.json`.
+
+CLI/extraction release compilation, desktop release compilation and **56 Linux
+desktop tests** passed (zero ignored, 5.55 seconds). Current extraction provenance,
+normal Google/speech runtimes and loader resolution were verified. No GPU
+execution was performed; the packages retain normal hardware detection and
+CPU fallback.
+
+| Artifact | Bytes | SHA-256 |
+| --- | ---: | --- |
+| `searchi_0.1.9_amd64.deb` | 177,702,778 | `8865da4994cc0e120c7962ffe04e25bd9535042ce9dc21c26306302efc57d3dc` |
+| `searchi-headless_0.1.9_linux-x86_64.tar.xz` | 110,104,160 | `f02bf5350c7b23dfecbcd58125cf9d505fb6d40044a849ad770851ed90026f08` |
+
+Actual startup of the extracted final Debian bytes passed on WSLg `:0` with an
+isolated profile, automatic indexing disabled and CPU/software rendering. Its
+bundled Google worker ran `--device cpu --role query --threads 1`; the desktop
+was alive. All 29 speech records and desktop dependencies were verified, and the
+owned process group was terminated. No UI interaction retry was attempted.
+
+The headless archive was extracted with all **60 package records** verified.
+Genuine CPU CLI and MCP searches used an existing owned one-source speech index,
+without reindexing or new fixture tuning. A known spoken-topic query returned one
+main match; an absent spaceship query returned zero main matches and one related
+suggestion. CLI/MCP match kinds agreed, MCP emitted explicit evidence and counts,
+and the genuine Google worker reported query role, 512-token context and one CPU
+thread. This tiny package boundary proof is not independent quality validation,
+an absence guarantee or a performance benchmark.
+
+Raw evidence: `.searchi/qa/linux-final-019-build.json`, matching build log,
+`.searchi/qa/linux-final-019-headless-build.json`,
+`.searchi/qa/linux-final-019-startup.json` and
+`.searchi/qa/linux-final-019-headless-smoke.json`. All owned processes finished;
+no public release or push was performed by this validation agent.
+
 ## Final startup writer correction
 
 The preceding local 0.1.8 packages remained unpublished prechecks. An actual
@@ -318,3 +359,46 @@ Google query worker was observed on CPU with query role and one thread, alongsid
 bounded background workers. The app is left running for Karl; device discovery
 continues in the background. No final native input pass is claimed.
 Receipts: `.searchi/qa/lean-final-fixed-install/result.json` and `index-check.json`.
+
+## Windows input access boundary
+
+The current native input failure is `GetCursorPos` returning `0x80070005`
+(access denied), not a filesystem or build approval rejection. Microsoft
+documents that [GetCursorPos](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getcursorpos)
+requires `WINSTA_READATTRIBUTES` on the window station and the current input
+desktop. Broad workspace access does not establish those conditions for the
+native automation helper. The precise failing permission/desktop condition
+has not been independently established. No security settings were bypassed
+and no unchanged failed input attempt was repeated for 0.1.9.
+
+The remaining manual Windows check is: press Ctrl+Shift+Space, type a query,
+navigate main results, expand/collapse Related suggestions, open the selected
+source, hide/show through Escape and the tray, and inspect the native glass
+opacity setting. Linux native graphical interaction remains a separate check.
+Actual CPU retrieval and software-rendered frontend checks do not replace
+these open integration checks.
+
+## Windows 0.1.9 installed correction
+
+The normal Windows installer is 101,821,254 bytes, SHA-256
+`ebdec4de6501b6f1cf35cb19ffb7e10adebdab039bffe6bd04ccc39f70d63272`.
+Installation exited zero; installed executable SHA-256
+`7079d7dff83138601f7f87153f7cec1032ccd9debd9c19f8810bc4c36efdd17a`
+matches the extracted installer. Current extraction-helper provenance passed.
+Settings bytes were preserved, a consistent SQLite backup was saved, and the
+VM CPU launcher and desktop/login shortcuts were restored. Retained-index
+`quick_check` returned `ok`; this is not a fresh full-discovery qualification.
+
+The installed app responds and its normal Google worker is resident with CPU,
+query role and one thread. The packaged Windows CLI using that installed worker
+searched the existing real-Google document/media fixture: one main supplier PDF
+and six related suggestions, with the mountain still accessible as related.
+This is functional package evidence, not the blind quality benchmark. A genuine
+Windows CLI/MCP test separately passed document/code queries and cited source
+reads. Windows desktop checks passed 56 tests (one explicitly ignored); Linux
+desktop checks passed 56. Workspace strict all-target Clippy and formatting
+passed, as did 66 frontend tests and the actual UI capture checks.
+
+Receipts: `.searchi/qa/evidence-019-install/`,
+`.searchi/qa/evidence-019-windows-real-mcp.log` and the Linux 0.1.9 receipts above.
+The installed app is left running. Native input remains unchecked.

docs/ROADMAP.md

@@ -2,6 +2,25 @@
 
 ## Current bounded goal — 2026-10-14
 
+### Final 0.1.9 correction — packaging pending
+
+- [x] Separate primary semantic matches from expandable related suggestions in
+  the shared desktop/CLI/MCP engine, preserving exact lexical matches and sources.
+- [x] Complete the frozen bilingual blind Google CPU evaluation: primary absent
+  neighbors 16/16 → 4/16; all 16 positive requests retain expected sources within
+  five accessible results, with 10/16 correct primary first results. No retuning
+  on the holdout; related candidates are not proof of presence. See
+  [semantic evidence](SEMANTIC-EVIDENCE.md).
+- [x] Capture current 0.1.9 production frontend against the real CPU engine,
+  including collapsed/expanded related suggestions and keyboard-selection checks.
+  Browser captures do not establish native OS interaction.
+- [ ] Build and verify final Windows/Linux desktop, CLI and headless artifacts;
+  publish 0.1.9, verify public downloads and update the installed Windows app.
+
+0.1.8 below is the completed prior delivery. The remaining 0.1.9 work is packaging,
+publication and installed smoke verification only; no further features or quality
+experiments belong to this final correction.
+
 Karl replaces the broad production goal with two deliverables. Work stays local;
 there are no intermediate pushes or releases. Publish only the final checked version.
 
@@ -44,7 +63,7 @@ Final bounded delivery: [searchi 0.1.8 is published](https://tea.karlcom.de/karl
 Windows desktop 0.1.8 is installed and its corrected installer verified;
 Ubuntu 24.04 desktop 0.1.8 passed packaged CPU startup. Both public downloads
 were fully hashed and matched the installed/tested artifacts. These are the
-final release artifacts. README includes current working-search
+prior verified release artifacts. README includes current working-search
 images and a user-facing agent installation prompt. Headless Linux/Windows CLI
 0.1.6 remain available through older releases. The native interaction checkbox
 above stays open because final capture/input was denied; clean-machine, macOS

docs/SEMANTIC-EVIDENCE.md

@@ -0,0 +1,66 @@
+# Semantic result evidence
+
+Google EmbeddingGemma 2 retrieves the closest eligible sources. A closest source
+can still be unrelated when the requested content is missing. Similarity and
+reciprocal-rank-fusion scores are not probabilities or proof of presence.
+
+The shared hybrid engine now distinguishes primary results from related
+suggestions using the [frozen presentation policy](../tools/relevance-eval/policies/evidence-v1.json):
+semantic-only primary candidates require raw cosine **at least 0.70** and membership
+in the existing leading semantic cluster. Weaker candidates and the separated
+tail remain available with a `_related` match-kind suffix. This is a presentation
+boundary, not hard deletion or a claim that no matching artifact exists.
+
+Independent filename and keyword results preserve their existing priority and
+match kind, even when the same path also occurs among related semantic neighbors.
+Primary results precede related suggestions within the caller's total limit.
+Strict filters and source validation still run before classification. Raw
+`search_semantic` diagnostics are unchanged.
+
+Clients use `searchi_service::is_related_result` to identify suggestions rather
+than interpreting fused scores as confidence. Debug tracing records
+`hybrid.semantic_shortlist` with `main_candidates`, `related_candidates`,
+`candidates_before` and `candidates_after`; no eligible source is silently
+discarded by this classification stage.
+
+The policy was frozen before new blind-query inference. Existing development
+evidence predicts useful precision/visibility tradeoffs but is not independent
+validation: 31/32 text/code positive tops meet the display floor, with 0/16 absent
+tops; repeated Code-scope rows are 8/8 and 0/4. Historical mixed-media top-score
+promotion is 49/55 positives and 1/6 absent queries, with strongest-file correctness
+evaluated separately. Temporal near-misses can remain strong similarities.
+Related suggestions preserve access to weak genuine results. These counts do
+not justify a universal confidence claim or perfect absence detection.
+
+## Frozen blind evaluation for 0.1.9
+
+The completed [absence-v3 summary](../fixtures/absence-v3/evaluation-summary.json)
+records actual Google CPU inference on 36 covered assets and 36 frozen queries:
+16 positive, 16 absent and four partial requests. No extraction, semantic or
+speech failure removed a required source or channel. The policy was not retuned
+after evaluation.
+
+- Absent queries showing primary neighbors fell from **16/16 to 4/16** compared
+  with a replay of the previously shipped leading-cluster rule using these same
+  actual vectors. This is not a timed run of the old binary.
+- All **16/16 positive requests** retained expected sources within five accessible
+  results, including related suggestions. Primary first-result correctness was
+  **10/16**; primary mean recall@5 was **0.625**, with at least one correct primary
+  source for 11/16 requests. Five needed the related group.
+- All 16 absent requests still had accessible related neighbors. The remaining
+  four primary errors were document/code near-misses, so absence is not solved.
+
+Publisher-based media labels, one independent AI annotator and the small corpus
+limit generalization. The report SHA-256 is
+`3a032695607a5035016602cbd995d9c4ef028891e5310eb585a9356f2404b628`.
+Initial indexing took 894.9 seconds, query startup 1.017 seconds and ordered warm
+raw queries a median 94.4 ms on the shared CPU VM. Hybrid queries reused vectors
+from the preceding raw calls; these are not cold first-input or UI benchmarks.
+
+The current browser-rendered production UI capture verifies that related items
+start collapsed, stay out of arrow-key navigation until expanded, remain
+accessible when expanded, and restore a visible primary selection when collapsed.
+Its exact source/build hashes are in screenshots/capture-manifest.json. Native
+WebView interaction and OS integration are separate, unexecuted checks.
+Windows/Linux desktop and headless/CLI 0.1.9 packages passed their actual CPU
+startup/search checks. Publication verification is recorded in ROADMAP.md.

docs/screenshots/capture-manifest.json

@@ -1,12 +1,22 @@
 {
   "kind": "browser-rendered-production-ui-real-cpu-engine",
   "source": {
-    "base_commit": "01279a6b25b545d0920889bf277abe00631a666d",
-    "working_tree_dirty": true
+    "base_commit": "a8ba594d0e7e6ba15c3ebb38c48aab8a6a8258ea",
+    "working_tree_dirty": true,
+    "source_sha256": {
+      "crates/searchi-service/src/lib.rs": "12e4fd01149a7755b587b5d7ed9162fbe673d8869241a38feb8b33639fa4ccdc",
+      "crates/searchi-service/src/relevance.rs": "de1c031592af13929ddf061da247343e76ecf941b46dfb3821bfce15b9413769",
+      "apps/desktop/src/main.ts": "c40baec5252df08bcc5b9ead9a5a0d38a4f8f82bb4f68212340967143dc8856a",
+      "apps/desktop/src/style.css": "aaf7619ce409cce39e6979727c741785ff8134ba11195932fc8809a21d1bf5c9",
+      "tools/desktop-capture/backend/src/main.rs": "e7f33320bba42452dd60f73803c204c2af96214ecfbbb7868ef7baa0de0bfdc9",
+      "tools/desktop-capture/capture.mjs": "b9c6c8a48c7ec13c4202d43eb57becab66d915fa69ed8fba490f4ccdb0a4116d",
+      "tools/relevance-eval/policies/evidence-v1.json": "d3d4e437a54d1d62a70bb09c2882db6362a2566525a54f92d5fdc7fdfb91e26c"
+    },
+    "capture_backend_sha256": "af504af16bf1c6f49fdf1310575a07771b89800a31d6e355d162cf44f1de4f54"
   },
   "frontend_build": {
-    "version": "0.1.8",
-    "index_sha256": "8415df31094999f0d8bae5a6eb06db160132f1dc4657d1a329a24a6125defe0b"
+    "version": "0.1.9",
+    "index_sha256": "ddaa9bf337c9c84c527e991301bc23d8367410199113ce06aa105e4df231be77"
   },
   "viewport": {
     "width": 1440,
@@ -24,7 +34,7 @@
     "threads": 1,
     "dimensions": 768,
     "ready": true,
-    "rust_build_profile": "debug"
+    "rust_build_profile": "release"
   },
   "cpu_flags": [
     "--disable-gpu",
@@ -37,11 +47,13 @@
     {
       "query": "cancel the supplier partnership",
       "mode": "basic",
-      "result_count": 1,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
       "metrics": {
         "dropped_spans": 0,
-        "result_count": 1,
-        "total_ms": 73.3586,
+        "result_count": 7,
+        "total_ms": 91.0269,
         "trace": null
       },
       "first_filename": "Supplier Agreement.pdf",
@@ -53,17 +65,20 @@
         "literal_query_marks": true,
         "actual_page_explanation": true,
         "why_disclosure_collapsed_by_default": true,
-        "unrelated_photos_removed": true
+        "unrelated_photos_in_collapsed_related_group": true,
+        "collapsed_related_skipped_by_keyboard": true
       }
     },
     {
       "query": "mountains reflected in calm water",
       "mode": "basic",
-      "result_count": 2,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
       "metrics": {
         "dropped_spans": 0,
-        "result_count": 2,
-        "total_ms": 76.9483,
+        "result_count": 7,
+        "total_ms": 81.7248,
         "trace": null
       },
       "first_filename": "Mountain Lake.jpg",
@@ -73,40 +88,42 @@
       },
       "ui_checks": {
         "meaning_only_image_has_no_text_marks": true,
-        "unrelated_documents_removed": true
+        "related_sources_retained": true
       }
     },
     {
       "query": "how can we cancel the supplier partnership",
       "mode": "debug",
-      "result_count": 1,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
       "metrics": {
         "dropped_spans": 0,
-        "result_count": 1,
-        "total_ms": 90.92160000000001,
+        "result_count": 7,
+        "total_ms": 81.6278,
         "trace": [
           {
             "counters": {},
-            "duration_ms": 90.8989,
+            "duration_ms": 81.6085,
             "name": "hybrid.search",
             "parent": null,
-            "start_ms": 0.0108
+            "start_ms": 0.0085
           },
           {
             "counters": {},
-            "duration_ms": 1.8246,
+            "duration_ms": 1.1802,
             "name": "lexical.search",
             "parent": 0,
-            "start_ms": 0.0306
+            "start_ms": 0.019
           },
           {
             "counters": {
               "query_bytes": 42
             },
-            "duration_ms": 0.0422,
+            "duration_ms": 0.0148,
             "name": "lexical.normalization",
             "parent": 1,
-            "start_ms": 0.041100000000000005
+            "start_ms": 0.028399999999999998
           },
           {
             "counters": {
@@ -114,119 +131,119 @@
               "frequency_cache_misses": 8,
               "trigram_index": 1
             },
-            "duration_ms": 0.2968,
+            "duration_ms": 0.14459999999999998,
             "name": "lexical.candidate_plan",
             "parent": 1,
-            "start_ms": 0.094
+            "start_ms": 0.0522
           },
           {
             "counters": {},
-            "duration_ms": 0.3236,
+            "duration_ms": 0.1353,
             "name": "lexical.exact_filename",
             "parent": 1,
-            "start_ms": 0.4067
+            "start_ms": 0.2054
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.2841,
+            "duration_ms": 0.11270000000000001,
             "name": "lexical.filtered_sql",
             "parent": 4,
-            "start_ms": 0.4364
+            "start_ms": 0.2187
           },
           {
             "counters": {},
-            "duration_ms": 0.2009,
+            "duration_ms": 0.1435,
             "name": "lexical.filename_substring",
             "parent": 1,
-            "start_ms": 0.7506999999999999
+            "start_ms": 0.3522
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.17229999999999998,
+            "duration_ms": 0.122,
             "name": "lexical.filtered_sql",
             "parent": 6,
-            "start_ms": 0.7678999999999999
+            "start_ms": 0.365
           },
           {
             "counters": {},
-            "duration_ms": 0.1716,
+            "duration_ms": 0.10160000000000001,
             "name": "lexical.path_substring",
             "parent": 1,
-            "start_ms": 0.9650000000000001
+            "start_ms": 0.5063
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.145,
+            "duration_ms": 0.0803,
             "name": "lexical.filtered_sql",
             "parent": 8,
-            "start_ms": 0.9821000000000001
+            "start_ms": 0.5181
           },
           {
             "counters": {},
-            "duration_ms": 0.229,
+            "duration_ms": 0.16990000000000002,
             "name": "lexical.content",
             "parent": 1,
-            "start_ms": 1.1488
+            "start_ms": 0.6185
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.2014,
+            "duration_ms": 0.1429,
             "name": "lexical.filtered_sql",
             "parent": 10,
-            "start_ms": 1.1647
+            "start_ms": 0.6296
           },
           {
             "counters": {},
-            "duration_ms": 0.27080000000000004,
+            "duration_ms": 0.25549999999999995,
             "name": "lexical.filename_terms",
             "parent": 1,
-            "start_ms": 1.3904
+            "start_ms": 0.7990999999999999
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.2424,
+            "duration_ms": 0.23049999999999998,
             "name": "lexical.filtered_sql",
             "parent": 12,
-            "start_ms": 1.4071
+            "start_ms": 0.8149000000000001
           },
           {
             "counters": {},
-            "duration_ms": 0.162,
+            "duration_ms": 0.1191,
             "name": "lexical.media_metadata",
             "parent": 1,
-            "start_ms": 1.675
+            "start_ms": 1.0663
           },
           {
             "counters": {
               "filters_active": 0,
               "rows": 0
             },
-            "duration_ms": 0.1344,
+            "duration_ms": 0.09780000000000001,
             "name": "lexical.filtered_sql",
             "parent": 14,
-            "start_ms": 1.6907999999999999
+            "start_ms": 1.0778999999999999
           },
           {
             "counters": {},
-            "duration_ms": 0.015000000000000001,
+            "duration_ms": 0.0098,
             "name": "hybrid.identifier_priority",
             "parent": 0,
-            "start_ms": 1.8684999999999998
+            "start_ms": 1.2079
           },
           {
             "counters": {
@@ -234,29 +251,29 @@
               "failed": 0,
               "query_cache_hit": 0,
               "query_cache_miss": 1,
-              "request_encode_us": 25,
-              "request_write_us": 197,
-              "response_validate_us": 97,
-              "worker_batch_prepare_us": 21,
-              "worker_inference_us": 86213,
-              "worker_pool_normalize_us": 19,
+              "request_encode_us": 11,
+              "request_write_us": 188,
+              "response_validate_us": 22,
+              "worker_batch_prepare_us": 20,
+              "worker_inference_us": 78632,
+              "worker_pool_normalize_us": 14,
               "worker_token_count": 16,
               "worker_tokenization_us": 179,
-              "worker_wait_and_response_decode_us": 87455
+              "worker_wait_and_response_decode_us": 79222
             },
-            "duration_ms": 87.9572,
+            "duration_ms": 79.5391,
             "name": "semantic.query_embedding",
             "parent": 0,
-            "start_ms": 1.8927
+            "start_ms": 1.2263
           },
           {
             "counters": {
               "general_lane": 1
             },
-            "duration_ms": 0.9468,
+            "duration_ms": 0.7745,
             "name": "semantic.routing",
             "parent": 0,
-            "start_ms": 89.89030000000001
+            "start_ms": 80.77969999999999
           },
           {
             "counters": {
@@ -264,110 +281,111 @@
               "filesystem_checks": 2,
               "result_files": 7
             },
-            "duration_ms": 0.8935,
+            "duration_ms": 0.752,
             "name": "semantic.retrieval",
             "parent": 18,
-            "start_ms": 89.93039999999999
+            "start_ms": 80.7915
           },
           {
             "counters": {},
-            "duration_ms": 0.14650000000000002,
+            "duration_ms": 0.136,
             "name": "semantic.generation_snapshot",
             "parent": 19,
-            "start_ms": 89.953
+            "start_ms": 80.8015
           },
           {
             "counters": {
               "cache_hit": 1
             },
-            "duration_ms": 0.0167,
+            "duration_ms": 0.0118,
             "name": "semantic.ann_load",
             "parent": 19,
-            "start_ms": 90.1134
+            "start_ms": 80.9495
           },
           {
             "counters": {},
-            "duration_ms": 0.0167,
+            "duration_ms": 0.013,
             "name": "semantic.filter_normalization",
             "parent": 19,
-            "start_ms": 90.14410000000001
+            "start_ms": 80.9726
           },
           {
             "counters": {
               "cache_hit": 1,
               "eligible_chunks": 8
             },
-            "duration_ms": 0.034999999999999996,
+            "duration_ms": 0.054,
             "name": "semantic.eligibility",
             "parent": 19,
-            "start_ms": 90.1714
+            "start_ms": 80.9971
           },
           {
             "counters": {
               "requested_chunks": 8
             },
-            "duration_ms": 0.5680999999999999,
+            "duration_ms": 0.4525,
             "name": "semantic.ann_pass",
             "parent": 19,
-            "start_ms": 90.2198
+            "start_ms": 81.065
           },
           {
             "counters": {
               "returned_chunks": 8
             },
-            "duration_ms": 0.0356,
+            "duration_ms": 0.022799999999999997,
             "name": "semantic.ann_search",
             "parent": 24,
-            "start_ms": 90.2333
+            "start_ms": 81.07730000000001
           },
           {
             "counters": {
               "filesystem_checks": 2,
               "unique_parents": 7
             },
-            "duration_ms": 0.4973,
+            "duration_ms": 0.3964,
             "name": "semantic.parent_materialization",
             "parent": 24,
-            "start_ms": 90.2796
+            "start_ms": 81.1106
           },
           {
             "counters": {
               "valid": 1
             },
-            "duration_ms": 0.193,
+            "duration_ms": 0.1794,
             "name": "semantic.parent_filesystem_validation",
             "parent": 26,
-            "start_ms": 90.38690000000001
+            "start_ms": 81.1704
           },
           {
             "counters": {
               "valid": 1
             },
-            "duration_ms": 0.1215,
+            "duration_ms": 0.1157,
             "name": "semantic.parent_filesystem_validation",
             "parent": 26,
-            "start_ms": 90.6088
+            "start_ms": 81.3696
           },
           {
             "counters": {
-              "candidates_after": 1,
+              "candidates_after": 7,
               "candidates_before": 7,
-              "tail_candidates_pruned": 6
+              "main_candidates": 1,
+              "related_candidates": 6
             },
-            "duration_ms": 0.0216,
+            "duration_ms": 0.0144,
             "name": "hybrid.semantic_shortlist",
             "parent": 0,
-            "start_ms": 90.8471
+            "start_ms": 81.5653
           },
           {
             "counters": {
               "lexical_files": 0,
-              "semantic_files": 1
+              "semantic_files": 7
             },
-            "duration_ms": 0.02,
+            "duration_ms": 0.0159,
             "name": "hybrid.rank_fusion",
             "parent": 0,
-            "start_ms": 90.8783
+            "start_ms": 81.5903
           }
         ]
       },
@@ -401,15 +419,18 @@
     },
     {
       "file": "search-light.png",
-      "sha256": "75fd2ebc9b40dcfb8501ee9ff0e14dc0b3a2cccc223b672f66c6feb4fe5f5858",
+      "sha256": "e043f0075247a674a8302fe5182402a8f98cea60a815714a03a9c4d24ef673ca",
       "query": "cancel the supplier partnership",
       "mode": "basic",
-      "result_count": 1,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
+      "related_expanded": false,
       "selected_filename": "Supplier Agreement.pdf",
       "first_source_kind": "page",
       "first_source_number": 2,
       "theme": "light",
-      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 73 MS · SHOWN 306 MS",
+      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 91 MS · SHOWN 444 MS",
       "capture_bounds": {
         "x": 180,
         "y": 0,
@@ -425,20 +446,57 @@
         "literal_query_marks": true,
         "actual_page_explanation": true,
         "why_disclosure_collapsed_by_default": true,
-        "unrelated_photos_removed": true
+        "unrelated_photos_in_collapsed_related_group": true,
+        "collapsed_related_skipped_by_keyboard": true
+      }
+    },
+    {
+      "file": "related-suggestions.png",
+      "sha256": "5149d0c0647d5c02a2a1a483f40fa63379e229da13fc3ce6d33c4aff6b616e07",
+      "query": "cancel the supplier partnership",
+      "mode": "basic",
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
+      "related_expanded": true,
+      "selected_filename": "Supplier Agreement.pdf",
+      "first_source_kind": "page",
+      "first_source_number": 2,
+      "theme": "light",
+      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 91 MS · SHOWN 444 MS",
+      "capture_bounds": {
+        "x": 180,
+        "y": 0,
+        "width": 1080,
+        "height": 1000
+      },
+      "state_assertions": {
+        "wide_split_preview": true,
+        "semantic_ready": true,
+        "hybrid_final": true,
+        "image_visible": false,
+        "actual_worker_inference": false,
+        "literal_query_marks": true,
+        "actual_page_explanation": true,
+        "why_disclosure_collapsed_by_default": true,
+        "unrelated_photos_in_collapsed_related_group": true,
+        "collapsed_related_skipped_by_keyboard": true
       }
     },
     {
       "file": "search-dark.png",
-      "sha256": "45c3b7f5072d22e4f9c52549727ad63ce122650c2cd105680d40d38b8e0730e1",
+      "sha256": "8579d937064937ec36c542ce79258c1c0d020364098d2b283c8d1d74aa1641e4",
       "query": "cancel the supplier partnership",
       "mode": "basic",
-      "result_count": 1,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
+      "related_expanded": false,
       "selected_filename": "Supplier Agreement.pdf",
       "first_source_kind": "page",
       "first_source_number": 2,
       "theme": "dark",
-      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 73 MS · SHOWN 306 MS",
+      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 91 MS · SHOWN 444 MS",
       "capture_bounds": {
         "x": 180,
         "y": 0,
@@ -454,20 +512,24 @@
         "literal_query_marks": true,
         "actual_page_explanation": true,
         "why_disclosure_collapsed_by_default": true,
-        "unrelated_photos_removed": true
+        "unrelated_photos_in_collapsed_related_group": true,
+        "collapsed_related_skipped_by_keyboard": true
       }
     },
     {
       "file": "media-search.png",
-      "sha256": "718ffd4e7fa0a21ef717a0773749c0b72a1cbae4968bebb0c26e7f4d68133488",
+      "sha256": "f456f6b3c396eddbc5f54745338092021e6751ef57c999f5e4ad88e50e00f0d2",
       "query": "mountains reflected in calm water",
       "mode": "basic",
-      "result_count": 2,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
+      "related_expanded": false,
       "selected_filename": "Mountain Lake.jpg",
       "first_source_kind": "image",
       "first_source_number": 0,
       "theme": "light",
-      "summary": "2 RESULTS · KEYWORD + MEANING · SEARCH 77 MS · SHOWN 280 MS",
+      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 82 MS · SHOWN 305 MS",
       "capture_bounds": {
         "x": 180,
         "y": 0,
@@ -481,20 +543,23 @@
         "image_visible": true,
         "actual_worker_inference": false,
         "meaning_only_image_has_no_text_marks": true,
-        "unrelated_documents_removed": true
+        "related_sources_retained": true
       }
     },
     {
       "file": "performance-details.png",
-      "sha256": "945dec2b087961a4cfa073983f4ac055c6f7b75c736aaaa5094596ffdd959713",
+      "sha256": "fd04c7ac988568a8205b4092e9dda0ddeaaf9fa55598609b78270afcbeafda9f",
       "query": "how can we cancel the supplier partnership",
       "mode": "debug",
-      "result_count": 1,
+      "result_count": 7,
+      "main_result_count": 1,
+      "related_result_count": 6,
+      "related_expanded": false,
       "selected_filename": "Supplier Agreement.pdf",
       "first_source_kind": "page",
       "first_source_number": 2,
       "theme": "light",
-      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 91 MS · SHOWN 306 MS",
+      "summary": "1 RESULTS · KEYWORD + MEANING · SEARCH 82 MS · SHOWN 295 MS",
       "capture_bounds": {
         "x": 180,
         "y": 0,