ci: make just the task source of truth (#134)

Unify the Rust, markdown, site, and release build entrypoints behind shared just recipes so local verification and GitHub workflows stay aligned.

This also adds a dedicated CI shell and removes the old scripts/ci.sh shim.

Author: barrettruth

.github/workflows/nightly.yaml

@@ -32,11 +32,8 @@ jobs:
             artifact: vimdoc-language-server-macos-x86_64
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: ${{ matrix.target }}
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo build --release --target ${{ matrix.target }}
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just build-target ${{ matrix.target }}
       - name: Rename binary
         run:
           cp target/${{ matrix.target }}/release/vimdoc-language-server ${{

.github/workflows/quality.yaml

@@ -14,6 +14,7 @@ jobs:
       rust: ${{ steps.filter.outputs.rust }}
       markdown: ${{ steps.filter.outputs.markdown }}
       site: ${{ steps.filter.outputs.site }}
+      infra: ${{ steps.filter.outputs.infra }}
     steps:
       - uses: actions/checkout@v4
       - uses: dorny/paths-filter@v3
@@ -27,78 +28,79 @@ jobs:
               - 'rust-toolchain.toml'
               - 'rustfmt.toml'
             markdown:
-              - '*.md'
+              - '**/*.md'
             site:
               - 'site/**'
+            infra:
+              - 'justfile'
+              - 'flake.nix'
+              - 'flake.lock'
+              - '.github/workflows/**'
 
   fmt:
     name: Rust Format Check
     needs: changes
-    if: needs.changes.outputs.rust == 'true'
+    if:
+      needs.changes.outputs.rust == 'true' || needs.changes.outputs.infra ==
+      'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          components: rustfmt
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo fmt --all -- --check
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just rust-format
 
   clippy:
     name: Rust Lint Check
     needs: changes
-    if: needs.changes.outputs.rust == 'true'
+    if:
+      needs.changes.outputs.rust == 'true' || needs.changes.outputs.infra ==
+      'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          components: clippy
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo clippy --all-targets -- -D warnings
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just rust-lint
 
   markdown:
     name: Markdown Format Check
     needs: changes
-    if: needs.changes.outputs.markdown == 'true'
+    if:
+      needs.changes.outputs.markdown == 'true' || needs.changes.outputs.infra ==
+      'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: cachix/install-nix-action@v31
-      - run: nix develop --command prettier --check "**/*.md"
+      - run: nix develop .#ci --command just markdown-format
+
+  flake-check:
+    name: Nix Flake Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just flake-check
 
   site-check:
     name: Astro Type Check
     needs: changes
-    if: needs.changes.outputs.site == 'true'
+    if:
+      needs.changes.outputs.site == 'true' || needs.changes.outputs.infra ==
+      'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-      - uses: pnpm/action-setup@v4
-        with:
-          version: latest
-      - run: pnpm install --frozen-lockfile
-        working-directory: site
-      - run: pnpm check
-        working-directory: site
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just site-check
 
   site-format:
     name: Site Format Check
     needs: changes
-    if: needs.changes.outputs.site == 'true'
+    if:
+      needs.changes.outputs.site == 'true' || needs.changes.outputs.infra ==
+      'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-      - uses: pnpm/action-setup@v4
-        with:
-          version: latest
-      - run: pnpm install --frozen-lockfile
-        working-directory: site
-      - run: pnpm format:check
-        working-directory: site
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just site-format

.github/workflows/release.yaml

@@ -33,11 +33,8 @@ jobs:
             artifact: vimdoc-language-server-macos-x86_64
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: ${{ matrix.target }}
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo build --release --target ${{ matrix.target }}
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just build-target ${{ matrix.target }}
       - name: Rename binary
         run: |
           cp target/${{ matrix.target }}/release/vimdoc-language-server ${{ matrix.artifact }}

.github/workflows/test.yaml

@@ -15,6 +15,5 @@ jobs:
         os: [ubuntu-latest, macos-latest]
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - uses: Swatinem/rust-cache@v2
-      - run: cargo test --all
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop .#ci --command just test

flake.nix

@@ -14,6 +14,21 @@
         overlays = [ (import rust-overlay) ];
         pkgs = import nixpkgs { inherit system overlays; };
         toolchain = pkgs.rust-bin.fromRustupToolchainFile ./rust-toolchain.toml;
+        ciToolchain = toolchain.override {
+          targets = [
+            "x86_64-unknown-linux-gnu"
+            "aarch64-apple-darwin"
+            "x86_64-apple-darwin"
+          ];
+        };
+        commonBuildInputs = [
+          pkgs.cargo-edit
+          pkgs.cargo-watch
+          pkgs.nodejs_22
+          pkgs.pnpm
+          pkgs.prettier
+          pkgs.just
+        ];
       in
       {
         packages.default = pkgs.rustPlatform.buildRustPackage {
@@ -24,14 +39,11 @@
         };
 
         devShells.default = pkgs.mkShell {
-          buildInputs = [
-            toolchain
-            pkgs.cargo-edit
-            pkgs.cargo-watch
-            pkgs.nodejs_22
-            pkgs.pnpm
-            pkgs.prettier
-          ];
+          buildInputs = [ toolchain ] ++ commonBuildInputs;
+        };
+
+        devShells.ci = pkgs.mkShell {
+          buildInputs = [ ciToolchain ] ++ commonBuildInputs;
         };
       }
     );

justfile

@@ -0,0 +1,44 @@
+default:
+    @just --list
+
+format: rust-format markdown-format site-format
+    @:
+
+lint: rust-lint site-check flake-check
+    @:
+
+test:
+    cargo test --all
+
+build:
+    cargo build --release
+
+rust-format:
+    cargo fmt --all -- --check
+
+rust-lint:
+    cargo clippy --all-targets -- -D warnings
+
+markdown-format:
+    prettier --check .
+
+site-install:
+    cd site && pnpm install --frozen-lockfile
+
+site-check: site-install
+    cd site && pnpm check
+
+site-format: site-install
+    cd site && pnpm format:check
+
+site-build: site-install
+    cd site && pnpm build
+
+flake-check:
+    nix flake check --no-build
+
+build-target target:
+    cargo build --release --target {{target}}
+
+ci: format lint test
+    @: