refactor(docs): code analysis engine

stats:
  lines: "+63024/-60205 (net +2819)"
  files: 14
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,24 @@
 ## [Unreleased]
 
+## [0.5.66] - 2026-03-25
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update project/analysis.json
+- Update project/analysis.toon
+- Update project/analysis.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- Update project/evolution.toon
+- Update project/flow.mmd
+- Update project/flow.png
+- ... and 2 more files
+
 ## [0.5.65] - 2026-03-25
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.5.65
+0.5.66

code2llm/__init__.py

@@ -8,7 +8,7 @@
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.65"
+__version__ = "0.5.66"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)

code2llm/nlp/__init__.py

@@ -4,7 +4,7 @@
 with multilingual support and fuzzy matching.
 """
 
-__version__ = "0.5.65"
+__version__ = "0.5.66"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer

project/README.md

@@ -10,7 +10,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 8 critical functions, 0 god modules |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 10 critical functions, 0 god modules |
 | `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
 | `map.toon` | **TOON** | **🗺️ Structural map + project header** - Modules, imports, exports, signatures, stats, alerts, hotspots, trend | Project architecture overview |
 
@@ -331,7 +331,7 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-25  
-**Total Functions**: 897  
+**Total Functions**: 908  
 **Total Classes**: 106  
 **Modules**: 117  
 

project/analysis.json

@@ -1,34 +1,37 @@
-# code2llm | 113f 20387L | python:105,shell:2,java:1 | 2026-03-25
-# CC̄=4.5 | critical:8/897 | dups:0 | cycles:0
+# code2llm | 113f 20861L | python:105,shell:2,java:1 | 2026-03-25
+# CC̄=4.6 | critical:10/908 | dups:0 | cycles:0
 
-HEALTH[8]:
+HEALTH[10]:
   🟡 CC    main CC=17 (limit:15)
   🟡 CC    validate_chunked_output CC=15 (limit:15)
   🟡 CC    _resolve_callee CC=18 (limit:15)
-  🟡 CC    _render_header CC=16 (limit:15)
-  🟡 CC    _export_chunked_results CC=17 (limit:15)
+  🟡 CC    export_flow_compact CC=23 (limit:15)
+  🟡 CC    export_flow_detailed CC=25 (limit:15)
+  🟡 CC    export_flow_full CC=23 (limit:15)
+  🟡 CC    _export_mermaid CC=16 (limit:15)
   🟡 CC    analyze_ruby CC=17 (limit:15)
   🟡 CC    extract_calls_regex CC=16 (limit:15)
   🟡 CC    _extract_declarations CC=65 (limit:15)
 
 REFACTOR[1]:
-  1. split 8 high-CC methods  (CC>15)
+  1. split 10 high-CC methods  (CC>15)
 
-PIPELINES[615]:
+PIPELINES[624]:
   [1] Src [read_readme]: read_readme
       PURITY: 100% pure
-  [2] Src [save_report]: save_report
+  [2] Src [run_benchmark]: run_benchmark → load_previous
       PURITY: 100% pure
-  [3] Src [main]: main → load_file → is_toon_file
+  [3] Src [save_report]: save_report
       PURITY: 100% pure
-  [4] Src [run_benchmark]: run_benchmark → load_previous
+  [4] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
-  [5] Src [__init__]: __init__
+  [5] Src [main]: main → create_html → get_shield_url
       PURITY: 100% pure
 
 LAYERS:
-  code2llm/                       CC̄=4.7    ←in:0  →out:5
+  code2llm/                       CC̄=4.8    ←in:0  →out:5
   │ !! index_generator            790L  1C    7m  CC=5      ←0
+  │ !! mermaid_exporter           637L  1C   18m  CC=25     ←0
   │ !! project_yaml_exporter      513L  1C   18m  CC=13     ←0
   │ !! html_dashboard             504L  1C   14m  CC=7      ←0
   │ !! metrics                    501L  1C   27m  CC=12     ←0
@@ -41,9 +44,9 @@ LAYERS:
   │ file_analyzer              398L  1C   17m  CC=12     ←0
   │ flow_exporter              391L  1C   14m  CC=10     ←0
   │ pipeline                   388L  3C   20m  CC=10     ←0
-  │ evolution_exporter         350L  1C   15m  CC=10     ←0
+  │ map_exporter               351L  1C   20m  CC=13     ←4
+  │ evolution_exporter         351L  1C   15m  CC=10     ←0
   │ analyzer                   333L  1C    9m  CC=14     ←0
-  │ !! map_exporter               327L  1C   17m  CC=16     ←4
   │ entity_resolution          326L  3C   16m  CC=13     ←0
   │ side_effects               324L  2C   17m  CC=14     ←0
   │ type_inference             321L  1C   19m  CC=9      ←0
@@ -54,11 +57,10 @@ LAYERS:
   │ cfg                        293L  1C   17m  CC=5      ←0
   │ data_analysis              286L  1C   18m  CC=14     ←0
   │ llm_task                   284L  0C   15m  CC=14     ←0
+  │ cli_parser                 270L  0C    1m  CC=1      ←1
+  │ !! formats                    270L  0C   11m  CC=16     ←3
   │ toon_size_manager          265L  0C    8m  CC=10     ←1
-  │ mermaid_exporter           253L  1C   12m  CC=13     ←0
-  │ cli_parser                 251L  0C    1m  CC=1      ←1
   │ context_exporter           248L  1C   15m  CC=10     ←0
-  │ formats                    242L  0C   11m  CC=14     ←3
   │ dfg                        224L  1C   12m  CC=7      ←0
   │ !! cli_commands               220L  0C    6m  CC=15     ←1
   │ call_graph                 211L  1C   13m  CC=9      ←0
@@ -83,11 +85,11 @@ LAYERS:
   │ prioritizer                131L  2C    4m  CC=9      ←0
   │ code2logic                 127L  0C    8m  CC=6      ←1
   │ normalization              122L  2C   13m  CC=6      ←0
+  │ orchestrator               121L  0C    5m  CC=11     ←1
   │ helpers                    120L  0C    8m  CC=8      ←3
   │ validate_project           118L  0C    3m  CC=11     ←1
   │ yaml_exporter              108L  1C    7m  CC=8      ←0
   │ php                        106L  0C    1m  CC=14     ←1
-  │ !! orchestrator               103L  0C    3m  CC=17     ←1
   │ rust                        94L  0C    1m  CC=9      ←1
   │ go_lang                     87L  0C    1m  CC=10     ←1
   │ coupling                    77L  1C    5m  CC=7      ←0