specfact-cli 0.16.3__tar.gz → 0.20.1__tar.gz

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.16.3
+Version: 0.20.1
 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
@@ -276,7 +276,7 @@ Description-Content-Type: text/markdown
 # SpecFact CLI
 
 > **Stop vibe coding. Start shipping quality code with contracts.**  
-> Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts
+> Brownfield-first CLI: Analyze legacy Python → find gaps → enforce 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/)
@@ -291,16 +291,45 @@ Description-Content-Type: text/markdown
 
 ---
 
+## 📋 Current Version: 0.20.0 LTS (Long-Term Stable)
+
+**🎉 v0.20.0 is the Long-Term Stable (LTS) release!** This version marks the stabilization of SpecFact CLI's core analysis and enforcement capabilities.
+
+**SpecFact 0.20.0 LTS focuses on what it does best: analyzing legacy code and enforcing contracts.** This LTS release is production-ready and will receive bug fixes and security updates until v1.0 GA.
+
+| Capability | Status | Description |
+|------------|--------|-------------|
+| **Code Analysis** | ✅ Stable | Reverse engineer legacy code into documented specs |
+| **Gap Detection** | ✅ Stable | Find missing tests, contracts, and documentation |
+| **Contract Enforcement** | ✅ Stable | Prevent regressions with runtime validation |
+| **API Contract Testing** | ✅ Stable | Validate OpenAPI specs with Specmatic |
+| **AI IDE Bridge** | ✅ New | Generate prompts for Cursor, Copilot, Claude |
+| **Code Generation** | ⚠️ Deprecated | Coming in v1.0 with AI-assisted workflow |
+
+**Need code generation?** Use the new bridge commands to get AI-ready prompts:
+
+```bash
+# Get AI prompt to fix a gap
+specfact generate fix-prompt GAP-001 --bundle legacy-api
+
+# Get AI prompt to generate tests
+specfact generate test-prompt src/auth/login.py
+```
+
+These prompts work with any AI IDE (Cursor, Copilot, Claude Code, etc.) - you control the code generation, SpecFact validates the results.
+
+---
+
 ## 🚀 Quick Start in 60 Seconds
 
 ### Install in 10 seconds
 
 ```bash
 # Zero-install (recommended)
-uvx --from specfact-cli specfact
+uvx specfact-cli
 
-# Or install with pip
-pip install specfact-cli
+# Or install with pip (upgrade if already installed)
+pip install -U specfact-cli
 ```
 
 ### Your first command (< 60 seconds)
@@ -324,9 +353,9 @@ That's it! 🎉
 
 ## What is SpecFact CLI?
 
-A brownfield-first CLI that **reverse engineers your legacy code** into documented specs, then prevents regressions with runtime contract enforcement.
+A brownfield-first CLI that **analyzes your legacy code** to find gaps, then **enforces contracts** to prevent regressions during modernization.
 
-**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.
+**Stop vibe coding. Start shipping quality code with contracts.** SpecFact automatically extracts specs from existing code, finds missing tests and contracts, then enforces them as you modernize—preventing bugs before they reach production.
 
 **Perfect for:** Teams modernizing legacy Python systems, data pipelines, DevOps scripts
 
@@ -436,6 +465,30 @@ SpecFact CLI works with your existing tools—no new platform to learn. See real
 
 **Core USP**: Pure CLI-first approach—works offline, no account required, zero vendor lock-in. Regularly showcases successful integrations that fix bugs not detected by other tools.
 
+### 🤖 AI IDE Bridge (New in 0.17)
+
+SpecFact now generates prompts you can use with any AI IDE for code generation:
+
+```bash
+# 1. Analyze your code to find gaps
+specfact analyze gaps --bundle legacy-api
+
+# 2. Generate AI prompt to fix a specific gap
+specfact generate fix-prompt GAP-001
+
+# 3. Copy prompt to your AI IDE (Cursor, Copilot, Claude)
+# 4. AI generates the fix
+# 5. Validate with SpecFact
+specfact enforce sdd --bundle legacy-api
+```
+
+**Why this approach?**
+
+- ✅ **You control the AI** - Use your preferred AI IDE and model
+- ✅ **SpecFact validates** - Ensure AI-generated code meets contracts
+- ✅ **No lock-in** - Works with Cursor, Copilot, Claude Code, or any AI tool
+- ✅ **Quality gates** - Prevent AI hallucinations from reaching production
+
 ---
 
 ## See It In Action

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/README.md

@@ -1,7 +1,7 @@
 # SpecFact CLI
 
 > **Stop vibe coding. Start shipping quality code with contracts.**  
-> Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts
+> Brownfield-first CLI: Analyze legacy Python → find gaps → enforce 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/)
@@ -16,16 +16,45 @@
 
 ---
 
+## 📋 Current Version: 0.20.0 LTS (Long-Term Stable)
+
+**🎉 v0.20.0 is the Long-Term Stable (LTS) release!** This version marks the stabilization of SpecFact CLI's core analysis and enforcement capabilities.
+
+**SpecFact 0.20.0 LTS focuses on what it does best: analyzing legacy code and enforcing contracts.** This LTS release is production-ready and will receive bug fixes and security updates until v1.0 GA.
+
+| Capability | Status | Description |
+|------------|--------|-------------|
+| **Code Analysis** | ✅ Stable | Reverse engineer legacy code into documented specs |
+| **Gap Detection** | ✅ Stable | Find missing tests, contracts, and documentation |
+| **Contract Enforcement** | ✅ Stable | Prevent regressions with runtime validation |
+| **API Contract Testing** | ✅ Stable | Validate OpenAPI specs with Specmatic |
+| **AI IDE Bridge** | ✅ New | Generate prompts for Cursor, Copilot, Claude |
+| **Code Generation** | ⚠️ Deprecated | Coming in v1.0 with AI-assisted workflow |
+
+**Need code generation?** Use the new bridge commands to get AI-ready prompts:
+
+```bash
+# Get AI prompt to fix a gap
+specfact generate fix-prompt GAP-001 --bundle legacy-api
+
+# Get AI prompt to generate tests
+specfact generate test-prompt src/auth/login.py
+```
+
+These prompts work with any AI IDE (Cursor, Copilot, Claude Code, etc.) - you control the code generation, SpecFact validates the results.
+
+---
+
 ## 🚀 Quick Start in 60 Seconds
 
 ### Install in 10 seconds
 
 ```bash
 # Zero-install (recommended)
-uvx --from specfact-cli specfact
+uvx specfact-cli
 
-# Or install with pip
-pip install specfact-cli
+# Or install with pip (upgrade if already installed)
+pip install -U specfact-cli
 ```
 
 ### Your first command (< 60 seconds)
@@ -49,9 +78,9 @@ That's it! 🎉
 
 ## What is SpecFact CLI?
 
-A brownfield-first CLI that **reverse engineers your legacy code** into documented specs, then prevents regressions with runtime contract enforcement.
+A brownfield-first CLI that **analyzes your legacy code** to find gaps, then **enforces contracts** to prevent regressions during modernization.
 
-**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.
+**Stop vibe coding. Start shipping quality code with contracts.** SpecFact automatically extracts specs from existing code, finds missing tests and contracts, then enforces them as you modernize—preventing bugs before they reach production.
 
 **Perfect for:** Teams modernizing legacy Python systems, data pipelines, DevOps scripts
 
@@ -161,6 +190,30 @@ SpecFact CLI works with your existing tools—no new platform to learn. See real
 
 **Core USP**: Pure CLI-first approach—works offline, no account required, zero vendor lock-in. Regularly showcases successful integrations that fix bugs not detected by other tools.
 
