docs(ci): add CI incident runbook and update quality gate documentation #2809

Closed
freemo wants to merge 2 commits from docs/ci-incident-runbook-2597 into master

2 Commits

Author SHA1 Message Date
freemo 1d01e6e44b docs(changelog): add entries for plan list namespace, MCP 1.4.0 fix, CI artifacts, IssueMeta fix
CI / typecheck (pull_request) Successful in 46s
CI / quality (pull_request) Successful in 34s
CI / security (pull_request) Successful in 57s
CI / build (pull_request) Successful in 19s
CI / helm (pull_request) Successful in 24s
CI / lint (pull_request) Successful in 3m20s
CI / unit_tests (pull_request) Successful in 6m56s
CI / e2e_tests (pull_request) Successful in 17m10s
CI / docker (pull_request) Successful in 1m32s
CI / integration_tests (pull_request) Successful in 26m20s
CI / coverage (pull_request) Successful in 10m45s
CI / status-check (pull_request) Successful in 2s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 57m18s
Add CHANGELOG [Unreleased] entries for four recently merged commits that
were missing documentation:

- CLI: agents plan list --namespace/-n filter option (#2165, PR #2616)
- MCP: correct error extraction from content[0].text per MCP 1.4.0 (#2158, PR #2600)
- CI: nox output captured as Forgejo CI artifacts (#2750)
- Agents: correct IssueMeta schema for Forgejo dependency API (#2750)

ISSUES CLOSED: #2597
2026-04-05 02:40:12 +00:00
freemo 0e5dc18602 docs(ci): add CI incident runbook and update quality gate documentation
- Add docs/development/ci-incident-runbook.md: comprehensive runbook for
  diagnosing, triaging, and recovering from master branch CI quality gate
  failures. Covers all 11 jobs in the status-check gate, triage procedures
  per failure type, the fix branch workflow, and the complete list of
  prohibited suppression techniques.

- Update docs/development/ci-cd.md: expand the Required Status Checks table
  to include all 11 jobs (e2e_tests and helm were previously missing), update
  the CI job dependency graph to reflect the actual status-check consolidation
  gate, add a cross-reference to the new incident runbook, and strengthen the
  no-direct-pushes-to-master note.

- Update docs/development/quality-automation.md: expand the CI Jobs table to
  include integration_tests, e2e_tests, and the status-check consolidation
  gate, which were previously missing.

- Update mkdocs.yml: add CI Incident Runbook to the Development nav section.

- Update CHANGELOG.md: record the documentation fix under [Unreleased].

ISSUES CLOSED: #2597
2026-04-05 02:40:12 +00:00