code2llm 0.5.123__tar.gz → 0.5.125__tar.gz

{code2llm-0.5.123 → code2llm-0.5.125}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.123
+Version: 0.5.125
 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,7 +67,7 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.123-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.125-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 (166 commits)

{code2llm-0.5.123 → code2llm-0.5.125}/README.md

@@ -3,7 +3,7 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.123-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.125-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 (166 commits)

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

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm/cli_analysis.py

@@ -84,6 +84,10 @@ def _build_config(args, output_dir: Path):
     # 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
+    # Watch mode for auto-detecting changed files
+    config.watch = getattr(args, 'watch', False)
+    # Dry-run mode (handled in orchestrator, but stored for reference)
+    config.dry_run = getattr(args, 'dry_run', False)
     return config
 
 

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm/cli_exports/orchestrator.py

@@ -42,6 +42,18 @@ FORMAT_FILENAMES: Dict[str, str] = {
     'project-yaml': 'project.yaml',
 }
 
+# Files produced per format in dry-run preview
+FORMAT_DRY_RUN_FILES: Dict[str, List[str]] = {
+    'toon':      ['analysis.toon'],
+    'map':       ['map.toon.yaml'],
+    'evolution': ['evolution.toon.yaml'],
+    'context':   ['context.md'],
+    'mermaid':   ['calls.mmd', 'calls.png'],
+    'yaml':      ['analysis.yaml'],
+    'json':      ['analysis.json'],
+    'readme':    ['README.md'],
+}
+
 # Human-readable labels
 FORMAT_LABELS: Dict[str, str] = {
     'toon': 'TOON (diagnostics)',
@@ -69,6 +81,41 @@ def _build_export_config(args, formats: List[str]) -> Dict[str, Any]:
     }
 
 
