ci: publish detailed coverage reports for backend + frontend

Adds first-class coverage reporting to the CI workflow. Previously only a raw coverage.out was uploaded for backend; frontend coverage was configured locally but never wired into CI.

Backend (.github/workflows/ci.yml backend job):

  - Test step now uses -covermode=atomic (race-safe and required for accurate concurrent coverage)

  - New 'Generate backend coverage reports' step runs after the test step (if: always() so it still publishes when a downstream step like Build fails) and produces:

    - coverage.txt (per-function, from 'go tool cover -func')

    - coverage.html (browsable annotated source, from 'go tool cover -html')

    - coverage-by-package.txt (statement coverage averaged per package, sorted high-to-low) via an awk roll-up

  - GITHUB_STEP_SUMMARY now shows the total-statements percent and a collapsible top-50 per-package table directly in the Actions run UI

  - Upload-artifact step renamed coverage → backend-coverage and now includes all four files

Frontend (.github/workflows/ci.yml frontend job + web/vite.config.ts):

  - vitest config now emits html and json-summary reporters in addition to text + lcov

  - Test step now runs 'npx vitest run --coverage --reporter=verbose' so coverage/ is populated on every CI run

  - New 'Generate frontend coverage report' step parses coverage/coverage-summary.json with a tiny inline node script and writes a 4-row Markdown table (statements/branches/functions/lines) to GITHUB_STEP_SUMMARY

  - New 'Upload coverage' step publishes web/coverage/ (which includes the v8 HTML report at coverage/index.html, lcov.info for external tools, and the JSON summaries) as the frontend-coverage artifact

.gitignore: adds coverage.txt, coverage-by-package.txt, web/coverage/ so local runs of the new reports don't accidentally get committed.

Verified locally (Windows + Git for Windows awk/sort/grep):

  - go tool cover -func + the awk rollup produces correct per-package percentages against a subset coverage.out

  - vitest run --coverage produces coverage/coverage-summary.json with the expected 'total' shape

  - The node summary script renders the markdown table cleanly

  - The HTML reports (coverage.html and web/coverage/index.html) render correctly

How to consume after this lands:

  - Quick read: open the CI run → 'Summary' tab shows backend total + frontend table inline

  - Deep dive: download the backend-coverage or frontend-coverage artifact, open coverage.html or coverage/index.html in a browser

  - External tools: lcov.info inside frontend-coverage is the standard format for Codecov/Coveralls/SonarQube if you choose to wire one of those up later

Net change: 3 files, +82/-5. No behavioural change to gating — tests still pass/fail on their own merits; coverage publishing is metadata-only and uses if: always() so it never masks test failures.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: atulmgupta

.github/workflows/ci.yml

@@ -55,7 +55,44 @@ jobs:
           DATABASE_USER: test
           DATABASE_PASS: test
           DATABASE_NAME: teslasync_test
-        run: go test -race -coverprofile=coverage.out ./...
+        run: go test -race -coverprofile=coverage.out -covermode=atomic ./...
+
+      - name: Generate backend coverage reports
+        if: always() && hashFiles('coverage.out') != ''
+        run: |
+          go tool cover -func=coverage.out > coverage.txt
+          go tool cover -html=coverage.out -o coverage.html
+          # Per-package roll-up (statement coverage averaged across the package's funcs)
+          awk '
+            /^total:/ { next }
+            {
+              n = split($1, parts, "/")
+              file = parts[n]; sub(/:.*$/, "", file)
+              pkg = parts[1]
+              for (i = 2; i < n; i++) pkg = pkg "/" parts[i]
+              gsub("%", "", $3)
+              sum[pkg] += $3
+              cnt[pkg]++
+            }
+            END {
+              for (p in sum) printf "%6.2f%%  %s\n", sum[p]/cnt[p], p
+            }
+          ' coverage.txt | sort -nr > coverage-by-package.txt
+          TOTAL_LINE=$(grep '^total:' coverage.txt || echo "total: (statements) 0.0%")
+          {
+            echo "## 📊 Backend Coverage"
+            echo ""
+            echo "**$TOTAL_LINE**"
+            echo ""
+            echo "Full HTML + per-function reports are attached to this run as the **backend-coverage** artifact."
+            echo ""
+            echo "<details><summary>Per-package coverage (top 50)</summary>"
+            echo ""
+            echo '```'
+            head -n 50 coverage-by-package.txt
+            echo '```'
+            echo "</details>"
+          } >> "$GITHUB_STEP_SUMMARY"
 
       - name: Architecture test (no forbidden import edges)
         run: |
@@ -91,10 +128,15 @@ jobs:
           CGO_ENABLED=0 go build -ldflags="-s -w" -o export-worker ./cmd/export-worker
 
       - name: Upload coverage
+        if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: coverage
-          path: coverage.out
+          name: backend-coverage
+          path: |
+            coverage.out
+            coverage.html
+            coverage.txt
+            coverage-by-package.txt
 
   frontend:
     name: Frontend (lint + test + build)
@@ -115,7 +157,37 @@ jobs:
       - name: Lint
         run: npm run lint
       - name: Test
-        run: npx vitest run --reporter=verbose
+        run: npx vitest run --coverage --reporter=verbose
+
+      - name: Generate frontend coverage report
+        if: always() && hashFiles('web/coverage/coverage-summary.json') != ''
+        run: |
+          node -e '
+            const fs = require("fs");
+            const path = "coverage/coverage-summary.json";
+            if (!fs.existsSync(path)) { process.exit(0); }
+            const t = JSON.parse(fs.readFileSync(path, "utf8")).total;
+            const out = [];
+            out.push("## 📊 Frontend Coverage");
+            out.push("");
+            out.push("| Metric | Covered | Total | % |");
+            out.push("|--------|--------:|------:|--:|");
+            for (const k of ["statements","branches","functions","lines"]) {
+              const m = t[k];
+              out.push(`| ${k} | ${m.covered} | ${m.total} | ${m.pct}% |`);
+            }
+            out.push("");
+            out.push("Browsable HTML report attached as the **frontend-coverage** artifact (open `coverage/index.html`).");
+            fs.appendFileSync(process.env.GITHUB_STEP_SUMMARY, out.join("\n") + "\n");
+          '
+
+      - name: Upload coverage
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-coverage
+          path: web/coverage/
+
       - name: Build
         run: npm run build
 

.gitignore

@@ -22,6 +22,8 @@ vendor/
 coverage/
 coverage.out
 coverage.html
+coverage.txt
+coverage-by-package.txt
 
 # Node
 node_modules/
@@ -58,6 +60,9 @@ docs/.vitepress/dist/
 test-results/
 coverage.out
 coverage.html
+coverage.txt
+coverage-by-package.txt
+web/coverage/
 *.test.log
 
 PROMPT_COMMANDS.txt

web/vite.config.ts

@@ -139,7 +139,7 @@ export default defineConfig({
     setupFiles: ['./src/test-setup.ts'],
     include: ['src/**/*.test.{ts,tsx}'],
     coverage: {
-      reporter: ['text', 'lcov'],
+      reporter: ['text', 'lcov', 'html', 'json-summary'],
       include: ['src/**/*.{ts,tsx}'],
       exclude: ['src/**/*.test.{ts,tsx}', 'src/main.tsx'],
     },