docs(docs): gate stages (drift, advisories), native exposure note, CI target wording, check:all in WORKSPACE and TEST_STRATEGY

This commit is contained in:
bchanot committed 2026-10-13 09:46:07 +02:00
1 parent e58c7be362
commit 073b25e52b
4 files changed
+27 -10

No files matched your search

+14 -3
View File
@@ -91,6 +91,14 @@ separate caches; neither invalidates the other.
uses; it is not needed for a compile or a test on the development
machine.
Exposure change, stated for the record: a native build runs the build
scripts and proc-macros of the dependencies under the user account (the
builder container ran them with the repository mounted read-write, so the
difference is the rest of the home directory). Mitigations in place:
`--locked` everywhere, `deny.toml` `[sources]` limited to crates.io with
unknown registries and git sources denied, `cargo deny check licenses bans
sources` in every check.
## 2. Workspace
```text
@@ -203,7 +211,10 @@ pnpm check:all # scripts/check-all.sh, stops at the first failure
```
Stages, in order: `scripts/rust-check.sh` (native), the ts-rs types drift
(`git diff --exit-code -- packages/core-wasm/types`), `scripts/wasm-build.sh`
(`git status --porcelain -- packages/core-wasm/types` must be empty: a
modified or a new type file both fail), `cargo deny check advisories`
(warn-only: out of the blocking path by design, review VIII.3, but printed
here because no nightly job runs yet; needs the network), `scripts/wasm-build.sh`
(native), `pnpm check` (typecheck, tests including the `core-wasm` proofs on
the module just built and the pgTAP suite on PGlite, lint, build), the
application image, `pnpm worker:test` (sandbox tests and seccomp derivation
@@ -235,8 +246,8 @@ same scripts:
`faunosteo_worker:<sha>` and print their digests. Deploys nothing
(DEPLOY.md "Image deploy by digest").
Target of the future CI/CD step (not implemented, recorded so the scripts
stay compatible): tests on every push and pull request, Rust and
Target of the future CI/CD step (planned, not yet built; recorded so the
scripts stay compatible): tests on every push and pull request, Rust and
TypeScript checks, PostgreSQL/RLS tests, Docker builds, security checks,
branch verification before a merge, image publication only in an
explicitly authorised workflow.
+1 -1
View File
@@ -1011,7 +1011,7 @@ and VIII.4 and are implemented on `feature/rust-r0-foundation`:
workflow is never reported as passed before it has run on the forge. The
pre-merge gate is local: `pnpm check:all` (`scripts/check-all.sh`), which a
future runner calls as is.
- Target of that future step (not implemented): tests on every push and pull
- Target of that future step (planned, not yet built): tests on every push and pull
request, Rust and TypeScript checks, PostgreSQL/RLS tests, Docker builds,
security checks, branch verification before a merge, image publication
only in an explicitly authorised workflow.
+10 -5
View File
@@ -76,12 +76,17 @@ Target after Step 1: roughly 230–250 cases, all current ones untouched.
- Golden PDFs are compared by extracted text and attachment JSON, not by
bytes (pdf-lib dates and ids vary); raster hash only on fixed-size inputs.
## 5. CI gates
## 5. Gates before a merge, and the CI target
Per PR: `pnpm typecheck`, `pnpm lint` (0 warnings), `pnpm test:run`,
`pnpm build`; when `supabase/` changes: `supabase db reset`, `supabase test
db`, types diff. Nightly: Playwright suite. Release: full RLS matrix,
backup/restore rehearsal checklist, `pnpm audit`, secret scan.
Today (2026-10-13) no CI runs on the forge; the gate is run on the
development machine: `pnpm check:all` (`docs/development/RUST.md` §4) before
every merge, plus `supabase db reset`, `supabase test db` and the types diff
when `supabase/` changes. The workflow files under `.gitea/workflows/` are
prepared for a future runner and call the same scripts.
CI target (planned): per PR the stages of `pnpm check:all`; nightly the
Playwright suite and `cargo deny check advisories`; at release the full RLS
matrix, the backup/restore rehearsal checklist, `pnpm audit`, a secret scan.
## 6. Numbers to track
+2 -1
View File
@@ -92,7 +92,8 @@ works as `corepack pnpm <cmd>`.
| `pnpm test` | vitest watch for `apps/app` |
| `pnpm lint` | ESLint, 0 warnings, in every package |
| `pnpm build` | typecheck + Vite build in every package |
| `pnpm check` | typecheck, test:run, lint, build in sequence (what CI runs) |
| `pnpm check` | typecheck, test:run, lint, build in sequence (the Node gate) |
| `pnpm check:all` | the whole pre-merge gate: native Rust check, types drift, wasm build, `pnpm check`, application and worker images (`docs/development/RUST.md` §4; no CI runs it yet) |
| `pnpm format` | Prettier on the whole repository |
Package-scoped: `pnpm --filter @faunosteo/app <script>`.