Skip to content

docs: add coverage gates page, fix stale coverage and Dependabot docs - #416

Merged
danibsheehan merged 1 commit into
mainfrom
docs/coverage-thresholds
Oct 12, 2026
Merged

danibsheehan merged 1 commit into
mainfrom
docs/coverage-thresholds

Conversation

@danibsheehan

Copy link
Copy Markdown
Owner

Summary

  • Why: the docs said the coverage gate was ≥50% on both sides, but the real gates are higher and differ per side: backend ≥70% line rate (Makefile / verify.yml), frontend Vitest thresholds 83/73/80/85 (vite.config.ts), plus a ≥78 cobertura-action comment check and a ≥70% root line-rate check in make ci-local-frontend. Numbers duplicated across files is how they went stale.
  • What: new docs/coverage.md holds every coverage number once, with its source of truth. AGENTS.md and the README ci-local-* table cells now point to it instead of stating a number. docs/README.md gains an index row, a folder-table row and a "Coverage / line rate" glossary entry.
  • Also included: the README said Dependabot opens weekly version PRs, but dependabot.yml is set to daily; fixed both mentions (README lines 350 and 360). The weekly triage/portfolio routines and probe smoke are different things and are unchanged.
  • Not in this PR: a drift check between the documented numbers and the Makefile; single-sourcing the Go version pins (separate follow-up PR).

How to verify

Docs-only; no code or behavior change.

  • Read docs/coverage.md and spot-check each row against its named source file.
  • Click the new links from AGENTS.md, README lines 490–491, and docs/README.md.
  • make check-stack-docs and make check-skills-docs pass.

🤖 Generated with Claude Code

AGENTS.md and the README said the coverage gate was >=50% on both
sides, but the real gates are 70% line rate (backend) and Vitest
thresholds 83/73/80/85 (frontend). Put the numbers in one new page,
docs/coverage.md, and point the other docs at it so they can't drift
again. Also add the page to the docs index and glossary.

README also said Dependabot opens weekly version PRs; dependabot.yml
is set to daily. Fix both mentions.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
@github-actions

Copy link
Copy Markdown
Contributor

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@github-actions

Copy link
Copy Markdown
Contributor

PR guide

Auto-generated from changed paths. Prefer a why-first Summary in the PR description above (motivation, then what changed); use this comment for path-based checklist and suggested verify commands.

Touches: docs, other

Diff: 4 files changed, 32 insertions(+), 5 deletions(-)

Suggested verify

  • N/A — tooling/docs only; confirm locally if anything user-facing changed

Checklist (applies to this PR)

  • No unintended secrets or local-only config committed

Reviewer focus

  • Scope looks tooling- or docs-only — confirm no hidden runtime impact

Commits

  • 8aea835 docs: add coverage gates page, fix stale coverage and Dependabot docs

Files by area

Area Files
docs 3
other 1

CI

Required checks: Frontend (per-concern jobs) and Backend in verify. Coverage tables are posted separately when those jobs finish.


Template: pull_request_template.md

@danibsheehan
danibsheehan merged commit 0ed903d into main Oct 12, 2026
23 checks passed
@danibsheehan
danibsheehan deleted the docs/coverage-thresholds branch October 12, 2026 21:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant