code2llm 0.5.113__tar.gz → 0.5.115__tar.gz

{code2llm-0.5.113 → code2llm-0.5.115}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.113
+Version: 0.5.115
 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
@@ -67,13 +67,13 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.113-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-55.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.115-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (162 commits)
-- 👤 **Human dev:** ~$5505 (55.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (166 commits)
+- 👤 **Human dev:** ~$5731 (57.3h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
@@ -89,7 +89,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
+| `evolution.toon.yaml` | **YAML** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -97,6 +97,11 @@ When you run `code2llm ./ -f all`, the following files are created:
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
 
+### 📊 Visualizations
+
+| File | Format | Purpose | Description |
+|------|--------|---------|-------------|
+| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
 
 ## 🚀 Quick Start Commands
 
@@ -401,10 +406,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-04-18  
-**Total Functions**: 1041  
-**Total Classes**: 111  
-**Modules**: 135  
+**Analysis Date**: 2026-04-19  
+**Total Functions**: 1115  
+**Total Classes**: 121  
+**Modules**: 152  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

{code2llm-0.5.113 → code2llm-0.5.115}/README.md

@@ -3,13 +3,13 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.113-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-55.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.115-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (162 commits)
-- 👤 **Human dev:** ~$5505 (55.0h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (166 commits)
+- 👤 **Human dev:** ~$5731 (57.3h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
@@ -25,7 +25,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 
 | File | Format | Purpose | Key Insights |
 |------|--------|---------|--------------|
-| `analysis.toon` | **TOON** | **🔥 Health diagnostics** - Health, LAYERS, COUPLING | 69 critical functions, 0 god modules |
+| `evolution.toon.yaml` | **YAML** | **📋 Refactoring queue** - Prioritized improvements | 0 refactoring actions needed |
 
 ### 🤖 LLM-Ready Documentation
 
@@ -33,6 +33,11 @@ When you run `code2llm ./ -f all`, the following files are created:
 |------|--------|---------|----------|
 | `context.md` | **Markdown** | **📖 LLM narrative** - Architecture summary | Paste into ChatGPT/Claude for code analysis |
 
+### 📊 Visualizations
+
+| File | Format | Purpose | Description |
+|------|--------|---------|-------------|
+| `calls.mmd` | **Mermaid** | **📞 Call graph** | Function dependencies (edges only) |
 
 ## 🚀 Quick Start Commands
 
@@ -337,10 +342,10 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-04-18  
-**Total Functions**: 1041  
-**Total Classes**: 111  
-**Modules**: 135  
+**Analysis Date**: 2026-04-19  
+**Total Functions**: 1115  
+**Total Classes**: 121  
+**Modules**: 152  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm
 

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

{code2llm-0.5.113 → code2llm-0.5.115}/code2llm/analysis/utils/__init__.py

@@ -1,5 +1,5 @@
 """Shared AST utilities for analysis modules."""
 
-from .ast_helpers import get_ast, find_function_node, expr_to_str
+from .ast_helpers import get_ast, find_function_node, expr_to_str, ast_unparse
 
-__all__ = ["get_ast", "find_function_node", "expr_to_str"]
+__all__ = ["get_ast", "find_function_node", "expr_to_str", "ast_unparse"]

{code2llm-0.5.113 → code2llm-0.5.115}/code2llm/analysis/utils/ast_helpers.py

@@ -38,6 +38,25 @@ def find_function_node(
     return None
 
 
+def ast_unparse(node: Optional[ast.AST], default_none: str = "None") -> str:
+    """Convert an AST node to its source string via ast.unparse (Python 3.9+).
+
+    Used as a shared replacement for the duplicated *_expr_to_str* methods
+    in ``cfg.py``, ``dfg.py``, and ``call_graph.py``.
+
+    Args:
+        node: AST node to convert, or None.
+        default_none: value returned when *node* is None (``"None"`` for most
+            callers; ``""`` for call_graph which uses empty-string sentinel).
+    """
+    if node is None:
+        return default_none
+    try:
+        return ast.unparse(node) if hasattr(ast, "unparse") else str(node)
+    except Exception:
+        return str(node)
+
+
 def expr_to_str(node: ast.expr) -> Optional[str]:
     """Convert an AST expression to a dotted string (for call-name extraction).
 

{code2llm-0.5.113 → code2llm-0.5.115}/code2llm/cli_analysis.py

@@ -73,7 +73,7 @@ def _build_config(args, output_dir: Path):
     if hasattr(args, 'no_gitignore') and args.no_gitignore:
         filter_config.gitignore_enabled = False
     
-    return Config(
+    config = Config(
         mode=args.mode,
         max_depth_enumeration=args.max_depth,
         detect_state_machines=not args.no_patterns,
@@ -81,6 +81,10 @@ def _build_config(args, output_dir: Path):
         output_dir=str(output_dir),
         filters=filter_config
     )
+    # Persistent cache flags (read via getattr with defaults in analyzer.py)
+    no_cache = getattr(args, 'no_cache', False) or getattr(args, 'force', False)
+    config.no_cache = no_cache
+    return config
 
 
 def _print_analysis_summary(result) -> None:

{code2llm-0.5.113 → code2llm-0.5.115}/code2llm/cli_commands.py

@@ -9,7 +9,7 @@ from .cli_exports import _run_report
 
 
 def handle_special_commands() -> Optional[int]:
-    """Handle special sub-commands (llm-flow, llm-context, report)."""
+    """Handle special sub-commands (llm-flow, llm-context, report, cache)."""
     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:])
@@ -17,9 +17,75 @@ def handle_special_commands() -> Optional[int]:
         return generate_llm_context(sys.argv[2:])
     if len(sys.argv) > 1 and sys.argv[1] == 'report':
         return handle_report_command(sys.argv[2:])
+    if len(sys.argv) > 1 and sys.argv[1] == 'cache':
+        return handle_cache_command(sys.argv[2:])
     return None
 
 
+def handle_cache_command(args_list) -> int:
+    """Manage persistent cache (~/.code2llm/).
+
+    Usage:
+        code2llm cache status          # show size, projects, last used
+        code2llm cache clear           # clear cache for current directory
+        code2llm cache clear --all     # clear entire ~/.code2llm/
+        code2llm cache gc              # manual garbage collection
+    """
+    import os
+    import time
+    from .core.persistent_cache import PersistentCache, get_all_projects, clear_all, _DEFAULT_ROOT
+
+    parser = argparse.ArgumentParser(prog='code2llm cache')
+    parser.add_argument('action', choices=['status', 'clear', 'gc'], help='Cache action')
+    parser.add_argument('--all', action='store_true', dest='all_projects',
+                        help='Apply to all cached projects (clear only)')
+    parser.add_argument('--max-age', type=int, default=30, metavar='DAYS',
+                        help='Max age in days for gc (default: 30)')
+    args = parser.parse_args(args_list)
+
+    if args.action == 'status':
+        projects = get_all_projects()
+        root = _DEFAULT_ROOT
+        total_mb = sum(p.get('cache_size_bytes', 0) for p in projects) / (1024 * 1024)
+        print(f"Cache: {root}")
+        print(f"  Projects: {len(projects)}   Total: {total_mb:.1f} MB")
+        for p in projects:
+            size_mb = p.get('cache_size_bytes', 0) / (1024 * 1024)
+            updated = p.get('updated_at', 0)
+            age_min = int((time.time() - updated) / 60) if updated else 0
+            age_str = f"{age_min}m ago" if age_min < 120 else f"{age_min//60}h ago"
+            exports = p.get('exports', 0)
+            files = p.get('files_cached', 0)
+            print(f"\n  {p.get('project', '?')}")
+            print(f"    Files: {files}   Exports: {exports}   Size: {size_mb:.1f} MB   Last: {age_str}")
+        return 0
+
+    if args.action == 'clear':
+        if args.all_projects:
+            clear_all()
+            print("Cleared entire cache.")
+        else:
+            project_dir = os.path.realpath('.')
+            c = PersistentCache(project_dir)
+            c.clear()
+            print(f"Cleared cache for {project_dir}")
+        return 0
+
+    if args.action == 'gc':
+        projects = get_all_projects()
+        total_removed = 0
+        for p in projects:
+            project_dir = p.get('project')
+            if project_dir and Path(project_dir).exists():
+                c = PersistentCache(project_dir)
+                removed = c.gc(max_age_days=args.max_age)
+                total_removed += removed
+        print(f"GC complete: {total_removed} stale entries removed.")
+        return 0
+
+    return 0
+
+
 def handle_report_command(args_list) -> int:
     """Generate views from an existing project.yaml (legacy).
 

{code2llm-0.5.113 → code2llm-0.5.115}/code2llm/cli_exports/formats.py

@@ -216,10 +216,24 @@ def _export_mermaid_pngs(args, output_dir: Path) -> None:
 
 
 def _export_calls(args, result, output_dir: Path):
-    """Export standalone calls.toon.yaml (call graph in toon format).
-    
-    Generates calls.toon.yaml in human-readable toon format with hubs, modules,
-    and edges sections — useful for programmatic analysis of call graphs.
+    """Export standalone calls.yaml (structured call graph YAML).
+
+    Generates calls.yaml with structured call graph data:
+    - nodes: functions with metadata (CC, calls_in/out)
+    - edges: caller -> callee relationships
+    - modules: grouping by module
+    - stats: summary statistics
+    """
+    yaml_exporter = YAMLExporter()
+    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+    if args.verbose:
+        print(f"  - CALLS (call graph YAML): {output_dir / 'calls.yaml'}")
+
+
+def _export_calls_toon(args, result, output_dir: Path):
+    """Export calls.toon.yaml (call graph in human-readable toon format).
+
+    Generates calls.toon.yaml with hubs, modules, and edges sections.
     """
     yaml_exporter = YAMLExporter()
     yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
@@ -247,8 +261,9 @@ def _export_mermaid(args, result, output_dir: Path):
     exporter.export_call_graph(result, str(output_dir / 'calls.mmd'))
     exporter.export_compact(result, str(output_dir / 'compact_flow.mmd'))
 
-    # Export calls.toon.yaml (structured call graph data in toon format)
+    # Export calls.yaml (structured call graph data) and calls.toon.yaml (human-readable)
     yaml_exporter = YAMLExporter()
+    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
     yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
 
     if args.verbose:
@@ -257,7 +272,7 @@ def _export_mermaid(args, result, output_dir: Path):
             files.append('flow_detailed.mmd')
         if getattr(args, 'flow_full', False):
             files.append('flow_full.mmd')
-        files.extend(['calls.mmd', 'compact_flow.mmd', 'calls.toon.yaml'])
+        files.extend(['calls.mmd', 'compact_flow.mmd', 'calls.yaml'])
         print(f"  - Mermaid: {output_dir}/*.mmd ({', '.join(files)})")
 
     _export_mermaid_pngs(args, output_dir)

code2llm-0.5.115/code2llm/cli_exports/orchestrator.py

@@ -0,0 +1,337 @@
+"""Export orchestration — registry-based dispatch for cleaner code.
+
+Refactored to use EXPORT_REGISTRY for core format dispatch.
+Maintains backward compatibility with all existing --format values.
+"""
+
+import sys
+from pathlib import Path
+from typing import Optional, List, Dict, Any
+
+from code2llm.exporters import (
+    get_exporter,
+    EXPORT_REGISTRY,
+    YAMLExporter,
+    MermaidExporter,
+    ToonViewGenerator,
+    IndexHTMLGenerator,
+)
+from code2llm.exporters.project_yaml.evolution import load_previous_evolution
+
+
+# Format output filenames
+FORMAT_FILENAMES: Dict[str, str] = {
+    'toon': 'analysis.toon.yaml',
+    'map': 'map.toon.yaml',
+    'flow': 'flow.toon.yaml',
+    'context': 'context.md',
+    'yaml': 'analysis.yaml',
+    'json': 'analysis.json',
+    'evolution': 'evolution.toon.yaml',
+    'readme': 'README.md',
+    'project-yaml': 'project.yaml',
+}
+
+# Human-readable labels
+FORMAT_LABELS: Dict[str, str] = {
+    'toon': 'TOON (diagnostics)',
+    'map': 'MAP (structure)',
+    'flow': 'FLOW (data-flow)',
+    'context': 'CONTEXT (LLM narrative)',
+    'yaml': 'YAML',
+    'json': 'JSON',
+    'evolution': 'EVOLUTION (refactoring queue)',
+    'readme': 'README (documentation)',
+    'project-yaml': 'PROJECT-YAML (single source of truth)',
+}
+
+
+def _run_exports(args, result, output_dir: Path, source_path: Optional[Path] = None):
+    """Export analysis results in requested formats.
+
+    Uses EXPORT_REGISTRY for core format dispatch.
+    For chunked analysis, exports to subproject subdirectories.
+    """
+    requested_formats = [f.strip() for f in args.format.split(',')]
+    formats = _expand_all_formats(requested_formats, getattr(args, 'png', False))
+    is_chunked = getattr(args, 'chunk', False)
+
+    try:
+        if is_chunked and source_path:
+            _export_chunked(args, result, output_dir, source_path, formats, requested_formats)
+        else:
+            _export_single(args, result, output_dir, formats, requested_formats, source_path)
+    except Exception as e:
+        print(f"Error during export: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def _expand_all_formats(requested: List[str], include_png: bool = False) -> List[str]:
+    """Expand 'all' to concrete format list."""
+    if 'all' not in requested:
+        return requested[:]
+    formats = ['toon', 'map', 'context', 'evolution']
+    if include_png:
+        formats.append('mermaid')
+    return formats
+
+
+def _export_single(
+    args, result, output_dir: Path,
+    formats: List[str], requested_formats: List[str],
+    source_path: Optional[Path] = None
+):
+    """Export single project results."""
+    # Core formats via registry
+    _export_registry_formats(args, result, output_dir, formats)
+
+    # Special/conditional formats
+    if 'mermaid' in formats:
+        _export_mermaid(args, result, output_dir)
+    if 'calls' in formats or 'calls_toon' in formats:
+        _export_calls(args, result, output_dir, formats)
+
+    # Evolution always exported for 'all' or 'evolution' (handled by registry)
+    # Context fallback only if not explicitly requested
+    if 'context' not in formats and 'all' not in requested_formats:
+        _export_context_fallback(args, result, output_dir)
+
+    # project.toon.yaml for 'all' mode
+    if 'all' in requested_formats:
+        _export_project_toon(args, result, output_dir)
+
+    # Optional exports
+    if source_path is not None:
+        from .code2logic import _export_code2logic
+        from .prompt import _export_prompt_txt
+        _export_code2logic(args, source_path, output_dir, formats)
+        _export_prompt_txt(args, output_dir, requested_formats, source_path)
+
+    if getattr(args, 'refactor', False):
+        from .formats import _export_refactor_prompts
+        _export_refactor_prompts(args, result, output_dir)
+
+    if getattr(args, 'data_structures', False):
+        _export_data_structures(args, result, output_dir)
+
+    # Always export README and index
+    _export_readme(args, result, output_dir)
+    _export_index_html(args, output_dir)
+
+
+def _export_registry_formats(args, result, output_dir: Path, formats: List[str]):
+    """Export core formats via EXPORT_REGISTRY lookup."""
+    for fmt in formats:
+        exporter_cls = get_exporter(fmt)
+        if exporter_cls is None:
+            continue
+
+        filename = FORMAT_FILENAMES.get(fmt, f'{fmt}.export')
+        label = FORMAT_LABELS.get(fmt, fmt.upper())
+        filepath = output_dir / filename
+
+        exporter = exporter_cls()
+        kwargs = _get_format_kwargs(fmt, args)
+
+        try:
+            exporter.export(result, str(filepath), **kwargs)
+            if args.verbose:
+                print(f"  - {label}: {filepath}")
+        except Exception as e:
+            if args.verbose:
+                print(f"  - {label} export failed: {e}", file=sys.stderr)
+
+
+def _get_format_kwargs(fmt: str, args) -> Dict[str, Any]:
+    """Get format-specific kwargs for export."""
+    kwargs: Dict[str, Any] = {}
+    if fmt in ('yaml', 'json'):
+        kwargs['compact'] = not args.full
+        kwargs['include_defaults'] = args.full
+    return kwargs
+
+
+def _export_mermaid(args, result, output_dir: Path):
+    """Export mermaid diagrams."""
+    exporter = MermaidExporter()
+    include_examples = getattr(args, 'flow_include_examples', False)
+
+    # Core diagrams
+    exporter.export_flow_compact(result, str(output_dir / 'flow.mmd'), include_examples)
+    exporter.export_call_graph(result, str(output_dir / 'calls.mmd'))
+    exporter.export_compact(result, str(output_dir / 'compact_flow.mmd'))
+
+    # Optional detailed diagrams
+    if getattr(args, 'flow_detail', False):
+        exporter.export_flow_detailed(result, str(output_dir / 'flow_detailed.mmd'), include_examples)
+    if getattr(args, 'flow_full', False):
+        exporter.export_flow_full(result, str(output_dir / 'flow_full.mmd'), include_examples)
+
+    # Also export calls.yaml/toon
+    yaml_exporter = YAMLExporter()
+    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+    yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
+
+    if args.verbose:
+        files = ['flow.mmd', 'calls.mmd', 'compact_flow.mmd', 'calls.yaml']
+        if getattr(args, 'flow_detail', False):
+            files.append('flow_detailed.mmd')
+        if getattr(args, 'flow_full', False):
+            files.append('flow_full.mmd')
+        print(f"  - Mermaid: {output_dir}/*.mmd ({', '.join(files)})")
+
+    # PNG generation
+    _export_mermaid_pngs(args, output_dir)
+
+
+def _export_mermaid_pngs(args, output_dir: Path):
+    """Generate PNGs from mermaid files."""
+    if getattr(args, 'no_png', False):
+        return
+    try:
+        from ..generators.mermaid import generate_pngs
+        png_count = generate_pngs(output_dir, output_dir)
+        if args.verbose and png_count > 0:
+            print(f"  - PNG: {png_count} files generated")
+    except ImportError:
+        if args.verbose:
+            print(f"  - PNG: Skipped (install with: make install-mermaid)")
+
+
+def _export_calls(args, result, output_dir: Path, formats: List[str]):
+    """Export calls.yaml and calls.toon.yaml."""
+    yaml_exporter = YAMLExporter()
+    if 'calls' in formats:
+        yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (call graph YAML): {output_dir / 'calls.yaml'}")
+    if 'calls_toon' in formats:
+        yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (toon format): {output_dir / 'calls.toon.yaml'}")
+
+
+def _export_context_fallback(args, result, output_dir: Path):
+    """Export context.md as fallback."""
+    exporter_cls = get_exporter('context')
+    if exporter_cls:
+        exporter = exporter_cls()
+        exporter.export(result, str(output_dir / 'context.md'))
+        if args.verbose:
+            print(f"  - CONTEXT (LLM narrative): {output_dir / 'context.md'}")
+
+
+def _export_data_structures(args, result, output_dir: Path):
+    """Export data_structures.yaml."""
+    yaml_exporter = YAMLExporter()
+    yaml_exporter.export_data_structures(result, str(output_dir / 'data_structures.yaml'), compact=True)
+    if args.verbose:
+        print(f"  - Data structures: {output_dir / 'data_structures.yaml'}")
+
+
+def _export_project_toon(args, result, output_dir: Path):
+    """Export project.toon.yaml from project.yaml data."""
+    from ..exporters.project_yaml_exporter import ProjectYAMLExporter
+
+    project_yaml_exporter = ProjectYAMLExporter()
+    prev_evolution = load_previous_evolution(output_dir / 'project.yaml')
+    data = project_yaml_exporter._build_project_yaml(result, prev_evolution)
+
+    generator = ToonViewGenerator()
+    generator.generate(data, str(output_dir / 'project.toon.yaml'))
+
+    if args.verbose:
+        print(f"  - PROJECT-TOON (project overview): {output_dir / 'project.toon.yaml'}")
+
+
+def _export_readme(args, result, output_dir: Path):
+    """Export README.md."""
+    if getattr(args, 'no_readme', False):
+        return
+    exporter_cls = get_exporter('readme')
+    if exporter_cls:
+        exporter = exporter_cls()
+        exporter.export(result, str(output_dir / 'README.md'))
+        if args.verbose:
+            print(f"  - README (documentation): {output_dir / 'README.md'}")
+
+
+def _export_index_html(args, output_dir: Path):
+    """Generate index.html for browsing files."""
+    if 'all' not in getattr(args, 'format', ''):
+        return
+    try:
+        generator = IndexHTMLGenerator(output_dir)
+        index_path = generator.generate()
+        if args.verbose:
+            print(f"  - INDEX (file browser): {index_path}")
+    except Exception as e:
+        if args.verbose:
+            print(f"  - INDEX generation failed: {e}", file=sys.stderr)
+
+
+def _export_chunked(
+    args, result, output_dir: Path, source_path: Path,
+    formats: List[str], requested_formats: List[str]
+):
+    """Export chunked analysis results."""
+    subprojects = _get_filtered_subprojects(args, source_path)
+
+    for sp in subprojects:
+        _process_subproject(args, sp, output_dir)
+
+    # Merged summary
+    _export_registry_formats(args, result, output_dir, ['toon', 'context', 'evolution'])
+
+    if 'calls' in formats or 'calls_toon' in formats:
+        _export_calls(args, result, output_dir, formats)
+    if 'all' in requested_formats:
+        _export_project_toon(args, result, output_dir)
+
+    if source_path is not None:
+        from .code2logic import _export_code2logic
+        from .prompt import _export_chunked_prompt_txt
+        _export_code2logic(args, source_path, output_dir, formats)
+        _export_chunked_prompt_txt(args, output_dir, requested_formats, source_path, subprojects)
+
+    _export_readme(args, result, output_dir)
+    _export_index_html(args, output_dir)
+
+
+def _get_filtered_subprojects(args, source_path: Path):
+    """Get filtered subprojects list."""
+    from ..core.large_repo import HierarchicalRepoSplitter
+
+    splitter = HierarchicalRepoSplitter(size_limit_kb=args.chunk_size)
+    subprojects = splitter.get_analysis_plan(source_path)
+
+    if getattr(args, 'only_subproject', None):
+        subprojects = [
+            sp for sp in subprojects
+            if sp.name == args.only_subproject or sp.name.startswith(args.only_subproject + '.')
+        ]
+    if getattr(args, 'skip_subprojects', None):
+        subprojects = [
+            sp for sp in subprojects
+            if not any(sp.name.startswith(skip) for skip in args.skip_subprojects)
+        ]
+    return subprojects
+
+
+def _process_subproject(args, sp, output_dir: Path):
+    """Process a single subproject result."""
+    sp_output_dir = output_dir / sp.name.replace('.', '_')
+    if not sp_output_dir.exists():
+        return
+    for ext in ['.toon', '.yaml', '.json']:
+        result_file = sp_output_dir / f'analysis{ext}'
+        if result_file.exists():
+            if args.verbose:
+                level_name = {0: 'root', 1: 'L1', 2: 'L2'}.get(sp.level, f'L{sp.level}')
+                print(f"  - Exported [{level_name}] {sp.name}")
+            break
+
+
+# Backward-compatible aliases
+_export_single_project = _export_single
+_export_chunked_results = _export_chunked