diff --git a/docs/MIGRATION.md b/docs/MIGRATION.md index b3ceb35..5d68162 100644 --- a/docs/MIGRATION.md +++ b/docs/MIGRATION.md @@ -210,7 +210,7 @@ and it's whichever has higher Nix priority. Fix these explicitly: | Graphics | `hardware.graphics.enable = true` (was `hardware.opengl`) | Probably already enabled — fine | | User groups | needs `video render networkmanager` | Add to your `users.users..extraGroups` | | `/etc/os-release` | `ID=nomarchy`, `NAME=Nomarchy` | A few third-party scripts grep `ID=nixos` — adjust them or rely on `ID_LIKE` (TBD) | -| autoLogin | `enable = true; user = "nomarchy";` (mkDefault) | Override with `services.displayManager.autoLogin.user = ""` or disable | +| autoLogin | `enable = false; user = "nomarchy";` (mkDefault) | Off by default — opt in with `services.displayManager.autoLogin = { enable = true; user = ""; };` if you want it | Impermanence is **off** unless you set `nomarchy.system.impermanence.enable = true`, and it requires a BTRFS layout with a `root-blank` snapshot. Don't enable it diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 85f0f30..a3ea69d 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -19,7 +19,9 @@ Guardrails (apply when adding anything): ### Now (ready to pick up) -- (Empty for now) +- **Full QA audit of shipped features.** Walk every feature/component end-to-end on a real install, fix what's small, log what's not. Runs as per-component PR sweeps — methodology in [Pillar 8](#8-pillar-qa-audit--features--components). +- **Installer: "What's installed?" summary on first boot.** Surface what the installer actually wrote (theme, font, profiles, drives, form factor) from `state.json` + `nomarchy-system-scripts` introspection so the user can verify before they start customising. Detail in [Pillar 4](#4-pillar-installer). +- **Installer: optional non-LUKS branch.** Let users explicitly opt out of FDE during install. Detail in [Pillar 4](#4-pillar-installer). ### Next (bigger lifts that build on Now) @@ -73,23 +75,23 @@ Each PR description should reference the row(s) in `docs/SCRIPTS.md` it closes, ## 4. Pillar: Installer -- Software-profile multi-select (Now). +- "What's installed?" summary screen on boot of a freshly-installed system, sourced from `state.json` + `nomarchy-system-scripts` introspection (Now). +- Optional non-LUKS branch in the installer for users who explicitly opt out of FDE (Now). - Richer disk metadata (Shipped). -- Form-factor → laptop preset (Now, depends on Pillar 5). - `disko-golden.nix` variants for software-RAID and BTRFS-pool-as-root (Shipped). - Pre-flight resume polish (Shipped). -- "What's installed?" summary screen on boot of a freshly-installed system, sourced from `state.json` + `nomarchy-system-scripts` introspection. -- Optional non-LUKS branch in the installer for users who explicitly opt out of FDE. +- Software-profile multi-select (Shipped). +- Form-factor → laptop preset (Shipped). ## 5. Pillar: Power, hardware, presets -- Laptop preset (Next): TLP, upower, brightness, lid, hypridle tuning. -- Desktop preset (Next): performance governor, no laptop UI (already filtered), ZFS hooks. -- Accessibility preset (Next). -- Gaming preset (Next). -- Vendor matchers in `installer/hardware-db.sh` (Shipped — ROG Ally added; Surface/Framework/Lenovo entries corrected; Steam Deck + Snapdragon X documented as nixos-hardware-unsupported. CI now lints DB references). -- Surface support behind `nomarchy.hardware.isSurface` (Later). - Auto-detect dGPU presence in `installer/hardware-db.sh` and pre-fill `hardware.nvidia.prime.{intel,nvidia}BusId` in the generated `system.nix` (driver stack itself is Shipped — see entry below). +- Surface support behind `nomarchy.hardware.isSurface` (Later). +- Laptop preset: TLP, upower, brightness, lid, hypridle tuning (Shipped). +- Desktop preset: performance governor, no laptop UI (already filtered), ZFS hooks (Shipped). +- Accessibility preset (Shipped). +- Gaming preset (Shipped). +- Vendor matchers in `installer/hardware-db.sh` (Shipped — ROG Ally added; Surface/Framework/Lenovo entries corrected; Steam Deck + Snapdragon X documented as nixos-hardware-unsupported. CI now lints DB references). ## 6. Pillar: Onboarding & docs @@ -109,6 +111,33 @@ Each PR description should reference the row(s) in `docs/SCRIPTS.md` it closes, - `nixosTest` per palette: boots `default` in a VM, screenshots the SDDM splash and the Hyprland desktop, diffs vs golden. Failure surfaces as CI red. - A small `bin/utils/nomarchy-bench-iso-build` that records ISO build time + size into a per-commit JSON so we notice regressions. +## 8. Pillar: QA audit — features & components + +Nomarchy now spans an installer, ~159 `nomarchy-*` scripts, a Hyprland desktop stack (Hyprland + waybar + walker + nightlight + idle), curated apps, a 22-palette theme engine, and two ISO hosts. Pillar 3 audited script *existence*; this pillar audits feature *behavior*. The goal: walk every shipped feature end-to-end on a real install, fix every bug or surprise inline when small, and capture the rest as new roadmap rows. + +Runs as **per-component sweeps**. One PR per component, branch `wave/qa-`. Don't grow scope mid-PR — bugs that need a new option, refactor, or missing module become a new **Now**/**Next** row. + +Components (each is one sweep): + +1. **Installer** — `installer/install.sh`, `installer/hardware-db.sh`, disko configs. Fresh install + `--resume` + `--dry-run`, on laptop and desktop, with FDE (non-LUKS branch is Later). Verify every generated file (`flake.nix`, `system.nix`, `home.nix`, `hardware-selection.nix`, `state.json`) is correct and idempotent. +2. **First-boot UX** — `nomarchy-welcome`, generated `home.nix`, SDDM and Plymouth metadata, default theme/font/panel position. Re-run on a clean VM; note every prompt that confuses and every default that's wrong. +3. **Core system modules** — `core/system/*` (laptop, desktop, accessibility, gaming, hybridGPU, impermanence, network, hardware, branding). For each: enable → rebuild → observe the claimed effect → disable → rebuild → observe it's gone. Cross-check against `docs/OPTIONS.md`. +4. **Core home modules** — `core/home/*` (options, state, behavior, overrides, deployed config). Verify every home-side `nomarchy.*` option does what its description claims; confirm `~/.config/nomarchy/overrides/` actually overrides. +5. **Desktop stack** — Hyprland (keybindings, window rules, monitors, input), waybar (every module × both panel positions × both form factors), walker (every launcher mode), idle, nightlight, notifications (mako). Reconcile `docs/KEYBINDINGS.md` against runtime. +6. **Apps** — `features/apps/*`. Each app: launches, themed via Stylix, configured as expected. Catches the "we package it but nobody configured it" class. +7. **Theme engine + palettes** — `nomarchy-theme-set` across all 22 palettes, font and wallpaper switchers, light-mode toggle. Verify per-palette Stylix targets render correctly across SDDM, Plymouth, GTK, Qt, terminals, browsers, waybar, walker. +8. **Scripts (runtime behavior)** — Pillar 3 confirmed existence; this sweep runs every user-visible script (especially every `nomarchy-menu` entry) on current NixOS and confirms it actually does the thing. +9. **ISOs** — boot `nomarchy-installer` and `nomarchy-live`; verify the `nomarchy-test-live-iso` flow; check the installer ISO ships every tool `install.sh` calls (regression class: `hardware-db.sh` missing, already shipped). +10. **Lib + state schema** — `lib/state-schema.nix`, color resolution, path helpers. Cross every codepath that produces `state.json` (installer, welcome wizard, hand-edit) against the schema; confirm bad inputs are rejected with a useful message. + +Per-PR deliverable: + +- PR body lists what was tested, what was broken, what was fixed inline, what was deferred (with the new roadmap row linked). +- Doc updates ride with the change per `docs/AGENT.md` §5.4. +- Don't bundle fixes across components — keep one component per branch so reviewers can spot-check end-to-end without context-switching. + +Pillar is **done** when every component has a closed `wave/qa-` PR and the roadmap captures every deferred finding. + ## 9. Process notes - **Branch naming:** `wave/-`. Examples: `wave/audit-pkg-scripts`, `wave/installer-disk-metadata`, `wave/laptop-preset`. diff --git a/features/scripts/utils/nomarchy-welcome b/features/scripts/utils/nomarchy-welcome index 4ce78f6..bf30367 100755 --- a/features/scripts/utils/nomarchy-welcome +++ b/features/scripts/utils/nomarchy-welcome @@ -59,39 +59,9 @@ if [[ "$USER" == "nixos" ]]; then exit 0 fi -# 4. Starter home.nix +# 4. Setup Local Repo (Crucial for nomarchy-env-update to work) echo "" -echo "Step 4: Starter home.nix" -HOME_NIX="$HOME/.config/home-manager/home.nix" -if [ ! -f "$HOME_NIX" ]; then - echo "It looks like you don't have a ~/.config/home-manager/home.nix file yet." - echo "Nomarchy uses this file to manage your user-level packages and settings." - if gum confirm "Would you like to generate a starter home.nix?"; then - mkdir -p "$(dirname "$HOME_NIX")" - cat < "$HOME_NIX" -{ pkgs, ... }: -{ - # Nomarchy starter home.nix - # Add your user packages here. - home.packages = with pkgs; [ - btop - fastfetch - chromium - # Add more packages here - ]; - - # home.stateVersion = "25.11"; # Consult docs/MIGRATION.md if you change this -} -EOF - echo "Starter home.nix generated at $HOME_NIX" - fi -else - echo "Detected existing home.nix at $HOME_NIX. Skipping generation." -fi - -# 5. Setup Local Repo (Crucial for nomarchy-env-update to work) -echo "" -echo "Step 5: Git Repository Check" +echo "Step 4: Git Repository Check" echo "Nomarchy relies on a local git repository for declarative updates." if [ ! -d "/etc/nixos/.git" ]; then echo "Warning: /etc/nixos is not a git repository. Declarative updates might fail." @@ -102,7 +72,7 @@ if [ ! -d "/etc/nixos/.git" ]; then fi fi -# 6. Success +# 5. Success echo "" echo "Applying all changes..." nomarchy-env-update diff --git a/themes/engine/sddm.nix b/themes/engine/sddm.nix index 6e0e851..eb57ce7 100644 --- a/themes/engine/sddm.nix +++ b/themes/engine/sddm.nix @@ -27,8 +27,12 @@ in services.displayManager.defaultSession = lib.mkDefault "hyprland-uwsm"; + # autoLogin defaults off so hand-migrated configs (no installer-written + # username) don't try to log in as a nonexistent "nomarchy" user. The + # installer-generated system.nix sets both `enable = true;` and + # `user = "$USERNAME";` at normal priority, overriding these defaults. services.displayManager.autoLogin = { - enable = lib.mkDefault true; + enable = lib.mkDefault false; user = lib.mkDefault "nomarchy"; };