Skip to content

[scanner] Rotate Activity Monitor display mode between URL-defined views #15932

Closed

Description

@hivecommons-hive

Part of #15860

Rotate a display-mode screen between URL-described tracker views (Part B, "Playlists"), for example needs a human → PRs in repo X → issues by repo.

Depends on #15924 (the am.* URL views) and #15925 (the ?display=1 shell).

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

Where

What

  • Grammar: ?display=1&am.view=<view>&am.view=<view>…&interval=60s.
    • Each am.view value is a URL-encoded am.* query string, for example am.view=am.kind%3Dpr%26am.repo%3Dhivecommons%2Fhive.
    • interval accepts Ns or Nm, clamps to 10 s–1 h and defaults to 60 s.
    • Fewer than two valid views means no rotation.
  • Add pure helpers between // tracker display playlist helpers begin/end markers:
    • stageTrackerParsePlaylist(href) returns { views: [filter…], intervalMs };
    • stageTrackerPlaylistIndex(startMs, nowMs, intervalMs, n).
  • Rotation swaps _stageTrackerFilter in memory and calls renderStageTracker(). It never writes localStorage and never navigates, so it survives an SSE reconnect and needs no refetch.
  • The index derives from wall-clock time, so a reload resumes the right view.
  • A thin progress bar shows the time left before the next view. Under prefers-reduced-motion it becomes a static "next in Ns" label.
  • Document the playlist grammar in the display-mode section of src/docs/streaming-the-activity-monitor.md.

Decision taken by hive: use repeated am.view params, each a self-contained am.* query string. This avoids inventing preset names, which the decision deferred, and reuses #15924's parser unchanged.

Acceptance

  • A two-view playlist alternates at the given interval and keeps alternating across an SSE drop and reconnect.
  • Invalid views are skipped.
  • Without am.view, nothing changes.
  • changelog.d/added-activity-monitor-display-playlist.md fragment.

Tests

  • New src/pkg/dashboard/stage_tracker_display_playlist.test.js (node:test), lifting the helpers by marker. Cover parsing, interval clamping, skipping invalid views, index math across a simulated reconnect, and the fewer-than-two-views no-op.
  • 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. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    Consolidated finding. This was filed as a separate issue; it references exactly the same files as this one (AGENTS.md, changelog.d/added-activity-monitor-display-playlist.md, hive.yaml, src/docs/streaming-the-activity-monitor.md, src/pkg/dashboard/stage_tracker_display_playlist.test.js, src/pkg/dashboard/static-src/css/popout.css, src/pkg/dashboard/static-src/js/tracker-filter-render.js, src/pkg/dashboard/static-src/js/tracker-filter-state.js, src/pkg/dashboard/static-src/js/tracker-popout.js, src/pkg/dashboard/static/index.html), so it was folded in here instead. Address it in the same PR as this issue — two PRs editing the same files would conflict.

    [scanner] Trigger single-item RFC notify sweep from issues/pull_request webhooks

    Part of #15860

    Rotate a display-mode screen between URL-described tracker views (Part B, "Playlists"), for example needs a human → PRs in repo X → issues by repo.

    Depends on #15924 (the am.* URL views) and #15925 (the ?display=1 shell).

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

    Where

    What

    • Grammar: ?display=1&am.view=<view>&am.view=<view>…&interval=60s.
      • Each am.view value is a URL-encoded am.* query string, for example am.view=am.kind%3Dpr%26am.repo%3Dhivecommons%2Fhive.
      • interval accepts Ns or Nm, clamps to 10 s–1 h and defaults to 60 s.
      • Fewer than two valid views means no rotation.
    • Add pure helpers between // tracker display playlist helpers begin/end markers:
      • stageTrackerParsePlaylist(href) returns { views: [filter…], intervalMs };
      • stageTrackerPlaylistIndex(startMs, nowMs, intervalMs, n).
    • Rotation swaps _stageTrackerFilter in memory and calls renderStageTracker(). It never writes localStorage and never navigates, so it survives an SSE reconnect and needs no refetch.
    • The index derives from wall-clock time, so a reload resumes the right view.
    • A thin progress bar shows the time left before the next view. Under prefers-reduced-motion it becomes a static "next in Ns" label.
    • Document the playlist grammar in the display-mode section of src/docs/streaming-the-activity-monitor.md.

    Decision taken by hive: use repeated am.view params, each a self-contained am.* query string. This avoids inventing preset names, which the decision deferred, and reuses #15924's parser unchanged.

    Acceptance

    • A two-view playlist alternates at the given interval and keeps alternating across an SSE drop and reconnect.
    • Invalid views are skipped.
    • Without am.view, nothing changes.
    • changelog.d/added-activity-monitor-display-playlist.md fragment.

    Tests

    • New src/pkg/dashboard/stage_tracker_display_playlist.test.js (node:test), lifting the helpers by marker. Cover parsing, interval clamping, skipping invalid views, index math across a simulated reconnect, and the fewer-than-two-views no-op.
    • 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

  4. 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.

  5. 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.

  6. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    Fixed by #15969 (merged 66cb92b). 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