code2llm 0.5.87__tar.gz → 0.5.88__tar.gz

{code2llm-0.5.87 → code2llm-0.5.88}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.87
+Version: 0.5.88
 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
@@ -76,7 +76,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 # Quick health check (TOON format only)
 code2llm ./ -f toon
 
-# Generate all formats + prompt.txt (single-project mode)
+# Generate all formats + project.toon.yaml + prompt.txt (single-project mode)
 code2llm ./ -f all -o ./project --no-chunk
 
 # LLM-ready context only
@@ -192,7 +192,7 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | 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
-**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`; `-f all` also writes `project.toon.yaml`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`

{code2llm-0.5.87 → code2llm-0.5.88}/README.md

@@ -26,7 +26,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 # Quick health check (TOON format only)
 code2llm ./ -f toon
 
-# Generate all formats + prompt.txt (single-project mode)
+# Generate all formats + project.toon.yaml + prompt.txt (single-project mode)
 code2llm ./ -f all -o ./project --no-chunk
 
 # LLM-ready context only
@@ -142,7 +142,7 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | 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
-**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`; `-f all` also writes `project.toon.yaml`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`

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

{code2llm-0.5.87 → code2llm-0.5.88}/code2llm/cli_exports/prompt.py

@@ -84,6 +84,7 @@ _MAIN_FILES = [
     ('analysis.toon', 'Health diagnostics - complexity metrics, god modules, coupling issues, refactoring priorities', ('analysis.toon', 'analysis.toon.yaml')),
     ('map.toon.yaml', 'Structural map - files, sizes, imports, exports, signatures, project header', ('map.toon.yaml',)),
     ('evolution.toon.yaml', 'Refactoring queue - ranked actions by impact/effort, risks, metrics targets, history', ('evolution.toon.yaml',)),
+    ('project.toon.yaml', 'Compact project overview - generated from project.yaml data', ('project.toon.yaml',)),
     ('context.md', 'LLM narrative - architecture summary and project context', ('context.md',)),
     ('README.md', 'Generated documentation - overview and usage guide', ('README.md',)),
 ]
@@ -242,6 +243,7 @@ def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict
     analysis_file = _find_existing_prompt_file(output_dir, ('analysis.toon', 'analysis.toon.yaml'))
     map_file = _find_existing_prompt_file(output_dir, ('map.toon.yaml',))
     evolution_file = _find_existing_prompt_file(output_dir, ('evolution.toon.yaml',))
+    project_toon_file = _find_existing_prompt_file(output_dir, ('project.toon.yaml',))
     context_file = _find_existing_prompt_file(output_dir, ('context.md',))
     readme_file = _find_existing_prompt_file(output_dir, ('README.md',))
     project_logic_file = _find_existing_prompt_file(output_dir, ('project.toon', 'project/project.toon', 'project.toon.txt'))
@@ -255,6 +257,8 @@ def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict
         'map_file': map_file or 'map.toon.yaml',
         'has_evolution_toon': evolution_file is not None,
         'evolution_file': evolution_file or 'evolution.toon.yaml',
+        'has_project_toon_yaml': project_toon_file is not None,
+        'project_toon_file': project_toon_file or 'project.toon.yaml',
         'has_context_md': context_file is not None,
         'context_file': context_file or 'context.md',
         'has_readme_md': readme_file is not None,
@@ -274,6 +278,7 @@ def _analyze_generated_files(output_dir: Path, subprojects: list = None) -> dict
         'has_analysis_toon',
         'has_map_toon',
         'has_evolution_toon',
+        'has_project_toon_yaml',
         'has_project_logic',
         'has_validation_toon',
         'has_duplication_toon',
@@ -292,6 +297,7 @@ def _build_dynamic_focus_areas(file_analysis: dict) -> List[str]:
     analysis_file = file_analysis.get('analysis_file', 'analysis.toon')
     map_file = file_analysis.get('map_file', 'map.toon.yaml')
     evolution_file = file_analysis.get('evolution_file', 'evolution.toon.yaml')
+    project_toon_file = file_analysis.get('project_toon_file', 'project.toon.yaml')
     project_logic_file = file_analysis.get('project_logic_file', 'project.toon')
     validation_file = file_analysis.get('validation_file', 'project/validation.toon.yaml')
     duplication_file = file_analysis.get('duplication_file', 'project/duplication.toon.yaml')
@@ -305,14 +311,17 @@ def _build_dynamic_focus_areas(file_analysis: dict) -> List[str]:
     if file_analysis['has_evolution_toon']:
         focus_areas.append(f"3. **Refactoring Priorities** - Examine ranked refactoring actions and risk assessment from {evolution_file}")
 
+    if file_analysis.get('has_project_toon_yaml'):
+        focus_areas.append(f"4. **Project Overview** - Review the compact project overview from {project_toon_file}")
+
     if file_analysis.get('has_project_logic'):
-        focus_areas.append(f"4. **Project Logic** - Review the compact module overview from {project_logic_file}")
+        focus_areas.append(f"5. **Project Logic** - Review the compact module overview from {project_logic_file}")
     
     if file_analysis['has_validation_toon']:
-        focus_areas.append(f"5. **Validation Analysis** - Review validation results and issues identified by vallm from {validation_file}")
+        focus_areas.append(f"6. **Validation Analysis** - Review validation results and issues identified by vallm from {validation_file}")
     
     if file_analysis['has_duplication_toon']:
-        focus_areas.append(f"6. **Code Duplication** - Examine duplicate code patterns detected by redup from {duplication_file}")
+        focus_areas.append(f"7. **Code Duplication** - Examine duplicate code patterns detected by redup from {duplication_file}")
     
     if not focus_areas:
         focus_areas.append("1. **General Code Review** - Provide overall architecture assessment and improvement recommendations")
@@ -325,6 +334,7 @@ def _build_dynamic_tasks(file_analysis: dict) -> List[str]:
     analysis_file = file_analysis.get('analysis_file', 'analysis.toon')
     map_file = file_analysis.get('map_file', 'map.toon.yaml')
     evolution_file = file_analysis.get('evolution_file', 'evolution.toon.yaml')
+    project_toon_file = file_analysis.get('project_toon_file', 'project.toon.yaml')
     validation_file = file_analysis.get('validation_file', 'project/validation.toon.yaml')
     duplication_file = file_analysis.get('duplication_file', 'project/duplication.toon.yaml')
     project_logic_file = file_analysis.get('project_logic_file', 'project.toon')
@@ -344,6 +354,9 @@ def _build_dynamic_tasks(file_analysis: dict) -> List[str]:
     if file_analysis['has_evolution_toon']:
         tasks.append(f"- Prioritize refactoring actions by impact/effort ratio from {evolution_file}.")
 
+    if file_analysis.get('has_project_toon_yaml'):
+        tasks.append(f"- Compare the compact project overview in {project_toon_file} with the main analysis files.")
+
     if file_analysis.get('has_project_logic'):
         tasks.append(f"- Use {project_logic_file} to validate the compact project overview against the rest of the analysis.")
     
@@ -385,6 +398,8 @@ def _build_prompt_footer(chunked: bool = False, file_analysis: dict = None) -> L
             lines.append(f"- Start with {file_analysis.get('analysis_file', 'analysis.toon')} for health metrics, then {file_analysis.get('map_file', 'map.toon.yaml')} for structure and signatures")
             if file_analysis['has_evolution_toon']:
                 lines.append(f"- Review {file_analysis.get('evolution_file', 'evolution.toon.yaml')} for action priorities and next steps")
+        if file_analysis.get('has_project_toon_yaml'):
+            lines.append(f"- Compare the compact project overview in {file_analysis.get('project_toon_file', 'project.toon.yaml')} with the main analysis files")
         if file_analysis.get('has_project_logic'):
             lines.append(f"- Compare the compact project overview in {file_analysis.get('project_logic_file', 'project.toon')} with the main analysis files")
         if file_analysis['has_validation_toon']:

{code2llm-0.5.87 → code2llm-0.5.88}/code2llm/cli_parser.py

