refactor(docs): deep code analysis engine with 5 supporting modules

changes:
  - file: prompt_engine.py
    area: core
    modified: [PromptEngine, _get_source_context]

stats:
  lines: "+11/-10 (net +1)"
  files: 5
  complexity: "Stable complexity"

Co-authored-by: Koru Agent <agent@coru.dev>

Author: tom-sapletta-com

CHANGELOG.md

@@ -18,6 +18,17 @@
 - Fix Mermaid comment syntax: `.mmd` files use `%%` for comments, not `#`
 - Fix Chromium sandbox crash: pass `--no-sandbox` to puppeteer/mmdc for PNG generation
 
+## [0.5.162] - 2026-05-25
+
+### Docs
+- Update README.md
+
+### Other
+- Update code2llm/analysis/pipeline_detector.py
+- Update code2llm/core/lang/ts_parser.py
+- Update code2llm/exporters/map/yaml_export.py
+- Update code2llm/refactor/prompt_engine.py
+
 ## [0.5.161] - 2026-05-25
 
 ### Docs

README.md

@@ -2,17 +2,16 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.161-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-84.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.162-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-85.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (230 commits)
-- 👤 **Human dev:** ~$8470 (84.7h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (233 commits)
+- 👤 **Human dev:** ~$8506 (85.1h @ $100/h, 30min dedup)
 
 Generated on 2026-05-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
 <!-- generated in 0.00s -->
 
 This directory contains the complete analysis of your project generated by `code2llm`. Each file serves a specific purpose for understanding, refactoring, and documenting your codebase.

VERSION

@@ -1 +1 @@
-0.5.161
+0.5.162

code2llm/__init__.py

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

code2llm/analysis/pipeline_detector.py

@@ -13,7 +13,7 @@
 
 import logging
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional, Set
+from typing import Any, Dict, List, Optional, Set, Tuple
 
 import networkx as nx
 

code2llm/core/lang/ts_parser.py

@@ -43,7 +43,7 @@ def _init_tree_sitter() -> bool:
     """Initialize tree-sitter. Returns True if available."""
     global _TS_AVAILABLE
     try:
-        import tree_sitter
+        import tree_sitter  # noqa: F401
 
         _TS_AVAILABLE = True
         return True

code2llm/exporters/map/yaml_export.py

@@ -2,7 +2,10 @@
 
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List
+from typing import TYPE_CHECKING, Any, Dict, List
+
+if TYPE_CHECKING:
+    from code2llm.core.models import ModuleInfo
 
 import yaml
 

code2llm/nlp/__init__.py

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

code2llm/refactor/prompt_engine.py

@@ -155,8 +155,7 @@ def _get_source_context(
 
             # If tree-sitter is available, use it to accurately find function boundaries
             if self.parser and "method" not in file_path:  # simplified check
-                tree = self.parser.parse(bytes(content, "utf8"))
-                root_node = tree.root_node
+                self.parser.parse(bytes(content, "utf8"))
 
                 # Simple function extraction using tree-sitter
                 # (Ideally we'd search for the function node at start_line)

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2llm"
-version = "0.5.161"
+version = "0.5.162"
 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"