ci: record P05 run 81 and prepare Alpine checkout remediation

This commit is contained in:
victorsteele428 committed 2026-11-22 13:09:43 +00:00
1 parent 42b79362c1
commit 42adaba004
13 files changed
+90 -39

No files matched your search

+4 -2
View File
@@ -1,4 +1,4 @@
# CI workflows — manual verification only # CI workflows - manual verification only
P05-CI-01 introduces a single `p05-ci.yml` with **manual workflow_dispatch**. Do not enable automatic push/PR builds with Docker access without a fresh security review. P05-CI-01 introduces a single `p05-ci.yml` with **manual workflow_dispatch**. Do not enable automatic push/PR builds with Docker access without a fresh security review.
@@ -6,7 +6,9 @@ Job responsibilities:
1. `account`: reproducible Account Portal `npm ci`, TypeScript, Next.js production build and dependency advisory check. 1. `account`: reproducible Account Portal `npm ci`, TypeScript, Next.js production build and dependency advisory check.
2. `login`: pinned pnpm workspace frozen install, proto/client/Login build and upstream unit checks. 2. `login`: pinned pnpm workspace frozen install, proto/client/Login build and upstream unit checks.
3. `backend`: Docker daemon preflight, disposable local-only P02 ZITADEL Compose, ready/discovery/JWKS smoke and safe cleanup. **Full interactive OIDC login is NOT certified.** 3. `backend`: install Git before Alpine `checkout`, Docker daemon preflight, disposable local-only P02 ZITADEL Compose, ready/discovery/JWKS smoke and safe cleanup. **Full interactive OIDC login is NOT certified.**
**Run #81 evidence:** backend's first revision failed during checkout because Alpine had no Git. Added a pre-checkout Git installation afterward; the corrected backend job remains **UNVERIFIED** until a separately approved CI rerun. See `docs/P05-CI-01.md`.
A green job indicates only its executed steps. Full CI acceptance also needs end-to-end OIDC session/callback, real login/MFA, admin console and session controls in a disposable environment, documented separately. A green job indicates only its executed steps. Full CI acceptance also needs end-to-end OIDC session/callback, real login/MFA, admin console and session controls in a disposable environment, documented separately.
+4
View File
@@ -103,6 +103,10 @@ jobs:
container: node:22-alpine container: node:22-alpine
timeout-minutes: 35 timeout-minutes: 35
steps: steps:
# Alpine does not include Git. Checkout's API-archive fallback is not
# reliable on Gitea; install Git before invoking actions/checkout.
- name: Install Git before checkout (Alpine runner prerequisite)
run: apk add --no-cache git
- uses: actions/checkout@v4 - uses: actions/checkout@v4
with: with:
github-server-url: https://dev.ivib.cc github-server-url: https://dev.ivib.cc
+1 -1
View File
@@ -7,7 +7,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
- **P02 ZITADEL local backend:** pinned official images, development Compose and secure local bootstrap helper source prepared. **Docker startup and Admin Console integration remain unverified**; all follow-up local testing is explicitly deferred to a future Gitea Actions scope. - **P02 ZITADEL local backend:** pinned official images, development Compose and secure local bootstrap helper source prepared. **Docker startup and Admin Console integration remain unverified**; all follow-up local testing is explicitly deferred to a future Gitea Actions scope.
- **P03 Login V2 source:** official v4.20.4 source and matching client/proto workspace imported under `auth/ui/v2/`; no redesign or runtime build/test was performed. **CI validation remains pending.** - **P03 Login V2 source:** official v4.20.4 source and matching client/proto workspace imported under `auth/ui/v2/`; no redesign or runtime build/test was performed. **CI validation remains pending.**
- **P04 Account Portal:** Next.js + ZITADEL OIDC Auth.js source, server-protected overview/profile/security pages and compact responsive foundation implemented under `users/ui/`. **No build/test/runtime validation yet; future Gitea Actions required.** - **P04 Account Portal:** Next.js + ZITADEL OIDC Auth.js source, server-protected overview/profile/security pages and compact responsive foundation implemented under `users/ui/`. **No build/test/runtime validation yet; future Gitea Actions required.**
- **P05-CI-01:** Gitea Actions manual verification workflow prepared (Account, Login V2, dependency security, disposable Docker). Acceptance results pending; interactive OIDC E2E remains a separate gate. - **P05-CI-01:** Manual Gitea Run #81 completed **overall FAILURE**: Login V2 build + 1219 unit tests PASS, security high/critical gate PASS (18 moderate findings unresolved), Account Auth.js typecheck FAIL, and Docker job checkout FAIL before backend startup. In-scope Git checkout prerequisite was fixed afterward without a rerun. Full acceptance/interactive OIDC E2E remains pending; see `docs/P05-CI-01.md`.
- **Production / Coolify:** not configured or deployed. - **Production / Coolify:** not configured or deployed.
## Documentation and project knowledge ## Documentation and project knowledge
+5 -5
View File
@@ -1,4 +1,4 @@
# ZitPlane — Actual feature availability / limitations # ZitPlane - Actual feature availability / limitations
Snapshot: 2026-11-22, P05-CI-01 source preparation based on baseline `7ecf531`. **SOURCE EXISTS != RUNNING != VERIFIED != PRODUCTION**. Snapshot: 2026-11-22, P05-CI-01 source preparation based on baseline `7ecf531`. **SOURCE EXISTS != RUNNING != VERIFIED != PRODUCTION**.
@@ -7,8 +7,8 @@ Snapshot: 2026-11-22, P05-CI-01 source preparation based on baseline `7ecf531`.
| Official ZITADEL Go backend image configuration | Yes, P02 | No | No | | Official ZITADEL Go backend image configuration | Yes, P02 | No | No |
| Local PostgreSQL and loopback Traefik stack | Yes, P02 | No | No | | Local PostgreSQL and loopback Traefik stack | Yes, P02 | No | No |
| Official prebuilt Login V2 service in local Compose | Yes, P02 configuration | No | No | | Official prebuilt Login V2 service in local Compose | Yes, P02 configuration | No | No |
| Official Login V2 customisable source | Yes, P03 v4.20.4 | No | No | | Official Login V2 customisable source | Yes, P03 v4.20.4 | Run #81 build + 1219/1219 unit tests PASS; integration not verified | No |
| Login V2 signup/password/OTP/MFA/passkey/IDP source routes | Present upstream | No | No | | Login V2 signup/password/OTP/MFA/passkey/IDP source routes | Present upstream | Run #81 unit suite PASS; real account flows NOT tested | No |
| Custom Account Portal Next.js app | Yes, P04 | No | No | | Custom Account Portal Next.js app | Yes, P04 | No | No |
| Portal login OIDC and Auth.js callbacks | Yes, P04 source | No | No | | Portal login OIDC and Auth.js callbacks | Yes, P04 source | No | No |
| Portal Overview / Profile / Security pages | Yes, P04 | No | No | | Portal Overview / Profile / Security pages | Yes, P04 | No | No |
@@ -17,8 +17,8 @@ Snapshot: 2026-11-22, P05-CI-01 source preparation based on baseline `7ecf531`.
| Mutable profile editing / device sessions / identity deletion | No | N/A | No | | Mutable profile editing / device sessions / identity deletion | No | N/A | No |
| Global ZITADEL SSO logout | No | N/A | No | | Global ZITADEL SSO logout | No | N/A | No |
| Subscriptions, payments and SaaS billing | Outside ZitPlane scope | N/A | No | | Subscriptions, payments and SaaS billing | Outside ZitPlane scope | N/A | No |
| Gitea Actions CI verification workflow | P05 source added, manual dispatch | Not yet verified | Not deployed | | Gitea Actions CI verification workflow | Yes, P05 manual dispatch | Run #81 completed: 2 PASS / 2 FAIL; overall FAILURE | Not deployed |
| Gitea Actions CI and isolated integration tests | Verification scripts prepared; full OIDC E2E absent | Pending | No | | Gitea Actions CI and isolated integration tests | Verification scripts prepared; full OIDC E2E absent | Run #81 backend checkout failed; runtime acceptance BLOCKED | No |
| Coolify production stack, TLS, routing and backups | No | No | No | | Coolify production stack, TLS, routing and backups | No | No | No |
| Public `auth.vib.tools/login` URL | Proposed only | No | No | | Public `auth.vib.tools/login` URL | Proposed only | No | No |
| Public `account.vib.tools` account website | Proposed only | No | No | | Public `account.vib.tools` account website | Proposed only | No | No |
+1 -1
View File
@@ -7,7 +7,7 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
| [README.md](README.md) | Documentation responsibilities, audience, navigation and change rules | DOCS-01 / active | | [README.md](README.md) | Documentation responsibilities, audience, navigation and change rules | DOCS-01 / active |
| [MINIFEST.md](MINIFEST.md) | Direct-file manifest and phase ownership | DOCS-01 / active | | [MINIFEST.md](MINIFEST.md) | Direct-file manifest and phase ownership | DOCS-01 / active |
| [USER-GUIDE.md](USER-GUIDE.md) | Source-grounded Account Portal page/button-by-button manual | DOCS-01 / active; runtime pending | | [USER-GUIDE.md](USER-GUIDE.md) | Source-grounded Account Portal page/button-by-button manual | DOCS-01 / active; runtime pending |
| [P05-CI-01.md](P05-CI-01.md) | Gitea Actions manual verification workflow, gates, limitations and real run evidence | P05-CI-01 / awaiting CI | | [P05-CI-01.md](P05-CI-01.md) | Gitea Actions manual verification workflow, gates, limitations and real run evidence | P05-CI-01 / Run #81 complete, acceptance blocked |
| [SETUP-GUIDE.md](SETUP-GUIDE.md) | Operator/developer prerequisites, configs, activation and safety | DOCS-01 / active; runtime pending | | [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 | | [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 | | [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Known blockers and safe diagnosis based on source status | DOCS-01 / active |
+17 -8
View File
@@ -1,8 +1,8 @@
# P05-CI-01 — Gitea Actions verification # P05-CI-01 - Gitea Actions verification
Date: 2026-11-22 Date: 2026-11-22
Source baseline: `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` Source baseline: `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1`
State: **WORKFLOW SOURCE PREPARED; DISPATCH/RESULTS PENDING**. State: **SOURCE IMPLEMENTED; GITEA RUN #81 FINISHED (OVERALL FAILURE, 2 PASS / 2 FAIL).** Checkout prerequisite source corrected after Run #81 without rerunning; corrected source remains unverified.
## How to run ## How to run
@@ -12,10 +12,10 @@ No local PC tests, builds, Docker or dev servers are performed by this phase. Th
## Gates ## Gates
- **account** — Account Portal pinned npm lock, dependency installation, TypeScript and Next.js production build. - **account** - Account Portal pinned npm lock, dependency installation, TypeScript and Next.js production build.
- **login** — upstream source's pinned pnpm frozen workspace install, Nx proto/client/Login V2 build and upstream Login unit suite. - **login** - upstream source's pinned pnpm frozen workspace install, Nx proto/client/Login V2 build and upstream Login unit suite.
- **security** — npm/pnpm production advisory triage; HIGH/CRITICAL advisories fail the gate. - **security** - npm/pnpm production advisory triage; HIGH/CRITICAL advisories fail the gate.
- **backend** — disposable Docker preflight, P02 Python helper contracts, ZITADEL/PostgreSQL/prebuilt Login/Traefik stack and OIDC discovery/JWKS, then cleanup. - **backend** - disposable Docker preflight, P02 Python helper contracts, ZITADEL/PostgreSQL/prebuilt Login/Traefik stack and OIDC discovery/JWKS, then cleanup.
**Not proved even by all four jobs passing:** complete interactive Account Portal OIDC callback/session, new user signup/MFA/passkeys, Admin Console login, global logout, production host/TLS/routing. These need a separate explicitly approved and fully disposable end-to-end integration test phase. **Not proved even by all four jobs passing:** complete interactive Account Portal OIDC callback/session, new user signup/MFA/passkeys, Admin Console login, global logout, production host/TLS/routing. These need a separate explicitly approved and fully disposable end-to-end integration test phase.
@@ -23,8 +23,17 @@ No local PC tests, builds, Docker or dev servers are performed by this phase. Th
Runner creates ephemeral secrets only. No production credentials or live user data. CI refuses to touch an existing Docker network with the fixed P02 name. Always cleanup is configured; if the runner itself crashes, disposable resources may require operator cleanup **after confirming exact project ownership**. No push/PR trigger, publish, release or deploy. Runner creates ephemeral secrets only. No production credentials or live user data. CI refuses to touch an existing Docker network with the fixed P02 name. Always cleanup is configured; if the runner itself crashes, disposable resources may require operator cleanup **after confirming exact project ownership**. No push/PR trigger, publish, release or deploy.
## Results ## Gitea verification results - ONE focused cycle
**No results have been verified at documentation creation time.** Fill with actual Gitea run ID, SHA, individual gate results and exact failures; do not infer PASS from static source or use historical runs from other repositories as ZitPlane acceptance. - **Run:** [#81](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/81), `workflow_dispatch` on `main`, SHA `42b79362c13b9dbb07f85a58ad278742d91b1f5b`. **Overall conclusion: FAILURE** (2026-11-22).
- **Account job #165: FAILED.** Checkout and three source/lock/OIDC-guard structural checks PASS; `npm ci` installed 38 packages. Then `npm run typecheck` failed at `users/ui/src/auth.ts(14,61)`, TypeScript `TS2345`, because inferred `session.user.id` callback return type is not assignable to the required `string` session identity type. Next production build was **NOT RUN**. This authentication-code fix is **outside P05 write scope**.
- **Login job #166: PASS.** Pinned pnpm `10.30.3` frozen install PASS; Nx proto/client/Login production build/standalone artifact PASS; Vitest **84/84 files, 1219/1219 tests PASS**.
- **Security job #167: PASS at high/critical threshold only.** Account npm audit and Login production pnpm audit completed successfully at severity `high`; however Login audit also reports **18 MODERATE vulnerabilities** without package-level triage in the current workflow. Those remain OPEN and require a separately reviewed advisory report.
- **Backend job #168: FAILED before tests.** `node:22-alpine` lacks Git before `actions/checkout@v4`. Action attempted Gitea REST-archive fallback, returned repeated `Not found`; Docker preflight, live backend, OIDC/JWKS smoke and persistence were **NOT EXECUTED**. Always-cleanup step PASS. The workflow source was minimally corrected **after the failed run** with a pre-checkout `apk add --no-cache git`; it has **not** been CI-verified.
- **No second CI run, local build or local application test** was executed.
**Acceptance verdict:** P05 CI foundation source exists and two CI jobs passed, but **FULL PHASE ACCEPTANCE BLOCKED** by Account TypeScript defect, missing Docker runtime verification, absent real user OIDC E2E, and 18 moderate advisory findings. No Coolify/prod deployment.
Read `notes/P05-CI-01.md` for scope and next-phase defect separation. Do not interpret a green Login test job as the complete central authentication platform being production-ready.
Developer map: `project/CI-ARCHITECTURE.md`. Phase notes and root-cause evidence: `notes/P05-CI-01.md`. Developer map: `project/CI-ARCHITECTURE.md`. Phase notes and root-cause evidence: `notes/P05-CI-01.md`.
+9 -9
View File
@@ -2,11 +2,11 @@
Implement one explicitly approved phase at a time. Keep out-of-scope files, existing authentication machinery and production systems unchanged. Implement one explicitly approved phase at a time. Keep out-of-scope files, existing authentication machinery and production systems unchanged.
## P01 — Foundation (COMPLETE) ## P01 - Foundation (COMPLETE)
- Baseline commit `8f54ccb30426f2955472c0cd40fb94d0b18e86ac`. - Baseline commit `8f54ccb30426f2955472c0cd40fb94d0b18e86ac`.
- Initial monorepo folder structure, docs, project Git identity and clean commit completed. - Initial monorepo folder structure, docs, project Git identity and clean commit completed.
## P02 — ZITADEL local backend (APPROVED 2026-11-22) ## P02 - ZITADEL local backend (APPROVED 2026-11-22)
- **Allowed source writes:** `core/backend/zitadel/**`, `deployment/docker/compose.backend.dev.yaml`, `.env.example`, backend-focused `tests/**`, and narrow `docs/**` / `README.md`. - **Allowed source writes:** `core/backend/zitadel/**`, `deployment/docker/compose.backend.dev.yaml`, `.env.example`, backend-focused `tests/**`, and narrow `docs/**` / `README.md`.
- Official versioned ZITADEL v4 backend image, local PostgreSQL persistence, secure random dev secret generation, first-admin bootstrap and health checks. - Official versioned ZITADEL v4 backend image, local PostgreSQL persistence, secure random dev secret generation, first-admin bootstrap and health checks.
- Official prebuilt Login V2 image as a **runtime dependency only** (v4 Admin Console login requires it); no Login V2 source import. - Official prebuilt Login V2 image as a **runtime dependency only** (v4 Admin Console login requires it); no Login V2 source import.
@@ -16,7 +16,7 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
- **P02-RUNTIME-ACCEPTANCE-01 instruction update (2026-11-22):** user explicitly deferred all local test/dev execution to a future Gitea Actions phase; this is a source handoff, **not** runtime acceptance. Existing source is committed; authorized push to `vibtools/ZitPlane` is in scope. CI workflow creation and UI import remain outside P02. - **P02-RUNTIME-ACCEPTANCE-01 instruction update (2026-11-22):** user explicitly deferred all local test/dev execution to a future Gitea Actions phase; this is a source handoff, **not** runtime acceptance. Existing source is committed; authorized push to `vibtools/ZitPlane` is in scope. CI workflow creation and UI import remain outside P02.
- Existing unrelated untracked `AI_INSTRUCTIONS.md` must remain untouched. - Existing unrelated untracked `AI_INSTRUCTIONS.md` must remain untouched.
## P03 — Official Login V2 source import (APPROVED 2026-11-22; SOURCE IMPLEMENTED) ## P03 - Official Login V2 source import (APPROVED 2026-11-22; SOURCE IMPLEMENTED)
- **Baseline:** `eadd0e558b459061e48583192badfc0579e95140`. - **Baseline:** `eadd0e558b459061e48583192badfc0579e95140`.
- **Write Scope:** `auth/ui/v2/**` (Login V2 and required upstream workspace files), narrow `README.md` and `docs/**` (P03 source/phase notes). No other files. - **Write Scope:** `auth/ui/v2/**` (Login V2 and required upstream workspace files), narrow `README.md` and `docs/**` (P03 source/phase notes). No other files.
- **Upstream tag:** `v4.20.4` at `384bb9ec96b501ad39dc232ee2061a40fe180bbd`, matching P02 Go backend image. - **Upstream tag:** `v4.20.4` at `384bb9ec96b501ad39dc232ee2061a40fe180bbd`, matching P02 Go backend image.
@@ -25,7 +25,7 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
- P02 prebuilt Login UI remains configured in the development Compose; do **not** replace it or call runtime acceptance complete. - P02 prebuilt Login UI remains configured in the development Compose; do **not** replace it or call runtime acceptance complete.
- Evidence and known gaps: `docs/P03-SOURCE-IMPORT.md`. CI workflow not part of this scope. - Evidence and known gaps: `docs/P03-SOURCE-IMPORT.md`. CI workflow not part of this scope.
## P04 — User Account Portal foundation (APPROVED 2026-11-22; SOURCE IMPLEMENTED) ## P04 - User Account Portal foundation (APPROVED 2026-11-22; SOURCE IMPLEMENTED)
- **Baseline:** `4404849fc4bd30c7b4b7cabe7caed54cbd7cd37d`. - **Baseline:** `4404849fc4bd30c7b4b7cabe7caed54cbd7cd37d`.
- **Exact Write Scope:** `users/ui/**`, narrow project `README.md` and relevant `docs/**` (phase/evidence/architecture/developer guide). **P02/P03 source read-only.** - **Exact Write Scope:** `users/ui/**`, narrow project `README.md` and relevant `docs/**` (phase/evidence/architecture/developer guide). **P02/P03 source read-only.**
- Separate compact Next.js portal, ZITADEL OIDC/PKCE authentication, server-protected user routes, read-only profile and security settings structure. - Separate compact Next.js portal, ZITADEL OIDC/PKCE authentication, server-protected user routes, read-only profile and security settings structure.
@@ -33,18 +33,18 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
- Explicitly **no local builds, tests, dev server, Docker or deployment**. Source-level audit only, Git commit and approved Gitea main push. Gitea Actions testing deferred; no CI workflow in this scope. - Explicitly **no local builds, tests, dev server, Docker or deployment**. Source-level audit only, Git commit and approved Gitea main push. Gitea Actions testing deferred; no CI workflow in this scope.
- Evidence and pending runtime acceptance: `docs/P04-ACCOUNT-PORTAL.md`. - Evidence and pending runtime acceptance: `docs/P04-ACCOUNT-PORTAL.md`.
## P05-CI-01 — Gitea Actions Verification Foundation (APPROVED 2026-11-22) ## P05-CI-01 - Gitea Actions Verification Foundation (APPROVED 2026-11-22)
- Baseline `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1`. - Baseline `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1`.
- Approved paths `.gitea/**`, `tests/ci/**`, narrow `users/ui/package.json` and lockfile, `auth/ui/v2/pnpm-workspace.yaml` and lockfile, `notes/**`, `project/**`, relevant `docs/**` and `README.md`; root `MINIFEST.md` is a documentation-maintenance exception. Backend/Account auth/UI source READ-ONLY. - Approved paths `.gitea/**`, `tests/ci/**`, narrow `users/ui/package.json` and lockfile, `auth/ui/v2/pnpm-workspace.yaml` and lockfile, `notes/**`, `project/**`, relevant `docs/**` and `README.md`; root `MINIFEST.md` is a documentation-maintenance exception. Backend/Account auth/UI source READ-ONLY.
- Manual Gitea workflow: account reproducible build, Login frozen build, dependency audit, disposable Docker backend readiness/discovery. **No local tests/build/dev server.** - Manual Gitea workflow: account reproducible build, Login frozen build, dependency audit, disposable Docker backend readiness/discovery. **No local tests/build/dev server.**
- Full OIDC login/session/MFA/Admin Console interactive acceptance is not covered without disposable app/user provisioning; status remains BLOCKED/PENDING, not fabricated PASS. - Full OIDC login/session/MFA/Admin Console interactive acceptance is not covered without disposable app/user provisioning; status remains BLOCKED/PENDING, not fabricated PASS.
- Run evidence: `notes/P05-CI-01.md` and `docs/P05-CI-01.md`. No production deployment/release. - **Gitea Run #81:** 2 PASS (Login V2 frozen build + 1219/1219 unit tests; high/critical audit) and 2 FAIL (Account Auth.js TypeScript TS2345; Docker Alpine checkout missing Git). 18 moderate advisories unresolved. Pre-checkout Git source fix applied *after* the run, not rerun. See `notes/P05-CI-01.md` and `docs/P05-CI-01.md`. No production deployment/release.
## P05 — Full Integration (proposed, NOT approved) ## P05 - Full Integration (proposed, NOT approved)
Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval. Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval.
## P06 — UI redesign (proposed, NOT approved) ## P06 - UI redesign (proposed, NOT approved)
Compact login and account UI, accessibility, responsive design and scoped regressions. Protected authentication semantics unchanged. Compact login and account UI, accessibility, responsive design and scoped regressions. Protected authentication semantics unchanged.
## P07 — Production deployment (proposed, NOT approved) ## P07 - Production deployment (proposed, NOT approved)
Coolify, HTTPS, secrets, backups, durable storage and focused production readiness; explicit approval required. Coolify, HTTPS, secrets, backups, durable storage and focused production readiness; explicit approval required.
+1 -1
View File
@@ -9,6 +9,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
| 2026-11-22 | P03 | Imported Login V2 v4.20.4 matching upstream source/workspace | `4404849`; source blob audit, CI deferred | | 2026-11-22 | P03 | Imported Login V2 v4.20.4 matching upstream source/workspace | `4404849`; source blob audit, CI deferred |
| 2026-11-22 | P04 | Account Portal OIDC and protected frontend foundation | `40af500`; patch/scope audit, CI deferred | | 2026-11-22 | P04 | Account Portal OIDC and protected frontend foundation | `40af500`; patch/scope audit, CI deferred |
| 2026-11-22 | DOCS-01 | Knowledge folders, first-party file/function maps, exact source inventory, user guides and mandatory AGENTS documentation policy | Documentation implementation complete; focused manifest/link/scope audit PASS; Git SHA in DOCS-01 local commit, see [DOCS-01.md](DOCS-01.md) | | 2026-11-22 | DOCS-01 | Knowledge folders, first-party file/function maps, exact source inventory, user guides and mandatory AGENTS documentation policy | Documentation implementation complete; focused manifest/link/scope audit PASS; Git SHA in DOCS-01 local commit, see [DOCS-01.md](DOCS-01.md) |
| 2026-11-22 | P05-CI-01 | Gitea Actions verification workflow, package lock reconciliation, isolated Docker smoke | In progress; results in [P05-CI-01.md](P05-CI-01.md) | | 2026-11-22 | P05-CI-01 | Gitea verification workflow, dependency lock reconciliation, narrow checkout remediation | Run #81: 2 PASS/2 FAIL; 1219 Login tests PASS, Account TS2345 and Docker checkout blocked; see [P05-CI-01.md](P05-CI-01.md) |
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. 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
@@ -5,7 +5,7 @@
| [README.md](README.md) | Rules for developer planning, ongoing notes, verification evidence and phase history | DOCS-01 / active | | [README.md](README.md) | Rules for developer planning, ongoing notes, verification evidence and phase history | DOCS-01 / active |
| [MINIFEST.md](MINIFEST.md) | File list and ownership; **MINIFEST is the exact required filename** | DOCS-01 / active | | [MINIFEST.md](MINIFEST.md) | File list and ownership; **MINIFEST is the exact required filename** | DOCS-01 / active |
| [DOCS-01.md](DOCS-01.md) | This documentation-governance change: baseline, scope, plan, implementation and closure | DOCS-01 / implementation complete | | [DOCS-01.md](DOCS-01.md) | This documentation-governance change: baseline, scope, plan, implementation and closure | DOCS-01 / implementation complete |
| [P05-CI-01.md](P05-CI-01.md) | Scope/roots, allowed paths, implementation and Gitea CI acceptance evidence | P05-CI-01 / in progress | | [P05-CI-01.md](P05-CI-01.md) | Scope/roots, allowed paths, implementation and Gitea CI acceptance evidence | P05-CI-01 / source complete, CI blockers open |
| [CHANGELOG.md](CHANGELOG.md) | Short append-only chronological phase log and links to detailed reports | DOCS-01 / active | | [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. Update this manifest whenever any direct child file or directory changes. Use **actual source state**; a planned file must be labeled planned, not present.
+36 -7
View File
@@ -1,17 +1,17 @@
# P05-CI-01 — Gitea Actions Verification Foundation # P05-CI-01 - Gitea Actions Verification Foundation
Date: 2026-11-22 Date: 2026-11-22
Status: APPROVED / IN PROGRESS — before code edits Status: SOURCE IMPLEMENTED; ONE CI RUN COMPLETED WITH BLOCKERS; NOT PRODUCTION-ACCEPTED
Baseline: `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` (local and Gitea `main` matched before implementation) Baseline: `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` (local and Gitea `main` matched before implementation)
User approval: 2026-11-22 P05-CI-01 explicit instruction. One focused Gitea Actions acceptance cycle, Git commit/push; **no local tests/builds/dev services**. User approval: 2026-11-22 P05-CI-01 explicit instruction. One focused Gitea Actions acceptance cycle, Git commit/push; **no local tests/builds/dev services**.
## Exact write scope ## Exact write scope
- `.gitea/**` — new workflow plus README/MINIFEST for first-party directories - `.gitea/**` - new workflow plus README/MINIFEST for first-party directories
- `tests/ci/**` — isolated runner verification utilities and folder docs - `tests/ci/**` - isolated runner verification utilities and folder docs
- `users/ui/package.json` and `users/ui/package-lock.json` — only justified dependency/lock corrections - `users/ui/package.json` and `users/ui/package-lock.json` - only justified dependency/lock corrections
- `auth/ui/v2/pnpm-workspace.yaml` and `auth/ui/v2/pnpm-lock.yaml` — only slim workspace reconciliation - `auth/ui/v2/pnpm-workspace.yaml` and `auth/ui/v2/pnpm-lock.yaml` - only slim workspace reconciliation
- `notes/**`, `project/**`, relevant `docs/**`, `README.md` — evidence, manifests and documentation - `notes/**`, `project/**`, relevant `docs/**`, `README.md` - evidence, manifests and documentation
- Existing `tests/README.md` is **not** approved for write; document test folder in its nested `tests/ci/` instead. - Existing `tests/README.md` is **not** approved for write; document test folder in its nested `tests/ci/` instead.
- `deployment/docker/compose.backend.dev.yaml` and `core/backend/zitadel/dev.py` remain **read-only**. Any reproduced runtime bug here requires a separate approved exception. - `deployment/docker/compose.backend.dev.yaml` and `core/backend/zitadel/dev.py` remain **read-only**. Any reproduced runtime bug here requires a separate approved exception.
@@ -41,3 +41,32 @@ E. Final evidence, notes/project/docs/manifests synchronized. If CI fails, recor
## Acceptance policy ## Acceptance policy
Only call a gate PASS if real Gitea Actions job step succeeded. Docker/OIDC requiring missing capability must state BLOCKED. No production-ready claim until all required gates succeed. Version/security advisories: report exact package/version/severity/decision; do not apply blind dependency updates. Only call a gate PASS if real Gitea Actions job step succeeded. Docker/OIDC requiring missing capability must state BLOCKED. No production-ready claim until all required gates succeed. Version/security advisories: report exact package/version/severity/decision; do not apply blind dependency updates.
## Actual implementation and one-cycle Gitea result (2026-11-22)
**Initial pushed CI source SHA:** `42b79362c13b9dbb07f85a58ad278742d91b1f5b`.
**Run:** [Gitea Actions #81](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/81), event `workflow_dispatch` on `main`; started 12:59:03Z, completed 13:03:55Z; **overall FAILURE**.
| Job | ID | Actual result | Concrete evidence |
| --- | ---: | --- | --- |
| Account Portal | 165 | **FAIL** | Checkout + source/lock/guard preflight PASS; `npm ci` added 38 packages. `npm run typecheck` TS2345 `users/ui/src/auth.ts(14,61)`: Auth.js session callback's inferred `user.id` type is not assignable to `string`. Next build not run |
| Login V2 | 166 | **PASS** | `pnpm install --frozen-lockfile` PASS; Nx generated proto + built client and Login V2 standalone PASS; upstream Vitest 84/84 files and **1219/1219 tests PASS** |
| Dependency advisory | 167 | **PASS only for HIGH/CRITICAL gate** | `npm audit --omit=dev --audit-level=high` PASS; `pnpm audit --prod --audit-level high` PASS; **18 MODERATE** Login advisory findings remain open, exact packages/remediation not yet triaged |
| Disposable Docker | 168 | **FAIL before Docker** | `node:22-alpine` checkout had no Git, falling back to REST archive which returned `Not found` after retries. Docker setup, P02 Python tests, backend runtime, ready/discovery/JWKS NOT RUN; always-cleanup step PASS |
**One focused CI acceptance cycle only.** No rerun, no local tests/builds/dev server/Docker. No actual user session, MFA, Admin Console or production deployment was verified.
### Exact in-scope source remediation (after Run #81)
`.gitea/workflows/p05-ci.yml`: inserted `apk add --no-cache git` **before** `actions/checkout@v4` in Alpine backend job. This fixes the identified checkout prerequisite **in source**, but **has not been CI-tested**. No changes to `core/backend/zitadel/`, `deployment/docker/`, `users/ui/src/auth.ts`, Login V2 original application code, or unrelated files.
### Open blockers and disposition
- **P05-B01 / Account Auth.js TS2345:** needs narrowly approved `users/ui/src/auth.ts` / type augmentation patch, preserve existing expiry/identity guarantees and regression test. Out of P05 write scope, **do not patch here**.
- **P05-B02 / Docker runtime acceptance:** first run did not reach Docker preflight. Corrected checkout source needs a separately approved Gitea CI rerun; no claim of ZITADEL health, Admin Console, persistence or OIDC discovery.
- **P05-B03 / Moderate advisories:** 18 moderate findings from `pnpm audit --prod`; current high/critical gate passed, but package-level advisory IDs and real impact must be collected and triaged before production.
- **P05-B04 / Interactive OIDC:** no disposable confidential OIDC client/user lifecycle harness in P05; full Account Portal auth callback, MFA/passkey, logout and protected route E2E remain **unverified**.
- All existing production host/domain/DNS/Coolify and real data unchanged.
**Final status:** Source and Gitea Actions foundation implemented and audited; **full CI acceptance BLOCKED**. Follow-up must be a separately approved, exact-scope remediation. After the result documentation and CI-only checkout patch are committed and pushed, record the new exact `main` SHA via Git; **that new SHA is not the tested Run #81 SHA**.
+1 -1
View File
@@ -9,7 +9,7 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
| 2026-11-22 | P03 | `auth/ui/v2/` official v4.20.4 source and matching client/proto/pnpm/Nx dependencies | `4404849`; `docs/P03-SOURCE-IMPORT.md`; no build | | 2026-11-22 | P03 | `auth/ui/v2/` official v4.20.4 source and matching client/proto/pnpm/Nx dependencies | `4404849`; `docs/P03-SOURCE-IMPORT.md`; no build |
| 2026-11-22 | P04 | `users/ui/` Account Portal OIDC, pages, styling, read-only identity API | `40af500`; `docs/P04-ACCOUNT-PORTAL.md`; no build/CI | | 2026-11-22 | P04 | `users/ui/` Account Portal OIDC, pages, styling, read-only identity API | `40af500`; `docs/P04-ACCOUNT-PORTAL.md`; no build/CI |
| 2026-11-22 | DOCS-01 | Documentation governance; developer architecture, reviewed first-party function/file/page mapping and 701-path source inventory; user manual/setup/status/troubleshooting | Documentation complete; manifest/link/source-scope audit PASS; `notes/DOCS-01.md`, local commit SHA via Git history | | 2026-11-22 | DOCS-01 | Documentation governance; developer architecture, reviewed first-party function/file/page mapping and 701-path source inventory; user manual/setup/status/troubleshooting | Documentation complete; manifest/link/source-scope audit PASS; `notes/DOCS-01.md`, local commit SHA via Git history |
| 2026-11-22 | P05-CI-01 | `.gitea/workflows/p05-ci.yml`, `tests/ci/**`, Account Portal npm lock and Login V2 slim pnpm importer reconciliation; source-only CI verification preparation | CI not yet accepted; see `notes/P05-CI-01.md` and `project/CI-ARCHITECTURE.md` | | 2026-11-22 | P05-CI-01 | `.gitea/workflows/p05-ci.yml`, `tests/ci/**`, Account npm lock, Login pnpm importer reconciliation and in-scope Alpine Git checkout correction | Run #81 overall FAIL; 2 jobs PASS, 2 FAIL; Login 1219/1219 tests PASS, Account TS2345 and Docker checkout blocked; `notes/P05-CI-01.md` |
## Required entry for each future change ## Required entry for each future change
+9 -2
View File
@@ -1,6 +1,6 @@
# ZitPlane P05-CI-01 — Gitea Actions verification architecture # ZitPlane P05-CI-01 - Gitea Actions verification architecture
**Status:** source implemented, CI run result pending. **Approved baseline:** `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` (2026-11-22). **Status:** source implemented; Gitea Run #81 completed overall FAILURE (Login and high/critical security jobs PASS; Account and backend checkout FAIL). Follow-up acceptance pending. **Approved baseline:** `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` (2026-11-22).
## Exact job map ## Exact job map
@@ -35,3 +35,10 @@ The P02 Compose has a fixed named network `zitplane-backend-dev-internal` and lo
4. Production Docker/Coolify/TLS and DNS are out of scope. 4. Production Docker/Coolify/TLS and DNS are out of scope.
Reference: `notes/P05-CI-01.md`, `docs/PHASES.md`, `.gitea/workflows/p05-ci.yml`, `tests/ci/`. Reference: `notes/P05-CI-01.md`, `docs/PHASES.md`, `.gitea/workflows/p05-ci.yml`, `tests/ci/`.
## Verified Gitea Run #81 and source follow-up
Initial dispatched commit `42b79362c13b9dbb07f85a58ad278742d91b1f5b`. Two PASS: Login V2 frozen reproducible install, production build and 1219/1219 upstream unit tests; dependency advisory gate at high/critical only (18 moderate findings outstanding). Two FAIL: Account Portal TS2345 Auth.js session callback type mismatch; Alpine backend actions/checkout fallback `Not found` because Git missing before checkout. The Docker runtime and full interactive OIDC flow **were not executed**.
Pre-checkout Git install inserted in the backend workflow after this failed run; this is only a **source fix** until a future run actually passes. Reference `docs/P05-CI-01.md` for job numbers and `notes/P05-CI-01.md` for the next phase defect IDs. There was no second CI run or local test.
+1 -1
View File
@@ -37,7 +37,7 @@ The Account Portal has **no dependency lockfile** yet. `npm ci`/reproducible bui
## P05-CI-01 dependency reconciliation and CI ## P05-CI-01 dependency reconciliation and CI
The P03 upstream `pnpm-lock.yaml` contained 8 importer metadata records but the slim ZitPlane workspace only contains 4. P05 removes absent importers while preserving all original resolution package snapshots; `pnpm-workspace.yaml` explicitly lists imported Login/Client/Proto packages. The `users/ui/package-lock.json` is npm v3, generated with metadata-only package-lock command (no local installs). Gitea `.gitea/workflows/p05-ci.yml` uses `ubuntu-latest` containers to verify frozen install, build, high/critical advisory gate, and disposable backend smoke. These paths are source configuration until Gitea jobs prove them. The P03 upstream `pnpm-lock.yaml` contained 8 importer metadata records but the slim ZitPlane workspace only contains 4. P05 removes absent importers while preserving all original resolution package snapshots; `pnpm-workspace.yaml` explicitly lists imported Login/Client/Proto packages. The `users/ui/package-lock.json` is npm v3, generated with metadata-only package-lock command (no local installs). Gitea `.gitea/workflows/p05-ci.yml` uses `ubuntu-latest` containers to verify frozen install, build, high/critical advisory gate, and disposable backend smoke. Gitea Run #81 proved Login frozen install/build/unit (1219/1219) and high/critical advisory threshold; Account dependencies installed but TypeScript failed; the Docker checkout had no Git before the action, so live backend was not exercised. Login's audit also reported 18 MODERATE findings. The checkout fix was committed after the run and remains unverified; see `docs/P05-CI-01.md`.
## Pending checks before any release ## Pending checks before any release