+### 🤖 AI IDE Bridge (New in 0.17)
+
+SpecFact now generates prompts you can use with any AI IDE for code generation:
+
+```bash
+# 1. Analyze your code to find gaps
+specfact analyze gaps --bundle legacy-api
+
+# 2. Generate AI prompt to fix a specific gap
+specfact generate fix-prompt GAP-001
+
+# 3. Copy prompt to your AI IDE (Cursor, Copilot, Claude)
+# 4. AI generates the fix
+# 5. Validate with SpecFact
+specfact enforce sdd --bundle legacy-api
+```
+
+**Why this approach?**
+
+- ✅ **You control the AI** - Use your preferred AI IDE and model
+- ✅ **SpecFact validates** - Ensure AI-generated code meets contracts
+- ✅ **No lock-in** - Works with Cursor, Copilot, Claude Code, or any AI tool
+- ✅ **Quality gates** - Prevent AI hallucinations from reaching production
+
 ---
 
 ## See It In Action

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.16.3"
+version = "0.20.1"
 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.16.3 → specfact_cli-0.20.1}/resources/templates/github-action.yml.j2

@@ -31,6 +31,15 @@ on:
           - block
           - warn
           - log
+      version_check_mode:
+        description: "Version check mode (info, warn, block)"
+        required: false
+        default: "warn"
+        type: choice
+        options:
+          - info
+          - warn
+          - block
 
 jobs:
   specfact-validation:
@@ -65,10 +74,13 @@ jobs:
         run: |
           BUDGET="${INPUT_BUDGET:-{{ budget }}}"
           MODE="${INPUT_MODE:-block}"
+          VERSION_CHECK_MODE="${INPUT_VERSION_CHECK_MODE:-info}"
           echo "budget=$BUDGET" >> $GITHUB_OUTPUT
           echo "mode=$MODE" >> $GITHUB_OUTPUT
+          echo "version_check_mode=$VERSION_CHECK_MODE" >> $GITHUB_OUTPUT
           echo "SPECFACT_BUDGET=$BUDGET" >> $GITHUB_ENV
           echo "SPECFACT_MODE=$MODE" >> $GITHUB_ENV
+          echo "SPECFACT_VERSION_CHECK_MODE=$VERSION_CHECK_MODE" >> $GITHUB_ENV
 
       - name: Run Contract Validation
         id: repro
@@ -77,6 +89,26 @@ jobs:
           specfact repro --verbose --budget {% raw %}${{ steps.validation.outputs.budget }}{% endraw %} || true
           echo "exit_code=$?" >> $GITHUB_OUTPUT
 
+      - name: Version check
+        id: version_check
+        continue-on-error: true
+        run: |
+          VERSION_CHECK_MODE="{% raw %}${{ steps.validation.outputs.version_check_mode }}{% endraw %}"
+          echo "📌 Checking bundle version recommendation (mode: $VERSION_CHECK_MODE)..."
+          if specfact project version check --repo .; then
+            echo "version_check_passed=true" >> $GITHUB_OUTPUT
+          else
+            echo "version_check_passed=false" >> $GITHUB_OUTPUT
+            if [ "$VERSION_CHECK_MODE" = "warn" ]; then
+              echo "⚠️ Version check recommendation not followed (warn mode - continuing)"
+            elif [ "$VERSION_CHECK_MODE" = "block" ]; then
+              echo "❌ Version check recommendation not followed (block mode - failing)"
+              exit 1
+            else
+              echo "ℹ️ Version check recommendation available (info mode - continuing)"
+            fi
+          fi
+
       - name: Find latest repro report
         id: report
         if: always()

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/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.16.3"
+__version__ = "0.20.1"

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/src/specfact_cli/__init__.py

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

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/src/specfact_cli/cli.py

@@ -68,7 +68,6 @@ from specfact_cli.commands import (
     plan,
     project_cmd,
     repro,
-    run,
     sdd,
     spec,
     sync,
@@ -329,7 +328,6 @@ app.add_typer(implement.app, name="implement", help="Execute tasks and generate
 app.add_typer(enforce.app, name="enforce", help="Configure quality gates")
 
 # 7. Workflow Orchestration
-app.add_typer(run.app, name="run", help="Orchestrate end-to-end workflows")
 
 # 8. Validation
 app.add_typer(repro.app, name="repro", help="Run validation suite")

{specfact_cli-0.16.3 → specfact_cli-0.20.1}/src/specfact_cli/commands/__init__.py

@@ -18,7 +18,6 @@ from specfact_cli.commands import (
     plan,
     project_cmd,
     repro,
-    run,
     sdd,
     spec,
     sync,