v0.3.3

[acamarata]

⏺ 🚀 nself v0.3.3 - Intelligent Auto-Fix System

Release Date: August 14, 2025

🎯 Highlights

nself just got smarter! This release transforms how nself handles issues - it now automatically fixes problems by default, making your development workflow smoother and more reliable. No more manual interventions for common issues!

---

✨ What's New

🤖 Automatic Fixing is Now Default

• ALWAYS_AUTOFIX=true is the new default behavior
• System intelligently resolves configuration issues without prompting
• Up to 30 automatic retry attempts ensure robust problem resolution
• Concise, inline status updates keep you informed without clutter
• Need control? Set ALWAYS_AUTOFIX=false for interactive mode

🧹 Docker Resource Management

New Command: nself clean

• Clean up Docker resources with surgical precision
• Remove project images, containers, volumes, and networks
• Smart detection prevents accidental deletion of unrelated resources
• Proper image tagging eliminates duplicate buildup
• See disk space reclaimed instantly

🏗️ Comprehensive Service Auto-Generation

• Missing service? No problem! nself creates it automatically
• Full support for NestJS, BullMQ, Go, and Python services
• Complete hello-world implementations with production-ready Dockerfiles
• Seamless continuation - no manual intervention needed
• Smart type detection from directory structure

🔌 Advanced Port Conflict Resolution

• Proactive port checking before Docker even starts
• Interactive numbered menu for manual resolution
• Automatic port reassignment in auto-fix mode
• Intelligent port mapping for Redis, Mailpit, PostgreSQL, and more
• No more cryptic "port already in use" errors

---

🛠️ Improvements

Build System Enhancements

• ✅ Silent failures now properly report errors
• ✅ Fully idempotent build command
• ✅ Graceful handling of partial builds
• ✅ Validation runs in isolated subshell

Service Reliability

• ✅ Automatic recovery from unhealthy services
• ✅ Missing Dockerfile detection and generation
• ✅ Go module dependency auto-resolution
• ✅ Continuous retry mechanism for transient failures

Professional Output

• ✅ Lowercase headers following nself design standards
• ✅ Compact status indicators (✓, ⚡, ⠋, ✗)
• ✅ Cleaner, more readable terminal output
• ✅ CI/CD-friendly verbose reduction

---

📚 Usage Examples

Just works! Auto-fixes everything by default

nself up

Need manual control? Use interactive mode

ALWAYS_AUTOFIX=false nself up

Clean up Docker resources

nself clean # Remove images and build cache
nself clean -a # Nuclear option - clean everything
nself clean -c -i # Clean containers and images only

Your typical workflow is now even simpler

nself init myproject
cd myproject
nself build # Idempotent - run it anytime
nself up # Auto-fixes any issues and starts

---

🔄 Migration Guide

Good news: No breaking changes!

Your existing projects will automatically benefit from the new auto-fix capabilities. If you prefer the previous interactive behavior:

Add to your .env.local

ALWAYS_AUTOFIX=false

---

📊 By The Numbers

• 30 maximum auto-fix retry attempts
• 4 service types auto-generated (NestJS, BullMQ, Go, Python)
• 22+ types of issues automatically resolved
• 1 command to clean all Docker resources
• 0 manual interventions needed for common issues

---

🙏 Acknowledgments

Thanks to our community for the feedback that shaped this release. Your real-world usage scenarios helped us identify and automate the most common pain points.

---

📦 Installation

New installation

curl -fsSL https://get.nself.org | bash

Update existing installation

nself update

---

📝 Full Changelog

See https://github.com/nself/nself/blob/main/docs/CHANGELOG.MD for complete technical details.

---

Ready to experience the new intelligent nself? Update now and let the system handle the complexity while you focus on building great applications!

---

This discussion was created from the release v0.3.3.