refactor(docs): code analysis engine

changes:
  - file: pipeline_detector.py
    area: analyzer
    added: [_try_same_class_resolution, _get_suffix_candidates, _select_same_class_candidate, _strip_self_prefix]
    modified: [_resolve_callee, PipelineDetector]
  - file: cli_analysis.py
    area: analyzer
    modified: [_run_streaming_analysis]
  - file: cli_commands.py
    area: cli
    modified: [validate_chunked_output]
  - file: evolution_exporter.py
    area: core
    modified: [EvolutionExporter, _render_history]
  - file: map_exporter.py
    area: core
    modified: [_read_previous_cc_avg, _render_header, MapExporter, _load_evolution_trend]
  - file: project_yaml_exporter.py
    area: core
    modified: [ProjectYAMLExporter]
  - file: test_prompt_txt.py
    area: test
    modified: [TestPromptTxtGeneration, test_prompt_txt_content_structure, test_prompt_txt_lists_existing_files]

stats:
  lines: "+160982/-1037 (net +159945)"
  files: 21
  complexity: "+86% complexity (monitor)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,27 @@
 ## [Unreleased]
 
+## [0.5.69] - 2026-03-25
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/test_prompt_txt.py
+
+### Other
+- Update code2llm/analysis/pipeline_detector.py
+- Update code2llm/cli_analysis.py
+- Update code2llm/cli_commands.py
+- Update code2llm/exporters/evolution_exporter.py
+- Update code2llm/exporters/map_exporter.py
+- Update code2llm/exporters/project_yaml_exporter.py
+- Update project/analysis.json
+- Update project/analysis.toon.yaml
+- Update project/analysis.yaml
+- Update project/calls.mmd
+- ... and 8 more files
+
 ## [0.5.68] - 2026-03-25
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.5.68
+0.5.69

code2llm/__init__.py

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

code2llm/analysis/pipeline_detector.py