+def _collect_dry_run_files(formats: List[str], output_dir: Path) -> List[Path]:
+    """Return the list of files that would be written for the given formats."""
+    output_files: List[Path] = []
+    for fmt in formats:
+        for name in FORMAT_DRY_RUN_FILES.get(fmt, []):
+            output_files.append(output_dir / name)
+    output_files.append(output_dir / 'project.toon.yaml')
+    output_files.append(output_dir / 'prompt.txt')
+    return output_files
+
+
+def _show_dry_run_plan(formats: List[str], output_dir: Path, is_chunked: bool, result) -> None:
+    """Display what would be exported in dry-run mode."""
+    print("\n📋 DRY-RUN: Would export the following:\n")
+
+    output_files = _collect_dry_run_files(formats, output_dir)
+
+    size_hint = ""
+    func_count = len(getattr(result, 'functions', []))
+    if func_count > 0:
+        size_hint = f" (~{func_count * 50 // 1024}KB est.)"
+
+    for f in sorted(set(output_files)):
+        print(f"  📄 {f}{size_hint}")
+
+    stats = getattr(result, 'stats', {})
+    if stats:
+        print(f"\n📊 Based on analysis:")
+        print(f"  - Functions: {stats.get('functions_found', 'N/A')}")
+        print(f"  - Classes: {stats.get('classes_found', 'N/A')}")
+        print(f"  - Files: {stats.get('files_processed', 'N/A')}")
+
+    print(f"\n✅ Dry-run complete. Use without --dry-run to export.\n")
+
+
 def _run_exports(args, result, output_dir: Path, source_path: Optional[Path] = None):
     """Export analysis results in requested formats.
 
@@ -79,6 +126,12 @@ def _run_exports(args, result, output_dir: Path, source_path: Optional[Path] = N
     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)
+    dry_run = getattr(args, 'dry_run', False)
+
+    # Dry-run: show what would be exported without writing
+    if dry_run:
+        _show_dry_run_plan(formats, output_dir, is_chunked, result)
+        return
 
     # Skip cache for chunked or when explicitly disabled
     skip_cache = is_chunked or getattr(args, 'no_cache', False)

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm/core/analyzer.py

@@ -52,6 +52,16 @@ class ProjectAnalyzer:
             print(f"  - Parallel: {self.config.performance.parallel_enabled}, Workers: {workers}")
 
         pcache, cached_results, files_to_analyze = self._load_from_persistent_cache(files, project_path)
+
+        # Watch mode: show what changed
+        if getattr(self.config, 'watch', False) and files_to_analyze:
+            print(f"\n👁️  Watch mode: {len(files_to_analyze)} files changed since last run:")
+            for fp, _ in files_to_analyze[:10]:
+                print(f"   • {Path(fp).name}")
+            if len(files_to_analyze) > 10:
+                print(f"   ... and {len(files_to_analyze) - 10} more")
+            print()
+
         fresh_results = self._run_analysis(files_to_analyze)
         self._store_to_persistent_cache(pcache, files_to_analyze, fresh_results)
 

code2llm-0.5.125/code2llm/exporters/report_generators.py

@@ -0,0 +1,76 @@
+"""Report generators — produce views from project.yaml (single source of truth).
+
+Thin re-export module. Actual generators live in separate files:
+  toon_view.py      → ToonViewGenerator     → project.toon.yaml
+  context_view.py   → ContextViewGenerator  → context.md
+  article_view.py   → ArticleViewGenerator  → status.md
+  html_dashboard.py → HTMLDashboardGenerator → dashboard.html
+"""
+
+import yaml
+from typing import Any, Dict
+
+from .toon_view import ToonViewGenerator
+from .context_view import ContextViewGenerator
+from .article_view import ArticleViewGenerator
+from .html_dashboard import HTMLDashboardGenerator
+
+
+def load_project_yaml(path: str) -> Dict[str, Any]:
+    """Load and validate project.yaml with detailed error reporting."""
+    import yaml
+    from yaml.scanner import ScannerError
+    from yaml.parser import ParserError
+
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            content = f.read()
+    except FileNotFoundError:
+        raise ValueError(f"project.yaml not found: {path}")
+    except Exception as e:
+        raise ValueError(f"Cannot read project.yaml ({path}): {e}")
+
+    # Check for empty file
+    if not content.strip():
+        raise ValueError(f"project.yaml is empty: {path}")
+
+    # Try to parse YAML with detailed error reporting
+    try:
+        data = yaml.safe_load(content)
+    except ScannerError as e:
+        line = e.problem_mark.line + 1 if e.problem_mark else "?"
+        col = e.problem_mark.column if e.problem_mark else "?"
+        raise ValueError(
+            f"YAML syntax error in {path} at line {line}, column {col}: {e.problem}\n"
+            f"Hint: Check indentation and special characters (:, -, #)")
+    except ParserError as e:
+        line = e.problem_mark.line + 1 if e.problem_mark else "?"
+        raise ValueError(
+            f"YAML parse error in {path} at line {line}: {e.problem}\n"
+            f"Hint: Verify YAML structure (mapping vs list)")
+    except Exception as e:
+        raise ValueError(f"YAML error in {path}: {e}")
+
+    # Validate structure
+    if data is None:
+        raise ValueError(f"project.yaml is null/empty: {path}")
+    if not isinstance(data, dict):
+        raise ValueError(
+            f"Invalid project.yaml: expected dict/object, got {type(data).__name__} in {path}\n"
+            f"Hint: YAML must start with key-value pairs, not a list")
+    if "version" not in data:
+        raise ValueError(
+            f"Invalid project.yaml: missing required 'version' key in {path}\n"
+            f"Required keys: version, project, analysis\n"
+            f"Found keys: {list(data.keys())[:10]}")
+
+    return data
+
+
+__all__ = [
+    "load_project_yaml",
+    "ToonViewGenerator",
+    "ContextViewGenerator",
+    "ArticleViewGenerator",
+    "HTMLDashboardGenerator",
+]

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm/generators/llm_flow.py

@@ -21,11 +21,42 @@ def _strip_bom(text: str) -> str:
 
 
 def _safe_read_yaml(path: Path) -> Dict[str, Any]:
-    """Read YAML file safely, handling BOM and type validation."""
-    raw = _strip_bom(path.read_text(encoding="utf-8"))
-    loaded = yaml.safe_load(raw) or {}
+    """Read YAML file safely, handling BOM and type validation with detailed errors."""
+    from yaml.scanner import ScannerError
+    from yaml.parser import ParserError
+
+    try:
+        raw = _strip_bom(path.read_text(encoding="utf-8"))
+    except FileNotFoundError:
+        raise ValueError(f"File not found: {path}")
+    except Exception as e:
+        raise ValueError(f"Cannot read file {path}: {e}")
+
+    if not raw.strip():
+        raise ValueError(f"File is empty: {path}")
+
+    try:
+        loaded = yaml.safe_load(raw)
+    except ScannerError as e:
+        line = e.problem_mark.line + 1 if e.problem_mark else "?"
+        col = e.problem_mark.column if e.problem_mark else "?"
+        raise ValueError(
+            f"YAML syntax error in {path} at line {line}, column {col}: {e.problem}\n"
+            f"Hint: Check indentation, avoid tabs, watch special characters (:, -, #)")
+    except ParserError as e:
+        line = e.problem_mark.line + 1 if e.problem_mark else "?"
+        raise ValueError(
+            f"YAML parse error in {path} at line {line}: {e.problem}\n"
+            f"Hint: Verify structure - are you using list where dict expected?")
+    except Exception as e:
+        raise ValueError(f"YAML error in {path}: {e}")
+
+    if loaded is None:
+        raise ValueError(f"File is null/empty YAML: {path}")
     if not isinstance(loaded, dict):
-        raise ValueError("analysis.yaml must be a mapping at top-level")
+        raise ValueError(
+            f"Expected YAML mapping (dict), got {type(loaded).__name__} in {path}\n"
+            f"Hint: File must start with 'key: value' pairs, not a list")
     return loaded
 
 

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm/generators/llm_task.py

@@ -212,13 +212,45 @@ def parse_llm_task_text(text: str) -> Dict[str, Any]:
 
 
 def load_input(path: Path) -> Dict[str, Any]:
-    raw = path.read_text(encoding="utf-8")
+    """Load input file with detailed YAML/JSON error reporting."""
+    from yaml.scanner import ScannerError
+    from yaml.parser import ParserError
+
+    try:
+        raw = path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        raise ValueError(f"Input file not found: {path}")
+    except Exception as e:
+        raise ValueError(f"Cannot read input file {path}: {e}")
+
     raw = _strip_bom(raw)
 
+    if not raw.strip():
+        raise ValueError(f"Input file is empty: {path}")
+
     if path.suffix.lower() in {".yaml", ".yml"}:
-        loaded = yaml.safe_load(raw) or {}
+        try:
+            loaded = yaml.safe_load(raw)
+        except ScannerError as e:
+            line = e.problem_mark.line + 1 if e.problem_mark else "?"
+            col = e.problem_mark.column if e.problem_mark else "?"
+            raise ValueError(
+                f"YAML syntax error at line {line}, column {col}: {e.problem}\n"
+                f"Hint: Check indentation in {path}")
+        except ParserError as e:
+            line = e.problem_mark.line + 1 if e.problem_mark else "?"
+            raise ValueError(
+                f"YAML parse error at line {line}: {e.problem}\n"
+                f"Hint: Verify YAML structure in {path}")
+        except Exception as e:
+            raise ValueError(f"YAML error in {path}: {e}")
+
+        if loaded is None:
+            raise ValueError(f"YAML file is null/empty: {path}")
         if not isinstance(loaded, dict):
-            raise ValueError("YAML input must be a mapping/object at top level")
+            raise ValueError(
+                f"YAML must be a mapping/object, got {type(loaded).__name__} in {path}\n"
+                f"Hint: File should start with 'key: value' pairs")
         return loaded
 
     if path.suffix.lower() == ".json":

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

{code2llm-0.5.123 → code2llm-0.5.125}/code2llm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.123
+Version: 0.5.125
 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,7 +67,7 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.123-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.125-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 (166 commits)

{code2llm-0.5.123 → code2llm-0.5.125}/pyproject.toml

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

@@ -4,7 +4,12 @@ from setuptools import setup, find_packages
 import os
 
 # Read version
-version = "0.5.122"
+def read_version():
+    version_path = os.path.join(os.path.dirname(__file__), 'VERSION')
+    with open(version_path, 'r') as f:
+        return f.read().strip()
+
+version = read_version()
 
 # Read long description
 def read_readme():

code2llm-0.5.123/code2llm/exporters/report_generators.py

@@ -1,34 +0,0 @@
-"""Report generators — produce views from project.yaml (single source of truth).
-
-Thin re-export module. Actual generators live in separate files:
-  toon_view.py      → ToonViewGenerator     → project.toon.yaml
-  context_view.py   → ContextViewGenerator  → context.md
-  article_view.py   → ArticleViewGenerator  → status.md
-  html_dashboard.py → HTMLDashboardGenerator → dashboard.html
-"""
-
-import yaml
-from typing import Any, Dict
-
-from .toon_view import ToonViewGenerator
-from .context_view import ContextViewGenerator
-from .article_view import ArticleViewGenerator
-from .html_dashboard import HTMLDashboardGenerator
-
-
-def load_project_yaml(path: str) -> Dict[str, Any]:
-    """Load and validate project.yaml."""
-    with open(path, "r", encoding="utf-8") as f:
-        data = yaml.safe_load(f)
-    if not isinstance(data, dict) or "version" not in data:
-        raise ValueError(f"Invalid project.yaml: missing 'version' key in {path}")
-    return data
-
-
-__all__ = [
-    "load_project_yaml",
-    "ToonViewGenerator",
-    "ContextViewGenerator",
-    "ArticleViewGenerator",
-    "HTMLDashboardGenerator",
-]