refactor(docs): code analysis engine

changes:
  - file: cli_commands.py
    area: cli
    modified: [handle_report_command]
  - file: cli_parser.py
    area: analyzer
    modified: [create_parser]
  - file: project_yaml_exporter.py
    area: core
    modified: [ProjectYAMLExporter]
  - file: readme_exporter.py
    area: docs
    modified: [_get_existing_files, _generate_readme_content, READMEExporter]

stats:
  lines: "+470/-357 (net +113)"
  files: 9
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,26 @@
 ## [Unreleased]
 
+## [0.5.83] - 2026-03-26
+
+### Docs
+- Update README.md
+- Update context.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update analysis.toon.yaml
+- Update batch_1/analysis.toon.yaml
+- Update code2llm/cli_commands.py
+- Update code2llm/cli_parser.py
+- Update code2llm/exporters/project_yaml_exporter.py
+- Update code2llm/exporters/readme_exporter.py
+- Update code2llm/exporters/report_generators.py
+- Update project/analysis.toon.yaml
+- Update project/batch_1/analysis.toon.yaml
+- Update project/root/analysis.toon.yaml
+- ... and 1 more files
+
 ## [0.5.82] - 2026-03-26
 
 ### Other

README.md

@@ -127,17 +127,17 @@ cat map.toon.yaml | head -50
 grep "SIGNATURES" map.toon.yaml
 ```
 
-### `analysis_view.toon` - Compact Analysis View
+### `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 analysis_view.toon | head -30
+cat project.toon.yaml | head -30
 
 # Find largest files
-grep -E "^  .*[0-9]{3,}$" analysis_view.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

VERSION

@@ -1 +1 @@
-0.5.82
+0.5.83

analysis.toon.yaml

@@ -1,8 +1,8 @@
-# code2llm | 113f 21241L | python:108,shell:4,php:1 | 2026-03-26
-# CC̄=4.6 | critical:10/923 | dups:0 | cycles:0
+# code2llm | 113f 21404L | python:108,shell:4,php:1 | 2026-03-26
+# CC̄=4.6 | critical:10/931 | dups:0 | cycles:0
 
 HEALTH[10]:
-  🟡 CC    _extract_declarations CC=65 (limit:15)
+  🟡 CC    _process_functions CC=34 (limit:15)
   🟡 CC    export_to_yaml CC=25 (limit:15)
   🟡 CC    export_flow_detailed CC=25 (limit:15)
   🟡 CC    export_flow_compact CC=23 (limit:15)
@@ -19,13 +19,13 @@ REFACTOR[1]:
 PIPELINES[637]:
   [1] Src [read_readme]: read_readme
       PURITY: 100% pure
