Give a laptop its first week: the keys, the lid, the battery's endgame

The audit's fourth tier -- what a Framework owner reaches for in the first
week and found missing.

The power button stops being an instant, unconfirmed poweroff: a shipped
logind drop-in tells the daemon to stand down and the compositor binds the
key to the power menu, the way GNOME turns it into a question. Holding it
still hard-cuts through firmware. change-settings restarts logind so the
change applies without waiting for a boot, and the Power page says what the
button does now.

The function row fills in: F10 (XF86RFKill) toggles airplane mode through a
new panama-osd verb that blocks or unblocks every radio and says which way it
went; F9 (XF86Display) opens the Displays page, the honest action until
mirroring exists. And the lid becomes a switch bind: closing a docked lid
turns the internal panel off so nothing renders inside a closed shell and no
workspace strands on an invisible output, and opening it restores the panel
with the mode and scale chosen in Settings. panama-lid owns both decisions;
undocked machines suspend via logind before any of it matters.

The battery gets an endgame. On battery the screen dims to 30% two-thirds of
the way to blanking -- GNOME's single largest idle battery saver -- and
restores exactly the level it saved. At the urgent threshold the machine
suspends after a fifteen-second grace, cancelled by plugging in, because a
suspend preserves the session for days and a hard cut at 0% preserves
nothing; "Only warn" remains a choice on the Power page. Hibernate joins the
power menu, but only where logind answers CanHibernate with yes -- an entry
that fails silently is worse than none.

And brightness stops being two code paths: the Displays page now embeds the
same control the quick-settings panel uses, so the built-in backlight and
DDC/CI monitors share one surface that withdraws itself where neither
exists. The lid contract narrows to what its principle protects -- a
HandleLidSwitch drop-in -- so deliberate policy for other keys can ship.

Claude-Session: https://claude.ai/code/session_01Epx9ZC1gwm81K3jm9x9CKh

config/dot/quickshell/scripts/panama-idle

@@ -117,6 +117,25 @@ generate() {
         printf '    inhibit_sleep = 2\n'
         printf '}\n'
 
+        # On battery, dim before blanking -- GNOME's single largest idle
+        # battery saver, and the gentle warning that the screen is about to
+        # go. Two-thirds of the way to blank, floor of 30 seconds; -s saves
+        # the level and -r restores exactly it, so a person's brightness
+        # choice survives the round trip. Only where a real backlight exists:
+        # a desktop's DDC monitor is not worth waking over this.
+        if on_battery && (( blank_min > 0 )) \
+            && command -v brightnessctl >/dev/null 2>&1 \
+            && [[ -n "$(ls /sys/class/backlight 2>/dev/null)" ]]; then
+            dim_at=$(( blank_min * 60 * 2 / 3 ))
+            (( dim_at < 30 )) && dim_at=30
+            printf '\n# %s seconds -> dim, undone on activity.\n' "$dim_at"
+            printf 'listener {\n'
+            printf '    timeout = %s\n' "$dim_at"
+            printf '    on-timeout = brightnessctl -c backlight -s set 30%%\n'
+            printf '    on-resume = brightnessctl -c backlight -r\n'
+            printf '}\n'
+        fi
+
         if (( blank_min > 0 )); then
             printf '\n# %s minutes -> screen off.\n' "$blank_min"
             printf 'listener {\n'

config/dot/quickshell/scripts/panama-lid

@@ -68,16 +68,64 @@ cmd_guard() {
         sleep infinity
 }
 
+# The internal panel's connector name, from the compositor: eDP, LVDS and
+# DSI are built in, everything else arrived through a cable -- the same rule
+# panama-hw and LidPolicy use.
+internal_connector() {
+    hyprctl -j monitors all 2>/dev/null \
+        | jq -r '[.[] | select(.name | test("^(eDP|LVDS|DSI)"; "i"))][0].name // empty'
+}
+
+# Bound to the lid switch by keybinds.lua. Closing a DOCKED lid turns the
+# internal panel off, so nothing renders inside a closed shell and no
+# workspace strands on an invisible output; an undocked lid does nothing here
+# because logind is already suspending the machine. Failure direction: if the
+# disable never runs, the panel stays lit inside the shell -- wasteful, not
+# harmful.
+cmd_close() {
+    "$HW" laptop || exit 0
+    "$HW" external-monitor || exit 0
+    local internal
+    internal="$(internal_connector)"
+    [[ -n "$internal" ]] || exit 0
+    hyprctl eval "hl.monitor({ output = \"$internal\", disable = true })" >/dev/null
+}
+
+# Re-enable on open, preferring what the person chose for this panel in
+# Settings (the same displays store monitors.lua reads at startup) and
+# falling back to the panel's preferred mode.
+cmd_open() {
+    "$HW" laptop || exit 0
+    local internal entry mode scale
+    internal="$(internal_connector)"
+    [[ -n "$internal" ]] || exit 0
+    entry="$(jq -c --arg name "$internal" '.displays[$name] // empty' \
+        "${XDG_CONFIG_HOME:-$HOME/.config}/panama/settings.json" 2>/dev/null)"
+    if [[ -n "$entry" ]]; then
+        mode="$(jq -r '.mode' <<<"$entry")"
+        scale="$(jq -r '.scale' <<<"$entry")"
+        hyprctl eval "hl.monitor({ output = \"$internal\", mode = \"$mode\", position = \"auto\", scale = $scale })" >/dev/null
+    else
+        hyprctl eval "hl.monitor({ output = \"$internal\", mode = \"preferred\", position = \"auto\", scale = \"auto\" })" >/dev/null
+    fi
+}
+
 case "${1:-status}" in
     status) cmd_status ;;
     guard)  cmd_guard ;;