@@ -14,7 +14,7 @@ def create_parser() -> argparse.ArgumentParser:
         epilog='''
 Examples:
   code2llm ./                                       # Default: TOON diagnostics + README
-  code2llm ./ -f all -o ./docs --no-chunk           # All core formats + prompt.txt to ./docs/
+  code2llm ./ -f all -o ./docs --no-chunk           # All core formats + project.toon.yaml + prompt.txt to ./docs/
   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 core outputs
@@ -43,7 +43,7 @@ Format Options (-f):
   flow         — Data-flow analysis (flow.toon) — legacy, explicit opt-in
   code2logic   — Generate project logic (legacy project.toon) via external code2logic
   project-yaml — Legacy project.yaml export (single source of truth) + generated views
-  all          — Generate core formats (analysis.toon, map.toon.yaml, evolution.toon.yaml, context, mermaid) plus prompt.txt in single-project runs
+  all          — Generate core formats (analysis.toon, map.toon.yaml, evolution.toon.yaml, context, mermaid) plus project.toon.yaml and prompt.txt in single-project runs
 
 Strategy Options (--strategy):
   quick     — Fast overview, fewer files analyzed

{code2llm-0.5.87 → code2llm-0.5.88}/code2llm/exporters/readme_exporter.py

@@ -235,7 +235,7 @@ grep -E "^  .*[0-9]{{3,}}$" project.toon.yaml | sort -t',' -k2 -n -r | head -10
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
 **Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
 **Contents**:
-- **Files section**: Lists all existing generated files with descriptions
+- **Files section**: Lists all existing generated files with descriptions, including `project.toon.yaml` when generated by `-f all`
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis

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

{code2llm-0.5.87 → code2llm-0.5.88}/code2llm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.87
+Version: 0.5.88
 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
@@ -76,7 +76,7 @@ When you run `code2llm ./ -f all`, the following files are created:
 # Quick health check (TOON format only)
 code2llm ./ -f toon
 
-# Generate all formats + prompt.txt (single-project mode)
+# Generate all formats + project.toon.yaml + prompt.txt (single-project mode)
 code2llm ./ -f all -o ./project --no-chunk
 
 # LLM-ready context only
@@ -192,7 +192,7 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | 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
-**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`; `-f all` also writes `project.toon.yaml`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`

{code2llm-0.5.87 → code2llm-0.5.88}/code2llm.egg-info/SOURCES.txt

@@ -111,6 +111,7 @@ tests/test_multilanguage_e2e.py
 tests/test_nlp_pipeline.py
 tests/test_nonpython_cc_calls.py
 tests/test_pipeline_detector.py
+tests/test_project_toon_export.py
 tests/test_prompt_engine.py
 tests/test_prompt_txt.py
 tests/test_refactoring_engine.py

{code2llm-0.5.87 → code2llm-0.5.88}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2llm"
-version = "0.5.87"
+version = "0.5.88"
 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.87 → code2llm-0.5.88}/setup.py

@@ -4,7 +4,7 @@ from setuptools import setup, find_packages
 import os
 
 # Read version
-version = "0.5.86"
+version = "0.5.87"
 
 # Read long description
 def read_readme():

code2llm-0.5.88/tests/test_project_toon_export.py

@@ -0,0 +1,75 @@
+"""Tests for automatic project.toon.yaml export in all-format runs."""
+
+from pathlib import Path
+from types import SimpleNamespace
+from unittest.mock import MagicMock, patch
+
+from code2llm.cli_exports.formats import _export_project_toon
+from code2llm.cli_exports.orchestrator import _export_single_project
+
+
+def test_export_project_toon_writes_file(tmp_path):
+    args = SimpleNamespace(verbose=False)
+    result = MagicMock()
+
+    fake_data = {
+        "project": {
+            "name": "sample",
+            "stats": {"functions": 1, "files": 1, "lines": 10, "classes": 0},
+            "language": "python",
+            "analyzed_at": "2026-03-26T12:34:56Z",
+        },
+        "health": {
+            "cc_avg": 1.0,
+            "critical_count": 0,
+            "critical_limit": 10,
+            "duplicates": 0,
+            "cycles": 0,
+            "alerts": [],
+        },
+        "modules": [
+            {"path": "sample.py", "lines": 10, "classes": 0, "methods": 1, "cc_max": 1, "inbound_deps": 0},
+        ],
+        "hotspots": [],
+        "refactoring": {},
+        "evolution": [],
+    }
+
+    with patch("code2llm.cli_exports.formats.ProjectYAMLExporter._load_previous_evolution", return_value=[]), \
+         patch("code2llm.cli_exports.formats.ProjectYAMLExporter._build_project_yaml", return_value=fake_data):
+        output_path = _export_project_toon(args, result, tmp_path)
+
+    assert output_path == tmp_path / "project.toon.yaml"
+    assert output_path.exists()
+
+    content = output_path.read_text(encoding="utf-8")
+    assert content.startswith("# sample | 1 func | 1f | 10L | python | 2026-03-26")
+    assert "HEALTH:" in content
+    assert "MODULES[1]" in content
+
+
+def test_export_single_project_all_triggers_project_toon(tmp_path):
+    args = SimpleNamespace(verbose=False, refactor=False)
+    result = MagicMock()
+    source_path = Path("/tmp/source")
+
+    with patch("code2llm.cli_exports.orchestrator._export_simple_formats"), \
+         patch("code2llm.cli_exports.orchestrator._export_mermaid"), \
+         patch("code2llm.cli_exports.orchestrator._export_evolution"), \
+         patch("code2llm.cli_exports.orchestrator._export_data_structures"), \
+         patch("code2llm.cli_exports.orchestrator._export_context_fallback"), \
+         patch("code2llm.cli_exports.orchestrator._export_project_toon") as project_toon_mock, \
+         patch("code2llm.cli_exports.orchestrator._export_code2logic"), \
+         patch("code2llm.cli_exports.orchestrator._export_prompt_txt"), \
+         patch("code2llm.cli_exports.orchestrator._export_readme"), \
+         patch("code2llm.cli_exports.orchestrator._export_index_html"):
+        _export_single_project(
+            args,
+            result,
+            tmp_path,
+            ['toon', 'map', 'context', 'mermaid', 'evolution'],
+            requested_formats=['all'],
+            source_path=source_path,
+        )
+
+    project_toon_mock.assert_called_once_with(args, result, tmp_path)

{code2llm-0.5.87 → code2llm-0.5.88}/tests/test_prompt_txt.py

@@ -148,7 +148,7 @@ class TestPromptTxtGeneration:
         source_path = Path('/home/user/myproject')
         
         # Create all expected files
-        all_files = ['analysis.toon', 'map.toon.yaml', 'context.md', 'evolution.toon.yaml', 'README.md']
+        all_files = ['analysis.toon', 'map.toon.yaml', 'evolution.toon.yaml', 'project.toon.yaml', 'context.md', 'README.md']
         for f in all_files:
             (temp_output_dir / f).write_text('test')