fix: Update references after docs consolidation

- Update help:// adapter STATIC_HELP to point to consolidated files
- Add new topics: recipes, codebase-review, output
- Fix README.md link text (COOL_TRICKS → RECIPES)
- Fix TOC anchor format in RECIPES.md and CODEBASE_REVIEW.md
- Update packaging test (AGENT_HELP_FULL.md merged into AGENT_HELP.md)
- Remove stale build/ artifacts

Fixes issues found during validation of spectral-hacker-0119 consolidation.

Author: Scott Senkeresty

README.md

@@ -486,7 +486,7 @@ reveal/
 **Quality metrics:** 2,500+ tests, continuous integration on every commit.
 
 **Documentation:** [reveal/docs/README.md](reveal/docs/README.md) - Comprehensive guides for users, developers, and AI agents
-**Power users:** [COOL_TRICKS.md](reveal/docs/RECIPES.md) - Hidden features and advanced workflows
+**Power users:** [RECIPES.md](reveal/docs/RECIPES.md) - Task-based workflows and advanced patterns
 
 ---
 

reveal/adapters/help.py

@@ -64,19 +64,21 @@ class HelpAdapter(ResourceAdapter):
     STATIC_HELP = {
         'quick-start': 'QUICK_START.md',  # 5-minute quick start guide
         'agent': 'AGENT_HELP.md',
-        'agent-full': 'AGENT_HELP_FULL.md',
+        'agent-full': 'AGENT_HELP.md',  # Alias (full version merged into AGENT_HELP.md)
         'python': 'PYTHON_ADAPTER_GUIDE.md',  # Alias for python-guide
         'python-guide': 'PYTHON_ADAPTER_GUIDE.md',
         'reveal-guide': 'REVEAL_ADAPTER_GUIDE.md',  # Reference implementation
         'markdown': 'MARKDOWN_GUIDE.md',
         'html': 'HTML_GUIDE.md',  # HTML features guide
-        'anti-patterns': 'ANTI_PATTERNS.md',
+        'anti-patterns': 'AGENT_HELP.md',  # Merged into AGENT_HELP.md
         'adapter-authoring': 'ADAPTER_AUTHORING_GUIDE.md',
-        'tricks': 'COOL_TRICKS.md',
+        'tricks': 'RECIPES.md',  # Merged into RECIPES.md (task-based workflows)
+        'recipes': 'RECIPES.md',  # Primary name for workflow recipes
         'help': 'HELP_SYSTEM_GUIDE.md',  # Meta-documentation about help system
         'configuration': 'CONFIGURATION_GUIDE.md',  # Configuration system guide
         'config': 'CONFIGURATION_GUIDE.md',  # Alias for configuration
-        'release': 'RELEASE_GUIDE.md',  # Release process for maintainers
+        'codebase-review': 'CODEBASE_REVIEW.md',  # Codebase review workflows
+        'output': 'OUTPUT_CONTRACT.md',  # Output format contract
         'schemas': 'SCHEMA_VALIDATION_HELP.md',  # Schema validation guide (v0.29.0+)
         'duplicates': 'DUPLICATE_DETECTION_GUIDE.md',  # Duplicate code detection guide
         'duplicate-detection': 'DUPLICATE_DETECTION_GUIDE.md'  # Alias for duplicates

reveal/docs/CODEBASE_REVIEW.md

@@ -17,11 +17,11 @@ Reveal is a **semantic code exploration tool** that enables comprehensive codeba
 
 ## Table of Contents
 
-1. [The 14 Adapters: Your Review Toolkit](#the-13-adapters-your-review-toolkit)
+1. [The 14 Adapters: Your Review Toolkit](#the-14-adapters-your-review-toolkit)
 2. [Core Review Workflows](#core-review-workflows)
 3. [The Complete Codebase Review Process](#the-complete-codebase-review-process)
 4. [Advanced Multi-Adapter Patterns](#advanced-multi-adapter-patterns)
-5. [Quality Gates & Metrics](#quality-gates--metrics)
+5. [Quality Gates & Metrics](#quality-gates-metrics)
 6. [Token-Efficient AI Review Strategies](#token-efficient-ai-review-strategies)
 7. [Real-World Review Scenarios](#real-world-review-scenarios)
 8. [Quick Reference](#quick-reference)

reveal/docs/RECIPES.md

@@ -9,9 +9,9 @@ Find your task, get the commands. This guide organizes reveal by workflow, not b
 ## Table of Contents
 
 - [Code Review](#code-review)
-- [Onboarding & Exploration](#onboarding--exploration)
-- [Debugging & Troubleshooting](#debugging--troubleshooting)
-- [Refactoring & Quality](#refactoring--quality)
+- [Onboarding & Exploration](#onboarding-exploration)
+- [Debugging & Troubleshooting](#debugging-troubleshooting)
+- [Refactoring & Quality](#refactoring-quality)
 - [Documentation Maintenance](#documentation-maintenance)
 - [JSON Navigation](#json-navigation)
 - [Database Operations](#database-operations)

tests/test_packaging_manifest.py

@@ -45,29 +45,25 @@ def tearDownClass(cls):
         shutil.rmtree(cls.temp_dir, ignore_errors=True)
 
     def test_agent_help_files_included(self):
-        """AGENT_HELP*.md files must be included in distribution.
-        
-        Regression test: These files were moved to reveal/docs/ but MANIFEST.in
-        still referenced reveal/AGENT_HELP*.md, causing them to be excluded.
+        """AGENT_HELP.md must be included in distribution.
+
+        Regression test: This file was moved to reveal/docs/ but MANIFEST.in
+        still referenced reveal/AGENT_HELP*.md, causing it to be excluded.
+        Note: AGENT_HELP_FULL.md was merged into AGENT_HELP.md in v0.39.0.
         """
         with tarfile.open(self.tarball, 'r:gz') as tar:
             names = tar.getnames()
-            
-            # Check for both agent help files
+
+            # Check for agent help file
             agent_help = [n for n in names if 'AGENT_HELP.md' in n]
-            agent_help_full = [n for n in names if 'AGENT_HELP_FULL.md' in n]
-            
+
             self.assertTrue(
                 len(agent_help) > 0,
                 "AGENT_HELP.md not found in package! Check MANIFEST.in"
             )
-            self.assertTrue(
-                len(agent_help_full) > 0,
-                "AGENT_HELP_FULL.md not found in package! Check MANIFEST.in"
-            )
-            
-            # Verify they're in the correct location
-            for name in agent_help + agent_help_full:
+
+            # Verify it's in the correct location
+            for name in agent_help:
                 self.assertIn(
                     '/reveal/docs/',
                     name,