From b158bafa49e66fc15ea58e1b4a4eb822952fd9e3 Mon Sep 17 00:00:00 2001 From: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com> Date: Sat, 31 Oct 2026 07:56:35 -0400 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=96=20docs:=20state=20Matrix=20display?= =?UTF-8?q?=20as=20an=20activation=20precondition?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rebased onto v5: the close-read decision enum is already documented there by #16012, so that hunk is dropped. The Matrix section no longer claims the renderer is pending (#16020 may land without a docs change); instead it states the renderer as a dependency and adds an activation-checklist step to confirm the deployed build serves view=matrix before scale-up, as issue #16003 asks. Fixes #16003 Hive-Fix-Attempt: 1/6 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com> --- src/docs/streaming-the-activity-monitor.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/src/docs/streaming-the-activity-monitor.md b/src/docs/streaming-the-activity-monitor.md index e3b1667b91..32a4f02d12 100644 --- a/src/docs/streaming-the-activity-monitor.md +++ b/src/docs/streaming-the-activity-monitor.md @@ -191,8 +191,12 @@ full-screen Activity Monitor. Matrix is an experimental, default-off code display for a separate channel, [`twitch.tv/hivecommonsmatrix`](https://www.twitch.tv/hivecommonsmatrix). -It shows pushed added lines only, from positively identified hive identities, -on public repositories explicitly allowlisted in `dashboard.matrix.repos`. +It depends on the Matrix display renderer (`/?kiosk=1&view=matrix`, +[#15936](https://github.com/hivecommons/hive/issues/15936)); without that +renderer the dashboard ignores `view=matrix` and the kiosk serves the ordinary +Activity Monitor. When active it shows pushed added lines only, from positively +identified hive identities, on public repositories explicitly allowlisted in +`dashboard.matrix.repos`. Private patches, unverified authors and excluded paths are never shown. Lines touched by scrubbing are dropped entirely rather than displayed with redactions; the built-in secret/path filters and `dashboard.matrix.exclude_paths` apply. @@ -213,16 +217,19 @@ unaffected. channel.** The overlay has `replicas: 0`; applying it starts no streamer. Channel availability alone does not authorize activation. The owner must: -1. Enable `dashboard.matrix` with an explicit, reviewed public repo allowlist +1. Confirm the deployed dashboard build serves the Matrix display for + `view=matrix` (#15936). A build without it broadcasts the ordinary kiosk + Activity Monitor on the Matrix channel, not code lines. +2. Enable `dashboard.matrix` with an explicit, reviewed public repo allowlist and verify the Matrix display and its author restriction and scrub/drop rules before any broadcast. An empty allowlist captures nothing. -2. Provision `hivecommonsmatrix` independently, create namespace +3. Provision `hivecommonsmatrix` independently, create namespace `hive-stream-matrix`, and create the out-of-band `twitch-stream-matrix` Secret there with its `TWITCH_STREAM_KEY`. Provision a separate `dashboard-token` Secret there for the dashboard source. Never reuse the main channel's `twitch-stream` Secret, or put key values in source, issues or documentation. -3. Apply the Matrix overlay and deliberately scale `matrix-hive-stream` above +4. Apply the Matrix overlay and deliberately scale `matrix-hive-stream` above zero only after authorization and readiness checks. Applying the overlay, creating the Twitch Secret and scaling up are all owner-only actions; this configuration does not authorize deployment or activation.