refactor(docs): code analysis engine

tom-sapletta-com · tom-sapletta-com · commit f5ad59671b86 · 2026-03-26T10:15:36.000+01:00
stats:
  lines: "+265/-270 (net -5)"
  files: 14
  complexity: "Stable complexity"
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,24 @@
 ## [Unreleased]
 
+## [0.5.96] - 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/compact_flow.png
+- Update project/evolution.toon.yaml
+- Update project/flow.mmd
+- Update project/index.html
+- Update project/map.toon.yaml
+- Update project/project.toon.yaml
+- ... and 1 more files
+
 ## [0.5.95] - 2026-03-26
 
 ### Docs
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.5.95
+0.5.96
diff --git a/code2llm/__init__.py b/code2llm/__init__.py
@@ -8,7 +8,7 @@
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.95"
+__version__ = "0.5.96"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)
diff --git a/code2llm/nlp/__init__.py b/code2llm/nlp/__init__.py
@@ -4,7 +4,7 @@
 with multilingual support and fuzzy matching.
 """
 
-__version__ = "0.5.95"
+__version__ = "0.5.96"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer
diff --git a/project/README.md b/project/README.md
@@ -332,7 +332,7 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-26  
-**Total Functions**: 934  
+**Total Functions**: 933  
 **Total Classes**: 106  
 **Modules**: 117  
 
diff --git a/project/analysis.toon.yaml b/project/analysis.toon.yaml
@@ -1,5 +1,5 @@
-# code2llm | 113f 21539L | python:105,shell:2,php:1 | 2026-03-26
-# CC̄=4.6 | critical:11/934 | dups:0 | cycles:0
+# code2llm | 113f 21511L | python:105,shell:2,php:1 | 2026-03-26
+# CC̄=4.6 | critical:11/933 | dups:0 | cycles:0
 
 HEALTH[11]:
   🟡 CC    main CC=17 (limit:15)
@@ -38,12 +38,12 @@ LAYERS:
   │ !! html_dashboard             504L  1C   14m  CC=7      ←0
   │ !! metrics                    501L  1C   27m  CC=12     ←0
   │ readme_exporter            496L  1C    7m  CC=13     ←0
-  │ !! prompt                     492L  0C   18m  CC=16     ←1
   │ large_repo                 488L  2C   20m  CC=9      ←1
   │ mermaid                    485L  0C   16m  CC=13     ←1
   │ llm_flow                   472L  1C   24m  CC=14     ←0
   │ evolution_exporter         471L  1C   17m  CC=11     ←0
   │ renderer                   471L  1C   26m  CC=11     ←0
+  │ !! prompt                     464L  0C   17m  CC=16     ←1
   │ !! map_exporter               435L  1C   21m  CC=25     ←4
   │ file_analyzer              398L  1C   17m  CC=12     ←0
   │ flow_exporter              391L  1C   14m  CC=10     ←0
diff --git a/project/calls.mmd b/project/calls.mmd
diff --git a/project/calls.png b/project/calls.png
diff --git a/project/compact_flow.mmd b/project/compact_flow.mmd
@@ -6,7 +6,7 @@ flowchart TD
     code2llm_cli["code2llm.cli<br/>1 funcs"]
     code2llm_cli_analysis["code2llm.cli_analysis<br/>11 funcs"]
     code2llm_cli_commands["code2llm.cli_commands<br/>6 funcs"]
-    code2llm_cli_exports["code2llm.cli_exports<br/>43 funcs"]
+    code2llm_cli_exports["code2llm.cli_exports<br/>42 funcs"]
     code2llm_cli_parser["code2llm.cli_parser<br/>1 funcs"]
     code2llm_core["code2llm.core<br/>140 funcs"]
     code2llm_exporters["code2llm.exporters<br/>257 funcs"]
@@ -25,5 +25,5 @@ flowchart TD
     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_exports -->|1| code2llm_core
     code2llm_cli_exports -->|1| code2llm_generators
+    code2llm_cli_exports -->|1| code2llm_core
diff --git a/project/compact_flow.png b/project/compact_flow.png
diff --git a/project/context.md b/project/context.md
@@ -6,7 +6,7 @@
 - **Primary Language**: python
 - **Languages**: python: 114, shell: 2, php: 1
 - **Analysis Mode**: static
-- **Total Functions**: 934
+- **Total Functions**: 933
 - **Total Classes**: 106
 - **Modules**: 117
 - **Entry Points**: 695
@@ -73,10 +73,6 @@
 - **Classes**: 1
 - **File**: `mermaid_exporter.py`
 
-### code2llm.cli_exports.prompt
-- **Functions**: 18
-- **File**: `prompt.py`
-
 ### code2llm.analysis.side_effects
 - **Functions**: 17
 - **Classes**: 2
@@ -97,6 +93,10 @@
 - **Classes**: 1
 - **File**: `evolution_exporter.py`
 
+### code2llm.cli_exports.prompt
+- **Functions**: 17
+- **File**: `prompt.py`
+
 ### code2llm.nlp.entity_resolution
 - **Functions**: 16
 - **Classes**: 3
@@ -446,6 +446,13 @@ Key functions that process and transform data:
 > Oceń pojedynczy format względem ground truth.
 - **Output to**: FormatScore, benchmarks.format_evaluator._detect_problems, sum, benchmarks.format_evaluator._detect_pipelines, sum
 
+### scripts.bump_version.parse_version
+> Parse version string into tuple of (major, minor, patch)
+- **Output to**: version_str.split, tuple, int
+
+### scripts.bump_version.format_version
+> Format version tuple as string
+
 ### scripts.benchmark_badges.parse_evolution_metrics
 > Extract metrics from evolution.toon content.
 - **Output to**: toon_content.splitlines, re.search, line.strip, line.startswith, m.group
@@ -462,13 +469,6 @@ Key functions that process and transform data:
 > Generate badges from format quality scores.
 - **Output to**: enumerate, badges.append, sorted, badges.append, format_scores.items
 
-### scripts.bump_version.parse_version
-> Parse version string into tuple of (major, minor, patch)
-- **Output to**: version_str.split, tuple, int
-
-### scripts.bump_version.format_version
-> Format version tuple as string
-
 ### code2llm.cli_parser.create_parser
 > Create CLI argument parser.
 - **Output to**: argparse.ArgumentParser, parser.add_argument, parser.add_argument, parser.add_argument, parser.add_argument
@@ -498,14 +498,6 @@ Checks:
 > Load gitignore parser for project if available.
 - **Output to**: code2llm.core.gitignore.load_gitignore_patterns
 
-### code2llm.core.large_repo.HierarchicalRepoSplitter._process_large_dirs
-> Process large directories with file-level chunking.
-- **Output to**: self._chunk_by_files, chunks.extend
-
-### code2llm.core.large_repo.HierarchicalRepoSplitter._process_level1_files
-> 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.core.gitignore.GitIgnoreParser._parse_pattern
 > Parse a single gitignore pattern into regex.
 - **Output to**: pattern.startswith, pattern.endswith, pattern.startswith, self._wildcard_to_regex, re.compile
@@ -516,14 +508,22 @@ Checks:
 Returns list of (module_name, start_line, end_line).
 - **Output to**: content.split, enumerate, modules.append, line.startswith, line.endswith
 
-### code2llm.core.file_filter.FastFileFilter.should_process
-> 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.large_repo.HierarchicalRepoSplitter._process_large_dirs
+> Process large directories with file-level chunking.
+- **Output to**: self._chunk_by_files, chunks.extend
+
+### code2llm.core.large_repo.HierarchicalRepoSplitter._process_level1_files
+> 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.core.file_filter.FastFileFilter.should_process
+> Check if file should be processed.
+- **Output to**: file_path.lower, Path, self._gitignore_parser.is_ignored, any, fnmatch.fnmatch
+
 ### code2llm.core.file_analyzer.FileAnalyzer._process_class
 > Process class definition.
 - **Output to**: ClassInfo, None.classes.append, isinstance, isinstance, methods.append
diff --git a/project/evolution.toon.yaml b/project/evolution.toon.yaml
@@ -1,4 +1,4 @@
-# code2llm/evolution | 756 func | 83f | 2026-03-26
+# code2llm/evolution | 755 func | 83f | 2026-03-26
 
 NEXT[10] (ranked by impact):
   [1] !! SPLIT           code2llm/exporters/mermaid_exporter.py
diff --git a/project/flow.mmd b/project/flow.mmd
@@ -19,7 +19,7 @@ flowchart TD
         code2llm__cli_commands__handle_special_commands["handle_special_commands"]
         code2llm__cli_commands__handle_report_command["handle_report_command"]
         code2llm__cli_commands__validate_and_setup["validate_and_setup"]
-        ...["+46 more"]
+        ...["+45 more"]
     end
 
     subgraph Core
@@ -60,4 +60,4 @@ flowchart TD
         ...["+224 more"]
     end
 
-    class setup__read_readme,validate_toon__main,badges__server__index,badges__server__generate_badges,badges__server__get_badges,code2llm__cli__main,code2llm__api__analyze,code2llm__api__analyze_file,code2llm__cli_analysis___run_analysis,code2llm__cli_analysis___run_standard_analysis entry
+    class setup__read_readme,validate_toon__main,code2llm__cli__main,badges__server__index,badges__server__generate_badges,badges__server__get_badges,code2llm__api__analyze,code2llm__api__analyze_file,code2llm__cli_analysis___run_analysis,code2llm__cli_analysis___run_standard_analysis entry
diff --git a/project/index.html b/project/index.html
diff --git a/project/map.toon.yaml b/project/map.toon.yaml
@@ -1,5 +1,5 @@
-# code2llm | 108f 21333L | python:105,php:1,shell:2 | 2026-03-26
-# stats: 830 func | 0 cls | 108 mod | CC̄=4.6 | critical:11 | cycles:0
+# code2llm | 108f 21305L | python:105,php:1,shell:2 | 2026-03-26
+# stats: 829 func | 0 cls | 108 mod | CC̄=4.6 | critical:11 | cycles:0
 # alerts[5]: CC _process_functions=34; CC MapExporter.export_to_yaml=25; CC MermaidExporter.export_flow_detailed=25; fan-out analyze_rust=24; fan-out MapExporter.export_to_yaml=23
 # hotspots[5]: analyze_rust fan=24; MapExporter.export_to_yaml fan=23; analyze_go fan=22; MermaidExporter.export_flow_detailed fan=21; _summarize_functions fan=21
 # evolution: CC̄ 4.8→4.6 (improved -0.2)
@@ -33,7 +33,7 @@ M[108]:
   code2llm/cli_exports/code2logic.py,127
   code2llm/cli_exports/formats.py,287
   code2llm/cli_exports/orchestrator.py,149
-  code2llm/cli_exports/prompt.py,492
+  code2llm/cli_exports/prompt.py,464
   code2llm/cli_parser.py,277
   code2llm/core/__init__.py,53
   code2llm/core/analyzer.py,333
@@ -167,7 +167,7 @@ D:
     _export_refactor_prompts(args;result;output_dir)
     _export_index_html(args;output_dir)
   code2llm/cli_exports/prompt.py:
-    e: _export_prompt_txt,_export_chunked_prompt_txt,_get_prompt_paths,_build_prompt_header,_find_existing_prompt_file,_build_prompt_file_lines,_build_main_files_section,_build_optional_files_section,_build_source_files_section,_format_size,_get_missing_files,_build_subprojects_section,_build_missing_files_section,_analyze_generated_files,_build_dynamic_focus_areas,_build_dynamic_tasks,_build_priority_order,_build_prompt_footer
+    e: _export_prompt_txt,_export_chunked_prompt_txt,_get_prompt_paths,_build_prompt_header,_find_existing_prompt_file,_build_prompt_file_lines,_build_main_files_section,_build_optional_files_section,_format_size,_get_missing_files,_build_subprojects_section,_build_missing_files_section,_analyze_generated_files,_build_dynamic_focus_areas,_build_dynamic_tasks,_build_priority_order,_build_prompt_footer
     _export_prompt_txt(args;output_dir;formats;source_path)
     _export_chunked_prompt_txt(args;output_dir;formats;source_path;subprojects)
     _get_prompt_paths(source_path;output_dir)
@@ -176,7 +176,6 @@ D:
     _build_prompt_file_lines(output_dir;output_rel_path;files)
     _build_main_files_section(output_dir;output_rel_path)
     _build_optional_files_section(output_dir;output_rel_path)
-    _build_source_files_section(source_path)
     _format_size(size_bytes)
     _get_missing_files(output_dir)
     _build_subprojects_section(subprojects;output_dir;output_rel_path)
@@ -398,9 +397,6 @@ Sections: P...
   code2llm/analysis/type_inference.py:
     e: TypeInferenceEngine
     TypeInferenceEngine: __init__(0),enrich_function(1),get_arg_types(1),get_return_type(1),get_typed_signature(1),extract_all_types(1),_get_ast(1),_find_function_node(3),_extract_from_node(2),_extract_args(1),_annotation_to_str(1),_ann_constant(1),_ann_name(1),_ann_attribute(1),_ann_subscript(1),_ann_tuple(1),_ann_binop(1),_infer_from_name(1),_infer_arg_type(1)  # Extract and infer type information from Python source files...
-  code2llm/analysis/call_graph.py:
-    e: CallGraphExtractor
-    CallGraphExtractor(ast.NodeVisitor): __init__(1),extract(3),_calculate_metrics(0),visit_Import(1),visit_ImportFrom(1),visit_ClassDef(1),visit_FunctionDef(1),visit_AsyncFunctionDef(1),visit_Call(1),_qualified_name(1),_resolve_call(1),_resolve_with_astroid(1),_expr_to_str(1)  # Extract call graph from AST...
   code2llm/core/large_repo.py:
     e: SubProject,HierarchicalRepoSplitter,should_use_chunking,get_analysis_plan
     SubProject:  # Represents a sub-project within a larger repository...
@@ -412,6 +408,9 @@ Stra...
   code2llm/core/refactoring.py:
     e: RefactoringAnalyzer
     RefactoringAnalyzer: __init__(2),perform_refactoring_analysis(1),_build_call_graph(1),_calculate_centrality(2),_detect_cycles(2),_detect_communities(2),_analyze_coupling(1),_detect_smells(1),_detect_dead_code(1),_map_dead_code_to_items(2),_mark_reachable_items(1)  # Performs refactoring analysis on code...
+  code2llm/analysis/call_graph.py:
+    e: CallGraphExtractor
+    CallGraphExtractor(ast.NodeVisitor): __init__(1),extract(3),_calculate_metrics(0),visit_Import(1),visit_ImportFrom(1),visit_ClassDef(1),visit_FunctionDef(1),visit_AsyncFunctionDef(1),visit_Call(1),_qualified_name(1),_resolve_call(1),_resolve_with_astroid(1),_expr_to_str(1)  # Extract call graph from AST...
   code2llm/exporters/toon/__init__.py:
     e: ToonExporter
     ToonExporter: __init__(0),export(2),export_to_yaml(2),_build_header_dict(1),_build_health_dict(1),_build_refactor_dict(1),_build_pipelines_dict(1),_build_layers_dict(1),_build_coupling_dict(1),_build_external_dict(1),_is_excluded(1)  # Export to toon v2 plain-text format — scannable, sorted by s...
diff --git a/project/project.toon.yaml b/project/project.toon.yaml
@@ -1,4 +1,4 @@
-# code2llm | 830 func | 97f | 26529L | python | 2026-03-26
+# code2llm | 829 func | 97f | 26477L | python | 2026-03-26
 
 HEALTH:
   CC̄=4.6  critical=73 (limit:10)  dup=1  cycles=0
@@ -23,12 +23,12 @@ MODULES[113] (top by size):
   M[code2llm/exporters/html_dashboard.py] 504L C:1 F:14 CC↑7 D:0 (python)
   M[code2llm/exporters/toon/metrics.py] 501L C:1 F:27 CC↑12 D:0 (python)
   M[code2llm/exporters/readme_exporter.py] 496L C:1 F:7 CC↑13 D:0 (python)
-  M[code2llm/cli_exports/prompt.py] 492L C:0 F:18 CC↑16 D:1 (python)
   M[code2llm/core/large_repo.py] 488L C:2 F:20 CC↑9 D:1 (python)
   M[code2llm/generators/mermaid.py] 485L C:0 F:16 CC↑13 D:1 (python)
   M[code2llm/generators/llm_flow.py] 472L C:1 F:24 CC↑14 D:0 (python)
   M[code2llm/exporters/evolution_exporter.py] 471L C:1 F:17 CC↑11 D:0 (python)
   M[code2llm/exporters/toon/renderer.py] 471L C:1 F:26 CC↑11 D:0 (python)
+  M[code2llm/cli_exports/prompt.py] 464L C:0 F:17 CC↑16 D:1 (python)
   M[code2llm/exporters/map_exporter.py] 435L C:1 F:21 CC↑25 D:4 (python)
   M[code2llm/core/file_analyzer.py] 398L C:1 F:17 CC↑12 D:0 (python)
   LANGS: python:106/shell:2/go:1/java:1/php:1/rust:1/typescript:1
@@ -48,4 +48,4 @@ REFACTOR[15]:
   [5] H/H Split god module code2llm/analysis/pipeline_detector.py (506L, 3 classes)
 
 EVOLUTION:
-  2026-03-26 CC̄=4.6 crit=73 26529L // Automated analysis
+  2026-03-26 CC̄=4.6 crit=73 26477L // Automated analysis
diff --git a/project/prompt.txt b/project/prompt.txt
@@ -14,10 +14,6 @@ Note: project/validation.toon.yaml and project/duplication.toon.yaml are generat
 - project/context.md  (LLM narrative - architecture summary and project context) [37KB]
 - project/README.md  (Generated documentation - overview and usage guide) [9KB]
 
-Source files:
-
-- code2llm/cli_exports/orchestrator.py  (Export orchestration - coordinates single-project and chunked export flows, including prompt generation) [4KB]
-
 Task:
 - Treat this prompt as a refactoring brief: identify the highest-priority changes and prepare concrete edits.
 - Use the file set to decide whether the first pass should focus on correctness, duplication, complexity reduction, or architecture cleanup.
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2llm"
-version = "0.5.95"
+version = "0.5.96"
 description = "High-performance Python code flow analysis with optimized TOON format - CFG, DFG, call graphs, and intelligent code queries"
 readme = "README.md"
 requires-python = ">=3.8"
diff --git a/setup.py b/setup.py
@@ -4,7 +4,7 @@
 import os
 
 # Read version
-version = "0.5.94"
+version = "0.5.95"
 
 # Read long description
 def read_readme():
