initiative/specs/031-quality-gates-hygiene/quickstart.md

Quickstart: Quality Gates & Code Hygiene

Feature: 031-quality-gates-hygiene Date: 2026-03-11

What This Feature Does

Strengthens the project's automated quality gates by adding coverage thresholds, cognitive complexity limits, dependency auditing, and cleaning up lint suppressions — all enforced at pre-commit via pnpm check.

Implementation Order

1. Constitution + CLAUDE.md — Add early-enforcement principle (documentation only)
2. Biome config — Enable cognitive complexity rule + a11y rule
3. Refactor violations — Fix 5 cognitive complexity violations + biome-ignore hygiene
4. Coverage — Install @vitest/coverage-v8, configure thresholds
5. Audit — Add pnpm audit to check script
6. Verify — Run pnpm check end-to-end

Key Files to Modify

File	Change
.specify/memory/constitution.md	PATCH: add early-enforcement rule to Development Workflow
CLAUDE.md	Reflect early-enforcement principle
biome.json	Add complexity + a11y rules
vitest.config.ts	Add coverage config with thresholds
package.json	Add @vitest/coverage-v8 dep, update check script
packages/domain/src/set-initiative.ts	Remove blanket biome-ignore
apps/web/src/components/combatant-row.tsx	Reduce a11y ignores
apps/web/src/adapters/bestiary-adapter.ts	Refactor renderEntries complexity
apps/web/src/persistence/encounter-storage.ts	Refactor loadEncounter + rehydration complexity
scripts/check-layer-boundaries.mjs	Refactor checkLayerBoundaries complexity
scripts/generate-bestiary-index.mjs	Refactor buildSourceMap complexity
.gitignore	Add coverage/ directory

Verification

pnpm check   # Must pass with all new gates