Add CI/CD pipeline, documentation, and project cleanup

.git-branches-guide.md

@@ -0,0 +1,62 @@
+# QuantCoder Branch Guide
+
+## Quick Switch Commands
+
+```bash
+# Switch to stable production (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
+
+| Local Branch | Version | Remote Branch |
+|--------------|---------|---------------|
+| `main` | 1.0.0 | `origin/main` |
+| `beta` | 1.1.0-beta.1 | `origin/refactor/modernize-2025` |
+| `gamma` | 2.0.0-alpha.1 | `origin/claude/refactor-quantcoder-cli-JwrsM` |
+
+## Common Operations
+
+### Check current branch
+```bash
+git branch
+```
+
+### Pull latest changes
+```bash
+git pull
+```
+
+### Push your changes
+```bash
+git push
+# Git knows where to push based on tracking
+```
+
+### See all branches
+```bash
+git branch -vv
+# Shows local branches with tracking info
+```
+
+## Package Info
+
+- **main**: Uses `quantcli` package
+- **beta**: Uses `quantcli` package (improved)
+- **gamma**: Uses `quantcoder` package (new)
+
+## Why Different Remote Names?
+
+The remote uses technical naming for system requirements.
+Your local names are clean and user-friendly.
+**This is normal and a Git best practice!**
+
+---
+
+**Need help?** See `docs/BRANCH_VERSION_MAP.md`

.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master, develop, gamma, beta, "feature/*", "claude/*"]
+  pull_request:
+    branches: [main, master, develop, gamma, beta]
+
+jobs:
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff black
+
+      - name: Check formatting with Black
+        run: black --check --diff .
+
+      - name: Lint with Ruff
+        run: ruff check .
+
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run mypy
+        run: mypy quantcoder --ignore-missing-imports
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+          pip install pytest-cov pytest-mock
+          python -m spacy download en_core_web_sm
+
+      - name: Run tests
+        run: pytest tests/ -v --cov=quantcoder --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        if: matrix.python-version == '3.11'
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pip-audit
+
+      - name: Run pip-audit
+        run: pip-audit --require-hashes=false || true
+
+  secret-scan:
+    name: Secret Scanning
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: TruffleHog Secret Scan
+        uses: trufflesecurity/trufflehog@main
+        with:
+          extra_args: --only-verified

.gitignore

@@ -1,17 +1,95 @@
-# Python virtual environments
+# Python bytecode and cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.whl
+
+# Virtual Environment
+.venv/
 .venv-legacy/
 venv/
+ENV/
+env/
+.env/
 
-# Bytecode files
-__pycache__/
-*.pyc
-
-# Environment variables
-.env
+# IDE and editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
 
-# Logs and output
+# Logs and output artifacts
 *.log
+logs/
+quantcli.log
+article_processor.log
+
+# QuantCoder specific - user data
+downloads/
+generated_code/
+articles.json
+output.html
 output.*
 
-# Packaging metadata
-*.egg-info/
+# Configuration and secrets (API keys)
+.env
+.env.*
+*.env
+.envrc
+.quantcoder/
+secrets.json
+credentials.json
+
+# OS specific
+.DS_Store
+Thumbs.db
+
+# SpaCy models (large binary files)
+*.bin
+
+# Testing and coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+*.cover
+.hypothesis/
+.tox/
+.nox/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Local development
+*.local