From 41f6db32eda103c9a388325752dafad40e81b147 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?ryan4yin=20=7C=20=E4=BA=8C=E8=8A=B1?= Date: Wed, 21 Oct 2026 21:13:52 +0800 Subject: [PATCH] docs(workarounds): record the Colmena version override (#482) Assisted-by: DeepSeek Harness 0.2.1-rc.2 (claude-opus-5-5) --- WORKAROUNDS.md | 1 + outputs/default.nix | 1 + 2 files changed, 2 insertions(+) diff --git a/WORKAROUNDS.md b/WORKAROUNDS.md index e9d0d6da..2814d04c 100644 --- a/WORKAROUNDS.md +++ b/WORKAROUNDS.md @@ -54,6 +54,7 @@ A setting that works around a bug or a hardware quirk. | WA-039 | niri's NVIDIA free-buffer pool bounded (`GLVidHeapReuseRatio` 0) — `hosts/idols-ai/hardware-nvidia.nix` | the driver does not return freed vidmem buffers to its free pool, so niri's VRAM grows to ~1.1 GiB instead of the ~100 MiB its NVIDIA notes expect (measured 1137 MiB after 24 h uptime; [NVIDIA/egl-wayland#126](https://github.com/NVIDIA/egl-wayland/issues/126)) | Drop once a driver stops growing niri's VRAM without the profile, or niri ships its own default | 2026-10-19 | on an nvidia driver bump | active | | WA-040 | Root CA blacklist on NixOS and Darwin (Nix CA bundle only, not the macOS Keychain) — `modules/base/security.nix` | eMudhra intermediate keys were compromised; [NixOS/nixpkgs#576390](https://github.com/NixOS/nixpkgs/pull/576390) and [#576401](https://github.com/NixOS/nixpkgs/pull/576401) merged before reaching release channels | Drop once every consumed nixpkgs revision (`nixpkgs` and `nixpkgs-darwin`) includes the upstream root blacklist | 2026-10-20 | on nixpkgs bump | active | | WA-041 | Monitor OSD "no-signal auto power-off" disabled — no code in this repo (the P32A2V OSD setting) | during a DPMS-off idle the panel drops and re-adds HPD every ~13 s, and after wake niri keeps scanning out while the panel stays dark until the monitor is power cycled; the panel's own auto power-off drives that state, so it is now disabled. Pinning the mode to 120 Hz did not change the symptom | Drop once a driver retrains the DP link after a DPMS wake, the monitor firmware stops cycling HPD, or this monitor is replaced | 2026-10-21 | confirm on the next full idle cycle, then on an nvidia or monitor firmware update | active | +| WA-042 | Colmena nodes set `system.nixos.versionSuffix` and `revision` from the flake's lib — `outputs/default.nix` (`rawColmenaHive`) | Colmena evaluates each node with nixpkgs' `eval-config.nix` and plain lib, which reports `26.11pre-git`, so without the override a Colmena deploy differs from the `nixosConfigurations` toplevel; the `colmena-parity` eval test guards the match | Drop once Colmena evaluates nodes with the flake's lib or accepts `nixosConfigurations` directly, keeping `colmena-parity` green | 2026-10-21 | on a colmena bump | active | If WA-008 freezes recur, the fallback is to restore the parameters commented out in `hosts/idols-ai/hardware-configuration.nix` — diff --git a/outputs/default.nix b/outputs/default.nix index 04675ae2..045452f6 100644 --- a/outputs/default.nix +++ b/outputs/default.nix @@ -123,6 +123,7 @@ let deployment # Colmena evaluates with nixpkgs' plain lib, which lacks the version the # flake's lib reports; without this the toplevel differs (`26.11pre-git`). + # Recorded as WA-042 in WORKAROUNDS.md. { system.nixos.versionSuffix = lib.trivial.versionSuffix; system.nixos.revision = lib.trivial.revisionWithDefault null;