refactor(docs): code analysis engine

changes:
  - file: prompt.py
    area: cli
    added: [_build_source_files_section]
    modified: [_export_chunked_prompt_txt, _export_prompt_txt]
  - file: readme_exporter.py
    area: docs
    modified: [READMEExporter, _generate_readme_content]
  - file: test_prompt_txt.py
    area: test
    added: [temp_source_dir]
    new_tests: 1
    modified: [TestPromptTxtGeneration]

testing:
  new_tests: 1
  scenarios:
    - prompt_txt_includes_orchestrator_source_file_description

stats:
  lines: "+593/-292 (net +301)"
  files: 17
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,27 @@
 ## [Unreleased]
 
+## [0.5.84] - 2026-03-26
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/test_prompt_txt.py
+
+### Other
+- Update code2llm/cli_exports/prompt.py
+- Update code2llm/exporters/readme_exporter.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.83] - 2026-03-26
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.5.83
+0.5.84

code2llm/__init__.py

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

code2llm/cli_exports/prompt.py

@@ -14,6 +14,7 @@ def _export_prompt_txt(args, output_dir: Path, formats: list[str], source_path:
     lines = _build_prompt_header(project_path)
     lines.extend(_build_main_files_section(output_dir, output_rel_path))
     lines.extend(_build_optional_files_section(output_dir, output_rel_path))
+    lines.extend(_build_source_files_section(source_path))
 
     missing = _get_missing_files(output_dir)
     if missing:
@@ -41,6 +42,7 @@ def _export_chunked_prompt_txt(args, output_dir: Path, formats: list[str], sourc
     lines = _build_prompt_header(project_path)
     lines.extend(_build_main_files_section(output_dir, output_rel_path))
     lines.extend(_build_optional_files_section(output_dir, output_rel_path))
+    lines.extend(_build_source_files_section(source_path))
 
     if subprojects:
         lines.extend(_build_subprojects_section(subprojects, output_dir, output_rel_path))
@@ -94,6 +96,11 @@ def _get_prompt_paths(source_path: Optional[Path], output_dir: Path) -> Tuple[st
 ]
 
 
+_SOURCE_FILES = [
+    ('code2llm/cli_exports/orchestrator.py', 'Export orchestration - coordinates single-project and chunked export flows, including prompt generation'),
+]
+
+
 def _build_prompt_header(project_path: str) -> List[str]:
     """Build header section of prompt."""
     return [
@@ -145,6 +152,27 @@ def _build_optional_files_section(output_dir: Path, output_rel_path: str) -> Lis
     return ["", "Optional files:", ""] + lines
 
 
+def _build_source_files_section(source_path: Optional[Path]) -> List[str]:
+    """Build source files section with size metrics."""
+    if source_path is None:
+        return []
+
+    source_root = source_path if source_path.is_dir() else source_path.parent
+    lines = []
+    for rel_path, desc in _SOURCE_FILES:
+        file_path = source_root / rel_path
+        if not file_path.exists():
+            continue
+
+        size_str = _format_size(file_path.stat().st_size)
+        lines.append(f"- {rel_path}  ({desc}) [{size_str}]")
+
+    if not lines:
+        return []
+
+    return ["", "Source files:", ""] + lines
+
+
 def _format_size(size_bytes: int) -> str:
     """Format file size in human readable format."""
     if size_bytes < 1024:

code2llm/exporters/readme_exporter.py

@@ -235,6 +235,7 @@ def _generate_readme_content(self, project_path: str, output_dir: Path,
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
+- **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
 - **Requirements section**: Guidelines for suggested changes

code2llm/nlp/__init__.py

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

project/README.md

@@ -331,6 +331,6 @@ code2llm ./ -f yaml --separate-orphans
 **Analysis Date**: 2026-03-26  
 **Total Functions**: 931  
 **Total Classes**: 106  
-**Modules**: 122  
+**Modules**: 117  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm

project/analysis.toon.yaml

@@ -1,31 +1,31 @@
-# code2llm | 113f 21404L | python:108,shell:4,php:1 | 2026-03-26
+# 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    _process_functions CC=34 (limit:15)
+  🟡 CC    main CC=17 (limit:15)
+  🟡 CC    validate_chunked_output CC=15 (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)
+  🟡 CC    export_flow_detailed CC=25 (limit:15)
   🟡 CC    export_flow_full CC=23 (limit:15)
-  🟡 CC    main CC=17 (limit:15)
-  🟡 CC    analyze_ruby CC=17 (limit:15)
   🟡 CC    _export_mermaid CC=16 (limit:15)
   🟡 CC    extract_calls_regex CC=16 (limit:15)
-  🟡 CC    validate_chunked_output CC=15 (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
       PURITY: 100% pure
-  [2] Src [run_benchmark]: run_benchmark → load_previous
+  [2] Src [save_report]: save_report
       PURITY: 100% pure
-  [3] Src [save_report]: save_report
+  [3] Src [run_benchmark]: run_benchmark → load_previous
       PURITY: 100% pure
   [4] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
-  [5] Src [main]: main → create_html → get_shield_url
+  [5] Src [__init__]: __init__
       PURITY: 100% pure
 
 LAYERS: