docs: add Workflow section to AGENTS.md + update compose submodule

- Add Workflow conventions section to infra AGENTS.md
- Update compose submodule to feat/hermes-workers (adds compose AGENTS.md)

.gitmodules

@@ -1,6 +1,3 @@
 [submodule "assets/compose"]
 	path = assets/compose
 	url = ssh://git@code.lazyworkhorse.net:2222/gortium/compose.git
-[submodule "assets/dotfiles"]
-	path = assets/dotfiles
-	url = ssh://git@code.lazyworkhorse.net:2222/gortium/dotfiles.git

AGENTS.md

@@ -25,3 +25,12 @@ This document outlines the development conventions for this NixOS-based infrastr
 - **Secrets:** Secrets are managed with `agenix`. Edit encrypted files with `agenix -e <file>`.
 - **Modularity:** Structure configurations into logical, reusable modules under `modules/`. New modules should be registered in `modules/nixos/default.nix` to be available to all hosts.
 - **Error Handling:** Ensure Nix expressions are robust and handle potential evaluation errors gracefully.
+
+## Workflow
+
+- New feature → clean branch from `origin/master` → push → PR on Gitea
+- Branch naming: `feat/description` (features), `fix/description` (bugs/docs)
+- Always branch from `origin/master`, never from another feature branch
+- Submodule changes: commit submodule update in parent repo (the parent commit pins the submodule commit)
+- PR title should describe the change; body should explain motivation + summary
+- After PR merge, delete the feature branch

flake.lock

@@ -23,22 +23,6 @@
         "type": "github"
       }
     },
-    "argononed": {
-      "flake": false,
-      "locked": {
-        "lastModified": 1729566243,
-        "narHash": "sha256-DPNI0Dpk5aym3Baf5UbEe5GENDrSmmXVdriRSWE+rgk=",
-        "owner": "nvmd",
-        "repo": "argononed",
-        "rev": "16dbee54d49b66d5654d228d1061246b440ef7cf",
-        "type": "github"
-      },
-      "original": {
-        "owner": "nvmd",
-        "repo": "argononed",
-        "type": "github"
-      }
-    },
     "flake-compat": {
       "flake": false,
       "locked": {
@@ -53,21 +37,6 @@
         "url": "https://git.lix.systems/lix-project/flake-compat/archive/main.tar.gz"
       }
     },
-    "flake-compat_2": {
-      "locked": {
-        "lastModified": 1767039857,
-        "narHash": "sha256-vNpUSpF5Nuw8xvDLj2KCwwksIbjua2LZCqhV1LNRDns=",
-        "owner": "edolstra",
-        "repo": "flake-compat",
-        "rev": "5edf11c44bc78a0d334f6334cdaf7d60d732daab",
-        "type": "github"
-      },
-      "original": {
-        "owner": "edolstra",
-        "repo": "flake-compat",
-        "type": "github"
-      }
-    },
     "home-manager": {
       "inputs": {
         "nixpkgs": [
@@ -175,80 +144,6 @@
         "type": "github"
       }
     },
-    "nixos-images": {
-      "inputs": {
-        "nixos-stable": [
-          "nixos-raspberrypi",
-          "nixpkgs"
-        ],
-        "nixos-unstable": [
-          "nixos-raspberrypi",
-          "nixpkgs"
-        ]
-      },
-      "locked": {
-        "lastModified": 1747747741,
-        "narHash": "sha256-LUOH27unNWbGTvZFitHonraNx0JF/55h30r9WxqrznM=",
-        "owner": "nvmd",
-        "repo": "nixos-images",
-        "rev": "cbbd6db325775096680b65e2a32fb6187c09bbb4",
-        "type": "github"
-      },
-      "original": {
-        "owner": "nvmd",
-        "ref": "sdimage-installer",
-        "repo": "nixos-images",
-        "type": "github"
-      }
-    },
-    "nixos-raspberrypi": {
-      "inputs": {
-        "argononed": "argononed",
-        "flake-compat": "flake-compat_2",
-        "nixos-images": "nixos-images",
-        "nixpkgs": [
-          "nixpkgs-uconsole"
-        ]
-      },
-      "locked": {
-        "lastModified": 1781324200,
-        "narHash": "sha256-JWqxN2Yle86+4Q+GFh12SvB92ZyLeqalVsN9lfMh6eQ=",
-        "owner": "gortium",
-        "repo": "nixos-raspberrypi",
-        "rev": "721a6e9e67dca3a23133db650b87018646bca3e6",
-        "type": "github"
-      },
-      "original": {
-        "owner": "gortium",
-        "ref": "cm5-cross-v1",
-        "repo": "nixos-raspberrypi",
-        "type": "github"
-      }
-    },
-    "nixos-uconsole": {
-      "inputs": {
-        "nixos-raspberrypi": [
-          "nixos-raspberrypi"
-        ],
-        "nixpkgs": [
-          "nixpkgs-uconsole"
-        ]
-      },
-      "locked": {
-        "lastModified": 1781476310,
-        "narHash": "sha256-jY6ujqLXNAWJGvt+pAuw1Wg/OiHRGd1B1Z7Czhiq7Q4=",
-        "owner": "gortium",
-        "repo": "nixos-uconsole",
-        "rev": "38a7fcbffbf2d2e122bc1e1c634fe25f66ecda13",
-        "type": "github"
-      },
-      "original": {
-        "owner": "gortium",
-        "ref": "pr/dcs-panel-detection",
-        "repo": "nixos-uconsole",
-        "type": "github"
-      }
-    },
     "nixpkgs": {
       "locked": {
         "lastModified": 1705033721,
@@ -281,22 +176,6 @@
         "type": "github"
       }
     },
-    "nixpkgs-uconsole": {
-      "locked": {
-        "lastModified": 1780952837,
-        "narHash": "sha256-Fwd1+spDtQ0hDyBwme6ufG3n4mY0UrjjFdYHv+G/Hds=",
-        "owner": "NixOS",
-        "repo": "nixpkgs",
-        "rev": "e820eb4a444b46a19b2e03e8dfd2359439ff30fe",
-        "type": "github"
-      },
-      "original": {
-        "owner": "NixOS",
-        "ref": "nixos-25.11",
-        "repo": "nixpkgs",
-        "type": "github"
-      }
-    },
     "nixpkgs_2": {
       "locked": {
         "lastModified": 1774386573,
@@ -333,10 +212,7 @@
       "inputs": {
         "agenix": "agenix",
         "lix": "lix",
-        "nixos-raspberrypi": "nixos-raspberrypi",
+        "nixpkgs": "nixpkgs_2"
-        "nixos-uconsole": "nixos-uconsole",
-        "nixpkgs": "nixpkgs_2",
-        "nixpkgs-uconsole": "nixpkgs-uconsole"
       }
     },
     "systems": {

flake.nix

@@ -12,21 +12,10 @@
       url = "git+https://git.lix.systems/lix-project/lix?ref=main";
       inputs.nixpkgs.follows = "nixpkgs";
     };
-    nixpkgs-uconsole.url = "github:NixOS/nixpkgs/nixos-25.11";
+    self.submodules = true;
-    nixos-uconsole = {
-      url = "github:gortium/nixos-uconsole/pr/dcs-panel-detection";
-      inputs.nixpkgs.follows = "nixpkgs-uconsole";
-      inputs.nixos-raspberrypi.follows = "nixos-raspberrypi";
-    };
-    nixos-raspberrypi = {
-      url = "github:gortium/nixos-raspberrypi/cm5-cross-v1";
-      inputs.nixpkgs.follows = "nixpkgs-uconsole";
-    };
   };
 
-  outputs = { self, nixpkgs, agenix, lix
+  outputs = { self, nixpkgs, agenix, lix, ... }@inputs:
-            , nixpkgs-uconsole, nixos-uconsole, nixos-raspberrypi
-            , ... }@inputs:
     let
       system = "x86_64-linux";
       keys = import ./lib/keys.nix;
@@ -41,159 +30,57 @@
       pkgs = import nixpkgs {
         inherit system overlays;
         config.allowUnfree = true;
-        config.permittedInsecurePackages = [ "openclaw-2026.3.12" ];
+        config.permittedInsecurePackages = [
+          "openclaw-2026.3.12"
+        ];
       };
+
       devShell = import ./shells/nix_dev.nix {
         inherit pkgs system agenix;
       };
-    in {
+    in
-      nixosConfigurations = {
+      {
-        lazyworkhorse = nixpkgs.lib.nixosSystem {
+        nixosConfigurations = {
-          specialArgs = { inherit system self keys paths inputs; };
+          lazyworkhorse = nixpkgs.lib.nixosSystem {
-          modules = [
+            specialArgs = { inherit system self keys paths inputs; };
-            {
+            modules = [
-              nixpkgs.overlays = overlays;
+              {
-              nixpkgs.config.allowUnfree = true;
+                nixpkgs.overlays = overlays;
-              nixpkgs.config.rocmSupport = true;
+                nixpkgs.config.allowUnfree = true;
-              nixpkgs.config.permittedInsecurePackages = [ "openclaw-2026.3.12" ];
+                nixpkgs.config.rocmSupport = true;
-              nix.package = lix.packages.${system}.default;
+                nixpkgs.config.permittedInsecurePackages = [
-            }
+                  "openclaw-2026.3.12"
-            agenix.nixosModules.default
+                ];
-            ./hosts/lazyworkhorse/configuration.nix
+                nix.package = lix.packages.${system}.default;
-            ./hosts/lazyworkhorse/hardware-configuration.nix
+              }
-            ./modules/nixos/filesystem/hoardingcow-mount.nix
+              agenix.nixosModules.default
-            ./modules/nixos/services/docker_manager.nix
+              ./hosts/lazyworkhorse/configuration.nix
-            ./modules/nixos/services/open_code_server.nix
+              ./hosts/lazyworkhorse/hardware-configuration.nix
-            ./modules/nixos/services/ollama_init_custom_models.nix
+              ./modules/nixos/filesystem/hoardingcow-mount.nix
-            ./modules/nixos/services/openclaw_node.nix
+              ./modules/nixos/services/docker_manager.nix
-            ./modules/nixos/security/ai-worker-restricted.nix
+              ./modules/nixos/services/open_code_server.nix
-            ./users/gortium.nix
+              ./modules/nixos/services/ollama_init_custom_models.nix
-            ./users/ai-worker.nix
+              ./modules/nixos/services/openclaw_node.nix
-          ];
+              ./modules/nixos/security/ai-worker-restricted.nix
-        };
+              ./users/gortium.nix
-
+              ./users/ai-worker.nix
-        cyt-pi = nixpkgs.lib.nixosSystem {
+            ];
-          specialArgs = { inherit self keys paths inputs; };
-          modules = [
-            {
-              nixpkgs.overlays = overlays;
-              nixpkgs.config.allowUnfree = true;
-              nixpkgs.hostPlatform = "aarch64-linux";
-              nix.package = lix.packages."aarch64-linux".default;
-            }
-            ./hosts/cyt-pi/configuration.nix
-            ./hosts/cyt-pi/hardware-configuration.nix
-          ];
-        };
-
-        uconsole-cm5 = nixpkgs-uconsole.lib.nixosSystem {
-          system = "aarch64-linux";
-          specialArgs = {
-            inherit self keys paths inputs;
-            nixos-raspberrypi = nixos-raspberrypi;
-            isCM4 = false;
           };
-          modules = [
-            {
-              nixpkgs.buildPlatform = "x86_64-linux";
-              nixpkgs.hostPlatform = "aarch64-linux";
-              nixpkgs.config.allowUnfree = true;
-              boot.loader.raspberry-pi.bootloader = "kernel";
-              # Kill camera packages — not needed on uConsole, break cross-compile
-              nixpkgs.overlays = [
-                # Make camera packages "unavailable" so no pkgs depend on them
-                (final: prev: {
-                  libcamera = prev.libcamera.overrideAttrs (_: { meta.platforms = []; });
-                  libcamera-rpi = prev.libcamera-rpi.overrideAttrs (_: { meta.platforms = []; });
-                  libpisp = prev.libpisp.overrideAttrs (_: { meta.platforms = []; });
-                  # Pipewire in nixos-25.11 has libcamera unconditionally in buildInputs;
-                  # meta.platforms trick doesn't help — must actually remove it
-                  pipewire = prev.pipewire.overrideAttrs (old: {
-                    buildInputs = builtins.filter
-                      (x: !(x?pname && x.pname == "libcamera"))
-                      (old.buildInputs or []);
-                    mesonFlags = builtins.filter
-                      (flag: !(builtins.isString flag && builtins.match ".*libcamera.*" flag != null))
-                      (old.mesonFlags or []) ++ [ "-Dlibcamera=disabled" ];
-                  });
-                  # gjs cross-compile fails without GTK; skip intro tests
-                  gjs = prev.gjs.overrideAttrs (old: {
-                    mesonFlags = (old.mesonFlags or []) ++ [ "-Dskip_gtk_tests=true" ];
-                  });
-                  # Qt6Quick missing from aarch64 qtdeclarative cross-compile;
-                  # skip qtutils runtime deps — Hyprland only needs it for QML UI
-                  hyprland = prev.hyprland.override { wrapRuntimeDeps = false; };
-                  # hyprwayland-scanner not found by cross pkg-config wrapper
-                  xdg-desktop-portal-hyprland = prev.xdg-desktop-portal-hyprland.overrideAttrs (old: {
-                    preConfigure = (old.preConfigure or "") + ''
-                      # Point cmake to the correct hyprwayland-scanner pkgconfig
-                      cmakeFlags="$cmakeFlags -Dhyprwayland-scanner_DIR=${prev.buildPackages.hyprwayland-scanner}/lib/cmake/hyprwayland-scanner" 2>/dev/null || true
-                      export PKG_CONFIG_PATH="${prev.buildPackages.hyprwayland-scanner}/lib/pkgconfig:$PKG_CONFIG_PATH"
-                    '';
-                  });
-                })
-              ];
-            }
-            nixos-raspberrypi.nixosModules.nixpkgs-rpi
-            # Disable libcamera in rpi pipewire too (separate nixpkgs instance)
-            ({ config, lib, pkgs, ... }: {
-              nixpkgs.overlays = [
-                (final: prev: {
-                  pipewire = prev.pipewire.overrideAttrs (old: {
-                    buildInputs = builtins.filter
-                      (x: !(x?pname && x.pname == "libcamera"))
-                      (old.buildInputs or []);
-                    mesonFlags = builtins.filter
-                      (flag: !(builtins.isString flag && builtins.match ".*libcamera.*" flag != null))
-                      (old.mesonFlags or []) ++ [ "-Dlibcamera=disabled" ];
-                  });
-                })
-              ];
-            })
 
-# Patches are now in gortium/nixos-uconsole fork (pr/dcs-panel-detection branch)
+          cyt-pi = nixpkgs.lib.nixosSystem {
-            nixos-raspberrypi.nixosModules.raspberry-pi-5.base
+            specialArgs = { inherit self keys paths inputs; };
-            nixos-raspberrypi.lib.inject-overlays
+            modules = [
-            nixos-raspberrypi.lib.inject-overlays-global
+              {
-            nixos-uconsole.nixosModules.uconsole-cm5
+                nixpkgs.overlays = overlays;
-            ({ config, lib, pkgs, inputs, ... }: let
+                nixpkgs.config.allowUnfree = true;
-              lix-cross = import inputs.nixpkgs-uconsole {
+                nixpkgs.hostPlatform = "aarch64-linux";
-                localSystem = { system = "x86_64-linux"; };
+                nix.package = lix.packages."aarch64-linux".default;
-                crossSystem = { system = "aarch64-linux"; };
+              }
-                overlays = [ inputs.lix.overlays.default ];
+              ./hosts/cyt-pi/configuration.nix
-              };
+              ./hosts/cyt-pi/hardware-configuration.nix
-            in { nix.package = lix-cross.lix; })
+            ];
-            agenix.nixosModules.default
-            ./hosts/uconsole-cm5/configuration.nix
-            ./hosts/uconsole-cm5/hardware-configuration.nix
-          ];
-        };
-      };
-
-      devShells.${system}.default = devShell;
-
-      packages.${system} = {
-        uconsole-cm5-image = (nixos-raspberrypi.lib.nixosSystem {
-          system = "aarch64-linux";
-          specialArgs = {
-            inherit self keys inputs;
-            nixos-raspberrypi = nixos-raspberrypi;
-            isCM4 = false;
           };
-          modules = [
+        };
-            {
+        devShells.${system}.default = devShell;
-              nixpkgs.buildPlatform = system;
-              nixpkgs.hostPlatform = "aarch64-linux";
-            }
-            nixos-raspberrypi.nixosModules.nixpkgs-rpi
-            nixos-raspberrypi.nixosModules.raspberry-pi-5.base
-            nixos-raspberrypi.lib.inject-overlays-global
-            nixos-raspberrypi.nixosModules.sd-image
-            nixos-uconsole.nixosModules.uconsole-cm5
-            agenix.nixosModules.default
-            ./hosts/uconsole-cm5/configuration.nix
-          ];
-        }).config.system.build.sdImage;
       };
-    };
 }

hosts/lazyworkhorse/configuration.nix

@@ -9,7 +9,7 @@
   hoardingcow-mount.enable = true;
 
   # Flakesss
-  nix.settings.experimental-features = [ "nix-command" "flakes" "flake-self-attrs" "ca-derivations" ];
+  nix.settings.experimental-features = [ "nix-command" "flakes" "flake-self-attrs" ];
   nix.settings.trusted-users = [ "root" "gortium" ];
 
   # Garbage collection
@@ -207,7 +207,6 @@
     ai = {
       path = self + "/assets/compose/ai";
       envFile = config.age.secrets.containers_env.path;
-      ports = [ 22000 ];  # Syncthing TCP sync
     };
 
     cloudstorage = {

hosts/uconsole-cm5/configuration.nix

@@ -1,36 +0,0 @@
-{ config, lib, pkgs, keys, ... }:
-
-{
-  networking.hostName = "uConsole";
-  time.timeZone = "America/Montreal";
-  i18n.defaultLocale = "en_CA.UTF-8";
-  system.stateVersion = "25.11";
-
-  # SSH — root access avec clés gortium + ai-worker
-  services.openssh = {
-    enable = true;
-    settings = {
-      PermitRootLogin = lib.mkForce "prohibit-password";
-      PasswordAuthentication = lib.mkForce false;
-    };
-  };
-
-  users.users.root.openssh.authorizedKeys.keys = with keys; [
-    users.gortium.main
-    users.ai-worker.main
-  ];
-
-  # WiFi via NetworkManager + secret agenix
-  networking.networkmanager.enable = true;
-
-  # Firmware
-  hardware.enableRedistributableFirmware = true;
-
-  # Hyprland Wayland compositor (manual start — no SDDM)
-  programs.hyprland = {
-    enable = true;
-    xwayland.enable = true;
-  };
-
-
-}

hosts/uconsole-cm5/hardware-configuration.nix

@@ -1,30 +0,0 @@
-{ config, lib, pkgs, modulesPath, ... }:
-
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-  ];
-
-  boot.initrd.availableKernelModules = [ "xhci_pci" "usbhid" "usb_storage" "sdhci_pci" "nvme" ];
-  boot.initrd.kernelModules = [ ];
-  boot.extraModulePackages = [ ];
-
-  # SD card partitions (nixos-uconsole layout)
-  fileSystems."/" = {
-    device = "/dev/disk/by-label/NIXOS_SD";
-    fsType = "ext4";
-    options = [ "noatime" ];
-  };
-
-  fileSystems."/boot/firmware" = {
-    device = "/dev/disk/by-label/FIRMWARE";
-    fsType = "vfat";
-    options = [ "fmask=0022" "dmask=0022" ];
-  };
-
-  swapDevices = [ ];
-
-  nixpkgs.hostPlatform = lib.mkDefault "aarch64-linux";
-  hardware.enableRedistributableFirmware = true;
-  powerManagement.cpuFreqGovernor = lib.mkDefault "ondemand";
-}

modules/nixos/services/default.nix

@@ -1,6 +0,0 @@
-{
-  imports = [
-    ./dotfiles.nix
-    ./systemd
-  ];
-}

modules/nixos/services/dotfiles.nix

@@ -1,69 +0,0 @@
-{ config, lib, pkgs, ... }:
-
-with lib;
-
-let
-  cfg = config.services.dotfiles;
-  stowDir = cfg.stowDir;
-
-  # Function to recursively find all files in a directory
-  findFiles = dir:
-    let
-      files = builtins.attrNames (builtins.readDir dir);
-    in
-      concatMap (name:
-        let
-          path = dir + "/${name}";
-        in
-          if (builtins.typeOf (builtins.readDir path) == "set")
-          then findFiles path
-          else [ path ]
-      ) files;
-
-  # Get a list of all packages (directories) in the stow directory
-  stowPackages = builtins.attrNames (builtins.readDir stowDir);
-
-  # Create an attribute set where each attribute is a package name
-  # and the value is a list of files to be linked.
-  homeManagerLinks = listToAttrs (map (pkg:
-    let
-      pkgPath = stowDir + "/${pkg}";
-      files = findFiles pkgPath;
-    in
-      nameValuePair pkg (map (file: {
-        source = file;
-        target = removePrefix (pkgPath + "/") file;
-      }) files)
-  ) stowPackages);
-
-in
-{
-  options.services.dotfiles = {
-    enable = mkEnableOption "Enable dotfiles management";
-
-    stowDir = mkOption {
-      type = types.path;
-      description = "The directory where your stow packages are located.";
-    };
-
-    user = mkOption {
-      type = types.str;
-      description = "The user to manage dotfiles for.";
-    };
-  };
-
-  config = mkIf cfg.enable {
-    home-manager.users.${cfg.user} = {
-      home.file =
-        let
-          allFiles = concatLists (attrValues homeManagerLinks);
-        in
-          listToAttrs (map (file:
-            nameValuePair file.target {
-              source = file.source;
-            }
-          ) allFiles);
-    };
-  };
-}
-

secrets/home_wifi.age

@@ -1,10 +0,0 @@
------BEGIN AGE ENCRYPTED FILE-----
-YWdlLWVuY3J5cHRpb24ub3JnL3YxCi0+IHNzaC1lZDI1NTE5IEdoTUQ4QSAycE1Y
-YmMvUWZpK2VKQVlqaHFtaERBRGROcFIyL0d6dEVRQmFxLzlqdFZNCkYxWkNIUXRZ
-V0dQOG4zY3U3Nk1JelBtY0cwUGdxaEI3dmZaVTZId04rVTQKLT4geV1cZC4wMnst
-Z3JlYXNlIDYgOG1IME1xCkQ0RGN1NU1FUWk0Y1RmamNEY0tJWmFQNGdoMkROcGVy
-aU5UYVFobVRLMVVUQ1JicUM2c0tSVzRQdEZ0VE5YamQKZUxPeVpLWDZJR0hqemdD
-cmkyUUdFZEZKZjBDNGhmNFR6bVUKLS0tIDRQUGR5RGI5UEhGNk5EQWw4dFk0R01k
-TUJWOFpleXBUajFPckFmem52cGsKHzn+QnuYLI2NEh5WWZQHrNuvVzYk+kVjsAsn
-KNS2dHjvadAopVY2Gypldf1p2RRtmgZkDHaPlNzv5Hk=
------END AGE ENCRYPTED FILE-----

secrets/secrets.nix

@@ -11,5 +11,4 @@ in
   "lazyworkhorse_host_ssh_key.age".publicKeys = authorizedKeys;
   "n8n_ssh_key.age".publicKeys = authorizedKeys;
   "openclaw_gateway_token.age".publicKeys = authorizedKeys;
-  "home_wifi.age".publicKeys = authorizedKeys;
 }

users/gortium.nix

@@ -1,5 +1,4 @@
 { pkgs, inputs, config, keys, ... }: {
-  home-manager.users.gortium = import ./home.nix;
   users.users.gortium = {
     isNormalUser = true;
     extraGroups = [ "wheel" "docker" "video" "render"];

users/gortium/home.nix

@@ -1,12 +0,0 @@
-{ pkgs, ... }: {
-  services.dotfiles = {
-    enable = true;
-    stowDir = ../../../assets/dotfiles;
-    user = "gortium";
-  };
-
-  home.username = "gortium";
-  home.homeDirectory = "/home/gortium";
-  home.stateVersion = "23.11"; # Please change this to your version.
-  programs.home-manager.enable = true;
-}