TUI fixes and refinements

Signed-off-by: Matthew Ballance <matt.ballance@gmail.com>

Author: Matthew Ballance

examples/README.md

@@ -1,52 +1,66 @@
 # PyUCIS Examples
 
-This directory contains example applications demonstrating PyUCIS usage.
+This directory contains examples demonstrating PyUCIS capabilities.
 
 ## Available Examples
 
-### Verilator Coverage Example
+### 1. Verilator Coverage Example
+**Directory:** [verilator/](verilator/)
 
-**Location:** `verilator/`
+Complete workflow for collecting coverage from Verilator simulations and converting to UCIS SQLite format.
 
-**Description:** Complete workflow for collecting coverage from Verilator simulations and converting to UCIS SQLite format.
+**Features:**
+- SystemVerilog counter design with assertions and covergroups
+- Multiple test scenarios with coverage collection
+- Conversion from Verilator coverage format to UCIS SQLite
+- Database merging from multiple test runs
+- Interactive TUI and command-line reporting
+- ~6,000 coverage items (line, branch, toggle)
 
 **Quick Start:**
 ```bash
 cd verilator
-make run convert view
+make view  # Build, run tests, merge, and launch TUI
 ```
 
+**See:** [verilator/README.md](verilator/README.md)
+
+---
+
+### 2. AI-Assisted Coverage Analysis
+**Directory:** [ai_assisted_workflow/](ai_assisted_workflow/)
+
+🤖 Learn how AI agents can work with coverage data for intelligent analysis.
+
 **Features:**
-- SystemVerilog counter design with covergroups
-- Automated build and test flow with Makefile
-- Verilator coverage collection (line, toggle, branch, expression)
-- Conversion from Verilator .dat to UCIS SQLite .cdb format
-- Interactive viewing with PyUCIS TUI
-- 218 coverage items across 17 design scopes
-
-**Files:** ~1,100 lines of code including:
-- SystemVerilog design (counter.sv, counter_tb.sv)
-- Python conversion tool (verilator2ucis.py)
-- Build automation (Makefile)
-- Comprehensive documentation (README.md, EXAMPLE_SUMMARY.md)
-
-**Requirements:**
-- Verilator 5.0+
-- Python 3.7+
-- PyUCIS
-
-**See:** `verilator/README.md` for detailed documentation
+- 13 detailed scenarios with problem statements and AI prompts
+- Command selection and decision trees for AI agents
+- Test optimization and gap analysis workflows
+- CI/CD integration examples (LCOV, Cobertura)
+- Automated validation scripts
+
+**Quick Start:**
+```bash
+cd ai_assisted_workflow
+./validate_ai_examples.sh  # Validate setup
+cat AI_INDEX.md            # Navigation hub
+```
+
+**See:** [ai_assisted_workflow/README.md](ai_assisted_workflow/README.md)
 
 ---
 
-## Contributing Examples
+## Which Example Should I Use?
 
-To add a new example:
-1. Create a subdirectory with a descriptive name
-2. Include a README.md with usage instructions
-3. Provide working code and test data
-4. Update this file with a link to your example
+| If you want to... | Use this example |
+|-------------------|------------------|
+| Learn Verilator integration | [verilator/](verilator/) |
+| Collect coverage from RTL | [verilator/](verilator/) |
+| Build coverage flow | [verilator/](verilator/) |
+| Analyze existing coverage | [ai_assisted_workflow/](ai_assisted_workflow/) |
+| Automate coverage analysis | [ai_assisted_workflow/](ai_assisted_workflow/) |
+| Train AI agents | [ai_assisted_workflow/](ai_assisted_workflow/) |
 
 ## License
 
-All examples are licensed under Apache License 2.0
+Apache License 2.0 - See LICENSE file in repository root