code2llm 0.5.79__tar.gz → 0.5.81__tar.gz

{code2llm-0.5.79 → code2llm-0.5.81}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.79
+Version: 0.5.81
 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
@@ -128,7 +128,7 @@ cat analysis.toon | head -30
 grep "REFACTOR" analysis.toon
 ```
 
-### `evolution.toon` - Refactoring Queue
+### `evolution.toon.yaml` - Refactoring Queue
 **Purpose**: Step-by-step refactoring plan
 **Key sections**:
 - **NEXT**: Immediate actions to take
@@ -138,10 +138,10 @@ grep "REFACTOR" analysis.toon
 **Example usage**:
 ```bash
 # Get refactoring plan
-cat evolution.toon
+cat evolution.toon.yaml
 
 # Track progress
-grep "NEXT" evolution.toon
+grep "NEXT" evolution.toon.yaml
 ```
 
 ### `flow.toon` - Legacy Data Flow Analysis
@@ -160,21 +160,21 @@ grep "PIPELINES" flow.toon
 grep "SIDE_EFFECTS" flow.toon
 ```
 
-### `map.toon` - Structural Map + Project Header
+### `map.toon.yaml` - Structural Map + Project Header
 **Purpose**: High-level architecture overview plus compact project header
 **Key sections**:
 - **MODULES**: All modules with basic stats
 - **IMPORTS**: Dependency relationships
-- **e:** Public API exports and signatures
+- **EXPORTS**: Public API surface and signatures
 - **HEADER**: Stats, alerts, hotspots, evolution trend
 
 **Example usage**:
 ```bash
 # See project structure
-cat map.toon | head -50
+cat map.toon.yaml | head -50
 
 # Find public APIs
-grep "^    e:" map.toon
+grep "SIGNATURES" map.toon.yaml
 ```
 
 ### `project.toon` - Legacy Project Logic (Deprecated)
@@ -256,7 +256,7 @@ cat analysis.toon | grep -E "(HEALTH|REFACTOR)"
 ```bash
 # Get refactoring queue
 code2llm ./ -f evolution
-cat evolution.toon
+cat evolution.toon.yaml
 
 # Focus on specific issues
 code2llm ./ -f toon --refactor --smell god_function
@@ -335,7 +335,7 @@ cat docs/context.md >> README.md
 ## 📚 Next Steps
 
 1. **Review `analysis.toon`** - Identify critical issues
-2. **Check `evolution.toon`** - Plan refactoring priorities
+2. **Check `evolution.toon.yaml`** - Plan refactoring priorities
 3. **Use `context.md`** - Get LLM assistance for complex changes
 4. **Reference visualizations** - Understand system architecture
 5. **Track progress** - Re-run analysis after changes
@@ -369,10 +369,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-25  
-**Total Functions**: 891  
+**Analysis Date**: 2026-03-26  
+**Total Functions**: 923  
 **Total Classes**: 106  
-**Modules**: 121  
+**Modules**: 122  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.79 → code2llm-0.5.81}/README.md

@@ -78,7 +78,7 @@ cat analysis.toon | head -30
 grep "REFACTOR" analysis.toon
 ```
 
-### `evolution.toon` - Refactoring Queue
+### `evolution.toon.yaml` - Refactoring Queue
 **Purpose**: Step-by-step refactoring plan
 **Key sections**:
 - **NEXT**: Immediate actions to take
@@ -88,10 +88,10 @@ grep "REFACTOR" analysis.toon
 **Example usage**:
 ```bash
 # Get refactoring plan
-cat evolution.toon
+cat evolution.toon.yaml
 
 # Track progress
-grep "NEXT" evolution.toon
+grep "NEXT" evolution.toon.yaml
 ```
 
 ### `flow.toon` - Legacy Data Flow Analysis
@@ -110,21 +110,21 @@ grep "PIPELINES" flow.toon
 grep "SIDE_EFFECTS" flow.toon
 ```
 
-### `map.toon` - Structural Map + Project Header
+### `map.toon.yaml` - Structural Map + Project Header
 **Purpose**: High-level architecture overview plus compact project header
 **Key sections**:
 - **MODULES**: All modules with basic stats
 - **IMPORTS**: Dependency relationships
-- **e:** Public API exports and signatures
+- **EXPORTS**: Public API surface and signatures
 - **HEADER**: Stats, alerts, hotspots, evolution trend
 
 **Example usage**:
 ```bash
 # See project structure