+    close)  cmd_close ;;
+    open)   cmd_open ;;
     -h|--help)
         cat <<'USAGE'
-usage: panama-lid [status|guard]
+usage: panama-lid [status|guard|close|open]
 
   status   what closing the lid would do right now, as JSON
   guard    hold a handle-lid-switch inhibitor while an external display is
            connected; exits immediately on a machine that needs none
+  close    docked lid closed: turn the internal panel off (bound to the lid
+           switch by keybinds.lua); does nothing undocked
+  open     lid opened: turn the internal panel back on, restoring the mode
+           and scale chosen in Settings
 USAGE
         ;;
     *) printf 'panama-lid: unknown command: %s\n' "$1" >&2; exit 2 ;;

config/dot/quickshell/scripts/panama-osd

@@ -240,11 +240,34 @@ media_action() {
     show_message "$kind" "$label"
 }
 
+# Airplane mode: one rfkill state for every radio, with an OSD saying which
+# way it went. "Any radio unblocked" reads as radios-on, so toggle means
+# "block everything" from a mixed state -- the direction a person reaching
+# for airplane mode wants.
+airplane_action() {
+    case "${1:-toggle}" in
+        toggle)
+            if rfkill list 2>/dev/null | grep -q 'Soft blocked: no'; then
+                rfkill block all 2>/dev/null \
+                    && show_message "airplane-mode-symbolic" "Airplane mode on"
+            else
+                rfkill unblock all 2>/dev/null \
+                    && show_message "network-wireless-symbolic" "Airplane mode off"
+            fi
+            ;;
+        *)
+            printf 'Usage: panama-osd airplane toggle\n' >&2
+            return 2
+            ;;
+    esac
+}
+
 case "${1:-}" in
     volume) shift; adjust_volume "$@" ;;
     microphone) shift; adjust_microphone "$@" ;;
     brightness) shift; adjust_brightness "$@" ;;
     media) shift; media_action "$@" ;;
+    airplane) shift; airplane_action "$@" ;;
     message)
         shift
         kind="${1:-}"
@@ -256,7 +279,7 @@ case "${1:-}" in
         show_message "$kind" "$*"
         ;;
     *)
-        printf 'Usage: panama-osd volume|microphone|brightness|media|message ACTION [value]\n' >&2
+        printf 'Usage: panama-osd volume|microphone|brightness|media|airplane|message ACTION [value]\n' >&2
         exit 2
         ;;
 esac