docs: clarify wizard candidate colors

Author: rossant

docs/changelog.md

@@ -102,11 +102,13 @@ behavior they verify rather than listed separately.
   Similarity rows in visible table order; sorting or filtering either table
   updates that presentation without recoloring existing selections. Deselecting
   and reselecting a cluster reuses its color while the blue reference remains
-  unchanged; choosing a new reference starts a new color session. In Merge
-  mode, explicit Merge View order takes precedence, while workflow-table
-  colors remain fixed for the entire session. Normal-mode cross-role mouse
-  transfers and cross-correlogram promotion have been removed in favor of the
-  Merge workspace.
+  unchanged; choosing a new reference starts a new color session. Normal-mode
+  `Space`/`Shift+Space` navigation gives the replacement wizard candidate the
+  outgoing candidate's color, so a lone candidate remains red. In Merge mode,
+  explicit Merge View order takes precedence, while workflow-table colors
+  remain fixed for the entire session. Normal-mode cross-role mouse transfers
+  and cross-correlogram promotion have been removed in favor of the Merge
+  workspace.
 - Undo and redo restore the complete selection context around merge, split,
   and metadata actions; redo also preserves selection-only exploration made
   after the original action.

docs/clustering.md

@@ -68,6 +68,11 @@ You can move up and down in the **cluster view** with the `Up` and `Down` arrows
 
 You can move up and down in the **similarity view** with the `Space` and `Shift-space` arrows. The cluster selected in the similarity view is called the **similar cluster**. The idea is to go through every "best cluster" in the cluster view, and review the "similar clusters" in the similarity view (sorted by decreasing similarity with the best cluster).
 
+In Normal mode, this wizard navigation replaces the current similar cluster in
+its color slot. With one blue reference, the candidate therefore remains red as
+you move forward or backward. Multi-selection colors and Merge-mode colors keep
+their separate stable-slot behavior.
+
 Press `Control+Space` to select the first 15 eligible clusters currently shown in the similarity view while preserving the cluster view selection. Repeat it to select the next batch. This uses the current similarity view sorting and filtering. To choose a different number, use **Select > Select N Similar**; the chosen number becomes the shortcut's new default and is remembered across sessions.
 
 Wizard navigation skips clusters labeled `noise` or `mua` by default. To include them when moving through either table or when selecting N similar clusters, uncheck **Select > Skip Noise and MUA**. This preference is remembered across sessions. Direct selection with the mouse, a cluster ID, or a snippet can always select these clusters. Code that creates a `Supervisor` can choose the initial behavior with `skip_masked_clusters=False`; saved GUI state takes precedence when present.