From 0bbf271154cb8753a37497b4d77053d897edf6d7 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Mon, 2 Mar 2026 08:08:33 -0500
Subject: [PATCH] docs: add beta hardening report and session notes

---
 docs/beta_hardening_2026-03-02.md | 46 +++++++++++++++++++++++++++++++
 memory-update.md                  | 14 ++++++++++
 2 files changed, 60 insertions(+)
 create mode 100644 docs/beta_hardening_2026-03-02.md

diff --git a/docs/beta_hardening_2026-03-02.md b/docs/beta_hardening_2026-03-02.md
new file mode 100644
index 00000000..17bf7358
--- /dev/null
+++ b/docs/beta_hardening_2026-03-02.md
@@ -0,0 +1,46 @@
+# Beta Hardening Report (2026-03-02)
+
+## Scope
+This report covers the hardening checklist run on branch `beta` after Textual TUI v2 parity/UX fixes.
+
+## 1) CI-equivalent validation
+Command:
+- `PATH=".venv/bin:$PATH" scripts/run_ci_tests.sh`
+
+Result:
+- Passed.
+- Determinism gate: passed (`43 passed, 950 skipped`).
+- Full suite: passed (`977 passed, 16 skipped`).
+
+## 2) Installer smoke tests
+Commands:
+- `bash scripts/installer_smoke_unix.sh beta tui`
+- `bash scripts/installer_smoke_unix.sh beta both`
+
+Result:
+- Both smoke runs passed.
+- `both` mode correctly skipped GUI install in headless environment and still completed successfully.
+
+Notes observed:
+- Installer reported stale `seedpass` launchers on PATH from previous local installs; install still completed.
+- This is an environment hygiene warning, not an installer failure.
+
+## 3) Parity bug-bash harness
+Commands:
+- `python scripts/ai_tui2_agent_test.py --scenario extended --verbose`
+- `python scripts/ai_tui_agent_test.py --scenario extended --verbose`
+
+Result:
+- TUI v2 extended scenario: passed.
+- Legacy TUI extended scenario: passed.
+
+## 4) Included UX fixes validated in this hardening pass
+- TUI v2 selected-entry state now stays synchronized with list navigation/highlight.
+- Left pane command/help content no longer hard-clips; scrolling enabled.
+- Sensitive reveal/QR confirmation paths now show explicit in-panel instructions.
+- QR panel avoids wrapping distortion for ASCII QR output.
+
+## Current release posture
+- Hardening checklist items 1-3 are complete and green for this environment.
+- No blocking failures identified in CI-equivalent, installer smoke, or parity harness checks.
+- Remaining operational caution: clean up stale local launchers in user environments to reduce ambiguity about which `seedpass` executable is being run.
diff --git a/memory-update.md b/memory-update.md
index 598970a6..153b25c9 100644
--- a/memory-update.md
+++ b/memory-update.md
@@ -548,3 +548,17 @@
 - Validation:
   - `pytest -q src/tests/test_tui_v2_textual_interactions.py src/tests/test_tui_v2_action_matrix.py src/tests/test_tui_v2_helpers.py` -> `33 passed`.
   - `python scripts/ai_tui2_agent_test.py --scenario core --verbose` -> `[PASS] core`.
+
+## 2026-03-02 Hardening checklist execution (post TUI v2 UX patch)
+- Completed requested hardening items in repo workspace:
+  1) CI-equivalent run via `scripts/run_ci_tests.sh`: PASS.
+     - Determinism gate: `43 passed, 950 skipped`.
+     - Full suite: `977 passed, 16 skipped`.
+  2) Installer smoke (`beta`) via `scripts/installer_smoke_unix.sh`:
+     - `mode=tui`: PASS.
+     - `mode=both`: PASS (GUI intentionally skipped in headless runtime).
+  3) Parity bug-bash harnesses:
+     - `scripts/ai_tui2_agent_test.py --scenario extended --verbose`: PASS.
+     - `scripts/ai_tui_agent_test.py --scenario extended --verbose`: PASS.
+- Added release note document: `docs/beta_hardening_2026-03-02.md` with checklist commands, results, and residual operational warning about stale launcher binaries on PATH.
+- Practical note: Installer repeatedly warns about stale `/home/user/.local/bin/seedpass` entries; this does not fail install but can obscure which binary users are executing.