vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

also stop provisioning the hive space and make hivectl matrix invite take a room

Browse source
This commit is contained in:
damocles 2026-10-28 20:57:41 +01:00
commit fd01848d4d
2 changed files with 83 additions and 437 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/tools/hivectl-cli.md
View file

@ -116,21 +116,21 @@ Always prints the diff first. `--from forge` resets the local checkout to forge
matrix-tuwunel invites.
Manual invites into the hive Space and its rooms; c0re's periodic matrix sweep provisions the Space and the agents' invites on its own.
Manual invites into a room by id or alias.
**Usage:** `hivectl matrix <COMMAND>`
###### **Subcommands:**
* `invite` — Invite a matrix user to the hive Space, or a specific room with `--room`. Idempotent
* `invite` — Invite a matrix user to a room. Idempotent
## `hivectl matrix invite`
Invite a matrix user to the hive Space, or a specific room with `--room`. Idempotent
Invite a matrix user to a room. Idempotent
**Usage:** `hivectl matrix invite [OPTIONS] <USER>`
**Usage:** `hivectl matrix invite --room <ROOM> <USER>`
###### **Arguments:**
@ -138,7 +138,7 @@ Invite a matrix user to the hive Space, or a specific room with `--room`. Idempo
###### **Options:**
* `--room <ROOM>` — Target room id (`!abc:server`) or alias (`#name:server`). Omit to invite to the hive Space
* `--room <ROOM>` — Target room id (`!abc:server`) or alias (`#name:server`)

14
docs/tools/hivectl.md
View file

@ -44,13 +44,12 @@ hivectl forge reconcile-config iris --verbose # include the full diff, not
## Matrix
Manual entry to the same idempotent matrix provisioning flow
`hive-c0re` runs at boot. Requires the `hive-matrix` container to be
Manual invites into a room. Requires the `hive-matrix` container to be
running (`services.hyperhive.deploy.matrix.enable = true`).
```bash
hivectl matrix invite mara # invite a user to the hive Space
hivectl matrix invite @mara:server --room '#some-room:server' # ...or to a specific room/alias
hivectl matrix invite mara --room '#some-room:server' # a room alias
hivectl matrix invite @mara:server --room '!abc:server' # ...or a room id
```
Human matrix accounts come from SSO, not `hivectl`; matrix homeserver
@ -58,10 +57,9 @@ admin should eventually come from membership in authelia's `admins`
group; nobody has built that sync yet.
- `invite`: invites a matrix user (full `@user:server` or a bare
localpart, qualified with the homeserver's `server_name`) to the hive
Space by default, or to a `--room` id / `#alias`. Uses the sender
token; the account must be a member of the target room with
invite power (it owns the hive Space, so that case always works).
localpart, qualified with the homeserver's `server_name`) to the
`--room` id / `#alias`. Uses the sender token; the account must be a
member of the target room with invite power.
Idempotent — already-member / already-invited is a no-op.
## Agents