specfact-cli 0.11.5__tar.gz → 0.13.0__tar.gz

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.11.5
+Version: 0.13.0
 Summary: Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git
@@ -275,20 +275,58 @@ Description-Content-Type: text/markdown
 
 # SpecFact CLI
 
-> **Understand and Modernize Legacy Code with Confidence**  
-> Automatically extract specs from existing Python code, then enforce them as contracts
+> **Stop vibe coding. Start shipping quality code with contracts.**  
+> Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts
 
+[![PyPI version](https://img.shields.io/pypi/v/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE.md)
-[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
 [![Status](https://img.shields.io/badge/status-beta-orange.svg)](https://github.com/nold-ai/specfact-cli)
 
+<div align="center">
+
+**[🌐 Learn More at noldai.com](https://noldai.com)** • **[📚 Documentation](https://nold-ai.github.io/specfact-cli)** • **[💬 Support](mailto:hello@noldai.com)**
+
+</div>
+
+---
+
+## 🚀 Quick Start in 60 Seconds
+
+### Install in 10 seconds
+
+```bash
+# Zero-install (recommended)
+uvx --from specfact-cli specfact
+
+# Or install with pip
+pip install specfact-cli
+```
+
+### Your first command (< 60 seconds)
+
+```bash
+# Modernizing legacy code? (Recommended)
+specfact import from-code legacy-api --repo .
+
+# Starting a new project?
+specfact plan init legacy-api --interactive
+
+# Using GitHub Spec-Kit or other tools?
+specfact import from-bridge --repo . --adapter speckit --write
+```
+
+That's it! 🎉
+
+> **Need machine-readable artifacts?** Use `specfact --output-format json …` (or the per-command `--output-format` flag) to emit plan bundles and reports as JSON instead of YAML.
+
 ---
 
 ## What is SpecFact CLI?
 
 A brownfield-first CLI that **reverse engineers your legacy code** into documented specs, then prevents regressions with runtime contract enforcement.
 
-**Stop guessing what your legacy code does.** SpecFact automatically extracts specs from existing code, then enforces them as you modernize.
+**Stop vibe coding. Start shipping quality code with contracts.** SpecFact automatically extracts specs from existing code, then enforces them as you modernize—preventing bugs before they reach production.
 
 **Perfect for:** Teams modernizing legacy Python systems, data pipelines, DevOps scripts
 
@@ -347,37 +385,6 @@ SpecFact CLI works with your existing tools—no new platform to learn. See real
 
 ---
 
-## Quick Start
-
-### Install in 10 seconds
-
-```bash
-# Zero-install (just run it)
-uvx specfact-cli@latest
-
-# Or install with pip
-pip install specfact-cli
-```
-
-### Your first command (< 60 seconds)
-
-```bash
-# Modernizing legacy code? (Recommended)
-specfact import from-code legacy-api --repo .
-
-# Starting a new project?
-specfact plan init legacy-api --interactive
-
-# Using GitHub Spec-Kit or other tools?
-specfact import from-bridge --repo . --adapter speckit --write
-```
-
-That's it! 🎉
-
-> Need machine-readable artifacts? Use `specfact --output-format json …` (or the per-command `--output-format` flag) to emit plan bundles and reports as JSON instead of YAML.
-
----
-
 ## See It In Action
 
 We ran SpecFact CLI **on itself** to prove it works with legacy code:
@@ -477,11 +484,16 @@ SpecFact CLI is licensed under the Apache License 2.0, which means:
 - 💬 **Questions?** [GitHub Discussions](https://github.com/nold-ai/specfact-cli/discussions)
 - 🐛 **Found a bug?** [GitHub Issues](https://github.com/nold-ai/specfact-cli/issues)
 - 📧 **Need help?** [hello@noldai.com](mailto:hello@noldai.com)
+- 🌐 **Learn more:** [noldai.com](https://noldai.com)
 
 ---
 
-> **Built with ❤️ by [NOLD AI](https://noldai.com)**
+<div align="center">
+
+**Built with ❤️ by [NOLD AI](https://noldai.com)**
 
 Copyright © 2025 Nold AI (Owner: Dominikus Nold)
 
 **Trademarks**: NOLD AI (NOLDAI) is a registered trademark (wordmark) at the European Union Intellectual Property Office (EUIPO). All other trademarks mentioned in this project are the property of their respective owners. See [TRADEMARKS.md](TRADEMARKS.md) for more information.
+
+</div>

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/README.md

@@ -1,19 +1,57 @@
 # SpecFact CLI
 
-> **Understand and Modernize Legacy Code with Confidence**  
-> Automatically extract specs from existing Python code, then enforce them as contracts
+> **Stop vibe coding. Start shipping quality code with contracts.**  
+> Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts
 
+[![PyPI version](https://img.shields.io/pypi/v/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/specfact-cli.svg)](https://pypi.org/project/specfact-cli/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE.md)
-[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
 [![Status](https://img.shields.io/badge/status-beta-orange.svg)](https://github.com/nold-ai/specfact-cli)
 
+<div align="center">
+
+**[🌐 Learn More at noldai.com](https://noldai.com)** • **[📚 Documentation](https://nold-ai.github.io/specfact-cli)** • **[💬 Support](mailto:hello@noldai.com)**
+
+</div>
+
+---
+
+## 🚀 Quick Start in 60 Seconds
+
+### Install in 10 seconds
+
+```bash
+# Zero-install (recommended)
+uvx --from specfact-cli specfact
+
+# Or install with pip
+pip install specfact-cli
+```
+
+### Your first command (< 60 seconds)
+
+```bash
+# Modernizing legacy code? (Recommended)
+specfact import from-code legacy-api --repo .
+
+# Starting a new project?
+specfact plan init legacy-api --interactive
+
+# Using GitHub Spec-Kit or other tools?
+specfact import from-bridge --repo . --adapter speckit --write
+```
+
+That's it! 🎉
+
+> **Need machine-readable artifacts?** Use `specfact --output-format json …` (or the per-command `--output-format` flag) to emit plan bundles and reports as JSON instead of YAML.
+
 ---
 
 ## What is SpecFact CLI?
 
 A brownfield-first CLI that **reverse engineers your legacy code** into documented specs, then prevents regressions with runtime contract enforcement.
 
-**Stop guessing what your legacy code does.** SpecFact automatically extracts specs from existing code, then enforces them as you modernize.
+**Stop vibe coding. Start shipping quality code with contracts.** SpecFact automatically extracts specs from existing code, then enforces them as you modernize—preventing bugs before they reach production.
 
 **Perfect for:** Teams modernizing legacy Python systems, data pipelines, DevOps scripts
 
@@ -72,37 +110,6 @@ SpecFact CLI works with your existing tools—no new platform to learn. See real
 
 ---
 
-## Quick Start
-
-### Install in 10 seconds
-
-```bash
-# Zero-install (just run it)
-uvx specfact-cli@latest
-
-# Or install with pip
-pip install specfact-cli
-```
-
-### Your first command (< 60 seconds)
-
-```bash
-# Modernizing legacy code? (Recommended)
-specfact import from-code legacy-api --repo .
-
-# Starting a new project?
-specfact plan init legacy-api --interactive
-
-# Using GitHub Spec-Kit or other tools?
-specfact import from-bridge --repo . --adapter speckit --write
-```
-
-That's it! 🎉
-
-> Need machine-readable artifacts? Use `specfact --output-format json …` (or the per-command `--output-format` flag) to emit plan bundles and reports as JSON instead of YAML.
-
----
-
 ## See It In Action
 
 We ran SpecFact CLI **on itself** to prove it works with legacy code:
@@ -202,11 +209,16 @@ SpecFact CLI is licensed under the Apache License 2.0, which means:
 - 💬 **Questions?** [GitHub Discussions](https://github.com/nold-ai/specfact-cli/discussions)
 - 🐛 **Found a bug?** [GitHub Issues](https://github.com/nold-ai/specfact-cli/issues)
 - 📧 **Need help?** [hello@noldai.com](mailto:hello@noldai.com)
+- 🌐 **Learn more:** [noldai.com](https://noldai.com)
 
 ---
 
-> **Built with ❤️ by [NOLD AI](https://noldai.com)**
+<div align="center">
+
+**Built with ❤️ by [NOLD AI](https://noldai.com)**
 
 Copyright © 2025 Nold AI (Owner: Dominikus Nold)
 
 **Trademarks**: NOLD AI (NOLDAI) is a registered trademark (wordmark) at the European Union Intellectual Property Office (EUIPO). All other trademarks mentioned in this project are the property of their respective owners. See [TRADEMARKS.md](TRADEMARKS.md) for more information.
+
+</div>

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.11.5"
+version = "0.13.0"
 description = "Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions."
 readme = "README.md"
 requires-python = ">=3.11"

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/src/__init__.py

@@ -3,4 +3,4 @@ SpecFact CLI - Spec→Contract→Sentinel tool for contract-driven development.
 """
 
 # Define the package version (kept in sync with pyproject.toml and setup.py)
-__version__ = "0.11.5"
+__version__ = "0.12.1"

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/src/specfact_cli/__init__.py

@@ -9,6 +9,6 @@ This package provides command-line tools for:
 - Validating reproducibility
 """
 
-__version__ = "0.11.5"
+__version__ = "0.13.0"
 
 __all__ = ["__version__"]

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/src/specfact_cli/analyzers/code_analyzer.py

@@ -175,9 +175,13 @@ class CodeAnalyzer:
             files_to_analyze = [f for f in python_files if not self._should_skip_file(f)]
 
             # Process files in parallel
-            max_workers = max(
-                1, min(os.cpu_count() or 4, 8, len(files_to_analyze))
-            )  # Cap at 8 workers, ensure at least 1
+            # In test mode, use fewer workers to avoid resource contention
+            if os.environ.get("TEST_MODE") == "true":
+                max_workers = max(1, min(2, len(files_to_analyze)))  # Max 2 workers in test mode
+            else:
+                max_workers = max(
+                    1, min(os.cpu_count() or 4, 8, len(files_to_analyze))
+                )  # Cap at 8 workers, ensure at least 1
             completed_count = 0
 
             def analyze_file_safe(file_path: Path) -> dict[str, Any]:
@@ -185,58 +189,76 @@ class CodeAnalyzer:
                 return self._analyze_file_parallel(file_path)
 
             if files_to_analyze:
-                executor = ThreadPoolExecutor(max_workers=max_workers)
-                interrupted = False
-                try:
-                    # Submit all tasks
-                    future_to_file = {executor.submit(analyze_file_safe, f): f for f in files_to_analyze}
-
-                    # Collect results as they complete
+                # In test mode, use sequential processing to avoid ThreadPoolExecutor deadlocks
+                is_test_mode = os.environ.get("TEST_MODE") == "true"
+                if is_test_mode:
+                    # Sequential processing in test mode - avoids ThreadPoolExecutor deadlocks entirely
+                    for file_path in files_to_analyze:
+                        try:
+                            results = analyze_file_safe(file_path)
+                            self._merge_analysis_results(results)
+                            completed_count += 1
+                            progress.update(task3, completed=completed_count)
+                        except Exception as e:
+                            console.print(f"[dim]⚠ Warning: Failed to analyze {file_path}: {e}[/dim]")
+                            completed_count += 1
+                            progress.update(task3, completed=completed_count)
+                else:
+                    executor = ThreadPoolExecutor(max_workers=max_workers)
+                    interrupted = False
+                    # In test mode, use wait=False to avoid hanging on shutdown
+                    wait_on_shutdown = not is_test_mode
                     try:
-                        for future in as_completed(future_to_file):
-                            try:
-                                results = future.result()
-                                # Merge results into instance variables (sequential merge is fast)
-                                self._merge_analysis_results(results)
-                                completed_count += 1
-                                progress.update(task3, completed=completed_count)
-                            except KeyboardInterrupt:
-                                # Cancel remaining tasks and break out of loop immediately
-                                interrupted = True
-                                for f in future_to_file:
-                                    if not f.done():
-                                        f.cancel()
-                                break
-                            except Exception as e:
-                                # Log error but continue processing
-                                file_path = future_to_file[future]
-                                console.print(f"[dim]⚠ Warning: Failed to analyze {file_path}: {e}[/dim]")
-                                completed_count += 1
-                                progress.update(task3, completed=completed_count)
+                        # Submit all tasks
+                        future_to_file = {executor.submit(analyze_file_safe, f): f for f in files_to_analyze}
+
+                        # Collect results as they complete
+                        try:
+                            for future in as_completed(future_to_file):
+                                try:
+                                    results = future.result()
+                                    # Merge results into instance variables (sequential merge is fast)
+                                    self._merge_analysis_results(results)
+                                    completed_count += 1
+                                    progress.update(task3, completed=completed_count)
+                                except KeyboardInterrupt:
+                                    # Cancel remaining tasks and break out of loop immediately
+                                    interrupted = True
+                                    for f in future_to_file:
+                                        if not f.done():
+                                            f.cancel()
+                                    break
+                                except Exception as e:
+                                    # Log error but continue processing
+                                    file_path = future_to_file[future]
+                                    console.print(f"[dim]⚠ Warning: Failed to analyze {file_path}: {e}[/dim]")
+                                    completed_count += 1
+                                    progress.update(task3, completed=completed_count)
+                        except KeyboardInterrupt:
+                            # Also catch KeyboardInterrupt from as_completed() itself
+                            interrupted = True
+                            for f in future_to_file:
+                                if not f.done():
+                                    f.cancel()
+
+                        # If interrupted, re-raise KeyboardInterrupt after breaking out of loop
+                        if interrupted:
+                            raise KeyboardInterrupt
                     except KeyboardInterrupt:
-                        # Also catch KeyboardInterrupt from as_completed() itself
+                        # Gracefully shutdown executor on interrupt (cancel pending tasks, don't wait)
                         interrupted = True
-                        for f in future_to_file:
-                            if not f.done():
-                                f.cancel()
-
-                    # If interrupted, re-raise KeyboardInterrupt after breaking out of loop
-                    if interrupted:
-                        raise KeyboardInterrupt
-                except KeyboardInterrupt:
-                    # Gracefully shutdown executor on interrupt (cancel pending tasks, don't wait)
-                    interrupted = True
-                    executor.shutdown(wait=False, cancel_futures=True)
-                    raise
-                finally:
-                    # Ensure executor is properly shutdown
-                    # If interrupted, don't wait for tasks (they're already cancelled)
-                    # shutdown() is safe to call multiple times
-                    if not interrupted:
-                        executor.shutdown(wait=True)
-                    else:
-                        # Already shutdown with wait=False, just ensure cleanup
-                        executor.shutdown(wait=False)
+                        executor.shutdown(wait=False, cancel_futures=True)
+                        raise
+                    finally:
+                        # Ensure executor is properly shutdown
+                        # If interrupted, don't wait for tasks (they're already cancelled)
+                        # shutdown() is safe to call multiple times
+                        # In test mode, use wait=False to avoid hanging
+                        if not interrupted:
+                            executor.shutdown(wait=wait_on_shutdown)
+                        else:
+                            # Already shutdown with wait=False, just ensure cleanup
+                            executor.shutdown(wait=False)
 
             # Update progress for skipped files
             skipped_count = len(python_files) - len(files_to_analyze)

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/src/specfact_cli/analyzers/graph_analyzer.py

@@ -149,11 +149,17 @@ class GraphAnalyzer:
 
         # Add edges from AST imports (parallelized for performance)
         import multiprocessing
+
+        # In test mode, use fewer workers to avoid resource contention
+        import os
         from concurrent.futures import ThreadPoolExecutor, as_completed
 
-        max_workers = max(
-            1, min(multiprocessing.cpu_count() or 4, 16, len(python_files))
-        )  # Increased for faster processing, ensure at least 1
+        if os.environ.get("TEST_MODE") == "true":
+            max_workers = max(1, min(2, len(python_files)))  # Max 2 workers in test mode
+        else:
+            max_workers = max(
+                1, min(multiprocessing.cpu_count() or 4, 16, len(python_files))
+            )  # Increased for faster processing, ensure at least 1
 
         # Get list of known modules for matching (needed for parallel processing)
         known_modules = list(graph.nodes())
@@ -176,8 +182,12 @@ class GraphAnalyzer:
             return edges
 
         # Process AST imports in parallel
-        with ThreadPoolExecutor(max_workers=max_workers) as executor:
-            future_to_file = {executor.submit(process_imports, file_path): file_path for file_path in python_files}
+        import os
+
+        executor1 = ThreadPoolExecutor(max_workers=max_workers)
+        wait_on_shutdown = os.environ.get("TEST_MODE") != "true"
+        try:
+            future_to_file = {executor1.submit(process_imports, file_path): file_path for file_path in python_files}
 
             for future in as_completed(future_to_file):
                 try:
@@ -186,11 +196,14 @@ class GraphAnalyzer:
                         graph.add_edge(module_name, matching_module)
                 except Exception:
                     continue
+        finally:
+            executor1.shutdown(wait=wait_on_shutdown)
 
         # Extract call graphs using pyan (if available) - parallelized for performance
-        with ThreadPoolExecutor(max_workers=max_workers) as executor:
+        executor2 = ThreadPoolExecutor(max_workers=max_workers)
+        try:
             future_to_file = {
-                executor.submit(self.extract_call_graph, file_path): file_path for file_path in python_files
+                executor2.submit(self.extract_call_graph, file_path): file_path for file_path in python_files
             }
 
             for future in as_completed(future_to_file):
@@ -206,6 +219,8 @@ class GraphAnalyzer:
                 except Exception:
                     # Skip if call graph extraction fails for this file
                     continue
+        finally:
+            executor2.shutdown(wait=wait_on_shutdown)
 
         self.dependency_graph = graph
         return graph

{specfact_cli-0.11.5 → specfact_cli-0.13.0}/src/specfact_cli/analyzers/relationship_mapper.py

@@ -380,10 +380,16 @@ class RelationshipMapper:
             }
 
         # Use ThreadPoolExecutor for parallel processing
-        max_workers = min(os.cpu_count() or 4, 16, len(python_files))  # Cap at 16 workers for faster processing
+        # In test mode, use fewer workers to avoid resource contention
+        if os.environ.get("TEST_MODE") == "true":
+            max_workers = max(1, min(2, len(python_files)))  # Max 2 workers in test mode
+        else:
+            max_workers = min(os.cpu_count() or 4, 16, len(python_files))  # Cap at 16 workers for faster processing
 
         executor = ThreadPoolExecutor(max_workers=max_workers)
         interrupted = False
+        # In test mode, use wait=False to avoid hanging on shutdown
+        wait_on_shutdown = os.environ.get("TEST_MODE") != "true"
         try:
             # Submit all tasks
             future_to_file = {executor.submit(self._analyze_file_parallel, f): f for f in python_files}
@@ -424,7 +430,7 @@ class RelationshipMapper:
             raise
         finally:
             if not interrupted:
-                executor.shutdown(wait=True)
+                executor.shutdown(wait=wait_on_shutdown)
             else:
                 executor.shutdown(wait=False)