feat: /ps:logs page scrolling and minimal footer hints with ? keybinds overlay

[378-kaiabot]

Note

Automated pull request by Pi, model aperture/glm-5.2. Implemented and validated empirically against
aliou/pi-processes on branch fix/log-viewer-dead-scroll (stack top feat/logs-paging-and-hints). See the local run log for the full investigation.

Summary

Two related changes to the /ps:logs overlay and /ps overview footers:

1. Page scrolling (/ps:logs overlay has no page up/down (or half-page) keybindings #77) — the logs overlay handled line scrolling (j/k, arrows) and jump-to-top/bottom (g/G) but PageUp/PageDown and ctrl+u/ctrl+d were no-ops. Confirmed empirically before the fix by running the issue's repro test against LogOverlayComponent: PAGE_DOWN never cleared following and PAGE_UP left L50/50 unchanged. Now pgup/pgdn scroll a full viewport (logRows()) and ctrl+u/ctrl+d half a viewport, reusing the same anchor write-back as line scrolling so the Dead scroll zone in /ps:logs after jumping to the top — j/k do nothing for ~a screenful #76 dead-zone fix covers them.

2. Minimal footer hints + ? keybinds overlay — the footers were getting crowded. Hints whose key letter occurs in their word now render as just the word with the key letter in accent + bold:

Before	After
w wrap	wrap (bold accent w)
f follow	follow
c clear / s sort / x kill	clear / sort / kill
q close, j/k scroll, / search	unchanged (key not in word)

When the list does not fit the footer width, a leading ? more affordance appears; pressing ? opens a stacked overlay on top of the overlay (herdr-style keybinds panel: grouped sections, aligned key/description columns, inverse esc close pill). In /ps:logs search mode the panel prepends a search group (n / N, /, esc) since those keys only exist there.

Changes

• extensions/processes-logs/components/log-overlay-component.ts — page/half-page scroll handling (Key.pageUp/pageDown, Key.ctrl("u"/"d")); footer renders via renderShortcutHints; ? opens the stacked keybinds panel; panel disposer invoked from dispose() so a background close (auto-hide, kill) cannot leak it.
• extensions/processes/components/overview-component.ts — same footer/? treatment for the /ps overview; added the previously-undocumented g/G preview jump to both the footer and the panel.
• extensions/shared/shortcut-hints.ts — hint rendering (minimal key-in-word form with per-segment state styling for wrap/stdout+stderr, classic form otherwise) and the ? more collapse that keeps the hints that still fit.
• extensions/shared/shortcuts-overlay.ts — the keybinds panel component and showShortcutsOverlay (pushes onto tui.showOverlay, centered, width computed from the longest aligned row, clamped 36–72; idempotent disposer).
• .agents/skills/pi-processes-testing/SKILL.md — manual QA checklist updated with the new keys, the minimal-hint display, and the ? panel.
• .changeset/logs-paging-and-hints.md — minor bump.

Live QA (herdr)

Driven from a herdr tab running pi -ne -e . in this repo; the agent started a ticker process via the process tool (1 line/s, later 0.1 s/s). Runtime-verified: PageUp moves off following to 60% L78/131; the footer collapses to ? more … on narrow widths; ? stacks the keybinds panel over both the logs overlay and /ps; q/esc dismiss it.

Verification

• pnpm typecheck ✅
• pnpm lint ✅ (biome, 200 files)
• pnpm test ✅ 638 passed (61 files; +33 tests: page/half-page scrolling incl. clamping, minimal-hint rendering incl. per-segment styling, ? more collapse bounds, panel layout/alignment/dismiss keys, disposer lifecycle in both hosts)

Closes #77

Stacked on #95 — merge that first.

---

Run host: golden-hugo-lefevre · Session: 01a010a1-f8de-7eef-8459-680c1ac2cd9a · Model: aperture/glm-5.2