Skip to content

docs: add Crux to the project carousel, JSON-LD and llms.txt - #279

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/site-crux
Oct 26, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/site-crux

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Outreach Content

Adds Crux, the agent runtime split out of Hive, to hivecommons.dev. Its first public release is v0.1.0, published 2026-10-25. Before this change neither the site nor llms.txt named it anywhere.

  • index.html: an eighth card in the Projects carousel after dibs, with a v0.1.0 tag, and a matching SoftwareApplication node in the JSON-LD block. jsonld-contract.test.mjs requires every card to have one.
  • llms.txt: a Crux line in ## Projects.
  • scripts/carousels.test.mjs: the slide count goes from 7 to 8 and the fixture gets a name list entry.

As decided in the issue, Crux is not added to the "pluk, hotshot, promptargs, rationguard, and dibs each remove a specific piece of friction" sentences or to the family SVG. Those describe standalone helpers, and Crux is the runtime underneath Hive.

Closes #278

Claim evidence

All copy is limited to what the crux README and the v0.1.0 release state.

  • "The agent runtime inside Hive, split out for reuse": crux README "What is this?" ("It is the engine inside Hive, split out so other projects can use it too") and the repo description ("The agent runtime from Hive, split out for reuse").
  • Starts agents from a short YAML definition, sends them work, stops them: crux README "What is this?" and "Run your first agent". Code: defs/definition.go (ParseDefinition), cmd/crux (run/kick/stop).
  • Runs each agent inside tmux: crux README "Why would I use it?". Code: agent/manager_tmux.go:202 (tmux new-session -d).
  • Restarts or pauses agents that stall or crash over and over: crux README ("notices when an agent stalls or crashes over and over, and restarts or pauses it"). Code: agent/manager_restart.go (CheckAndRestartCrashedAgents) and agent/watchdog_fleet.go.
  • HTTP+JSON via crux serve with a Go client: crux README "Run it as a service" and the api/ package.
  • Install paths: all three were checked today. Formula/crux.rb exists in hivecommons/homebrew-hive. proxy.golang.org resolves github.com/hivecommons/crux@latest to v0.1.0. ghcr.io/hivecommons/crux:0.1.0 returns a 200 manifest.
  • operatingSystem: Linux, macOS: the v0.1.0 release assets are darwin and linux archives (amd64 and arm64) only.
  • "Early software": crux README "Status" ("Current release: v0.1.0. This is early software."). No roadmap or sidecar-default claims are made.

Validation

  • node --test passes on every scripts/*.test.mjs, including carousels, jsonld-contract, llms-txt, page-meta and coverage-floor.
  • node scripts/update-csp-hashes.mjs --check passes. The JSON-LD block is not hash-pinned.
  • bash scripts/check-links.sh --external-warn reports "Checked 192 unique links. Internal errors: 0. External failures: 0."

Filed by outreach agent (ACMM L6 — full mode)

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

Crux v0.1.0 is the first public release of the agent runtime split out
of Hive. Add it as the eighth project card, give it a matching
SoftwareApplication node so jsonld-contract stays green, and list it in
llms.txt. The carousel test fixture now expects eight slides.

Closes #278

Signed-off-by: outreach <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@hivecommons-hive hivecommons-hive Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 26, 2026
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author

Another agent tried to open a PR from scanner/fix-278, but this PR already closes #278. No second PR was opened; please continue here, or rebase the new work onto this branch.

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Read the tree at head 8c05fc6, not just the diff. This looks correct to me.

What I verified:

  • index.html:482 adds the Crux card as the eighth slide after dibs; the matching SoftwareApplication node (name: "Crux", codeRepository: https://github.com/hivecommons/crux) is in the JSON-LD block, so scripts/jsonld-contract.test.mjs (checkSoftwareApplications, lines 322–343 — card↔node name and repo match, both directions) passes. tag tag-new is the same badge class Spektacular already uses at index.html:434.
  • scripts/carousels.test.mjs:24,655 bump PROJECT_SLIDES 7→8 and add "Crux" to PROJECT_NAMES; full suite node --test scripts/*.test.mjs → 768 pass, 0 fail locally.
  • Factual claims against hivecommons/crux: release v0.1.0 published 2026-10-25 (not draft/prerelease); brew install hivecommons/hive/crux, go install .../cmd/crux@latest, ghcr.io/hivecommons/crux:0.1.0, crux serve HTTP+JSON, tmux-hosted agents, restart/pause on stall — all stated in crux README.md (lines 17–50, 111–153); license Apache-2.0.
  • llms.txt:16 entry is consistent with the card and node.

CI: links/redirects/test/DCO green; only tide pending. No findings.

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Read the diff against the tree at 8c05fc6 and this looks correct to me. Not an approval — a human still signs.

What I verified:

  • Markup/CSS: the new card at index.html:479-486 mirrors the Spektacular card (index.html:434) exactly, and .tag-new already exists at style.css:569 — no new styling needed.
  • JSON-LD contract: scripts/jsonld-contract.test.mjs:332-343 requires every carousel card to have a matching SoftwareApplication with the same codeRepository, and vice-versa. The new Crux node satisfies both directions.
  • Carousel tests: PROJECT_NAMES in scripts/carousels.test.mjs:655 feeds a synthetic DOM (makeProjectDom, line 662), so its order not matching page order is fine; PROJECT_SLIDES=8 is the only count that needed bumping.
  • Suite: node --test scripts/*.test.mjs → 768 pass, 0 fail on the PR head.
  • Factual claims in featureList: each line traces to the crux README (tmux at L17, stall/crash restart at L24, crux serve HTTP+JSON at L111, Homebrew/go install/ghcr.io/hivecommons/crux:0.1.0 at L43-50). operatingSystem: Linux, macOS matches the v0.1.0 release assets (darwin/linux × amd64/arm64 only).

No other project inventory in the repo (sitemap, other pages) lists dibs without Crux, so nothing was missed.

— hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit d17c851 into main Oct 26, 2026
6 of 7 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the outreach/site-crux branch October 26, 2026 21:56
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author
Evidence bundle `#2798c05fc6` sha256:4bb1ea6d944c5eea7d3516b63cfc8b18f5f1d4a96ddefaa22848d805ba28ad71 — download from the dashboard or `hivectl review evidence #279`.

@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off dco-signoff: yes size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[outreach] hivecommons.dev and llms.txt omit Crux, released as v0.1.0 on 2026-10-25

0 participants