code2llm 0.5.54__tar.gz → 0.5.56__tar.gz

{code2llm-0.5.54 → code2llm-0.5.56}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.54
+Version: 0.5.56
 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,8 +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 | 66 critical functions, 0 god modules |
-| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -145,8 +144,8 @@ cat evolution.toon
 grep "NEXT" evolution.toon
 ```
 
-### `flow.toon` - Data Flow Analysis
-**Purpose**: Understand data movement through the system
+### `flow.toon` - Legacy Data Flow Analysis
+**Purpose**: Understand data movement through the system (legacy / explicit opt-in)
 **Key sections**:
 - **PIPELINES**: Data processing chains
 - **CONTRACTS**: Function input/output contracts
@@ -161,12 +160,13 @@ grep "PIPELINES" flow.toon
 grep "SIDE_EFFECTS" flow.toon
 ```
 
-### `map.toon` - Structural Map
-**Purpose**: High-level architecture overview
+### `map.toon` - Structural Map + Project Header
+**Purpose**: High-level architecture overview plus compact project header
 **Key sections**:
 - **MODULES**: All modules with basic stats
 - **IMPORTS**: Dependency relationships
-- **SIGNATURES**: Public API functions
+- **EXPORTS**: Public API surface and signatures
+- **HEADER**: Stats, alerts, hotspots, evolution trend
 
 **Example usage**:
 ```bash
@@ -177,14 +177,9 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
-### `project.toon` - Project Logic (Code2Logic)
+### `project.toon` - Legacy Project Logic (Deprecated)
 **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
+**Status**: Deprecated — the lightweight project overview is now merged into `map.toon` header
 
 **Example usage**:
 ```bash
@@ -374,10 +369,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-09  
-**Total Functions**: 861  
-**Total Classes**: 104  
-**Modules**: 105  
+**Analysis Date**: 2026-03-25  
+**Total Functions**: 891  
+**Total Classes**: 106  
+**Modules**: 121  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.54 → code2llm-0.5.56}/README.md

@@ -10,8 +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 | 66 critical functions, 0 god modules |
-| `project.toon` | **TOON** | **🧠 Project logic** - Compact module view from code2logic | Generated via code2logic integration |
+| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -95,8 +94,8 @@ cat evolution.toon
 grep "NEXT" evolution.toon
 ```
 
-### `flow.toon` - Data Flow Analysis
-**Purpose**: Understand data movement through the system
+### `flow.toon` - Legacy Data Flow Analysis
+**Purpose**: Understand data movement through the system (legacy / explicit opt-in)
 **Key sections**:
 - **PIPELINES**: Data processing chains
 - **CONTRACTS**: Function input/output contracts
@@ -111,12 +110,13 @@ grep "PIPELINES" flow.toon
 grep "SIDE_EFFECTS" flow.toon
 ```
 
-### `map.toon` - Structural Map
-**Purpose**: High-level architecture overview
+### `map.toon` - Structural Map + Project Header
+**Purpose**: High-level architecture overview plus compact project header
 **Key sections**:
 - **MODULES**: All modules with basic stats
 - **IMPORTS**: Dependency relationships
-- **SIGNATURES**: Public API functions
+- **EXPORTS**: Public API surface and signatures
+- **HEADER**: Stats, alerts, hotspots, evolution trend
 
 **Example usage**:
 ```bash
@@ -127,14 +127,9 @@ cat map.toon | head -50
 grep "SIGNATURES" map.toon
 ```
 
-### `project.toon` - Project Logic (Code2Logic)
+### `project.toon` - Legacy Project Logic (Deprecated)
 **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
