SpecFact CLI v0.20.0 LTS is here! 🎉

[djm81]

SpecFact CLI v0.20.0 LTS is here! 🎉

We're excited to announce SpecFact CLI v0.20.0 LTS (Long-Term Stable) — our first production-ready release focused on brownfield legacy code modernization.

What is SpecFact CLI?

SpecFact CLI helps teams modernize legacy Python codebases by:

• Reverse engineering undocumented code → specs → executable contracts
• Runtime enforcement that prevents regressions during modernization
• Symbolic execution (CrossHair) that finds edge cases LLMs miss
• CI/CD integration that blocks breaking changes automatically

Built for: Teams modernizing legacy Python systems in finance, healthcare, and data engineering where bugs cost millions.

Why Brownfield-First?

SpecFact is designed specifically for legacy code modernization:

• ✅ Works with undocumented code (no type hints required)
• ✅ AST-based analysis (not LLM guessing) — deterministic and fast
• ✅ CLI-first — works offline, no account, zero vendor lock-in
• ✅ Runtime contracts — executable guarantees, not just documentation

Quick Start

Recommended: Use slash commands in your AI IDE (Cursor, VS Code + Copilot):

# Install slash commands
specfact init --ide cursor

# Then use in your AI IDE:
/specfact.01-import --repo .

Or CLI-only mode:

# Install
uvx specfact-cli --version

# Reverse engineer your legacy code
specfact import from-code legacy-api --repo .

# Analyze contracts
specfact analyze contracts --bundle legacy-api

# Enforce at runtime
specfact enforce sdd --sdd .specfact/sdd.yaml

What We're Looking For

We'd love to hear from you! Share:

• Brownfield use cases — Are you modernizing legacy Python code?
• Integration examples — How are you using SpecFact with VS Code, Cursor, GitHub Actions, or other tools?
• Real-world case studies — What bugs did SpecFact catch? What time did you save?
• Feedback — What's working? What needs improvement?

Resources

• 📚 Documentation: https://nold-ai.github.io/specfact-cli
• 🌐 Website: https://specfact.io
• 📖 Blog Posts: https://specfact.dev (new posts coming soon!)
• 🐛 Issues: Report bugs or request features here: https://github.com/nold-ai/specfact-cli/issues

What's Next?

v0.20.0 LTS focuses on analysis and enforcement. v1.0 (coming in 2026) will add AI-assisted code generation with validation.

Try it today and let us know what you think! 🚀