diff --git a/llms.txt b/llms.txt index bb6b4ce..fdeb156 100644 --- a/llms.txt +++ b/llms.txt @@ -6,6 +6,8 @@ Crux is the agent runtime taken from Hive. Use it without Hive to start agents, Hive Commons also maintains Spektacular (Spek), a spec-driven workflow tool; the specs it produces are called speks. +Video: [How Hive works](https://www.youtube.com/watch?v=uo1KGTyJJyU) + ## Projects - [Hive](https://github.com/hivecommons/hive): control layer for governed, audited fleets of AI coding agents. Docs: https://docs.hivecommons.dev @@ -17,6 +19,21 @@ Hive Commons also maintains Spektacular (Spek), a spec-driven workflow tool; the - [rationguard](https://github.com/hivecommons/rationguard): detects and rebuts rationalization patterns in AI agent output. - [dibs](https://dibs.hivecommons.dev): contributor attribution layer for the AI-agent era, connecting ideators with hive-managed repositories. +## Adopters + +KubeStellar Console, tunaos.org and Project Bluefin run Hive in production; Frostyard, Open Horizon, Open Horizon Services and Danathar are pre-production adopters. Full list: [ADOPTERS.md](https://github.com/hivecommons/hive/blob/HEAD/ADOPTERS.md) + +## Community + +- [Join the mailing list](https://hivecommons.dev/join) +- [Chat on Discord](https://hivecommons.dev/discord) +- [Watch the hive live on Twitch](https://hivecommons.dev/twitch) +- [Biweekly meeting, Thursdays 10:00 AM ET](https://hivecommons.dev/meet) +- [Agenda and notes](https://hivecommons.dev/agenda) +- [Meeting recordings](https://hivecommons.dev/tv) +- [Documentation](https://docs.hivecommons.dev) +- [Governance, maintainers, and security policy](https://github.com/hivecommons/.github/blob/HEAD/GOVERNANCE.md) + ## Supported agents and inference engines Hive supports agent CLIs including Claude Code, GitHub Copilot CLI, Goose, OpenAI Codex CLI, Pi, IBM Bob, Aider, Gemini CLI, Google Antigravity CLI, OpenCode, Kilo Code, Muse Code and Oh My Pi. diff --git a/scripts/llms-txt.test.mjs b/scripts/llms-txt.test.mjs index 830bae3..5317ff5 100644 --- a/scripts/llms-txt.test.mjs +++ b/scripts/llms-txt.test.mjs @@ -159,6 +159,34 @@ function assertSameSet(pageNames, llmsNames, what) { ); } +// Absolute URLs llms.txt must carry for the home page's community surface: +// every "Join in" link in #community, the ADOPTERS.md link and the +// "See how Hive works" video. Root-relative hrefs resolve against SITE. +const SITE = "https://hivecommons.dev"; + +export function absolutize(href) { + return href.startsWith("/") ? SITE + href : href; +} + +export function communityHrefs(html) { + const s = html.indexOf('id="community"'); + if (s < 0) return []; + const start = html.indexOf("

Join in

", s); + const end = html.indexOf("", start); + if (start < 0 || end < 0) return []; + return [...html.slice(start, end).matchAll(/]*\bhref="([^"]+)"/g)].map((m) => absolutize(decode(m[1]))); +} + +export function adoptersHref(html) { + const m = html.match(/[^<]*See how Hive works/); + return m ? decode(m[1]) : null; +} + // --- fixture self-tests ------------------------------------------------------ test("splitProseList handles Oxford and non-Oxford lists, 'and', and single items", () => { @@ -318,6 +346,20 @@ test("fixture: cruxVersionFromLlms extracts version from llms.txt or returns nul assert.equal(cruxVersionFromLlms(""), null); }); +test("community link extractors read Join in, ADOPTERS.md and video hrefs", () => { + const html = `Prefer to watch? See how Hive works +

Listed in ADOPTERS.md.

+
x

Join in

`; + assert.deepEqual(communityHrefs(html), ["https://hivecommons.dev/join", "https://docs.example"]); + assert.equal(adoptersHref(html), "https://g.example/ADOPTERS.md"); + assert.equal(videoHref(html), "https://v.example/x"); + assert.deepEqual(communityHrefs("

none

"), []); + assert.deepEqual(communityHrefs('

Other

'), []); + assert.equal(adoptersHref("

none

"), null); + assert.equal(videoHref("

none

"), null); +}); + // --- live checks ------------------------------------------------------------- const live = parseLlmsTxt(LLMS_TXT); @@ -420,3 +462,14 @@ test("hotshot JSON-LD featureList names every released target CLI and the Homebr "hotshot JSON-LD featureList omits the Homebrew install", ); }); + +test("llms.txt carries every Join in link, the ADOPTERS.md link and the How Hive works video from index.html", () => { + const hrefs = communityHrefs(INDEX_HTML); + assert.ok(hrefs.length > 0, "index.html lost its #community 'Join in' list"); + const adopters = adoptersHref(INDEX_HTML); + assert.ok(adopters, "index.html lost its ADOPTERS.md link"); + const video = videoHref(INDEX_HTML); + assert.ok(video, "index.html lost its 'See how Hive works' video link"); + const missing = [...hrefs, adopters, video].filter((u) => !LLMS_TXT.includes(`(${u})`)); + assert.deepEqual(missing, [], "on index.html but missing from llms.txt — add them as markdown links"); +});