refactor(docs): code analysis engine

stats:
  lines: "+41/-41 (net +0)"
  files: 6
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -127,6 +127,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.25] - 2026-03-31
+
+### Docs
+- Update project/context.md
+
+### Other
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/compact_flow.mmd
+- Update project/index.html
+- Update project/project.toon.yaml
+
 ## [3.0.24] - 2026-03-31
 
 ### Docs

README.md

@@ -3,7 +3,7 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.24-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.25-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 ![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
 - 🤖 **LLM usage:** $7.5000 (52 commits)
@@ -15,7 +15,7 @@ Generated on 2026-03-31 using [openrouter/qwen/qwen3-coder-next](https://openrou
 
 
 
-![version](https://img.shields.io/badge/version-3.0.24-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.25-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.
 
@@ -155,7 +155,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.24-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.25-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.24
+3.0.25

code2docs/__init__.py

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

project/analysis.toon.yaml

@@ -2,7 +2,6 @@
 # CC̄=4.4 | critical:12/298 | dups:0 | cycles:1
 
 HEALTH[12]:
-  🟡 CC    _extract_project_metadata CC=29 (limit:15)
   🟡 CC    _render_first_usage CC=15 (limit:15)
   🟡 CC    _generate_intro CC=16 (limit:15)
   🟡 CC    parse_gitignore CC=15 (limit:15)
@@ -11,9 +10,10 @@ HEALTH[12]:
   🟡 CC    _render_module_detail CC=25 (limit:15)
   🟡 CC    _extract_description CC=17 (limit:15)
   🟡 CC    _render_module_section CC=25 (limit:15)
+  🟡 CC    _extract_project_metadata CC=29 (limit:15)
   🟡 CC    _generate_advanced CC=22 (limit:15)
-  🟡 CC    _generate_html CC=15 (limit:15)
   🟡 CC    _render_code_style CC=16 (limit:15)
+  🟡 CC    _generate_html CC=15 (limit:15)
 
 REFACTOR[2]:
   1. split 12 high-CC methods  (CC>15)

project/calls.mmd

@@ -3,31 +3,31 @@ flowchart LR
         code2docs__analyzers__project_scanner__ProjectScanner__analyze["analyze"]
     end
     subgraph code2docs__cli
+        code2docs__cli___run_check["_run_check"]
+        code2docs__cli__diff["diff"]
+        code2docs__cli___load_config["_load_config"]
+        code2docs__cli__sync["sync"]
         code2docs__cli__watch["watch"]
         code2docs__cli___run_watch["_run_watch"]
-        code2docs__cli__check["check"]
         code2docs__cli___run_sync["_run_sync"]
-        code2docs__cli__sync["sync"]
+        code2docs__cli__check["check"]
         code2docs__cli___run_diff["_run_diff"]
-        code2docs__cli__diff["diff"]
-        code2docs__cli___run_check["_run_check"]
-        code2docs__cli___load_config["_load_config"]
     end
     subgraph code2docs__config
         code2docs__config__Code2DocsConfig__from_yaml["from_yaml"]
     end
     subgraph code2docs__formatters
-        code2docs__formatters__badges___make_badge["_make_badge"]
-        code2docs__formatters__toc__extract_headings["extract_headings"]
         code2docs__formatters__toc__generate_toc["generate_toc"]
-        code2docs__formatters__toc___slugify["_slugify"]
+        code2docs__formatters__toc__extract_headings["extract_headings"]
         code2docs__formatters__badges__generate_badges["generate_badges"]
+        code2docs__formatters__badges___make_badge["_make_badge"]
+        code2docs__formatters__toc___slugify["_slugify"]
     end
     subgraph code2docs__generators
-        code2docs__generators__readme_gen__ReadmeGenerator___build_context["_build_context"]
-        code2docs__generators__readme_gen__generate_readme["generate_readme"]
-        code2docs__generators__code2llm_gen__parse_gitignore["parse_gitignore"]
         code2docs__generators__code2llm_gen__Code2LlmGenerator___run_code2llm["_run_code2llm"]
+        code2docs__generators__code2llm_gen__parse_gitignore["parse_gitignore"]
+        code2docs__generators__readme_gen__generate_readme["generate_readme"]
+        code2docs__generators__readme_gen__ReadmeGenerator___build_context["_build_context"]
     end
     subgraph code2docs__llm_helper
         code2docs__llm_helper___get_litellm["_get_litellm"]
@@ -40,11 +40,11 @@ flowchart LR
         examples__02_configuration__load_config_from_yaml["load_config_from_yaml"]
     end
     subgraph examples__03_programmatic_api
-        examples__03_programmatic_api__generate_docs_if_needed["generate_docs_if_needed"]
-        examples__03_programmatic_api__generate_full_documentation["generate_full_documentation"]
         examples__03_programmatic_api__custom_documentation_pipeline["custom_documentation_pipeline"]
         examples__03_programmatic_api__inspect_project_structure["inspect_project_structure"]
         examples__03_programmatic_api__generate_readme_simple["generate_readme_simple"]
+        examples__03_programmatic_api__generate_full_documentation["generate_full_documentation"]
+        examples__03_programmatic_api__generate_docs_if_needed["generate_docs_if_needed"]
     end
     subgraph examples__04_sync_and_watch
         examples__04_sync_and_watch__watch_and_auto_regenerate["watch_and_auto_regenerate"]
@@ -53,8 +53,8 @@ flowchart LR
         examples__05_custom_generators__generate_custom_report["generate_custom_report"]
     end
     subgraph examples__06_formatters
-        examples__06_formatters__build_custom_readme["build_custom_readme"]
         examples__06_formatters__toc_examples["toc_examples"]
+        examples__06_formatters__build_custom_readme["build_custom_readme"]
         examples__06_formatters__badge_examples["badge_examples"]
     end
     subgraph examples__07_web_frameworks
@@ -66,8 +66,8 @@ flowchart LR
     code2docs__formatters__badges__generate_badges --> code2docs__formatters__badges___make_badge
     code2docs__formatters__toc__generate_toc --> code2docs__formatters__toc__extract_headings
     code2docs__formatters__toc__extract_headings --> code2docs__formatters__toc___slugify
-    code2docs__generators__readme_gen__ReadmeGenerator___build_context --> code2docs__formatters__badges__generate_badges
     code2docs__generators__code2llm_gen__Code2LlmGenerator___run_code2llm --> code2docs__generators__code2llm_gen__parse_gitignore
+    code2docs__generators__readme_gen__ReadmeGenerator___build_context --> code2docs__formatters__badges__generate_badges
     code2docs__cli__sync --> code2docs__cli___load_config
     code2docs__cli__sync --> code2docs__cli___run_sync
     code2docs__cli__watch --> code2docs__cli___load_config
@@ -84,16 +84,16 @@ flowchart LR
     examples__06_formatters__toc_examples --> code2docs__formatters__toc__generate_toc
     examples__06_formatters__toc_examples --> code2docs__formatters__toc__extract_headings
     examples__06_formatters__build_custom_readme --> code2docs__formatters__toc__generate_toc
-    examples__07_web_frameworks__detect_flask_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
-    examples__07_web_frameworks__detect_fastapi_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
-    examples__07_web_frameworks__generate_api_docs_from_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
-    examples__07_web_frameworks__document_web_project --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
-    examples__07_web_frameworks__document_web_project --> examples__07_web_frameworks__generate_api_docs_from_endpoints
-    examples__02_configuration__load_config_from_yaml --> code2docs__config__Code2DocsConfig__from_yaml
     examples__03_programmatic_api__generate_readme_simple --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
     examples__03_programmatic_api__generate_readme_simple --> code2docs__generators__readme_gen__generate_readme
     examples__03_programmatic_api__generate_full_documentation --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
     examples__03_programmatic_api__custom_documentation_pipeline --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
     examples__03_programmatic_api__inspect_project_structure --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
     examples__03_programmatic_api__generate_docs_if_needed --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
+    examples__02_configuration__load_config_from_yaml --> code2docs__config__Code2DocsConfig__from_yaml
+    examples__07_web_frameworks__detect_flask_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
+    examples__07_web_frameworks__detect_fastapi_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
+    examples__07_web_frameworks__generate_api_docs_from_endpoints --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
+    examples__07_web_frameworks__document_web_project --> code2docs__analyzers__project_scanner__ProjectScanner__analyze
+    examples__07_web_frameworks__document_web_project --> examples__07_web_frameworks__generate_api_docs_from_endpoints
     code2docs__llm_helper__LLMHelper__complete --> code2docs__llm_helper___get_litellm

project/compact_flow.mmd

@@ -19,5 +19,5 @@ flowchart TD
     code2docs__cli -->|1| code2docs__sync
     examples__04_sync_and_watch -->|1| code2docs__sync
     examples__05_custom_generators -->|1| code2docs__analyzers
-    examples__02_configuration -->|1| code2docs__config
     examples__03_programmatic_api -->|1| code2docs__generators
+    examples__02_configuration -->|1| code2docs__config

project/context.md

@@ -440,18 +440,6 @@ Filters out:
 > Parse an examples line.
 - **Output to**: info.examples.append
 
-### code2docs.analyzers.endpoint_detector.EndpointDetector._parse_decorator
-> Try to parse a route decorator string.
-- **Output to**: self.FASTAPI_PATTERNS.search, self.FLASK_PATTERNS.search, Endpoint, Endpoint, None.upper
-
-### examples.05_custom_generators.MetricsReportGenerator._format_stats_table
-> Format statistics as markdown table.
-- **Output to**: stats.items, None.join, lines.append
-
-### examples.06_formatters.markdown_formatting_examples
-> Demonstrate markdown formatting utilities.
-- **Output to**: MarkdownFormatter, print, print, print, print
-
 ### code2docs.analyzers.dependency_scanner.DependencyScanner._parse_pyproject
 > Parse pyproject.toml for dependencies.
 - **Output to**: ProjectDependencies, data.get, project.get, project.get, project.get
@@ -484,6 +472,18 @@ Filters out:
 > Parse a dependency string like 'package>=1.0'.
 - **Output to**: re.match, DependencyInfo, dep_str.strip, DependencyInfo, dep_str.strip
 
+### code2docs.analyzers.endpoint_detector.EndpointDetector._parse_decorator
+> Try to parse a route decorator string.
+- **Output to**: self.FASTAPI_PATTERNS.search, self.FLASK_PATTERNS.search, Endpoint, Endpoint, None.upper
+
+### examples.05_custom_generators.MetricsReportGenerator._format_stats_table
+> Format statistics as markdown table.
+- **Output to**: stats.items, None.join, lines.append
+
+### examples.06_formatters.markdown_formatting_examples
+> Demonstrate markdown formatting utilities.
+- **Output to**: MarkdownFormatter, print, print, print, print
+
 ## Behavioral Patterns
 
 ### recursion_analyze
@@ -539,7 +539,7 @@ Functions exposed as public API (no underscore prefix):
 - `code2docs.generators.org_readme_gen.OrgReadmeGenerator.generate` - 8 calls
 - `code2docs.cli.sync` - 8 calls
 - `examples.03_programmatic_api.custom_documentation_pipeline` - 8 calls
-- `code2docs.generators._registry_adapters.Code2LlmAdapter.run` - 7 calls
+- `code2docs.cli.watch` - 7 calls
 
 ## System Interactions
 

project/index.html

@@ -43,9 +43,9 @@ Requires watchdog
   ★ OrgReadmeGenerator._extract_description fan=20  // Extract short description from project (max 5 lines).
 
 REFACTOR[15]:
-  [1] H/L Split ReadmeGenerator._extract_project_metadata (CC=29 → target CC<10)
-  [2] H/L Split ModuleDocsGenerator._render_module_detail (CC=25 → target CC<10)
-  [3] H/L Split ApiReferenceGenerator._render_module_section (CC=25 → target CC<10)
+  [1] H/L Split ModuleDocsGenerator._render_module_detail (CC=25 → target CC<10)
+  [2] H/L Split ApiReferenceGenerator._render_module_section (CC=25 → target CC<10)
+  [3] H/L Split ReadmeGenerator._extract_project_metadata (CC=29 → target CC<10)
   [4] M/L Split GettingStartedGenerator._render_first_usage (CC=15 → target CC<10)
   [5] M/L Split GettingStartedGenerator._generate_intro (CC=16 → target CC<10)