code2llm 0.5.14__tar.gz → 0.5.16__tar.gz

{code2llm-0.5.14 → code2llm-0.5.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.14
+Version: 0.5.16
 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
@@ -60,48 +60,18 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 45 critical functions, 0 god modules |
-| `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
-| `flow.toon` | **TOON** | **🔄 Data flow analysis** - Pipelines, contracts, types | Data dependencies and side effects |
-| `map.toon` | **TOON** | **🗺️ Structural map** - Modules, imports, signatures | Project architecture overview |
-| `project.toon` | **TOON** | **🧠 Project logic** - Code2Logic compact module view | Generated via code2logic integration |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 43 critical functions, 0 god modules |
+| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
 
 ### 🤖 LLM-Ready Documentation
 
 | File | Format | Purpose | Use Case |
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
-| `prompt.txt` | **Text** | **📝 Ready-to-send prompt** - Lists all generated files with instructions | Attach to LLM conversation as context guide |
-| `analysis.yaml` | **YAML** | **📊 Structured data** - Machine-readable | For scripts and automated processing |
-| `analysis.json` | **JSON** | **🔧 API format** - Programmatic access | For integration with other tools |
 
-### 📊 Visualizations
-
-| File | Format | Purpose | Description |
-|------|--------|---------|-------------|
-| `flow.mmd` | **Mermaid** | **🔄 Control flow diagram** | Function call paths with complexity styling |
-| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
-| `compact_flow.mmd` | **Mermaid** | **📦 Module overview** | Aggregated module-level view |
-| `*.png` | **PNG** | **🖼️ Visual diagrams** | Rendered versions of Mermaid files |
 
 ## 🚀 Quick Start Commands
 
-### Complete LLM Analysis (with Code2Logic)
-```bash
-# Generate complete analysis with code2logic integration
-# Creates: analysis.toon, evolution.toon, project.toon, prompt.txt, README.md
-
-# Using specific formats (recommended)
-code2llm ./ -f toon,evolution,code2logic -o ./project
-
-# Using 'all' format (includes code2logic)
-code2llm ./ -f all -o ./project
-```
-
-The `code2logic` format automatically:
-1. Runs `code2logic` tool to generate `project.toon` (compact module view)
-2. Creates `prompt.txt` - ready-to-send prompt listing all generated files
-
 ### Basic Analysis
 ```bash
 # Quick health check (TOON format only)
@@ -114,12 +84,6 @@ code2llm ./ -f all
 code2llm ./ -f context
 ```
 
-Przykład z projektu toonic, z użyciem modelu Kimi K2.5 w VScode Windsurf:
-![img_1.png](img_1.png)
-```bash
-code2llm ./ -f toon,evolution -o ./project
-```
-
 ### Performance Options
 ```bash
 # Fast analysis for large projects
@@ -213,23 +177,6 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
-### `context.md` - LLM Narrative
-**Purpose**: Ready-to-paste context for AI assistants
-**Key sections**:
-- **Overview**: Project statistics
-- **Architecture**: Module breakdown
-- **Entry Points**: Public interfaces
-- **Patterns**: Design patterns detected
-
-**Example usage**:
-```bash
-# Copy to clipboard for LLM
-cat context.md | pbcopy  # macOS
-cat context.md | xclip -sel clip  # Linux
-
-# Use with Claude/ChatGPT for code analysis
-```
-
 ### `project.toon` - Project Logic (Code2Logic)
 **Purpose**: Compact module view generated by code2logic integration
 **Key sections**:
@@ -239,31 +186,49 @@ cat context.md | xclip -sel clip  # Linux
 
 **When to use**: When you need a lightweight project overview combined with code2llm analysis
 
-**Generation**:
+**Example usage**:
 ```bash
-# Generated automatically when using -f code2logic
-code2llm ./ -f toon,evolution,code2logic -o ./project
+# View compact project structure
+cat project.toon | head -30
+
+# Find largest files
+grep -E "^  .*[0-9]{3,}$" project.toon | sort -t',' -k2 -n -r | head -10
 ```
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Contents**:
-- **Files section**: Lists all existing generated files (analysis.toon, context.md, etc.)
+- **Files section**: Lists all existing generated files with descriptions
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
-- **Constraints section**: Guidelines for suggested changes
+- **Requirements section**: Guidelines for suggested changes
 
 **Example usage**:
 ```bash
 # View the prompt
-cat project/prompt.txt
+cat prompt.txt
 
 # Copy to clipboard and paste into ChatGPT/Claude
-cat project/prompt.txt | pbcopy  # macOS
-cat project/prompt.txt | xclip -sel clip  # Linux
+cat prompt.txt | pbcopy  # macOS
+cat prompt.txt | xclip -sel clip  # Linux
 ```
 
-**Generated when**: Using `-f code2logic` or `-f all`
+### `context.md` - LLM Narrative
+**Purpose**: Ready-to-paste context for AI assistants
+**Key sections**:
+- **Overview**: Project statistics
+- **Architecture**: Module breakdown
+- **Entry Points**: Public interfaces
+- **Patterns**: Design patterns detected
+
+**Example usage**:
+```bash
+# Copy to clipboard for LLM
+cat context.md | pbcopy  # macOS
+cat context.md | xclip -sel clip  # Linux
+
+# Use with Claude/ChatGPT for code analysis
+```
 
 ### Visualization Files (`*.mmd`, `*.png`)
 **Purpose**: Visual understanding of code structure
@@ -409,10 +374,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-01  
-**Total Functions**: 645  
-**Total Classes**: 94  
-**Modules**: 76  
+**Analysis Date**: 2026-03-03  
+**Total Functions**: 700  
+**Total Classes**: 97  
+**Modules**: 83  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.14 → code2llm-0.5.16}/README.md

