refactor(docs): code analysis engine

stats:
  lines: "+332/-274 (net +58)"
  files: 13
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
+## [0.5.90] - 2026-03-26
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/flow.mmd
+- Update project/flow.png
+- Update project/index.html
+- Update project/map.toon.yaml
+- Update project/project.toon.yaml
+- Update project/prompt.txt
+
 ## [0.5.89] - 2026-03-26
 
 ## [0.5.88] - 2026-03-26

VERSION

@@ -1 +1 @@
-0.5.89
+0.5.90

code2llm/__init__.py

@@ -8,7 +8,7 @@
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.89"
+__version__ = "0.5.90"
 __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.89"
+__version__ = "0.5.90"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer

project/README.md

@@ -153,7 +153,7 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | sort -t',' -k2 -n -r | head -10
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
 **Contents**:
-- **Files section**: Lists all existing generated files with descriptions
+- **Files section**: Lists all existing generated files with descriptions, including `project.toon.yaml` when generated by `-f all`
 - **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

project/analysis.toon.yaml

@@ -1,4 +1,4 @@
-# code2llm | 113f 21449L | python:105,shell:2,php:1 | 2026-03-26
+# code2llm | 113f 21472L | python:105,shell:2,php:1 | 2026-03-26
 # CC̄=4.6 | critical:10/933 | dups:0 | cycles:0
 
 HEALTH[10]:
@@ -16,7 +16,7 @@ HEALTH[10]:
 REFACTOR[1]:
   1. split 10 high-CC methods  (CC>15)
 
-PIPELINES[638]:
+PIPELINES[637]:
   [1] Src [read_readme]: read_readme
       PURITY: 100% pure
   [2] Src [save_report]: save_report
@@ -25,7 +25,7 @@ PIPELINES[638]:
       PURITY: 100% pure
   [4] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
-  [5] Src [main]: main → create_html → get_shield_url
+  [5] Src [__init__]: __init__
       PURITY: 100% pure
 
 LAYERS:
@@ -43,7 +43,7 @@ LAYERS:
   │ evolution_exporter         471L  1C   17m  CC=11     ←0
   │ renderer                   471L  1C   26m  CC=11     ←0
   │ !! map_exporter               435L  1C   21m  CC=25     ←4
-  │ prompt                     411L  0C   17m  CC=13     ←1
+  │ prompt                     426L  0C   17m  CC=14     ←1
   │ file_analyzer              398L  1C   17m  CC=12     ←0
   │ flow_exporter              391L  1C   14m  CC=10     ←0
   │ pipeline                   388L  3C   20m  CC=10     ←0
@@ -55,8 +55,8 @@ LAYERS:
   │ type_inference             321L  1C   19m  CC=9      ←0
   │ intent_matching            297L  3C   15m  CC=7      ←0
   │ cfg                        293L  1C   17m  CC=5      ←0
+  │ !! formats                    287L  0C   12m  CC=16     ←3
   │ data_analysis              286L  1C   18m  CC=14     ←0
-  │ !! formats                    286L  0C   12m  CC=16     ←3
   │ llm_task                   284L  0C   15m  CC=14     ←0
   │ cli_parser                 277L  0C    1m  CC=1      ←1
   │ toon_size_manager          265L  0C    8m  CC=10     ←1
@@ -79,8 +79,8 @@ LAYERS:
   │ module_detail              162L  1C    9m  CC=7      ←0
   │ toon_view                  157L  1C    9m  CC=6      ←0
   │ prompt_engine              150L  1C    7m  CC=12     ←0
+  │ orchestrator               149L  0C    5m  CC=11     ←1
   │ toon_parser                147L  0C   10m  CC=8      ←1
-  │ orchestrator               142L  0C    5m  CC=11     ←1
   │ context_view               140L  1C    8m  CC=11     ←0
   │ gitignore                  139L  1C    6m  CC=10     ←2
   │ !! ruby                       135L  0C    2m  CC=17     ←1

project/calls.mmd

@@ -16,14 +16,14 @@ flowchart TD
     code2llm_cli ==>|5| code2llm_cli_commands
     code2llm_cli_exports -->|3| code2llm_exporters
     validate_toon -->|2| code2llm_parsers
