code2llm 0.5.114__tar.gz → 0.5.116__tar.gz

{code2llm-0.5.114 → code2llm-0.5.116}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.114
+Version: 0.5.116
 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
@@ -67,13 +67,13 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.114-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-55.0h-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.116-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-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (162 commits)
-- 👤 **Human dev:** ~$5505 (55.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (166 commits)
+- 👤 **Human dev:** ~$5731 (57.3h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
@@ -89,7 +89,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
+| `evolution.toon.yaml` | **YAML** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -97,6 +97,11 @@ When you run `code2llm ./ -f all`, the following files are created:
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
 
+### 📊 Visualizations
+
+| File | Format | Purpose | Description |
+|------|--------|---------|-------------|
+| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
 
 ## 🚀 Quick Start Commands
 
@@ -401,10 +406,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-04-18  
-**Total Functions**: 1041  
-**Total Classes**: 111  
-**Modules**: 135  
+**Analysis Date**: 2026-04-19  
+**Total Functions**: 1115  
+**Total Classes**: 121  
+**Modules**: 152  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.114 → code2llm-0.5.116}/README.md

@@ -3,13 +3,13 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.114-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-55.0h-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.116-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-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (162 commits)
-- 👤 **Human dev:** ~$5505 (55.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (166 commits)
+- 👤 **Human dev:** ~$5731 (57.3h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
@@ -25,7 +25,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
+| `evolution.toon.yaml` | **YAML** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -33,6 +33,11 @@ When you run `code2llm ./ -f all`, the following files are created:
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
 
+### 📊 Visualizations
+
+| File | Format | Purpose | Description |
+|------|--------|---------|-------------|
+| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
 
 ## 🚀 Quick Start Commands
 
@@ -337,10 +342,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-04-18  
-**Total Functions**: 1041  
-**Total Classes**: 111  
-**Modules**: 135  
+**Analysis Date**: 2026-04-19  
+**Total Functions**: 1115  
+**Total Classes**: 121  
+**Modules**: 152  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.114 → code2llm-0.5.116}/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.114"
+__version__ = "0.5.116"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/analysis/call_graph.py

@@ -5,6 +5,7 @@ from typing import Optional, Set, List, Dict
 
 from code2llm.core.config import Config
 from code2llm.core.models import AnalysisResult, FlowEdge
+from code2llm.analysis.utils import ast_unparse
 
 
 class CallGraphExtractor(ast.NodeVisitor):
@@ -202,10 +203,4 @@ class CallGraphExtractor(ast.NodeVisitor):
         return None
         
     def _expr_to_str(self, node: ast.AST) -> str:
-        """Convert AST expression to string."""
-        if node is None:
-            return ""
-        try:
-            return ast.unparse(node) if hasattr(ast, 'unparse') else str(node)
-        except:
-            return str(node)
+        return ast_unparse(node, default_none="")

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/analysis/cfg.py

@@ -6,6 +6,7 @@ from typing import Optional
 
 from code2llm.core.config import Config
 from code2llm.core.models import AnalysisResult, FlowNode, FlowEdge, FunctionInfo
+from code2llm.analysis.utils import ast_unparse
 
 
 class CFGExtractor(ast.NodeVisitor):
@@ -275,13 +276,7 @@ class CFGExtractor(ast.NodeVisitor):
             return str(node)[:50]
             
     def _expr_to_str(self, node: ast.AST) -> str:
-        """Convert AST expression to string."""
-        if node is None:
-            return "None"
-        try:
-            return ast.unparse(node) if hasattr(ast, 'unparse') else str(node)
-        except:
-            return str(node)
+        return ast_unparse(node)
             
     def _format_except(self, handler: ast.ExceptHandler) -> str:
         """Format except handler."""

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/analysis/dfg.py

@@ -6,6 +6,7 @@ from typing import Set, Dict, List
 
 from code2llm.core.config import Config
 from code2llm.core.models import AnalysisResult, FlowEdge, DataFlow, Mutation
+from code2llm.analysis.utils import ast_unparse
 
 
 class DFGExtractor(ast.NodeVisitor):
@@ -207,13 +208,7 @@ class DFGExtractor(ast.NodeVisitor):
         return names
         
     def _expr_to_str(self, node: ast.AST) -> str:
-        """Convert AST expression to string."""
-        if node is None:
-            return "None"
-        try:
-            return ast.unparse(node) if hasattr(ast, 'unparse') else str(node)
-        except:
-            return str(node)
+        return ast_unparse(node)
             
     def _build_data_flow_edges(self):
         """Build DFG edges from data flow records."""

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/analysis/utils/__init__.py

@@ -1,5 +1,5 @@
 """Shared AST utilities for analysis modules."""
 
-from .ast_helpers import get_ast, find_function_node, expr_to_str
+from .ast_helpers import get_ast, find_function_node, expr_to_str, ast_unparse
 
-__all__ = ["get_ast", "find_function_node", "expr_to_str"]
+__all__ = ["get_ast", "find_function_node", "expr_to_str", "ast_unparse"]

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/analysis/utils/ast_helpers.py

@@ -38,6 +38,25 @@ def find_function_node(
     return None
 
 
+def ast_unparse(node: Optional[ast.AST], default_none: str = "None") -> str:
+    """Convert an AST node to its source string via ast.unparse (Python 3.9+).
+
+    Used as a shared replacement for the duplicated *_expr_to_str* methods
+    in ``cfg.py``, ``dfg.py``, and ``call_graph.py``.
+
+    Args:
+        node: AST node to convert, or None.
+        default_none: value returned when *node* is None (``"None"`` for most
+            callers; ``""`` for call_graph which uses empty-string sentinel).
+    """
+    if node is None:
+        return default_none
+    try:
+        return ast.unparse(node) if hasattr(ast, "unparse") else str(node)
+    except Exception:
+        return str(node)
+
+
 def expr_to_str(node: ast.expr) -> Optional[str]:
     """Convert an AST expression to a dotted string (for call-name extraction).
 

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/cli_analysis.py

@@ -73,7 +73,7 @@ def _build_config(args, output_dir: Path):
     if hasattr(args, 'no_gitignore') and args.no_gitignore:
         filter_config.gitignore_enabled = False
     
-    return Config(
+    config = Config(
         mode=args.mode,
         max_depth_enumeration=args.max_depth,
         detect_state_machines=not args.no_patterns,
@@ -81,6 +81,10 @@ def _build_config(args, output_dir: Path):
         output_dir=str(output_dir),
         filters=filter_config
     )
+    # Persistent cache flags (read via getattr with defaults in analyzer.py)
+    no_cache = getattr(args, 'no_cache', False) or getattr(args, 'force', False)
+    config.no_cache = no_cache
+    return config
 
 
 def _print_analysis_summary(result) -> None:

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/cli_commands.py

@@ -9,7 +9,7 @@ from .cli_exports import _run_report
 
 
 def handle_special_commands() -> Optional[int]:
-    """Handle special sub-commands (llm-flow, llm-context, report)."""
+    """Handle special sub-commands (llm-flow, llm-context, report, cache)."""
     if len(sys.argv) > 1 and sys.argv[1] == 'llm-flow':
         from .generators.llm_flow import main as llm_flow_main
         return llm_flow_main(sys.argv[2:])
@@ -17,9 +17,75 @@ def handle_special_commands() -> Optional[int]:
         return generate_llm_context(sys.argv[2:])
     if len(sys.argv) > 1 and sys.argv[1] == 'report':
         return handle_report_command(sys.argv[2:])
+    if len(sys.argv) > 1 and sys.argv[1] == 'cache':
+        return handle_cache_command(sys.argv[2:])
     return None
 
 
+def handle_cache_command(args_list) -> int:
+    """Manage persistent cache (~/.code2llm/).
+
+    Usage:
+        code2llm cache status          # show size, projects, last used
+        code2llm cache clear           # clear cache for current directory
+        code2llm cache clear --all     # clear entire ~/.code2llm/
+        code2llm cache gc              # manual garbage collection
+    """
+    import os
+    import time
+    from .core.persistent_cache import PersistentCache, get_all_projects, clear_all, _DEFAULT_ROOT
+
+    parser = argparse.ArgumentParser(prog='code2llm cache')
+    parser.add_argument('action', choices=['status', 'clear', 'gc'], help='Cache action')
+    parser.add_argument('--all', action='store_true', dest='all_projects',
+                        help='Apply to all cached projects (clear only)')
+    parser.add_argument('--max-age', type=int, default=30, metavar='DAYS',
+                        help='Max age in days for gc (default: 30)')
+    args = parser.parse_args(args_list)
+
+    if args.action == 'status':
+        projects = get_all_projects()
+        root = _DEFAULT_ROOT
+        total_mb = sum(p.get('cache_size_bytes', 0) for p in projects) / (1024 * 1024)
+        print(f"Cache: {root}")
+        print(f"  Projects: {len(projects)}   Total: {total_mb:.1f} MB")
+        for p in projects:
+            size_mb = p.get('cache_size_bytes', 0) / (1024 * 1024)
+            updated = p.get('updated_at', 0)
+            age_min = int((time.time() - updated) / 60) if updated else 0
+            age_str = f"{age_min}m ago" if age_min < 120 else f"{age_min//60}h ago"
+            exports = p.get('exports', 0)
+            files = p.get('files_cached', 0)
+            print(f"\n  {p.get('project', '?')}")
+            print(f"    Files: {files}   Exports: {exports}   Size: {size_mb:.1f} MB   Last: {age_str}")
+        return 0
+
+    if args.action == 'clear':
+        if args.all_projects:
+            clear_all()
+            print("Cleared entire cache.")
+        else:
+            project_dir = os.path.realpath('.')
+            c = PersistentCache(project_dir)
+            c.clear()
+            print(f"Cleared cache for {project_dir}")
+        return 0
+
+    if args.action == 'gc':
+        projects = get_all_projects()
+        total_removed = 0
+        for p in projects:
+            project_dir = p.get('project')
+            if project_dir and Path(project_dir).exists():
+                c = PersistentCache(project_dir)
+                removed = c.gc(max_age_days=args.max_age)
+                total_removed += removed
+        print(f"GC complete: {total_removed} stale entries removed.")
+        return 0
+
+    return 0
+
+
 def handle_report_command(args_list) -> int:
     """Generate views from an existing project.yaml (legacy).
 

{code2llm-0.5.114 → code2llm-0.5.116}/code2llm/cli_exports/formats.py

@@ -215,16 +215,27 @@ def _export_mermaid_pngs(args, output_dir: Path) -> None:
                 print(f"  - PNG: Skipped (install with: make install-mermaid)")
 
 
-def _export_calls(args, result, output_dir: Path):
-    """Export standalone calls.toon.yaml (call graph in toon format).
-    
-    Generates calls.toon.yaml in human-readable toon format with hubs, modules,
-    and edges sections — useful for programmatic analysis of call graphs.
-    """
+def _export_calls_format(args, result, output_dir: Path, toon: bool = False) -> None:
+    """Shared helper: export call graph in YAML or toon format."""
     yaml_exporter = YAMLExporter()
-    yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
-    if args.verbose:
-        print(f"  - CALLS (toon format): {output_dir / 'calls.toon.yaml'}")
+    if toon:
+        yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (toon format): {output_dir / 'calls.toon.yaml'}")
+    else:
+        yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (call graph YAML): {output_dir / 'calls.yaml'}")
+
+
+def _export_calls(args, result, output_dir: Path):
+    """Export standalone calls.yaml (structured call graph YAML)."""
+    _export_calls_format(args, result, output_dir, toon=False)
+
+
+def _export_calls_toon(args, result, output_dir: Path):
+    """Export calls.toon.yaml (call graph in human-readable toon format)."""
+    _export_calls_format(args, result, output_dir, toon=True)
 
 
 def _export_mermaid(args, result, output_dir: Path):
@@ -247,8 +258,9 @@ def _export_mermaid(args, result, output_dir: Path):
     exporter.export_call_graph(result, str(output_dir / 'calls.mmd'))
     exporter.export_compact(result, str(output_dir / 'compact_flow.mmd'))
 
-    # Export calls.toon.yaml (structured call graph data in toon format)
+    # Export calls.yaml (structured call graph data) and calls.toon.yaml (human-readable)
     yaml_exporter = YAMLExporter()
+    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
     yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
 
     if args.verbose:
@@ -257,7 +269,7 @@ def _export_mermaid(args, result, output_dir: Path):
             files.append('flow_detailed.mmd')
         if getattr(args, 'flow_full', False):
             files.append('flow_full.mmd')
-        files.extend(['calls.mmd', 'compact_flow.mmd', 'calls.toon.yaml'])
+        files.extend(['calls.mmd', 'compact_flow.mmd', 'calls.yaml'])
         print(f"  - Mermaid: {output_dir}/*.mmd ({', '.join(files)})")
 
     _export_mermaid_pngs(args, output_dir)