Watch
0
0
Fork
You've already forked hyperhive
0
Commit graph hyperhive/docs
Author SHA1 Message Date
atlas
817c222951 container stats: sample the ci runner's container 2026-11-08 10:34:13 +01:00
atlas
530137a7bb hive-c0re: queue another knowledge pull soon after a failed one, backing off to 5 minutes 2026-11-08 09:19:48 +01:00
atlas
a20596fa59 swarmctl: add bao init and bao grant-bootstrap
init prints the store's keys and root token once and keeps none; with
--and-grant it goes on to the granter bootstrap in the same process.
grant-bootstrap does that step alone, reading the root token from a
hidden prompt or stdin. The token reaches bao only as BAO_TOKEN in the
child's environment.
2026-11-08 09:09:13 +01:00
atlas
e9321297c0 swarm-grafana: a host dashboard for the collector's system metrics
Adds host.json (hive and host filters over the hostmetrics series),
registers it in the provisioned dashboard list, lists it in the swarm
services handbook, and adds a module-eval case that it ships and every
query filters on both variables.
2026-11-08 09:01:21 +01:00
damocles
1c3b5e52cf drop the host side of the agent broker send
Remove the agent-side Send and AckUntil requests, their hive-c0re handlers
(handle_send with its 4 KiB size cap, handle_ack_until) and Broker::ack_until.
Everything that existed only for them goes with them: the OkWarn response
(its sole producer was Send's reserved-name warning), Recv's max parameter
and RECV_BATCH_MAX (the harness never asked for more than one message),
OPERATOR_SEND_REFUSAL, and the MESSAGE_MAX_BYTES / check_size limit (the
reminder timer keeps its own copy of the cap, so its comment is reworded).

Messages.remaining stays on the wire (default on read) because a harness
built before this change still requires it. Update the conventions docs.
2026-11-08 08:56:39 +01:00
atlas
aeef4634e1 report the btrfs-subvolume root in host filesystem metrics 2026-11-08 03:03:49 +01:00
atlas
319dd6a808 alert when claude usage runs ahead of the clock, per account 2026-11-08 02:05:50 +01:00
atlas
dab7768869 scope the cache access to hive-core: client-side nix copy, daemon trusts only the key 2026-11-08 01:56:55 +01:00
atlas
ecd4445680 hive-c0re pulls closures through the nix daemon; hive-priv verifies the swarm signature before applying 2026-11-08 01:56:55 +01:00
atlas
448b703995 hivectl agent watch: document control-char replacement and the quiet exit on a closed pipe 2026-11-08 01:55:16 +01:00
damocles
8154c5da02 docs: vale fixes in the messaging paragraph 2026-11-08 01:40:10 +01:00
damocles
bffb2c07a8 drop the hyperhive send/recv/ack_until tools: agents message over matrix 2026-11-08 01:40:10 +01:00
damocles
64c0b8b3f0 docs: send_dm and open_dm accept a bare agent name 2026-11-07 23:01:02 +01:00
atlas
61a334c847 swarmctl setup status shows where the setup ceremony stands 2026-11-07 17:20:21 +01:00
atlas
78b0451ed1 hive-priv: overlay the knowledge .git only when the clone has one, so agents start before the first clone 2026-11-07 15:13:35 +01:00
damocles
513530ae35 matrix-mcp: auto-join only on accounts that live on the swarm homeserver 2026-11-07 14:10:06 +01:00
damocles
852d98e8dd docs: the daemon auto-joins invites from the own homeserver 2026-11-07 14:10:06 +01:00
iris
a47edaec5b docs: drop the sentence that says the dashboard row has no forge links
A page documents what is there, not what was removed.
2026-11-07 13:43:44 +01:00
iris
d516bb890c remove the forge links from the hive dashboard and the agent page
Each agent row on the hive dashboard, and the agent page's link menu, linked
to the agent's forge profile and its config repo. Both are gone, with what
only they used:

- hive-agent no longer builds the two links, the `Forge` link kind, or the
  `forge_public_url` field of its state, and no longer reads
  `HIVE_FORGE_PUBLIC_URL`. The agent page's link menu and the dashboard row's
  icon strip (which skips a forge link an agent not yet rebuilt still sends)
  drop their forge handling.
- hive-c0re's dashboard state no longer carries `forge_public_url`.
- `HIVE_FORGE_PUBLIC_URL` is no longer forwarded to agents through the meta
  flake (the forwarded-variable list, its test fixture, the controller's
  settings and the VM test), so the next meta flake render differs by that
  one line. hive-c0re still reads it for the forge URL a hive publishes, so
  `swarm.forge.publicUrl` stays, with its description corrected.
- The docs stop describing the links.
2026-11-07 13:43:44 +01:00
atlas
1b6d7f3c99 swarm: a failed facts copy counts in the held-deploys gauge 2026-11-07 12:59:50 +01:00
atlas
79c1b6d81d swarm: a deploy goes out only once its closure is cached and the hive has its cache facts 2026-11-07 12:28:44 +01:00
iris
0e84fe8bc4 docs: the handbook follows the three layers: swarm, hives, agents
The handbook's sections were agent-lifecycle, integrations, swarm, tools,
trust-boundary and web-ui, which do not follow how the system is built, so a
reader could not tell which layer a page is about. Its pages now sit in
swarm/, hives/ and agents/, with the accounts an agent can hold outside the
system in external-accounts/.

- swarm/: forge, matrix and the knowledge repo join the swarm pages, and so
  does the swarmctl reference.
- hives/: the dashboard, hivectl and its reference, and the operator/agent
  boundary, with a README that takes over the old web-ui and tools pages.
- agents/: the roster, persistence, config changes, the agent's own web page
  (was web-ui/agent) and the security model, with a README.
- external-accounts/: GitHub and GitLab.

Pages are moved whole; none is split yet. Every reference follows: relative
links in the docs, `docs/2-handbook/...` paths in code comments, the nix
checks that regenerate the CLI references and the ignore list, and docs/README.md,
whose handbook section is now by layer.
2026-11-07 12:19:36 +01:00
atlas
263b21021a swarm-controller: ask the builder for the archetypes again soon after a failed pass 2026-11-07 11:54:23 +01:00
iris
560afef2b6 swarm ui: the issue report card is named "issues"
The reports tab holds cards, so a card named "issue report" repeats the word.
The card is now "issues", beside "pull requests", and the handbook says the
same.
2026-11-07 11:46:05 +01:00
iris
944fd5b726 swarm ui: a diff column on the pull requests card, and "approved" as its header
The pull requests card gets a diff column, the lines a PR adds and removes
(`+120 −8`), sortable on the total. The controller takes the counts from the
forge's pull request list, so no call is added. The column that said "has all
approvals" is now headed "approved".
2026-11-07 11:46:05 +01:00
iris
f633963b77 swarm ui: a pull requests card on the reports tab
The reports tab gets a "pull requests" card under the issue report. It lists
the open PRs of every repo, or of one picked in a repo select, with the
columns a reviewer or merger filters on: author, labels, requested
reviewers, base branch, WIP (the forge's draft flag), approvals against the
base branch's protection rule, has all approvals, conflicts, protected base
and CI. Every column sorts, the small-set columns filter by picking values,
and the browser keeps the filters and the repo. No filter applies at first.

swarm-controller resolves each row so the page makes no calls of its own:
GET /api/pr-report and GET /api/repos/{org}/{repo}/pr-report. The required
approvals come from the first matching branch protection rule (an
unprotected base asks for none); an approval counts when it is the
reviewer's latest decision, on the current head, neither stale nor
dismissed and official.

A free-text table cell gets a minimum width, so a table with many columns
scrolls sideways instead of wrapping a title to a word a line.
2026-11-07 11:46:05 +01:00
iris
cffe8895df review classifier: the most classifications a run carries is a setting
The limit was a constant of ten in swarm-wire, so a repo with eleven rules
could not be reviewed and nothing short of a rebuild changed it. It is now
`max_classifications` in the classifier settings, beside
`max_concurrent_reviews`: 1 to 1000, ten until set, and a document stored
before the field decodes with the default. The classifier settings form in
the swarm UI gets a "rules per review" field, and the try-out's add button
stops at the saved limit instead of a hard-coded ten.

The controller checks a try-out, and a requested review's rules file, against
the setting where the run starts. The rules file itself may hold up to the
1000 the setting allows, so raising the limit needs no change to a repo.
A review whose rules exceed the limit posts a no-verdict comment saying so.

A run's reply deadline was a constant that covered ten classifications, a
minute plus three each. It is now computed from the run's own size, so a
bigger run waits as long as it needs and a default-sized one still waits 31
minutes. The classifier's answer window in the queue permissions covers the
biggest run the setting allows.
2026-11-07 11:32:04 +01:00
atlas
b8b55ba23e credentials-reference: a hand-edited public-key on the in-swarm cache is overwritten 2026-11-07 10:40:07 +01:00
atlas
b0f6ccaa64 attic-init: replace the stored public key with the one the cache reports
a re-created cache signs with a new key; the fact was only created once, so
every hive then rejected the swarm's closures. the cache's grant gains update
on that one leaf, and a store that refuses it leaves the key as it was.

Closes #6181
2026-11-07 10:40:07 +01:00
damocles
485e2e86ca docs: active voice in the power intent seeding sentence 2026-11-07 10:05:14 +01:00
damocles
b77fa9edc3 c0re: keep power intent in memory, drop agent_power/kv tables and the stop snapshot 2026-11-07 10:05:14 +01:00
damocles
c1f7bb798e hive-agent-mcp: the send allow-list is gone, agents talk to peers over matrix 2026-11-07 09:26:24 +01:00
iris
f23ce106b1 fixup! swarm-ui: the refresh picker of a polling card sits in the card's header row 2026-11-07 09:22:34 +01:00
iris
d0b37f52be fixup! swarm-ui: the refresh picker of a polling card sits in the card's header row 2026-11-07 09:22:34 +01:00
atlas
64dfe0d205 cache-miss pass pushes a record the builder did not push
A meta build whose attic push failed (attic or its token not up yet) is
recorded with cached false and the deploy goes ahead. Nothing sent that
build again until internal/meta moved, so the create for that agent
failed on every hive and a rebuild was silently never pending.

The controller's cache-miss pass now also takes a record from the head
with cached false: it sends the same build without asking the cache, with
the pass's existing backoff (30 min doubling to 12 h), and rewrites the
record with cached true once the push lands, under the same
compare-and-set guard as a path change. The push.rs module doc no longer
claims the next build pushes again.

Mixed versions: controller-only, same wire type and builder request. An
old controller leaves an uncached record as before; a builder needs no
change.

Closes #6173
2026-11-07 09:05:45 +01:00
atlas
9e0c51052b swarmctl: agent watch follows an agent's terminal rows
Reads GET /api/agents/{name}/term/stream over the controller socket or the
gateway and prints one line per row. The gateway path uses a client without
the total-request timeout so the stream isn't cut after 30 seconds.

Closes #6160
2026-11-07 09:05:10 +01:00
atlas
aa227a95c1 docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
atlas
df8a82bc33 docs: move the cli references under 2-handbook/tools
Closes #6157
2026-11-07 09:04:27 +01:00
atlas
fae9398295 start the forge and github pollers when their token lands late
Both pollers wait about ten minutes for the agent's token, then exit 0.
Under Restart=on-failure that exit is final, and nothing started them
again, so a token minted or placed after the window left the agent
without notifications until its container restarted.

Add a path unit per poller with PathChanged on the token file(s) the
poller reads, the shape forge-avatar-sync already uses. A path unit
starts its service only when it is not running, so a poller that found
its token is untouched. The github path unit is gated on
github.enable like its service.

Container-side: it ships with the agent's next rebuild, and an agent on
an older rev keeps the old behaviour.

Closes #6179
2026-11-07 08:40:05 +01:00
damocles
ac3b3cfcd3 hive-agent: the agent has no login flow of its own, credentials come from the swarm 2026-11-07 08:32:11 +01:00
atlas
71d360c9d2 swarmctl: agent set-state declares an agent's wanted state
Wraps PUT /api/hives/{hive}/agents/{agent}/state, the route the swarm UI's
state menu uses. States come from swarm_wire::wanted::AgentState; destroyed
needs --yes.

Closes #6159
2026-11-07 07:58:30 +01:00
damocles
06b303aff2 hivectl: the open verb is gone and the docs say what hivectl has 2026-11-07 07:57:50 +01:00
atlas
e9025823d9 agent: export swarm-queue connected gauge and skipped-publish counter, with dashboard panels 2026-11-07 07:56:17 +01:00
damocles
ce9332cd02 hive-matrix-mcp: an edited message shows once, edited in place, and is not a second unread 2026-11-06 22:04:49 +01:00
damocles
c8eaa93268 swarm: the notification router tells a PR's author when CI on it fails or is cancelled 2026-11-06 22:01:22 +01:00
atlas
d4e58f8741 docs: put default comments above the claude plugin options 2026-11-06 21:20:49 +01:00
atlas
4c321f3d2d docs: nest config examples and use neutral swarm/hive names
Closes #6146
2026-11-06 21:20:49 +01:00
iris
bb789e4603 swarm-ui: the job graph shows placeholder rows in the shape of a job tree while it loads
JobqGraph takes an optional loading element, so the dashboard keeps its text
and the swarm UI's jobs tab passes a placeholder built from the graph's own
node and row classes: a root with two children and a second root, with the
real indent and rail.
2026-11-06 20:26:31 +01:00
iris
f276ee342c swarm-ui: linking a matrix account starts on the password login and warns before a pasted token
The form's credential choice now starts on 'log in with a password', listed
first, with a note that the swarm's own login gives the account a device of
its own. Choosing 'paste a token' shows a warning: a token from Element or
another client belongs to a device that is already logged in, so the agent
cannot use its encryption keys and the account will not decrypt encrypted
rooms.
2026-11-06 20:21:16 +01:00
iris
8847e6390b swarm-ui: the broadcast roster and the egress lists show placeholders while they load
The broadcast grid showed nothing while the agents loaded, and the egress
card a 'loading the … domains' line. They now show grey placeholders in the
shape of what is coming: six agent chips with the real chip's height (160 px,
measured), and three domain rows with their remove buttons.
2026-11-06 20:07:25 +01:00