FULL MAIN CORE UPDATE

.github/workflows/main.yml

@@ -1,37 +1,87 @@
-name: Python CI
+# ═══════════════════════════════════════════════════════════════════════════
+#  S T A R R Y N O T E  ·  CI/CD Pipeline
+#  Runs on every push to main/master and on all pull requests
+#  Tests: pytest 288 tests across 12 test files
+# ═══════════════════════════════════════════════════════════════════════════
+
+name: StarryNote CI
 
 on:
   push:
-    branches:
-      - main
+    branches: [main, master]
   pull_request:
-    branches:
-      - main
+    branches: [main, master]
+
+permissions:
+  contents: read
 
 jobs:
-  build:
+  test:
+    name: Test Suite (Python ${{ matrix.python-version }})
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🐍 Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: 📦 Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements-ci.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: 🔧 Install system dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq libmagic1
 
+      - name: 📦 Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-ci.txt
+
+      - name: 🧪 Run test suite
+        run: pytest tests/ -v --tb=short --strict-markers
+        env:
+          PYTHONPATH: ${{ github.workspace }}
+
+      - name: 📊 Test summary
+        if: always()
+        run: |
+          echo "╔══════════════════════════════════════════════╗"
+          echo "║  S T A R R Y N O T E  ·  Test Summary       ║"
+          echo "╠══════════════════════════════════════════════╣"
+          echo "║  Python: ${{ matrix.python-version }}                          ║"
+          echo "║  Platform: ubuntu-latest                     ║"
+          echo "╚══════════════════════════════════════════════╝"
+
+  lint:
+    name: Code Quality
+    runs-on: ubuntu-latest
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: '3.12'
-
-    - name: Install system dependencies
-      run: |
-        sudo apt-get update
-        sudo apt-get install -y libmagic1
-
-    - name: Install Python dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements-ci.txt
-
-    - name: Test with pytest
-      run: pytest tests -v
-      env:
-        PYTHONPATH: ${{ github.workspace }}
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: 📦 Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install black
+
+      - name: 🎨 Check code formatting (Black)
+        run: black --check --diff src/ main.py tests/