build(M0.1): pin reproducible Rust foundation

Select Rust 1.88.0 as the pinned toolchain and MSRV, centralize workspace package metadata and dependency versions, make Jenkins honor the same toolchain, and document Linux build prerequisites and locked commands.

Tests: cargo +1.88.0 fmt --all -- --check (passed)

Tests: cargo +1.88.0 check/test/clippy/doc/build workspace gates, release build, and no-default-features check with --locked (passed)

Tests: scripts/test-ci.sh; git diff --check (passed)
This commit is contained in:
Dandaedre 2026-10-05 07:47:49 +02:00
parent 567aa13262
commit 9711e6024c
10 changed files with 75 additions and 12 deletions

View File

@ -1,14 +1,17 @@
# cargo-features = ["codegen-backend"]
[workspace]
members = [ "tui", "sound" , "fader_master", "midi"]
members = ["fader_master", "midi", "sound", "tui"]
resolver = "3"
[workspace.package]
version = "0.1.0"
edition = "2024"
rust-version = "1.88"
license = "MIT"
repository = "https://git.dandaedre.com/MadGobblins/fader_master"
publish = false
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
[workspace.dependencies]
ratatui = { version = "0.29.0", features = ["all-widgets", "serde"] }
[profile.dev]
debug = true

4
Jenkinsfile vendored
View File

@ -22,6 +22,7 @@ pipeline {
BADGE_PUBLICATION_ROOT = '/mnt/assets/coverage'
COVERAGE_MIN_LINES = '20'
CARGO_LLVM_COV_VERSION = '0.9.1'
RUSTUP_TOOLCHAIN = '1.88.0'
}
stages {
@ -51,12 +52,11 @@ pipeline {
exit 1
fi
rustup toolchain install stable \
rustup toolchain install "${RUSTUP_TOOLCHAIN}" \
--profile minimal \
--component rustfmt \
--component clippy \
--component llvm-tools-preview
rustup default stable
if ! cargo llvm-cov --version 2>/dev/null \
| grep -F "cargo-llvm-cov ${CARGO_LLVM_COV_VERSION}" >/dev/null; then

View File

@ -13,6 +13,7 @@ planned in the following documents:
- [Architecture and library research](architecture.md)
- [Implementation tasks and acceptance tests](task.md)
- [Project-agent instructions and test/commit workflow](AGENTS.md)
- [Build prerequisites and MSRV](docs/build.md)
- [CI coverage and badge lifecycle](docs/ci-coverage.md)
# References

39
docs/build.md Normal file
View File

@ -0,0 +1,39 @@
# Build prerequisites
`fader_master` targets Linux and uses Rust 2024. Rust 1.88.0 is the selected
minimum supported Rust version (MSRV) and the repository-pinned development
toolchain. `rustup` reads `rust-toolchain.toml` and installs the required
`rustfmt`, Clippy, and LLVM tools components.
The current scaffold needs a C compiler and linker for transitive Rust system
crates, but it does not yet link to an audio daemon or MIDI library. On a
Debian-family Linux system, the foundation prerequisites are:
```sh
sudo apt-get install build-essential pkg-config
rustup toolchain install 1.88.0 \
--profile minimal \
--component rustfmt \
--component clippy \
--component llvm-tools-preview
```
Future PulseAudio, PipeWire, ALSA, MIDI, and udev adapters will add native
development packages. Their exact package names and feature-specific build
commands must be documented when those adapters are introduced; the scaffold
does not claim those dependencies yet.
From a fresh checkout, use the tracked lockfile for reproducible resolution:
```sh
cargo build --workspace --locked
cargo test --workspace --all-targets --all-features --locked
```
Verify the MSRV explicitly without allowing `rust-toolchain.toml` to select a
newer installed toolchain:
```sh
cargo +1.88.0 check --workspace --all-targets --all-features --locked
cargo +1.88.0 test --workspace --all-targets --all-features --locked
```

View File

@ -2,5 +2,9 @@
name = "fader_master"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
publish.workspace = true
[dependencies]

View File

@ -2,5 +2,9 @@
name = "midi"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
publish.workspace = true
[dependencies]

4
rust-toolchain.toml Normal file
View File

@ -0,0 +1,4 @@
[toolchain]
channel = "1.88.0"
profile = "minimal"
components = ["clippy", "llvm-tools-preview", "rustfmt"]

View File

@ -1,6 +1,10 @@
[package]
name = "volume_lib"
version = "0.1.0"
edition = "2024"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
publish.workspace = true
[dependencies]

View File

@ -17,7 +17,7 @@ Baseline test attempt on 2026-10-05: `cargo test --workspace --all-targets --off
Dependencies: planning.
- [ ] **M0.1 Toolchain and build:** select/test an MSRV and pinned toolchain, centralize workspace metadata/dependencies, track Cargo.lock for the executable, document native build prerequisites. Acceptance: a fresh supported Linux checkout builds and tests reproducibly with `--locked`; the chosen MSRV builds the chosen dependency set.
- [x] **M0.1 Toolchain and build:** select/test an MSRV and pinned toolchain, centralize workspace metadata/dependencies, track Cargo.lock for the executable, document native build prerequisites. Acceptance: a fresh supported Linux checkout builds and tests reproducibly with `--locked`; the chosen MSRV builds the chosen dependency set.
- [ ] **M0.2 CI gates:** align Jenkins with AGENTS.md, including doctests, Clippy `-D warnings`, release build and later backend feature matrix. Acceptance: representative formatting/lint/test failures fail the pipeline; default and full-feature builds pass with provisioned dependencies.
- [x] **M0.2a Coverage badges:** measure locked all-target line coverage with a pinned tool, enforce the documented 20% scaffold floor, and generate/archive the version, test, and coverage badges on every build. Publish atomically only from `main`, with fresh-build markers preventing stale test or coverage values. Acceptance: renderer, coverage lifecycle, finalization, and publication fixture tests pass; the real local measurement is above the floor. Jenkins publication and public retrieval remain deployment checks.
- [ ] **M0.3 Domain boundary:** add `fader-core` and `fader-config`, wire current crates inward, remove placeholder arithmetic tests as real contracts replace them. Acceptance: core tests run without a terminal, sound daemon, native device connection, or Tokio runtime; dependency graph has no cycles.

View File

@ -1,7 +1,11 @@
[package]
name = "tui"
version = "0.1.0"
edition = "2024"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
publish.workspace = true
[dependencies]
ratatui = { version = "0.29.0", features = ["all-widgets", "serde"] }
ratatui.workspace = true