diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index a8afa99dd5..74c8817679 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -9,6 +9,9 @@ contact_links: - name: Join our Discord url: https://hivecommons.dev/discord about: Ask setup, contributor, and community questions in the Hive Commons Discord. + - name: Watch the hive live on Twitch + url: https://www.twitch.tv/hivecommons + about: Live stream of the hosted hive's Activity Monitor — see issues and PRs move through the pipeline in real time. - name: Propose a project to join Hive Commons url: https://github.com/hivecommons/.github/issues/new?template=join-hive-commons.yml about: Project proposals for the Hive Commons family are handled in the hivecommons/.github repository. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index fda1207856..395c2ebdfe 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,7 +2,7 @@ Thank you for helping improve Hive. This guide is for contributing code and documentation to this repository. If you want to donate compute to a running hive, see [Contribute to a Hive](src/docs/what-is-hive.md#contribute-to-a-hive) instead. -**New here?** Start with the [getting-started guide for first-time contributors](docs/getting-started-contributing.md) — it walks the end-to-end journey (finding an issue, local setup, testing without a cluster, key concepts, and what the review/CI process looks like) and links back into this guide for the mechanics. For live community help, [Join our Discord](https://hivecommons.dev/discord). +**New here?** Start with the [getting-started guide for first-time contributors](docs/getting-started-contributing.md) — it walks the end-to-end journey (finding an issue, local setup, testing without a cluster, key concepts, and what the review/CI process looks like) and links back into this guide for the mechanics. For live community help, [Join our Discord](https://hivecommons.dev/discord). To see a hive at work, [watch the hive live on Twitch](https://www.twitch.tv/hivecommons). ## Where to work diff --git a/README.md b/README.md index 8f4a3f6fe6..e531e43189 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,10 @@ Community

+

+ Watch the hive live on Twitch +

