Skip to content

[scanner] docs: streaming-the-activity-monitor.md operator guide #15600

Closed

Description

@hivecommons-hive

Part of #15594 — blocked by #15598 (documents what the container, overlay and image ship).

Scope

Write src/docs/streaming-the-activity-monitor.md: an operator guide for streaming the dashboard Activity Monitor to Twitch unattended.

  • What the stream container does (Xvfb + Chromium kiosk + ffmpeg + authproxy) and how the token is kept off the URL, history, logs and screen.
  • Running it locally with docker compose from src/deploy/stream/.
  • Deploying to OKE with the hive-hosted overlay: the two Secrets the owner creates (Twitch stream key, dashboard token), kubectl apply -k, and how to check health.
  • ?kiosk=1 dashboard mode and what it hides.
  • Operating notes: reload interval, restart behaviour, resolution/bitrate tuning, rotating the stream key.

Link the page from the docs index the same way the other src/docs/*.md guides are linked.

Acceptance

  • Relative links resolve; git diff --check clean.
  • Docs-only: no changelog.d fragment needed unless the repo's guard asks for one.

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

Activity

  1. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 30, 2026
  2. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    Scanner triage: this child's scope is already implemented in open PR #15595 (src/deploy/stream/ Dockerfile + authproxy + entrypoint, k8s/ + overlays/hive-hosted/, .github/workflows/stream-image.yml, and src/docs/streaming-the-activity-monitor.md). Not dispatching a separate fix — it would collide file-for-file with #15595. If #15595 merges without a closing keyword for this issue, close it citing that PR.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

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

  3. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

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

  4. odttlnt commented on Oct 30, 2026

    @odttlnt
    Contributor

    Already covered on v5: merged PR #15595 (commit aa1b5af) added src/docs/streaming-the-activity-monitor.md (Twitch setup, Secrets, kubectl apply -k with the hive-hosted overlay, health check, ?kiosk=1, reload interval, bitrate/resolution tuning, key rotation, local docker compose) and linked it from src/docs/documentation-map.md. No further work to ship; a maintainer can close this issue citing #15595 (its body only had Fixes #15594).

    — hive: backend=bob model=premium

  5. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @odttlnt released (released on disconnect).

  6. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    Already done — closing (selfreport).

    src/docs/streaming-the-activity-monitor.md landed on v5 in #15595 (aa1b5af ✨ deploy: headless Twitch streamer for the Activity Monitor) and covers every item in this issue's scope:

    • container architecture (Xvfb + authproxy + Chromium --kiosk + ffmpeg) and the bearer token kept off the URL/logs (lines 13–18, "Privacy" section)
    • local docker compose up --build from src/deploy/stream/ ("Running the container from a laptop")
    • OKE hive-hosted overlay: the two Secrets (Twitch stream key, dashboard token), kubectl apply -k, health verification ("2. Create the Secrets", "3. Apply", "4. Verify")
    • ?kiosk=1 and what it hides ("Privacy")
    • operating notes: RELOAD_EVERY, restart/backoff behaviour, BITRATE/VIDEO_SIZE/X264_PRESET tuning, key rotation ("Troubleshooting", step 1)

    It is linked from src/docs/documentation-map.md:130 like the other guides. Nothing remains for this issue to track.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

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

  7. added
    hive/already-doneHive contributor found this issue already resolved; remove if work remains
    and removed
    stage/010-actionableTriaged; eligible for the hive to pick up
    on Oct 30, 2026
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.hive/already-doneHive contributor found this issue already resolved; remove if work remains

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions