refactor(docs): code analysis engine

changes:
  - file: batch_processor.py
    area: cli
    modified: [BatchProcessor, _should_exclude_file]
  - file: output_formatters.py
    area: cli
    added: [_build_unsupported_summary, _unsupported_bucket, _split_toon_results, _toon_today, _format_toon_issue, _print_toon_file_section, +1 more]
    modified: [output_batch_empty, output_batch_toon]
  - file: test_batch_toon_output.py
    area: test
    added: [FixedDate, make_result, today]
    new_tests: 2

testing:
  new_tests: 2
  scenarios:
    - batch_processor_skips_toon_files
    - output_batch_toon_is_compact_and_groups_sections

dependencies:
  flow: "test_batch_toon_output→output_formatters"
  - test_batch_toon_output.py -> output_formatters.py

stats:
  lines: "+1607/-1299 (net +308)"
  files: 19
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -124,6 +124,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Tree-sitter for all** — syntax validation for 165+ languages
 - **Example 07** — comprehensive multi-language demo with 8 languages
 
+## [0.1.66] - 2026-03-26
+
+### Docs
+- Update docs/README.md
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/test_batch_toon_output.py
+
+### Other
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- Update project/duplication.toon.yaml
+- Update project/evolution.toon.yaml
+- Update project/flow.mmd
+- Update project/flow.png
+- Update project/index.html
+- ... and 4 more files
+
 ## [0.1.65] - 2026-03-25
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.1.65
+0.1.66

docs/README.md

@@ -20,8 +20,6 @@ When you run `code2llm ./ -f all`, the following files are created:
 |------|--------|---------|----------|
 | `prompt.txt` | **Text** | **📝 Ready-to-send prompt** - Lists all files with instructions | Attach to LLM conversation as context guide |
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
-| `analysis.yaml` | **YAML** | **📊 Structured data** - Machine-readable | For scripts and automated processing |
-| `analysis.json` | **JSON** | **🔧 API format** - Programmatic access | For integration with other tools |
 
 ### 📊 Visualizations
 
@@ -139,23 +137,24 @@ cat map.toon.yaml | head -50
 grep "SIGNATURES" map.toon.yaml
 ```
 
-### `project.toon` - Legacy Project Logic (Deprecated)
-**Purpose**: Compact module view generated by code2logic integration
-**Status**: Deprecated — the lightweight project overview is now merged into `map.toon` header
+### `project.toon.yaml` - Compact Analysis View
+**Purpose**: Compact module view generated from project.yaml data
+**Status**: Legacy view generated on demand from unified project.yaml
 
 **Example usage**:
 ```bash
 # View compact project structure
-cat project.toon | head -30
+cat project.toon.yaml | head -30
 
 # Find largest files
-grep -E "^  .*[0-9]{3,}$" project.toon | sort -t',' -k2 -n -r | head -10
+grep -E "^  .*[0-9]{3,}$" project.toon.yaml | sort -t',' -k2 -n -r | head -10
 ```
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
+- **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
 - **Requirements section**: Guidelines for suggested changes
@@ -331,8 +330,8 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-25  
-**Total Functions**: 12152  
+**Analysis Date**: 2026-03-26  
+**Total Functions**: 12159  
 **Total Classes**: 3039  
 **Modules**: 1425  
 

project/README.md

@@ -1,5 +1,5 @@
-# code2llm | 45f 5765L | python:44,shell:1 | 2026-03-25
-# CC̄=3.5 | critical:4/12152 | dups:0 | cycles:0
+# code2llm | 45f 5819L | python:44,shell:1 | 2026-03-26
+# CC̄=3.5 | critical:3/12159 | dups:0 | cycles:0
 
 HEALTH[20]:
   🟡 CC    validate_code CC=22 (limit:15)
@@ -26,16 +26,16 @@ HEALTH[20]:
 REFACTOR[1]:
   1. split 20 high-CC methods  (CC>15)
 
-PIPELINES[8384]:
-  [1] Src [handle_validate_syntax]: handle_validate_syntax → validate_syntax
+PIPELINES[8385]:
+  [1] Src [__init__]: __init__
       PURITY: 100% pure
-  [2] Src [handle_validate_imports]: handle_validate_imports → validate_imports
+  [2] Src [__init__]: __init__
       PURITY: 100% pure
-  [3] Src [handle_validate_security]: handle_validate_security → validate_security
+  [3] Src [handle_validate_syntax]: handle_validate_syntax → validate_syntax
       PURITY: 100% pure
-  [4] Src [handle_validate_code]: handle_validate_code → validate_code
+  [4] Src [handle_validate_imports]: handle_validate_imports → validate_imports
       PURITY: 100% pure
-  [5] Src [__init__]: __init__
+  [5] Src [handle_validate_security]: handle_validate_security → validate_security
       PURITY: 100% pure
 
 LAYERS:
@@ -49,9 +49,9 @@ LAYERS:
   │ __init__                     1L  0C    0m  CC=0.0    ←0
   │
   src/                            CC̄=3.4    ←in:0  →out:0
-  │ !! output_formatters          421L  0C   16m  CC=17     ←2
+  │ output_formatters          469L  0C   23m  CC=10     ←2
   │ command_handlers           344L  0C   11m  CC=6      ←0
-  │ !! batch_processor            319L  1C   12m  CC=26     ←0
+  │ !! batch_processor            325L  1C   12m  CC=26     ←0
   │ semantic                   296L  1C   15m  CC=4      ←0
   │ gitignore                  272L  1C   10m  CC=11     ←1
   │ regression                 265L  1C   10m  CC=7      ←0