docs(docs): Ubuntu native development, Docker for services and isolation, separate VPS; pnpm check:all; CI status
RUST.md §1 (three environments, native install recipe, what stays in Docker and why), §4 (pre-merge gate, workflow files prepared and never run), §5.8 (native run numbers against the builder image), §6; CLAUDE.md stack row, commands, map, workflow rule; README quick start and verification; DEPLOY.md CI status; WORKSPACE.md; TEST_STRATEGY.md; CHANGELOG; review Annex C.1 addendum of 2026-10-13.
This commit is contained in:
1 parent
981a66f33b
commit
6e2bbec4b0
8 files changed
+233
-68
No files matched your search
+157
-50
@@ -8,37 +8,88 @@ sandboxed child, the browser module loader and seven experimental proofs. No
|
||||
application behaviour, interface, archive or database changes; the frontend
|
||||
does not load the module before R2; the worker's job loop arrives at R1.
|
||||
|
||||
## 1. Toolchain: reproducible in Docker, never on the VPS
|
||||
## 1. Toolchain: native on the development machine, reproducible in Docker, never on the VPS
|
||||
|
||||
Every cargo command runs inside the reference builder image, so CI and a
|
||||
developer machine use the same compiler and the production VPS never needs
|
||||
Rust (images are built in CI and pulled by digest, DEPLOY.md "Image deploy by
|
||||
digest").
|
||||
Three environments, three roles (owner decision of 2026-10-13, review Annex C
|
||||
addendum). The development machine is a self-hosted Ubuntu server (native,
|
||||
not WSL, not the VPS) with Docker rootless.
|
||||
|
||||
| Piece | Where | Pinned by |
|
||||
| Environment | Role | Rust |
|
||||
|---|---|---|
|
||||
| Rust 1.99.0, edition 2024, rustfmt, clippy, `wasm32-unknown-unknown` | `docker/rust-builder.Dockerfile` (`FROM rust:1.99.0-bookworm`) | `rust-toolchain.toml` (same channel; a difference would make rustup download inside the container) |
|
||||
| `wasm-bindgen-cli` 0.2.129 | same image | `wasm-bindgen = "=0.2.129"` in `Cargo.toml`; `docker/wasm-build.sh` refuses to run when `Cargo.lock` and the CLI differ |
|
||||
| `cargo-deny` 0.20.2 | same image | `deny.toml` |
|
||||
| worker builder | `crates/worker/Dockerfile` (`FROM rust:1.99.0-alpine3.24`, `build-base` for libwebp) | same channel |
|
||||
| Ubuntu development machine, native | daily development (`cargo check / test / build / clippy / fmt`), the browser module build, every check before a merge (`pnpm check:all`) | user-level `rustup` in `~/.cargo` and `~/.rustup`, channel pinned by `rust-toolchain.toml` |
|
||||
| Docker on that machine | the Supabase stack, the worker's sandbox tests and seccomp derivation, integration tests, the application and worker images, and the reproducible run of the same Rust scripts through the builder image | inside images only |
|
||||
| Production VPS | runs images; never compiles | none |
|
||||
|
||||
Commands (root `package.json`):
|
||||
### 1.1 Native toolchain (the primary path)
|
||||
|
||||
Everything lives in the user's home: no global package, no `sudo`. Checked on
|
||||
2026-10-13 (Ubuntu 26.04.1, x86_64): `build-essential` (gcc 15, the C
|
||||
compiler that builds the worker's vendored libwebp), `libc6-dev`,
|
||||
`pkg-config`, `libssl-dev` and `strace` were already installed; no system
|
||||
package is missing.
|
||||
|
||||
```bash
|
||||
pnpm rust:builder # builds faunosteo_rust_builder:1.99.0 once (about 6 minutes cold)
|
||||
pnpm rust:check # docker/rust-check.sh: fmt --check, clippy -D warnings (all targets),
|
||||
# cargo test (core, wasm), ts-rs export, cargo deny licenses/bans/sources
|
||||
pnpm wasm:build # crates/wasm → packages/core-wasm/pkg (git-ignored), prints raw and gzip sizes
|
||||
pnpm worker:test # crates/worker/Dockerfile stage test: 13 sandbox tests + seccomp derivation
|
||||
pnpm worker:image # runtime image faunosteo_worker:dev (distroless/static:nonroot)
|
||||
bash docker/rust-run.sh cargo <anything> # any cargo command in the builder
|
||||
# once: rustup, the user-level installer (https://rustup.rs); ~/.bashrc and ~/.profile source ~/.cargo/env
|
||||
rustup show # from the repository: installs 1.99.0 + rustfmt + clippy
|
||||
rustup target add wasm32-unknown-unknown # browser build of crates/wasm
|
||||
cargo install wasm-bindgen-cli --version 0.2.129 --locked # = the wasm-bindgen crate in Cargo.lock
|
||||
cargo install cargo-deny --version 0.20.2 --locked
|
||||
```
|
||||
|
||||
`docker/rust-run.sh` mounts the repository at `/w` and keeps Cargo's registry
|
||||
and the target directory in the named volumes `faunosteo_cargo_registry` and
|
||||
`faunosteo_rust_target` (incremental builds take seconds). A local `rustup`
|
||||
is optional for the inner loop (same `rust-toolchain.toml`); the container is
|
||||
the arbiter.
|
||||
`rustup show` run inside the repository installs the channel of
|
||||
`rust-toolchain.toml` (rustup auto-install), so `cargo` here is always
|
||||
1.99.0 whatever the default toolchain of the machine. Non-interactive
|
||||
shells (editor tasks, git hooks, agent shells) skip `~/.bashrc` and start
|
||||
without `~/.cargo/bin` on PATH: the scripts source `scripts/rust-env.sh`,
|
||||
which prepends it when `cargo` is not found.
|
||||
|
||||
| Piece | Native | Builder image | Pinned by |
|
||||
|---|---|---|---|
|
||||
| Rust 1.99.0, edition 2024, rustfmt, clippy | `rustup show` (auto-install) | `FROM rust:1.99.0-bookworm` + `rustup component add` | `rust-toolchain.toml` |
|
||||
| `wasm32-unknown-unknown` | `rustup target add` | `RUN rustup target add` | same channel |
|
||||
| `wasm-bindgen-cli` 0.2.129 | `cargo install --locked` | same | `wasm-bindgen = "=0.2.129"` in `Cargo.toml`; `scripts/wasm-build.sh` refuses to run when `Cargo.lock` and the CLI on PATH differ |
|
||||
| `cargo-deny` 0.20.2 | `cargo install --locked` | same | `deny.toml` |
|
||||
| worker builder (musl, libwebp) | not native: sandbox tests run in Docker only | `crates/worker/Dockerfile` (`FROM rust:1.99.0-alpine3.24`, `build-base`) | same channel |
|
||||
|
||||
Commands (root `package.json`; every Rust script is one file run natively
|
||||
or inside the builder image):
|
||||
|
||||
```bash
|
||||
pnpm rust:check # scripts/rust-check.sh, native: fmt --check, clippy -D warnings (all targets),
|
||||
# cargo test (core, wasm, worker unit tests), ts-rs export, cargo deny licenses/bans/sources
|
||||
pnpm wasm:build # scripts/wasm-build.sh, native: crates/wasm → packages/core-wasm/pkg (git-ignored), sizes printed
|
||||
pnpm check:all # scripts/check-all.sh: the pre-merge gate (§4): rust:check, types drift, wasm:build,
|
||||
# pnpm check, application image, worker:test, worker:image started read-only
|
||||
pnpm rust:check:docker # the same rust-check.sh inside the builder image (reproducible run)
|
||||
pnpm wasm:build:docker # the same wasm-build.sh inside the builder image
|
||||
pnpm rust:builder # builds faunosteo_rust_builder:1.99.0 once (about 6 minutes cold)
|
||||
pnpm worker:test # Docker only: crates/worker/Dockerfile stage test, 16 sandbox tests + seccomp derivation
|
||||
pnpm worker:image # Docker only: runtime image faunosteo_worker:dev (distroless/static:nonroot)
|
||||
bash docker/rust-run.sh cargo <anything> # any cargo command in the builder
|
||||
cargo check | test | build | clippy | fmt # the inner loop, from the repository root
|
||||
```
|
||||
|
||||
The native `target/` (git-ignored, `.dockerignore`d) and the builder's named
|
||||
volumes `faunosteo_cargo_registry` / `faunosteo_rust_target` are two
|
||||
separate caches; neither invalidates the other.
|
||||
|
||||
### 1.2 What stays in Docker, and why
|
||||
|
||||
- The worker's sandbox tests (`crates/worker/tests/sandbox.rs`) are gated by
|
||||
the `test-hooks` feature: a native `cargo test` compiles that target empty
|
||||
and runs the worker's unit tests only. The seccomp allowlist is derived by
|
||||
`strace` on the **musl static binary that ships**, inside the Alpine
|
||||
`test` stage, and glibc would need other syscalls (`brk`, `mprotect`,
|
||||
`futex`): running the sandbox natively would either kill a legitimate
|
||||
decode or prove nothing about the shipped binary. `pnpm worker:test` is
|
||||
the only path, and the worker keeps running in its container.
|
||||
- The Supabase stack, the application image, the worker image and the
|
||||
integration tests on them: `pnpm db:start`, `docker build -t faunosteo .`,
|
||||
`pnpm worker:image`.
|
||||
- The builder image stays as the reproducible alternative (same compiler,
|
||||
same tools, a clean environment) and as the reference a future runner
|
||||
uses; it is not needed for a compile or a test on the development
|
||||
machine.
|
||||
|
||||
## 2. Workspace
|
||||
|
||||
@@ -140,35 +191,60 @@ from the shipped one by the feature-gated hooks only), `runtime`
|
||||
binary), `run --check` exits 0 with `--read-only --cap-drop ALL
|
||||
--security-opt no-new-privileges:true`.
|
||||
|
||||
## 4. CI
|
||||
## 4. Checks before a merge, and the workflow files (prepared, no CI active)
|
||||
|
||||
- Job `rust` (before `check`): builds the builder image, runs
|
||||
`docker/rust-check.sh`, checks the committed ts-rs types for drift, builds
|
||||
the browser module (size printed).
|
||||
- Job `check`: builds the module the same way, then the existing Node
|
||||
pipeline; the `core-wasm` proofs run because `pkg/` exists.
|
||||
- Job `docker`: application image, worker `test` stage (sandbox tests and
|
||||
seccomp derivation on the musl binary that ships), worker runtime image
|
||||
started once with `--read-only --cap-drop ALL`.
|
||||
No CI/CD runs on the forge today (2026-10-13): no runner, no secret, no
|
||||
registry. The YAML files under `.gitea/workflows/` are kept as prepared
|
||||
material for that separate decision; a green workflow is never claimed
|
||||
until one has actually run on the forge. Until then the gate is local:
|
||||
|
||||
```bash
|
||||
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`
|
||||
(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
|
||||
on the musl binary), `pnpm worker:image` started once with `--read-only
|
||||
--cap-drop ALL`. The local Supabase stack is not required; `pnpm db:test`
|
||||
is the real-stack complement after a change under `supabase/`.
|
||||
|
||||
Workflow files, each mapping onto those stages so a future runner calls the
|
||||
same scripts:
|
||||
|
||||
- `ci.yml` (push on main/develop, pull requests): job `rust` (builder image,
|
||||
`scripts/rust-check.sh`, types drift, `scripts/wasm-build.sh`), job `check`
|
||||
(module built the same way, then the Node pipeline), job `docker`
|
||||
(application image, worker `test` stage, worker runtime started read-only),
|
||||
job `supabase` (real stack, pgTAP, generated types diff).
|
||||
- `rust-advisories.yml`: nightly and manual `cargo deny check advisories`,
|
||||
out of the blocking path on purpose.
|
||||
- `release-images.yml`: manual only; the dispatch input is a typed choice
|
||||
re-validated through an environment variable; the RustSec and npm
|
||||
(`pnpm audit --prod`) advisories gates run first; a named ephemeral
|
||||
`buildx` builder (`--builder`, no silent fallback) with its own cache
|
||||
builds the images; the registry token reaches the login step only, into
|
||||
a per-job `DOCKER_CONFIG` under `RUNNER_TEMP` created before any step and
|
||||
removed by a literal path; digests read from the build metadata;
|
||||
`actions/checkout` pinned to a commit. The `if: github.ref` line is not a
|
||||
boundary (push access and the token's scope are; a dedicated release
|
||||
runner label is the Step 27 operation). It pushes `faunosteo_app:<sha>`
|
||||
and `faunosteo_worker:<sha>` and prints their digests. Deploys nothing
|
||||
(`pnpm audit --prod`) advisories gates run first in a job without
|
||||
secrets; a named ephemeral `buildx` builder (`--builder`, no silent
|
||||
fallback) with its own cache builds the images; the registry token
|
||||
reaches the login step only, into a per-job `DOCKER_CONFIG` under
|
||||
`RUNNER_TEMP` created before any step and removed by a literal path;
|
||||
digests read from the build metadata; `actions/checkout` pinned to a
|
||||
commit. The `if: github.ref` line is not a boundary (push access and the
|
||||
token's scope are; a dedicated release runner label is the Step 27
|
||||
operation). It would push `faunosteo_app:<sha>` and
|
||||
`faunosteo_worker:<sha>` and print their digests. Deploys nothing
|
||||
(DEPLOY.md "Image deploy by digest").
|
||||
|
||||
Not measured here: the forge runner's cache behaviour and cold build times
|
||||
(the runner was not available from this host). The builder image build took
|
||||
about 6 minutes cold on the development host; both image builds reuse
|
||||
BuildKit cache mounts (`faunosteo_cargo_registry_musl`,
|
||||
Target of the future CI/CD step (not implemented, 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.
|
||||
|
||||
Not measured: the forge runner's cache behaviour, cold build times and the
|
||||
workflow syntax (job-level `env`, `GITHUB_ENV` path) have never run. The
|
||||
builder image build took about 6 minutes cold on the development host; both
|
||||
image builds reuse BuildKit cache mounts (`faunosteo_cargo_registry_musl`,
|
||||
`faunosteo_target_musl`).
|
||||
|
||||
## 5. R0 proofs (2026-10-12, development host, Docker 29.8 rootless, kernel 7.0)
|
||||
@@ -267,14 +343,43 @@ builder image cold build about 6 minutes; worker test stage cold about 2
|
||||
minutes, warm under 30 s with the BuildKit cache mounts; the wasm build
|
||||
under 10 s warm. The first run on the forge records its own numbers here.
|
||||
|
||||
### 5.8 Native toolchain run (2026-10-13, Ubuntu 26.04.1, rustup 1.29.1, 16 cores)
|
||||
|
||||
Same proofs, native toolchain (`rustc 1.99.0 (b940084d7 2026-09-28)`,
|
||||
`cargo 1.99.0`, `clippy 0.1.99`, `rustfmt 1.10.0-stable`, `wasm-bindgen
|
||||
0.2.129`, `cargo-deny 0.20.2`), compared with the builder image runs above:
|
||||
|
||||
| Measure | Native | Builder image (R0) |
|
||||
|---|---|---|
|
||||
| cold `cargo build --workspace --all-targets` (libwebp compiled by gcc 15) | 31.5 s | not timed at R0 |
|
||||
| cold wasm release build | 4.3 s | under 10 s warm |
|
||||
| `scripts/rust-check.sh` warm (fmt, clippy, tests, ts export, deny) | 32 s | 2.2 s warm volumes (same script, same results) |
|
||||
| cargo tests | core 10 + 2, worker unit 9, core with `ts` 14 + 2, all green | identical counts |
|
||||
| committed ts-rs types | unchanged after the export | unchanged |
|
||||
| `faunosteo_wasm_bg.wasm` raw | 224 777 B | 224 713 B |
|
||||
| gzip -9 | 84 924 B (`gzip`), 85 390 B (the vitest measure) | 84 927 B / 85 396 B |
|
||||
| sha256 | `2d559a6b…bb3a` | `451d49c1…a752` |
|
||||
| core-wasm proofs | 14 passed, instantiate 3.9 ms | 14 passed, 2.7 ms |
|
||||
|
||||
The 64-byte difference and the distinct hashes come from the source paths
|
||||
embedded in the panic locations (`/home/<user>/Documents/faunosteo/…`
|
||||
natively, `/w/…` in the builder): the module is not bit-reproducible across
|
||||
build roots without `--remap-path-prefix`, which R0 does not set. The
|
||||
builder image is the reference when two builds must match byte for byte.
|
||||
`cargo deny` prints the same warnings in both environments
|
||||
(`license-not-encountered` for six allowed licences, duplicate `miniz_oxide`
|
||||
and `syn`): policy `warn`, not failures.
|
||||
|
||||
## 6. Reproduction
|
||||
|
||||
```bash
|
||||
pnpm rust:builder && pnpm rust:check # §2, §5.2 (cargo side)
|
||||
pnpm wasm:build && pnpm --filter @faunosteo/core-wasm test:run # §5.1, §5.2, §5.6
|
||||
pnpm worker:test # §5.3, §5.4 (tests + derivation in the build log)
|
||||
pnpm rust:check # §2, §5.2 (cargo side), native
|
||||
pnpm wasm:build && pnpm --filter @faunosteo/core-wasm test:run # §5.1, §5.2, §5.6, native module
|
||||
pnpm rust:builder && pnpm rust:check:docker && pnpm wasm:build:docker # the same, reproducible in the builder
|
||||
pnpm worker:test # §5.3, §5.4 (tests + derivation in the build log)
|
||||
pnpm worker:image && docker run --rm --read-only --cap-drop ALL faunosteo_worker:dev # §3
|
||||
CHROME=<chromium binary> bash docker/csp-proof/run.sh # §5.5 (playwright-core on NODE_PATH)
|
||||
CHROME=<chromium binary> bash docker/csp-proof/run.sh # §5.5 (playwright-core on NODE_PATH)
|
||||
pnpm check:all # everything above but the CSP proof, in one command
|
||||
```
|
||||
|
||||
## 7. What stays hypothetical after R0
|
||||
@@ -291,7 +396,9 @@ CHROME=<chromium binary> bash docker/csp-proof/run.sh # §5.5 (playwright-core
|
||||
built: R2 builds and tests it.
|
||||
- HTTPS from the worker (CA bundle of distroless, `webpki-roots`): no HTTP
|
||||
client in the R0 binary; R1 adds `reqwest` and the CI HTTPS call.
|
||||
- The forge runner's cache and timings (§5.7).
|
||||
- The forge runner's cache and timings (§5.7), and the workflow files
|
||||
themselves: no runner exists, none of the three workflows has ever run
|
||||
(§4).
|
||||
- The allowlist is x86_64; an aarch64 host would need its own derivation
|
||||
(`target_arch` selects the seccomp architecture, the syscall numbers come
|
||||
from `libc`).
|
||||
@@ -985,3 +985,35 @@ frontend to load the module; no anatomy, PDF or business validation
|
||||
migration (R2–R5); no avatar processing (R1); everything dockerised, the
|
||||
production image produced in CI and pulled by the VPS; the live deployment
|
||||
untouched; no tag or merge into main.
|
||||
|
||||
### C.1 Addendum 2026-10-13: development environment and CI status (owner brief after R0)
|
||||
|
||||
R0 delivered and validated on the architecture. The owner corrected the
|
||||
development organisation before closing R0; these points amend Annex B §B.1
|
||||
and VIII.4 and are implemented on `feature/rust-r0-foundation`:
|
||||
|
||||
- Three environments, three roles. The development machine is a self-hosted
|
||||
Ubuntu server (native, not WSL, not the VPS) with Docker rootless: Rust is
|
||||
developed and compiled **natively** there (user-level `rustup`, channel of
|
||||
`rust-toolchain.toml`, `wasm32-unknown-unknown`, `wasm-bindgen-cli` and
|
||||
`cargo-deny` at the pinned versions; `cargo check / test / build / clippy /
|
||||
fmt` and the browser module build run without Docker). Docker on that
|
||||
machine runs the Faunosteo services (Supabase), the worker in its hardened
|
||||
container, the integration tests, the sandbox and seccomp proofs, and
|
||||
builds the deployment images (multi-stage). The production VPS is separate
|
||||
and never compiles.
|
||||
- The R0 builder image is kept as the reproducible alternative
|
||||
(`pnpm rust:check:docker`, `pnpm wasm:build:docker`) and as the reference
|
||||
for a future runner; it is no longer the arbiter of daily work and is not
|
||||
required for a compile or a test. The worker's isolation is unchanged.
|
||||
- No CI/CD is operational on the forge (no runner, secret or registry). The
|
||||
workflow files are prepared material for a separate CI/CD decision; a
|
||||
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
|
||||
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.
|
||||
- R1 (the Step 8 worker) waits for the owner's final validation of this
|
||||
correction; no deployment, no release 0.2.0.
|
||||
@@ -17,9 +17,9 @@ Status: Step 0 deliverable, 2026-10-08. Current state: 32 files under
|
||||
| Migration | `supabase db reset` from zero + seed + regression fixtures | CI | every PR touching `supabase/` |
|
||||
| PDF regression | vitest golden tests: text extraction of generated PDFs, attachment roundtrip, raster hash on fixed inputs | `packages/pdf/tests` | CI |
|
||||
| SQL/TS contract | generated types diff check | CI | every PR touching `supabase/` |
|
||||
| Rust core and facade | `cargo test` (unit + fixture tests reading the repository JSON in place), `clippy -D warnings`, `cargo deny`; ts-rs types drift check | `crates/*`, CI job `rust` through the builder image | CI on every PR |
|
||||
| Rust/TS contract | vitest proofs on the built module: byte equality with `JSON.stringify(…, null, 2)` on the real documents, optional/nullable shape read by the current Zod schemas, panic and stack traps, served size budget | `packages/core-wasm/tests` (skipped with a notice when `pkg/` is absent) | CI `check` after `wasm:build` |
|
||||
| Worker sandbox | integration tests against the musl binary that ships: fixture corpus through the full sandbox, refusals, SIGSYS on a denied syscall, output cap, `RLIMIT_AS` abort, `RLIMIT_CPU`, deadline; seccomp allowlist derived by `strace` and compared | `crates/worker/tests`, Dockerfile stage `test` | CI `docker` job |
|
||||
| Rust core and facade | `cargo test` (unit + fixture tests reading the repository JSON in place), `clippy -D warnings`, `cargo deny`; ts-rs types drift check | `crates/*`, `pnpm rust:check` (native, `scripts/rust-check.sh`; same file in the builder image), `pnpm check:all` | before every Rust commit and every merge; CI job `rust` prepared, no runner yet |
|
||||
| Rust/TS contract | vitest proofs on the built module: byte equality with `JSON.stringify(…, null, 2)` on the real documents, optional/nullable shape read by the current Zod schemas, panic and stack traps, served size budget | `packages/core-wasm/tests` (skipped with a notice when `pkg/` is absent) | `pnpm check:all` (after the native `wasm:build`); CI `check` prepared |
|
||||
| Worker sandbox | integration tests against the musl binary that ships: fixture corpus through the full sandbox, refusals, SIGSYS on a denied syscall, output cap, `RLIMIT_AS` abort, `RLIMIT_CPU`, deadline; seccomp allowlist derived by `strace` and compared | `crates/worker/tests`, Dockerfile stage `test` (`pnpm worker:test`, Docker only, never native) | every `crates/worker` commit, `pnpm check:all`; CI `docker` job prepared |
|
||||
|
||||
Browser-only code (`svgToPng`, `DOMParser` in the importer) runs under
|
||||
happy-dom where sufficient and under Playwright when real rendering matters
|
||||
|
||||
@@ -40,7 +40,9 @@ Future units, created only by the step that needs them:
|
||||
Rust workspace (plan R0, `docs/development/RUST.md`): `Cargo.toml` at the
|
||||
root with `crates/core` (library), `crates/wasm` (browser facade, built into
|
||||
`packages/core-wasm/pkg`) and `crates/worker` (binary). Every cargo command
|
||||
runs through the builder image (`pnpm rust:check`, `pnpm wasm:build`); the
|
||||
runs on the native toolchain of the development machine (`pnpm rust:check`,
|
||||
`pnpm wasm:build`; user-level rustup, channel of `rust-toolchain.toml`) or,
|
||||
for a reproducible run, through the builder image (`:docker` variants); the
|
||||
pnpm workspace gains `packages/core-wasm` (loader, generated types, proofs),
|
||||
whose tests skip with a notice when the module has not been built.
|
||||
| `supabase/` | migrations, functions, seed, tests | plan Step 3 |
|
||||
|
||||
Reference in new issue
Block a user