feat(confidence-engine): clarify understanding during Done refresh

2026-09-02 07:53:45 +01:00
parent b647236d44
commit 043ba5f264
5 changed files with 207 additions and 13 deletions
@@ -144,6 +144,20 @@ coherent user-facing explanation

 A separate LLM call here remains appropriate because this operation serves presentation/coherence, **not** authoritative episode interpretation. Desired presentation direction: short, clear, scannable, plain language, minimal repetition. Do not redesign or tune the CU prompt now.

+### Done-for-now interaction (current bounded contract)
+
+`Done for now` is user-owned and has immediate visible effect — the engine does not decide whether enough evidence has been gathered.
+
+On clicking **Done for now**:
+
+1. **Question parks immediately** under "Questions we have clarified" with `Clarified` status + Re-open button
+2. **Focused investigation workspace closes** without waiting for async pipeline
+3. **Current Understanding loading begins immediately** — skeleton overlay appears while the async pipeline runs
+4. Skeleton spans: episode reconsideration → graph application → CU synthesis
+5. **CU refresh completes the investigation checkpoint** — new CU replaces skeleton when ready
+
+The skeleton overlay uses strong paragraph-style bars with varied widths and a left→right shimmer, centred status message ("Clarifying your current understanding…"), and an opaque background that fully obscures old CU content until synthesis succeeds or fails.
+
 ### Current Understanding refresh invariant

 Reconstruct Current Understanding when canonical meaning or the eligible evidence set changes. Do **not** reconstruct it merely because investigation/question status changes.