docs(ci): plan P05 SEC-02 A01 focused Login acceptance

This commit is contained in:
Vib Tools committed 2026-11-22 08:30:02 -08:00
1 parent 7655dbdcb4
commit ff4c58ed86
12 files changed
+92 -15

No files matched your search

+1
View File
@@ -12,6 +12,7 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
| [P05-CI-03.md](P05-CI-03.md) | Isolated backend-only Gitea CI procedure, checks and exact run outcomes | P05-CI-03 / Run #86 SUCCESS |
| [P05-SEC-01.md](P05-SEC-01.md) | Source-grounded dependency security patches, advisory blockers and CI verification | P05-SEC-01 / Run #87 3 PASS/1 FAIL, 2 Moderate open |
| [P05-SEC-02.md](P05-SEC-02.md) | Seven scoped PNPM parent overrides, patched lock and manual Login-only security CI evidence | P05-SEC-02 / Run #88 partial: security zero, build unverified |
| [P05-SEC-02-A01.md](P05-SEC-02-A01.md) | Gitea-only Login V2 full frozen-install/build/units/zero-advisory acceptance and status | P05-SEC-02-A01 / pending acceptance |
| [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 |
+21
View File
@@ -0,0 +1,21 @@
# P05-SEC-02-A01 — Login Dependency Security Final Acceptance
**Date:** 2026-11-22
**Scope:** Gitea-only focused CI verification of the *already committed* corrected PNPM transitive-override validator and frozen Login V2 security dependencies.
**Baseline:** `7655dbdcb48c49aab8f3bf97aab8f1867f129531`.
**Status:** one Gitea CI run planned; **no new application/CI code change**.
## Why this follow-up exists
In Gitea [Run #88](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/88), Login security audit job #192 passed with **0 Moderate, 0 High, 0 Critical** after seven parent-scoped `glob@14.0.6` and `minimatch@11.0.9` resolutions. However Login build job #190 never reached frozen install because a new CI-only parser incorrectly interpreted old `axios@>=...` and similar root version-range keys as new parent selectors. The parser was subsequently restricted to explicit `>glob` or `>minimatch` selectors and committed, but **the corrected parser had not been tested by Gitea**.
## How to verify
Open Gitea [ZitPlane Actions](https://dev.ivib.cc/vibtools/ZitPlane/actions). Select **ZitPlane P05 Dependency Security Acceptance (SEC-01/02)**, dispatch `main` with `login_only=true`. A valid result has **two Account jobs SKIPPED** and only two Login jobs executing:
- Login job: source-level exact seven parent selector/lockfile contract → pinned `pnpm@10.30.3 install --frozen-lockfile` → original Nx proto/client/Next Login V2 standalone production build → upstream Vitest. Each check must execute; a skipped or failed check is not a PASS.
- Security job: nonmutating `pnpm audit --prod`, strict High/Critical gate and separate complete-report zero Moderate/High/Critical gate.
**Full phase PASS** requires a green overall run, a frozen install, a generated standalone Login build, actual upstream unit-test count and zero Moderate/High/Critical vulnerabilities, with no source edit outside Scope Lock. If CI fails, note the exact blocker and do not rerun. No real login/MFA, ZITADEL integration or Coolify production deployment is covered.
**Status:** awaiting this single authorized run. Full pre-change scope, exact root cause and result ledger: `notes/P05-SEC-02-A01.md`. Historical dependency patch evidence: `project/DEPENDENCY-SECURITY.md` and `docs/P05-SEC-02.md`.
+5
View File
@@ -65,6 +65,11 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
- Seven **exact parent-scoped** overrides: two glob10 parents → glob14.0.6, five minimatch10 parents → minimatch11.0.9. No broad global major override; pinned PNPM 10.30.3 metadata-only lockfile regeneration; compatibility subject to CI proof.
- **Actual Gitea Run #88**, tested source SHA `66cfed5a8b6bd5845b229c9934695e307f9a0775`, overall **FAILURE**: Account jobs correctly SKIPPED, Login live production audit **0 Moderate/High/Critical PASS**; Login build job FAIL before frozen install because new contract helper falsely treated existing `>=` semver ranges as parent overrides. No frozen install/build/units executed in this run. Corrected parser to recognize exact `>glob` or `>minimatch` selectors after the run, **not CI-verified**. Full security/compatibility acceptance **BLOCKED** pending separately approved focused CI; one run only, no local app builds/tests or deployment. Exact evidence: `notes/P05-SEC-02.md`, `docs/P05-SEC-02.md`.
## P05-SEC-02-A01 — Login Build & Security Final Acceptance (APPROVED 2026-11-22)
- Baseline `7655dbdcb48c49aab8f3bf97aab8f1867f129531`. Previous Run #88 security 0 Moderate/High/Critical; Login frozen/build/unit unexecuted due CI helper `>=` selector false-positive. Corrected parser is committed but not yet CI-verified.
- **Exact Scope Lock:** `tests/ci/transitive_override_contract.py` and `.gitea/workflows/p05-security-acceptance.yml` only if a NEW exact validator/CI defect is reproduced; `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST for evidence. All PNPM lock/config/manifests, original Login/UI/auth, Account Portal, ZITADEL backend, Compose, production and unrelated files read-only. Preserve untracked `AI_INSTRUCTIONS.md`.
- **Plan:** no code change necessary from initial source review. Record plan before edits. Commit/push documentation; ONE Gitea `workflow_dispatch` with `login_only=true`; verify exact seven override contract, frozen PNPM 10.30.3 install, Nx proto/client/Login standalone build, upstream Vitest and live zero Moderate/High/Critical audit. Account and backend jobs skipped; no local app test/build/deploy. Document exact run results and remote SHA. `notes/P05-SEC-02-A01.md`, `docs/P05-SEC-02-A01.md`.
## P05 - Full Integration (proposed, NOT approved)
Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval.
+5
View File
@@ -92,3 +92,8 @@ Gitea `vibtools/ZitPlane` → Actions → **ZitPlane P05 Dependency Security Acc
**P05-SEC-02 verified outcome:** Gitea [Run #88](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/88) with `login_only=true` proved a clean Login production registry audit (**zero known Moderate/High/Critical**), while Account jobs were correctly skipped. The Login build/unit job did not reach frozen install because a new CI helper misparsed `>=` version-range selectors; a post-run source-only parser correction is **unverified**. **Do not deploy or claim Login dependency compatibility until the separately approved P05-SEC-02-A01 CI completes.** No local build/test is required.
## P05-SEC-02-A01 — one-run Login security/build verification
Use Gitea Actions → **ZitPlane P05 Dependency Security Acceptance (SEC-01/02)** → manual `main` workflow with `login_only=true`. Only Login frozen PNPM install, proto/client/Next standalone build, upstream Vitest and zero Moderate/High/Critical live registry audit should run. Account jobs should be skipped (Run #87 already accepted), and there is no backend, human identity or production deployment. A successful security audit alone is insufficient; the login build/unit job must also pass. Actual results will be in `docs/P05-SEC-02-A01.md` and `notes/P05-SEC-02-A01.md`.