refactor(docs): code analysis engine

stats:
  lines: "+16071/-62600 (net -46529)"
  files: 18
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.12] - 2026-03-09
+
+### Docs
+- Update code2docs/project/README.md
+- Update code2docs/project/context.md
+- Update docs/README.md
+- Update docs/api-changelog.md
+- Update docs/architecture.md
+- Update docs/configuration.md
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/project/README.md
+- Update tests/project/analysis.toon
+- Update tests/project/dashboard.html
+- Update tests/project/evolution.toon
+- Update tests/project/flow.toon
+- Update tests/project/project.yaml
+
+### Other
+- Update code2docs/project/analysis.json
+- Update code2docs/project/analysis.toon
+- Update code2docs/project/analysis.yaml
+- Update code2docs/project/calls.mmd
+- Update code2docs/project/dashboard.html
+- Update code2docs/project/evolution.toon
+- Update code2docs/project/flow.mmd
+- Update code2docs/project/flow.toon
+- Update code2docs/project/map.toon
+- Update code2docs/project/project.yaml
+- ... and 13 more files
+
 ## [3.0.11] - 2026-03-09
 
 ### Other

README.md

@@ -1,6 +1,6 @@
 # code2docs
 
-![version](https://img.shields.io/badge/version-3.0.11-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
+![version](https://img.shields.io/badge/version-3.0.12-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
 
 > Auto-generate and sync project documentation from source code analysis.
 
@@ -140,7 +140,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-3.0.11-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-276-green)
+![version](https://img.shields.io/badge/version-3.0.12-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-276-green)
 > **276** functions | **57** classes | **51** files | CC̄ = 3.8
 
 > Auto-generated project documentation from source code analysis.

VERSION

@@ -1 +1 @@
-3.0.11
+3.0.12

code2docs/__init__.py

@@ -5,7 +5,7 @@
 README.md, API references, module docs, examples, and architecture diagrams.
 """
 
-__version__ = "3.0.11"
+__version__ = "3.0.12"
 __author__ = "Tom Sapletta"
 
 from .config import Code2DocsConfig

code2docs/project/README.md

@@ -337,7 +337,7 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-08  
+**Analysis Date**: 2026-03-09  
 **Total Functions**: 252  
 **Total Classes**: 56  
 **Modules**: 40  

code2docs/project/analysis.json

@@ -1,4 +1,4 @@
-# code2llm | 38f 5373L | py:38 | 2026-03-08
+# code2llm | 38f 5373L | py:38 | 2026-03-09
 # CC̄=4.2 | critical:25/252 | dups:0 | cycles:1
 
 HEALTH[10]:
@@ -100,9 +100,9 @@ FUNCTIONS (CC≥10, 25 of 252):
    11.0  ArchitectureGenerator._generate_class_diagram   12n   2exit  loops+cond+ret
    10.0  ConfigDocsGenerator._render_section        14n   2exit  loops+cond+ret
    10.0  ApiReferenceGenerator._has_content          6n   3exit  cond+ret
-   10.0  _run_check                                 11n   1exit  loops+cond
    10.0  ApiChangelogGenerator._diff_functions       9n   1exit  loops+cond
    10.0  ApiChangelogGenerator._diff_classes        15n   1exit  loops+cond
+   10.0  _run_check                                 11n   1exit  loops+cond
    10.0  Code2DocsConfig.from_yaml                  20n   3exit  cond+ret
 
   summary:
@@ -146,8 +146,8 @@ CLASSES:
   Code2LlmGenerator              █████                      4m  CC̄=6.2   max=17    !!
   Code2DocsConfig                █████                      4m  CC̄=4.0   max=10  
   BaseGenerator                  ████                       3m  CC̄=1.0   max=1   
-  EndpointDetector               ████                       3m  CC̄=4.0   max=5   
   ProjectScanner                 ████                       3m  CC̄=1.3   max=2   
+  EndpointDetector               ████                       3m  CC̄=4.0   max=5   
   Updater                        ██                         2m  CC̄=3.0   max=4   
   ReadmeGeneratorAdapter         ██                         2m  CC̄=2.5   max=4   
   ApiReferenceAdapter            ██                         2m  CC̄=2.0   max=2   
@@ -174,10 +174,10 @@ CLASSES:
   ExamplesConfig                                            0m  CC̄=0.0   max=0.0 
   SyncConfig                                                0m  CC̄=0.0   max=0.0 
   Code2LlmConfig                                            0m  CC̄=0.0   max=0.0 
-  Endpoint                                                  0m  CC̄=0.0   max=0.0 
+  DocstringInfo                                             0m  CC̄=0.0   max=0.0 
   DependencyInfo                                            0m  CC̄=0.0   max=0.0 
   ProjectDependencies                                       0m  CC̄=0.0   max=0.0 
-  DocstringInfo                                             0m  CC̄=0.0   max=0.0 
+  Endpoint                                                  0m  CC̄=0.0   max=0.0 
 
 D:
   generators/readme_gen.py:
@@ -273,6 +273,15 @@ Thi...
     e: ContributingGenerator
     ContributingGenerator  # Generate CONTRIBUTING.md by detecting dev tools from pyproje...
       __init__(2)  CC=1.0
+  analyzers/docstring_extractor.py:
+    e: DocstringInfo,DocstringExtractor
+    DocstringInfo  # Parsed docstring with sections....
+    DocstringExtractor  # Extract and parse docstrings from AnalysisResult....
+      extract_all(1)  CC=5.0
+        → parse(1)  CC=2.0
+        → _extract_summary(0)  CC=2.0
+        → _parse_sections(2)  CC=8.0
+        → _classify_section(0)  CC=5.0
   analyzers/dependency_scanner.py:
     e: DependencyInfo,ProjectDependencies,DependencyScanner
     DependencyInfo  # Information about a project dependency....
@@ -285,15 +294,6 @@ Thi...
         → _parse_dep_string(0)  CC=2.0
         → _parse_setup_py(1)  CC=4.0
         → _parse_requirements_txt(1)  CC=5.0
-  analyzers/docstring_extractor.py:
-    e: DocstringInfo,DocstringExtractor
-    DocstringInfo  # Parsed docstring with sections....
-    DocstringExtractor  # Extract and parse docstrings from AnalysisResult....
-      extract_all(1)  CC=5.0
-        → parse(1)  CC=2.0
-        → _extract_summary(0)  CC=2.0
-        → _parse_sections(2)  CC=8.0
-        → _classify_section(0)  CC=5.0
   llm_helper.py:
     e: LLMHelper,_get_litellm
     LLMHelper  # Thin wrapper around litellm for documentation generation.