docs(ci): record OIDC run 93 queued with no executed gates

This commit is contained in:
Vib Tools committed 2026-11-22 10:13:54 -08:00
1 parent 7b80f411b2
commit 09add5345a
12 files changed
+36 -7

No files matched your search

+3
View File
@@ -36,3 +36,6 @@ See `notes/P05-CI-01.md` and `tests/ci/`.
**P05-OIDC-03:** Existing manual-only `p05-oidc-acceptance.yml` unchanged; only run-owned `tests/ci/oidc_e2e/run.sh` and new `forwarder.py` implement allowlisted socat startup error classification and, when needed, one same-run official Python image sha256-digest private 8080→80 fallback. Always cleanup unchanged. A new Gitea run must actually verify client/user, browser Auth.js callback, protected session, negatives, and teardown before PASS.
**P05-OIDC-03 Run #93 (single dispatch):** `workflow_dispatch` on `main`, tested SHA `7b80f411b2981e2274d171c12596301ed757b768`, job #206 **QUEUED at last inspection**. No CI steps, error-class evidence, OIDC positive/negative assertions or cleanup have executed yet. Neither pass nor failure is established. Do not rerun, alter login/auth or auto-trigger workflows; verify the *existing Run #93* terminal status when runner scheduling permits.
+1 -1
View File
@@ -15,7 +15,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
- **P05-SEC-02-A01:** **Gitea Run #89 SUCCESS** on `ff4c58e`: corrected exact override contract PASS, pinned PNPM frozen install PASS, official Login V2 standalone build PASS, upstream Vitest **1219/1219 PASS**, Login production audit **0 Moderate/High/Critical**; Account jobs skipped. **Dependency security/build unit acceptance complete; real user OIDC/MFA E2E and production integration NOT verified**. See `docs/P05-SEC-02-A01.md`.
- **P05-OIDC-01:** Gitea **Run #90 FAILED**: disposable four-service ZITADEL stack healthy and host-portless, but private `localhost:8080` loopback forwarding was not ready. Provisioning aborted before OIDC client/human/browser creation; real callback/session **NOT verified**. Owned database/bootstrap/secret/network cleanup **PASS**. No app/auth source change or deployment. See `docs/P05-OIDC-01.md`.
- **P05-OIDC-02:** **Gitea Run #91 FAILURE**: original four backend services and no-host-port private Traefik Host routing PASS, prebuilt socat version/digest PASS; forwarder immediately **exited with code 1**, so client/user/browser/Auth.js callback NOT EXECUTED. Cleanup PASS. No application/auth/backend edits; real OIDC remains BLOCKED. See `docs/P05-OIDC-02.md`.
- **P05-OIDC-03:** Approved CI-only real OIDC retry after socat exited 1 in Run #91: safe socat startup error classification and same-run immutable official Python stdlib loopback fallback, with original auth/browser/cleanup unchanged. **Real login acceptance CI pending**. See `docs/P05-OIDC-03.md`.
- **P05-OIDC-03:** CI-only socat startup diagnosis and immutable Python stdlib private fallback committed at `7b80f41`; **single Gitea Run #93 QUEUED** at last check, no OIDC/browser/cleanup steps executed, authentication acceptance **NOT VERIFIED**. Original auth/browser/Compose unchanged. See `docs/P05-OIDC-03.md`.
- **Production / Coolify:** not configured or deployed.
## Documentation and project knowledge
+3
View File
@@ -42,3 +42,6 @@ Future feature additions need an evidence-backed status update here, an exact de
**P05-OIDC-03 planned CI acceptance:** A same-run, safe error-class socat diagnosis and digest-verified Python stdlib private TCP fallback is prepared. The prior Run #91 verified private proxy route and cleanup but **not** any client/user/browser login. Full authenticated OIDC positive/negative flow remains **UNVERIFIED** until one actual Gitea run reaches and passes those contracts. MFA/passkeys and production TLS remain out of scope.
**P05-OIDC-03 current CI evidence:** [Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93) was dispatched on exact source `7b80f411b2981e2274d171c12596301ed757b768` but remains **QUEUED** at the last check; all actual OIDC/browser/fallback/cleanup checks **NOT EXECUTED**. The Python relay exists in source but its runtime compatibility is **NOT VERIFIED**. Run #91 remains last terminal evidence. No production login or MFA claimed.
+1 -1
View File
@@ -15,7 +15,7 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
| [P05-SEC-02-A01.md](P05-SEC-02-A01.md) | Gitea-only Login V2 full frozen-install/build/units/zero-advisory acceptance and status | P05-SEC-02-A01 / Run #89 SUCCESS |
| [P05-OIDC-01.md](P05-OIDC-01.md) | How isolated real OIDC Login V2 browser/session checks work; real CI status/limitations | P05-OIDC-01 / Run #90 BLOCKED before provisioning; cleanup PASS |
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pinned prebuilt forwarder, safe private HTTP diagnostics and actual Run #91 evidence | P05-OIDC-02 / real OIDC BLOCKED by forwarder exit 1, cleanup PASS |
| [P05-OIDC-03.md](P05-OIDC-03.md) | Same-run allowlisted socat startup evidence, immutable Python TCP fallback and real OIDC acceptance | P05-OIDC-03 / CI pending |
| [P05-OIDC-03.md](P05-OIDC-03.md) | Same-run socat classification, private Python fallback and exact Gitea status | P05-OIDC-03 / Run #93 QUEUED, no terminal result |
| [SETUP-GUIDE.md](SETUP-GUIDE.md) | Operator/developer prerequisites, configs, activation and safety | DOCS-01 / active; runtime pending |
| [FEATURES-STATUS.md](FEATURES-STATUS.md) | Exact implemented/unavailable/unverified feature matrix | DOCS-01 / active |
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Known blockers and safe diagnosis based on source status | DOCS-01 / active |
+9
View File
@@ -18,3 +18,12 @@ The manual `.gitea/workflows/p05-oidc-acceptance.yml` and original backend/Login
**Full real-browser acceptance requires one actual successful Gitea CI run** proving the private network, official disposable ZITADEL project/client/verified human provisioning, real original Login V2 password, code + PKCE S256/state/nonce and Auth.js callback, authenticated subject and protected Account pages/API, anonymous/invalid callback rejection, local logout and complete `always()` cleanup. A forwarder-only pass or a mere discovery/JWKS response cannot be called authenticated login.
**No** local application tests/builds/Docker, real users, production HTTPS, MFA/passkeys, tags or deployment. See `notes/P05-OIDC-03.md` for pre-change scope and exact actual run ledger; `project/OIDC-E2E-ARCHITECTURE.md` for source/network boundaries.
## Real execution status — Gitea Run #93 queued, not yet accepted
A single approved [Gitea Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93) was dispatched on `main` using tested source SHA `7b80f411b2981e2274d171c12596301ed757b768`. Its job #206 was still **QUEUED** at the last status inspection; **no runner steps executed and no terminal conclusion exists**.
Therefore socat startup classification, official Python digest fallback, private HTTP 200, ZITADEL project/client/human creation, real Chromium Login V2/PKCE/state/nonce/Auth.js callback, protected API/session, negative cases, and mandatory cleanup are all **NOT EXECUTED / UNVERIFIED in Run #93**. This is **not** evidence of a source regression or successful OIDC. **No second CI run** is permitted by this phase.
Next work is read-only runner scheduling/status inspection plus **terminal evidence collection from the same Run #93** once it actually executes, then strict documentation-only closure. Original Login/Account/auth/Compose and dependencies remain unchanged; `AI_INSTRUCTIONS.md` was preserved. See `notes/P05-OIDC-03.md` for exact pre-edit Scope Lock and live snapshot.
+1 -1
View File
@@ -85,7 +85,7 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
## P05-OIDC-03 — Forwarder Process Diagnosis and Real OIDC Acceptance (APPROVED 2026-11-23)
- Baseline `5f542a6aa376d06ba2c1fd3d46835baae9b8654e`. Gitea Run #91 proved 4 healthy services, private proxy Host route and prebuilt socat digest PASS, but socat exited 1; project/client/human/browser NOT EXECUTED; cleanup PASS. Actual socat stderr root cause unverified.
- Exact write scope: `tests/ci/oidc_e2e/run.sh`, optional new `forwarder.py` because Run #91 proved socat unreliable; `provision.py` / `cleanup.sh` ONLY if a separately reproduced narrow defect; `notes/**`, `project/**`, relevant `docs/**` and associated README/MINIFEST navigation. Original backend/Compose, Login V2, Account Portal, browser scripts, manifests/lockfiles and production READ-ONLY. Preserve untracked `AI_INSTRUCTIONS.md`.
- Single CI-only run plan: start pinned socat for safe error classification before credentials; only if unhealthy, remove its run-labeled container and use official `python:3.12-alpine` resolved immutable digest, copying a transparent 127.0.0.1:8080 → 127.0.0.1:80 stdlib relay; fail closed on forwarded HTTP/Host readiness. Continue unchanged official provisioning, original Chromium password/PKCE/state/nonce/Auth.js callback/session/negative tests and mandatory owned cleanup. **ONE manual Gitea cycle, no local tests or production deployment; real PASS only on actual browser & cleanup evidence.** `notes/P05-OIDC-03.md`, `docs/P05-OIDC-03.md`.
- **Actual dispatch:** one manual Gitea Run #93, tested SHA `7b80f411b2981e2274d171c12596301ed757b768`, job #206 **QUEUED at last inspection**, no job start, no steps/cleanup and no conclusion. Nothing authenticated verified yet. Source prepared with allowlisted socat startup error classification and one same-run immutable official Python TCP fallback; original provisioning/Chromium/PKCE/state/nonce/Account and cleanup untouched. **No second dispatch**, local app tests or production deployment. Read-only terminal evidence from this same run must determine PASS/FAIL. `notes/P05-OIDC-03.md`, `docs/P05-OIDC-03.md`.
## P05 - Full Integration (proposed, NOT approved)
Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval.
+1 -1
View File
@@ -17,6 +17,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
| 2026-11-22 | P05-SEC-02-A01 | One-run final acceptance of corrected CI parser and unchanged Login lockfile/seven overrides | **Run #89 SUCCESS** on `ff4c58e`: frozen install, standalone build and upstream 1219/1219 tests PASS; audit 0 Moderate/High/Critical; Account jobs skipped. [Evidence](P05-SEC-02-A01.md) |
| 2026-11-22 | P05-OIDC-01 | CI-only official ZITADEL OIDC project/client/user and Chromium original Login V2/Auth.js acceptance harness with owned cleanup | **Run #90 FAILED**: 4 services healthy, no host ports; private localhost:8080 forwarder not ready, no user/client/browser created; cleanup VERIFIED PASS. [Evidence](P05-OIDC-01.md) |
| 2026-11-22 | P05-OIDC-02 | Prebuilt/digest-verified socat, private proxy/Host/sidecar state probes, status-only readiness | **Run #91 FAILURE**: backend and private Host routing PASS; forwarder exited code 1, no provisioning/browser; owned cleanup PASS. [Evidence](P05-OIDC-02.md) |
| 2026-11-23 | P05-OIDC-03 | Safe socat exit diagnostics and one digest-pinned Python stdlib private TCP fallback within the same disposable Gitea cycle | Exact [pre-edit scope/evidence](P05-OIDC-03.md), CI pending |
| 2026-11-23 | P05-OIDC-03 | Safe socat exit diagnostics and one digest-pinned Python stdlib private TCP fallback within same disposable Gitea cycle | Source pushed; single Gitea Run #93 dispatched on `7b80f41`, **QUEUED**, no steps/cleanup executed; [evidence](P05-OIDC-03.md), acceptance pending |
Rules: Append new phases or fixes; never silently rewrite a past result. Separate **implemented**, **verified**, **blocked**, and **proposed**. Never log a user secret or personal data.
+1 -1
View File
@@ -13,7 +13,7 @@
| [P05-SEC-02-A01.md](P05-SEC-02-A01.md) | Single-run Login-only final frozen/build/unit/security acceptance, scope lock and evidence | P05-SEC-02-A01 / Run #89 SUCCESS, accepted |
| [P05-OIDC-01.md](P05-OIDC-01.md) | Pre-change real browser OIDC Scope Lock, provision/redirect/session/negative tests and one CI run evidence | P05-OIDC-01 / Run #90 FAILED at forwarder readiness; cleanup PASS; acceptance BLOCKED |
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pre-change loopback-forwarder scope, pinned digest/preflight fix and one real Gitea acceptance cycle | P05-OIDC-02 / Run #91: private proxy PASS; socat exit 1, OIDC BLOCKED, cleanup PASS |
| [P05-OIDC-03.md](P05-OIDC-03.md) | Pre-edit scoped socat exit diagnosis, immutable Python loopback fallback and one real browser CI evidence | P05-OIDC-03 / source prepared, one CI pending |
| [P05-OIDC-03.md](P05-OIDC-03.md) | Pre-edit socat diagnosis, Python fallback and one focused Gitea Run #93 evidence | P05-OIDC-03 / Run #93 QUEUED, no steps executed, acceptance UNVERIFIED |
| [CHANGELOG.md](CHANGELOG.md) | Short append-only chronological phase log and links to detailed reports | DOCS-01 / active |
Update this manifest whenever any direct child file or directory changes. Use **actual source state**; a planned file must be labeled planned, not present.
+11
View File
@@ -41,3 +41,14 @@
- Authentication and cleanup gates remain fail-closed and unmodified. No CI success assumption before real completion.
**Acceptance:** proxy/forwarder readiness + official disposable client/human + real original Login V2 password/PKCE/state/nonce/Auth.js callback + actual protected identity/negative/logout + always verified owned cleanup + no unauthorized source changes. MFA/passkeys, production HTTPS and full Admin Console user flow remain outside this phase.
## Execution-status snapshot — single Gitea Run #93, 2026-11-23 Asia/Dhaka
**Dispatched exactly once:** [Gitea Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93), one `workflow_dispatch` on `main`, requested at `2026-11-22T18:08:45Z`. **Test candidate SHA `7b80f411b2981e2274d171c12596301ed757b768`**. Intended single job **#206**, `Disposable ZITADEL Client User Browser OIDC and Cleanup`.
**Last queried run status in this phase: `queued` (no job start timestamp, no steps, no conclusion).** This is **NOT A TERMINAL CI RESULT**. No Docker preflight, socat error classification, Python fallback, OIDC project/client/user provisioning, browser callback, negative session checks or `always()` cleanup has executed in Run #93 yet. **Do not claim any step PASS, FAIL or cleanup for Run #93.** There was no second dispatch, rerun, cancellation, extra source patch, local build/test, live account or production deployment.
**Acceptance verdict at snapshot:** **PENDING RUNNER EXECUTION / NOT VERIFIED**, not SUCCESS or failure of the proposed fix. Run #91 remains the last terminal evidence, socat process exited 1 and owned cleanup PASS. The newly committed source needs the eventual **Run #93 terminal job + cleanup evidence**, not a new Gitea run. If Run #93 remains unstarted, runner scheduling/availability must be inspected read-only; do not guess an outage. If it completes later, verify the real job logs, tested SHA, whether socat error class/fallback/private HTTP 200 and actual client/user/browser/negative/cleanup gates executed before declaring acceptance.
**No repeated CI loops:** This phase dispatched one run only. Any follow-up is a read-only verification of the existing Run #93 and documentation sync, not a second workflow dispatch. The pending result-only documentation commit does not alter tested application/CI source.
+1 -1
View File
@@ -17,7 +17,7 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
| 2026-11-22 | P05-SEC-02-A01 | Verify existing corrected helper, exact seven PNPM scoped overrides, frozen Login Nx build and upstream Vitest; no source/lock changes | **Gitea Run #89 SUCCESS** on `ff4c58e`, 84/84 files, 1219/1219 tests, Login audit 0 Moderate/High/Critical; `notes/P05-SEC-02-A01.md` |
| 2026-11-22 | P05-OIDC-01 | Added manual disposable IAM_OWNER/client/human/browser OIDC acceptance harness, secret isolation and cleanup | Run #90 FAIL before provisioning: private loopback forwarder unready; 4 backend services healthy, owned cleanup PASS. `notes/P05-OIDC-01.md` |
| 2026-11-22 | P05-OIDC-02 | CI-only prebuilt socat digest startup, private proxy/Host/readiness/exit checks and status-only provisioner | **Run #91 FAILED**: 4 services + private proxy PASS, sidecar exit code 1; no real user/browser test; cleanup PASS. `notes/P05-OIDC-02.md` |
| 2026-11-23 | P05-OIDC-03 | Redacted socat startup diagnosis and strictly private/digest-pinned official Python stdlib fallback | Source prepared; one disposable CI pending. `notes/P05-OIDC-03.md` |
| 2026-11-23 | P05-OIDC-03 | Allowlisted socat startup diagnostics and strictly private digest-pinned official Python stdlib fallback | Source `7b80f41` on Gitea; Run #93 QUEUED, no CI steps or terminal result. `notes/P05-OIDC-03.md` |
## Required entry for each future change
+3
View File
@@ -145,3 +145,6 @@ New source in `tests/ci/oidc_e2e/run.sh`: test namespace-local Traefik proxy Hos
**P05-OIDC-03 approved CI-only source:** The existing manual workflow is unchanged. Run #91's verified socat exit 1 justifies a single-run diagnostic attempt plus a one-time deterministic, digest-pinned `python:3.12-alpine` stdlib private forwarder fallback. Only run-labeled containers, 127.0.0.1:8080 → private Traefik:80, bounded error-class diagnostics and original proxy Host HTTP 200 gate are permitted. The diagnostic/fallback happens before real provisioning; no authentication, browser or cleanup source changed. A new single Gitea run must prove all real client/user/browser/callback/session and mandatory owned cleanup checks or remain BLOCKED.
**P05-OIDC-03 queued CI evidence:** The only approved Gitea Run #93 (source `7b80f411b2981e2274d171c12596301ed757b768`) was still **QUEUED** at last inspection; job #206 has not started, so neither the socat diagnostic/Python fallback nor the browser/provisioning/cleanup ran. Do not mark technical failure/success; **runner scheduling is a pending dependency**, not a proven outage. Source audit passed, and no second dispatch occurred. Follow-up should examine **the same Run #93** terminal steps/actual cleanup and update docs, not rerun prior suites.
+1 -1
View File
@@ -1,6 +1,6 @@
# ZitPlane ? exact tracked source inventory
**Snapshot:** 2026-11-23, P05-OIDC-03 focused source candidate on approved baseline `5f542a6`. Run #91 socat startup exited 1 and real browser acceptance is **NOT YET VERIFIED**.
**Snapshot:** 2026-11-23, P05-OIDC-03 code at tested candidate SHA `7b80f411b2981e2274d171c12596301ed757b768`; one Gitea Run #93 dispatched but **QUEUED at last inspection**, no job steps executed. Real browser acceptance **NOT VERIFIED**; result-only docs commit does not alter tested CI code.
**Git-tracked paths: 751.** Untracked `AI_INSTRUCTIONS.md` and local secrets excluded.