refactor: Rename test files for clarity and update documentation

- Rename test files to be more descriptive:
  - test_comprehensive_coverage.py → test_server_features.py
  - test_agent_feedback_fixes.py → test_search_relevance_fixes.py
  - test_evals.py → test_ai_usability_evaluations.py
  - test_edge_cases.py → test_error_handling_edge_cases.py

- Update CLAUDE.md:
  - Update test count to 334 tests with 89% coverage
  - Add comprehensive test coverage bullet points
  - Document search relevance fixes and enhancements

- Update README.md (maintaining snarky tone):
  - Update test count and coverage percentage
  - Add key improvements for search relevance fixes
  - Update test file count to 19 (perfectly organized)
  - Add enhanced Home Manager display to features

- Update tests/README.md with new file names and descriptions

Author: jamesbrink

CLAUDE.md

@@ -62,11 +62,16 @@ mypy mcp_nixos/
 
 ## Testing Approach
 
-- 376+ async tests using pytest-asyncio
+- 334+ async tests using pytest-asyncio (89% coverage)
 - Real API calls (no mocks) for integration tests
 - Unit tests marked with `@pytest.mark.unit`
 - Integration tests marked with `@pytest.mark.integration`
 - Tests ensure plain text output (no XML/JSON leakage)
+- Comprehensive test coverage including:
+  - Search relevance fixes (darwin_search dock prioritization)
+  - Enhanced Home Manager option display
+  - Error handling edge cases
+  - AI usability evaluations
 
 ## Code Quality Commands
 

README.md

@@ -139,6 +139,8 @@ nix profile install github:utensils/mcp-nixos
 - **Deduped flake results** - No more duplicate spam
 - **Version-aware searches** - Find that old Ruby version you need
 - **Category browsing** - Explore options systematically
+- **Search relevance fixes** - Darwin dock searches now find dock, not Docker (revolutionary!)
+- **Enhanced Home Manager display** - Now shows default values like a proper tool
 
 ## For Developers (The Brave Ones)
 
@@ -205,11 +207,12 @@ twine upload dist/*    # Upload to PyPI
 ```
 
 ### Testing Philosophy
-- **367 tests** that actually test things (now async because why not)
+- **334 tests** that actually test things (now async because why not)
+- **89% coverage** because perfection is overrated (but we're close)
 - **Real API calls** because mocks are for cowards (await real_courage())
 - **Plain text validation** ensuring no XML leaks through
 - **Cross-platform tests** because Windows users deserve pain too
-- **15 test files** down from 29 because organization is a virtue
+- **19 test files** perfectly organized because naming things is half the battle
 
 ## Environment Variables
 

tests/README.md

@@ -15,7 +15,7 @@ This directory contains comprehensive tests for the MCP-NixOS server, organized
 
 ### Output and Formatting Tests
 - `test_plain_text_output.py` - Ensures all outputs are plain text (no XML/JSON leakage)
-- `test_edge_cases.py` - Edge case handling and error conditions
+- `test_error_handling_edge_cases.py` - Edge case handling and error conditions
 
 ### Integration and Real-World Tests
 - `test_integration.py` - Integration tests with real APIs (marked with @pytest.mark.integration)
@@ -24,11 +24,11 @@ This directory contains comprehensive tests for the MCP-NixOS server, organized
 - `test_context_awareness.py` - Context tracking and smart suggestions
 
 ### Specialized Tests
-- `test_agent_feedback_fixes.py` - Fixes based on agent feedback (darwin_search dock prioritization, hm_show enhancements)
-- `test_comprehensive_coverage.py` - Additional tests to improve code coverage to 90%+
+- `test_search_relevance_fixes.py` - Fixes based on agent feedback (darwin_search dock prioritization, hm_show enhancements)
+- `test_server_features.py` - Additional tests to improve code coverage to 90%+
 - `test_regression.py` - Regression tests for previously fixed bugs
 - `test_nixos_stats.py` - Statistics functionality tests
-- `test_evals.py` - AI usability evaluation tests
+- `test_ai_usability_evaluations.py` - AI usability evaluation tests
 - `test_mcp_tools.py` - MCP-specific tool tests
 
 ### Support Files

tests/test_evals.py renamed to tests/test_ai_usability_evaluations.py

@@ -157,7 +157,7 @@ async def test_complete_firefox_installation_flow(self, mock_get, mock_post):
         # AI should now have all info needed to guide user through installation
 
 
-# ===== Content from test_evals_comprehensive.py =====
+# ===== Content from test_ai_usability_evaluations_comprehensive.py =====
 @dataclass
 class EvalScenario:
     """Represents an evaluation scenario."""