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 |
| --- | --- | --- | --- |
| `.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 |
| `core/` | folder | P02 official ZITADEL image/config plus dev helper | P01/P02; runtime unverified |
| `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.
- **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.**
- **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.
## 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) |
| `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 |
| `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 |
## Local development (requires Docker Desktop Linux containers)
+1 -439
View File
@@ -15,6 +15,7 @@ overrides:
importers:
.:
devDependencies:
'@bufbuild/buf':
@@ -36,160 +37,6 @@ importers:
specifier: ^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:
dependencies:
'@braintree/sanitize-url':
@@ -455,268 +302,6 @@ importers:
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))
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:
dependencies:
'@bufbuild/protobuf':
@@ -791,29 +376,6 @@ importers:
specifier: ^2.12.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:
+3 -5
View File
@@ -1,9 +1,7 @@
packages:
- console
- tests/*
- packages/*
- apps/*
- deploy/compose
- apps/login
- packages/zitadel-client
- packages/zitadel-proto
exclude:
- benchmark # because of the node 18 or 20 dependency
+3 -2
View File
@@ -1,6 +1,6 @@
# 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 |
| --- | --- | --- | --- |
@@ -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 |
| Global ZITADEL SSO logout | No | 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 |
| Public `auth.vib.tools/login` URL | 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 |
| [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 |
| [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 |
| [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 |
@@ -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 |
| [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.
- Evidence and pending runtime acceptance: `docs/P04-ACCOUNT-PORTAL.md`.
## P05 — Integration (proposed, NOT approved)
Local development, shared UI tokens as needed, production-safe Docker topology, routing drafts, tests/docs. No live deployment.
## P05-CI-01 — Gitea Actions Verification Foundation (APPROVED 2026-11-22)
- 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)
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.
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.
## 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
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 | 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 | 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.
+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 |
| [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 |
| [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 |
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 | 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 | 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
+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
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.
## 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
`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
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 |
| [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 |
| [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 |
| [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 |
+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.
**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.
- `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
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
**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 |
| `auth` | 639 | P03 pinned upstream Login V2 import |
| `core` | 2 | P02 ZITADEL orchestration, not Go backend source |
| `deployment` | 2 | P02 local-only Compose |
| `docs` | 12 | P01-P04 user/phase evidence + DOCS-01 |
| `notes` | 4 | DOCS-01 phase plans and records |
| `packages` | 1 | P01 future shared package placeholder |
| `project` | 9 | DOCS-01 developer knowledge and inventory |
| `scripts` | 1 | P01 future script placeholder |
| `tests` | 2 | P02 backend helper contracts |
| `users` | 23 | P04 Account Portal Next.js source |
| `(repository root)` | 6 | Main Git/project config and documentation navigation |
| `.gitea` | 5 | Gitea CI workflows and owner documentation |
| `auth` | 639 | Pinned upstream Login V2 and dependency workspace |
| `core` | 2 | Official backend orchestration; not Go core source |
| `deployment` | 2 | Local-only P02 Compose |
| `docs` | 13 | User/operator docs and evidence |
| `notes` | 5 | Phase plans and logs |
| `packages` | 1 | Future first-party shared component placeholder |
| `project` | 10 | Developer knowledge and source inventory |
| `scripts` | 1 | Future development script placeholder |
| `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
@@ -31,6 +32,14 @@ This is an **exact path and ownership locator**, not a claim that every imported
- `MINIFEST.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/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/docker/compose.backend.dev.yaml`
### docs ? 12 files
### docs ? 13 files
- `docs/ARCHITECTURE.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/P03-SOURCE-IMPORT.md`
- `docs/P04-ACCOUNT-PORTAL.md`
- `docs/P05-CI-01.md`
- `docs/PHASES.md`
- `docs/README.md`
- `docs/SETUP-GUIDE.md`
- `docs/TROUBLESHOOTING.md`
- `docs/USER-GUIDE.md`
### notes ? 4 files
### notes ? 5 files
- `notes/CHANGELOG.md`
- `notes/DOCS-01.md`
- `notes/MINIFEST.md`
- `notes/P05-CI-01.md`
- `notes/README.md`
### packages ? 1 files
- `packages/README.md`
### project ? 9 files
### project ? 10 files
- `project/ARCHITECTURE.md`
- `project/CHANGELOG.md`
- `project/CI-ARCHITECTURE.md`
- `project/FEATURES-AND-PAGES.md`
- `project/FILE-MAP.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`
### tests ? 2 files
### tests ? 6 files
- `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`
### users ? 23 files
### users ? 24 files
- `users/ui/.env.example`
- `users/ui/.gitignore`
- `users/ui/README.md`
- `users/ui/next-env.d.ts`
- `users/ui/next.config.ts`
- `users/ui/package-lock.json`
- `users/ui/package.json`
- `users/ui/src/app/(protected)/account/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