+ --- Hive helps people and AI agents work together across their projects. @@ -134,7 +138,7 @@ Use official images from `ghcr.io/hivecommons/hive`. ## Community -[First contribution](docs/getting-started-contributing.md) · [Contributing](CONTRIBUTING.md) · [Contribute compute](src/docs/contributor-relay.md) · [Discord](https://hivecommons.dev/discord) · [Discussions](https://github.com/orgs/hivecommons/discussions). +[First contribution](docs/getting-started-contributing.md) · [Contributing](CONTRIBUTING.md) · [Contribute compute](src/docs/contributor-relay.md) · [Discord](https://hivecommons.dev/discord) · [Live stream (Twitch)](https://www.twitch.tv/hivecommons) · [Discussions](https://github.com/orgs/hivecommons/discussions). [Code of Conduct](CODE_OF_CONDUCT.md) · [Project governance](GOVERNANCE.md) · [Report a vulnerability](SECURITY.md) · [Telemetry](src/docs/telemetry.md). diff --git a/changelog.d/added-twitch-community-links.md b/changelog.d/added-twitch-community-links.md new file mode 100644 index 0000000000..b734e9c555 --- /dev/null +++ b/changelog.d/added-twitch-community-links.md @@ -0,0 +1 @@ +- Twitch live stream (https://www.twitch.tv/hivecommons) listed in every community-link cluster: README badge and Community section, CONTRIBUTING, community/getting-started docs, issue-template contact links, dashboard sidebar Help / FAQ / Getting Started modal, the `/contribute` portal and default `contribute.help_links`, and hub landing/status page navs and footers. (#15635, #15637) diff --git a/docs/getting-started-contributing.md b/docs/getting-started-contributing.md index 8adfdca749..91453f4b79 100644 --- a/docs/getting-started-contributing.md +++ b/docs/getting-started-contributing.md @@ -16,6 +16,7 @@ build/test commands, see [`docs/development.md`](development.md). - Comment on the issue before starting anything non-trivial so work isn't duplicated. - Need a quick human answer? [Join our Discord](https://hivecommons.dev/discord). +- Curious what a running hive looks like? [Watch the hive live on Twitch](https://www.twitch.tv/hivecommons). ## 2. Set up a local environment diff --git a/src/README.md b/src/README.md index d8c88ee31d..5deabe53b7 100644 --- a/src/README.md +++ b/src/README.md @@ -220,7 +220,8 @@ contributors to act as selected spoke roles with `HIVE_AGENT_ROLE` / See [docs/contributor-relay.md](docs/contributor-relay.md), [docs/contributor-trust-and-roles.md](docs/contributor-trust-and-roles.md), and -[Join our Discord](https://hivecommons.dev/discord) for newcomer questions. +[Join our Discord](https://hivecommons.dev/discord) for newcomer questions, or +[watch the hive live on Twitch](https://www.twitch.tv/hivecommons). ## Governor diff --git a/src/docs/community.md b/src/docs/community.md index ffa6956e8b..f5a22e1132 100644 --- a/src/docs/community.md +++ b/src/docs/community.md @@ -6,8 +6,13 @@ Hive Commons is the open community around Hive, ClankeR contributor relay, and t For setup help, contributor relay questions, first-run guidance, and community discussion, [Join our Discord](https://hivecommons.dev/discord). The redirect points to the permanent Hive Commons invite and lets us rotate the underlying invite in one place if that ever changes. +## Watch the hive live on Twitch + +Hive's own hosted hive streams its Activity Monitor 24/7 at [twitch.tv/hivecommons](https://www.twitch.tv/hivecommons) — every tracked issue and PR walking from open to merged. See [Streaming the Activity Monitor](streaming-the-activity-monitor.md) for how the stream is run. + ## Other community entry points +- [Live stream (Twitch)](https://www.twitch.tv/hivecommons) - [Hive Commons website](https://hivecommons.dev) - [Hosted Hive Hub](https://hive.hivecommons.dev) - [Contributor portal](https://hive.hivecommons.dev/contribute) diff --git a/src/docs/getting-started.md b/src/docs/getting-started.md index 2714a1a03e..34d57b5263 100644 --- a/src/docs/getting-started.md +++ b/src/docs/getting-started.md @@ -90,7 +90,7 @@ For the following weeks, review findings and improve tests before considering mo ## Community help -If you get stuck, [Join our Discord](https://hivecommons.dev/discord). The invite is permanent, and the Hive Commons community can help with setup, first-run questions, contributor relay, and choosing a safe next ACMM step. +If you get stuck, [Join our Discord](https://hivecommons.dev/discord). The invite is permanent, and the Hive Commons community can help with setup, first-run questions, contributor relay, and choosing a safe next ACMM step. To see what a running hive looks like, [watch the hive live on Twitch](https://www.twitch.tv/hivecommons). ## Common gotchas (so you don't panic) diff --git a/src/docs/operator-reference.md b/src/docs/operator-reference.md index 23a5e1d0c8..9fcdc30341 100644 --- a/src/docs/operator-reference.md +++ b/src/docs/operator-reference.md @@ -186,7 +186,7 @@ Top-level YAML keys accepted by `config.Config`: | `issues.hard_suppress_reconcile_interval` | `30m`. | Minimum time between hard-suppress reconcile passes. | | `issues.rfc_existing_check.enabled` | `false`. | Triage existing-coverage check (#13575): new open issues labelled `rfc`, `enhancement` or `kind/feature` get one comment that lists the existing settings that may already cover the request. Each setting links to Settings with the search set to its key. The comment carries `` and is never posted twice. The check never labels or closes issues. Tuning keys are `post_when_nothing_found`, `labels`, `max_matches` and `max_age`; see [Triage: does this RFC already exist?](settings.md#triage-does-this-rfc-already-exist). | | `runs.triage.prior_art.enabled` | `true`. | Prior-art gate (#13575): before any agent claims a feature / RFC / epic issue, the scheduler searches knowledge beads, the Settings index, merged PRs (12 months), closed issues, docs and code for the issue's key terms. A human-filed issue whose best finding reaches `runs.triage.prior_art.threshold` (default `70`) is parked at `stage/017-possible-existing` with one `` comment quoting up to `max_findings` (default `5`) findings and the two replies (`/hive decision proceed — ` / `/hive decision exists`); a clanker-filed one is parked the same way and closed `already-exists` after `bot_close_ttl` (default `72h`) with no reply; a hive-filed one is never parked (findings note only). `kinds` (default `feature, rfc, epic, enhancement`) picks the gated kinds; `max_parks_per_cycle` (default `5`) bounds one cycle. See [Prior-art gate](spektacular.md#prior-art-gate). | -| `contribute.help_links` | Defaults to Hive contributor docs and the Hive issue tracker. | Up to 5 `{label, url}` links shown on `/contribute` Onboarding, Operations, and printed once by relays on connect. URLs must be absolute `http://` or `https://`; labels are plain text and length-capped. Prefer the Hive Commons Discord redirect (`https://hivecommons.dev/discord`) over channel URLs for contributors who may not already be server members. | +| `contribute.help_links` | Defaults to Hive contributor docs, the Hive issue tracker, and the Twitch live stream. | Up to 5 `{label, url}` links shown on `/contribute` Onboarding, Operations, and printed once by relays on connect. URLs must be absolute `http://` or `https://`; labels are plain text and length-capped. Prefer the Hive Commons Discord redirect (`https://hivecommons.dev/discord`) over channel URLs for contributors who may not already be server members. | | `contribute.max_parallel_fixes` | `2`. | Ceiling on how many stage-072 `fix-pr` sub-sessions one contributor's relay may run beside its primary session ([#12436](https://github.com/hivecommons/hive/issues/12436)). The relay advertises its own count (`max_parallel_fixes`, from `HIVE_MAX_PARALLEL_FIXES`); the hub clamps it to this. A relay that advertises no `parallel_sessions` always has capacity 1 (preempt mode). Fixes beyond capacity queue server-side and are served before new work. Settings → Hub → Fix budget. | | `contribute.min_focus_window` | `30m`. | Preempt mode only: after a preempted primary task resumes, the hub does not preempt that contributor again until it has run uninterrupted for this long. Settings → Hub → Fix budget. | | `variables` | Trusted variable resolver definitions. | Env-only substitution works without this block. | diff --git a/src/docs/security-self-assessment.md b/src/docs/security-self-assessment.md index d2769f8963..f8019216b0 100644 --- a/src/docs/security-self-assessment.md +++ b/src/docs/security-self-assessment.md @@ -146,7 +146,7 @@ Hive holds no formal certification (SOC 2, ISO 27001, FIPS). It holds the [OpenS ### Communication channels -* **Internal.** GitHub issues and pull requests on `hivecommons/hive`. Decisions are made in those public threads. Day-to-day discussion happens on the project [Discord](https://hivecommons.dev/discord) and the [hivecommons-dev Google Group](https://groups.google.com/g/hivecommons-dev), which also announces the community meeting. +* **Internal.** GitHub issues and pull requests on `hivecommons/hive`. Decisions are made in those public threads. Day-to-day discussion happens on the project [Discord](https://hivecommons.dev/discord) and the [hivecommons-dev Google Group](https://groups.google.com/g/hivecommons-dev), which also announces the community meeting. The hosted hive's Activity Monitor is also streamed publicly on [Twitch](https://www.twitch.tv/hivecommons). * **Inbound.** Public GitHub issues; private vulnerability reports through GitHub's "Report a vulnerability" form. * **Outbound.** GitHub releases and `CHANGELOG.md`. diff --git a/src/docs/streaming-the-activity-monitor.md b/src/docs/streaming-the-activity-monitor.md index 6dc84828ad..c59c775c9d 100644 --- a/src/docs/streaming-the-activity-monitor.md +++ b/src/docs/streaming-the-activity-monitor.md @@ -4,7 +4,8 @@ An unattended, 24/7 Twitch stream of the hive dashboard's **Activity Monitor** (the stage tracker: every tracked issue and PR walking Open → Actionable → Claimed → PR in progress → CI / Review → Merge queue). The first stream is hive's own hosted spoke on `hive-oke`, channel -[`twitch.tv/hivecommons`](https://www.twitch.tv/hivecommons). +[`twitch.tv/hivecommons`](https://www.twitch.tv/hivecommons). The stream is +listed alongside the other community links in [Community and support](community.md). Everything lives in [`src/deploy/stream/`](../deploy/stream/README.md): a container that renders the dashboard in a virtual display and pushes it to diff --git a/src/pkg/config/contribute_help_links.go b/src/pkg/config/contribute_help_links.go index f13057ad08..f9d4b30edb 100644 --- a/src/pkg/config/contribute_help_links.go +++ b/src/pkg/config/contribute_help_links.go @@ -15,6 +15,7 @@ const ( var DefaultContributeHelpLinks = []ContributeHelpLink{ {Label: "Contributor docs", URL: "https://github.com/hivecommons/hive/blob/v5/src/docs/contributor-relay.md"}, {Label: "Open a Hive issue", URL: "https://github.com/hivecommons/hive/issues"}, + {Label: "Watch the hive live on Twitch", URL: "https://www.twitch.tv/hivecommons"}, } func NormalizeContributeHelpLinks(in []ContributeHelpLink) ([]ContributeHelpLink, error) { diff --git a/src/pkg/config/contribute_help_links_test.go b/src/pkg/config/contribute_help_links_test.go index cde3849d8c..264ebbcf63 100644 --- a/src/pkg/config/contribute_help_links_test.go +++ b/src/pkg/config/contribute_help_links_test.go @@ -37,4 +37,13 @@ func TestContributeHelpLinksDefault(t *testing.T) { if !strings.Contains(links[0].URL, "src/docs/contributor-relay.md") { t.Fatalf("default docs link = %#v", links[0]) } + found := false + for _, l := range links { + if l.URL == "https://www.twitch.tv/hivecommons" && strings.Contains(l.Label, "Twitch") { + found = true + } + } + if !found { + t.Fatalf("default links = %#v, want Twitch live stream link", links) + } } diff --git a/src/pkg/dashboard/contribute_landing.go b/src/pkg/dashboard/contribute_landing.go index 2a5887570d..e810c5f254 100644 --- a/src/pkg/dashboard/contribute_landing.go +++ b/src/pkg/dashboard/contribute_landing.go @@ -1579,7 +1579,7 @@ select.admin-act{min-width:0;max-width:100%%}