@@ -10,48 +10,18 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 45 critical functions, 0 god modules |
-| `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
-| `flow.toon` | **TOON** | **🔄 Data flow analysis** - Pipelines, contracts, types | Data dependencies and side effects |
-| `map.toon` | **TOON** | **🗺️ Structural map** - Modules, imports, signatures | Project architecture overview |
-| `project.toon` | **TOON** | **🧠 Project logic** - Code2Logic compact module view | Generated via code2logic integration |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 43 critical functions, 0 god modules |
+| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
 
 ### 🤖 LLM-Ready Documentation
 
 | File | Format | Purpose | Use Case |
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
-| `prompt.txt` | **Text** | **📝 Ready-to-send prompt** - Lists all generated files with instructions | Attach to LLM conversation as context guide |
-| `analysis.yaml` | **YAML** | **📊 Structured data** - Machine-readable | For scripts and automated processing |
-| `analysis.json` | **JSON** | **🔧 API format** - Programmatic access | For integration with other tools |
 
-### 📊 Visualizations
-
-| File | Format | Purpose | Description |
-|------|--------|---------|-------------|
-| `flow.mmd` | **Mermaid** | **🔄 Control flow diagram** | Function call paths with complexity styling |
-| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
-| `compact_flow.mmd` | **Mermaid** | **📦 Module overview** | Aggregated module-level view |
-| `*.png` | **PNG** | **🖼️ Visual diagrams** | Rendered versions of Mermaid files |
 
 ## 🚀 Quick Start Commands
 
-### Complete LLM Analysis (with Code2Logic)
-```bash
-# Generate complete analysis with code2logic integration
-# Creates: analysis.toon, evolution.toon, project.toon, prompt.txt, README.md
-
-# Using specific formats (recommended)
-code2llm ./ -f toon,evolution,code2logic -o ./project
-
-# Using 'all' format (includes code2logic)
-code2llm ./ -f all -o ./project
-```
-
-The `code2logic` format automatically:
-1. Runs `code2logic` tool to generate `project.toon` (compact module view)
-2. Creates `prompt.txt` - ready-to-send prompt listing all generated files
-
 ### Basic Analysis
 ```bash
 # Quick health check (TOON format only)
