feat(docs): code analysis engine

changes:
  - file: formats.py
    area: cli
    added: [_export_project_toon]
  - file: orchestrator.py
    area: cli
    modified: [_export_chunked_results, _export_single_project]

dependencies:
  flow: "orchestrator→formats"
  - orchestrator.py -> formats.py
  - orchestrator.py -> prompt.py

stats:
  lines: "+272/-249 (net +23)"
  files: 16
  complexity: "+200% complexity (monitor)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,24 @@
 ## [Unreleased]
 
+## [0.5.87] - 2026-03-26
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update code2llm/cli_exports/formats.py
+- Update code2llm/cli_exports/orchestrator.py
+- 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/evolution.toon.yaml
+- Update project/flow.mmd
+- Update project/flow.png
+- ... and 3 more files
+
 ## [0.5.86] - 2026-03-26
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.5.86
+0.5.87

code2llm/__init__.py

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

code2llm/cli_exports/formats.py

@@ -69,6 +69,21 @@ def _export_project_yaml(args, result, output_dir: Path):
     return filepath
 
 
+def _export_project_toon(args, result, output_dir: Path):
+    """Export project.toon.yaml directly from the current analysis result."""
+    project_yaml_exporter = ProjectYAMLExporter()
+    data = project_yaml_exporter._build_project_yaml(result, [])
+
+    exporter = ToonViewGenerator()
+    filepath = output_dir / 'project.toon.yaml'
+    exporter.generate(data, str(filepath))
+
+    if getattr(args, 'verbose', False):
+        print(f"  - PROJECT-TOON (project overview): {filepath}")
+
+    return filepath
+
+
 def _run_report(args, project_yaml_path: str, output_dir: Path) -> None:
     """Generate views from project.yaml.
 

code2llm/cli_exports/orchestrator.py

@@ -10,6 +10,7 @@
     _export_evolution,
     _export_data_structures,
     _export_context_fallback,
+    _export_project_toon,
     _export_readme,
     _export_refactor_prompts,
     _export_index_html,
@@ -61,6 +62,9 @@ def _export_single_project(
     _export_data_structures(args, result, output_dir)
     _export_context_fallback(args, result, output_dir, formats)
 
+    if 'all' in requested_formats:
+        _export_project_toon(args, result, output_dir)
+
     if source_path is not None:
         _export_code2logic(args, source_path, output_dir, formats)
         _export_prompt_txt(args, output_dir, requested_formats, source_path)
@@ -95,6 +99,9 @@ def _export_chunked_results(
     _export_simple_formats(args, result, output_dir, ['toon', 'context'])
     _export_evolution(args, result, output_dir)
 
+    if 'all' in requested_formats:
+        _export_project_toon(args, result, output_dir)
+
     if source_path is not None:
         _export_code2logic(args, source_path, output_dir, formats)
         _export_chunked_prompt_txt(args, output_dir, requested_formats, source_path, subprojects)

code2llm/nlp/__init__.py

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

project/README.md

@@ -331,7 +331,7 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-26  
-**Total Functions**: 932  
+**Total Functions**: 933  
 **Total Classes**: 106  
 **Modules**: 117  
 

project/analysis.toon.yaml

@@ -1,5 +1,5 @@
-# code2llm | 113f 21434L | python:105,shell:2,php:1 | 2026-03-26
-# CC̄=4.6 | critical:10/932 | dups:0 | cycles:0
+# code2llm | 113f 21449L | python:105,shell:2,php:1 | 2026-03-26
+# CC̄=4.6 | critical:10/933 | dups:0 | cycles:0
 
 HEALTH[10]:
   🟡 CC    main CC=17 (limit:15)
@@ -16,14 +16,14 @@ HEALTH[10]:
 REFACTOR[1]:
   1. split 10 high-CC methods  (CC>15)
 
-PIPELINES[637]:
-  [1] Src [run_benchmark]: run_benchmark → load_previous
+PIPELINES[638]:
+  [1] Src [read_readme]: read_readme
       PURITY: 100% pure
-  [2] Src [read_readme]: read_readme
+  [2] Src [save_report]: save_report
       PURITY: 100% pure
-  [3] Src [main]: main → load_file → is_toon_file
+  [3] Src [run_benchmark]: run_benchmark → load_previous
       PURITY: 100% pure
-  [4] Src [save_report]: save_report
+  [4] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
   [5] Src [main]: main → create_html → get_shield_url
       PURITY: 100% pure
@@ -56,9 +56,9 @@ LAYERS:
   │ intent_matching            297L  3C   15m  CC=7      ←0
   │ cfg                        293L  1C   17m  CC=5      ←0
   │ 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
-  │ !! formats                    271L  0C   11m  CC=16     ←3
   │ toon_size_manager          265L  0C    8m  CC=10     ←1
   │ context_exporter           248L  1C   15m  CC=10     ←0
   │ dfg                        224L  1C   12m  CC=7      ←0