add nix module

Author: DolceTriade

Cargo.lock

@@ -1,5 +1,5 @@
 [workspace]
-members = ["indexer", "backend"]
+members = ["indexer", "backend", "reposerver"]
 resolver = "2"
 
 [package]

Cargo.toml

@@ -346,9 +346,9 @@ pub async fn prune_commit_data(
                AND crc.ref_count > 0
          )",
     )
-        .execute(&mut *tx)
-        .await
-        .map_err(ApiErrorKind::from)?;
+    .execute(&mut *tx)
+    .await
+    .map_err(ApiErrorKind::from)?;
 
     tx.commit().await.map_err(ApiErrorKind::from)?;
 
@@ -495,9 +495,9 @@ pub async fn prune_repository_data(
                    AND crc.ref_count > 0
              )",
         )
-            .execute(&mut *tx)
-            .await
-            .map_err(ApiErrorKind::from)?;
+        .execute(&mut *tx)
+        .await
+        .map_err(ApiErrorKind::from)?;
         tx.commit().await.map_err(ApiErrorKind::from)?;
     }
 

backend/src/gc.rs

@@ -6,6 +6,12 @@
 }:
 with lib; let
   cfg = config.services.pointer;
+  tomlFormat = pkgs.formats.toml {};
+  repoServerConfig = recursiveUpdate cfg.repoServer.config {
+    global.state_dir = cfg.repoServer.stateDirectory;
+  };
+  repoServerConfigFile = tomlFormat.generate "pointer-reposerver.toml" repoServerConfig;
+  repoServerArgs = ["--config" repoServerConfigFile] ++ cfg.repoServer.extraArgs;
 
   # Helper function to create environment variables for a service component
   mkEnv = {
@@ -100,6 +106,41 @@ in {
         description = "Sets the GC_INTERVAL_SECS environment variable for the 'pointer-backend' service.";
       };
     };
+
+    # --- Reposerver Configuration ---
+    repoServer = {
+      enable = mkEnableOption "the Pointer reposerver component.";
+
+      config = mkOption {
+        type = tomlFormat.type;
+        default = {};
+        description = "Inline reposerver TOML configuration rendered by the module.";
+      };
+
+      extraArgs = mkOption {
+        type = types.listOf types.str;
+        default = [];
+        description = "Additional command-line arguments passed to reposerver.";
+      };
+
+      user = mkOption {
+        type = types.str;
+        default = "pointer";
+        description = "User account for the reposerver systemd service.";
+      };
+
+      group = mkOption {
+        type = types.str;
+        default = "pointer";
+        description = "Group for the reposerver systemd service.";
+      };
+
+      stateDirectory = mkOption {
+        type = types.str;
+        default = "/home/pointer";
+        description = "State directory for pointer-reposerver; also used as WorkingDirectory and written to global.state_dir.";
+      };
+    };
   };
 
   config = mkIf cfg.enable {
@@ -143,6 +184,20 @@ in {
       };
     };
 
+    # --- Systemd Service for Reposerver ---
+    systemd.services.pointer-reposerver = mkIf cfg.repoServer.enable {
+      description = "Pointer Reposerver Service";
+      wantedBy = ["multi-user.target"];
+      after = ["network.target"];
+      serviceConfig = {
+        ExecStart = "${cfg.package}/bin/pointer-reposerver ${escapeShellArgs repoServerArgs}";
+        User = cfg.repoServer.user;
+        Group = cfg.repoServer.group;
+        WorkingDirectory = cfg.repoServer.stateDirectory;
+        Restart = "always";
+      };
+    };
+
     users.groups.pointer = {};
     users.users.pointer = {
       createHome = true;

nix/pointer-module.nix

@@ -15,7 +15,7 @@
 rustPlatform.buildRustPackage rec {
   pname = "pointer";
   version = "0.1.0";
-  outputs = ["out" "web" "backend" "indexer"];
+  outputs = ["out" "web" "backend" "indexer" "reposerver"];
 
   src = lib.cleanSource ../.;
 
@@ -49,23 +49,26 @@ rustPlatform.buildRustPackage rec {
     export SQLX_OFFLINE_DIR=$PWD/backend/.sqlx
     cargo build --release --package pointer-backend --bin pointer-backend
     cargo build --release --package pointer-indexer --bin pointer-indexer
+    cargo build --release --package pointer-reposerver --bin pointer-reposerver
 
     runHook postBuild
   '';
 
   installPhase = ''
     runHook preInstall
 
-    mkdir -p $out/bin $web/bin $web/share/target $backend/bin $indexer/bin
+    mkdir -p $out/bin $web/bin $web/share/target $backend/bin $indexer/bin $reposerver/bin
     cp target/release/pointer-indexer $indexer/bin/pointer-indexer
     cp target/release/pointer-backend $backend/bin/pointer-backend
+    cp target/release/pointer-reposerver $reposerver/bin/pointer-reposerver
     cp target/release/pointer $web/bin/pointer
     cp Cargo.toml $web/share
     cp -r target/site $web/share/target/site
     wrapProgram $web/bin/pointer --chdir $web/share
 
     ln -sf $indexer/bin/pointer-indexer $out/bin/pointer-indexer
     ln -sf $backend/bin/pointer-backend $out/bin/pointer-backend
+    ln -sf $reposerver/bin/pointer-reposerver $out/bin/pointer-reposerver
     ln -sf $web/bin/pointer $out/bin/pointer
 
     runHook postInstall

nix/pointer.nix

@@ -1,5 +1,5 @@
 [package]
-name = "reposerver"
+name = "pointer-reposerver"
 version = "0.1.0"
 edition = "2024"
 

reposerver/Cargo.toml

@@ -1,16 +1,16 @@
-# reposerver
+# pointer-reposerver
 
-`reposerver` polls configured Git repositories, fetches only configured branches at depth 1,
+`pointer-reposerver` polls configured Git repositories, fetches only configured branches at depth 1,
 and runs `pointer-indexer` only when branch head commits change.
 
 Logging is emitted to stderr via `tracing` (configure verbosity with `RUST_LOG`).
 
 ## Run
 
 ```bash
-cargo run -p reposerver -- --config reposerver/example.reposerver.toml --validate-config
-cargo run -p reposerver -- --config reposerver/example.reposerver.toml --once
-cargo run -p reposerver -- --config reposerver/example.reposerver.toml
+cargo run -p pointer-reposerver -- --config reposerver/example.reposerver.toml --validate-config
+cargo run -p pointer-reposerver -- --config reposerver/example.reposerver.toml --once
+cargo run -p pointer-reposerver -- --config reposerver/example.reposerver.toml
 ```
 
 ## Config
@@ -19,3 +19,13 @@ See `reposerver/example.reposerver.toml` for a complete example.
 
 `global.indexer_args` are applied first for every invocation, then `repo.indexer_args` are appended.
 Per-branch args can be set with `[[repo.per_branch]]`; those args are appended last.
+
+Optional global finish hook:
+
+```toml
+[global.finish_hook]
+command = "scripts/after-sweep.sh"
+timeout = "30s"
+```
+
+The finish hook runs once after all repos complete in `--once` mode, and once per full sweep in forever mode.

reposerver/README.md

@@ -6,6 +6,10 @@ git_bin = "git"
 indexer_bin = "pointer-indexer"
 indexer_args = ["--upload-url", "http://127.0.0.1:8080/api/v1/index"]
 
+[global.finish_hook]
+command = "echo pointer-reposerver sweep finished"
+timeout = "30s"
+
 [[repo]]
 name = "pointer"
 url = "git@github.com:org/pointer.git"