refactoring

Author: tom-sapletta-com

README.md

@@ -101,16 +101,19 @@ from code2logic.llm import get_client, BaseLLMClient
 from code2logic.tools import run_benchmark, CodeReviewer
 ```
 
-## Output Formats
+## 📋 Output Formats
 
 ### Markdown (default)
+
 Human-readable documentation with:
+
 - Project structure tree with hub markers (★)
 - Dependency graphs with PageRank scores
 - Classes with methods and intents
 - Functions with signatures and descriptions
 
 ### Compact
+
 Ultra-compact format optimized for LLM context:
 
 ```text
@@ -124,12 +127,14 @@ HUBS: evolution-manager llm-orchestrator
 ```
 
 ### JSON
+
 Machine-readable format for:
+
 - RAG (Retrieval-Augmented Generation)
 - Database storage
 - Further analysis
 
-## Configuration
+## 🔧 Configuration
 
 ### Library Status
 Check which features are available:
@@ -198,15 +203,17 @@ status = get_library_status()
 # {'tree_sitter': True, 'networkx': True, ...}
 ```
 
-## Analysis Features
+## 📊 Analysis Features
 
 ### Dependency Analysis
+
 - **PageRank** - Identifies most important modules
 - **Hub detection** - Central modules marked with ★
 - **Cycle detection** - Find circular dependencies
 - **Clustering** - Group related modules
 
 ### Intent Generation
+
 Functions get human-readable descriptions:
 
 ```yaml
@@ -217,6 +224,7 @@ methods:
 ```
 
 ### Similarity Detection
+
 Find duplicate and similar functions:
 
 ```yaml
@@ -226,7 +234,7 @@ Similar Functions:
     - services/jwt.ts::verifyToken (85%)
 ```
 
-## Architecture
+## 🏗️ Architecture
 
 ```text
 code2logic/
@@ -240,7 +248,7 @@ code2logic/
 └── cli.py           # Command-line interface
 ```
 
-## Integration Examples
+## 🔌 Integration Examples
 
 ### With Claude/ChatGPT
 
@@ -276,7 +284,7 @@ for module in data['modules']:
         )
 ```
 
-## Development
+## 🧪 Development
 
 ### Setup
 
@@ -307,28 +315,28 @@ ruff check code2logic
 black code2logic
 ```
 
-## Performance
+## 📈 Performance
 
-| Codebase Size | Files | Lines | Time | Output Size |
-| --- | --- | --- | --- | --- |
-| Small | 10 | 1K | <1s | ~5KB |
-| Medium | 100 | 30K | ~2s | ~50KB |
-| Large | 500 | 150K | ~10s | ~200KB |
+|Codebase Size|Files|Lines|Time|Output Size|
+|---|---|---|---|---|
+|Small|10|1K|<1s|~5KB|
+|Medium|100|30K|~2s|~50KB|
+|Large|500|150K|~10s|~200KB|
 
 Compact format is ~10-15x smaller than Markdown.
 
-## Code Reproduction Benchmarks
+## 🔬 Code Reproduction Benchmarks
 
 Code2Logic can reproduce code from specifications using LLMs. Benchmark results:
 
 ### Format Comparison (Token Efficiency)
 
-| Format | Score | Token Efficiency | Spec Tokens | Runs OK |
-| --- | --- | --- | --- | --- |
-| **YAML** | **71.1%** | 42.1 | **366** | 66.7% |
-| **Markdown** | 65.6% | **48.7** | 385 | **100%** |
-| JSON | 61.9% | 23.7 | 605 | 66.7% |
-| Gherkin | 51.3% | 19.1 | 411 | 66.7% |
+|Format|Score|Token Efficiency|Spec Tokens|Runs OK|
+|---|---|---|---|---|
+|**YAML**|**71.1%**|42.1|**366**|66.7%|
+|**Markdown**|65.6%|**48.7**|385|**100%**|
+|JSON|61.9%|23.7|605|66.7%|
+|Gherkin|51.3%|19.1|411|66.7%|
 
 ### Key Findings
 

