.forgejo/workflows/desktop.yml

@@ -52,12 +52,17 @@ jobs:
         run: npm ci && npm run build
         working-directory: frontend
 
+      # --locked on the FIRST cargo invocation of the job is the lockfile gate: it
+      # fails the run if Cargo.toml and the committed Cargo.lock disagree, instead
+      # of silently re-resolving. Everything after it in this job then compiles the
+      # exact versions recorded in the lockfile, so the flag isn't repeated on the
+      # bundle build (issue 2102).
       - name: Clippy
-        run: cargo clippy --all-targets -- -D warnings
+        run: cargo clippy --locked --all-targets -- -D warnings
         working-directory: desktop/src-tauri
 
       - name: Test
-        run: cargo test
+        run: cargo test --locked
         working-directory: desktop/src-tauri
 
       # Deliberately AFTER clippy + test, not before.
@@ -244,6 +249,15 @@ jobs:
         run: cargo tauri icon app-icon.png
         working-directory: desktop/src-tauri
 
+      # This lane's lockfile gate (the Linux job gets it from `cargo clippy
+      # --locked`). It has to be its own step here because the build is this job's
+      # only crate-graph command, and discovering the drift 30 minutes into a
+      # cross-compile is the expensive way to learn it. Fetching for the Windows
+      # target also pre-warms exactly the crates the build will want.
+      - name: Verify the lockfile and fetch dependencies
+        run: cargo fetch --locked --target x86_64-pc-windows-msvc
+        working-directory: desktop/src-tauri
+
       # --runner cargo-xwin swaps cargo for the cross-compiling driver (it supplies
       # the MSVC CRT/SDK, pre-warmed into the image, and links with lld-link).
       # Frontend already built above; skip the beforeBuildCommand rebuild.

ci-requirements.md

@@ -179,6 +179,36 @@ files behind; `CARGO_HOME` points somewhere writable for that user.
 exceed 100 characters and survive only because rustfmt cannot break a string
 literal — copying that shape caused one of the four failures.
 
+## The desktop lockfile
+
+`desktop/src-tauri/Cargo.lock` is **committed**, per Cargo's own guidance for
+binary crates. Without it every CI run re-resolved the graph, which meant a
+released `.deb`/`.AppImage`/`.exe` couldn't be rebuilt from its tag, a build
+could break with no repo change, and Renovate had nothing to bump (issue 2102).
+
+Enforced by `--locked` on each job's **first** cargo invocation — `cargo clippy
+--locked` on Linux, a dedicated `cargo fetch --locked --target
+x86_64-pc-windows-msvc` step on Windows. If the manifest and the lockfile
+disagree, the run fails there instead of silently re-resolving; everything after
+it in the same job then compiles the recorded versions, so the flag isn't
+repeated on the bundle build. The Windows step exists separately because that
+job's only crate-graph command is the cross-compile itself, and drift is cheaper
+to learn in the first thirty seconds than thirty minutes in.
+
+To regenerate it after a dependency change — same reasoning as `cargo fmt`
+above, and resolution is neither a test run nor a build:
+
+```
+docker run --rm --user "$(id -u):$(id -g)" -e CARGO_HOME=/tmp/cargo \
+  -v "$PWD/desktop/src-tauri:/w" -w /w \
+  git.fabledsword.com/bvandeusen/ci-tauri:1.97 cargo generate-lockfile
+```
+
+Resolving inside the CI image rather than against some other cargo is what keeps
+the lockfile format and the picked versions identical to what CI would have
+chosen. Commit the result in the same change as the `Cargo.toml` edit — a
+manifest change pushed without it fails the gate.
+
 ## Pushing: `dev` is both a branch and a tag
 
 `git push origin dev` fails in this repo: