chore: Replace haskell.nix with stacklock2nix

.envrc

@@ -1 +1,5 @@
-use flake
+export DIRENV_WARN_TIMEOUT=20s
+
+eval "$(devenv direnvrc)"
+
+use devenv

.github/workflows/build.yml

@@ -9,31 +9,76 @@ on:
     types:
       - opened
       - synchronize
+
 concurrency:
   group: build-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
-  haskell:
+  build:
+    strategy:
+      matrix:
+        runner:
+          - macos-latest
+          - ubuntu-latest
+    runs-on: ${{ matrix.runner }}
+    env:
+      LANG: en_US.UTF-8
+      LC_ALL: en_US.UTF-8
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Install Nix
+        uses: cachix/install-nix-action@v31
+      - name: Setup Cachix
+        uses: cachix/cachix-action@v16
+        with:
+          name: devenv
+      - name: Install devenv
+        run: nix profile install nixpkgs#devenv 
+      - name: Setup cache for `~/.stack`
+        uses: actions/cache@v4
+        with:
+          path: ~/.stack
+          key: ${{ runner.os }}-stack-global-${{ hashFiles('stack.yaml') }}-${{ hashFiles('hapistrano.cabal') }}
+          restore-keys: |
+            ${{ runner.os }}-stack-global-${{ hashFiles('stack.yaml') }}-
+            ${{ runner.os }}-stack-global-
+      - name: Install dependencies
+        run: devenv shell -- stack build --only-dependencies --test
+      - name: Setup cache for `.stack-work`
+        uses: actions/cache@v4
+        with:
+          path: .stack-work
+          key: ${{ runner.os }}-stack-work-${{ hashFiles('stack.yaml') }}-${{ hashFiles('hapistrano.cabal') }}-${{ hashFiles('**/*.hs') }}
+          restore-keys: |
+            ${{ runner.os }}-stack-work-${{ hashFiles('stack.yaml') }}-${{ hashFiles('hapistrano.cabal') }}-
+            ${{ runner.os }}-stack-work-${{ hashFiles('stack.yaml') }}-
+            ${{ runner.os }}-stack-work-
+      - name: Compile code
+        run: devenv shell -- stack build --test --no-run-tests
+      - name: Run tests
+        run: devenv shell -- stack test
+
+  nix-build:
     strategy:
       matrix:
-        os:
-          - macos-13      # x86_64-darwin
-          - macos-latest  # aarch64-darwin
-          - ubuntu-latest # x86_64-linux
-      fail-fast: true
-    runs-on: ${{ matrix.os }}
-    timeout-minutes: 30
+        runner:
+          - macos-latest
+          - ubuntu-latest
+    runs-on: ${{ matrix.runner }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: DeterminateSystems/nix-installer-action@v12
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Install Nix
+        uses: cachix/install-nix-action@v31
+      - name: Setup Cachix
+        uses: cachix/cachix-action@v16
         with:
-          extra-conf: accept-flake-config = true
-      - uses: DeterminateSystems/magic-nix-cache-action@v7
-      - name: Compile code ${{ matrix.ghc }}
-        run: nix build .#test
-      - name: Run tests ${{ matrix.ghc }}
-        run: nix run .#test
+          name: stackbuilders
+          authToken: ${{ secrets.CACHIX_AUTH_TOKEN }}
+      - name: Build `default` package
+        run: nix build
 
   docker:
     uses: ./.github/workflows/reusable-docker.yml

.gitignore

@@ -20,7 +20,6 @@ cabal.sandbox.config
 .stack-work/
 dist-newstyle
 result
-nix/
 .ghc.environment.*
 .tmuxinator.yml
 # Devenv

devenv.lock

@@ -20,11 +20,10 @@
     "flake-compat": {
       "flake": false,
       "locked": {
-        "lastModified": 1696426674,
+        "lastModified": 1733328505,
         "owner": "edolstra",
         "repo": "flake-compat",
-        "rev": "0f9255e01c2351cc7d116c072cb317785dd33b33",
-        "treeHash": "2addb7b71a20a25ea74feeaf5c2f6a6b30898ecb",
+        "rev": "ff81ac966bb2cae68946d5ed5fc4994f96d0ffec",
         "type": "github"
       },
       "original": {
@@ -33,10 +32,31 @@
         "type": "github"
       }
     },
+    "git-hooks": {
+      "inputs": {
+        "flake-compat": "flake-compat",
+        "gitignore": "gitignore",
+        "nixpkgs": [
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1742649964,
+        "owner": "cachix",
+        "repo": "git-hooks.nix",
+        "rev": "dcf5072734cb576d2b0c59b2ac44f5050b5eac82",
+        "type": "github"
+      },
+      "original": {
+        "owner": "cachix",
+        "repo": "git-hooks.nix",
+        "type": "github"
+      }
+    },
     "gitignore": {
       "inputs": {
         "nixpkgs": [
-          "pre-commit-hooks",
+          "git-hooks",
           "nixpkgs"
         ]
       },
@@ -45,7 +65,6 @@
         "owner": "hercules-ci",
         "repo": "gitignore.nix",
         "rev": "637db329424fd7e46cf4185293b9cc8c88c95394",
-        "treeHash": "ca14199cabdfe1a06a7b1654c76ed49100a689f9",
         "type": "github"
       },
       "original": {
@@ -70,50 +89,14 @@
         "type": "github"
       }
     },
-    "nixpkgs-stable": {
-      "locked": {
-        "lastModified": 1718811006,
-        "owner": "NixOS",
-        "repo": "nixpkgs",
-        "rev": "03d771e513ce90147b65fe922d87d3a0356fc125",
-        "treeHash": "ab837eb82b2b0afbb6568f2b27f214324699af3d",
-        "type": "github"
-      },
-      "original": {
-        "owner": "NixOS",
-        "ref": "nixos-23.11",
-        "repo": "nixpkgs",
-        "type": "github"
-      }
-    },
-    "pre-commit-hooks": {
-      "inputs": {
-        "flake-compat": "flake-compat",
-        "gitignore": "gitignore",
-        "nixpkgs": [
-          "nixpkgs"
-        ],
-        "nixpkgs-stable": "nixpkgs-stable"
-      },
-      "locked": {
-        "lastModified": 1718879355,
-        "owner": "cachix",
-        "repo": "pre-commit-hooks.nix",
-        "rev": "8cd35b9496d21a6c55164d8547d9d5280162b07a",
-        "treeHash": "246f2197feb48979ccc58af4cab0cfd0f5738645",
-        "type": "github"
-      },
-      "original": {
-        "owner": "cachix",
-        "repo": "pre-commit-hooks.nix",
-        "type": "github"
-      }
-    },
     "root": {
       "inputs": {
         "devenv": "devenv",
+        "git-hooks": "git-hooks",
         "nixpkgs": "nixpkgs",
-        "pre-commit-hooks": "pre-commit-hooks"
+        "pre-commit-hooks": [
+          "git-hooks"
+        ]
       }
     }
   },

devenv.nix

@@ -0,0 +1,13 @@
+{ pkgs, lib, ... }:
+
+{
+  packages =
+    [
+      pkgs.git
+      pkgs.stack
+      pkgs.zsh
+    ]
+    ++ lib.optionals pkgs.stdenv.isLinux [
+      pkgs.gmp
+    ];
+}

devenv.yaml

@@ -0,0 +1,4 @@
+# yaml-language-server: $schema=https://devenv.sh/devenv.schema.json
+inputs:
+  nixpkgs:
+    url: github:cachix/devenv-nixpkgs/rolling

docs/NIX.md

@@ -3,46 +3,50 @@
 ## Requirements
 
 - Install [Nix](https://nixos.org/download.html)
-- Enable Flakes [permanently](https://nixos.wiki/wiki/Flakes#Permanent)
+- Enable [Flakes](https://nixos.wiki/wiki/Flakes#Permanent) permanently
+- Install [devenv](https://devenv.sh/getting-started/):
 
-**For macOS users**
+## Project Structure
 
-Add the following lines to configuration file located at `/etc/nix/nix.conf`:
+The project uses:
+- Nix Flakes for reproducible builds and development environments
+- `stacklock2nix` for deriving Nix packages from stack.yaml.lock
+- `devenv` for creating consistent development environments
 
-```
-trusted-public-keys = hydra.iohk.io:f/Ea+s+dFdN+3Y/G+FDgSq+a5NEWhJGzdjvKNGv0/EQ= cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY=
-substituters = https://cache.iog.io https://cache.nixos.org
-```
+### Flake.nix
 
-Restart the `nix-daemon` service:
+The flake.nix file has the following inputs:
+- `nixpkgs`: Standard Nix packages repository
+- `stacklock2nix`: A tool for generating Nix packages from stack.yaml.lock files
 
-```
-sudo launchctl stop org.nixos.nix-daemon
-sudo launchctl start org.nixos.nix-daemon
-```
+The flake outputs:
+- `packages.default`: The Hapistrano package for each supported system
+- `overlays.default`: An overlay for integrating Hapistrano into other Nix
+  systems
 
-If the following messages appear running the scripts detailed in the section
-below, it means that Nix is not picking up the substituters we described
-earlier and is unable to use them as a derivation cache: 
+## Development Environments
 
-```
-warning: ignoring untrusted substituter 'https://cache.iog.io'
-```
-in which case
-it is recommended to go over the steps detailed in this section again, or look for alternative ways to add extra substituters in [nix.conf](https://nix.dev/manual/nix/2.18/command-ref/conf-file).
-
-## Enabling the development environment
+The project includes a `devenv.nix` configuration that provides a consistent
+development environment with all necessary dependencies.
 
-To enable the development environment exposed by the project's [Nix flake](../flake.nix), you can start a development shell by running the following command from within the project's root:
+To use devenv:
 
 ```
-nix develop
+devenv shell
 ```
 
-Alternatively, if you are using [nix-direnv](https://github.com/nix-community/nix-direnv) (recommended), you can run:
+The devenv configuration includes:
+- Essential tools like git, stack, and zsh
+- System-specific dependencies (e.g., gmp for Linux systems)
+
+### Using nix-direnv
+
+If you are using [nix-direnv](https://github.com/nix-community/nix-direnv), run:
 
 ```
 direnv allow
 ```
 
-that will enable the development shell according to the contents of [.envrc](../.envrc). It is advisable not to run `direnv allow` blindly and always check the contents of [.envrc](../.envrc) files first to ensure nothing malicious is executed.
+This will enable the development shell according to the contents of
+[.envrc](../.envrc). Always check the contents of [.envrc](../.envrc) files
+before running `direnv allow` to ensure nothing malicious is executed.