many changes

.gitea/workflows/build-release.yml

@@ -0,0 +1,337 @@
+name: Build & Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to build (e.g., v1.0.0)'
+        required: false
+
+env:
+  RUST_BACKTRACE: 1
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Setup Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Run frontend tests
+        run: bun run test --run
+        continue-on-error: false
+
+      - name: Run Rust tests
+        run: bun run test:rust
+        continue-on-error: false
+
+      - name: Check TypeScript
+        run: bun run check
+        continue-on-error: false
+
+  build-linux:
+    name: Build Linux
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Setup Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            build-essential \
+            curl \
+            wget \
+            file \
+            libssl-dev \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            librsvg2-dev
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build for Linux
+        run: bun run tauri build
+        env:
+          TAURI_SKIP_UPDATER: true
+
+      - name: Prepare Linux artifacts
+        run: |
+          mkdir -p dist/linux
+          # Copy AppImage
+          if [ -f "src-tauri/target/release/bundle/appimage/jellytau_"*.AppImage ]; then
+            cp src-tauri/target/release/bundle/appimage/jellytau_*.AppImage dist/linux/
+          fi
+          # Copy .deb if built
+          if [ -f "src-tauri/target/release/bundle/deb/jellytau_"*.deb ]; then
+            cp src-tauri/target/release/bundle/deb/jellytau_*.deb dist/linux/
+          fi
+          ls -lah dist/linux/
+
+      - name: Upload Linux build artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: jellytau-linux
+          path: dist/linux/
+          retention-days: 30
+
+  build-android:
+    name: Build Android
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Setup Java
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Setup Android SDK
+        uses: android-actions/setup-android@v2
+        with:
+          api-level: 33
+
+      - name: Setup Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Add Android targets
+        run: |
+          rustup target add aarch64-linux-android
+          rustup target add armv7-linux-androideabi
+          rustup target add x86_64-linux-android
+
+      - name: Install Android NDK
+        run: |
+          sdkmanager "ndk;25.1.8937393"
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-android-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-android-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build for Android
+        run: bun run tauri android build
+        env:
+          ANDROID_NDK_HOME: ${{ android.ndk-home }}
+          ANDROID_SDK_ROOT: ${{ android.sdk-root }}
+          ANDROID_HOME: ${{ android.sdk-root }}
+
+      - name: Prepare Android artifacts
+        run: |
+          mkdir -p dist/android
+          # Copy APK
+          if [ -f "src-tauri/gen/android/app/build/outputs/apk/release/app-release.apk" ]; then
+            cp src-tauri/gen/android/app/build/outputs/apk/release/app-release.apk dist/android/jellytau-release.apk
+          fi
+          # Copy AAB (Android App Bundle) if built
+          if [ -f "src-tauri/gen/android/app/build/outputs/bundle/release/app-release.aab" ]; then
+            cp src-tauri/gen/android/app/build/outputs/bundle/release/app-release.aab dist/android/jellytau-release.aab
+          fi
+          ls -lah dist/android/
+
+      - name: Upload Android build artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: jellytau-android
+          path: dist/android/
+          retention-days: 30
+
+  create-release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    needs: [build-linux, build-android]
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Get version from tag
+        id: tag_name
+        run: |
+          echo "VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+          echo "RELEASE_NAME=JellyTau ${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Download Linux artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: jellytau-linux
+          path: artifacts/linux/
+
+      - name: Download Android artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: jellytau-android
+          path: artifacts/android/
+
+      - name: Prepare release notes
+        id: release_notes
+        run: |
+          VERSION="${{ steps.tag_name.outputs.VERSION }}"
+          echo "## 📱 JellyTau $VERSION Release" > release_notes.md
+          echo "" >> release_notes.md
+          echo "### 📦 Downloads" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "#### Linux" >> release_notes.md
+          echo "- **AppImage** - Run directly on most Linux distributions" >> release_notes.md
+          echo "- **DEB** - Install via `sudo dpkg -i jellytau_*.deb` (Ubuntu/Debian)" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "#### Android" >> release_notes.md
+          echo "- **APK** - Install via `adb install jellytau-release.apk` or sideload via file manager" >> release_notes.md
+          echo "- **AAB** - Upload to Google Play Console or testing platforms" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "### ✨ What's New" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "See [CHANGELOG.md](CHANGELOG.md) for detailed changes." >> release_notes.md
+          echo "" >> release_notes.md
+          echo "### 🔧 Installation" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "#### Linux (AppImage)" >> release_notes.md
+          echo "\`\`\`bash" >> release_notes.md
+          echo "chmod +x jellytau_*.AppImage" >> release_notes.md
+          echo "./jellytau_*.AppImage" >> release_notes.md
+          echo "\`\`\`" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "#### Linux (DEB)" >> release_notes.md
+          echo "\`\`\`bash" >> release_notes.md
+          echo "sudo dpkg -i jellytau_*.deb" >> release_notes.md
+          echo "jellytau" >> release_notes.md
+          echo "\`\`\`" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "#### Android" >> release_notes.md
+          echo "- Sideload: Download APK and install via file manager or ADB" >> release_notes.md
+          echo "- Play Store: Coming soon" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "### 🐛 Known Issues" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "See [GitHub Issues](../../issues) for reported bugs." >> release_notes.md
+          echo "" >> release_notes.md
+          echo "### 📝 Requirements" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "**Linux:**" >> release_notes.md
+          echo "- 64-bit Linux system" >> release_notes.md
+          echo "- GLIBC 2.29+" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "**Android:**" >> release_notes.md
+          echo "- Android 8.0 or higher" >> release_notes.md
+          echo "- 50MB free storage" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "---" >> release_notes.md
+          echo "Built with Tauri, SvelteKit, and Rust 🦀" >> release_notes.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          name: ${{ steps.tag_name.outputs.RELEASE_NAME }}
+          body_path: release_notes.md
+          files: |
+            artifacts/linux/*
+            artifacts/android/*
+          draft: false
+          prerelease: ${{ contains(steps.tag_name.outputs.VERSION, 'rc') || contains(steps.tag_name.outputs.VERSION, 'beta') || contains(steps.tag_name.outputs.VERSION, 'alpha') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload to Gitea Releases
+        run: |
+          VERSION="${{ steps.tag_name.outputs.VERSION }}"
+
+          echo "📦 Release artifacts prepared for $VERSION"
+          echo ""
+          echo "Linux:"
+          ls -lh artifacts/linux/ || echo "No Linux artifacts"
+          echo ""
+          echo "Android:"
+          ls -lh artifacts/android/ || echo "No Android artifacts"
+          echo ""
+          echo "✅ Release $VERSION is ready!"
+          echo "📄 Release notes saved to release_notes.md"
+
+      - name: Publish release notes
+        run: |
+          echo "## 🎉 Release Published"
+          echo ""
+          echo "**Version:** ${{ steps.tag_name.outputs.VERSION }}"
+          echo "**Tag:** ${{ github.ref }}"
+          echo ""
+          echo "Artifacts:"
+          echo "- Linux artifacts in: artifacts/linux/"
+          echo "- Android artifacts in: artifacts/android/"
+          echo ""
+          echo "Visit the Release page to download files."

.gitea/workflows/traceability-check.yml

@@ -0,0 +1,142 @@
+name: Traceability Validation
+
+on:
+  push:
+    branches:
+      - master
+      - main
+      - develop
+  pull_request:
+    branches:
+      - master
+      - main
+      - develop
+
+jobs:
+  validate-traces:
+    runs-on: ubuntu-latest
+    name: Check Requirement Traces
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Extract traces
+        run: |
+          echo "🔍 Extracting requirement traces..."
+          bun run traces:json > traces-report.json
+
+      - name: Validate traces
+        run: |
+          set -e
+
+          echo "📊 Validating requirement traceability..."
+          echo ""
+
+          # Parse JSON
+          TOTAL_TRACES=$(jq '.totalTraces' traces-report.json)
+          UR=$(jq '.byType.UR | length' traces-report.json)
+          IR=$(jq '.byType.IR | length' traces-report.json)
+          DR=$(jq '.byType.DR | length' traces-report.json)
+          JA=$(jq '.byType.JA | length' traces-report.json)
+
+          # Print coverage report
+          echo "✅ TRACES Found: $TOTAL_TRACES"
+          echo ""
+          echo "📋 Coverage Summary:"
+          echo "   User Requirements (UR):         $UR / 39 ($(( UR * 100 / 39 ))%)"
+          echo "   Integration Requirements (IR): $IR / 24 ($(( IR * 100 / 24 ))%)"
+          echo "   Development Requirements (DR): $DR / 48 ($(( DR * 100 / 48 ))%)"
+          echo "   Jellyfin API Requirements (JA): $JA / 3 ($(( JA * 100 / 3 ))%)"
+          echo ""
+
+          COVERED=$((UR + IR + DR + JA))
+          TOTAL_REQS=114
+          COVERAGE=$((COVERED * 100 / TOTAL_REQS))
+
+          echo "📈 Overall Coverage: $COVERED / $TOTAL_REQS ($COVERAGE%)"
+          echo ""
+
+          # Check minimum threshold
+          MIN_THRESHOLD=50
+          if [ "$COVERAGE" -lt "$MIN_THRESHOLD" ]; then
+            echo "❌ ERROR: Coverage ($COVERAGE%) is below minimum threshold ($MIN_THRESHOLD%)"
+            exit 1
+          fi
+
+          echo "✅ Coverage is acceptable ($COVERAGE% >= $MIN_THRESHOLD%)"
+
+      - name: Check modified files
+        if: github.event_name == 'pull_request'
+        run: |
+          echo "🔍 Checking modified files for traces..."
+          echo ""
+
+          # Get changed files
+          CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.(ts|tsx|svelte|rs)$' || echo "")
+
+          if [ -z "$CHANGED" ]; then
+            echo "✅ No TypeScript/Rust files changed"
+            exit 0
+          fi
+
+          echo "📝 Changed files:"
+          echo "$CHANGED" | sed 's/^/   /'
+          echo ""
+
+          # Check each file
+          MISSING_TRACES=0
+          while IFS= read -r file; do
+            # Skip test files
+            if [[ "$file" == *".test."* ]]; then
+              continue
+            fi
+
+            if [ -f "$file" ]; then
+              if ! grep -q "TRACES:" "$file"; then
+                echo "⚠️  Missing TRACES: $file"
+                MISSING_TRACES=$((MISSING_TRACES + 1))
+              fi
+            fi
+          done <<< "$CHANGED"
+
+          if [ "$MISSING_TRACES" -gt 0 ]; then
+            echo ""
+            echo "📝 Recommendation: Add TRACES comments to new/modified code"
+            echo "   Format: // TRACES: UR-001, UR-002 | DR-003"
+            echo ""
+            echo "💡 For more info, see: scripts/README.md"
+          fi
+
+      - name: Generate full report
+        if: always()
+        run: |
+          echo "📄 Generating full traceability report..."
+          bun run traces:markdown
+
+      - name: Display report summary
+        if: always()
+        run: |
+          echo ""
+          echo "📊 Full Report Generated"
+          echo "📁 Location: docs/TRACEABILITY.md"
+          echo ""
+          head -50 docs/TRACEABILITY.md || true
+
+      - name: Save artifacts
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: traceability-reports
+          path: |
+            traces-report.json
+            docs/TRACEABILITY.md
+          retention-days: 30

.gitea/workflows/traceability.yml

@@ -0,0 +1,173 @@
+name: Requirement Traceability Check
+
+on:
+  push:
+    branches:
+      - master
+      - main
+      - develop
+  pull_request:
+    branches:
+      - master
+      - main
+      - develop
+
+jobs:
+  traceability:
+    name: Validate Requirement Traces
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Extract requirement traces
+        run: bun run traces:json > traces.json
+
+      - name: Validate trace format
+        run: |
+          if ! jq empty traces.json 2>/dev/null; then
+            echo "❌ Invalid traces.json format"
+            exit 1
+          fi
+          echo "✅ Traces JSON is valid"
+
+      - name: Check requirement coverage
+        run: |
+          set -e
+
+          # Extract coverage stats
+          TOTAL_TRACES=$(jq '.totalTraces' traces.json)
+          UR_COUNT=$(jq '.byType.UR | length' traces.json)
+          IR_COUNT=$(jq '.byType.IR | length' traces.json)
+          DR_COUNT=$(jq '.byType.DR | length' traces.json)
+          JA_COUNT=$(jq '.byType.JA | length' traces.json)
+
+          echo "## 📊 Requirement Traceability Report"
+          echo ""
+          echo "**Total TRACES Found:** $TOTAL_TRACES"
+          echo ""
+          echo "### Requirements Covered:"
+          echo "- User Requirements (UR): $UR_COUNT / 39 ($(( UR_COUNT * 100 / 39 ))%)"
+          echo "- Integration Requirements (IR): $IR_COUNT / 24 ($(( IR_COUNT * 100 / 24 ))%)"
+          echo "- Development Requirements (DR): $DR_COUNT / 48 ($(( DR_COUNT * 100 / 48 ))%)"
+          echo "- Jellyfin API Requirements (JA): $JA_COUNT / 3 ($(( JA_COUNT * 100 / 3 ))%)"
+          echo ""
+
+          # Set minimum coverage threshold (50%)
+          TOTAL_REQS=114
+          MIN_COVERAGE=$((TOTAL_REQS / 2))
+          COVERED=$((UR_COUNT + IR_COUNT + DR_COUNT + JA_COUNT))
+          COVERAGE_PERCENT=$((COVERED * 100 / TOTAL_REQS))
+
+          echo "**Overall Coverage:** $COVERED / $TOTAL_REQS ($COVERAGE_PERCENT%)"
+          echo ""
+
+          if [ "$COVERED" -lt "$MIN_COVERAGE" ]; then
+            echo "❌ Coverage below minimum threshold ($COVERAGE_PERCENT% < 50%)"
+            exit 1
+          else
+            echo "✅ Coverage meets minimum threshold ($COVERAGE_PERCENT% >= 50%)"
+          fi
+
+      - name: Check for new untraced code
+        run: |
+          set -e
+
+          # Find files modified in this PR/push
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            CHANGED_FILES=$(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.(ts|tsx|svelte|rs)$' || true)
+          else
+            CHANGED_FILES=$(git diff --name-only HEAD~1 | grep -E '\.(ts|tsx|svelte|rs)$' || true)
+          fi
+
+          if [ -z "$CHANGED_FILES" ]; then
+            echo "✅ No source files changed"
+            exit 0
+          fi
+
+          echo "### Files Changed:"
+          echo "$CHANGED_FILES" | sed 's/^/- /'
+          echo ""
+
+          # Check if changed files have TRACES
+          UNTRACED_FILES=""
+          while IFS= read -r file; do
+            if [ -f "$file" ]; then
+              # Skip test files and generated code
+              if [[ "$file" == *".test."* ]] || [[ "$file" == *"node_modules"* ]]; then
+                continue
+              fi
+
+              # Check if file has TRACES comments
+              if ! grep -q "TRACES:" "$file" 2>/dev/null; then
+                UNTRACED_FILES+="$file"$'\n'
+              fi
+            fi
+          done <<< "$CHANGED_FILES"
+
+          if [ -n "$UNTRACED_FILES" ]; then
+            echo "⚠️  New files without TRACES:"
+            echo "$UNTRACED_FILES" | sed 's/^/  - /'
+            echo ""
+            echo "💡 Add TRACES comments to link code to requirements:"
+            echo "   // TRACES: UR-001, UR-002 | DR-003"
+          else
+            echo "✅ All changed files have TRACES comments"
+          fi
+
+      - name: Generate traceability report
+        if: always()
+        run: bun run traces:markdown
+
+      - name: Upload traceability report
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: traceability-report
+          path: docs/TRACEABILITY.md
+          retention-days: 30
+
+      - name: Comment PR with coverage report
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const traces = JSON.parse(fs.readFileSync('traces.json', 'utf8'));
+
+            const urCount = traces.byType.UR.length;
+            const irCount = traces.byType.IR.length;
+            const drCount = traces.byType.DR.length;
+            const jaCount = traces.byType.JA.length;
+            const total = urCount + irCount + drCount + jaCount;
+            const coverage = Math.round((total / 114) * 100);
+
+            const comment = `## 📊 Requirement Traceability Report
+
+**Coverage:** ${coverage}% (${total}/114 requirements traced)
+
+### By Type:
+- **User Requirements (UR):** ${urCount}/39 (${Math.round(urCount/39*100)}%)
+- **Integration Requirements (IR):** ${irCount}/24 (${Math.round(irCount/24*100)}%)
+- **Development Requirements (DR):** ${drCount}/48 (${Math.round(drCount/48*100)}%)
+- **Jellyfin API (JA):** ${jaCount}/3 (${Math.round(jaCount/3*100)}%)
+
+**Total Traces:** ${traces.totalTraces}
+
+[View full report](artifacts) | [Format Guide](https://github.com/yourusername/jellytau/blob/master/scripts/README.md#extract-tracests)`;
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment
+            });