docs(runbooks): add Gitea Actions operational quirks reference #1339

Open
core-devops wants to merge 2 commits from docs/gitea-actions-quirks-runbook into main

2 Commits

Author SHA1 Message Date
85579901be docs(runbooks): add Gitea Actions operational quirks reference
Some checks failed
Handlers Postgres Integration / detect-changes (pull_request) Successful in 55s
Harness Replays / detect-changes (pull_request) Successful in 51s
E2E Staging SaaS (full lifecycle) / pr-validate (pull_request) Successful in 1m20s
Lint curl status-code capture / Scan workflows for curl status-capture pollution (pull_request) Successful in 34s
publish-runtime-autobump / pr-validate (pull_request) Successful in 1m11s
publish-runtime-autobump / bump-and-tag (pull_request) Has been skipped
lint-required-no-paths / lint-required-no-paths (pull_request) Successful in 1m44s
Runtime PR-Built Compatibility / detect-changes (pull_request) Successful in 19s
Secret scan / Scan diff for credential-shaped strings (pull_request) Successful in 21s
Lint workflow YAML (Gitea-1.22.6-hostile shapes) / Lint workflow YAML for Gitea-1.22.6-hostile shapes (pull_request) Successful in 2m5s
lint-required-context-exists-in-bp / lint-required-context-exists-in-bp (pull_request) Successful in 2m17s
gate-check-v3 / gate-check (pull_request) Successful in 21s
security-review / approved (pull_request) Failing after 18s
qa-review / approved (pull_request) Failing after 19s
sop-tier-check / tier-check (pull_request) Successful in 13s
sop-checklist / all-items-acked (pull_request) Successful in 14s
Ops Scripts Tests / Ops scripts (unittest) (pull_request) Failing after 1m27s
E2E Staging External Runtime / E2E Staging External Runtime (pull_request) Successful in 5m30s
CI / Python Lint & Test (pull_request) Successful in 8m20s
Harness Replays / Harness Replays (pull_request) Successful in 8s
E2E API Smoke Test / E2E API Smoke Test (pull_request) Successful in 1m59s
Handlers Postgres Integration / Handlers Postgres Integration (pull_request) Successful in 5m22s
CI / Canvas (Next.js) (pull_request) Successful in 15m53s
E2E Staging Canvas (Playwright) / Canvas tabs E2E (pull_request) Successful in 8m10s
Runtime PR-Built Compatibility / PR-built wheel + import smoke (pull_request) Successful in 2m27s
CI / Canvas Deploy Reminder (pull_request) Successful in 6s
CI / all-required (pull_request) Failing after 40m28s
lint-continue-on-error-tracking / lint-continue-on-error-tracking (pull_request) Has been cancelled
Lint pre-flip continue-on-error / Verify continue-on-error flips have run-log proof (pull_request) Has been cancelled
lint-mask-pr-atomicity / lint-mask-pr-atomicity (pull_request) Has been cancelled
Documents four persistent Gitea 1.22.6 Actions quirks discovered
during the 2026-05-11 CI noise investigation (PR #441):

- Runner network isolation: git remote unreachable from container
- continue-on-error only at step level: job-level flag ignored
- workflow_dispatch.inputs not supported: parser rejects at load time
- fetch-depth:0 times out: use fetch-depth:1 + Compare API

Closes #457.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-16 10:44:54 +00:00
329efd12a9 fix(ci): replace fetch-depth: 0 with targeted shallow fetch in detect-changes
Some checks failed
Handlers Postgres Integration / detect-changes (pull_request) Waiting to run
Lint curl status-code capture / Scan workflows for curl status-capture pollution (pull_request) Waiting to run
lint-required-no-paths / lint-required-no-paths (pull_request) Waiting to run
Block internal-flavored paths / Block forbidden paths (pull_request) Successful in 33s
CI / Detect changes (pull_request) Successful in 45s
CI / Shellcheck (E2E scripts) (pull_request) Successful in 49s
E2E Staging Canvas (Playwright) / detect-changes (pull_request) Successful in 57s
E2E API Smoke Test / detect-changes (pull_request) Successful in 1m4s
Runtime PR-Built Compatibility / detect-changes (pull_request) Successful in 50s
Secret scan / Scan diff for credential-shaped strings (pull_request) Successful in 41s
Lint workflow YAML (Gitea-1.22.6-hostile shapes) / Lint workflow YAML for Gitea-1.22.6-hostile shapes (pull_request) Successful in 2m27s
qa-review / approved (pull_request) Failing after 45s
security-review / approved (pull_request) Failing after 45s
lint-continue-on-error-tracking / lint-continue-on-error-tracking (pull_request) Successful in 4m19s
Lint pre-flip continue-on-error / Verify continue-on-error flips have run-log proof (pull_request) Successful in 4m2s
lint-required-context-exists-in-bp / lint-required-context-exists-in-bp (pull_request) Successful in 4m7s
CI / Python Lint & Test (pull_request) Successful in 9m54s
Runtime PR-Built Compatibility / PR-built wheel + import smoke (pull_request) Successful in 4m1s
E2E API Smoke Test / E2E API Smoke Test (pull_request) Successful in 6m23s
E2E Staging Canvas (Playwright) / Canvas tabs E2E (pull_request) Successful in 10m22s
CI / Canvas (Next.js) (pull_request) Successful in 22m12s
CI / Platform (Go) (pull_request) Successful in 23m21s
CI / all-required (pull_request) Successful in 22m45s
CI / Canvas Deploy Reminder (pull_request) Successful in 8s
gate-check-v3 / gate-check (pull_request) Successful in 22s
sop-checklist / all-items-acked (pull_request) Successful in 15s
sop-tier-check / tier-check (pull_request) Successful in 15s
lint-mask-pr-atomicity / lint-mask-pr-atomicity (pull_request) Successful in 1m39s
audit-force-merge / audit (pull_request) Has been skipped
Handlers Postgres Integration / Handlers Postgres Integration (pull_request) Has been cancelled
Root cause of mc#1314: detect-changes jobs in CI/E2E workflows were
running `fetch-depth: 0` (full repository history clone) before
computing the git diff. On large repositories this takes 10+ minutes,
causing the detect-changes job itself to timeout and fail.

Fix: use `fetch-depth: 1` (shallow clone of HEAD only) plus explicit
`git fetch --depth=1 origin <BASE> --no-walk` to fetch the BASE commit
without its ancestry. This makes detect-changes complete in seconds
instead of minutes.

Files changed:
- ci.yml: changes job
- e2e-api.yml: detect-changes job
- e2e-staging-canvas.yml: detect-changes job
- runtime-prbuild-compat.yml: detect-changes job

Lint workflows (lint-mask-pr-atomicity, lint-required-context-exists-in-bp,
check-migration-collisions, lint-pre-flip-continue-on-error) retain
fetch-depth: 0 because they use `git show <base>:<path>` which needs
the full blob set from the base commit.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-16 07:47:14 +00:00