diff --git a/.git-branches-guide.md b/.git-branches-guide.md index 9840d5a..f262a25 100644 --- a/.git-branches-guide.md +++ b/.git-branches-guide.md @@ -3,14 +3,14 @@ ## Quick Switch Commands ```bash -# Switch to stable production (1.0) +# Default branch - Latest development (2.0) ⭐ +git checkout gamma + +# Switch to original stable (1.0) git checkout main # Switch to improved testing (1.1) git checkout beta - -# Switch to cutting edge (2.0) ⭐ -git checkout gamma ``` ## Branch Mapping diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 034bf46..cae9005 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -2,9 +2,9 @@ name: CI on: push: - branches: [main, master, develop, gamma, beta, "feature/*", "claude/*"] + branches: [gamma, main, master, develop, beta, "feature/*", "claude/*"] pull_request: - branches: [main, master, develop, gamma, beta] + branches: [gamma, main, master, develop, beta] jobs: lint: diff --git a/README.md b/README.md index 9ee6046..00890b8 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,9 @@ > **AI-powered CLI for generating QuantConnect trading algorithms from research articles** -⚠️ **This is the GAMMA branch (2.0.0-alpha.1)** - Cutting edge with autonomous mode & library builder +**This is QuantCoder 2.0 (GAMMA)** - The primary development branch with autonomous mode & library builder -**Looking for stable version?** → [QuantCoder 1.0 (main branch)](https://github.com/SL-Mar/quantcoder-cli/tree/main) +**Want the original stable version?** → [QuantCoder 1.0 (main branch)](https://github.com/SL-Mar/quantcoder-cli/tree/main) **Want improved legacy?** → [QuantCoder 1.1 (beta branch)](https://github.com/SL-Mar/quantcoder-cli/tree/beta) 📖 **[Version Comparison Guide](docs/VERSION_COMPARISON.md)** | **[Branch Map](docs/BRANCH_VERSION_MAP.md)** diff --git a/docs/BRANCH_VERSION_MAP.md b/docs/BRANCH_VERSION_MAP.md index dfbb5b7..7433184 100644 --- a/docs/BRANCH_VERSION_MAP.md +++ b/docs/BRANCH_VERSION_MAP.md @@ -1,16 +1,16 @@ # QuantCoder-CLI Branch & Version Map -**Last Updated**: 2025-01-15 (**RESTRUCTURED**) +**Last Updated**: 2026-01-26 (**DEFAULT BRANCH: GAMMA**) **Repository**: SL-Mar/quantcoder-cli ## ⚡ Quick Reference -After restructuring, QuantCoder now has **3 active branches**: +QuantCoder has **3 active branches** with **gamma as the default**: ``` -main (1.0) → Stable production +gamma (2.0) → Default branch - Latest development ⭐ +main (1.0) → Original stable beta (1.1) → Improved legacy (testing) -gamma (2.0) → Complete rewrite (alpha) ``` --- @@ -19,9 +19,9 @@ gamma (2.0) → Complete rewrite (alpha) | Branch | Version | Package | Status | Use Case | |--------|---------|---------|--------|----------| -| **main** | 1.0.0 | `quantcli` | 🟢 Stable | Production, simple workflows | +| **gamma** ⭐ | 2.0.0-alpha.1 | `quantcoder` | 🚀 Default | Autonomous mode, library builder | +| **main** | 1.0.0 | `quantcli` | 🟢 Legacy Stable | Production, simple workflows | | **beta** | 1.1.0-beta.1 | `quantcli` | 🧪 Testing | Improved legacy, not tested | -| **gamma** | 2.0.0-alpha.1 | `quantcoder` | 🚀 Alpha | Autonomous mode, library builder | **Archived**: `feature/enhanced-help-command`, `revert-3-feature/enhanced-help-command` diff --git a/docs/VERSION_COMPARISON.md b/docs/VERSION_COMPARISON.md index 2e3931a..14695e0 100644 --- a/docs/VERSION_COMPARISON.md +++ b/docs/VERSION_COMPARISON.md @@ -1,6 +1,6 @@ # QuantCoder Version Comparison Guide -**Last Updated:** 2025-01-15 +**Last Updated:** 2026-01-26 (**DEFAULT BRANCH: GAMMA**) **Repository:** SL-Mar/quantcoder-cli This guide helps you choose the right version of QuantCoder for your needs. @@ -10,15 +10,14 @@ This guide helps you choose the right version of QuantCoder for your needs. ## 🎯 Quick Decision Tree ``` -Do you need the latest cutting-edge features? - └─ YES → QuantCoder 2.0 (gamma branch) ⭐ - └─ NO ↓ +Start here → QuantCoder 2.0 (gamma branch - DEFAULT) ⭐ + └─ Want simpler legacy versions? ↓ Do you want improved legacy with testing? └─ YES → QuantCoder 1.1 (beta branch) └─ NO ↓ -Do you need stable, proven production CLI? +Do you need the original stable production CLI? └─ YES → QuantCoder 1.0 (main branch) ``` @@ -28,19 +27,19 @@ Do you need stable, proven production CLI? | Version | Branch | Package | Status | Best For | |---------|--------|---------|--------|----------| -| **1.0** | `main` | `quantcli` | ✅ Stable | Production, simple workflows | +| **2.0** ⭐ | `gamma` | `quantcoder` | 🚀 Default | Latest development, autonomous features | +| **1.0** | `main` | `quantcli` | ✅ Legacy Stable | Original production, simple workflows | | **1.1** | `beta` | `quantcli` | 🧪 Testing | Improved legacy, not yet tested | -| **2.0** | `gamma` | `quantcoder` | 🚀 Alpha | Cutting edge, autonomous features | --- ## 🔍 Detailed Comparison -### QuantCoder 1.0 (Stable) +### QuantCoder 1.0 (Legacy Stable) **Branch:** `main` **Package:** `quantcli` -**Status:** ✅ Production stable +**Status:** ✅ Original production version **First Released:** November 2023 #### Installation @@ -137,11 +136,11 @@ pip install -e . --- -### QuantCoder 2.0 (Alpha) +### QuantCoder 2.0 (Default Branch) -**Branch:** `gamma` +**Branch:** `gamma` (DEFAULT) ⭐ **Package:** `quantcoder` (NEW - different from quantcli!) -**Status:** 🚀 Alpha development +**Status:** 🚀 Primary development branch **Version:** 2.0.0-alpha.1 #### Installation @@ -322,9 +321,16 @@ quantcoder library export ## 🎓 Recommendations -### For Production Use +### For Latest Features (Default) +**→ Use 2.0 (gamma - DEFAULT)** +- Autonomous learning +- Library building +- Multi-agent system +- Cutting edge features + +### For Legacy Production Use **→ Use 1.0 (main)** -- Stable and proven +- Original stable version - Low cost - Simple workflows - Known limitations @@ -336,18 +342,11 @@ quantcoder library export - Security improvements - Help test before release! -### For Advanced Features -**→ Use 2.0 (gamma)** -- Autonomous learning -- Library building -- Multi-agent system -- Cutting edge - ### For Beginners -**→ Start with 1.0, upgrade later** -1. Learn with 1.0 (simple) -2. Try 1.1 (improvements) -3. Explore 2.0 (advanced) +**→ Start with 2.0, explore legacy if needed** +1. Start with 2.0 (default, most features) +2. Try 1.1 or 1.0 if you need simplicity +3. Learn at your own pace --- @@ -407,7 +406,7 @@ pip install -e . - Advanced features → 2.0 ### Q: Is 2.0 production-ready? -**A:** Alpha status - architecture is solid, but testing needed. Use with caution. +**A:** It's the default development branch with solid architecture. While marked as alpha for cautious users, it represents the latest and most advanced features. ### Q: Will 1.0 be maintained? **A:** Yes, as stable legacy version. Critical bugs will be fixed. @@ -419,26 +418,26 @@ pip install -e . **A:** Specify version number in issues: "Bug in 1.0" vs "Bug in 2.0" ### Q: When will 2.0 be stable? -**A:** After testing phase. Help us test to speed this up! +**A:** 2.0 is already the default branch. The version numbering indicates development stage, but it's the primary branch for active development and new features. --- ## 🎯 Summary Table -| Criteria | Choose 1.0 | Choose 1.1 | Choose 2.0 | +| Criteria | Choose 2.0 | Choose 1.1 | Choose 1.0 | |----------|------------|------------|------------| -| Stability needed | ✅ | ⚠️ | ❌ | -| Want latest features | ❌ | ❌ | ✅ | -| Low cost priority | ✅ | ✅ | ❌ | -| Simple workflows | ✅ | ✅ | ❌ | -| Complex workflows | ❌ | ❌ | ✅ | -| Autonomous generation | ❌ | ❌ | ✅ | -| Library building | ❌ | ❌ | ✅ | -| Production use | ✅ | ⚠️ | ⚠️ | +| Default choice | ✅ | ❌ | ❌ | +| Latest features | ✅ | ❌ | ❌ | +| Legacy stability | ⚠️ | ⚠️ | ✅ | +| Simple workflows | ⚠️ | ✅ | ✅ | +| Complex workflows | ✅ | ❌ | ❌ | +| Autonomous generation | ✅ | ❌ | ❌ | +| Library building | ✅ | ❌ | ❌ | +| Active development | ✅ | ⚠️ | ❌ | --- **Need help choosing?** Open an issue with your use case! -**Last Updated:** 2025-01-15 +**Last Updated:** 2026-01-26 (**DEFAULT BRANCH: GAMMA**) **Maintained by:** SL-MAR