Donate your CLI + API tokens to help this project's AI agent swarm.

Powered by ClankeR, the contributor relay — it hands tasks from this hive's backlog to the agent running on your machine. Your compute, their backlog. Bring your own inference — how you want to contribute is up to you.

-

Questions? Join our Discord and we'll help you get to your first PR.

+

Questions? Join our Discord and we'll help you get to your first PR. Or watch the hive live on Twitch.

%d
Total
%s diff --git a/src/pkg/dashboard/contribute_sse_gap_test.go b/src/pkg/dashboard/contribute_sse_gap_test.go index a24b9dfb9f..881deef3f3 100644 --- a/src/pkg/dashboard/contribute_sse_gap_test.go +++ b/src/pkg/dashboard/contribute_sse_gap_test.go @@ -408,7 +408,7 @@ func TestSSEHealthyStreamCarriesSeqAndNoGap(t *testing.T) { waitFor(t, func() bool { return hub.sse.count() == 1 }, "subscriber to register") hub.addActivity("live", "picked up", "contributor", "claude", "sonnet", "", "acme/repo#7") - waitFor(t, func() bool { return strings.Contains(rec.BodyString(), "live") }, "the live event to stream") + waitFor(t, func() bool { return strings.Contains(rec.BodyString(), `"username":"live"`) }, "the live event to stream") frames := sseFrames(t, rec.BodyString()) if len(frames) < 2 { diff --git a/src/pkg/dashboard/static-src/html/faq.html b/src/pkg/dashboard/static-src/html/faq.html index 10ba03a980..675267a0a0 100644 --- a/src/pkg/dashboard/static-src/html/faq.html +++ b/src/pkg/dashboard/static-src/html/faq.html @@ -6,7 +6,7 @@