Watch
0
0
Fork
You've already forked hyperhive
0
Commit graph hyperhive/docs/2-handbook
Author SHA1 Message Date
damocles
5814f177c8 docs: the swarm-builder status gates the merge now, and no promise about rebasing a PR branch 2026-11-21 21:40:56 +01:00
iris
7707a257e9 hive ui: the dashboard wears the swarm UI's chrome, and its own header, tab strip and menu mounts go
The dashboard mounts @hive/shared's AppShell, the header, nav and settings menu the swarm UI has, from a new shell.js: the hive's name for the brand, the tabs agents, rebuild queue and kept state routed by the URL hash, the theme, motion and solid-background settings in this page's own browser storage, and the shared links and user menus. The three tab panes stay plain DOM, kept hidden in index.html and moved into the shell's content column by shell.js. The tabs, the hash-to-tab parse and the menu entries sit in shell-routes.js, which npm test covers (the dashboard package gets a test script). The old header, the createTabStrip tabbar, the leet tab names, the identity headline and title code, the sticky-top wrapper, the links-menu.js and user-menu.js mounts and their CSS are removed. The docs say the plain tab names and the new chrome.
2026-11-21 10:47:37 +01:00
iris
797e6e3137 swarm ui: the messages cards move to the swarm page and the messages tab goes
The broadcast, schedules and message log cards now sit on the swarm page, after the notification router; the message log opens its stream on its first open instead of when the page loads, and its connection badge moves into its filter bar. The messages tab is removed from the header, and the old /messages address redirects to /swarm next to /schedules, which now does too. MessagesPage becomes MessageCards, and comments, tests and the swarm UI docs say the swarm page where they said the messages tab.
2026-11-20 22:10:42 +01:00
maia
c9204ad0e0 android-dev archetype: ship the Android SDK and nix-ld so a Gradle build runs
The archetype installed Gradle, a JDK and android-tools but no SDK, no
ANDROID_HOME/JAVA_HOME and no nix-ld, so the aapt2 Gradle downloads could not
start on NixOS and an agent could not build an app.

It now builds an SDK (build-tools 36.1.0, platform 35, no emulator or system
images), sets ANDROID_HOME, ANDROID_SDK_ROOT and JAVA_HOME, and enables
programs.nix-ld. The SDK's unfree names are read off the SDK and added to
allowUnfreePackages, which adds to the claude-code allowance instead of
replacing it.

Closes #6696
2026-11-20 19:35:47 +01:00
atlas
eab2dcb0a2 egress: document the allowed ssh connections 2026-11-20 04:04:30 +01:00
atlas
934da6f31f agent ssh connections: declare per agent, render into the agent's ssh config 2026-11-20 03:10:41 +01:00
maia
ffbd2f4dea swarm-controller: an opt-in plain /healthz and /readyz listener a kubelet can probe 2026-11-19 12:23:17 +01:00
maia
b0239914b8 readiness follows a cached store check instead of a constant or a login per probe 2026-11-19 08:43:43 +01:00
maia
2eacb83b21 a removed hive's OIDC client secret is deleted with its other store credentials 2026-11-19 08:42:46 +01:00
maia
c7d37ca455 grant-bootstrap re-applies the granter and restarts failed policy units; setup treats a refused granting unit as not done 2026-11-19 08:17:02 +01:00
atlas
c21b158884 swarm daemons: opt-in /healthz and /readyz listener, and /readyz on the controller 2026-11-18 19:06:04 +01:00
atlas
b6dc46d315 document the hive cut-off 2026-11-17 06:48:05 +01:00
maia
07ca0b6100 swarm-ui: say in the revoke checkbox that it deletes the key-backup passphrase; docs: active voice for vale 2026-11-16 22:49:16 +01:00
maia
6b3e1f0fb2 revoking a linked Matrix account also deletes its key-backup passphrase; a plain unlink keeps it for a relink 2026-11-16 22:49:16 +01:00
atlas
3d7541c0af sign ssh certificates on demand from ssh itself, warn before setup, say what to do when a host key changes 2026-11-16 20:31:18 +01:00
atlas
e621397252 swarm ui ssh row with target snippets, docs for the per-agent switch 2026-11-16 20:31:18 +01:00
atlas
aeb9317ad1 correct the ssh revocation docs and say the sign permission is shared 2026-11-16 20:31:18 +01:00
atlas
0afb111862 add an ssh ca to bao, agent ssh certificates and a target module 2026-11-16 20:31:18 +01:00
iris
6ed714a0a7 remove the agent's stats page and its endpoint 2026-11-16 19:00:52 +01:00
iris
db924d9e77 swarm ui: a fire now button on each schedule 2026-11-16 11:29:23 +01:00
iris
5175d3663e swarm: set the fresh-session threshold per agent 2026-11-16 10:50:13 +01:00
iris
6289b8d64b remove the agent's live terminal page and the endpoints only it used 2026-11-16 08:06:47 +01:00
iris
750535db8a docs: use a contraction in the swarm UI commands paragraph 2026-11-16 03:21:20 +01:00
iris
fb9d4b5040 swarm: /clear starts an agent's next turn on a fresh session 2026-11-16 03:21:20 +01:00
damocles
7b62f2c22a docs: the config repo grant is read in the persistence and forge handbook pages 2026-11-16 01:34:25 +01:00
damocles
07c66e3a1c agents get read, not write, on their own agent-configs repo; an existing grant is left alone 2026-11-16 01:34:25 +01:00
iris
144d958208 swarm ui: format the section list the way treefmt does, and say the todos are not editable in active voice 2026-11-16 01:21:52 +01:00
iris
fa2a75d499 swarm ui: an open todos section on the agent card 2026-11-16 01:21:52 +01:00
atlas
c9604a6708 security handbook: say the repo limit in operator terms 2026-11-16 01:21:25 +01:00
atlas
1edeb5c55d agents get a per-agent repo limit in their permissions record, orgs are locked
max_repos (default 0, 0..=100) lives in the agent's agent-permissions record and is edited on its permissions panel. The controller applies each agent's own value as max_repo_creation at CreateForgeUser and to existing accounts on change, restart and every five minutes; agent accounts may not create organizations.
2026-11-16 01:21:25 +01:00
damocles
dc0d08b7fb add a /clear-todos command that marks the agent's todos done 2026-11-16 01:06:02 +01:00
iris
275009b64e docs: the swarm UI's command menu 2026-11-15 21:37:59 +01:00
damocles
1e03979836 swarm: a soft context limit per agent, as a percent of the window, applied at turn end 2026-11-15 17:21:13 +01:00
iris
e9ddfd61ec swarm ui: a log in button in the claude login row of an agent's settings
An agent with no stored login, or one to log in again, can be logged in from
the settings panel instead of waiting for its turns to fail with a login needed
badge first. The button opens the same dialog as the card's.
2026-11-15 16:13:15 +01:00
atlas
4bd02ea14d agents keep their github token in /run, fetched on every start, not in the state dir 2026-11-15 14:08:57 +01:00
atlas
adc61c9043 remove the swarm wireguard mesh; tombstone its options 2026-11-15 02:17:44 +01:00
iris
0e99662710 docs: the swarm README and credentials page keep the overview, the rest moves to its own pages
The hive directory and the WireGuard mesh become handbook pages of their own,
the controller's mint-failure handling moves to controller.md, and the
credential-by-credential mechanics and the secret store UI's proxy move to a new
implementation page.
2026-11-14 13:33:50 +01:00
damocles
7beb1193f4 swarm-controller: archive a destroyed agent's config repo, unarchive it when the name is created again 2026-11-14 13:29:39 +01:00
iris
814edd1d67 docs: swarm/services.md is one blurb per service, the host detail moves to the service's implementation page
Each service section lost its container, credential and metrics detail to a
Host setup section on its own implementation page, unchanged apart from links.
The four agentAuth option rows that sat above the page title moved into the
telemetry page's metrics option table.
2026-11-14 13:28:02 +01:00
atlas
c7580ac3dd archive: say the check reads from the bucket with the s3 backend 2026-11-14 11:57:57 +01:00
atlas
5c30985a25 swarm-archive: check each agent's restic repository weekly
A weekly swarm-archive-check unit runs restic check --read-data-subset on every repository on the archive host, serialised with the prune by a shared flock. It logs archive check failed per agent, pushes check gauges, and has an alert and dashboard columns.
2026-11-14 11:53:27 +01:00
atlas
723ce866f1 archive: push restic backup and prune metrics, and add a backups dashboard 2026-11-14 11:08:57 +01:00
atlas
cf360b74b9 remove the hivectl-only quota verbs and the trollshell status feed 2026-11-13 16:14:41 +01:00
damocles
c66832febf swarm-controller: stop minting the per-hive matrix sender account and token nothing reads 2026-11-12 15:38:34 +01:00
damocles
2d6ac0b7e7 swarm-stt: say plainly that the network is not restricted and the decoder can read the unit's credentials 2026-11-12 12:18:32 +01:00
damocles
96b5b83fa4 swarm-stt: the deploy module (deploy.stt.*, sandboxed container, store leaf, queue grants) and its docs 2026-11-12 12:18:32 +01:00
iris
7ba684a1da docs: the agent roster page is Agent permissions, and the docs say agent list
Roster named the permissions page, the hive's topology file and the swarm's list of agents without saying which. The page and its links are renamed; the implementation docs and UI text follow separately.
2026-11-11 23:52:15 +01:00
iris
f13d3426ee docs: choom runs Claude Code, so it needs the claude runtime 2026-11-11 23:30:54 +01:00
iris
f3093c8a5c docs: an agent is a model-driven worker, not one Claude instance
The operator chooses the runtime (claude or any ACP agent) and the model.
2026-11-11 23:26:45 +01:00
atlas
70e4c63ff7 add a triage archetype: haiku, a triage prompt, flows for new issues and prs 2026-11-11 23:25:59 +01:00