code2logic/benchmarks/runner.py

@@ -374,7 +374,12 @@ def run_file_benchmark(
 
         client: Optional[BaseLLMClient]
         if self._should_use_llm():
-            client = self._get_client()
+            try:
+                client = self._get_client()
+            except Exception as e:
+                client = None
+                if verbose:
+                    render.warning(f"LLM not available ({str(e)[:80]}). Falling back to template mode.")
         else:
             client = None
 
@@ -471,7 +476,12 @@ def run_function_benchmark(
 
         client: Optional[BaseLLMClient]
         if self._should_use_llm():
-            client = self._get_client()
+            try:
+                client = self._get_client()
+            except Exception as e:
+                client = None
+                if verbose:
+                    render.warning(f"LLM not available ({str(e)[:80]}). Falling back to template mode.")
         else:
             client = None
 

code2logic/universal.py

@@ -903,9 +903,15 @@ class UniversalReproducer:
 
     def __init__(self, client: BaseLLMClient = None):
         """Initialize reproducer."""
-        self.client = client or get_client()
+        self.client = client
         self.parser = UniversalParser()
         self.generator = CodeGenerator()
+
+    def _get_client(self) -> BaseLLMClient:
+        """Get or create LLM client."""
+        if self.client is None:
+            self.client = get_client()
+        return self.client
 
     def extract_logic(self, file_path: str) -> CodeLogic:
         """Extract code logic from file."""
@@ -978,6 +984,7 @@ def reproduce(
 
     def _generate_with_llm(self, logic: CodeLogic, target: Language) -> str:
         """Generate code using LLM."""
+        client = self._get_client()
         compact = logic.to_compact()
 
         lang_names = {
@@ -1007,7 +1014,7 @@ def _generate_with_llm(self, logic: CodeLogic, target: Language) -> str:
 
 Generate complete, working {target_name} code that implements all elements."""
 
-        response = self.client.generate(prompt, system=system, max_tokens=8000)
+        response = client.generate(prompt, system=system, max_tokens=8000)
         return extract_code_block(response, target.value)
 
     def _save_result(

examples/15_unified_benchmark.py

@@ -6,10 +6,10 @@
 functionality from examples 10-13 into a simple, reusable interface.
 
 Usage:
-    python examples/14_unified_benchmark.py
-    python examples/14_unified_benchmark.py --type format --folder tests/samples/
-    python examples/14_unified_benchmark.py --type function --file tests/samples/sample_functions.py
-    python examples/14_unified_benchmark.py --type project --folder tests/samples/ --limit 3
+    python examples/15_unified_benchmark.py
+    python examples/15_unified_benchmark.py --type format --folder tests/samples/
+    python examples/15_unified_benchmark.py --type function --file tests/samples/sample_functions.py
+    python examples/15_unified_benchmark.py --type project --folder tests/samples/ --limit 3
 """
 
 import argparse
@@ -102,13 +102,15 @@ def main():
     parser.add_argument('--limit', '-l', type=int, default=3)
     parser.add_argument('--output', '-o', default='examples/output/unified_benchmark.json')
     parser.add_argument('--verbose', '-v', action='store_true')
+    parser.add_argument('--no-llm', action='store_true', help='Run without LLM (template fallback)')
     args = parser.parse_args()
 
     # Configure
     config = BenchmarkConfig(
         formats=args.formats,
         max_files=args.limit,
         verbose=args.verbose,
+        use_llm=not args.no_llm,
     )
 
     runner = BenchmarkRunner(config=config)

examples/16_terminal_demo.py

@@ -182,6 +182,7 @@ def demo_log_highlighting():
 def main():
     parser = argparse.ArgumentParser(description='Terminal Rendering Demo')
     parser.add_argument('--no-color', action='store_true', help='Disable colors')
+    parser.add_argument('--folder', '-f', default=None, help='Ignored (kept for CLI compatibility)')
     args = parser.parse_args()
 
     if args.no_color: