Skip to content

quality-gates.mdx

Latest commit

 

History

History
104 lines (73 loc) · 2.35 KB

quality-gates.mdx

File metadata and controls

104 lines (73 loc) · 2.35 KB
title Quality Gates Map
sidebarTitle Quality Gates
description Layered quality gate map aligned to first-principles ownership and runtime budgets.
keywords
livepeer
quality gates
hooks
ci
ownership
enforcement
runtime budget

Canonical Policy

Primary policy source:

  • docs-guide/quality-testing/infrastructure-principles.mdx

This page is the operational map. Rule ownership and budgets are canonical in the policy file above.

Gate Layers

1) Pre-commit (Local, Fast, Offline)

Entry:

  • .githooks/pre-commit

Responsibilities:

  • staged structure and style invariants
  • staged unit/static checks (tests/run-all.js --staged --skip-browser)
  • staged generated-artifact sync checks
  • runtime budget enforcement (<= 60s default)

Out of scope:

  • browser sweeps
  • WCAG crawl/audit flows
  • full/broad link sweeps
  • codex issue-readiness governance

2) Pre-push (codex/* Governance)

Entry:

  • .githooks/pre-push

Responsibilities:

  • codex task-contract validation
  • codex issue-readiness validation
  • lock overlap validation
  • stash-policy enforcement
  • non-fast-forward push blocking by default

3) PR Changed-File CI (Blocking)

Entries:

  • .github/workflows/test-suite.yml
  • tests/run-pr-checks.js

Responsibilities:

  • blocking changed-file checks for style/MDX/spelling/quality/links/imports
  • docs navigation and script-doc checks
  • codex contract + PR-body + issue-state checks

4) Full/Broad CI Sweeps (Blocking or Advisory by Workflow)

Primary entries:

  • .github/workflows/test-v2-pages.yml
  • .github/workflows/openapi-reference-validation.yml
  • .github/workflows/v2-external-link-audit.yml
  • .github/workflows/broken-links.yml

Responsibilities:

  • browser/render integrity across route sets
  • OpenAPI reference integrity
  • broad link health and scheduled external checks

Blocking Defaults

  • P0/P1 checks are blocking where they are owned.
  • P2 checks may be blocking or advisory based on rollout state.
  • P3 checks are advisory unless explicitly graduated.

Source Files

  • .githooks/pre-commit
  • .githooks/pre-push
  • tests/run-all.js
  • tests/run-pr-checks.js
  • .github/workflows/test-suite.yml
  • .github/workflows/test-v2-pages.yml
  • .github/workflows/openapi-reference-validation.yml
  • docs-guide/quality-testing/infrastructure-principles.mdx