docs: add P2 reports and TUI views 6-8 to RST documentation

- reports.rst: add usage examples and autofunction/autoclass entries for
  report_test_budget (H), report_safety_matrix (L), report_seed_reliability (M)
- exploring-tui.rst: document views 6 (Code Coverage), 7 (Test History with
  v2 flake stats), and 8 (Testplan closure); update global key table 1-8

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: mballance

doc/source/working-with-coverage/exploring-tui.rst

@@ -53,6 +53,24 @@ Press the number key at any time to switch views.
     Statistical analysis: hit-count distribution histogram, mean/median/stddev,
     coverage tier breakdown (complete / high / medium / low), bin utilization rate.
 
+**6 — Code Coverage**
+    File-level code coverage table showing statement, branch, and toggle hit
+    rates per source file.  Requires a database with code-coverage data (e.g.
+    imported from Verilator).
+
+**7 — Test History**
+    Per-test contribution analysis.  Each row shows total and unique coverage
+    items hit by that test.  When the database includes v2 history (NCDB v2),
+    the detail panel also shows flake score, pass/fail counts, and mean CPU
+    time.  Sort with ``N`` (name), ``D`` (date), ``C`` (coverage), ``U``
+    (unique).
+
+**8 — Testplan**
+    Testplan closure status.  Requires a testplan embedded in the database
+    (see :doc:`testplan`).  Shows every testpoint with its stage, closure
+    status, and pass/fail counts.  The header displays a stage roll-up with
+    colour-coded progress.  Press ``r`` to refresh.
+
 Global Keys
 ===========
 
@@ -62,7 +80,7 @@ Global Keys
 
    * - Key
      - Action
-   * - ``1`` – ``5``
+   * - ``1`` – ``8``
      - Switch view
    * - ``?``
      - Help overlay

doc/source/working-with-coverage/reports.rst

@@ -194,6 +194,75 @@ In a GitHub Actions workflow::
 
 -----------
 
+**********************
+Test budget by stage
+**********************
+
+Estimate CPU-hour cost per stage from v2 test history mean CPU times::
+
+    from ucis.ncdb.ncdb_ucis import NcdbUCIS
+    from ucis.ncdb.testplan import get_testplan
+    from ucis.ncdb.reports import report_test_budget, format_test_budget
+
+    db   = NcdbUCIS("coverage.cdb")
+    plan = db.getTestplan()
+    rpt  = report_test_budget(plan, db)
+    print(format_test_budget(rpt))
+
+    # JSON export
+    import json
+    print(json.loads(rpt.to_json())["stage_totals"])
+
+Testpoints whose tests have no CPU time recorded appear in
+``rpt.missing_stats``.
+
+-----------
+
+**********************
+Safety traceability matrix
+**********************
+
+Build a requirement-to-testpoint matrix (suitable for safety audits)::
+
+    from ucis.ncdb.reports import report_safety_matrix, format_safety_matrix
+
+    rpt = report_safety_matrix(results)          # results from compute_closure
+    print(format_safety_matrix(rpt))
+
+    # CSV for a spreadsheet or audit tool
+    with open("traceability.csv", "w") as f:
+        f.write(rpt.to_csv())
+
+    # Add a WaiverSet to flag waived testpoints
+    from ucis.ncdb.waivers import WaiverSet
+    waivers = WaiverSet.from_file("waivers.hjson")
+    rpt = report_safety_matrix(results, waivers=waivers)
+
+-----------
+
+**********************
+Seed reliability heat-map
+**********************
+
+Identify seeds that are disproportionately flaky::
+
+    from ucis.ncdb.ncdb_ucis import NcdbUCIS
+    from ucis.ncdb.reports import report_seed_reliability, format_seed_reliability
+
+    db  = NcdbUCIS("coverage.cdb")
+    rpt = report_seed_reliability(db, "uart_smoke")
+    print(format_seed_reliability(rpt))
+    # Seeds with flake_score ≥ 0.2 are flagged with ⚠
+
+    # JSON heat-map for a custom dashboard
+    import json
+    data = json.loads(rpt.to_json())
+    for row in data["rows"]:
+        if row["flake"] >= 0.2:
+            print(f"Seed {row['seed']}: {row['fail']} failures")
+
+-----------
+
 **********************
 GitHub Step Summary
 **********************
@@ -241,6 +310,18 @@ API reference
 .. autofunction:: ucis.ncdb.reports.format_coverage_contribution
 .. autoclass:: ucis.ncdb.reports.CoverageContribution
 
+.. autofunction:: ucis.ncdb.reports.report_test_budget
+.. autofunction:: ucis.ncdb.reports.format_test_budget
+.. autoclass:: ucis.ncdb.reports.TestBudget
+
+.. autofunction:: ucis.ncdb.reports.report_safety_matrix
+.. autofunction:: ucis.ncdb.reports.format_safety_matrix
+.. autoclass:: ucis.ncdb.reports.SafetyMatrix
+
+.. autofunction:: ucis.ncdb.reports.report_seed_reliability
+.. autofunction:: ucis.ncdb.reports.format_seed_reliability
+.. autoclass:: ucis.ncdb.reports.SeedReliability
+
 .. autofunction:: ucis.ncdb.testplan_export.export_junit_xml
 .. autofunction:: ucis.ncdb.testplan_export.export_github_annotations
 .. autofunction:: ucis.ncdb.testplan_export.export_summary_markdown