docs: plan the post-boot hygiene tasks
neogaia was installed from a configuration written before the hardware existed, so several things are now knowably wrong rather than guessed. Adopt the upstream hardware profile for this laptop, which fixes deep sleep, thermal management and the touchpad driver. Bound the store, the retained generations and the boot menu, none of which have a limit today. Declare the commit identity, which currently lives only in one checkout. Grow the EFI system partition, which holds around seven generations at its present size and cannot be enlarged in place, since the encrypted container immediately behind it would have to be relocated. That makes a reimage the only practical route, and the cheapest moment for one is now. It doubles as the reproducibility test of the install documentation.
This commit is contained in:
20
.claude/tasks/0017-hardware-detection-refresh.md
Normal file
20
.claude/tasks/0017-hardware-detection-refresh.md
Normal file
@@ -0,0 +1,20 @@
|
||||
---
|
||||
blocked-by: 0016-esp-resize-and-reimage
|
||||
---
|
||||
|
||||
## What to build
|
||||
|
||||
Replace `neogaia`'s hand-written hardware detection file with a real scan of the machine it describes.
|
||||
|
||||
The file was written before the laptop ran NixOS, as an educated guess at what a Dell XPS 13 9380 needs, and still says so. The guess turned out to be adequate — the module required to reach the encrypted root is present and working — so this is honesty maintenance rather than a fix. It matters because the next person to read the file, including a future reader of this repo, should be able to trust that it describes measured hardware.
|
||||
|
||||
Only the detection results are kept: the modules the initrd needs, the modules the kernel loads, and the platform. The generated output also contains filesystem and swap declarations, which are dropped — the declarative disk layout owns those, produces them on every evaluation, and a second stale definition would either conflict outright or silently disagree.
|
||||
|
||||
Generating the scan requires root on the target machine.
|
||||
|
||||
## Acceptance criteria
|
||||
|
||||
- [ ] The detection file's contents come from a scan of the running machine rather than a guess
|
||||
- [ ] Filesystem and swap declarations are absent from it, leaving the disk layout as the sole source of those
|
||||
- [ ] The file no longer describes itself as a placeholder, and says plainly what it holds
|
||||
- [ ] `nix flake check` builds the `neogaia` toplevel
|
||||
Reference in New Issue
Block a user