code2llm 0.5.32__tar.gz → 0.5.34__tar.gz

{code2llm-0.5.32 → code2llm-0.5.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.32
+Version: 0.5.34
 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,7 +60,7 @@ 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 | 46 critical functions, 0 god modules |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 55 critical functions, 1 god modules |
 | `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
 
 ### 🤖 LLM-Ready Documentation
@@ -375,9 +375,9 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-05  
-**Total Functions**: 753  
-**Total Classes**: 99  
-**Modules**: 90  
+**Total Functions**: 774  
+**Total Classes**: 104  
+**Modules**: 92  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.32 → code2llm-0.5.34}/README.md

@@ -10,7 +10,7 @@ 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 | 46 critical functions, 0 god modules |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Complexity, god modules, coupling | 55 critical functions, 1 god modules |
 | `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
 
 ### 🤖 LLM-Ready Documentation
@@ -325,9 +325,9 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-05  
-**Total Functions**: 753  
-**Total Classes**: 99  
-**Modules**: 90  
+**Total Functions**: 774  
+**Total Classes**: 104  
+**Modules**: 92  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

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

{code2llm-0.5.32 → code2llm-0.5.34}/code2llm/cli.py

@@ -16,6 +16,7 @@ from .cli_exports import (
     _export_evolution, _export_data_structures, _export_context_fallback,
     _export_readme, _export_code2logic, _export_prompt_txt, _run_exports,
     _export_simple_formats, _export_yaml, _export_mermaid, _export_refactor_prompts,
+    _export_project_yaml, _run_report,
 )
 
 
@@ -41,20 +42,24 @@ Examples:
   code2llm ./ -f mermaid --no-png                   # Mermaid diagrams without PNG
   code2llm ./ -m static -v -o ./analysis            # Static mode, verbose
   code2llm ./ --no-readme                           # Disable README generation
+  code2llm ./ -f project-yaml                       # Unified project.yaml (single source of truth)
+  code2llm report --format toon                     # Generate view from project.yaml
+  code2llm report --format all                      # All views from project.yaml
   code2llm llm-flow                                 # Generate LLM flow summary
   code2llm llm-context ./                           # Generate LLM context only
 
 Format Options (-f):
-  toon      — Health diagnostics (analysis.toon) [default]
-  map       — Structural map (map.toon) — modules, imports, signatures
-  flow      — Data-flow analysis (flow.toon) — pipelines, contracts, types
-  context   — LLM narrative (context.md) — architecture summary
-  code2logic — Generate project logic (project.toon) via external code2logic
-  yaml      — Standard YAML format
-  json      — Machine-readable JSON
-  mermaid   — Flowchart diagrams (flow.mmd, calls.mmd, compact_flow.mmd)
-  evolution — Refactoring queue (evolution.toon)
-  all       — Generate all formats
+  toon         — Health diagnostics (analysis.toon) [default]
+  map          — Structural map (map.toon) — modules, imports, signatures
+  flow         — Data-flow analysis (flow.toon) — pipelines, contracts, types
+  context      — LLM narrative (context.md) — architecture summary
+  code2logic   — Generate project logic (project.toon) via external code2logic
+  yaml         — Standard YAML format
+  json         — Machine-readable JSON
+  mermaid      — Flowchart diagrams (flow.mmd, calls.mmd, compact_flow.mmd)
+  evolution    — Refactoring queue (evolution.toon)
+  project-yaml — Unified project.yaml (single source of truth) + generated views
+  all          — Generate all formats (including project-yaml)
 
 Strategy Options (--strategy):
   quick     — Fast overview, fewer files analyzed
@@ -244,15 +249,78 @@ Strategy Options (--strategy):
 
 
 def _handle_special_commands() -> Optional[int]:
-    """Handle special sub-commands (llm-flow, llm-context)."""
+    """Handle special sub-commands (llm-flow, llm-context, report)."""
     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:])
     if len(sys.argv) > 1 and sys.argv[1] == 'llm-context':
         return generate_llm_context(sys.argv[2:])
+    if len(sys.argv) > 1 and sys.argv[1] == 'report':
+        return _handle_report_command(sys.argv[2:])
     return None
 
 
+def _handle_report_command(args_list) -> int:
+    """Generate views from an existing project.yaml.
+
+    Usage:
+        code2llm report --format toon    # → project.toon
+        code2llm report --format context # → context.md
+        code2llm report --format article # → status.md
+        code2llm report --format html    # → dashboard.html
+        code2llm report --format all     # → all views
+    """
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        prog='code2llm report',
+        description='Generate views from project.yaml (single source of truth)',
+    )
+    parser.add_argument(
+        '--input', '-i',
+        default='./project.yaml',
+        help='Path to project.yaml (default: ./project.yaml)',
+    )
+    parser.add_argument(
+        '--format', '-f',
+        dest='report_format',
+        default='all',
+        help='Output format: toon, context, article, html, all (default: all)',
+    )
+    parser.add_argument(
+        '-o', '--output',
+        default='.',
+        help='Output directory (default: current directory)',
+    )
+    parser.add_argument(
+        '-v', '--verbose',
+        action='store_true',
+        help='Verbose output',
+    )
+
+    args = parser.parse_args(args_list)
+
+    input_path = Path(args.input)
+    if not input_path.exists():
+        print(f"Error: project.yaml not found: {input_path}", file=sys.stderr)
+        print("Run 'code2llm <source> -f project-yaml' first to generate it.", file=sys.stderr)
+        return 1
+
+    output_dir = Path(args.output)
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    if args.verbose:
+        print(f"Generating views from: {input_path}")
+        print(f"Output directory: {output_dir}")
+
+    _run_report(args, str(input_path), output_dir)
+
+    if args.verbose:
+        print(f"\nAll views saved to: {output_dir}")
+
+    return 0
+
+
 def _validate_and_setup(args) -> tuple[Path, Path]:
     """Validate source path and setup output directory."""
     if not args.source:

{code2llm-0.5.32 → code2llm-0.5.34}/code2llm/cli_exports.py

@@ -10,7 +10,10 @@ from typing import List, Optional, Tuple
 from .exporters import (
     YAMLExporter, JSONExporter, MermaidExporter,
     ContextExporter, ToonExporter, MapExporter, FlowExporter,
-    EvolutionExporter, READMEExporter,
+    EvolutionExporter, READMEExporter, ProjectYAMLExporter,
+    ToonViewGenerator, ContextViewGenerator,
+    ArticleViewGenerator, HTMLDashboardGenerator,
+    load_project_yaml,
 )
 
 
@@ -386,8 +389,46 @@ def _export_prompt_txt(args, output_dir: Path, formats: list[str], source_path:
         print(f"  - PROMPT: {prompt_path}")
 
 
+def _export_project_yaml(args, result, output_dir: Path):
+    """Export unified project.yaml — single source of truth."""
+    exporter = ProjectYAMLExporter()
+    filepath = output_dir / 'project.yaml'
+    exporter.export(result, str(filepath))
+    if getattr(args, 'verbose', False):
+        print(f"  - PROJECT-YAML (single source of truth): {filepath}")
+    return filepath
+
+
+def _run_report(args, project_yaml_path: str, output_dir: Path) -> None:
+    """Generate views from project.yaml.
+
+    Supported formats: toon, context, article, html, all.
+    """
+    data = load_project_yaml(project_yaml_path)
+    report_formats = [f.strip() for f in args.report_format.split(',')]
+    if 'all' in report_formats:
+        report_formats = ['toon', 'context', 'article', 'html']
+
+    generator_map = {
+        'toon': ('project.toon', ToonViewGenerator(), 'TOON view'),
+        'context': ('context.md', ContextViewGenerator(), 'Context view'),
+        'article': ('status.md', ArticleViewGenerator(), 'Article view'),
+        'html': ('dashboard.html', HTMLDashboardGenerator(), 'HTML dashboard'),
+    }
+
+    for fmt in report_formats:
+        if fmt not in generator_map:
+            print(f"Warning: unknown report format '{fmt}', skipping", file=sys.stderr)
+            continue
+        filename, generator, label = generator_map[fmt]
+        filepath = output_dir / filename
+        generator.generate(data, str(filepath))
+        if getattr(args, 'verbose', False):
+            print(f"  - {label}: {filepath}")
+
+
 def _export_simple_formats(args, result, output_dir: Path, formats):
-    """Export toon, map, flow, context, yaml, json formats."""
+    """Export toon, map, flow, context, yaml, json, project-yaml formats."""
     format_map = {
         'toon': ('analysis.toon', ToonExporter, 'TOON (diagnostics)'),
         'map': ('map.toon', MapExporter, 'MAP (structure)'),
@@ -403,6 +444,21 @@ def _export_simple_formats(args, result, output_dir: Path, formats):
             if args.verbose:
                 print(f"  - {label}: {filepath}")
 
+    # Unified project.yaml (single source of truth)
+    if 'project-yaml' in formats or 'all' 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(),
+            '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}")
+
     if 'yaml' in formats:
         _export_yaml(args, result, output_dir)
 
@@ -498,7 +554,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', 'flow', 'context', 'code2logic', 'yaml', 'json', 'mermaid', 'evolution']
+        formats = ['toon', 'map', 'flow', 'context', 'code2logic', 'yaml', 'json', 'mermaid', 'evolution', 'project-yaml']
 
     # Check if this is a chunked analysis (has subproject subdirs)
     is_chunked = args.chunk if hasattr(args, 'chunk') else False

{code2llm-0.5.32 → code2llm-0.5.34}/code2llm/core/large_repo.py

@@ -26,9 +26,9 @@ class SubProject:
     @property
     def estimated_size_kb(self) -> int:
         """Estimate output size based on file count."""
-        # Rough estimate: ~3KB per file in TOON format
+        # Rough estimate: ~1KB per file in TOON format
         file_count = len(self.files)
-        return max(1, file_count * 3)
+        return max(1, file_count * 1)
     
     @property
     def file_count(self) -> int:

{code2llm-0.5.32 → code2llm-0.5.34}/code2llm/exporters/__init__.py

@@ -25,6 +25,12 @@ from .map_exporter import MapExporter
 from .flow_exporter import FlowExporter
 from .evolution_exporter import EvolutionExporter
 from .readme_exporter import READMEExporter
+from .project_yaml_exporter import ProjectYAMLExporter
+from .report_generators import (
+    ToonViewGenerator, ContextViewGenerator,
+    ArticleViewGenerator, HTMLDashboardGenerator,
+    load_project_yaml,
+)
 
 __all__ = [
     'Exporter',
@@ -38,4 +44,10 @@ __all__ = [
     'FlowExporter',
     'EvolutionExporter',
     'READMEExporter',
+    'ProjectYAMLExporter',
+    'ToonViewGenerator',
+    'ContextViewGenerator',
+    'ArticleViewGenerator',
+    'HTMLDashboardGenerator',
+    'load_project_yaml',
 ]