Incidents
A registry of situations observed on real managed WordPress sites that are likely to recur elsewhere: what the traffic looked like, why it worked, the rule that stopped it, and the legitimate requests that must not be blocked.
Every record follows the incident schema and
identifies the affected deployment by placeholder (site-a, site-b), never by
domain.
| ID | Situation | Class | Status | First seen | Instances | Rule |
|---|---|---|---|---|---|---|
| INC-2026-10-28-01 | Nested pagination cache-busting flood | cache-busting-flood | contained | 2026-10-28 | site-a | incident-only |
Adding a record
- Copy the incident template to
docs/incidents/<YYYY>-<MM>-<slug>.md. - Fill the front matter and the eight sections — especially Do not block.
- Add a row to the table above.
- Run
bash tests/test-incidents.shandnpm --prefix website run build.
The test enforces the schema, the site-a placeholders and the section order,
and it sweeps the records for hostnames. It cannot detect a bare site title, so
read the record before committing it.