-cat map.toon | head -50
+cat map.toon.yaml | head -50
 
 # Find public APIs
-grep "^    e:" map.toon
+grep "SIGNATURES" map.toon.yaml
 ```
 
 ### `project.toon` - Legacy Project Logic (Deprecated)
@@ -206,7 +206,7 @@ cat analysis.toon | grep -E "(HEALTH|REFACTOR)"
 ```bash
 # Get refactoring queue
 code2llm ./ -f evolution
-cat evolution.toon
+cat evolution.toon.yaml
 
 # Focus on specific issues
 code2llm ./ -f toon --refactor --smell god_function
@@ -285,7 +285,7 @@ cat docs/context.md >> README.md
 ## 📚 Next Steps
 
 1. **Review `analysis.toon`** - Identify critical issues
-2. **Check `evolution.toon`** - Plan refactoring priorities
+2. **Check `evolution.toon.yaml`** - Plan refactoring priorities
 3. **Use `context.md`** - Get LLM assistance for complex changes
 4. **Reference visualizations** - Understand system architecture
 5. **Track progress** - Re-run analysis after changes
@@ -319,10 +319,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-25  
-**Total Functions**: 891  
+**Analysis Date**: 2026-03-26  
+**Total Functions**: 923  
 **Total Classes**: 106  
-**Modules**: 121  
+**Modules**: 122  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

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

{code2llm-0.5.79 → code2llm-0.5.81}/code2llm/cli_exports/formats.py

@@ -80,7 +80,7 @@ def _run_report(args, project_yaml_path: str, output_dir: Path) -> None:
         report_formats = ['toon', 'context', 'article', 'html']
 
     generator_map = {
-        'toon': ('project.toon', ToonViewGenerator(), 'TOON view'),
+        'toon': ('analysis_view.toon', ToonViewGenerator(), 'TOON view'),
         'context': ('context.md', ContextViewGenerator(), 'Context view'),
         'article': ('status.md', ArticleViewGenerator(), 'Article view'),
         'html': ('dashboard.html', HTMLDashboardGenerator(), 'HTML dashboard'),
@@ -116,12 +116,12 @@ def _export_simple_formats(args, result, output_dir: Path, formats):
                 print(f"  - {label}: {filepath}")
 
     # Unified project.yaml (single source of truth)
-    if 'project-yaml' in formats or 'all' in formats:
+    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': ToonViewGenerator(),
+            'analysis_view.toon': ToonViewGenerator(),
             'context.md': ContextViewGenerator(),
             'dashboard.html': HTMLDashboardGenerator(),
         }

{code2llm-0.5.79 → code2llm-0.5.81}/code2llm/cli_exports/orchestrator.py