@@ -64,12 +34,6 @@ code2llm ./ -f all
 code2llm ./ -f context
 ```
 
-Przykład z projektu toonic, z użyciem modelu Kimi K2.5 w VScode Windsurf:
-![img_1.png](img_1.png)
-```bash
-code2llm ./ -f toon,evolution -o ./project
-```
-
 ### Performance Options
 ```bash
 # Fast analysis for large projects
@@ -163,23 +127,6 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
-### `context.md` - LLM Narrative
-**Purpose**: Ready-to-paste context for AI assistants
-**Key sections**:
-- **Overview**: Project statistics
-- **Architecture**: Module breakdown
-- **Entry Points**: Public interfaces
-- **Patterns**: Design patterns detected
-
-**Example usage**:
-```bash
-# Copy to clipboard for LLM
-cat context.md | pbcopy  # macOS
-cat context.md | xclip -sel clip  # Linux
-
-# Use with Claude/ChatGPT for code analysis
-```
-
 ### `project.toon` - Project Logic (Code2Logic)
 **Purpose**: Compact module view generated by code2logic integration
 **Key sections**:
@@ -189,31 +136,49 @@ cat context.md | xclip -sel clip  # Linux
 
 **When to use**: When you need a lightweight project overview combined with code2llm analysis
 
-**Generation**:
+**Example usage**:
 ```bash
-# Generated automatically when using -f code2logic
-code2llm ./ -f toon,evolution,code2logic -o ./project
+# View compact project structure
+cat project.toon | head -30
+
+# Find largest files
+grep -E "^  .*[0-9]{3,}$" project.toon | sort -t',' -k2 -n -r | head -10
 ```
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Contents**:
-- **Files section**: Lists all existing generated files (analysis.toon, context.md, etc.)
+- **Files section**: Lists all existing generated files with descriptions
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
-- **Constraints section**: Guidelines for suggested changes
+- **Requirements section**: Guidelines for suggested changes
 
 **Example usage**:
 ```bash
 # View the prompt
-cat project/prompt.txt
+cat prompt.txt
 
 # Copy to clipboard and paste into ChatGPT/Claude
-cat project/prompt.txt | pbcopy  # macOS
-cat project/prompt.txt | xclip -sel clip  # Linux
+cat prompt.txt | pbcopy  # macOS
+cat prompt.txt | xclip -sel clip  # Linux
 ```
 
-**Generated when**: Using `-f code2logic` or `-f all`
+### `context.md` - LLM Narrative
+**Purpose**: Ready-to-paste context for AI assistants
+**Key sections**:
+- **Overview**: Project statistics
+- **Architecture**: Module breakdown
+- **Entry Points**: Public interfaces
+- **Patterns**: Design patterns detected
+
+**Example usage**:
+```bash
+# Copy to clipboard for LLM
+cat context.md | pbcopy  # macOS
+cat context.md | xclip -sel clip  # Linux
+
+# Use with Claude/ChatGPT for code analysis
+```
 
 ### Visualization Files (`*.mmd`, `*.png`)
 **Purpose**: Visual understanding of code structure
@@ -359,10 +324,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-01  
-**Total Functions**: 645  
-**Total Classes**: 94  
-**Modules**: 76  
+**Analysis Date**: 2026-03-03  
+**Total Functions**: 700  
+**Total Classes**: 97  
+**Modules**: 83  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.14 → code2llm-0.5.16}/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.13"
+__version__ = "0.5.16"
 __author__ = "STTS Project"
 
 # Core analysis components

{code2llm-0.5.14 → code2llm-0.5.16}/code2llm/core/analyzer.py

@@ -37,6 +37,7 @@ class ProjectAnalyzer:
         
         if self.config.verbose:
             print(f"Found {len(files)} files to analyze")
+            print(f"  - Parallel: {self.config.performance.parallel_enabled}, Workers: {self.config.performance.parallel_workers}")
         
         # Analyze files
         if self.config.performance.parallel_enabled and len(files) > 1:
@@ -54,7 +55,11 @@ class ProjectAnalyzer:
             self._detect_patterns(merged)
             
         # Refactoring analysis
