ci: introduce ZitPlane P05 verification foundation

This commit is contained in:
Vib Tools committed 2026-11-22 04:58:45 -08:00
1 parent 7ecf531697
commit 42b79362c1
32 files changed
+1731 -471

No files matched your search

+7
View File
@@ -0,0 +1,7 @@
# .gitea manifest
| Child | Purpose | Phase |
| --- | --- | --- |
| [README.md](README.md) | CI ownership, runner assumptions and safety rules | P05-CI-01 |
| [MINIFEST.md](MINIFEST.md) | Exact direct children register | P05-CI-01 |
| [workflows/](workflows/README.md) | Gitea Actions verification YAML and local workflow documentation | P05-CI-01 |
+11
View File
@@ -0,0 +1,11 @@
# Gitea Actions configuration
This directory is the **ZitPlane-owned CI configuration**, not a production deployment or release directory.
- `workflows/` contains explicitly approved Gitea Actions workflows.
- P05-CI-01 adds a **manual-dispatch only** verification workflow. It does not push Docker images, deploy Coolify, publish releases or handle real accounts.
- Runners use Gitea's registered `ubuntu-latest` label and Docker-capable Linux job containers. Gitea runner availability is a CI preflight gate, not assumed.
- Read `notes/P05-CI-01.md` before updating verification jobs, and synchronize `project/` and `docs/` in the same scope.
- Do not introduce production secrets, writable source deployments or untrusted PR builds with Docker daemon access.
See [MINIFEST.md](MINIFEST.md) for direct files/subfolders.
+7
View File
@@ -0,0 +1,7 @@
# .gitea/workflows manifest
| File | Responsibility | Phase |
| --- | --- | --- |
| [README.md](README.md) | Manual CI entry, job and security instructions | P05-CI-01 |
| [MINIFEST.md](MINIFEST.md) | Workflow directory file inventory | P05-CI-01 |
| [p05-ci.yml](p05-ci.yml) | Isolated account/login/backend CI verification on Gitea | P05-CI-01 |
+13
View File
@@ -0,0 +1,13 @@
# 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.
Job responsibilities:
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.
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.**
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.
See `notes/P05-CI-01.md` and `tests/ci/`.
+148
View File
@@ -0,0 +1,148 @@
name: ZitPlane P05 CI Verification
# Manual only. Docker socket is accessible to CI; do not enable untrusted PR triggers.
on:
workflow_dispatch:
permissions:
contents: read
jobs:
account:
name: Account Portal reproducible build
runs-on: ubuntu-latest
container: node:22-bookworm
timeout-minutes: 25
steps:
- uses: actions/checkout@v4
with:
github-server-url: https://dev.ivib.cc
- name: Preflight source, npm lock and OIDC guard contracts
run: |
set -eu
node --version
npm --version
python3 --version
python3 tests/ci/source_contract.py
- name: Account Portal npm ci, TypeScript and Next.js build
working-directory: users/ui
run: |
set -eu
npm ci --no-audit --no-fund
npm run typecheck
npm run build
echo ZITPLANE_ACCOUNT_BUILD_PASS
login:
name: Upstream Login V2 frozen workspace build
runs-on: ubuntu-latest
container: node:22-bookworm
timeout-minutes: 45
env:
NX_NO_CLOUD: "true"
NX_DAEMON: "false"
CI: "true"
steps:
- uses: actions/checkout@v4
with:
github-server-url: https://dev.ivib.cc
- name: Prepare pinned pnpm and frozen workspace
working-directory: auth/ui/v2
run: |
set -eu
corepack enable
corepack prepare pnpm@10.30.3 --activate
pnpm --version
pnpm install --frozen-lockfile
echo ZITPLANE_LOGIN_FROZEN_INSTALL_PASS
- name: Build ZITADEL proto, client and Login V2
working-directory: auth/ui/v2
run: |
set -eu
# Upstream build expects a transient .env to remove from standalone output.
# No real token or credential is injected; source snapshots are untouched.
: > apps/login/.env
trap 'rm -f apps/login/.env' EXIT
pnpm exec nx run @zitadel/login:build --skip-nx-cache
test -f apps/login/.next/standalone/apps/login/server.js
echo ZITPLANE_LOGIN_BUILD_PASS
- name: Run upstream Login V2 unit suite
working-directory: auth/ui/v2
run: |
set -eu
pnpm --filter @zitadel/login run test-unit
echo ZITPLANE_LOGIN_UNIT_PASS
security:
name: Account and Login dependency security triage
runs-on: ubuntu-latest
container: node:22-bookworm
timeout-minutes: 25
steps:
- uses: actions/checkout@v4
with:
github-server-url: https://dev.ivib.cc
- name: Account production dependency advisories (high and critical)
working-directory: users/ui
run: |
set -eu
npm audit --omit=dev --audit-level=high
echo ZITPLANE_ACCOUNT_ADVISORY_GATE_PASS
- name: Login workspace production dependency advisories (high and critical)
working-directory: auth/ui/v2
run: |
set -eu
corepack enable
corepack prepare pnpm@10.30.3 --activate
pnpm audit --prod --audit-level high
echo ZITPLANE_LOGIN_ADVISORY_GATE_PASS
backend:
name: Disposable ZITADEL Docker and OIDC discovery
runs-on: ubuntu-latest
container: node:22-alpine
timeout-minutes: 35
steps:
- uses: actions/checkout@v4
with:
github-server-url: https://dev.ivib.cc
- name: Docker runner capability and prior backend contracts
run: |
set -eu
apk add --no-cache python3 docker-cli docker-cli-compose git
docker --version
docker compose version
docker info --format 'Docker driver={{.Driver}}'
python3 -m unittest discover -s tests -p test_backend_dev.py -v
# The P02 Compose has a literal network name and loopback port.
# Refuse to attach to an existing network belonging to a different run.
if docker network inspect zitplane-backend-dev-internal >/dev/null 2>&1; then
echo '::error::CI local network already exists; refusing to touch another stack'
exit 1
fi
echo ZITPLANE_DOCKER_PREFLIGHT_PASS
- name: Start disposable backend and verify OIDC discovery/JWKS
run: |
set -eu
project="zitplane-p05-${GITHUB_RUN_ID:-0}"
python3 core/backend/zitadel/dev.py init
docker compose --env-file .env -p "$project" -f deployment/docker/compose.backend.dev.yaml config --quiet
# Cleanup is allowed only after the preflight confirmed the network was absent.
touch .p05-ci-started
docker compose --env-file .env -p "$project" -f deployment/docker/compose.backend.dev.yaml up -d --wait
docker compose --env-file .env -p "$project" -f deployment/docker/compose.backend.dev.yaml ps
docker run --rm --network zitplane-backend-dev-internal \
-e ZITPLANE_CI_PROXY=http://proxy \
python:3.12-alpine python -c "$(cat tests/ci/oidc_discovery.py)"
echo ZITPLANE_DOCKER_DISCOVERY_PASS
echo '::warning::OIDC interactive callback, MFA and Account Portal session E2E require a future disposable-client integration gate; NOT VERIFIED.'
- name: Always remove only P05 disposable Docker state
if: always()
run: |
set +e
if [ -f .p05-ci-started ] && [ -f .env ]; then
project="zitplane-p05-${GITHUB_RUN_ID:-0}"
docker compose --env-file .env -p "$project" -f deployment/docker/compose.backend.dev.yaml down -v --remove-orphans
fi
rm -f .env .p05-ci-started
echo ZITPLANE_DISPOSABLE_CLEANUP_COMPLETE
+1
View File
@@ -4,6 +4,7 @@
| Direct child | Type | Purpose | Phase / status | | Direct child | Type | Purpose | Phase / status |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| `.gitea/` | folder | Gitea manual Actions workflow and README/MINIFEST | P05-CI-01; source ready, CI results pending |
| `auth/` | folder | P03 imported upstream Login V2 Next.js workspace under `ui/v2/` | P01/P03; source only | | `auth/` | folder | P03 imported upstream Login V2 Next.js workspace under `ui/v2/` | P01/P03; source only |
| `core/` | folder | P02 official ZITADEL image/config plus dev helper | P01/P02; runtime unverified | | `core/` | folder | P02 official ZITADEL image/config plus dev helper | P01/P02; runtime unverified |
| `deployment/` | folder | Local-only Compose; no production stack | P01/P02 | | `deployment/` | folder | Local-only Compose; no production stack | P01/P02 |
+3 -1
View File
@@ -7,6 +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.
- **Production / Coolify:** not configured or deployed. - **Production / Coolify:** not configured or deployed.
## Documentation and project knowledge ## Documentation and project knowledge
@@ -30,7 +31,8 @@ Each of these folders contains `README.md` and the requested literal `MINIFEST.m
| `auth/ui/v2/` | Official Login V2 monorepo subset (Next.js source in `apps/login/`, matched client/proto and pnpm/Nx workspace) | | `auth/ui/v2/` | Official Login V2 monorepo subset (Next.js source in `apps/login/`, matched client/proto and pnpm/Nx workspace) |
| `users/ui/` | P04 account portal source: separate Next.js app, protected pages, OIDC, server-side user API (CI pending) | | `users/ui/` | P04 account portal source: separate Next.js app, protected pages, OIDC, server-side user API (CI pending) |
| `packages/` | Shared packages only when needed | | `packages/` | Shared packages only when needed |
| `tests/` | Focused contracts and future integration/UI tests | | `tests/` | Focused P02 contracts and P05 isolated CI smoke scripts |
| `.gitea/` | Gitea Actions manual CI verification configuration |
| `docs/` | Architecture, scopes and developer instructions | | `docs/` | Architecture, scopes and developer instructions |
## Local development (requires Docker Desktop Linux containers) ## Local development (requires Docker Desktop Linux containers)
+1 -439
View File
@@ -15,6 +15,7 @@ overrides:
importers: importers:
.: .:
devDependencies: devDependencies:
'@bufbuild/buf': '@bufbuild/buf':
@@ -36,160 +37,6 @@ importers:
specifier: ^9.1.0 specifier: ^9.1.0
version: 9.1.0 version: 9.1.0
apps/docs:
dependencies:
'@headlessui/react':
specifier: ^2.2.10
version: 2.2.10(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
'@heroicons/react':
specifier: ^2.2.0
version: 2.2.0(react@19.2.6)
'@shikijs/rehype':
specifier: ^4.0.2
version: 4.4.3
'@shikijs/types':
specifier: ^4.0.2
version: 4.4.3
'@types/js-yaml':
specifier: ^4.0.9
version: 4.0.9
clsx:
specifier: ^2.1.1
version: 2.1.1
fumadocs-core:
specifier: 16.8.10
version: 16.8.10(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.5)(@types/mdast@4.0.4)(@types/react@19.2.14)(algoliasearch@5.48.1)(lucide-react@0.577.0(react@19.2.6))(next@16.4.3(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(zod@4.6.7)
fumadocs-mdx:
specifier: 14.3.2
version: 14.3.2(@types/mdast@4.0.4)(@types/mdx@2.0.14)(@types/react@19.2.14)(fumadocs-core@16.8.10(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.5)(@types/mdast@4.0.4)(@types/react@19.2.14)(algoliasearch@5.48.1)(lucide-react@0.577.0(react@19.2.6))(next@16.4.3(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(zod@4.6.7))(next@16.4.3(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0))(react@19.2.6)(vite@7.3.7(@types/node@25.9.5)(jiti@2.7.0)(lightningcss@1.32.0)(sass@1.102.0)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.0))
fumadocs-openapi:
specifier: 10.8.2
version: 10.8.2(e0ab1c2e20c9d92e6c66e159aaced6dc)
fumadocs-ui:
specifier: 16.8.10
version: 16.8.10(@tailwindcss/oxide@4.3.3)(@types/mdx@2.0.14)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(fumadocs-core@16.8.10(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.5)(@types/mdast@4.0.4)(@types/react@19.2.14)(algoliasearch@5.48.1)(lucide-react@0.577.0(react@19.2.6))(next@16.4.3(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(zod@4.6.7))(next@16.4.3(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(tailwindcss@4.3.3)
js-yaml:
specifier: ^4.3.2
version: 4.3.2
lucide-react:
specifier: ^0.577.0
version: 0.577.0(react@19.2.6)
mixpanel-browser:
specifier: ^2.78.0
version: 2.82.0
next:
specifier: 16.4.3
version: 16.4.3(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(@playwright/test@1.62.1)(@types/node@25.9.5)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(sass@1.102.0)
next-themes:
specifier: ^0.4.6
version: 0.4.6(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
react:
specifier: 19.2.6
version: 19.2.6
react-copy-to-clipboard:
specifier: ^5.1.1
version: 5.1.1(react@19.2.6)
react-dom:
specifier: 19.2.6
version: 19.2.6(react@19.2.6)
react-google-charts:
specifier: ^5.2.1
version: 5.2.1(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
react-markdown:
specifier: ^10.1.0
version: 10.1.0(@types/react@19.2.14)(react@19.2.6)
remark-gfm:
specifier: ^4.0.1
version: 4.0.1
shiki:
specifier: ^4.0.2
version: 4.4.3
tailwind-merge:
specifier: ^3.6.0
version: 3.6.0
vanilla-cookieconsent:
specifier: ^3.1.0
version: 3.1.0
zod:
specifier: ^4.6.7
version: 4.6.7
devDependencies:
'@eslint/js':
specifier: ^10.0.1
version: 10.0.1(eslint@10.8.1(jiti@2.7.0))
'@tailwindcss/postcss':
specifier: ^4.3.0
version: 4.3.3
'@types/mdx':
specifier: ^2.0.13
version: 2.0.14
'@types/node':
specifier: ^25.7.0
version: 25.9.5
'@types/react':
specifier: 19.2.14
version: 19.2.14
'@types/react-dom':
specifier: 19.2.3
version: 19.2.3(@types/react@19.2.14)
'@typescript-eslint/eslint-plugin':
specifier: ^8.59.3
version: 8.67.0(@typescript-eslint/parser@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.3))(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.3)
'@typescript-eslint/parser':
specifier: ^8.59.3
version: 8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.3)
eslint:
specifier: ^10.3.0
version: 10.8.1(jiti@2.7.0)
eslint-config-prettier:
specifier: ^10.1.8
version: 10.1.8(eslint@10.8.1(jiti@2.7.0))
eslint-import-resolver-typescript:
specifier: ^4.4.4
version: 4.4.5(eslint-plugin-import@2.32.0)(eslint@10.8.1(jiti@2.7.0))
eslint-plugin-import:
specifier: ^2.32.0
version: 2.32.0(@typescript-eslint/parser@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.3))(eslint-import-resolver-typescript@4.4.5)(eslint@10.8.1(jiti@2.7.0))
eslint-plugin-mdx:
specifier: ^3.7.0
version: 3.8.1(eslint@10.8.1(jiti@2.7.0))
glob:
specifier: ^13.0.6
version: 13.0.6
globals:
specifier: ^17.6.0
version: 17.11.0
next-validate-link:
specifier: ^1.6.6
version: 1.6.7(@types/mdast@4.0.4)(@types/unist@3.0.3)
postcss:
specifier: ^8.5.23
version: 8.5.26
raw-loader:
specifier: ^4.0.2
version: 4.0.2(webpack@5.109.2(@swc/core@1.15.47(@swc/helpers@0.5.23))(lightningcss@1.32.0)(postcss@8.5.26))
remark-heading-id:
specifier: ^1.0.1
version: 1.0.1
semver:
specifier: ^7.8.0
version: 7.8.5
tailwindcss:
specifier: ^4.3.0
version: 4.3.3
tailwindcss-animate:
specifier: ^1.0.7
version: 1.0.7(tailwindcss@4.3.3)
tsx:
specifier: 4.23.15
version: 4.23.15
typescript:
specifier: ^5.9.3
version: 5.9.3
yaml-loader:
specifier: ^0.9.0
version: 0.9.0
apps/login: apps/login:
dependencies: dependencies:
'@braintree/sanitize-url': '@braintree/sanitize-url':
@@ -455,268 +302,6 @@ importers:
specifier: ^4.1.12 specifier: ^4.1.12
version: 4.1.12(@opentelemetry/api@1.9.1)(@types/node@25.9.5)(jsdom@26.1.0)(vite@7.3.7(@types/node@25.9.5)(jiti@2.7.0)(lightningcss@1.32.0)(sass@1.102.0)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.0)) version: 4.1.12(@opentelemetry/api@1.9.1)(@types/node@25.9.5)(jsdom@26.1.0)(vite@7.3.7(@types/node@25.9.5)(jiti@2.7.0)(lightningcss@1.32.0)(sass@1.102.0)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.0))
console:
dependencies:
'@angular/animations':
specifier: ^21.2.25
version: 21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
'@angular/cdk':
specifier: ^21.2.14
version: 21.2.14(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/platform-browser@21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(rxjs@7.8.2)
'@angular/common':
specifier: ^21.2.25
version: 21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2)
'@angular/compiler':
specifier: ^21.2.25
version: 21.2.25
'@angular/core':
specifier: ^21.2.25
version: 21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)
'@angular/forms':
specifier: ^21.2.25
version: 21.2.25(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/platform-browser@21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(rxjs@7.8.2)
'@angular/material':
specifier: ^21.2.14
version: 21.2.14(4fa12bb6dee48d002b1b91cd0497533e)
'@angular/material-moment-adapter':
specifier: ^21.2.14
version: 21.2.14(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/material@21.2.14(4fa12bb6dee48d002b1b91cd0497533e))(moment@2.31.0)
'@angular/platform-browser':
specifier: ^21.2.25
version: 21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
'@angular/platform-browser-dynamic':
specifier: ^21.2.25
version: 21.2.25(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/compiler@21.2.25)(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/platform-browser@21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))
'@angular/router':
specifier: ^21.2.25
version: 21.2.25(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/platform-browser@21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(rxjs@7.8.2)
'@angular/service-worker':
specifier: ^21.2.25
version: 21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2)
'@bufbuild/protobuf':
specifier: ^2.12.0
version: 2.13.0
'@connectrpc/connect':
specifier: ^2.1.1
version: 2.1.2(@bufbuild/protobuf@2.13.0)
'@connectrpc/connect-web':
specifier: ^2.1.1
version: 2.1.2(@bufbuild/protobuf@2.13.0)(@connectrpc/connect@2.1.2(@bufbuild/protobuf@2.13.0))
'@ctrl/ngx-codemirror':
specifier: ^7.0.0
version: 7.0.0(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/forms@21.2.25(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@angular/platform-browser@21.2.25(@angular/animations@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2)))(rxjs@7.8.2))(codemirror@5.65.21)
'@fortawesome/angular-fontawesome':
specifier: ^4.0.0
version: 4.0.0(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
'@fortawesome/fontawesome-svg-core':
specifier: ^7.2.0
version: 7.3.1
'@fortawesome/free-brands-svg-icons':
specifier: ^7.2.0
version: 7.3.1
'@netlify/build-info':
specifier: ^10.5.1
version: 10.5.1
'@ng-icons/core':
specifier: ^33.2.2
version: 33.4.0(@angular-devkit/schematics@21.2.29(chokidar@5.0.0))(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(@schematics/angular@21.2.29(chokidar@5.0.0))(rxjs@7.8.2)
'@ng-icons/heroicons':
specifier: ^33.2.2
version: 33.4.0
'@ngx-translate/core':
specifier: ^17.0.0
version: 17.0.0(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
'@tanstack/angular-query-experimental':
specifier: ^5.100.11
version: 5.101.4(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
angular-oauth2-oidc:
specifier: ^20.0.2
version: 20.0.3(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
angularx-qrcode:
specifier: ^21.0.5
version: 21.0.5(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
buffer:
specifier: ^6.0.3
version: 6.0.3
codemirror:
specifier: ^5.65.21
version: 5.65.21
file-saver:
specifier: ^2.0.5
version: 2.0.5
flag-icons:
specifier: ^7.5.0
version: 7.5.0
google-protobuf:
specifier: ^4.0.2
version: 4.0.2
grpc-web:
specifier: ^2.0.2
version: 2.0.2
i18n-iso-countries:
specifier: ^7.14.0
version: 7.14.0
libphonenumber-js:
specifier: ^1.13.2
version: 1.13.10
material-design-icons-iconfont:
specifier: ^6.7.0
version: 6.7.0
moment:
specifier: ^2.31.0
version: 2.31.0
ngx-color:
specifier: ^10.1.0
version: 10.1.0(@angular/common@21.2.25(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))(rxjs@7.8.2))(@angular/core@21.2.25(@angular/compiler@21.2.25)(rxjs@7.8.2)(zone.js@0.16.2))
opentype.js:
specifier: ^1.3.4
version: 1.3.5
posthog-js:
specifier: ^1.380.1
version: 1.416.0
rxjs:
specifier: ^7.8.2
version: 7.8.2
tinycolor2:
specifier: ^1.6.0
version: 1.6.0
tslib:
specifier: ^2.8.1
version: 2.8.1
uuid:
specifier: ^14.0.0
version: 14.0.1
zone.js:
specifier: ~0.16.2
version: 0.16.2
devDependencies:
'@angular-eslint/eslint-plugin':
specifier: 21.4.0
version: 21.4.0(@typescript-eslint/utils@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2))(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2)
'@angular-eslint/eslint-plugin-template':
specifier: 21.4.0
version: 21.4.0(@angular-eslint/template-parser@21.4.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2))(@typescript-eslint/types@8.67.0)(@typescript-eslint/utils@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2))(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2)
'@angular-eslint/template-parser':
specifier: 21.4.0
version: 21.4.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2)
'@angular/build':
specifier: ^21.2.29
version: 21.2.29(d595838af8fdcb06b20fa7fcd3673ddc)
'@angular/cli':
specifier: ^21.2.29
version: 21.2.29(@types/node@25.9.5)(chokidar@5.0.0)
'@angular/compiler-cli':
specifier: ^21.2.25
version: 21.2.25(@angular/compiler@21.2.25)(typescript@5.9.2)
'@angular/language-service':
specifier: ^21.2.25
version: 21.2.25
'@eslint/js':
specifier: ^10.0.1
version: 10.0.1(eslint@10.8.1(jiti@2.7.0))
'@tailwindcss/postcss':
specifier: ^4.3.0
version: 4.3.3
'@types/file-saver':
specifier: ^2.0.7
version: 2.0.7
'@types/google-protobuf':
specifier: ^3.15.12
version: 3.15.12
'@types/jasmine':
specifier: ~5.1.15
version: 5.1.15
'@types/jasminewd2':
specifier: ~2.0.13
version: 2.0.13
'@types/node':
specifier: ^25.9.1
version: 25.9.5
'@types/opentype.js':
specifier: ^1.3.9
version: 1.3.10
'@types/qrcode':
specifier: ^1.5.6
version: 1.5.6
'@types/uuid':
specifier: ^11.0.0
version: 11.0.0
'@typescript-eslint/eslint-plugin':
specifier: ^8.59.4
version: 8.67.0(@typescript-eslint/parser@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2))(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2)
'@typescript-eslint/parser':
specifier: ^8.59.4
version: 8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2)
'@zitadel/client':
specifier: workspace:*
version: link:../packages/zitadel-client
'@zitadel/proto':
specifier: workspace:*
version: link:../packages/zitadel-proto
eslint:
specifier: ^10.4.0
version: 10.8.1(jiti@2.7.0)
eslint-config-prettier:
specifier: ^10.1.8
version: 10.1.8(eslint@10.8.1(jiti@2.7.0))
eslint-import-resolver-typescript:
specifier: ^4.4.4
version: 4.4.5(eslint-plugin-import@2.32.0)(eslint@10.8.1(jiti@2.7.0))
eslint-plugin-import:
specifier: ^2.32.0
version: 2.32.0(@typescript-eslint/parser@8.67.0(eslint@10.8.1(jiti@2.7.0))(typescript@5.9.2))(eslint-import-resolver-typescript@4.4.5)(eslint@10.8.1(jiti@2.7.0))
globals:
specifier: ^17.6.0
version: 17.11.0
jasmine-core:
specifier: ~5.12.1
version: 5.12.1
jasmine-spec-reporter:
specifier: ~7.0.0
version: 7.0.0
karma:
specifier: ^6.4.4
version: 6.4.4
karma-chrome-launcher:
specifier: ^3.2.0
version: 3.2.0
karma-coverage:
specifier: ^2.2.1
version: 2.2.1
karma-coverage-istanbul-reporter:
specifier: ^3.0.3
version: 3.0.3
karma-jasmine:
specifier: ^5.1.0
version: 5.1.0(karma@6.4.4)
karma-jasmine-html-reporter:
specifier: ^2.2.0
version: 2.2.0(jasmine-core@5.12.1)(karma-jasmine@5.1.0(karma@6.4.4))(karma@6.4.4)
postcss:
specifier: ^8.5.15
version: 8.5.26
prettier:
specifier: ^3.8.3
version: 3.9.6
prettier-plugin-organize-imports:
specifier: ^4.3.0
version: 4.3.0(prettier@3.9.6)(typescript@5.9.2)
tailwindcss:
specifier: ^4.3.0
version: 4.3.3
typescript:
specifier: 5.9.2
version: 5.9.2
deploy/compose:
devDependencies:
'@playwright/test':
specifier: ^1.60.0
version: 1.62.1
dotenv:
specifier: ^16.6.1
version: 16.6.1
packages/zitadel-client: packages/zitadel-client:
dependencies: dependencies:
'@bufbuild/protobuf': '@bufbuild/protobuf':
@@ -791,29 +376,6 @@ importers:
specifier: ^2.12.0 specifier: ^2.12.0
version: 2.13.0(@bufbuild/protobuf@2.13.0) version: 2.13.0(@bufbuild/protobuf@2.13.0)
tests/functional-ui:
devDependencies:
'@types/node':
specifier: ^25.7.0
version: 25.9.5
cypress:
specifier: ^15.14.2
version: 15.20.1
cypress-wait-until:
specifier: ^3.0.2
version: 3.0.2
jsonwebtoken:
specifier: ^9.0.3
version: 9.0.3
prettier:
specifier: ^3.8.3
version: 3.9.6
typescript:
specifier: ^5.9.3
version: 5.9.3
uuid:
specifier: ^14.0.0
version: 14.0.1
packages: packages:
+3 -5
View File
@@ -1,9 +1,7 @@
packages: packages:
- console - apps/login
- tests/* - packages/zitadel-client
- packages/* - packages/zitadel-proto
- apps/*
- deploy/compose
exclude: exclude:
- benchmark # because of the node 18 or 20 dependency - benchmark # because of the node 18 or 20 dependency
+3 -2
View File
@@ -1,6 +1,6 @@
# ZitPlane — Actual feature availability / limitations # ZitPlane — Actual feature availability / limitations
Snapshot: 2026-11-22, baseline `40af500`. **SOURCE EXISTS != RUNNING != VERIFIED != PRODUCTION**. Snapshot: 2026-11-22, P05-CI-01 source preparation based on baseline `7ecf531`. **SOURCE EXISTS != RUNNING != VERIFIED != PRODUCTION**.
| Feature | Source present | CI/build verified | Live/deployed | | Feature | Source present | CI/build verified | Live/deployed |
| --- | --- | --- | --- | | --- | --- | --- | --- |
@@ -17,7 +17,8 @@ Snapshot: 2026-11-22, baseline `40af500`. **SOURCE EXISTS != RUNNING != VERIFIED
| 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 and isolated integration tests | No | No | No | | Gitea Actions CI verification workflow | P05 source added, manual dispatch | Not yet verified | Not deployed |
| Gitea Actions CI and isolated integration tests | Verification scripts prepared; full OIDC E2E absent | Pending | 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 |
+2 -1
View File
@@ -7,6 +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 |
| [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,4 +18,4 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
| [P03-SOURCE-IMPORT.md](P03-SOURCE-IMPORT.md) | Exact ZITADEL upstream import source/blob audit and CI backlog | P03 / existing | | [P03-SOURCE-IMPORT.md](P03-SOURCE-IMPORT.md) | Exact ZITADEL upstream import source/blob audit and CI backlog | P03 / existing |
| [P04-ACCOUNT-PORTAL.md](P04-ACCOUNT-PORTAL.md) | Account Portal source, security assumptions and pending CI | P04 / existing | | [P04-ACCOUNT-PORTAL.md](P04-ACCOUNT-PORTAL.md) | Account Portal source, security assumptions and pending CI | P04 / existing |
No new subfolders in `docs/` at DOCS-01. Future subfolders need their own `README.md` and `MINIFEST.md` if project-owned; do not rewrite upstream vendor directories merely to add documentation. No subfolders in `docs/` as of P05-CI-01. Future subfolders need their own `README.md` and `MINIFEST.md` if project-owned; do not rewrite upstream vendor directories merely to add documentation.
+30
View File
@@ -0,0 +1,30 @@
# P05-CI-01 — Gitea Actions verification
Date: 2026-11-22
Source baseline: `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1`
State: **WORKFLOW SOURCE PREPARED; DISPATCH/RESULTS PENDING**.
## How to run
In Gitea `vibtools/ZitPlane`, open Actions > **ZitPlane P05 CI Verification** > Run workflow, select `main`. This is **manual only** and requires an existing `ubuntu-latest` runner with working Docker support. The workflow file is `.gitea/workflows/p05-ci.yml`.
No local PC tests, builds, Docker or dev servers are performed by this phase. The workflow jobs execute only inside Gitea runner job containers.
## Gates
- **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.
- **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.
**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.
## Safety
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
**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.
Developer map: `project/CI-ARCHITECTURE.md`. Phase notes and root-cause evidence: `notes/P05-CI-01.md`.
+9 -2
View File
@@ -33,8 +33,15 @@ 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 — Integration (proposed, NOT approved) ## P05-CI-01 — Gitea Actions Verification Foundation (APPROVED 2026-11-22)
Local development, shared UI tokens as needed, production-safe Docker topology, routing drafts, tests/docs. No live deployment. - 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.
- 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.
- Run evidence: `notes/P05-CI-01.md` and `docs/P05-CI-01.md`. No production deployment/release.
## P05 — Full Integration (proposed, NOT approved)
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.
+3
View File
@@ -24,3 +24,6 @@
- Never publish real personal user data, passwords, access tokens or secrets. - Never publish real personal user data, passwords, access tokens or secrets.
Full update policy is in root [AGENTS.md](../AGENTS.md). A list of available docs is in [MINIFEST.md](MINIFEST.md). Full update policy is in root [AGENTS.md](../AGENTS.md). A list of available docs is in [MINIFEST.md](MINIFEST.md).
For manual Gitea runner verification and its limitations, see [P05-CI-01.md](P05-CI-01.md). A green backend discovery smoke is not an authenticated user-login result.
+3
View File
@@ -59,6 +59,9 @@ The Account Portal's profile page is currently **read-only**, and security page
ZITADEL Admin Console is distinct from the Account Portal. Never expose administrative API tokens or secrets to the browser. Identity administration should follow roles/policies, while billing/subscriptions/product permissions belong to individual SaaS applications. ZITADEL Admin Console is distinct from the Account Portal. Never expose administrative API tokens or secrets to the browser. Identity administration should follow roles/policies, while billing/subscriptions/product permissions belong to individual SaaS applications.
## Gitea Actions verification (P05-CI-01)
A manual-only workflow is defined in `.gitea/workflows/p05-ci.yml`. In Gitea go to `vibtools/ZitPlane` > Actions > **ZitPlane P05 CI Verification** > Run workflow (`main`). This runs on a registered Docker-capable `ubuntu-latest` runner, **not** your PC. See `docs/P05-CI-01.md` for its four gates and limitations. The CI workflow creates only disposable local test credentials and removes its own volumes; no real accounts, Coolify or production domains are accessed.
## Acceptance and configuration troubleshooting ## Acceptance and configuration troubleshooting
Refer to [FEATURES-STATUS.md](FEATURES-STATUS.md), [TROUBLESHOOTING.md](TROUBLESHOOTING.md), `docs/P02-EVIDENCE.md` and `docs/P04-ACCOUNT-PORTAL.md`. Do not claim success on a missing-run check. Future changes must update all affected docs and developer records. Refer to [FEATURES-STATUS.md](FEATURES-STATUS.md), [TROUBLESHOOTING.md](TROUBLESHOOTING.md), `docs/P02-EVIDENCE.md` and `docs/P04-ACCOUNT-PORTAL.md`. Do not claim success on a missing-run check. Future changes must update all affected docs and developer records.
+1
View File
@@ -9,5 +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) |
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
View File
@@ -5,6 +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 |
| [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.
+43
View File
@@ -0,0 +1,43 @@
# P05-CI-01 — Gitea Actions Verification Foundation
Date: 2026-11-22
Status: APPROVED / IN PROGRESS — before code edits
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**.
## Exact write scope
- `.gitea/**` — new workflow plus README/MINIFEST for first-party directories
- `tests/ci/**` — isolated runner verification utilities and folder docs
- `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
- `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.
- `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.
Excluded: application Login V2 source logic, account portal auth/session/pages, UI redesign, production deployment, release/tag, real credentials, production data, local build/test, unrelated untracked `AI_INSTRUCTIONS.md`.
## Pre-change root cause evidence
1. Gitea `vibtools/ZitPlane`: Actions enabled but **0 workflows**. Existing Gitea runner success in the sister repo DataStack on `ubuntu-latest` for CLI/Docker workflows; ZitPlane runner capability still must be checked on its own run.
2. P03 slim Login source: root `auth/ui/v2/pnpm-workspace.yaml` still references upstream `console`, `tests/*`, `deploy/compose` etc; only `apps/login`, `packages/zitadel-client`, `packages/zitadel-proto` imported. Original `pnpm-lock.yaml` contains absent importers (`apps/docs` etc), likely requires lockfile-safe reconciliation.
3. `auth/ui/v2/apps/login/project.json` declares build dependencies on generated proto and client; explicit reproducible install/build/verification must preserve this dependency graph.
4. `users/ui/package.json` pins Next/React/Auth.js and lacks `package-lock.json`; CI cannot use `npm ci` until a reviewed lockfile exists.
5. P02 dev Compose defines PostgreSQL, official ZITADEL API, prebuilt Login V2 and Traefik; **Docker/health/SSO not previously tested**.
6. P04 Auth.js OIDC route, session expiry, protected pages, local-only sign-out are **source-only**, not integrated with a disposable ZITADEL instance. Avoid simulated PASS or real-user tokens.
## Execution plan
A. Create first-party `.gitea/`, `.gitea/workflows/`, `tests/ci/` README/MINIFEST files and single manually dispatched `p05-ci.yml` with a preflight gate, account reproducible build, Login V2 frozen build, targeted dependency triage, disposable backend smoke and optional OIDC acceptance with explicit prerequisites.
B. Reconcile only necessary workspace/lockfile inputs. Lockfiles are generated **without executing local builds/tests**. Any unsupported reproducibility or failed generation must become a clear BLOCKED condition, not a silent unlocked install.
C. Runner job uses transient secrets, loopback-only services, disposable Docker Compose project/volumes, and always cleanup; never touches live ZITADEL domains or production data.
D. Stage exact paths, audit source scope and sensitive files, commit locally, push `main`; dispatch **one** workflow run; read run/jobs/log evidence and document exact results/remaining blockers.
E. Final evidence, notes/project/docs/manifests synchronized. If CI fails, record failure and propose a new phase/scope instead of unlimited edit/retry loops.
## 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.
+1
View File
@@ -9,6 +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` |
## Required entry for each future change ## Required entry for each future change
+37
View File
@@ -0,0 +1,37 @@
# ZitPlane P05-CI-01 — Gitea Actions verification architecture
**Status:** source implemented, CI run result pending. **Approved baseline:** `7ecf53169776cc7f08af3dde6fe4b4492acf3ea1` (2026-11-22).
## Exact job map
| Job | Runner / source | What PASS means | Not covered |
| --- | --- | --- | --- |
| `account` | `ubuntu-latest`, `node:22-bookworm`; `users/ui/` | Structural guard + `npm ci`, `tsc --noEmit`, Next standalone production build | Real login/redirect, live Account Portal |
| `login` | `ubuntu-latest`, `node:22-bookworm`; `auth/ui/v2/` | Frozen pnpm install, Nx proto/client/login build and original Login unit suite | Interactive admin/password/MFA/SSO integration |
| `security` | `ubuntu-latest`, `node:22-bookworm` | NPM and pnpm production dependency advisories at HIGH+ thresholds triaged by runner registry | License/legal or full application security proof |
| `backend` | `ubuntu-latest`, `node:22-alpine`; `deployment/docker/compose.backend.dev.yaml` read-only | Docker daemon preflight, Python helper contracts, disposable ZITADEL stack, readiness, OIDC discovery and JWKS | Portal OIDC callback, MFA, live account session, production TLS |
All jobs use the previously seen Gitea standard `ubuntu-latest` runner label; no separate runner is created or installed. A failed runner capability is a **BLOCKED** gate, never a PASS. Docker job must not run from an untrusted pull request; the workflow is `workflow_dispatch` only.
## Dependency/root cause fixes
- `auth/ui/v2/pnpm-workspace.yaml` has only the 3 actually imported packages. P03's original `pnpm-lock.yaml` retains exact `packages:/snapshots:` resolution graph; 4 missing-upstream importers were removed, 4 present importers retained.
- Account Portal package-lock v3 generated using local `npm install --package-lock-only --ignore-scripts --no-audit --no-fund --engine-strict`, **not** an install/test/build. Root package manifest matches lock manifest.
- Login CI sets up pinned pnpm `10.30.3`, runs `--frozen-lockfile` and the upstream Nx dependency graph; no upstream UI/auth logic was modified.
- Account CI uses `npm ci` only from committed lock, plus TS + production Next build. No automatically loosened package versions or npm install fallback.
- Security jobs audit dependency advisory metadata on the runner. Any failure is reported verbatim with severity/package/version; no blind package updates.
## Disposable backend safety and behavior
The P02 Compose has a fixed named network `zitplane-backend-dev-internal` and loopback-only `127.0.0.1:8080`. CI **refuses** to start if that network already exists. It generates independent random `.env` in runner checkout and uses unique Compose project name `zitplane-p05-${GITHUB_RUN_ID}`. A marker is written only after the network absence check; cleanup uses that exact Compose project, deletes its ephemeral volumes, and removes its temporary credentials. It never connects to `auth.vib.tools`, `account.vib.tools` or any production database.
`tests/ci/oidc_discovery.py` probes ready/discovery/JWKS inside disposable Docker network only, avoiding exposing admin PATs. **OIDC full user-session acceptance is explicitly NOT VERIFIED**: P05 does not provision a disposable confidential OIDC app, fake user or Session API script. A 200 readiness/discovery alone does not constitute user login, MFA, PKCE callback, protected account route or logout acceptance.
## Future gates
1. Document actual Gitea runner job results and exact failure/line in `notes/P05-CI-01.md` and `docs/P05-CI-01.md`.
2. If any job fails, keep immutable logged evidence; fix only reproduced narrow defects with separate approval if outside P05 Scope Lock.
3. Provide disposable OIDC client/user provisioning and Account Portal auth/session lifecycle tests in a narrow separately approved integration phase.
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/`.
+5
View File
@@ -44,3 +44,8 @@ Custom profile edits, password/MFA/passkey changes inside the portal, sessions/d
## Feature-update contract ## Feature-update contract
For every future page/feature change, record exact route/file, action, data source, guards, validation, errors, dependency version, accessibility details, status (proposed/source/CI verified/deployed), and phase/commit. Update user button-by-button guidance in `docs/USER-GUIDE.md` alongside this register. For every future page/feature change, record exact route/file, action, data source, guards, validation, errors, dependency version, accessibility details, status (proposed/source/CI verified/deployed), and phase/commit. Update user button-by-button guidance in `docs/USER-GUIDE.md` alongside this register.
## P05 CI verification (not a UI feature)
New manually dispatched workflow `.gitea/workflows/p05-ci.yml` defines four isolated runner gates: Account Portal reproducible dependency install/build, official Login V2 frozen install/build/unit, dependency security advisory triage, and disposable Docker ZITADEL/OIDC discovery smoke. Exact verification scripts reside at `tests/ci/source_contract.py` and `tests/ci/oidc_discovery.py`. The full Account Portal interactive OIDC callback/session/SSO flow is **not implemented as a CI test**; it remains a pending acceptance gate. Status must be updated from the actual Gitea run report in `notes/P05-CI-01.md`.
+15
View File
@@ -81,6 +81,21 @@ Upstream import: official ZITADEL `v4.20.4` / Git `384bb9ec96b501ad39dc232ee2061
These paths describe **source**, not a verified running app. Do not infer API compatibility or production availability from files existing. These paths describe **source**, not a verified running app. Do not infer API compatibility or production availability from files existing.
## P05 CI verification files
| Path | Purpose / scope |
| --- | --- |
| `.gitea/workflows/p05-ci.yml` | Manual Gitea Actions workflow with Account, Login, dependency security and disposable backend jobs |
| `.gitea/README.md`, `.gitea/MINIFEST.md`, `.gitea/workflows/README.md`, `.gitea/workflows/MINIFEST.md` | Ownership, controls and file register for new CI configuration |
| `tests/ci/source_contract.py` | CI-only lockfile/importer and first-party security guard structural assertions |
| `tests/ci/oidc_discovery.py` | CI-only disposable ZITADEL readiness, discovery and public JWKS probes (not interactive login) |
| `tests/ci/README.md`, `tests/ci/MINIFEST.md` | CI tool scope and direct-child register |
| `users/ui/package-lock.json` | P05 account npm lock v3, generated metadata-only; reconciles `users/ui/package.json` |
| `auth/ui/v2/pnpm-workspace.yaml` | P05 selected 3 imported workspace members only, no source logic changes |
| `auth/ui/v2/pnpm-lock.yaml` | P05 retained 4 matching importers (root, Login, Client, Proto), package snapshots preserved |
| `project/CI-ARCHITECTURE.md` | Runner/CI security and runtime-verification boundaries |
| `notes/P05-CI-01.md`, `docs/P05-CI-01.md` | Pre-change plan and operator-facing CI evidence |
## Other first-party folders ## Other first-party folders
`packages/README.md`: intentionally empty shared-package placeholder, not the upstream `auth/ui/v2/packages/`. `packages/README.md`: intentionally empty shared-package placeholder, not the upstream `auth/ui/v2/packages/`.
+15
View File
@@ -68,3 +68,18 @@
## Future update minimum for each function ## Future update minimum for each function
Record: exact path, function name/signature, callers, inputs/outputs, error behavior, security assumptions, user-visible effect, tests/CI reference, phase + commit. Do not speculate from a filename alone. Record: exact path, function name/signature, callers, inputs/outputs, error behavior, security assumptions, user-visible effect, tests/CI reference, phase + commit. Do not speculate from a filename alone.
## P05-CI-01 — CI-only verification helpers
| Function | Exact path | Purpose / security boundary |
| --- | --- | --- |
| `fail(message)` | `tests/ci/source_contract.py` | Raise a source-contract assertion with a clear reason |
| `check_account_lock()` | Same | Check npm lock v3 root dependency snapshot against Account Portal manifest |
| `check_login_importers()` | Same | Require exact 4-importer pnpm lockfile and existing 3 upstream workspace members |
| `check_security_boundaries()` | Same | Static source markers for PKCE/state/nonce, expiry and nonempty protected user ID; **not** a behavioral auth test |
| `main()` | Same | Execute CI structural checks and return clear process success/failure |
| `fetch(path)` | `tests/ci/oidc_discovery.py` | HTTP read-only probe of disposable proxy with expected localhost Host header |
| `main()` | Same | Check ZITADEL readiness, issuer discovery metadata and JWKS shape; print explicit interactive OIDC E2E BLOCKED |
Workflow service orchestration is in `.gitea/workflows/p05-ci.yml`, not Python. It executes only in Gitea CI; no local tests were requested. A green source check does not certify real authentication.
+1
View File
@@ -5,6 +5,7 @@
| [README.md](README.md) | Purpose, ownership and update rules for internal developer knowledge | DOCS-01 / active | | [README.md](README.md) | Purpose, ownership and update rules for internal developer knowledge | DOCS-01 / active |
| [MINIFEST.md](MINIFEST.md) | Exact direct-child file inventory | DOCS-01 / active | | [MINIFEST.md](MINIFEST.md) | Exact direct-child file inventory | DOCS-01 / active |
| [ARCHITECTURE.md](ARCHITECTURE.md) | Verified component boundaries, identity flows, future integration boundary | DOCS-01 / active | | [ARCHITECTURE.md](ARCHITECTURE.md) | Verified component boundaries, identity flows, future integration boundary | DOCS-01 / active |
| [CI-ARCHITECTURE.md](CI-ARCHITECTURE.md) | Gitea runner jobs, dependency reconciliation, disposable infrastructure and remaining auth gates | P05-CI-01 / prepared |
| [FILE-MAP.md](FILE-MAP.md) | First-party file + module explanation; upstream source references | DOCS-01 / active | | [FILE-MAP.md](FILE-MAP.md) | First-party file + module explanation; upstream source references | DOCS-01 / active |
| [FUNCTIONS.md](FUNCTIONS.md) | First-party function/route map, safeguards and responsibilities | DOCS-01 / active | | [FUNCTIONS.md](FUNCTIONS.md) | First-party function/route map, safeguards and responsibilities | DOCS-01 / active |
| [FEATURES-AND-PAGES.md](FEATURES-AND-PAGES.md) | Every ZitPlane-owned Account Portal page/API and backend/login capability status | DOCS-01 / active | | [FEATURES-AND-PAGES.md](FEATURES-AND-PAGES.md) | Every ZitPlane-owned Account Portal page/API and backend/login capability status | DOCS-01 / active |
+5
View File
@@ -26,3 +26,8 @@ Use this folder for **architecture, behavior and maintainers' internal details**
The upstream ZITADEL Login V2 was imported unmodified from a pinned revision. Its own read-only internals should be referenced with exact file paths (and added to this knowledge base when modified in an approved later phase), not silently replaced with guessed descriptions. The upstream ZITADEL Login V2 was imported unmodified from a pinned revision. Its own read-only internals should be referenced with exact file paths (and added to this knowledge base when modified in an approved later phase), not silently replaced with guessed descriptions.
**Security:** This is public-repository-appropriate documentation. Never include credentials, session cookies, real account IDs, tokens, production data or sensitive configuration values. **Security:** This is public-repository-appropriate documentation. Never include credentials, session cookies, real account IDs, tokens, production data or sensitive configuration values.
## P05 CI developer entrypoint
Read [CI-ARCHITECTURE.md](CI-ARCHITECTURE.md) for workflow responsibilities, dependency lockfile reconciliation, smoke coverage and outstanding full OIDC gates. CI executes only on Gitea, not the developer PC.
+4
View File
@@ -35,6 +35,10 @@ The Account Portal has **no dependency lockfile** yet. `npm ci`/reproducible bui
- `packages/` is a placeholder for future ZitPlane-owned reusable UI; do not confuse with `auth/ui/v2/packages/` which are pinned upstream dependencies. - `packages/` is a placeholder for future ZitPlane-owned reusable UI; do not confuse with `auth/ui/v2/packages/` which are pinned upstream dependencies.
- `notes/` = phase plans/evidence; `project/` = developer truth; `docs/` = user guides. - `notes/` = phase plans/evidence; `project/` = developer truth; `docs/` = user guides.
## 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.
## Pending checks before any release ## Pending checks before any release
Version security review, reproducible installs, TypeScript/typecheck, Next.js build, OIDC state/PKCE, callback, token expiry, local vs global logout, self-service access, routing, secrets handling, production TLS, backup/restore, monitoring, and isolated Gitea CI verification. No current public deployment exists per recorded phase evidence. Version security review, reproducible installs, TypeScript/typecheck, Next.js build, OIDC state/PKCE, callback, token expiry, local vs global logout, self-service access, routing, secrets handling, production TLS, backup/restore, monitoring, and isolated Gitea CI verification. No current public deployment exists per recorded phase evidence.
+38 -21
View File
@@ -1,26 +1,27 @@
# Source inventory ? all Git-tracked paths # Source inventory ? all Git-tracked paths
**Snapshot:** 2026-11-22, P04 baseline `40af500` + staged DOCS-01 documentation changes. Paths read from the local Git **index**; the pending documentation commit preserves the same tracked file set. **Snapshot:** 2026-11-22, P05-CI-01 staging based on baseline `7ecf531`. Files listed from the local Git index; final Git commit records the snapshot.
**Tracked paths in this snapshot: 701.** Ignored `.env` secrets and unrelated untracked `AI_INSTRUCTIONS.md` are **not included**. **Tracked paths: 714.** Excludes ignored secrets, local builds and untracked `AI_INSTRUCTIONS.md`.
This is an **exact path and ownership locator**, not a claim that every imported function has been reviewed. For first-party behavior see `project/FILE-MAP.md` and `project/FUNCTIONS.md`. The upstream Login V2 subtree is preserved from v4.20.4. This is an exact **source location inventory**, not an audit of each upstream Login V2 function or proof of CI success. For behavior see `project/FILE-MAP.md`, `project/FUNCTIONS.md` and the phase evidence.
| Group | Files | Ownership / history | | Group | Files | Ownership |
| --- | ---: | --- | | --- | ---: | --- |
| `(repository root)` | 6 | First-party root configuration and entrypoints | | `(repository root)` | 6 | Main Git/project config and documentation navigation |
| `auth` | 639 | P03 pinned upstream Login V2 import | | `.gitea` | 5 | Gitea CI workflows and owner documentation |
| `core` | 2 | P02 ZITADEL orchestration, not Go backend source | | `auth` | 639 | Pinned upstream Login V2 and dependency workspace |
| `deployment` | 2 | P02 local-only Compose | | `core` | 2 | Official backend orchestration; not Go core source |
| `docs` | 12 | P01-P04 user/phase evidence + DOCS-01 | | `deployment` | 2 | Local-only P02 Compose |
| `notes` | 4 | DOCS-01 phase plans and records | | `docs` | 13 | User/operator docs and evidence |
| `packages` | 1 | P01 future shared package placeholder | | `notes` | 5 | Phase plans and logs |
| `project` | 9 | DOCS-01 developer knowledge and inventory | | `packages` | 1 | Future first-party shared component placeholder |
| `scripts` | 1 | P01 future script placeholder | | `project` | 10 | Developer knowledge and source inventory |
| `tests` | 2 | P02 backend helper contracts | | `scripts` | 1 | Future development script placeholder |
| `users` | 23 | P04 Account Portal Next.js source | | `tests` | 6 | P02 static and P05 CI-only verification scripts |
| `users` | 24 | P04 Account Portal and P05 lockfile |
## Exact tracked paths ## Exact Git-tracked paths
### (repository root) ? 6 files ### (repository root) ? 6 files
@@ -31,6 +32,14 @@ This is an **exact path and ownership locator**, not a claim that every imported
- `MINIFEST.md` - `MINIFEST.md`
- `README.md` - `README.md`
### .gitea ? 5 files
- `.gitea/MINIFEST.md`
- `.gitea/README.md`
- `.gitea/workflows/MINIFEST.md`
- `.gitea/workflows/README.md`
- `.gitea/workflows/p05-ci.yml`
### auth ? 639 files ### auth ? 639 files
- `auth/ui/v2/.npmrc` - `auth/ui/v2/.npmrc`
@@ -683,7 +692,7 @@ This is an **exact path and ownership locator**, not a claim that every imported
- `deployment/README.md` - `deployment/README.md`
- `deployment/docker/compose.backend.dev.yaml` - `deployment/docker/compose.backend.dev.yaml`
### docs ? 12 files ### docs ? 13 files
- `docs/ARCHITECTURE.md` - `docs/ARCHITECTURE.md`
- `docs/DEVELOPMENT.md` - `docs/DEVELOPMENT.md`
@@ -692,27 +701,30 @@ This is an **exact path and ownership locator**, not a claim that every imported
- `docs/P02-EVIDENCE.md` - `docs/P02-EVIDENCE.md`
- `docs/P03-SOURCE-IMPORT.md` - `docs/P03-SOURCE-IMPORT.md`
- `docs/P04-ACCOUNT-PORTAL.md` - `docs/P04-ACCOUNT-PORTAL.md`
- `docs/P05-CI-01.md`
- `docs/PHASES.md` - `docs/PHASES.md`
- `docs/README.md` - `docs/README.md`
- `docs/SETUP-GUIDE.md` - `docs/SETUP-GUIDE.md`
- `docs/TROUBLESHOOTING.md` - `docs/TROUBLESHOOTING.md`
- `docs/USER-GUIDE.md` - `docs/USER-GUIDE.md`
### notes ? 4 files ### notes ? 5 files
- `notes/CHANGELOG.md` - `notes/CHANGELOG.md`
- `notes/DOCS-01.md` - `notes/DOCS-01.md`
- `notes/MINIFEST.md` - `notes/MINIFEST.md`
- `notes/P05-CI-01.md`
- `notes/README.md` - `notes/README.md`
### packages ? 1 files ### packages ? 1 files
- `packages/README.md` - `packages/README.md`
### project ? 9 files ### project ? 10 files
- `project/ARCHITECTURE.md` - `project/ARCHITECTURE.md`
- `project/CHANGELOG.md` - `project/CHANGELOG.md`
- `project/CI-ARCHITECTURE.md`
- `project/FEATURES-AND-PAGES.md` - `project/FEATURES-AND-PAGES.md`
- `project/FILE-MAP.md` - `project/FILE-MAP.md`
- `project/FUNCTIONS.md` - `project/FUNCTIONS.md`
@@ -725,18 +737,23 @@ This is an **exact path and ownership locator**, not a claim that every imported
- `scripts/README.md` - `scripts/README.md`
### tests ? 2 files ### tests ? 6 files
- `tests/README.md` - `tests/README.md`
- `tests/ci/MINIFEST.md`
- `tests/ci/README.md`
- `tests/ci/oidc_discovery.py`
- `tests/ci/source_contract.py`
- `tests/test_backend_dev.py` - `tests/test_backend_dev.py`
### users ? 23 files ### users ? 24 files
- `users/ui/.env.example` - `users/ui/.env.example`
- `users/ui/.gitignore` - `users/ui/.gitignore`
- `users/ui/README.md` - `users/ui/README.md`
- `users/ui/next-env.d.ts` - `users/ui/next-env.d.ts`
- `users/ui/next.config.ts` - `users/ui/next.config.ts`
- `users/ui/package-lock.json`
- `users/ui/package.json` - `users/ui/package.json`
- `users/ui/src/app/(protected)/account/page.tsx` - `users/ui/src/app/(protected)/account/page.tsx`
- `users/ui/src/app/(protected)/account/profile/page.tsx` - `users/ui/src/app/(protected)/account/profile/page.tsx`
+8
View File
@@ -0,0 +1,8 @@
# tests/ci manifest
| File | Responsibility | Phase |
| --- | --- | --- |
| [README.md](README.md) | CI-only test boundaries and safety constraints | P05-CI-01 |
| [MINIFEST.md](MINIFEST.md) | Exact tests/ci direct-file register | P05-CI-01 |
| [source_contract.py](source_contract.py) | Source and lockfile structural checks, no network/secrets | P05-CI-01 |
| [oidc_discovery.py](oidc_discovery.py) | Disposable ZITADEL ready/discovery/JWKS smoke only | P05-CI-01 |
+10
View File
@@ -0,0 +1,10 @@
# 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, and the public JWKS endpoint on the **disposable** Docker network. It does NOT log in a user, check a real callback, prove protected routes or administer accounts.
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.
Add new CI checks and update `MINIFEST.md`, `project/`, `docs/`, and `notes/` in the same approved phase.
+39
View File
@@ -0,0 +1,39 @@
"""Read-only OIDC smoke: disposable Docker network only; not a login E2E."""
from __future__ import annotations
import json
import os
from urllib.parse import urlparse
from urllib.request import Request, urlopen
PROXY = os.environ.get("ZITPLANE_CI_PROXY", "http://proxy")
EXPECTED_ISSUER = "http://localhost:8080"
HOST = "localhost:8080"
def fetch(path: str):
request = Request(PROXY + path, headers={"Host": HOST, "Accept": "application/json"})
with urlopen(request, timeout=20) as reply:
if reply.status != 200:
raise RuntimeError(f"HTTP {reply.status}: {path}")
return reply.read()
def main() -> None:
fetch("/debug/ready")
print("ZITPLANE_BACKEND_READY_PASS")
discovery = json.loads(fetch("/.well-known/openid-configuration"))
if discovery.get("issuer") != EXPECTED_ISSUER:
raise RuntimeError("OIDC issuer does not match local dev origin")
for field in ("authorization_endpoint", "token_endpoint", "jwks_uri"):
value = discovery.get(field)
if not isinstance(value, str) or not value.startswith(EXPECTED_ISSUER + "/"):
raise RuntimeError(f"Missing/unsafe OIDC {field}")
print("ZITPLANE_OIDC_DISCOVERY_PASS")
jwks_path = urlparse(discovery["jwks_uri"]).path
jwks = json.loads(fetch(jwks_path))
if not isinstance(jwks.get("keys"), list):
raise RuntimeError("Invalid JWKS shape")
print("ZITPLANE_OIDC_JWKS_PASS")
print("ZITPLANE_OIDC_INTERACTIVE_E2E_BLOCKED: no disposable OIDC app/user provisioning in P05")
if __name__ == "__main__":
main()
+75
View File
@@ -0,0 +1,75 @@
"""P05 structural contract checks — CI only, not a build or live auth test."""
from __future__ import annotations
import json
from pathlib import Path
import re
import sys
ROOT = Path(__file__).resolve().parents[2]
ACCOUNT = ROOT / "users/ui"
LOGIN = ROOT / "auth/ui/v2"
def fail(message: str) -> None:
raise AssertionError(message)
def check_account_lock() -> None:
manifest = json.loads((ACCOUNT / "package.json").read_text(encoding="utf-8"))
lock = json.loads((ACCOUNT / "package-lock.json").read_text(encoding="utf-8"))
root = lock["packages"][""]
for group in ("dependencies", "devDependencies"):
if root.get(group) != manifest.get(group):
fail(f"Account {group} diverge from lockfile")
if lock.get("lockfileVersion") != 3:
fail("Expected npm lockfile v3")
if manifest["name"] != lock["name"]:
fail("Account lock name mismatch")
print("ZITPLANE_ACCOUNT_LOCK_CONTRACT_PASS")
def check_login_importers() -> None:
work = (LOGIN / "pnpm-workspace.yaml").read_text(encoding="utf-8")
lock = (LOGIN / "pnpm-lock.yaml").read_text(encoding="utf-8")
expected = {".", "apps/login", "packages/zitadel-client", "packages/zitadel-proto"}
m = re.search(r"(?m)^importers:\s*$", lock)
if not m:
fail("Missing pnpm importers")
n = re.search(r"(?m)^packages:\s*$", lock[m.end():])
if not n:
fail("Missing pnpm package snapshots")
section = lock[m.end():m.end()+n.start()]
importers = set(re.findall(r"(?m)^ ([^\s].*?):\s*$", section))
if importers != expected:
fail(f"Unexpected lock importers: {sorted(importers)}")
for name in sorted(expected - {"."}):
if not (LOGIN / name / "package.json").is_file():
fail(f"Missing actual workspace package {name}")
if f" - {name}\n" not in work:
fail(f"Missing workspace member {name}")
if " - apps/*" in work or " - console" in work:
fail("Unused upstream workspace globs retained")
print("ZITPLANE_LOGIN_WORKSPACE_CONTRACT_PASS")
def check_security_boundaries() -> None:
src = (ACCOUNT / "src/auth.ts").read_text(encoding="utf-8")
endpoint = (ACCOUNT / "src/app/api/account/me/route.ts").read_text(encoding="utf-8")
identity = (ACCOUNT / "src/lib/identity.ts").read_text(encoding="utf-8")
for flag in ('checks: ["pkce", "state", "nonce"]', 'zitadelTokenExpiresAt', 'token.zitadelSubject'):
if flag not in src:
fail(f"Missing reviewed OIDC source contract: {flag}")
if "session?.user?.id" not in endpoint or "session?.user?.id" not in identity:
fail("Protected source must gate on valid user id")
print("ZITPLANE_SOURCE_GUARD_CONTRACT_PASS")
def main() -> int:
check_account_lock()
check_login_importers()
check_security_boundaries()
print("ZITPLANE_SOURCE_CONTRACTS_PASS")
return 0
if __name__ == "__main__":
try:
sys.exit(main())
except (AssertionError, ValueError, KeyError, FileNotFoundError) as exc:
print(f"ZITPLANE_SOURCE_CONTRACTS_FAIL: {exc}", file=sys.stderr)
sys.exit(1)
+1189
View File
File diff suppressed because it is too large. Load diff