Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .git-branches-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)**
Expand Down
12 changes: 6 additions & 6 deletions docs/BRANCH_VERSION_MAP.md
Original file line number Diff line number Diff line change
@@ -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)
```

---
Expand All @@ -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`

Expand Down
73 changes: 36 additions & 37 deletions docs/VERSION_COMPARISON.md
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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)
```

Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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

---

Expand Down Expand Up @@ -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.
Expand All @@ -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
Loading