From 0a33ec6bd2f705bdea129a42c17d980cbbd50f83 Mon Sep 17 00:00:00 2001
From: Jeff Smith <jeff@unbiasedgeek.com>
Date: Sat, 11 Apr 2026 10:25:19 -0600
Subject: [PATCH] wiki: add test_ai_pure.py to test coverage table (#55)

---
 DevelopmentGuide.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/DevelopmentGuide.md b/DevelopmentGuide.md
index db774bc..4cc8cf9 100644
--- a/DevelopmentGuide.md
+++ b/DevelopmentGuide.md
@@ -106,7 +106,7 @@ The test suite uses stdlib `unittest` only.
 
 ### Test coverage
 
-Tests live in `tests/`, one file per module:
+Tests live in `tests/`, one file per module (ai.py has its own pure-helper file):
 
 | Test file | Module covered |
 |---|---|
@@ -117,12 +117,13 @@ Tests live in `tests/`, one file per module:
 | `test_recency.py` | `recency.py` — recent file detection, output parsing |
 | `test_tree.py` | `tree.py` — tree building, rendering, hidden/exclude logic |
 | `test_report.py` | `report.py` — `format_flags`, `format_report`, all sections |
+| `test_ai_pure.py` | `ai.py` (pure helpers) — `_filter_dir_tools`, `_format_survey_block`, `_format_survey_signals`, `_default_survey`, `_should_skip_dir`, `_path_is_safe`, `_block_to_dict`, `_flush_partial_dir_entry` |
 
 Modules **not covered** (exempt from unit testing):
 
 | Module | Reason |
 |---|---|
-| `ai.py` | Requires live Anthropic API |
+| `ai.py` (loops) | End-to-end dir/synthesis/survey loops require a live Anthropic API. Pure helpers in `ai.py` are covered by `test_ai_pure.py`. |
 | `ast_parser.py` | Imports tree-sitter grammars at module load |
 | `prompts.py` | String templates with no logic |
 
@@ -175,6 +176,7 @@ luminos/
 │   ├── report.py           terminal report formatter
 │   └── tree.py             directory tree
 ├── tests/
+│   ├── test_ai_pure.py
 │   ├── test_cache.py
 │   ├── test_code.py
 │   ├── test_disk.py