-    code2llm_cli_analysis -->|2| code2llm_cli_exports
     benchmarks_benchmark_format_quality -->|2| benchmarks_reporting
+    code2llm_cli_analysis -->|2| code2llm_cli_exports
     code2llm_cli -->|1| code2llm_cli_parser
     code2llm_cli -->|1| code2llm_cli_analysis
     code2llm_cli -->|1| code2llm_cli_exports
-    code2llm_cli_analysis -->|1| code2llm_core
-    code2llm_cli_commands -->|1| code2llm_cli_exports
     benchmarks_benchmark_format_quality -->|1| benchmarks_format_evaluator
     benchmarks_benchmark_format_quality -->|1| benchmarks_project_generator
+    code2llm_cli_analysis -->|1| code2llm_core
+    code2llm_cli_commands -->|1| code2llm_cli_exports
     code2llm_cli_exports -->|1| code2llm_core
     code2llm_cli_exports -->|1| code2llm_generators

project/calls.png

@@ -9,7 +9,7 @@
 - **Total Functions**: 933
 - **Total Classes**: 106
 - **Modules**: 117
-- **Entry Points**: 696
+- **Entry Points**: 695
 
 ## Architecture by Module
 
@@ -53,16 +53,16 @@
 - **Classes**: 1
 - **File**: `type_inference.py`
 
-### code2llm.analysis.data_analysis
-- **Functions**: 18
-- **Classes**: 1
-- **File**: `data_analysis.py`
-
 ### code2llm.analysis.pipeline_detector
 - **Functions**: 18
 - **Classes**: 3
 - **File**: `pipeline_detector.py`
 
+### code2llm.analysis.data_analysis
+- **Functions**: 18
+- **Classes**: 1
+- **File**: `data_analysis.py`
+
 ### code2llm.exporters.project_yaml_exporter
 - **Functions**: 18
 - **Classes**: 1
@@ -473,6 +473,10 @@ Key functions that process and transform data:
 > Create CLI argument parser.
 - **Output to**: argparse.ArgumentParser, parser.add_argument, parser.add_argument, parser.add_argument, parser.add_argument
 
+### benchmarks.benchmark_format_quality._generate_format_outputs
+> Generate all format outputs and evaluate them.
+- **Output to**: format_configs.items, __import__, getattr, exporter_cls, time.time
+
 ### demo_langs.valid.sample.UserService.process_users
 - **Output to**: print
 
@@ -487,10 +491,6 @@ Checks:
 1. All chunks have required files (analysis.toon, contex
 - **Output to**: print, print, sorted, print, print
 
-### benchmarks.benchmark_format_quality._generate_format_outputs
-> Generate all format outputs and evaluate them.
-- **Output to**: format_configs.items, __import__, getattr, exporter_cls, time.time
-
 ### code2llm.analysis.data_analysis.DataAnalyzer._identify_process_patterns
 - **Output to**: result.functions.items, patterns.items, sorted, func.name.lower, indicators.items
 
@@ -502,10 +502,6 @@ Checks:
 > Process Python files directly in level1 directory.
 - **Output to**: code2llm.core.repo_files._get_gitignore_parser, len, chunks.append, self._chunk_by_files, chunks.extend
 
-### code2llm.analysis.cfg.CFGExtractor._format_except
-> Format except handler.
-- **Output to**: self._expr_to_str
-
 ### code2llm.core.repo_files._get_gitignore_parser
 > Load gitignore parser for project if available.
 - **Output to**: code2llm.core.gitignore.load_gitignore_patterns
@@ -524,6 +520,10 @@ Returns list of (module_name, start_line, end_line).
 > Check if file should be processed.
 - **Output to**: file_path.lower, Path, self._gitignore_parser.is_ignored, any, fnmatch.fnmatch
 
+### code2llm.analysis.cfg.CFGExtractor._format_except
+> Format except handler.
+- **Output to**: self._expr_to_str
+
 ### code2llm.core.file_analyzer.FileAnalyzer._process_class
 > Process class definition.
 - **Output to**: ClassInfo, None.classes.append, isinstance, isinstance, methods.append