diff --git a/.gitea/workflows/README.md b/.gitea/workflows/README.md index 5c71dd6..3a41f16 100644 --- a/.gitea/workflows/README.md +++ b/.gitea/workflows/README.md @@ -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. diff --git a/README.md b/README.md index f677c65..4e72acc 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docs/FEATURES-STATUS.md b/docs/FEATURES-STATUS.md index 1b3f4e0..e12930c 100644 --- a/docs/FEATURES-STATUS.md +++ b/docs/FEATURES-STATUS.md @@ -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. diff --git a/docs/MINIFEST.md b/docs/MINIFEST.md index f519d7f..64b15c4 100644 --- a/docs/MINIFEST.md +++ b/docs/MINIFEST.md @@ -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 | diff --git a/docs/P05-OIDC-03.md b/docs/P05-OIDC-03.md index 0e0643a..2e5dd6e 100644 --- a/docs/P05-OIDC-03.md +++ b/docs/P05-OIDC-03.md @@ -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. diff --git a/docs/PHASES.md b/docs/PHASES.md index d5c2ff2..d29f549 100644 --- a/docs/PHASES.md +++ b/docs/PHASES.md @@ -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. diff --git a/notes/CHANGELOG.md b/notes/CHANGELOG.md index 8007954..b3f08e7 100644 --- a/notes/CHANGELOG.md +++ b/notes/CHANGELOG.md @@ -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. diff --git a/notes/MINIFEST.md b/notes/MINIFEST.md index 53640c3..322ceb2 100644 --- a/notes/MINIFEST.md +++ b/notes/MINIFEST.md @@ -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. diff --git a/notes/P05-OIDC-03.md b/notes/P05-OIDC-03.md index e92224c..90cf382 100644 --- a/notes/P05-OIDC-03.md +++ b/notes/P05-OIDC-03.md @@ -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. diff --git a/project/CHANGELOG.md b/project/CHANGELOG.md index 64e7818..62d3f10 100644 --- a/project/CHANGELOG.md +++ b/project/CHANGELOG.md @@ -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 diff --git a/project/CI-ARCHITECTURE.md b/project/CI-ARCHITECTURE.md index 72c613f..832bb38 100644 --- a/project/CI-ARCHITECTURE.md +++ b/project/CI-ARCHITECTURE.md @@ -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. diff --git a/project/SOURCE-INVENTORY.md b/project/SOURCE-INVENTORY.md index fbfe73d..0fff4c2 100644 --- a/project/SOURCE-INVENTORY.md +++ b/project/SOURCE-INVENTORY.md @@ -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.