-  [2] Src [run_benchmark]: run_benchmark → load_previous
+  [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 [__init__]: __init__
+  [5] Src [main]: main → create_html → get_shield_url
       PURITY: 100% pure
 
 LAYERS:
@@ -46,13 +46,13 @@ LAYERS:
   │ file_analyzer              398L  1C   17m  CC=12     ←0
   │ flow_exporter              391L  1C   14m  CC=10     ←0
   │ pipeline                   388L  3C   20m  CC=10     ←0
+  │ prompt                     383L  0C   16m  CC=13     ←1
+  │ !! base                       370L  0C    9m  CC=34     ←8
   │ analyzer                   333L  1C    9m  CC=14     ←0
   │ entity_resolution          326L  3C   16m  CC=13     ←0
   │ side_effects               324L  2C   17m  CC=14     ←0
   │ cli_analysis               323L  0C   11m  CC=14     ←1
   │ type_inference             321L  1C   19m  CC=9      ←0
-  │ !! base                       312L  0C    4m  CC=65     ←8
-  │ prompt                     299L  0C   13m  CC=12     ←1
   │ intent_matching            297L  3C   15m  CC=7      ←0
   │ cfg                        293L  1C   17m  CC=5      ←0
   │ data_analysis              286L  1C   18m  CC=14     ←0
@@ -80,13 +80,13 @@ LAYERS:
   │ toon_view                  157L  1C    9m  CC=6      ←0
   │ prompt_engine              150L  1C    7m  CC=12     ←0
   │ 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
   │ 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
@@ -152,7 +152,7 @@ LAYERS:
   │ sample.go                   46L  0C    4m  CC=3      ←0
   │ sample.php                  44L  2C    4m  CC=2      ←2
   │ sample                      40L  1C    4m  CC=3      ←0
-  │ sample.ts                   26L  0C    1m  CC=1      ←0
+  │ sample.ts                   26L  1C    1m  CC=1      ←0
   │
   ── zero ──
      code2llm/patterns/__init__.py             0L

batch_1/analysis.toon.yaml

@@ -1,5 +1,5 @@
-# code2llm | 113f 21241L | python:105,shell:2,php:1 | 2026-03-26
-# CC̄=4.6 | critical:10/923 | dups:0 | cycles:0
+# code2llm | 113f 21404L | python:105,shell:2,php:1 | 2026-03-26
+# CC̄=4.6 | critical:10/931 | dups:0 | cycles:0
 
 HEALTH[10]:
   🟡 CC    main CC=17 (limit:15)
@@ -10,20 +10,20 @@ HEALTH[10]:
   🟡 CC    export_flow_full CC=23 (limit:15)
   🟡 CC    _export_mermaid CC=16 (limit:15)
   🟡 CC    extract_calls_regex CC=16 (limit:15)
-  🟡 CC    _extract_declarations CC=65 (limit:15)
+  🟡 CC    _process_functions CC=34 (limit:15)
   🟡 CC    analyze_ruby CC=17 (limit:15)
 
 REFACTOR[1]:
   1. split 10 high-CC methods  (CC>15)
 
 PIPELINES[637]:
-  [1] Src [read_readme]: read_readme
+  [1] Src [run_benchmark]: run_benchmark → load_previous
       PURITY: 100% pure
-  [2] Src [run_benchmark]: run_benchmark → load_previous
+  [2] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
   [3] Src [save_report]: save_report
       PURITY: 100% pure
-  [4] Src [main]: main → load_file → is_toon_file
+  [4] Src [read_readme]: read_readme
       PURITY: 100% pure
   [5] Src [__init__]: __init__
       PURITY: 100% pure
@@ -46,13 +46,13 @@ LAYERS:
   │ file_analyzer              398L  1C   17m  CC=12     ←0
   │ flow_exporter              391L  1C   14m  CC=10     ←0
   │ pipeline                   388L  3C   20m  CC=10     ←0
+  │ prompt                     383L  0C   16m  CC=13     ←1
+  │ !! base                       370L  0C    9m  CC=34     ←8
   │ analyzer                   333L  1C    9m  CC=14     ←0
   │ entity_resolution          326L  3C   16m  CC=13     ←0
   │ side_effects               324L  2C   17m  CC=14     ←0
   │ cli_analysis               323L  0C   11m  CC=14     ←1
   │ type_inference             321L  1C   19m  CC=9      ←0
-  │ !! base                       312L  0C    4m  CC=65     ←8
-  │ prompt                     299L  0C   13m  CC=12     ←1
   │ intent_matching            297L  3C   15m  CC=7      ←0
   │ cfg                        293L  1C   17m  CC=5      ←0
   │ data_analysis              286L  1C   18m  CC=14     ←0
@@ -80,13 +80,13 @@ LAYERS:
   │ toon_view                  157L  1C    9m  CC=6      ←0
   │ prompt_engine              150L  1C    7m  CC=12     ←0
   │ 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
   │ 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
@@ -152,7 +152,7 @@ LAYERS:
   │ sample.go                   46L  0C    4m  CC=3      ←0
   │ sample.php                  44L  2C    4m  CC=2      ←2
   │ sample                      40L  1C    4m  CC=3      ←0
-  │ sample.ts                   26L  0C    1m  CC=1      ←0
+  │ sample.ts                   26L  1C    1m  CC=1      ←0
   │
   ── zero ──
      code2llm/patterns/__init__.py             0L

code2llm/__init__.py

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

code2llm/cli_commands.py

@@ -24,7 +24,7 @@ def handle_report_command(args_list) -> int:
     """Generate views from an existing project.yaml (legacy).
 
     Usage:
-        code2llm report --format toon    # → analysis_view.toon (legacy)
+        code2llm report --format toon    # → project.toon.yaml (legacy)
         code2llm report --format context # → context.md
         code2llm report --format article # → status.md
         code2llm report --format html    # → dashboard.html

code2llm/cli_parser.py

@@ -27,7 +27,7 @@ def create_parser() -> argparse.ArgumentParser:
   code2llm ./ -m static -v -o ./analysis            # Static mode, verbose
   code2llm ./ --no-readme                           # Disable README generation
   code2llm ./ -f project-yaml                       # Legacy project.yaml export (opt-in)
-  code2llm report --format toon                     # Generate analysis_view.toon from existing project.yaml
+  code2llm report --format toon                     # Generate project.toon.yaml from existing project.yaml
   code2llm report --format all                      # All legacy views from existing project.yaml
   code2llm llm-flow                                 # Generate LLM flow summary
   code2llm llm-context ./                           # Generate LLM context only

code2llm/exporters/project_yaml_exporter.py

@@ -35,7 +35,7 @@
 class ProjectYAMLExporter(Exporter):
     """Export unified project.yaml — single source of truth for diagnostics.
 
-    Combines data from analysis.toon, analysis_view.toon, context.md, and evolution.toon.yaml
+    Combines data from analysis.toon, project.toon.yaml, context.md, and evolution.toon.yaml
     into one machine-parseable YAML file.
     """
 

code2llm/exporters/readme_exporter.py

@@ -218,17 +218,17 @@ def _generate_readme_content(self, project_path: str, output_dir: Path,
 grep "SIGNATURES" map.toon.yaml
 ```
 
-### `analysis_view.toon` - Compact Analysis View
+### `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 analysis_view.toon | head -30
+cat project.toon.yaml | head -30
 
 # Find largest files
-grep -E "^  .*[0-9]{{3,}}$" analysis_view.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
@@ -427,7 +427,7 @@ def _get_existing_files(self, output_dir: Path) -> Dict[str, bool]:
             'evolution.toon.yaml': 'Refactoring queue',
             'flow.toon': 'Data flow analysis',
             'map.toon.yaml': 'Structural map',
-            'analysis_view.toon': 'Project logic',
+            'project.toon.yaml': 'Project logic',
             'prompt.txt': 'LLM prompt',
             'context.md': 'LLM narrative',
             'analysis.yaml': 'YAML data',