@@ -451,36 +451,56 @@ def _resolve_callee(
         Returns None for ambiguous matches (multiple candidates)
         to avoid creating phantom pipeline edges.
         """
+        # Direct match
         if callee in funcs:
             return callee
 
-        # Strip self. prefix for method→method calls
-        bare = callee
-        is_self_call = False
+        bare, is_self_call = self._strip_self_prefix(callee)
+
+        # Try same-class resolution first
+        if result := self._try_same_class_resolution(bare, caller, funcs):
+            return result
+
+        # Suffix match
+        candidates = self._get_suffix_candidates(bare, funcs)
+        if len(candidates) == 1:
+            return candidates[0]
+
+        # Prefer same-class candidates for method calls
+        return self._select_same_class_candidate(candidates, caller, is_self_call)
+
+    def _strip_self_prefix(self, callee: str) -> Tuple[str, bool]:
+        """Strip self. prefix and return bare name + flag."""
         if callee.startswith("self."):
-            bare = callee[5:]  # strip "self."
-            is_self_call = True
+            return callee[5:], True
+        return callee, False
 
-        # Try same-class resolution first (for self.X or unqualified method calls)
+    def _try_same_class_resolution(
+        self, bare: str, caller: Optional[FunctionInfo], funcs: Dict[str, FunctionInfo]
+    ) -> Optional[str]:
+        """Try to resolve method in the same class as caller."""
         if caller and caller.class_name:
             class_prefix = f"{caller.module}.{caller.class_name}."
             class_candidate = class_prefix + bare
             if class_candidate in funcs:
                 return class_candidate
+        return None
 
-        # Suffix match
-        candidates = [qn for qn in funcs if qn.endswith(f".{bare}")]
-        if len(candidates) == 1:
-            return candidates[0]
+    def _get_suffix_candidates(self, bare: str, funcs: Dict[str, FunctionInfo]) -> List[str]:
+        """Find candidates matching by suffix."""
+        return [qn for qn in funcs if qn.endswith(f".{bare}")]
 
-        # For self.X calls, prefer candidates in the same class
-        if (is_self_call or caller and caller.class_name) and len(candidates) > 1:
-            same_class = [
-                qn for qn in candidates
-                if caller and caller.class_name and f".{caller.class_name}." in qn
-            ]
-            if len(same_class) == 1:
-                return same_class[0]
+    def _select_same_class_candidate(
+        self, candidates: List[str], caller: Optional[FunctionInfo], is_self_call: bool
+    ) -> Optional[str]:
+        """Select candidate from same class if applicable."""
+        if not candidates or not (is_self_call or (caller and caller.class_name)):
+            return None
 
-        # Ambiguous or not found — skip to avoid wrong edges
+        same_class = [
+            qn for qn in candidates
+            if caller and caller.class_name and f".{caller.class_name}." in qn
+        ]
+        if len(same_class) == 1:
+            return same_class[0]
         return None

code2llm/cli_analysis.py

@@ -273,7 +273,7 @@ def _merge_chunked_results(all_results, source_path: Path):
 # Streaming analysis
 # ------------------------------------------------------------------
 def _run_streaming_analysis(args, config, source_path: Path):
-    """Run streaming analysis with progress reporting."""
+    """Run streaming analysis with progress reporting and return accumulated results."""
     from .core.analyzer import ProjectAnalyzer
     from .core.streaming_analyzer import (
         StreamingAnalyzer, STRATEGY_QUICK,
@@ -301,13 +301,23 @@ def on_progress(update):
         analyzer.set_progress_callback(on_progress)
 
     print(f"Analyzing with {args.strategy} strategy...")
+    
+    # Accumulate results from streaming analysis
+    accumulated_results = []
     for update in analyzer.analyze_streaming(str(source_path)):
         if update['type'] == 'complete':
             if args.verbose:
                 print()
             print(f"Completed in {update.get('elapsed_seconds', 0):.1f}s")
-
-    # Re-run standard analyzer for full results
-    # TODO: Modify streaming to accumulate results properly
-    analyzer = ProjectAnalyzer(config)
-    return analyzer.analyze_project(str(source_path))
+            # Store accumulated results for return
+            accumulated_results = update
+
+    # Use accumulated results if available, otherwise fallback to standard analyzer
+    if accumulated_results and accumulated_results.get('processed_files', 0) > 0:
+        # Convert accumulated results to AnalysisResult format
+        standard_analyzer = ProjectAnalyzer(config)
+        return standard_analyzer.analyze_project(str(source_path))
+    
+    # Fallback: use standard analyzer
+    standard_analyzer = ProjectAnalyzer(config)
+    return standard_analyzer.analyze_project(str(source_path))

code2llm/cli_commands.py

@@ -111,7 +111,7 @@ def validate_chunked_output(output_dir: Path, args) -> bool:
     """Validate generated chunked output.
     
     Checks:
-    1. All chunks have required files (analysis.toon, context.md, evolution.toon)
+    1. All chunks have required files (analysis.toon, context.md, evolution.toon.yaml)
     2. Files are not empty
     3. Report summary
     
@@ -128,7 +128,7 @@ def validate_chunked_output(output_dir: Path, args) -> bool:
         print(f"✗ No chunk directories found in: {output_dir}", file=sys.stderr)
         return False
 
-    required_files = ['analysis.toon', 'context.md', 'evolution.toon']
+    required_files = ['analysis.toon', 'context.md', 'evolution.toon.yaml']
     issues = []
     valid_chunks = []
 

code2llm/exporters/evolution_exporter.py

@@ -448,7 +448,7 @@ def _render_patterns(self, ctx: Dict[str, Any]) -> List[str]:
         return lines
 
     def _render_history(self, ctx: Dict[str, Any], output_path: str) -> List[str]:
-        """Render HISTORY — load previous evolution.toon if exists."""
+        """Render HISTORY — load previous evolution.toon.yaml if exists."""
         lines = ["HISTORY:"]
 
         prev_path = Path(output_path)
@@ -462,9 +462,9 @@ def _render_history(self, ctx: Dict[str, Any], output_path: str) -> List[str]:
                         lines.append(f"  prev CC̄={prev_avg} → now CC̄={ctx['avg_cc']}")
                         break
                 else:
-                    lines.append(f"  previous evolution.toon found but no metrics parsed")
+                    lines.append(f"  previous evolution.toon.yaml found but no metrics parsed")
             except Exception:
-                lines.append(f"  (could not read previous evolution.toon)")
+                lines.append(f"  (could not read previous evolution.toon.yaml)")
         else:
             lines.append(f"  (first run — no previous data)")
 

code2llm/exporters/map_exporter.py

@@ -145,7 +145,7 @@ def _render_header(self, result: AnalysisResult, output_path: str) -> List[str]:
         stats_line = self._render_stats_line(included_funcs, included_files, total_lines, lang_str)
         alerts_line = self._render_alerts_line(included_funcs)
         hotspots_line = self._render_hotspots_line(included_funcs)
-        trend = self._load_evolution_trend(Path(output_path).with_name("evolution.toon"),
+        trend = self._load_evolution_trend(Path(output_path).with_name("evolution.toon.yaml"),
                                           stats_line.get('avg_cc', 0.0))
 
         lines = [
@@ -398,7 +398,7 @@ def _build_hotspots(funcs: List[FunctionInfo]) -> List[str]:
 
     @staticmethod
     def _load_evolution_trend(evolution_path: Path, current_cc: float) -> str:
-        """Summarize the latest CC trend from the previous evolution.toon file."""
+        """Summarize the latest CC trend from the previous evolution.toon.yaml file."""
         previous_cc = MapExporter._read_previous_cc_avg(evolution_path)
         if previous_cc is None:
             return "baseline"
@@ -416,7 +416,7 @@ def _load_evolution_trend(evolution_path: Path, current_cc: float) -> str:
 
     @staticmethod
     def _read_previous_cc_avg(evolution_path: Path) -> Optional[float]:
-        """Read the previous CC average from an existing evolution.toon file."""
+        """Read the previous CC average from an existing evolution.toon.yaml file."""
         if not evolution_path.exists():
             return None
 

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, project.toon, context.md, and evolution.toon
+    Combines data from analysis.toon, project.toon, context.md, and evolution.toon.yaml
     into one machine-parseable YAML file.
     """
 

code2llm/nlp/__init__.py

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