Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,10 @@
<a href="#community">Community</a>
</p>

<p align="center">
<a href="https://www.twitch.tv/hivecommons"><img src="https://img.shields.io/twitch/status/hivecommons?style=flat&logo=twitch&label=live" alt="Watch the hive live on Twitch"></a>
</p>

---

Hive helps people and AI agents work together across their projects.
Expand Down Expand Up @@ -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).

Expand Down
1 change: 1 addition & 0 deletions changelog.d/added-twitch-community-links.md
Original file line number Diff line number Diff line change
@@ -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)
1 change: 1 addition & 0 deletions docs/getting-started-contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
3 changes: 2 additions & 1 deletion src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
5 changes: 5 additions & 0 deletions src/docs/community.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion src/docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
2 changes: 1 addition & 1 deletion src/docs/operator-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<!-- hive:rfc-existing-coverage -->` 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 `<!-- hive:prior-art-gate -->` comment quoting up to `max_findings` (default `5`) findings and the two replies (`/hive decision proceed β€” <gap>` / `/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. |
Expand Down
2 changes: 1 addition & 1 deletion src/docs/security-self-assessment.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

Expand Down
3 changes: 2 additions & 1 deletion src/docs/streaming-the-activity-monitor.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions src/pkg/config/contribute_help_links.go
Original file line number Diff line number Diff line change
Expand Up @@ -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) {
Expand Down
9 changes: 9 additions & 0 deletions src/pkg/config/contribute_help_links_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -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)
}
}
2 changes: 1 addition & 1 deletion src/pkg/dashboard/contribute_landing.go
Original file line number Diff line number Diff line change
Expand Up @@ -1579,7 +1579,7 @@ select.admin-act{min-width:0;max-width:100%%}
<div id="invite-banner" class="invite-banner" hidden role="status"></div>
<p class="subtitle">Donate your CLI + API tokens to help this project's AI agent swarm.</p>
<p class="subtitle" style="font-size:.95rem;margin-top:-24px;margin-bottom:var(--sp-4)">Powered by <strong style="color:var(--text)">ClankeR</strong>, the contributor relay &mdash; it hands tasks from this hive's backlog to the agent running on your machine. Your compute, their backlog. Bring your own inference &mdash; how you want to contribute is up to you.</p>
<p class="subtitle-discord">Questions? <a class="discord-link" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a> and we'll help you get to your first PR.</p>
<p class="subtitle-discord">Questions? <a class="discord-link" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a> and we'll help you get to your first PR. Or <a class="discord-link" href="https://www.twitch.tv/hivecommons" target="_blank" rel="noopener">watch the hive live on Twitch</a>.</p>
<div class="stat-row">
<div class="stat"><div class="stat-num" style="color:var(--cc-accent)">%d</div><div class="stat-label">Total</div></div>
%s
Expand Down
2 changes: 1 addition & 1 deletion src/pkg/dashboard/contribute_sse_gap_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -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 {
Expand Down
2 changes: 1 addition & 1 deletion src/pkg/dashboard/static-src/html/faq.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ <h2 class="section-label section-header-toggle mb-4" data-action="toggleSection"
<p class="faq-intro">Short answers to the questions people ask once a hive is running. Everything below describes what this hive
actually does today β€” where behaviour is surprising, it is called out rather than smoothed over. Each answer links to the
source doc, so this panel stays a map, not a second source of truth.</p>
<p class="faq-intro">Need help from humans? <a class="text-accent fw-semibold" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a>; the Hive Commons community can help you pick the right next step.</p>
<p class="faq-intro">Need help from humans? <a class="text-accent fw-semibold" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a>; the Hive Commons community can help you pick the right next step. Want to see a hive at work? <a class="text-accent fw-semibold" href="https://www.twitch.tv/hivecommons" target="_blank" rel="noopener">Watch the hive live on Twitch</a>.</p>

<div class="faq-filter-row">
<label for="faq-filter" class="faq-filter-label">Filter</label>
Expand Down
1 change: 1 addition & 0 deletions src/pkg/dashboard/static-src/html/sidebar.html
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@
<a class="oc-nav-item" href="/api/docs" target="_blank"><span class="oc-nav-emoji">πŸ“˜</span><span class="oc-nav-text">API Spec (Redoc)</span></a>
<a class="oc-nav-item" href="https://docs.hivecommons.dev/docs/hive/getting-started" target="_blank" rel="noopener noreferrer" title="Zero to Automation: the beginner guide to running your hive, level by level"><span class="oc-nav-emoji">πŸ“–</span><span class="oc-nav-text">Getting Started Guide</span></a>
<a class="oc-nav-item" href="https://hivecommons.dev/discord" target="_blank" rel="noopener"><span class="oc-nav-emoji">πŸ’¬</span><span class="oc-nav-text">Join our Discord</span></a>
<a class="oc-nav-item" href="https://www.twitch.tv/hivecommons" target="_blank" rel="noopener" title="Live stream of the hosted hive's Activity Monitor"><span class="oc-nav-emoji">πŸ“Ί</span><span class="oc-nav-text">Watch live on Twitch</span></a>
<a class="oc-nav-item" data-action="openFeedbackModal" data-arg0="bug" data-prevent="1"><span class="oc-nav-emoji">πŸ›</span><span class="oc-nav-text">Report an Issue</span></a>
</div>
<!-- Pinned label filters (#12172): one entry per pinned saved filter /
Expand Down
2 changes: 1 addition & 1 deletion src/pkg/dashboard/static-src/js/config-hub.js
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@
<div class="config-field">
<label>Help &amp; community links ${settingHelpMark('contributor-relay', '', 'Help & community links', `Shown on /contribute Onboarding, Operations, and in relay terminals at connect. One "Label | URL" per line, max 5. Discord channel URLs only work for existing server members; prefer https://hivecommons.dev/discord for new contributors.`)}</label>
<textarea rows="4" style="width:100%;font-family:var(--font-mono);font-size:0.72rem;resize:vertical" placeholder="Chat with other contributors | https://hivecommons.dev/discord" data-change-action="setContributeHelpLinksFromText" data-arg-types="v">${esc(helpLinksText)}</textarea>
<span style="font-size:0.65rem;color:var(--muted);margin-top:var(--sp-2);display:block">Stored as <code>contribute.help_links[].label</code> and <code>contribute.help_links[].url</code>. Empty restores Hive's default contributor docs and issue links.</span>
<span style="font-size:0.65rem;color:var(--muted);margin-top:var(--sp-2);display:block">Stored as <code>contribute.help_links[].label</code> and <code>contribute.help_links[].url</code>. Empty restores Hive's default contributor docs, issue tracker, and Twitch live stream links.</span>
</div>

${renderFilterWithMode({
Expand Down
2 changes: 1 addition & 1 deletion src/pkg/dashboard/static-src/js/welcome.js
Original file line number Diff line number Diff line change
Expand Up @@ -332,7 +332,7 @@
_welcomeOpenSteps.add(firstUndone ? firstUndone.id : WELCOME_STEPS[0].id);
}
let html = '';
html += '<div class="welcome-intro">New to Hive? Start here β†’ <a href="https://docs.hivecommons.dev/docs/hive/getting-started" target="_blank" rel="noopener noreferrer" style="color:var(--accent);font-weight:600">Zero to Automation: Your Getting Started Guide</a> Β· <a class="text-accent fw-semibold" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a><br><span style="font-size:0.85em;color:var(--muted)">⏰ Heads up: hosted hives that stay unconfigured or inactive are reaped on a timer. Install the Forge App β€” the app for your source control system (e.g., GitHub, GitHub Enterprise, GitLab, or Gitea) β€” in your first session (step 2), and if your hive ever disappears or its URL times out, request a new one from the hub and set it up promptly.</span></div>';
html += '<div class="welcome-intro">New to Hive? Start here β†’ <a href="https://docs.hivecommons.dev/docs/hive/getting-started" target="_blank" rel="noopener noreferrer" style="color:var(--accent);font-weight:600">Zero to Automation: Your Getting Started Guide</a> Β· <a class="text-accent fw-semibold" href="https://hivecommons.dev/discord" target="_blank" rel="noopener">Join our Discord</a> Β· <a class="text-accent fw-semibold" href="https://www.twitch.tv/hivecommons" target="_blank" rel="noopener">Watch the hive live on Twitch</a><br><span style="font-size:0.85em;color:var(--muted)">⏰ Heads up: hosted hives that stay unconfigured or inactive are reaped on a timer. Install the Forge App β€” the app for your source control system (e.g., GitHub, GitHub Enterprise, GitLab, or Gitea) β€” in your first session (step 2), and if your hive ever disappears or its URL times out, request a new one from the hub and set it up promptly.</span></div>';
let n = 0;
for (const step of WELCOME_STEPS) {
n++;
Expand Down
Loading
Loading