+        if self.config.verbose:
+            print(f"  - Running refactoring analysis...", flush=True)
         self.refactoring_analyzer.perform_refactoring_analysis(merged)
+        if self.config.verbose:
+            print(f"  - Refactoring analysis complete", flush=True)
         
         # Calculate stats
         elapsed = time.time() - start_time
@@ -121,6 +126,7 @@ class ProjectAnalyzer:
             }
             
             # Collect results as they complete
+            completed = 0
             for future in as_completed(future_to_file):
                 file_path, module_name = future_to_file[future]
                 try:
@@ -130,6 +136,9 @@ class ProjectAnalyzer:
                 except Exception as e:
                     if self.config.verbose:
                         print(f"Error analyzing {file_path}: {e}")
+                completed += 1
+                if self.config.verbose and completed % 10 == 0:
+                    print(f"  - Progress: {completed}/{len(files)} files analyzed ({completed*100//len(files)}%)", flush=True)
         
         return results
     
@@ -137,8 +146,9 @@ class ProjectAnalyzer:
         """Analyze files sequentially."""
         results = []
         analyzer = FileAnalyzer(self.config, self.cache)
+        total = len(files)
         
-        for file_path, module_name in files:
+        for i, (file_path, module_name) in enumerate(files, 1):
             try:
                 result = analyzer.analyze_file(file_path, module_name)
                 if result:
@@ -146,6 +156,8 @@ class ProjectAnalyzer:
             except Exception as e:
                 if self.config.verbose:
                     print(f"Error analyzing {file_path}: {e}")
+            if self.config.verbose and (i % 10 == 0 or i == total):
+                print(f"  - Progress: {i}/{total} files analyzed ({i*100//total}%)", flush=True)
         
         return results
     
@@ -184,20 +196,48 @@ class ProjectAnalyzer:
     
     def _build_call_graph(self, result: AnalysisResult) -> None:
         """Build call graph and find entry points."""
+        if self.config.verbose:
+            print(f"  - Building call graph for {len(result.functions)} functions...", flush=True)
+        
+        # Build lookup maps for O(1) resolution
+        # Map simple name -> list of full names (for overloaded methods)
+        simple_to_full: Dict[str, List[str]] = {}
+        for known_name in result.functions:
+            simple_name = known_name.split('.')[-1]
+            if simple_name not in simple_to_full:
+                simple_to_full[simple_name] = []
+            simple_to_full[simple_name].append(known_name)
+        
         # Map calls between functions
         for func_name, func in result.functions.items():
-            for called in func.calls:
-                # Try to resolve to a known function
-                for known_name in result.functions:
-                    if known_name.endswith(f".{called}") or known_name == called:
-                        func.calls[func.calls.index(called)] = known_name
-                        result.functions[known_name].called_by.append(func_name)
-                        break
+            for idx, called in enumerate(func.calls):
+                # Try exact match first, then suffix match
+                if called in result.functions:
+                    resolved = called
+                elif called in simple_to_full:
+                    # Use first match if multiple (common case: single match)
+                    candidates = simple_to_full[called]
+                    # Prefer exact module match if available
+                    resolved = None
+                    for cand in candidates:
+                        if func_name.rsplit('.', 1)[0] == cand.rsplit('.', 1)[0]:
+                            resolved = cand
+                            break
+                    if resolved is None:
+                        resolved = candidates[0]
+                else:
+                    continue  # Unknown function
+                
+                func.calls[idx] = resolved
+                result.functions[resolved].called_by.append(func_name)
         
         # Find entry points (not called by anything)
         for func_name, func in result.functions.items():
             if not func.called_by:
                 result.entry_points.append(func_name)
+        
+        if self.config.verbose:
+            print(f"  - Call graph complete: {len(result.entry_points)} entry points found", flush=True)
     
     def _detect_patterns(self, result: AnalysisResult) -> None:
         """Detect behavioral patterns."""

{code2llm-0.5.14 → code2llm-0.5.16}/code2llm/core/core/refactoring.py

