17 17 - `MANIFEST.md` must list every direct file in `quickshell/nugu`; orphaned or stale manifest rows fail the audit.
18 18 - `SCRIPTS.md` must inventory every `*.sh` file; each script must be executable and start with `#!/bin/sh` plus `set -eu`.
19 19 - `live-check.sh` is executable and audited read-only: it must not link, start, stop, enable, disable, restart, or launch `qs -c nugu`.
20 -- `smoke.sh` is executable and audited for self-contained temp `HOME`/`XDG_CONFIG_HOME`, named config launch, launcher/clipboard/power/native-notification/OSD IPC probes, cleanup trap, and no live link/service mutation.
20 +- `smoke.sh` is executable and audited for self-contained temp `HOME`/`XDG_CONFIG_HOME`, named config launch, launcher/clipboard/power/native-notification/OSD IPC probes, optional cropped dark/light screenshot checks, cleanup trap, and no live link/service mutation.
21 21 - `gate.sh` is executable and audited as the read-only/self-contained verification chain: audit, unit verify, smoke, live-check, optional strict live-check.
22 22 - every QML component is listed in `COMPONENTS.md` with purpose and rollout status.
23 23 - every `nugu` IPC method from `shell.qml` is listed in `IPC.md` with purpose and rollout status.
152 -The smoke runner now executes the audit before launching `qs -c nugu` with temporary `HOME` and `XDG_CONFIG_HOME`. It also opens/closes launcher and clipboard surfaces, verifies power confirmations stay dry-run, toggles the native notification loader only on the private smoke bus, and probes non-destructive OSD IPC. `gate.sh` now wraps audit, unit verification, smoke, and live readiness in one non-mutating command. The rollout runbook is audited as documentation only; it does not authorize live mutation.
157 +The smoke runner now executes the audit before launching `qs -c nugu` with temporary `HOME` and `XDG_CONFIG_HOME`. It also opens/closes launcher and clipboard surfaces, verifies power confirmations stay dry-run, toggles the native notification loader only on the private smoke bus, probes non-destructive OSD IPC, and can save cropped non-empty dark/light screenshots that must differ. `gate.sh` now wraps audit, unit verification, smoke, and live readiness in one non-mutating command. The rollout runbook is audited as documentation only; it does not authorize live mutation.
9 9 | `audit.sh` | Static repository guard for inventories, QML self-containment, Nugu style, rollout contracts, and stale dependency rows. | Read-only; checks files and exits without touching live HOME, services, DBus, or Hypr state. |
10 -| `smoke.sh` | Named-config scaffold runner using temporary `HOME` and `XDG_CONFIG_HOME` to prove Quickshell surfaces and IPC load without live links. | May create and remove only its own temp directory and its own temporary `qs` process. |
10 +| `smoke.sh` | Named-config scaffold runner using temporary `HOME` and `XDG_CONFIG_HOME` to prove Quickshell surfaces, IPC, and optional cropped screenshots load without live links. | May create and remove only its own temp directory, optional screenshot output directory contents requested by the caller, and its own temporary `qs` process. |
11 11 | `live-check.sh` | Read-only live readiness reporter for links, services, DBus health, Hypr config errors, and old helper refs. | Reports blockers only; never starts, stops, enables, disables, links, reloads, or launches `qs -c nugu`. |
12 12 | `gate.sh` | One-command verification chain for audit, user unit verification, smoke, live readiness, and optional strict live readiness. | Delegates only to audited non-mutating/self-contained gates; never performs rollout actions itself. |