code2llm 0.5.9__tar.gz → 0.5.10__tar.gz

{code2llm-0.5.9 → code2llm-0.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.9
+Version: 0.5.10
 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

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

{code2llm-0.5.9 → code2llm-0.5.10}/code2llm/cli.py

@@ -445,36 +445,48 @@ def _export_code2logic(args, source_path: Path, output_dir: Path, formats: list[
         print(f"  - CODE2LOGIC (project logic): {target}")
 
 
-def _export_prompt_txt(args, output_dir: Path, formats: list[str]) -> None:
+def _export_prompt_txt(args, output_dir: Path, formats: list[str], source_path: Optional[Path] = None) -> None:
     """Generate prompt.txt useful to send to an LLM."""
     # Keep it conservative: generate when code2logic is requested.
     if 'code2logic' not in formats and 'all' not in formats:
         return
 
     prompt_path = output_dir / 'prompt.txt'
+    
+    # Determine absolute paths for display
+    project_path = str(source_path.resolve()) if source_path else str(Path.cwd().resolve())
+    output_abs_path = str(output_dir.resolve())
 
     files = [
-        'analysis.toon',
-        'context.md',
-        'evolution.toon',
-        'project.toon',
-        'README.md',
+        ('analysis.toon', 'Health diagnostics - complexity metrics, god modules, coupling issues, refactoring priorities'),
+        ('context.md', 'LLM narrative - architecture summary, key entry points, process flows, public API surface'),
+        ('evolution.toon', 'Refactoring queue - ranked actions by impact/effort, risks, metrics targets, history'),
+        ('project.toon', 'Project logic - compact module view from code2logic, file sizes, dependencies overview'),
+        ('README.md', 'Documentation - complete guide to all generated files, usage examples, interpretation'),
     ]
-    existing = [f for f in files if (output_dir / f).exists()]
-    missing = [f for f in files if (output_dir / f).exists() is False]
+    
+    existing = [(name, desc) for name, desc in files if (output_dir / name).exists()]
+    missing = [name for name, desc in files if (output_dir / name).exists() is False]
 
     lines: list[str] = []
     lines.append("You are an AI assistant helping me understand and improve a codebase.")
     lines.append("Use the attached/generated files as the authoritative context.")
     lines.append("")
-    lines.append("Files:")
-    for f in existing:
-        lines.append(f"- {f}")
+    lines.append(f"we are in project path: {project_path}")
+    lines.append("")
+    lines.append("Files for analysis:")
+    
+    for name, desc in existing:
+        file_path = f"{output_abs_path}/{name}"
+        lines.append(f"- {file_path}  ({desc})")
+    
     if missing:
         lines.append("")
-        lines.append("Missing (not generated in this run):")
-        for f in missing:
-            lines.append(f"- {f}")
+        lines.append("Missing files (not generated in this run):")
+        for name in missing:
+            file_path = f"{output_abs_path}/{name}"
+            lines.append(f"- {file_path}")
+    
     lines.append("")
     lines.append("Task:")
     lines.append("- Summarize the architecture and main flows.")
@@ -508,7 +520,7 @@ def _run_exports(args, result, output_dir: Path, source_path: Optional[Path] = N
 
         if source_path is not None:
             _export_code2logic(args, source_path, output_dir, formats)
-            _export_prompt_txt(args, output_dir, formats)
+            _export_prompt_txt(args, output_dir, formats, source_path)
         
         if args.refactor:
             _export_refactor_prompts(args, result, output_dir)

{code2llm-0.5.9 → code2llm-0.5.10}/code2llm/exporters/readme_exporter.py

@@ -91,6 +91,14 @@ class READMEExporter(BaseExporter):
         
         current_date = datetime.now().strftime('%Y-%m-%d')
         
+        # Check which files actually exist
+        existing_files = self._get_existing_files(output_dir)
+        
+        # Build dynamic file sections
+        core_files_section = self._build_core_files_section(existing_files, insights)
+        llm_files_section = self._build_llm_files_section(existing_files)
+        viz_files_section = self._build_viz_files_section(existing_files)
+        
         content = f"""# code2llm - Generated Analysis Files
 
 This directory contains the complete analysis of your Python project generated by `code2llm`. Each file serves a specific purpose for understanding, refactoring, and documenting your codebase.
@@ -99,32 +107,9 @@ This directory contains the complete analysis of your Python project generated b
 
 When you run `code2llm ./ -f all`, the following files are created:
 
-### 🎯 Core Analysis Files
-
-| File | Format | Purpose | Key Insights |
-|------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | {insights['critical_functions']} critical functions, {insights['god_modules']} god modules |
-| `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | {insights['refactoring_actions']} 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 |
-
-### 🤖 LLM-Ready Documentation
-
-| File | Format | Purpose | Use Case |
-|------|--------|---------|----------|
-| `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
-| `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 |
-
+{core_files_section}
+{llm_files_section}
+{viz_files_section}
 ## 🚀 Quick Start Commands
 
 ### Basic Analysis
@@ -232,6 +217,42 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
+### `project.toon` - Project Logic (Code2Logic)
+**Purpose**: Compact module view generated by code2logic integration
+**Key sections**:
+- **Modules list**: All project modules with file sizes
+- **Imports**: Dependency information
+- **Classes/Functions**: Summary counts
+
+**When to use**: When you need a lightweight project overview combined with code2llm analysis
+
+**Example usage**:
+```bash
+# 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 with descriptions
+- **Missing section**: Shows which files weren't generated (if any)
+- **Task section**: Instructions for LLM analysis
+- **Requirements section**: Guidelines for suggested changes
+
+**Example usage**:
+```bash
+# View the prompt
+cat prompt.txt
+
+# Copy to clipboard and paste into ChatGPT/Claude
+cat prompt.txt | pbcopy  # macOS
+cat prompt.txt | xclip -sel clip  # Linux
+```
+
 ### `context.md` - LLM Narrative
 **Purpose**: Ready-to-paste context for AI assistants
 **Key sections**:
@@ -402,3 +423,79 @@ For more information about code2llm, visit: https://github.com/tom-sapletta/code
 """
         
         return content
+
+    def _get_existing_files(self, output_dir: Path) -> Dict[str, bool]:
+        """Check which files exist in the output directory."""
+        files_to_check = {
+            'analysis.toon': 'Health diagnostics',
+            'evolution.toon': 'Refactoring queue',
+            'flow.toon': 'Data flow analysis',
+            'map.toon': 'Structural map',
+            'project.toon': 'Project logic',
+            'prompt.txt': 'LLM prompt',
+            'context.md': 'LLM narrative',
+            'analysis.yaml': 'YAML data',
+            'analysis.json': 'JSON data',
+            'flow.mmd': 'Flow diagram',
+            'calls.mmd': 'Call graph',
+            'compact_flow.mmd': 'Module view',
+        }
+        return {name: (output_dir / name).exists() for name in files_to_check}
+    
+    def _build_core_files_section(self, existing: Dict[str, bool], insights: Dict[str, Any]) -> str:
+        """Build the Core Analysis Files section dynamically."""
+        lines = ["### 🎯 Core Analysis Files", ""]
+        lines.append("| File | Format | Purpose | Key Insights |")
+        lines.append("|------|--------|---------|--------------|")
+        
+        if existing.get('analysis.toon'):
+            lines.append(f"| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | {insights['critical_functions']} critical functions, {insights['god_modules']} god modules |")
+        if existing.get('evolution.toon'):
+            lines.append(f"| `evolution.toon` | **TOON** | **📋 Refactoring queue** - Prioritized improvements | {insights['refactoring_actions']} refactoring actions needed |")
+        if existing.get('flow.toon'):
+            lines.append("| `flow.toon` | **TOON** | **🔄 Data flow analysis** - Pipelines, contracts, types | Data dependencies and side effects |")
+        if existing.get('map.toon'):
+            lines.append("| `map.toon` | **TOON** | **🗺️ Structural map** - Modules, imports, signatures | Project architecture overview |")
+        if existing.get('project.toon'):
+            lines.append("| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |")
+        
+        lines.append("")
+        return "\n".join(lines)
+    
+    def _build_llm_files_section(self, existing: Dict[str, bool]) -> str:
+        """Build the LLM-Ready Documentation section dynamically."""
+        lines = ["### 🤖 LLM-Ready Documentation", ""]
+        lines.append("| File | Format | Purpose | Use Case |")
+        lines.append("|------|--------|---------|----------|")
+        
+        if existing.get('prompt.txt'):
+            lines.append("| `prompt.txt` | **Text** | **📝 Ready-to-send prompt** - Lists all files with instructions | Attach to LLM conversation as context guide |")
+        if existing.get('context.md'):
+            lines.append("| `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |")
+        if existing.get('analysis.yaml'):
+            lines.append("| `analysis.yaml` | **YAML** | **📊 Structured data** - Machine-readable | For scripts and automated processing |")
+        if existing.get('analysis.json'):
+            lines.append("| `analysis.json` | **JSON** | **🔧 API format** - Programmatic access | For integration with other tools |")
+        
+        lines.append("")
+        return "\n".join(lines)
+    
+    def _build_viz_files_section(self, existing: Dict[str, bool]) -> str:
+        """Build the Visualizations section dynamically."""
+        has_mermaid = existing.get('flow.mmd') or existing.get('calls.mmd') or existing.get('compact_flow.mmd')
+        if not has_mermaid:
+            return ""
+            
+        lines = ["### 📊 Visualizations", ""]
+        lines.append("| File | Format | Purpose | Description |")
+        lines.append("|------|--------|---------|-------------|")
+        
+        if existing.get('flow.mmd'):
+            lines.append("| `flow.mmd` | **Mermaid** | **🔄 Control flow diagram** | Function call paths with complexity styling |")
+        if existing.get('calls.mmd'):
+            lines.append("| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |")
+        if existing.get('compact_flow.mmd'):
+            lines.append("| `compact_flow.mmd` | **Mermaid** | **📦 Module overview** | Aggregated module-level view |")
+        
+        lines.append("")
+        return "\n".join(lines)

{code2llm-0.5.9 → code2llm-0.5.10}/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.9"
+__version__ = "0.5.10"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer

{code2llm-0.5.9 → code2llm-0.5.10}/code2llm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.9
+Version: 0.5.10
 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

{code2llm-0.5.9 → code2llm-0.5.10}/pyproject.toml

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

{code2llm-0.5.9 → code2llm-0.5.10}/tests/test_prompt_txt.py

@@ -27,8 +27,9 @@ class TestPromptTxtGeneration:
     def test_prompt_txt_not_generated_without_code2logic_format(self, temp_output_dir, mock_args):
         """Test that prompt.txt is NOT generated when code2logic is not in formats."""
         formats = ['toon', 'evolution']
+        source_path = Path('/home/user/myproject')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         assert not prompt_file.exists(), "prompt.txt should not be generated without code2logic format"
@@ -36,12 +37,13 @@ class TestPromptTxtGeneration:
     def test_prompt_txt_generated_with_code2logic_format(self, temp_output_dir, mock_args):
         """Test that prompt.txt IS generated when code2logic is in formats."""
         formats = ['toon', 'evolution', 'code2logic']
+        source_path = Path('/home/user/myproject')
         
         # Create some existing files
         (temp_output_dir / 'analysis.toon').write_text('test')
         (temp_output_dir / 'context.md').write_text('test')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         assert prompt_file.exists(), "prompt.txt should be generated with code2logic format"
@@ -49,93 +51,113 @@ class TestPromptTxtGeneration:
     def test_prompt_txt_generated_with_all_format(self, temp_output_dir, mock_args):
         """Test that prompt.txt IS generated when 'all' is in formats."""
         formats = ['all']
+        source_path = Path('/home/user/myproject')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         assert prompt_file.exists(), "prompt.txt should be generated with 'all' format"
     
     def test_prompt_txt_lists_existing_files(self, temp_output_dir, mock_args):
-        """Test that prompt.txt correctly lists existing files."""
+        """Test that prompt.txt correctly lists existing files with paths and descriptions."""
         formats = ['code2logic']
+        source_path = Path('/home/user/myproject')
         
         # Create some files that should be detected
         expected_files = ['analysis.toon', 'context.md']
         for f in expected_files:
             (temp_output_dir / f).write_text('test content')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         content = prompt_file.read_text()
         
-        # Check that existing files are listed
+        # Check that project path is shown
+        assert "we are in project path:" in content
+        assert "/home/user/myproject" in content
+        
+        # Check that existing files are listed with paths and descriptions
+        assert "Files for analysis:" in content
         for f in expected_files:
-            assert f"- {f}" in content, f"Existing file {f} should be listed in prompt.txt"
+            assert f in content, f"Existing file {f} should be listed in prompt.txt"
+            # Check for path format with description
+            assert "- " in content, "File should be listed with bullet point"
         
         # Check that missing files are marked
-        assert "Missing" in content or "project.toon" in content, "Missing files should be indicated"
+        assert "Missing files" in content or "project.toon" in content, "Missing files should be indicated"
     
     def test_prompt_txt_shows_missing_files(self, temp_output_dir, mock_args):
         """Test that prompt.txt shows missing files section when files don't exist."""
         formats = ['code2logic']
+        source_path = Path('/home/user/myproject')
         
         # Don't create any files - all should be missing
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         content = prompt_file.read_text()
         
-        assert "Missing" in content, "Missing section should be present when files don't exist"
+        assert "Missing files" in content, "Missing section should be present when files don't exist"
         assert "analysis.toon" in content, "Missing files should be listed"
     
     def test_prompt_txt_contains_task_instructions(self, temp_output_dir, mock_args):
         """Test that prompt.txt contains task instructions for LLM."""
         formats = ['code2logic']
+        source_path = Path('/home/user/myproject')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         content = prompt_file.read_text()
         
         # Check for key sections
-        assert "Files:" in content, "Files section should be present"
+        assert "You are an AI assistant" in content, "Main instruction should be present"
         assert "Task:" in content, "Task section should be present"
         assert "Constraints:" in content, "Constraints section should be present"
+        assert "we are in project path:" in content, "Project path should be present"
     
     def test_prompt_txt_content_structure(self, temp_output_dir, mock_args):
         """Test the overall structure of generated prompt.txt."""
         formats = ['code2logic']
+        source_path = Path('/home/user/myproject')
         
         # Create all expected files
         all_files = ['analysis.toon', 'context.md', 'evolution.toon', 'project.toon', 'README.md']
         for f in all_files:
             (temp_output_dir / f).write_text('test')
         
-        _export_prompt_txt(mock_args, temp_output_dir, formats)
+        _export_prompt_txt(mock_args, temp_output_dir, formats, source_path)
         
         prompt_file = temp_output_dir / 'prompt.txt'
         content = prompt_file.read_text()
         lines = content.split('\n')
         
         # Check structure
-        assert any("AI assistant" in line or "helping me" in line for line in lines), \
-            "Prompt should mention AI assistant"
-        assert any("authoritative context" in line for line in lines), \
-            "Prompt should mention authoritative context"
+        assert any("You are an AI assistant" in line for line in lines), \
+            "Prompt should start with AI assistant instruction"
+        assert any("we are in project path:" in line for line in lines), \
+            "Project path should be present"
+        assert any("Files for analysis:" in line for line in lines), \
+            "Files section should be present"
         
         # All files should be listed without missing section
-        assert "Missing" not in content, "No missing section when all files exist"
+        assert "Missing files" not in content, "No missing section when all files exist"
         for f in all_files:
-            assert f"- {f}" in content, f"All files should be listed: {f}"
+            assert f in content, f"All files should be listed: {f}"
+        
+        # Check for file paths with descriptions
+        assert "- " in content, "Files should be listed with bullet points"
+        assert "Health diagnostics" in content, "Descriptions should be present"
     
     def test_prompt_txt_no_verbose_output(self, temp_output_dir):
         """Test that no print occurs when verbose is False."""
         args = MagicMock()
         args.verbose = False
         formats = ['code2logic']
+        source_path = Path('/home/user/myproject')
         
         # Should not raise or print anything
-        _export_prompt_txt(args, temp_output_dir, formats)
+        _export_prompt_txt(args, temp_output_dir, formats, source_path)
         
         assert (temp_output_dir / 'prompt.txt').exists()