@@ -67,7 +67,16 @@ class RefactoringAnalyzer:
         """Calculate betweenness centrality for bottleneck detection."""
         if len(call_graph) > 0:
             try:
-                centrality = nx.betweenness_centrality(call_graph)
+                node_count = len(call_graph)
+                # For large graphs, use sampling to avoid exponential time complexity
+                if node_count > 500:
+                    if self.config.verbose:
+                        print(f"  Large graph ({node_count} nodes), using sampled centrality...")
+                    # Sample 20% of nodes, max 500
+                    k = min(int(node_count * 0.2), 500)
+                    centrality = nx.betweenness_centrality(call_graph, k=k)
+                else:
+                    centrality = nx.betweenness_centrality(call_graph)
                 for func_name, score in centrality.items():
                     if func_name in result.functions:
                         result.functions[func_name].centrality = score
@@ -78,6 +87,11 @@ class RefactoringAnalyzer:
     def _detect_cycles(self, call_graph: nx.DiGraph, result: AnalysisResult) -> None:
         """Detect circular dependencies."""
         try:
+            # Limit cycle detection for large graphs
+            if len(call_graph) > 1000:
+                if self.config.verbose:
+                    print(f"  Skipping cycle detection for large graph ({len(call_graph)} nodes)")
+                return
             cycles = list(nx.simple_cycles(call_graph))
             if cycles:
                 result.metrics["project"] = result.metrics.get("project", {})
@@ -89,6 +103,11 @@ class RefactoringAnalyzer:
     def _detect_communities(self, call_graph: nx.DiGraph, result: AnalysisResult) -> None:
         """Detect communities (module groups)."""
         try:
+            # Limit community detection for large graphs
+            if len(call_graph) > 1000:
+                if self.config.verbose:
+                    print(f"  Skipping community detection for large graph ({len(call_graph)} nodes)")
+                return
             from networkx.algorithms import community
             # Using Louvain if available, otherwise greedy modularity
             if hasattr(community, 'louvain_communities'):

{code2llm-0.5.14 → code2llm-0.5.16}/code2llm/nlp/__init__.py

@@ -4,7 +4,7 @@ Provides query normalization, intent matching, and entity resolution
 with multilingual support and fuzzy matching.
 """
 
-__version__ = "0.5.13"
+__version__ = "0.5.16"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer

{code2llm-0.5.14 → code2llm-0.5.16}/code2llm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.14
+Version: 0.5.16
 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
@@ -60,48 +60,18 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 45 critical functions, 0 god modules |
-| `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
-| `flow.toon` | **TOON** | **🔄 Data flow analysis** - Pipelines, contracts, types | Data dependencies and side effects |
-| `map.toon` | **TOON** | **🗺️ Structural map** - Modules, imports, signatures | Project architecture overview |
-| `project.toon` | **TOON** | **🧠 Project logic** - Code2Logic compact module view | Generated via code2logic integration |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 43 critical functions, 0 god modules |
+| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
 
 ### 🤖 LLM-Ready Documentation
 
 | File | Format | Purpose | Use Case |
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
-| `prompt.txt` | **Text** | **📝 Ready-to-send prompt** - Lists all generated files with instructions | Attach to LLM conversation as context guide |
-| `analysis.yaml` | **YAML** | **📊 Structured data** - Machine-readable | For scripts and automated processing |
-| `analysis.json` | **JSON** | **🔧 API format** - Programmatic access | For integration with other tools |
 
-### 📊 Visualizations
-
-| File | Format | Purpose | Description |
-|------|--------|---------|-------------|
-| `flow.mmd` | **Mermaid** | **🔄 Control flow diagram** | Function call paths with complexity styling |
-| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
-| `compact_flow.mmd` | **Mermaid** | **📦 Module overview** | Aggregated module-level view |
-| `*.png` | **PNG** | **🖼️ Visual diagrams** | Rendered versions of Mermaid files |
 
 ## 🚀 Quick Start Commands
 
-### Complete LLM Analysis (with Code2Logic)
-```bash
-# Generate complete analysis with code2logic integration
-# Creates: analysis.toon, evolution.toon, project.toon, prompt.txt, README.md
-
-# Using specific formats (recommended)
-code2llm ./ -f toon,evolution,code2logic -o ./project
-
-# Using 'all' format (includes code2logic)
-code2llm ./ -f all -o ./project
-```
-
-The `code2logic` format automatically:
-1. Runs `code2logic` tool to generate `project.toon` (compact module view)
-2. Creates `prompt.txt` - ready-to-send prompt listing all generated files
-
 ### Basic Analysis
 ```bash
 # Quick health check (TOON format only)
@@ -114,12 +84,6 @@ code2llm ./ -f all
 code2llm ./ -f context
 ```
 
-Przykład z projektu toonic, z użyciem modelu Kimi K2.5 w VScode Windsurf:
-![img_1.png](img_1.png)
-```bash
-code2llm ./ -f toon,evolution -o ./project
-```
-
 ### Performance Options
 ```bash
 # Fast analysis for large projects
@@ -213,23 +177,6 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
-### `context.md` - LLM Narrative
-**Purpose**: Ready-to-paste context for AI assistants
-**Key sections**:
-- **Overview**: Project statistics
-- **Architecture**: Module breakdown
-- **Entry Points**: Public interfaces
-- **Patterns**: Design patterns detected
-
-**Example usage**:
-```bash
-# Copy to clipboard for LLM
-cat context.md | pbcopy  # macOS
-cat context.md | xclip -sel clip  # Linux
-
-# Use with Claude/ChatGPT for code analysis
-```
-
 ### `project.toon` - Project Logic (Code2Logic)
 **Purpose**: Compact module view generated by code2logic integration
 **Key sections**:
@@ -239,31 +186,49 @@ cat context.md | xclip -sel clip  # Linux
 
 **When to use**: When you need a lightweight project overview combined with code2llm analysis
 
-**Generation**:
+**Example usage**:
 ```bash
-# Generated automatically when using -f code2logic
-code2llm ./ -f toon,evolution,code2logic -o ./project
+# View compact project structure
+cat project.toon | head -30
+
+# Find largest files
+grep -E "^  .*[0-9]{3,}$" project.toon | sort -t',' -k2 -n -r | head -10
 ```
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Contents**:
-- **Files section**: Lists all existing generated files (analysis.toon, context.md, etc.)
+- **Files section**: Lists all existing generated files with descriptions
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
-- **Constraints section**: Guidelines for suggested changes
+- **Requirements section**: Guidelines for suggested changes
 
 **Example usage**:
 ```bash
 # View the prompt
-cat project/prompt.txt
+cat prompt.txt
 
 # Copy to clipboard and paste into ChatGPT/Claude
-cat project/prompt.txt | pbcopy  # macOS
-cat project/prompt.txt | xclip -sel clip  # Linux
+cat prompt.txt | pbcopy  # macOS
+cat prompt.txt | xclip -sel clip  # Linux
 ```
 
-**Generated when**: Using `-f code2logic` or `-f all`
+### `context.md` - LLM Narrative
+**Purpose**: Ready-to-paste context for AI assistants
+**Key sections**:
+- **Overview**: Project statistics
+- **Architecture**: Module breakdown
+- **Entry Points**: Public interfaces
+- **Patterns**: Design patterns detected
+
+**Example usage**:
+```bash
+# Copy to clipboard for LLM
+cat context.md | pbcopy  # macOS
+cat context.md | xclip -sel clip  # Linux
+
+# Use with Claude/ChatGPT for code analysis
+```
 
 ### Visualization Files (`*.mmd`, `*.png`)
 **Purpose**: Visual understanding of code structure
@@ -409,10 +374,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-01  
-**Total Functions**: 645  
-**Total Classes**: 94  
-**Modules**: 76  
+**Analysis Date**: 2026-03-03  
+**Total Functions**: 700  
+**Total Classes**: 97  
+**Modules**: 83  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.14 → code2llm-0.5.16}/pyproject.toml

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