Skip to content

[scanner] Add attended ?display=1 mode with a 📺 header button to the Activity Monitor #15925

Closed

Description

@hivecommons-hive

Part of #15860

Add an attended display mode for the Activity Monitor that is reachable from the UI and easy to leave. This is the "getting in and out" piece of Part A. It reuses the existing pop-out / full-screen shell from #15829 and leaves headless ?kiosk=1 alone.

Decision constraints that apply (from the maintainer's /hive decision on #15860)

  • Reuse the existing pop-out/full-screen shell.
  • Preserve existing headless ?kiosk=1 behaviour. What ?kiosk=1 renders for the streamer must not change.
  • Make no change to the ordinary Activity Monitor layout or flow when display mode is off. The only visible addition is one header button.
  • Full screen and wake lock are separate explicit user controls and are not requested automatically. Entering display mode must not call requestFullscreen or navigator.wakeLock. Those controls come in a follow-up child.
  • Add no new mutation privileges and no new credential. Use the existing authenticated viewer access.

Where

  • src/pkg/dashboard/static-src/js/boot.js: the first IIFE parses kiosk / popout into window.HIVE_KIOSK / HIVE_POPOUT and sets the body classes before first paint.
  • src/pkg/dashboard/static-src/js/sections.js: STAGE_TRACKER_HEADER_TOOLS_HTML holds the ⧉ / ⛶ buttons.
  • src/pkg/dashboard/static-src/js/tracker-popout.js: stageTrackerPopoutUrl(), stageTrackerDashboardUrl(), stageTrackerFullscreenHotkey() and the keydown listener.
  • src/pkg/dashboard/static-src/css/popout.css: the body.popout-mode / body.ham-fullscreen chrome-less rules, plus body.kiosk-mode .ham-header-tool { display:none }.
  • Regenerate src/pkg/dashboard/static/index.html with go generate ./src/pkg/dashboard/webstatic.

What

  • New URL flag ?display=1:
    • boot.js sets window.HIVE_DISPLAY and body.display-mode before first paint.
    • Kiosk wins if both kiosk=1 and display=1 are present.
    • Display mode lands on #section-activity-monitor-section, like pop-out does.
  • popout.css: add body.display-mode to the existing chrome-less selector lists. Do not add a new stylesheet. Display mode differs from kiosk in four ways:
    • it is attended, so the cursor is not hidden;
    • sound keeps the user's normal setting, with no kiosk sound default;
    • it never writes layout or theme to localStorage;
    • it hides the row ⋯ / context-menu and multi-select affordances, so a wall view offers no actions. This is presentation only; server authorization is unchanged.
  • A third header tool, 📺 Display, sits beside ⧉ and ⛶. It navigates to the current URL with display=1 added (via a pure stageTrackerDisplayUrl(href, on)), keeping any other query such as am.* (see the sibling URL-views child) and theme.
  • Exit: Esc (when not in browser full screen, which consumes Esc itself), or d while focus is in the tracker, navigates to the URL with display removed. d also enters display mode from the tracker. Mirror stageTrackerFullscreenHotkey() in a pure stageTrackerDisplayHotkey(ev, inTracker, typing).
  • body.kiosk-mode keeps hiding all .ham-header-tools, so the streamer never shows 📺.
  • Add a short "Display mode" paragraph to src/docs/streaming-the-activity-monitor.md, in the section created by the URL-views child or a new one.

Decision taken by hive: use a new display=1 flag instead of adding kiosk=1 as the RFC sketched. kiosk=1 hides the cursor and every header tool and forces sound on, which would make an attended display impossible to exit. Changing kiosk would also change what the headless streamer renders, which the decision forbids.

Acceptance

  • 📺 enters display mode; Esc or d leaves it. Neither path requests full screen or a wake lock.
  • With no display param, the Activity Monitor DOM and CSS behave as today apart from the added 📺 button. TestKioskModeWiring, TestKioskSoundDefault and stage_tracker_popout.test.js still pass.
  • In ?kiosk=1, 📺 is hidden and kiosk output is unchanged.
  • changelog.d/added-activity-monitor-display-mode.md fragment.

Tests

  • Extend src/pkg/dashboard/stage_tracker_popout.test.js, or add stage_tracker_display.test.js next to it, for stageTrackerDisplayUrl and stageTrackerDisplayHotkey.
  • Add a Go wiring assertion to src/pkg/dashboard/kiosk_mode_test.go (TestDisplayModeWiring) that boot.js sets display-mode and that kiosk still wins.
  • CI runs the tests; do not run them locally (see AGENTS.md).

— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

Activity

  1. added
    kind/featureCategorizes issue or PR as related to a new feature.
    agent/scannerCreated or modified by the scanner agent
    on Oct 31, 2026
  2. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 31, 2026
  3. clubanderson commented on Oct 31, 2026

    @clubanderson
    Member

    @hanthor Tracking implementation of your RFC #15860 here. Implementer requirement: mention @hanthor in the associated PR description, link this issue and RFC #15860, and post a completion comment mentioning @hanthor after the PR actually merges, with the merge link and a clear distinction between source shipped and deployment/activation. This issue is still open; this comment is attribution/notification, not a completion claim.

  4. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  5. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    Fixed by #15948 (merged ceafe3f). Closing. Reply /reopen if the problem persists.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/scannerCreated or modified by the scanner agenthelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.kind/featureCategorizes issue or PR as related to a new feature.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions