code2llm 0.5.159__tar.gz → 0.5.160__tar.gz

{code2llm-0.5.159/code2llm.egg-info → code2llm-0.5.160}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.159
+Version: 0.5.160
 Summary: High-performance Python code flow analysis with optimized TOON format - CFG, DFG, call graphs, and intelligent code queries
 Home-page: https://github.com/wronai/stts
 Author: STTS Project
@@ -66,11 +66,11 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.159-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-80.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.160-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-81.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (216 commits)
-- 👤 **Human dev:** ~$8072 (80.7h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (221 commits)
+- 👤 **Human dev:** ~$8118 (81.2h @ $100/h, 30min dedup)
 
 Generated on 2026-05-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 

{code2llm-0.5.159 → code2llm-0.5.160}/README.md

@@ -2,11 +2,11 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.159-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-80.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.160-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-81.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (216 commits)
-- 👤 **Human dev:** ~$8072 (80.7h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (221 commits)
+- 👤 **Human dev:** ~$8118 (81.2h @ $100/h, 30min dedup)
 
 Generated on 2026-05-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 

code2llm-0.5.160/VERSION

@@ -0,0 +1 @@
+0.5.160

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/__init__.py

@@ -8,7 +8,7 @@ Includes NLP Processing Pipeline for query normalization, intent matching,
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.159"
+__version__ = "0.5.160"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/analysis/_data_impl.py

@@ -222,26 +222,26 @@ def _analyze_data_types(result: AnalysisResult) -> list:
 # ---------------------------------------------------------------------------
 
 
+_NAME_TYPE_KEYWORDS: List[tuple] = [
+    ("list", ("list", "items")),
+    ("dict", ("dict", "map")),
+    ("str",  ("text", "string")),
+    ("int",  ("count", "index")),
+]
+_DOC_TYPE_KEYWORDS: List[tuple] = [
+    ("list", ("list",)),
+    ("dict", ("dict",)),
+    ("str",  ("string", "text")),
+]
+
+
 def _get_function_data_types(func) -> list:
     """Derive data type labels for a function from its name and docstring."""
-    types: List[str] = []
     name = func.name.lower()
-    if "list" in name or "items" in name:
-        types.append("list")
-    if "dict" in name or "map" in name:
-        types.append("dict")
-    if "text" in name or "string" in name:
-        types.append("str")
-    if "count" in name or "index" in name:
-        types.append("int")
+    types = [dt for dt, kws in _NAME_TYPE_KEYWORDS if any(kw in name for kw in kws)]
     if func.docstring:
         doc = func.docstring.lower()
-        if "list" in doc:
-            types.append("list")
-        if "dict" in doc:
-            types.append("dict")
-        if "string" in doc or "text" in doc:
-            types.append("str")
+        types += [dt for dt, kws in _DOC_TYPE_KEYWORDS if any(kw in doc for kw in kws)]
     return list(set(types))
 
 

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/analysis/coupling.py

@@ -8,6 +8,7 @@ class CouplingAnalyzer:
     """Analyze coupling between modules."""
 
     def __init__(self, result: AnalysisResult):
+        """Initialise with the analysis result to analyse for coupling."""
         self.result = result
 
     def analyze(self) -> Dict[str, Any]:

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/analysis/side_effects.py

@@ -323,54 +323,31 @@ class SideEffectDetector:
         else:
             info.classification = "pure"
 
+    # word-sets and their target attribute names, in priority order
+    _HEURISTIC_CATEGORIES: List[tuple] = [
+        (
+            "IO",
+            {"write", "read", "open", "save", "load", "export", "dump", "print", "mkdir", "rmdir", "remove"},
+            "io_operations",
+        ),
+        ("cache", {"cache", "memoize", "lru_cache", "store", "fetch"}, "cache_operations"),
+        ("mutation", {"set_", "update", "modify", "mutate", "append", "insert", "delete", "fix", "patch"}, "mutations"),
+    ]
+
     def _heuristic_classify(self, fi: FunctionInfo, info: SideEffectInfo) -> None:
         """Classify based on function name and calls (fallback)."""
         name_lower = fi.name.lower()
         calls_lower = {c.lower() for c in fi.calls}
-
-        io_words = {
-            "write",
-            "read",
-            "open",
-            "save",
-            "load",
-            "export",
-            "dump",
-            "print",
-            "mkdir",
-            "rmdir",
-            "remove",
-        }
-        cache_words = {"cache", "memoize", "lru_cache", "store", "fetch"}
-        mutation_words = {
-            "set_",
-            "update",
-            "modify",
-            "mutate",
-            "append",
-            "insert",
-            "delete",
-            "fix",
-            "patch",
-        }
-
-        if any(w in name_lower for w in io_words):
-            info.classification = "IO"
-            info.io_operations.append(f"name:{fi.name}")
-        elif any(any(w in c for w in io_words) for c in calls_lower):
-            info.classification = "IO"
-            info.io_operations.append("calls:IO")
-        elif any(w in name_lower for w in cache_words):
-            info.classification = "cache"
-            info.cache_operations.append(f"name:{fi.name}")
-        elif any(any(w in c for w in cache_words) for c in calls_lower):
-            info.classification = "cache"
-            info.cache_operations.append("calls:cache")
-        elif any(w in name_lower for w in mutation_words):
-            info.classification = "mutation"
-            info.mutations.append(f"name:{fi.name}")
-        else:
-            info.classification = "pure"
+        for classification, words, attr in self._HEURISTIC_CATEGORIES:
+            if any(w in name_lower for w in words):
+                info.classification = classification
+                getattr(info, attr).append(f"name:{fi.name}")
+                return
+            if any(any(w in c for w in words) for c in calls_lower):
+                info.classification = classification
+                getattr(info, attr).append(f"calls:{classification}")
+                return
+        info.classification = "pure"
 
     # ------------------------------------------------------------------
     # AST helpers

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/analysis/smells.py

@@ -9,6 +9,7 @@ class SmellDetector:
     """Detect code smells from analysis results."""
 
     def __init__(self, result: AnalysisResult):
+        """Initialise with the analysis result to detect code smells."""
         self.result = result
         # Pre-index mutations by scope — avoids O(n×m) full scans
         self._mutations_by_scope: Dict[str, list] = defaultdict(list)

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/cli_analysis.py

@@ -218,30 +218,28 @@ def _analyze_all_subprojects(args, subprojects, output_dir: Path) -> list:
     return all_results
 
 
+def _build_filter_config(args):
+    """Build a FilterConfig from CLI args (exclude patterns, gitignore flag)."""
+    from .core.config import FilterConfig
+    fc = FilterConfig()
+    if getattr(args, "exclude", None):
+        custom = [
+            f"*{p}*" if not p.startswith("*") and not p.endswith("*") else p
+            for p in args.exclude
+        ]
+        fc.exclude_patterns = list(set(fc.exclude_patterns + custom))
+    if getattr(args, "no_gitignore", False):
+        fc.gitignore_enabled = False
+    return fc
+
+
 def _analyze_subproject(args, subproject, output_dir: Path):
     """Analyze and export a single subproject."""
     from .core.analyzer import ProjectAnalyzer
-    from .core.config import Config, FilterConfig
+    from .core.config import Config
     from .cli_exports import _export_simple_formats, _export_evolution
 
-    # Start with default filter config
-    filter_config = FilterConfig()
-
-    # Apply custom exclude patterns if provided
-    if hasattr(args, "exclude") and args.exclude:
-        default_patterns = filter_config.exclude_patterns
-        custom_patterns = [
-            f"*{pattern}*"
-            if not pattern.startswith("*") and not pattern.endswith("*")
-            else pattern
-            for pattern in args.exclude
-        ]
-        filter_config.exclude_patterns = list(set(default_patterns + custom_patterns))
-
-    # Apply gitignore setting
-    if hasattr(args, "no_gitignore") and args.no_gitignore:
-        filter_config.gitignore_enabled = False
-
+    filter_config = _build_filter_config(args)
     config = Config(
         mode=args.mode,
         max_depth_enumeration=args.max_depth,

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/cli_exports/formats.py

@@ -163,32 +163,8 @@ def _export_simple_formats(args, result, output_dir: Path, formats):
             if args.verbose:
                 print(f"  - {label}: {filepath} ({elapsed:.2f}s)")
 
-    # Unified project.yaml (single source of truth)
     if "project-yaml" in formats:
-        yaml_path = _export_project_yaml(args, result, output_dir)
-        # Auto-generate all views from project.yaml
-        data = load_project_yaml(str(yaml_path))
-        view_map = {
-            "project.toon.yaml": ToonViewGenerator(),
-            "context.md": ContextViewGenerator(),
-            "dashboard.html": HTMLDashboardGenerator(),
-        }
-        for filename, generator in view_map.items():
-            filepath = output_dir / filename
-            generator.generate(data, str(filepath))
-            if args.verbose:
-                print(f"  - Generated view: {filepath}")
-
-        # Auto-validate consistency
-        from ..exporters.validate_project import validate_project_yaml
-
-        is_valid, issues = validate_project_yaml(output_dir, verbose=args.verbose)
-        if not is_valid and not args.verbose:
-            print(
-                f"  ⚠ project.yaml validation: {len(issues)} issue(s)", file=sys.stderr
-            )
-            for issue in issues:
-                print(f"    - {issue}", file=sys.stderr)
+        _export_project_yaml_bundle(args, result, output_dir)
 
     if "yaml" in formats:
         _export_yaml(args, result, output_dir)
@@ -221,6 +197,28 @@ def _export_yaml(args, result, output_dir: Path):
             print(f"  - YAML: {filepath}")
 
 
+def _export_project_yaml_bundle(args, result, output_dir: Path) -> None:
+    """Export project.yaml and auto-generate all derived views, then validate."""
+    yaml_path = _export_project_yaml(args, result, output_dir)
+    data = load_project_yaml(str(yaml_path))
+    view_map = {
+        "project.toon.yaml": ToonViewGenerator(),
+        "context.md": ContextViewGenerator(),
+        "dashboard.html": HTMLDashboardGenerator(),
+    }
+    for filename, generator in view_map.items():
+        filepath = output_dir / filename
+        generator.generate(data, str(filepath))
+        if args.verbose:
+            print(f"  - Generated view: {filepath}")
+    from ..exporters.validate_project import validate_project_yaml
+    is_valid, issues = validate_project_yaml(output_dir, verbose=args.verbose)
+    if not is_valid and not args.verbose:
+        print(f"  \u26a0 project.yaml validation: {len(issues)} issue(s)", file=sys.stderr)
+        for issue in issues:
+            print(f"    - {issue}", file=sys.stderr)
+
+
 def _export_mermaid_pngs(args, output_dir: Path) -> None:
     """Attempt PNG generation from .mmd files, with graceful fallback."""
     if args.no_png:

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/cli_exports/orchestrator.py

@@ -354,6 +354,26 @@ def _export_chunked(
     _chunked_impl(args, result, output_dir, source_path, formats, requested_formats)
 
 
+# Maps suffix(es) → (prefix, suffix_str) for inserting after line 1.
+# None = skip (no comment possible). "html" handled separately.
+_COMMENT_PREFIXES = {
+    ".mmd": ("%%", ""),
+    ".export": ("%%", ""),
+    ".yaml": ("#", ""),
+    ".yml": ("#", ""),
+    ".txt": ("#", ""),
+    ".md": ("<!--", " -->"),
+}
+_SKIP_SUFFIXES = {".json"}
+
+
+def _insert_after_first_line(content: str, tag: str, pre: str, suf: str) -> str:
+    """Return content with a comment line inserted after the first newline."""
+    parts = content.split("\n", 1)
+    rest = parts[1] if len(parts) == 2 else ""
+    return f"{parts[0]}\n{pre} {tag}{suf}\n{rest}"
+
+
 def _inject_generation_time(filepath: Path, elapsed: float) -> None:
     """Inject generation time comment into the second line of an exported file."""
     try:
@@ -361,58 +381,22 @@ def _inject_generation_time(filepath: Path, elapsed: float) -> None:
         if not path.exists():
             return
         suffix = path.suffix.lower()
-        name = path.name.lower()
-
-        # Only inject into text-based files
-        if suffix not in (
-            ".yaml",
-            ".yml",
-            ".md",
-            ".txt",
-            ".mmd",
-            ".html",
-            ".json",
-            ".export",
-        ):
-            return
-
-        content = path.read_text(encoding="utf-8")
-        if not content:
-            return
-
         tag = f"generated in {elapsed:.2f}s"
 
-        if suffix in (".mmd", ".export"):
-            # Mermaid uses %% for comments
-            lines = content.split("\n", 1)
-            if len(lines) == 2:
-                content = f"{lines[0]}\n%% {tag}\n{lines[1]}"
-            else:
-                content = f"{lines[0]}\n%% {tag}\n"
-        elif suffix in (".yaml", ".yml", ".txt") or name.endswith(".toon.yaml"):
-            # YAML/text: insert '# generated in X.XXs' after first line
-            lines = content.split("\n", 1)
-            if len(lines) == 2:
-                content = f"{lines[0]}\n# {tag}\n{lines[1]}"
-            else:
-                content = f"{lines[0]}\n# {tag}\n"
-        elif suffix == ".md":
-            # Markdown: insert HTML comment after first line
-            lines = content.split("\n", 1)
-            if len(lines) == 2:
-                content = f"{lines[0]}\n<!-- {tag} -->\n{lines[1]}"
-            else:
-                content = f"{lines[0]}\n<!-- {tag} -->\n"
-        elif suffix == ".html":
-            # HTML: insert comment after <!DOCTYPE or <html>
-            content = content.replace("\n", f"\n<!-- {tag} -->\n", 1)
-        elif suffix == ".json":
-            # JSON doesn't support comments — skip
+        if suffix in _SKIP_SUFFIXES:
             return
-        else:
+        if suffix == ".html":
+            path.write_text(
+                path.read_text(encoding="utf-8").replace("\n", f"\n<!-- {tag} -->\n", 1),
+                encoding="utf-8",
+            )
             return
-
-        path.write_text(content, encoding="utf-8")
+        pre, suf_str = _COMMENT_PREFIXES.get(suffix, (None, None))
+        if pre is None:
+            return
+        content = path.read_text(encoding="utf-8")
+        if content:
+            path.write_text(_insert_after_first_line(content, tag, pre, suf_str), encoding="utf-8")
     except Exception:
         pass  # Never fail the export pipeline for a comment
 

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/cli_exports/prompt.py

@@ -282,63 +282,38 @@ def _build_missing_files_section(output_dir: Path, output_rel_path: str) -> List
     return lines
 
 
-def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict:
-    """Analyze which files were generated and determine appropriate focus areas."""
-    analysis_file = _find_existing_prompt_file(
-        output_dir, ("analysis.toon", "analysis.toon.yaml")
-    )
-    map_file = _find_existing_prompt_file(output_dir, ("map.toon.yaml",))
-    evolution_file = _find_existing_prompt_file(output_dir, ("evolution.toon.yaml",))
-    project_toon_file = _find_existing_prompt_file(output_dir, ("project.toon.yaml",))
-    context_file = _find_existing_prompt_file(output_dir, ("context.md",))
-    readme_file = _find_existing_prompt_file(output_dir, ("README.md",))
-    project_logic_file = _find_existing_prompt_file(
-        output_dir, ("project.toon", "project/project.toon", "project.toon.txt")
-    )
-    validation_file = _find_existing_prompt_file(
-        output_dir, ("project/validation.toon.yaml",)
-    )
-    duplication_file = _find_existing_prompt_file(
-        output_dir, ("project/duplication.toon.yaml",)
-    )
+# (has_key, file_key, candidate_filenames, default_path)
+_OUTPUT_FILE_SPECS = [
+    ("has_analysis_toon",    "analysis_file",      ("analysis.toon", "analysis.toon.yaml"),                "analysis.toon"),
+    ("has_map_toon",         "map_file",           ("map.toon.yaml",),                                     "map.toon.yaml"),
+    ("has_evolution_toon",   "evolution_file",     ("evolution.toon.yaml",),                               "evolution.toon.yaml"),
+    ("has_project_toon_yaml","project_toon_file",  ("project.toon.yaml",),                                 "project.toon.yaml"),
+    ("has_context_md",       "context_file",       ("context.md",),                                        "context.md"),
+    ("has_readme_md",        "readme_file",        ("README.md",),                                         "README.md"),
+    ("has_project_logic",    "project_logic_file", ("project.toon", "project/project.toon", "project.toon.txt"), "project.toon"),
+    ("has_validation_toon",  "validation_file",    ("project/validation.toon.yaml",),                     "project/validation.toon.yaml"),
+    ("has_duplication_toon", "duplication_file",   ("project/duplication.toon.yaml",),                    "project/duplication.toon.yaml"),
+]
+_ACTIONABLE_KEYS = {"has_analysis_toon", "has_map_toon", "has_evolution_toon",
+                    "has_project_toon_yaml", "has_project_logic",
+                    "has_validation_toon", "has_duplication_toon"}
+
+
+def _probe_output_files(output_dir: Path) -> dict:
+    """Probe output_dir for known generated files, returning presence flags and paths."""
+    result: dict = {}
+    for has_key, file_key, candidates, default in _OUTPUT_FILE_SPECS:
+        found = _find_existing_prompt_file(output_dir, candidates)
+        result[has_key] = found is not None
+        result[file_key] = found or default
+    return result
 
-    analysis = {
-        "has_analysis_toon": analysis_file is not None,
-        "analysis_file": analysis_file or "analysis.toon",
-        "has_map_toon": map_file is not None,
-        "map_file": map_file or "map.toon.yaml",
-        "has_evolution_toon": evolution_file is not None,
-        "evolution_file": evolution_file or "evolution.toon.yaml",
-        "has_project_toon_yaml": project_toon_file is not None,
-        "project_toon_file": project_toon_file or "project.toon.yaml",
-        "has_context_md": context_file is not None,
-        "context_file": context_file or "context.md",
-        "has_readme_md": readme_file is not None,
-        "readme_file": readme_file or "README.md",
-        "has_project_logic": project_logic_file is not None,
-        "project_logic_file": project_logic_file or "project.toon",
-        "has_validation_toon": validation_file is not None,
-        "validation_file": validation_file or "project/validation.toon.yaml",
-        "has_duplication_toon": duplication_file is not None,
-        "duplication_file": duplication_file or "project/duplication.toon.yaml",
-        "is_chunked": subprojects is not None and len(subprojects) > 0,
-        "file_count": 0,
-    }
-
-    # Count total files
-    actionable_keys = {
-        "has_analysis_toon",
-        "has_map_toon",
-        "has_evolution_toon",
-        "has_project_toon_yaml",
-        "has_project_logic",
-        "has_validation_toon",
-        "has_duplication_toon",
-    }
-    for key, exists in analysis.items():
-        if key in actionable_keys and exists:
-            analysis["file_count"] += 1
 
+def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict:
+    """Analyze which files were generated and determine appropriate focus areas."""
+    analysis = _probe_output_files(output_dir)
+    analysis["is_chunked"] = bool(subprojects)
+    analysis["file_count"] = sum(1 for k in _ACTIONABLE_KEYS if analysis.get(k))
     return analysis
 
 

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/analyzer.py

@@ -40,6 +40,7 @@ class ProjectAnalyzer:
     def __init__(
         self, config: Optional[Config] = None, project_path: Optional[Path] = None
     ):
+        """Initialise the analyser with optional config and project path."""
         self.config = config or FAST_CONFIG
         self.project_path = project_path
         self.cache = (

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/file_analyzer.py

@@ -29,6 +29,7 @@ class FileAnalyzer:
     """Analyzes a single file."""
 
     def __init__(self, config: Config, cache=None):
+        """Initialise with project config and optional file cache."""
         self.config = config
         self.cache = cache
         self._file_filter = FastFileFilter(config.filters)

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/lang/_c_parser.py

@@ -149,23 +149,20 @@ def _process_standalone_function(
 def _match_method_name(arrow_prop_re, method_re, func_re, line, reserved):
     """Return matched method name from any of the three patterns, or None."""
     if arrow_prop_re:
-        apm = arrow_prop_re.match(line)
-        if apm:
-            mname = apm.group(1)
-            if mname not in reserved and mname != "constructor":
-                return mname
-    if method_re:
-        mm = method_re.match(line)
-        if mm:
-            mname = mm.group(1)
-            if mname not in reserved:
-                return mname
-    if func_re:
-        fm = func_re.match(line)
-        if fm:
-            fn = fm.group(1) or (fm.group(2) if len(fm.groups()) > 1 else None)
-            if fn and fn not in reserved:
-                return fn
+        m = arrow_prop_re.match(line)
+        if m:
+            name = m.group(1)
+            if name not in reserved and name != "constructor":
+                return name
+    for regex in (method_re, func_re):
+        if not regex:
+            continue
+        m = regex.match(line)
+        if not m:
+            continue
+        name = m.group(1) or (m.group(2) if len(m.groups()) > 1 else None)
+        if name and name not in reserved:
+            return name
     return None
 
 

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/lang/ts_parser.py

@@ -117,10 +117,12 @@ class TreeSitterParser:
     """
 
     def __init__(self):
+        """Initialise the parser pool, loading tree-sitter language modules."""
         self._initialized = _init_tree_sitter()
 
     @property
     def available(self) -> bool:
+        """Return True when tree-sitter is available for parsing."""
         return self._initialized
 
     def parse(self, source: bytes, ext: str) -> Optional[Any]:

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/refactoring.py

@@ -11,6 +11,7 @@ class RefactoringAnalyzer:
     """Performs refactoring analysis on code."""
 
     def __init__(self, config: Config, file_filter: FastFileFilter):
+        """Initialise with project config and file filter."""
         self.config = config
         self.file_filter = file_filter
 

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/source_classifier.py

@@ -194,6 +194,17 @@ def _has_code2llm_output_manifest(path: Path) -> bool:
     )
 
 
+def _is_generated_by_name(name: str, p: Path) -> bool:
+    """Return True when the file name alone marks it as a generated artefact."""
+    if name in GENERATED_EXACT_FILENAMES:
+        return True
+    if any(name.startswith(prefix) for prefix in GENERATED_PREFIXES):
+        return True
+    if name in GENERATED_SNIFF_FILENAMES and _looks_like_generated_content(p):
+        return True
+    return False
+
+
 def is_generated_artifact(
     path: str | Path, project_root: Optional[Path] = None
 ) -> bool:
@@ -204,29 +215,14 @@ def is_generated_artifact(
         return True
 
     if project_root:
-        rel_parts = parts[:-1]
-        for idx, part in enumerate(rel_parts):
-            if part != "project":
-                continue
-            candidate = Path(project_root).joinpath(*parts[: idx + 1])
-            if _has_code2llm_output_manifest(candidate):
+        for idx, part in enumerate(parts[:-1]):
+            if part == "project" and _has_code2llm_output_manifest(
+                Path(project_root).joinpath(*parts[: idx + 1])
+            ):
                 return True
 
     name = p.name.lower()
-    if name in GENERATED_EXACT_FILENAMES:
-        return True
-    if any(name.startswith(prefix) for prefix in GENERATED_PREFIXES):
-        return True
-    if name in GENERATED_SNIFF_FILENAMES and _looks_like_generated_content(p):
-        return True
-
-    # The default code2llm output folder is commonly named "project". Avoid
-    # treating arbitrary project/ directories as generated unless the filename
-    # itself is a known code2llm artefact.
-    if "project" in parts[:-1] and name in GENERATED_EXACT_FILENAMES:
-        return True
-
-    return False
+    return _is_generated_by_name(name, p)
 
 
 def classify_source_path(path: str | Path, project_root: Optional[Path] = None) -> str:

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/streaming/incremental.py

@@ -13,6 +13,7 @@ class StreamingIncrementalAnalyzer:
     """Incremental analysis with change detection for streaming analyzer."""
 
     def __init__(self, config: Optional[Config] = None):
+        """Initialise incremental analyser with optional config."""
         self.config = config or FAST_CONFIG
         self.state_file = Path(".code2llm_state.json")
         self.previous_state: Dict[str, str] = {}

{code2llm-0.5.159 → code2llm-0.5.160}/code2llm/core/streaming/prioritizer.py

@@ -30,6 +30,7 @@ class SmartPrioritizer:
     """Smart file prioritization for optimal analysis order."""
 
     def __init__(self, strategy: ScanStrategy):
+        """Initialise the file prioritiser with a scan strategy."""
         self.strategy = strategy
 
     def prioritize_files(