diff --git a/src/docs/api-reference/dashboard-misc.md b/src/docs/api-reference/dashboard-misc.md index f19178f89f..699a775aa4 100644 --- a/src/docs/api-reference/dashboard-misc.md +++ b/src/docs/api-reference/dashboard-misc.md @@ -139,10 +139,5 @@ Code buffers are bounded and memory-only, so this is not an audit history. Clear retained browser code on epoch changes and failed/disabled/unauthorized pulls. An empty response says nothing about work outside the admitted source. -The internal `/api/matrix/lines` and `dashboard.matrix.*` names are deprecated -but remain supported for compatibility. The sole code display is now **Code activity** -at `?kiosk=1&view=reader`; `?kiosk=1&view=matrix` is a deprecated alias that -opens the same reader. The Matrix renderers and their `mx.*` settings are -retired. Activation remains explicitly opt-in and default-off; -only pushed, published PR checkpoints are admitted, never workspace or pre-push -content. The cutover grants no anonymous access or broadcast authorization. +This endpoint supplies the [Code activity reader](../dashboard.md#code-activity-reader); +see that section for presentation, compatibility, capture and access policies. diff --git a/src/docs/operator-reference/README.md b/src/docs/operator-reference/README.md index 23a9811ad5..2757cd42a3 100644 --- a/src/docs/operator-reference/README.md +++ b/src/docs/operator-reference/README.md @@ -284,7 +284,7 @@ Go callers keep reading `cfg.Agents`, `cfg.Governor.Gateways` and so on through | `dashboard.public_url` | Empty means OAuth redirect URIs (Linear agent install, OpenRouter funding) fall back to `hub.dashboard_url`, then the request's forwarded/`Host` origin. | Set to this dashboard's externally reachable origin (`https://hive.example.com`, no path/query) on a standalone hive whose callback is published on a different hostname or whose ingress rewrites `Host`. Must be an absolute `http(s)://` origin; a trailing slash is trimmed and anything else fails config load. See [linear-agent.md](../linear-agent.md#setup). | | `dashboard.experiment_lab` | Off by default. | Hides the Experiment Lab (formerly Strategy Lab) while that surface is being reworked. Set `dashboard.experiment_lab: true` to show the Experiment Lab section, sidebar nav entry, and Nous status controls. | | `dashboard.strategy_lab` | Off by default. **Deprecated** alias of `dashboard.experiment_lab`, kept for one release (#11695). | `true` still enables the Experiment Lab and logs a one-line deprecation at config load; the value is folded into `dashboard.experiment_lab` so the next config save writes the documented key. | -| `dashboard.matrix` | Off by default (`enabled: false`, `repos: []`, `exclude_paths: []`). **Experimental.** | Opt-in Code activity source. The `dashboard.matrix.*` names are deprecated but retained for compatibility; the Code activity entry opens `?kiosk=1&view=reader` in a new tab. No automatic enablement or workspace capture. When active, pushed lines from allow-listed repos are served to authenticated read-role viewers via `GET /api/matrix/lines?since=&max=` (bounded backlog, `Cache-Control: no-store`; `404` when inactive) and `/api/events` emits a content-free `code-lines` nudge (`{"seq":N}`, ≤1/s) telling browsers to pull. `repos` is an explicit exact `owner/name` allowlist (no wildcards, URLs or bare names) and an empty list captures nothing, so `enabled: true` alone stays inactive. `exclude_paths` adds non-empty path globs to the built-in deny-list. There is no `authors` or `private_repos` key: authors are fixed and private repos are always excluded. | +| `dashboard.matrix` | Off by default (`enabled: false`, `repos: []`, `exclude_paths: []`). **Experimental.** | Code activity source; see [Code activity reader](../dashboard.md#code-activity-reader) for presentation, compatibility, capture and access policies. When active, pushed lines from allow-listed repos are served to authenticated read-role viewers via `GET /api/matrix/lines?since=&max=` (bounded backlog, `Cache-Control: no-store`; `404` when inactive) and `/api/events` emits a content-free `code-lines` nudge (`{"seq":N}`, ≤1/s) telling browsers to pull. `repos` is an explicit exact `owner/name` allowlist (no wildcards, URLs or bare names) and an empty list captures nothing, so `enabled: true` alone stays inactive. `exclude_paths` adds non-empty path globs to the built-in deny-list. There is no `authors` or `private_repos` key: authors are fixed and private repos are always excluded. | | `hub.contribute_announcement` | Empty/off by default. | Operator notice for contributors. Set from Governor → Hub or `/contribute` Management (owner/read-write): `text` is server-sanitised plain text capped at 500 characters and rendered only through text-safe sinks (empty clears), `level` is `info`/`warning`, `expires_at` is optional RFC3339, and the server rotates `id` whenever text changes so dismissed Operations/Profile banners reappear. Active notices show on `/contribute` Operations/Profile, above the Onboarding command block, and in connected relay terminals. | | `hub.contribute_repo_filters` | Empty map means repos inherit the hive-wide contributor title, author, and label filters exactly as before. | Optional full `owner/repo` keys that narrow one repository's `/contribute` queue without widening the hive. Hive-wide skip labels and hive-wide filters always run first; a repo filter can only add deny matches or require an allow-mode title/author/label match for that repo. Edit from `/contribute` → Management → Repos for Contribute → Filters or Governor → Hub. Operations lists configured overrides and withheld diagnostics name repo matches, e.g. `Repo filter label "2-discussing" denied for projectbluefin/common`. | | `hub.contribute_wall_enabled` | Off by default. | Opts the hive into the public contributor wall on `/contribute` Operations. The Management tab and Governor Hub settings mirror this switch. When off, the panel is hidden and write endpoints refuse posts. | diff --git a/src/docs/streaming-the-activity-monitor.md b/src/docs/streaming-the-activity-monitor.md index f7f737d2ff..c7dd5a8cde 100644 --- a/src/docs/streaming-the-activity-monitor.md +++ b/src/docs/streaming-the-activity-monitor.md @@ -296,21 +296,10 @@ full-screen Activity Monitor. ## Code activity (separate channel) -The Activity Monitor topbar shows one **Code activity** entry when -`dashboard.matrix.enabled` is set. It opens the [reader](dashboard.md#code-activity-reader) -at `?kiosk=1&view=reader` in a new tab. Code activity supersedes the Matrix -code view: rain, cascade, ghost, terminal and all `mx.*` presentation settings -are retired. Saved `?kiosk=1&view=matrix` display URLs are a deprecated alias -that opens the same reader; new links should use `view=reader`. - -The source remains default-off and limited to pushed published PR checkpoints -from positively identified Hive/clanker authors in explicitly allowlisted public -repositories. Complete admitted add/remove regions are shown with `Pushed PR` -provenance and observed time; opening backlog is labelled a buffered snapshot. -There is no workspace or pre-push capture. The internal `dashboard.matrix.*` -configuration and `/api/matrix/lines` names are deprecated but remain supported. -Existing read authorization, path exclusions and whole-region scrub/drop filters -still apply. Dashboard authentication alone does not authorize broadcasting. +The separate Code activity channel uses the +[Code activity reader](dashboard.md#code-activity-reader); see that section for +its display, source restrictions, compatibility and access policy. +Dashboard authentication alone does not authorize broadcasting. [`overlays/hive-hosted-matrix/`](../deploy/stream/overlays/hive-hosted-matrix/kustomization.yaml) reuses the streamer image and base as a separate instance. It renders Deployment,