+**Status**: Deprecated — the lightweight project overview is now merged into `map.toon` header
 
 **Example usage**:
 ```bash
@@ -324,10 +319,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-09  
-**Total Functions**: 861  
-**Total Classes**: 104  
-**Modules**: 105  
+**Analysis Date**: 2026-03-25  
+**Total Functions**: 891  
+**Total Classes**: 106  
+**Modules**: 121  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

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

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/cli_commands.py

@@ -24,7 +24,7 @@ def handle_report_command(args_list) -> int:
     """Generate views from an existing project.yaml.
 
     Usage:
-        code2llm report --format toon    # → project.toon
+        code2llm report --format toon    # → project.toon (legacy)
         code2llm report --format context # → context.md
         code2llm report --format article # → status.md
         code2llm report --format html    # → dashboard.html

{code2llm-0.5.54 → code2llm-0.5.56}/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', 'flow', 'context', 'code2logic', 'yaml', 'json', 'mermaid', 'evolution', 'project-yaml']
+        formats = ['toon', 'map', 'context', 'yaml', 'json', 'mermaid', 'evolution']
 
     is_chunked = args.chunk if hasattr(args, 'chunk') else False
 

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/cli_exports/prompt.py

@@ -78,9 +78,9 @@ 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'),
+    ('map.toon', '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', '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'),
 ]
 
@@ -121,7 +121,7 @@ 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 name != 'project.toon' and not (output_dir / name).exists()]
+    return [name for name, _ in _MAIN_FILES if not (output_dir / name).exists()]
 
 
 def _build_subprojects_section(subprojects: list, output_dir: Path, output_rel_path: str) -> List[str]:
@@ -169,9 +169,9 @@ 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_map_toon': (output_dir / 'map.toon').exists(),
         'has_context_md': (output_dir / 'context.md').exists(),
         'has_evolution_toon': (output_dir / 'evolution.toon').exists(),
-        'has_project_toon': (output_dir / 'project.toon').exists(),
         'has_readme': (output_dir / 'README.md').exists(),
         'has_yaml': (output_dir / 'analysis.yaml').exists(),
         'has_json': (output_dir / 'analysis.json').exists(),
@@ -194,15 +194,15 @@ def _build_dynamic_focus_areas(file_analysis: dict) -> List[str]:
     
     if file_analysis['has_analysis_toon']:
         focus_areas.append("1. **Code Health Analysis** - Review complexity metrics, god modules, coupling issues from analysis.toon")
+
+    if file_analysis['has_map_toon']:
+        focus_areas.append("2. **Structural Map** - Use map.toon to inspect imports, exports, signatures, and the project header")
     
     if file_analysis['has_evolution_toon']:
-        focus_areas.append("2. **Refactoring Priorities** - Examine ranked refactoring actions and risk assessment from evolution.toon")
+        focus_areas.append("3. **Refactoring Priorities** - Examine ranked refactoring actions and risk assessment from evolution.toon")
     
     if file_analysis['has_context_md']:
-        focus_areas.append("3. **Architecture Overview** - Understand main flows, entry points, and public API from context.md")
-    
-    if file_analysis['has_project_toon']:
-        focus_areas.append("4. **Project Structure** - Analyze module organization and dependencies from project.toon")
+        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")
@@ -222,20 +222,23 @@ def _build_dynamic_focus_areas(file_analysis: dict) -> List[str]:
 def _build_dynamic_tasks(file_analysis: dict) -> List[str]:
     """Build tasks based on available files."""
     tasks = [
-        "- Summarize the architecture and main flows.",
+        "- Summarize the architecture, main flows, and structural dependencies.",
         "- Identify the highest-risk areas and propose a refactoring plan.",
         "- If you suggest changes, keep behavior backward compatible and provide concrete steps.",
     ]
     
     if file_analysis['has_analysis_toon']:
-        tasks.append("- Highlight critical functions (CC ≥ 10) and god modules from analysis.toon.")
+        tasks.append("- Highlight critical functions (CC ≥ 10) and top problem areas from analysis.toon.")
+
+    if file_analysis['has_map_toon']:
+        tasks.append("- Cross-check imports, exports, and signatures against map.toon before proposing splits.")
     
     if file_analysis['has_evolution_toon']:
         tasks.append("- Prioritize refactoring actions by impact/effort ratio from evolution.toon.")
     
     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.")
     
@@ -267,12 +270,12 @@ def _build_prompt_footer(chunked: bool = False, file_analysis: dict = None) -> L
     if file_analysis['file_count'] > 0:
         lines.append("")
         lines.append("Analysis Strategy:")
-        if file_analysis['has_analysis_toon'] and file_analysis['has_evolution_toon']:
-            lines.append("- Start with analysis.toon for health metrics, then evolution.toon for action priorities")
+        if file_analysis['has_analysis_toon'] and file_analysis['has_map_toon']:
+            lines.append("- Start with analysis.toon for health metrics, then map.toon for structure and signatures")
+            if file_analysis['has_evolution_toon']:
+                lines.append("- Finish with evolution.toon for action priorities and next steps")
         elif file_analysis['has_context_md']:
             lines.append("- Use context.md as the primary reference for architectural understanding")
-        elif file_analysis['has_project_toon']:
-            lines.append("- Begin with project.toon for structural overview")
         
         if file_analysis['has_yaml']:
             lines.append("- Reference analysis.yaml for precise metrics and programmatic data")

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/cli_parser.py

@@ -15,7 +15,7 @@ def create_parser() -> argparse.ArgumentParser:
 Examples:
   code2llm ./                                       # Default: TOON diagnostics + README
   code2llm ./ -f all -o ./docs                      # All formats to ./docs/
-  code2llm ./ -f toon,map,flow                      # Diagnostics + structure + data-flow
+  code2llm ./ -f toon,map,evolution                 # Consolidated diagnostics + structure + roadmap
   code2llm ./ -f context                            # LLM narrative (context.md)
   code2llm ./ --streaming --strategy deep -f all    # Deep streaming analysis, all outputs
   code2llm ./ --strategy quick -f toon              # Fast overview
@@ -34,16 +34,16 @@ Examples:
 
 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
+  map          — Structural map (map.toon) — modules, imports, exports, signatures, project header
+  evolution    — Refactoring queue (evolution.toon)
   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)
+  flow         — Data-flow analysis (flow.toon) — legacy, explicit opt-in
+  code2logic   — Generate project logic (legacy project.toon) via external code2logic
   project-yaml — Unified project.yaml (single source of truth) + generated views
-  all          — Generate all formats (including project-yaml)
+  all          — Generate core formats (analysis.toon, map.toon, evolution.toon, context, yaml, json, mermaid)
 
 Strategy Options (--strategy):
   quick     — Fast overview, fewer files analyzed

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/core/gitignore.py

@@ -120,6 +120,20 @@ class GitIgnoreParser:
 
 
 def load_gitignore_patterns(project_path: Path) -> GitIgnoreParser:
-    """Load gitignore patterns from project directory."""
-    gitignore_path = project_path / '.gitignore'
+    """Load gitignore patterns from project directory.
+    
+    Searches up the directory tree from project_path until it finds a .gitignore file
+    or reaches the filesystem root. This ensures that gitignore rules are properly applied
+    even when analyzing subdirectories of a larger project.
+    """
+    current_path = project_path.resolve()
+    
+    while current_path != current_path.parent:  # Stop at filesystem root
+        gitignore_path = current_path / '.gitignore'
+        if gitignore_path.exists():
+            return GitIgnoreParser(gitignore_path)
+        current_path = current_path.parent
+    
+    # Check filesystem root as last resort
+    gitignore_path = current_path / '.gitignore'
     return GitIgnoreParser(gitignore_path)

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/exporters/__init__.py

@@ -2,7 +2,7 @@
 
 Available exporters:
   - ToonExporter      → analysis.toon  (health diagnostics)
-  - MapExporter       → project.map    (structural map)
+  - MapExporter       → map.toon       (structural map + project header)
   - FlowExporter      → flow.toon      (data-flow: pipelines, contracts, types)
   - EvolutionExporter  → evolution.toon (ranked refactoring queue)
   - ContextExporter   → context.md     (LLM narrative)

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/exporters/index_generator.py

@@ -84,6 +84,9 @@ class IndexHTMLGenerator:
                     # Limit size
                     if len(content) > 100000:
                         content = content[:100000] + '\n\n... [truncated - file too large]'
+                    # Don't escape markdown - it will be rendered as HTML
+                    if file_type == 'markdown':
+                        return content
                     return self._escape_html(content)
             return '[Binary file]'
         except Exception as e:
@@ -116,6 +119,7 @@ class IndexHTMLGenerator:
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>code2llm Analysis Results</title>
+    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
     <style>
         :root {{
             --bg: #0f172a;
@@ -418,6 +422,101 @@ class IndexHTMLGenerator:
             word-break: break-word;
         }}
         
+        /* Markdown rendered content styles */
+        .markdown-content {{
+            line-height: 1.6;
+            max-width: 100%;
+        }}
+        
+        .markdown-content h1, .markdown-content h2, .markdown-content h3,
+        .markdown-content h4, .markdown-content h5, .markdown-content h6 {{
+            margin-top: 1.5rem;
+            margin-bottom: 0.75rem;
+            font-weight: 600;
+            line-height: 1.3;
+        }}
+        
+        .markdown-content h1 {{ font-size: 1.75rem; border-bottom: 2px solid var(--border); padding-bottom: 0.5rem; }}
+        .markdown-content h2 {{ font-size: 1.5rem; border-bottom: 1px solid var(--border); padding-bottom: 0.4rem; }}
+        .markdown-content h3 {{ font-size: 1.25rem; }}
+        .markdown-content h4 {{ font-size: 1.1rem; }}
+        
+        .markdown-content p {{
+            margin-bottom: 1rem;
+        }}
+        
+        .markdown-content ul, .markdown-content ol {{
+            margin-bottom: 1rem;
+            padding-left: 1.5rem;
+        }}
+        
+        .markdown-content li {{
+            margin-bottom: 0.25rem;
+        }}
+        
+        .markdown-content code {{
+            background: var(--surface);
+            padding: 0.2rem 0.4rem;
+            border-radius: 0.25rem;
+            font-family: 'Menlo', 'Monaco', 'Courier New', monospace;
+            font-size: 0.875em;
+        }}
+        
+        .markdown-content pre code {{
+            background: none;
+            padding: 0;
+        }}
+        
+        .markdown-content blockquote {{
+            border-left: 4px solid var(--accent);
+            padding-left: 1rem;
+            margin-left: 0;
+            margin-bottom: 1rem;
+            color: var(--text-muted);
+        }}
+        
+        .markdown-content table {{
+            border-collapse: collapse;
+            width: 100%;
+            margin-bottom: 1rem;
+        }}
+        
+        .markdown-content th, .markdown-content td {{
+            border: 1px solid var(--border);
+            padding: 0.5rem 0.75rem;
+            text-align: left;
+        }}
+        
+        .markdown-content th {{
+            background: var(--surface);
+            font-weight: 600;
+        }}
+        
+        .markdown-content tr:nth-child(even) {{
+            background: var(--surface-hover);
+        }}
+        
+        .markdown-content a {{
+            color: var(--accent);
+            text-decoration: none;
+        }}
+        
+        .markdown-content a:hover {{
+            text-decoration: underline;
+        }}
+        
+        .markdown-content img {{
+            max-width: 100%;
+            height: auto;
+            border-radius: 0.5rem;
+        }}
+        
+        .markdown-content hr {{
+            border: none;
+            border-top: 1px solid var(--border);
+            margin: 1.5rem 0;
+        }}
+        
         /* Mobile responsive */
         @media (max-width: 768px) {{
             .container {{
@@ -568,9 +667,12 @@ class IndexHTMLGenerator:
             
             // Content
             const body = document.getElementById('contentBody');
-            if (file.type === 'markdown' || file.type === 'html') {{
-                // For markdown, show formatted but also offer raw view
-                body.innerHTML = `<pre>${{file.content}}</pre>`;
+            if (file.type === 'markdown') {{
+                // Render markdown as HTML using marked.js
+                body.innerHTML = `<div class="markdown-content">${{marked.parse(file.content)}}</div>`;
+            }} else if (file.type === 'html') {{
+                // For HTML files, show in iframe for safety
+                body.innerHTML = `<iframe src="${{file.rel_path}}" style="width:100%;height:100%;border:none;border-radius:0.5rem;"></iframe>`;
             }} else if (file.type === 'json') {{
                 try {{
                     const json = JSON.parse(file.content.replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&'));

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/exporters/map_exporter.py

@@ -1,14 +1,16 @@
 """Map Exporter — generates map.toon (structural map).
 
-Produces a compact key:value format showing modules, imports, signatures,
-and type information. Formerly the project.toon format.
+Produces a compact project header plus a key:value structural map showing
+modules, imports, exports, and signatures.
 
 Purpose: "what exists and how it's connected"
-Format: M[] module list, D: details with i: imports, e: exports, signatures
+Format: header summary + M[] module list, D: details with i: imports,
+e: exports, signatures
 """
 
 from collections import defaultdict
 from datetime import datetime
+import re
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Set, Tuple
 
@@ -25,15 +27,16 @@ EXCLUDE_PATTERNS = {
 
 
 class MapExporter(Exporter):
-    """Export to map.toon — structural map with modules, imports, signatures.
+    """Export to map.toon — structural map with a compact project header.
 
-    Keys: M=modules, D=details, i=imports, c=classes, f=functions, m=methods
+    Keys: M=modules, D=details, i=imports, e=exports, c=classes, f=functions,
+    m=methods
     """
 
     def export(self, result: AnalysisResult, output_path: str, **kwargs) -> None:
         """Export analysis result to .map format."""
         lines: List[str] = []
-        lines.extend(self._render_header(result))
+        lines.extend(self._render_header(result, output_path))
         lines.extend(self._render_module_list(result))
         lines.extend(self._render_details(result))
 
@@ -44,16 +47,32 @@ class MapExporter(Exporter):
     # ------------------------------------------------------------------
     # header
     # ------------------------------------------------------------------
-    def _render_header(self, result: AnalysisResult) -> List[str]:
-        nfiles = len(result.modules)
+    def _render_header(self, result: AnalysisResult, output_path: str) -> List[str]:
+        project_name = Path(result.project_path).name if result.project_path else "project"
         total_lines = self._count_total_lines(result)
         langs = self._detect_languages(result)
-        lang_str = ",".join(f"{lang}:{count}" for lang, count in langs.items())
+        lang_str = ",".join(f"{lang}:{count}" for lang, count in langs.items()) or "unknown"
+
+        included_files = [mi for mi in result.modules.values() if not self._is_excluded(mi.file)]
+        included_funcs = [fi for fi in result.functions.values() if not self._is_excluded(fi.file)]
+        included_classes = [ci for ci in result.classes.values() if not self._is_excluded(ci.file)]
+
+        cc_scores = [fi.complexity.get("cyclomatic_complexity", 0) for fi in included_funcs]
+        avg_cc = round(sum(cc_scores) / len(cc_scores), 1) if cc_scores else 0.0
+        critical_count = len([cc for cc in cc_scores if cc >= 15])
+        cycles = len(result.metrics.get("project", {}).get("circular_dependencies", []))
+
+        alerts = self._build_alerts(included_funcs)
+        hotspots = self._build_hotspots(included_funcs)
+        trend = self._load_evolution_trend(Path(output_path).with_name("evolution.toon"), avg_cc)
 
         lines = [
-            f"# {Path(result.project_path).name if result.project_path else 'project'}"
-            f" | {nfiles}f {total_lines}L | {lang_str}",
-            "# Keys: M=modules, D=details, i=imports, c=classes, f=functions, m=methods",
+            f"# {project_name} | {len(included_files)}f {total_lines}L | {lang_str} | {datetime.now().strftime('%Y-%m-%d')}",
+            f"# stats: {len(included_funcs)} func | {len(included_classes)} cls | {len(included_files)} mod | CC̄={avg_cc} | critical:{critical_count} | cycles:{cycles}",
+            f"# alerts[{len(alerts)}]: {'; '.join(alerts) if alerts else 'none'}",
+            f"# hotspots[{len(hotspots)}]: {'; '.join(hotspots) if hotspots else 'none'}",
+            f"# evolution: {trend}",
+            "# Keys: M=modules, D=details, i=imports, e=exports, c=classes, f=functions, m=methods",
         ]
         return lines
 
@@ -235,3 +254,73 @@ class MapExporter(Exporter):
                 if ext:
                     langs[ext.lstrip('.')] += 1
         return dict(langs)
+
+    @staticmethod
+    def _build_alerts(funcs: List[FunctionInfo]) -> List[str]:
+        """Build a compact list of top alerts for the header."""
+        alerts: List[Tuple[int, int, str]] = []
+        for fi in funcs:
+            display = fi.name if not fi.class_name else f"{fi.class_name}.{fi.name}"
+            cc = fi.complexity.get("cyclomatic_complexity", 0)
+            if cc >= 15:
+                severity = 0 if cc >= 25 else 1
+                alerts.append((severity, cc, f"CC {display}={cc}"))
+
+            fan_out = len(set(fi.calls))
+            if fan_out >= 10:
+                severity = 0 if fan_out >= 20 else 1
+                alerts.append((severity, fan_out, f"fan-out {display}={fan_out}"))
+
+        alerts.sort(key=lambda item: (item[0], -item[1], item[2]))
+        return [label for _, _, label in alerts[:5]]
+
+    @staticmethod
+    def _build_hotspots(funcs: List[FunctionInfo]) -> List[str]:
+        """Build a compact list of top fan-out hotspots for the header."""
+        spots: List[Tuple[int, str]] = []
+        for fi in funcs:
+            fan_out = len(set(fi.calls))
+            if fan_out >= 5:
+                display = fi.name if not fi.class_name else f"{fi.class_name}.{fi.name}"
+                spots.append((fan_out, f"{display} fan={fan_out}"))
+
+        spots.sort(key=lambda item: item[0], reverse=True)
+        return [label for _, label in spots[:5]]
+
+    @staticmethod
+    def _load_evolution_trend(evolution_path: Path, current_cc: float) -> str:
+        """Summarize the latest CC trend from the previous evolution.toon file."""
+        previous_cc = MapExporter._read_previous_cc_avg(evolution_path)
+        if previous_cc is None:
+            return "baseline"
+
+        delta = round(current_cc - previous_cc, 1)
+        if delta < 0:
+            direction = "improved"
+        elif delta > 0:
+            direction = "regressed"
+        else:
+            direction = "flat"
+
+        sign = "+" if delta > 0 else ""
+        return f"CC̄ {previous_cc:.1f}→{current_cc:.1f} ({direction} {sign}{delta:.1f})"
+
+    @staticmethod
+    def _read_previous_cc_avg(evolution_path: Path) -> Optional[float]:
+        """Read the previous CC average from an existing evolution.toon file."""
+        if not evolution_path.exists():
+            return None
+
+        try:
+            content = evolution_path.read_text(encoding="utf-8")
+        except Exception:
+            return None
+
+        for line in content.splitlines():
+            match = re.search(r"CC̄:\s*([0-9]+(?:\.[0-9]+)?)\s*→", line)
+            if match:
+                try:
+                    return float(match.group(1))
+                except ValueError:
+                    return None
+        return None

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/exporters/mermaid_exporter.py

@@ -212,7 +212,9 @@ class MermaidExporter(Exporter):
         safe = safe.replace(' ', '_')
         if len(safe) > 50:
             # Keep module prefix + function name
-            parts = name.split('.')
+            # Use sanitized parts (replace dashes first)
+            sanitized = name.replace('-', '_').replace(':', '_')
+            parts = sanitized.split('.')
             if len(parts) >= 2:
                 safe = f"{parts[0]}__{parts[-1]}"
             safe = safe[:50]

{code2llm-0.5.54 → code2llm-0.5.56}/code2llm/exporters/project_yaml_exporter.py

@@ -35,7 +35,7 @@ GOD_MODULE_LINES = 500
 class ProjectYAMLExporter(Exporter):
     """Export unified project.yaml — single source of truth for diagnostics.
 
-    Combines data from analysis.toon, project.toon, context.md, and evolution.toon
+    Combines data from analysis.toon, map.toon, context.md, and evolution.toon
     into one machine-parseable YAML file.
     """