Files
ZitPlane/tests/ci/README.md
T

19 lines
2.7 KiB
Markdown
Raw Normal View History

# tests/ci — Isolated Gitea verification tools
This folder contains **CI-only** source/lockfile checks and OIDC discovery smoke support. Run these through the approved `.gitea/workflows/p05-ci.yml` on a disposable Linux runner.
- `source_contract.py` checks the narrow P05 source/package constraints and paths. It is not a typecheck or application test.
- `oidc_discovery.py` checks ZITADEL readiness, OIDC discovery, JWKS and fail-closed issuer/JWKS negative fixtures on the **disposable** Docker network. It does NOT log in a user or check an authenticated callback.
- `account_negative.py` checks that an anonymous Account Portal call returns 401 and that a protected page redirects to `/signin`. It does NOT create a test user or prove real login.
- `advisory_triage.py` summarizes available npm/pnpm registry advisory JSON with IDs, ranges and fixes, without changing dependency versions.
- `compose.portless.override.yaml` is **CI-only**, adds `ports: !reset []` to clear P02's inherited Traefik host mapping. Run #83 failed because host 8080 was occupied; this post-run source correction is **not CI-verified**. Use both Compose files together and assert `proxy.ports` absent before startup. P02 dev Compose is unchanged.
No real credentials or production domains are used. Never print bootstrap PATs, admin secrets, session cookies or `.env` contents. Cleanup of disposable volumes is mandatory; never apply `docker compose down -v` to a user's non-CI stack.
- `backend_acceptance.sh` (P05-CI-03) is the manual backend-only Gitea runner preflight, portless Compose gate, four-service readiness, disposable database restart persistence and OIDC/JWKS smoke. Refuses pre-existing fixed network/project/volumes.
- `backend_cleanup.sh` (P05-CI-03) is the workflow's `always()` cleanup script. It tears down only a marked run-owned Compose project and verifies that no project containers, volumes or fixed network remain. Unverified cleanup is an explicit failure.
- Run from `.gitea/workflows/p05-backend-acceptance.yml` **only in isolated Gitea CI**, not on a production Docker host or local developer PC. **Run #86 PASS** on `03fb589`, including persistence and owned cleanup. No real user login/MFA E2E was run.
- `security_advisory_gate.py` (P05-SEC-01) takes npm or pnpm registry audit JSON, rejects missing/errored/inconsistent metadata and requires **zero Moderate/High/Critical findings**. It is independent of the existing HIGH+ audit command and `advisory_triage.py` detailed advisory ID report. Do not mark reported Moderate findings resolved without a green CI result. Dedicated `.gitea/workflows/p05-security-acceptance.yml` is manual only; frozen installs/builds run only on Gitea.
Add new CI checks and update `MINIFEST.md`, `project/`, `docs/`, and `notes/` in the same approved phase.