chore: improve CI tooling, linting, and code cleanup

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches:
+     - main
+     - dev
+  pull_request:
+
+# Only keep the latest run per branch/PR to save CI minutes.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  rust-all:
+    name: Rust (fmt, clippy, test, doc, shear)
+    runs-on: ubuntu-latest
+    env:
+      # Cache compilation output between runs via sccache.
+      SCCACHE_GHA_ENABLED: "true"
+      RUSTC_WRAPPER: "sccache"
+      CARGO_INCREMENTAL: "0"
+    steps:
+      - uses: actions/checkout@v4
+
+      # Starts the sccache server used by RUSTC_WRAPPER above.
+      - name: Start sccache
+        uses: mozilla-actions/sccache-action@v0.0.9
+
+      # Runs every default workflow in a single step
+      - name: Run Rust workflows
+        uses: aderinom/rust-all-action@v1
+        with:
+          run: fmt,clippy,test,doc,shear,deny
+          flow-fmt-toolchain: nightly

.gitignore

@@ -1,2 +1,5 @@
 target
-Cargo.lock
+Cargo.lock
+
+# Vendored rust-all-action bundle for local CI (scripts/ci-local.sh)
+/.tools/

.rustfmt.toml

@@ -0,0 +1,21 @@
+# Requires nightly rustfmt to be installed.
+
+# Comments Formatting
+comment_width = 100
+wrap_comments = true
+format_code_in_doc_comments = true
+normalize_comments = true # replace `/*comment*/ with `// comment` where possible
+
+# Imports Formatting
+imports_granularity = "Crate" # Groups imports by their source crate
+group_imports = "StdExternalCrate" # Orders imports by STD, External, Internal
+
+# Enum Formatting
+enum_discrim_align_threshold = 4 # Vertical Align enum assignments by up to N characters
+
+# Block and Closure Formatting
+force_multiline_blocks = true # Force multiline closures to be wrapped in a block
+
+# Patterns Formatting
+condense_wildcard_suffixes = true # Replace (a, _, _) = (1,2,3) with (a, ..) = (1,2,3)
+use_field_init_shorthand = true # A{ x: x } becomes A { x }

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "cSpell.words": [
+    "oneshot",
+    "wrapp"
+  ],
+  "rust-analyzer.rustfmt.extraArgs": [
+    "+nightly"
+  ]
+}

.vscode/tasks.json

@@ -0,0 +1,27 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "clippy-watch",
+      "type": "shell",
+      "command": "cargo watch -x clippy",
+      "isBackground": true,
+      "problemMatcher": {
+        "base": "$rustc",
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^\\[Running 'cargo clippy'\\]",
+          "endsPattern": "^\\[Finished running\\. Exit status: [0-9]+\\]"
+        }
+      },
+      "presentation": {
+        "reveal": "never",
+        "panel": "dedicated",
+        "clear": true
+      },
+      "runOptions": {
+        "runOn": "folderOpen"
+      }
+    }
+  ]
+}