@@ -25,7 +25,7 @@ def _run_exports(args, result, output_dir: Path, source_path: Optional[Path] = N
     """
     formats = [f.strip() for f in args.format.split(',')]
     if 'all' in formats:
-        formats = ['toon', 'map', 'context', 'yaml', 'json', 'mermaid', 'evolution']
+        formats = ['toon', 'map', 'context', 'mermaid', 'evolution']
 
     is_chunked = args.chunk if hasattr(args, 'chunk') else False
 
@@ -51,8 +51,8 @@ def _export_single_project(args, result, output_dir: Path, formats: list, source
     _export_context_fallback(args, result, output_dir, formats)
 
     if source_path is not None:
-        _export_code2logic(args, source_path, output_dir, formats)
-        _export_prompt_txt(args, output_dir, formats, source_path)
+        _export_code2logic(args, source_path, output_dir, args.format.split(','))
+        _export_prompt_txt(args, output_dir, args.format.split(','), source_path)
 
     if hasattr(args, 'refactor') and args.refactor:
         _export_refactor_prompts(args, result, output_dir)
@@ -75,8 +75,8 @@ def _export_chunked_results(args, result, output_dir: Path, source_path: Path, f
     _export_evolution(args, result, output_dir)
 
     if source_path is not None:
-        _export_code2logic(args, source_path, output_dir, formats)
-        _export_chunked_prompt_txt(args, output_dir, formats, source_path, subprojects)
+        _export_code2logic(args, source_path, output_dir, args.format.split(','))
+        _export_chunked_prompt_txt(args, output_dir, args.format.split(','), source_path, subprojects)
 
     _export_readme(args, result, output_dir)
 

{code2llm-0.5.79 → code2llm-0.5.81}/code2llm/cli_exports/prompt.py

@@ -77,11 +77,11 @@ def _get_prompt_paths(source_path: Optional[Path], output_dir: Path) -> Tuple[st
 
 
 _MAIN_FILES = [
-    ('analysis.toon', 'Health diagnostics - complexity metrics, god modules, coupling issues, refactoring priorities'),
+    ('analysis.toon.yaml', 'Health diagnostics - complexity metrics, god modules, coupling issues, refactoring priorities'),
     ('map.toon.yaml', 'Structural map - files, sizes, imports, exports, signatures, project header'),
-    ('context.md', 'LLM narrative - architecture summary, key entry points, process flows, public API surface'),
     ('evolution.toon.yaml', 'Refactoring queue - ranked actions by impact/effort, risks, metrics targets, history'),
-    ('README.md', 'Documentation - complete guide to all generated files, usage examples, interpretation'),
+    ('validation.toon.yaml', 'Validation analysis - generated by vallm tool (in project/ subdirectory)'),
+    ('duplication.toon.yaml', 'Code duplication analysis - generated by redup tool (in project/ subdirectory)'),
 ]
 
 
@@ -94,6 +94,8 @@ def _build_prompt_header(project_path: str) -> List[str]:
         f"we are in project path: {project_path}",
         "",
         "Files for analysis:",
+        "",
+        "Note: validation.toon.yaml and duplication.toon.yaml are generated by external tools (vallm and redup)",
     ]
 
 
@@ -101,11 +103,18 @@ def _build_main_files_section(output_dir: Path, output_rel_path: str) -> List[st
     """Build main files section with size metrics."""
     lines = []
     for name, desc in _MAIN_FILES:
-        file_path = output_dir / name
+        # Special handling for validation and duplication files
+        if name in ['validation.toon.yaml', 'duplication.toon.yaml']:
+            file_path = output_dir / 'project' / name
+            rel_path = f"{output_rel_path}/project/{name}"
+        else:
+            file_path = output_dir / name
+            rel_path = f"{output_rel_path}/{name}"
+        
         if file_path.exists():
             size_bytes = file_path.stat().st_size
             size_str = _format_size(size_bytes)
-            lines.append(f"- {output_rel_path}/{name}  ({desc}) [{size_str}]")
+            lines.append(f"- {rel_path}  ({desc}) [{size_str}]")
     return lines
 
 
@@ -121,7 +130,15 @@ def _format_size(size_bytes: int) -> str:
 
 def _get_missing_files(output_dir: Path) -> List[str]:
     """Return names of expected main files that are missing."""
-    return [name for name, _ in _MAIN_FILES if not (output_dir / name).exists()]
+    missing = []
+    for name, _ in _MAIN_FILES:
+        if name in ['validation.toon.yaml', 'duplication.toon.yaml']:
+            file_path = output_dir / 'project' / name
+        else:
+            file_path = output_dir / name
+        if not file_path.exists():
+            missing.append(name)
+    return missing
 
 
 def _build_subprojects_section(subprojects: list, output_dir: Path, output_rel_path: str) -> List[str]:
@@ -161,21 +178,22 @@ def _build_missing_files_section(output_dir: Path, output_rel_path: str) -> List
         return []
     lines = ["", "Missing files (not generated in this run):"]
     for name in missing:
-        lines.append(f"- {output_rel_path}/{name}")
+        # Special handling for validation and duplication files
+        if name in ['validation.toon.yaml', 'duplication.toon.yaml']:
+            lines.append(f"- {output_rel_path}/project/{name}")
+        else:
+            lines.append(f"- {output_rel_path}/{name}")
     return lines
 
 
 def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict:
     """Analyze which files were generated and determine appropriate focus areas."""
     analysis = {
-        'has_analysis_toon': (output_dir / 'analysis.toon').exists(),
+        'has_analysis_toon': (output_dir / 'analysis.toon.yaml').exists(),
         'has_map_toon': (output_dir / 'map.toon.yaml').exists(),
-        'has_context_md': (output_dir / 'context.md').exists(),
         'has_evolution_toon': (output_dir / 'evolution.toon.yaml').exists(),
-        'has_readme': (output_dir / 'README.md').exists(),
-        'has_yaml': (output_dir / 'analysis.yaml').exists(),
-        'has_json': (output_dir / 'analysis.json').exists(),
-        'has_mermaid': (output_dir / 'flow.mmd').exists() or (output_dir / 'calls.mmd').exists(),
+        'has_validation_toon': (output_dir / 'project/validation.toon.yaml').exists(),
+        'has_duplication_toon': (output_dir / 'project/duplication.toon.yaml').exists(),
         'is_chunked': subprojects is not None and len(subprojects) > 0,
         'file_count': 0,
     }
@@ -201,17 +219,11 @@ def _build_dynamic_focus_areas(file_analysis: dict) -> List[str]:
     if file_analysis['has_evolution_toon']:
         focus_areas.append("3. **Refactoring Priorities** - Examine ranked refactoring actions and risk assessment from evolution.toon.yaml")
     
-    if file_analysis['has_context_md']:
-        focus_areas.append("4. **Architecture Overview** - Understand main flows, entry points, and public API from context.md")
-    
-    if file_analysis['has_yaml'] or file_analysis['has_json']:
-        focus_areas.append("5. **Structured Data** - Use machine-readable formats for automated analysis and metrics extraction")
+    if file_analysis['has_validation_toon']:
+        focus_areas.append("4. **Validation Analysis** - Review validation results and issues identified by vallm")
     
-    if file_analysis['has_mermaid']:
-        focus_areas.append("6. **Visual Flow** - Review control flow diagrams and call graphs for architectural insights")
-    
-    if file_analysis['is_chunked']:
-        focus_areas.append("7. **Large Repository Patterns** - Identify cross-chunk dependencies and consolidation opportunities")
+    if file_analysis['has_duplication_toon']:
+        focus_areas.append("5. **Code Duplication** - Examine duplicate code patterns detected by redup")
     
     if not focus_areas:
         focus_areas.append("1. **General Code Review** - Provide overall architecture assessment and improvement recommendations")
@@ -236,11 +248,11 @@ def _build_dynamic_tasks(file_analysis: dict) -> List[str]:
     if file_analysis['has_evolution_toon']:
         tasks.append("- Prioritize refactoring actions by impact/effort ratio from evolution.toon.yaml.")
     
-    if file_analysis['has_context_md']:
-        tasks.append("- Validate entry points and public API surface match the architecture described.")
-
-    if file_analysis['is_chunked']:
-        tasks.append("- Analyze cross-chunk dependencies and suggest consolidation strategies.")
+    if file_analysis['has_validation_toon']:
+        tasks.append("- Review validation findings from project/validation.toon.yaml generated by vallm.")
+    
+    if file_analysis['has_duplication_toon']:
+        tasks.append("- Analyze code duplication patterns from project/duplication.toon.yaml generated by redup.")
     
     return tasks
 
@@ -271,14 +283,13 @@ def _build_prompt_footer(chunked: bool = False, file_analysis: dict = None) -> L
         lines.append("")
         lines.append("Analysis Strategy:")
         if file_analysis['has_analysis_toon'] and file_analysis['has_map_toon']:
-            lines.append("- Start with analysis.toon for health metrics, then map.toon.yaml for structure and signatures")
+            lines.append("- Start with analysis.toon.yaml for health metrics, then map.toon.yaml for structure and signatures")
             if file_analysis['has_evolution_toon']:
-                lines.append("- Finish with evolution.toon.yaml for action priorities and next steps")
-        elif file_analysis['has_context_md']:
-            lines.append("- Use context.md as the primary reference for architectural understanding")
-        
-        if file_analysis['has_yaml']:
-            lines.append("- Reference analysis.yaml for precise metrics and programmatic data")
+                lines.append("- Review evolution.toon.yaml for action priorities and next steps")
+        if file_analysis['has_validation_toon']:
+            lines.append("- Check project/validation.toon.yaml for validation issues (vallm tool output)")
+        if file_analysis['has_duplication_toon']:
+            lines.append("- Examine project/duplication.toon.yaml for duplicate code patterns (redup tool output)")
     
     # Constraints
     lines.append("")