enable carapace command-line completion

modules/cli/shell/all.nix

@@ -12,6 +12,7 @@ in
       zsh.enable = true;
       fish.enable = true;
       starship.enable = true;
+      carapace.enable = true;
     };
   };
 }

modules/cli/shell/carapace.nix

@@ -0,0 +1,17 @@
+{ config, lib, ... }:
+let
+  cfg = config.my.cli.shell.carapace;
+in
+{
+  options.my.cli.shell.carapace = {
+    enable = lib.mkEnableOption "carapace completer";
+  };
+
+  config = lib.mkIf cfg.enable {
+    my.hm = {
+      programs.carapace = {
+        enable = true;
+      };
+    };
+  };
+}

modules/coding/misc.nix

@@ -21,6 +21,7 @@ in
       ];
       programs.direnv = {
         enable = true;
+        nix-direnv.enable = true;
         config = {
           global = {
             warn_timeout = 0;

modules/core/nix-racer/.gitignore

@@ -0,0 +1 @@
+/target

modules/core/nix-racer/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "nix-racer"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+axum = "0.8"
+reqwest = { version = "0.13", features = ["rustls"] }
+serde = { version = "1.0.228", features = ["derive"] }
+tokio = { version = "1.52", features = ["full"] }
+toml = "1.1"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }

modules/core/nix-racer/_package.nix

@@ -0,0 +1,29 @@
+{
+  lib,
+  rustPlatform,
+}:
+
+rustPlatform.buildRustPackage {
+  pname = "nix-racer";
+  version = "0.1.0";
+
+  src = lib.fileset.toSource {
+    root = ./.;
+    fileset = lib.fileset.unions [
+      ./Cargo.toml
+      ./Cargo.lock
+      ./src
+    ];
+  };
+
+  cargoLock = {
+    lockFile = ./Cargo.lock;
+  };
+
+  meta = {
+    description = "Nix substituter proxy with parallel cache queries and latency-aware selection";
+    mainProgram = "nix-racer";
+    license = lib.licenses.mit;
+    platforms = lib.platforms.unix;
+  };
+}

modules/core/nix-racer/src/config.rs

@@ -0,0 +1,64 @@
+use reqwest::Url;
+use serde::{Deserialize, Deserializer, de::Error};
+use std::net::{SocketAddr, SocketAddrV4};
+
+#[derive(Debug, Clone, Deserialize)]
+pub struct AppConfig {
+    #[serde(default = "default_listen")]
+    pub listen: SocketAddr,
+    pub substituters: Vec<Substituter>,
+}
+
+impl Default for AppConfig {
+    fn default() -> Self {
+        Self {
+            listen: default_listen(),
+            substituters: vec![
+                Substituter {
+                    url: "https://mirror.sjtu.edu.cn/nix-channels/store",
+                    penalty: 0,
+                },
+                Substituter {
+                    url: "https://mirrors.ustc.edu.cn/nix-channels/store",
+                    penalty: 0,
+                },
+                Substituter {
+                    url: "https://cache.nixos.org",
+                    penalty: 100,
+                },
+            ],
+        }
+    }
+}
+
+fn default_listen() -> SocketAddr {
+    SocketAddr::V4(SocketAddrV4::new([127, 0, 0, 1].into(), 2048))
+}
+
+#[derive(Debug, Clone)]
+pub struct Substituter {
+    pub url: &'static str,
+    pub penalty: u32,
+}
+
+impl<'de> Deserialize<'de> for Substituter {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: Deserializer<'de>,
+    {
+        #[derive(Debug, Clone, Deserialize)]
+        struct ShadowSubstituter {
+            url: String,
+            #[serde(default)]
+            penalty: u32,
+        }
+        let sub = <ShadowSubstituter as Deserialize>::deserialize(deserializer);
+        sub.and_then(|ShadowSubstituter { url, penalty }| {
+            let url = match Url::parse(&url) {
+                Ok(url) => Ok(Box::leak(url.to_string().into_boxed_str())),
+                Err(err) => Err(<D::Error as Error>::custom(err.to_string())),
+            }?;
+            Ok(Substituter { url, penalty })
+        })
+    }
+}

modules/core/nix-racer/src/main.rs

@@ -0,0 +1,212 @@
+use std::{
+    collections::HashMap,
+    sync::Arc,
+    time::{Duration, Instant},
+};
+
+use axum::{
+    Router,
+    extract::{Path, State},
+    http::{StatusCode, header},
+    response::{IntoResponse, Redirect},
+    routing::get,
+};
+use reqwest::Client;
+use tokio::task::JoinSet;
+use tracing_subscriber::{EnvFilter, layer::SubscriberExt as _, util::SubscriberInitExt as _};
+
+mod config;
+use config::*;
+
+#[derive(Clone)]
+struct AppState {
+    client: Client,
+    config: Arc<AppConfig>,
+}
+
+#[tokio::main]
+async fn main() {
+    tracing_subscriber::registry()
+        .with(tracing_subscriber::fmt::layer())
+        .with(
+            EnvFilter::builder()
+                .with_env_var("NIX_RACER_LOG")
+                .with_default_directive("nix_racer=debug".parse().unwrap())
+                .from_env()
+                .unwrap(),
+        )
+        .init();
+
+    let config: Arc<AppConfig> = match std::fs::read_to_string("/etc/nix/nix-racer.toml") {
+        Ok(file) => toml::from_str::<AppConfig>(&file).unwrap_or_else(|x| {
+            tracing::warn!("Failed to parse config file ({x}), fallback to default configuration");
+            AppConfig::default()
+        }),
+        Err(err) if err.kind() == std::io::ErrorKind::NotFound => {
+            tracing::info!("Config file not found, fallback to default configuration");
+            AppConfig::default()
+        }
+        Err(err) => {
+            tracing::warn!("Failed to read config file ({err}), fallback to default configuration");
+            AppConfig::default()
+        }
+    }
+    .into();
+
+    if config.substituters.is_empty() {
+        tracing::error!("No substituters found");
+        std::process::exit(1);
+    }
+
+    let listen = config.listen;
+
+    let client = Client::builder()
+        .timeout(Duration::from_secs(5))
+        .pool_idle_timeout(Duration::from_secs(90))
+        .build()
+        .unwrap();
+
+    let state = AppState { client, config };
+
+    let listener = tokio::net::TcpListener::bind(listen).await.unwrap();
+
+    let app = Router::new()
+        .route("/nix-cache-info", get(nix_cache_info_handler))
+        .route("/{*path}", get(proxy_handler))
+        .with_state(state);
+
+    tracing::info!("Smart Nix Proxy listening on http://{listen}");
+    axum::serve(listener, app).await.unwrap();
+}
+
+async fn nix_cache_info_handler() -> impl IntoResponse {
+    let info = "StoreDir: /nix/store\nWantMassQuery: 1\nPriority: 30\n";
+    ([(header::CONTENT_TYPE, "text/x-nix-cache-info")], info)
+}
+
+async fn proxy_handler(
+    Path(path): Path<String>,
+    State(state): State<AppState>,
+) -> impl IntoResponse {
+    if !path.ends_with(".narinfo") {
+        let redirect_url = format!("{}/{}", state.config.substituters[0].url, path);
+        return Redirect::temporary(&redirect_url).into_response();
+    }
+
+    let start_time = Instant::now();
+    let mut set = JoinSet::new();
+
+    let mut penalties = HashMap::new();
+
+    for upstream in state.config.substituters.iter() {
+        let url = format!("{}/{}", upstream.url, path);
+        let client = state.client.clone();
+        let base_url = upstream.url;
+
+        let handle = set.spawn(async move {
+            let max_retries = 2;
+            let mut delay = Duration::from_millis(50);
+
+            for attempt in 0..=max_retries {
+                match client.get(&url).send().await {
+                    Ok(resp) if resp.status().is_success() => {
+                        let bytes = resp.bytes().await.map_err(|_| "Body error")?;
+
+                        let text = String::from_utf8_lossy(&bytes);
+                        let mut new_text = String::with_capacity(text.len() + 64);
+                        for line in text.lines() {
+                            if let Some(rel_url) = line.strip_prefix("URL: ") {
+                                if rel_url.starts_with("http://") || rel_url.starts_with("https://")
+                                {
+                                    new_text.push_str(line);
+                                } else {
+                                    new_text.push_str(&format!("URL: {}/{}", base_url, rel_url));
+                                }
+                            } else {
+                                new_text.push_str(line);
+                            }
+                            new_text.push('\n');
+                        }
+                        return Ok((new_text.into_bytes(), base_url));
+                    }
+                    Ok(resp) if resp.status() == StatusCode::NOT_FOUND => return Err("404"),
+                    Err(_) => {
+                        if attempt == max_retries {
+                            return Err("Max retries");
+                        }
+                        tokio::time::sleep(delay).await;
+                        delay *= 2;
+                    }
+                    _ => return Err("Other HTTP Error"),
+                }
+            }
+            Err("Unreachable")
+        });
+
+        penalties.insert(handle.id(), upstream.penalty);
+    }
+
+    struct ProxyResult {
+        score: Duration,
+        body: Vec<u8>,
+        url: &'static str,
+    }
+    let mut best_result: Option<ProxyResult> = None;
+
+    loop {
+        let min_active_penalty = penalties.values().min().copied();
+
+        if let Some(ProxyResult { score, .. }) = best_result {
+            if let Some(min_p) = min_active_penalty {
+                if start_time.elapsed() + Duration::from_millis(u64::from(min_p)) >= score {
+                    break;
+                }
+            } else {
+                break;
+            }
+        } else if min_active_penalty.is_none() {
+            break;
+        }
+
+        let timeout_dur = if let Some(ProxyResult { score, .. }) = best_result {
+            score.saturating_sub(start_time.elapsed())
+        } else {
+            Duration::from_secs(86400)
+        };
+
+        if timeout_dur.is_zero() && best_result.is_some() {
+            break;
+        }
+
+        let res = tokio::time::timeout(timeout_dur, set.join_next_with_id()).await;
+
+        match res {
+            Ok(Some(Ok((task_id, task_res)))) => {
+                let penalty = penalties.remove(&task_id).unwrap();
+                if let Ok((body, url)) = task_res {
+                    let score = start_time.elapsed() + Duration::from_millis(u64::from(penalty));
+                    if best_result.as_ref().is_none_or(|best| score < best.score) {
+                        best_result = Some(ProxyResult { score, body, url })
+                    }
+                }
+            }
+            Ok(Some(Err(join_err))) => {
+                penalties.remove(&join_err.id());
+            }
+            Ok(None) => break,
+            Err(_) => break,
+        }
+    }
+
+    if let Some(ProxyResult { score, body, url }) = best_result {
+        tracing::debug!("Winner for {}: {} (Score: {:?})", path, url, score,);
+        (
+            StatusCode::OK,
+            [(header::CONTENT_TYPE, "text/x-nix-narinfo")],
+            body,
+        )
+            .into_response()
+    } else {
+        (StatusCode::NOT_FOUND, "Not Found").into_response()
+    }
+}

modules/core/nix.nix

@@ -32,19 +32,94 @@ in
       nh
     ];
 
-    environment.etc = lib.mapAttrs' (name: value: {
+    environment.etc =
+      (lib.mapAttrs' (name: value: {
         name = "nix/path/${name}";
         value.source = value.flake;
-    }) config.nix.registry;
+      }) config.nix.registry)
+      // {
+        "nix/nix-racer.toml".source = (pkgs.formats.toml { }).generate "nix-racer.toml" {
+          listen = "127.0.0.1:2048";
+          substituters = [
+            {
+              penalty = 0;
+              url = "https://mirror.sjtu.edu.cn/nix-channels/store";
+            }
+            {
+              penalty = 50;
+              url = "https://mirrors.ustc.edu.cn/nix-channels/store";
+            }
+            {
+              penalty = 0;
+              url = "https://nix-community.cachix.org";
+            }
+            {
+              penalty = 0;
+              url = "https://cache.garnix.io";
+            }
+            {
+              penalty = 100;
+              url = "https://cache.nixos.org";
+            }
+          ];
+        };
+      };
+
+    systemd.services.nix-racer = {
+      description = "Nix substituter proxy with parallel cache queries and latency-aware selection";
+      wantedBy = [ "multi-user.target" ];
+      after = [ "network-online.target" ];
+      wants = [ "network-online.target" ];
+
+      serviceConfig = {
+        Type = "simple";
+        ExecStart = "${lib.getExe (pkgs.callPackage ./nix-racer/_package.nix { })}";
+        Restart = "on-failure";
+        RestartSec = 5;
+
+        DynamicUser = true;
+        CapabilityBoundingSet = [ "" ];
+        DeviceAllow = "";
+        LockPersonality = true;
+        MemoryDenyWriteExecute = true;
+        NoNewPrivileges = true;
+        PrivateDevices = true;
+        PrivateTmp = true;
+        ProtectClock = true;
+        ProtectControlGroups = true;
+        ProtectHome = true;
+        ProtectHostname = true;
+        ProtectKernelLogs = true;
+        ProtectKernelModules = true;
+        ProtectKernelTunables = true;
+        ProtectSystem = "strict";
+        RestrictAddressFamilies = [
+          "AF_INET"
+          "AF_INET6"
+        ];
+        RestrictNamespaces = true;
+        RestrictRealtime = true;
+        RestrictSUIDSGID = true;
+        SystemCallArchitectures = "native";
+        SystemCallFilter = [
+          "@system-service"
+          "~@resources"
+          "~@privileged"
+        ];
+        UMask = "0077";
+      };
+    };
 
     nix.settings = {
       experimental-features = "nix-command flakes pipe-operators";
-      substituters = [
-        "https://mirrors.ustc.edu.cn/nix-channels/store"
-        "https://mirrors.sjtug.sjtu.edu.cn/nix-channels/store"
-        "https://mirror.sjtu.edu.cn/nix-channels/store"
-        "https://nix-community.cachix.org"
-        "https://cache.garnix.io"
+      substituters = lib.mkForce [
+        "http://127.0.0.1:2048"
+
+        # "https://mirrors.ustc.edu.cn/nix-channels/store"
+        # "https://mirrors.sjtug.sjtu.edu.cn/nix-channels/store"
+        # "https://mirror.sjtu.edu.cn/nix-channels/store"
+        # "https://nix-community.cachix.org"
+        # "https://cache.garnix.io"
       ];
       trusted-public-keys = [
         "nix-community.cachix.org-1:mB9FSh9qf2dCimDSUo8Zy7bkq5CX+/rkCWyvRCYg3Fs="