docs: the config repo grant is read in the persistence and forge handbook pages
This commit is contained in:
parent
51283b8cb1
commit
7b62f2c22a
2 changed files with 8 additions and 8 deletions
|
|
@ -46,10 +46,11 @@ The tables, state directories, mounts and migrations behind this are in
|
|||
A config change is a pull request on the agent's config repo,
|
||||
`agent-configs/<name>`. No tool exists for it: opening the PR is the request.
|
||||
|
||||
1. The agent clones its config repo, edits it (`agent.nix` is the entry point),
|
||||
pushes a branch and opens the PR with `hive-forge`. Branch protection lets it
|
||||
push branches but not `main`, so it **can't merge its own config PR**. An agent
|
||||
can propose a change to another agent's config the same way.
|
||||
1. The agent clones its config repo, edits it (`agent.nix` is the entry point)
|
||||
and opens the PR with `hive-forge pr create --agit`. It has read access to
|
||||
the repo and no push access, so it **can't push a branch or merge its own
|
||||
config PR**. An agent can propose a change to another agent's config the same
|
||||
way.
|
||||
2. You review the PR on the forge, with its diff, comments and CI status, and
|
||||
merge it there. Merging needs membership of the `operators` team in
|
||||
`agent-configs`. The team starts empty: add each operator by hand in the forge
|
||||
|
|
|
|||
|
|
@ -48,10 +48,9 @@ forge is re-minted within five minutes.
|
|||
|
||||
Two things live in the `agent-configs` Forgejo organization:
|
||||
|
||||
- A config repo per agent, `agent-configs/<name>`. The agent can push
|
||||
config-change branches and open config PRs there, but `main` is
|
||||
branch-protected: only the `operators` team can merge, and the agent can
|
||||
neither push `main` nor self-merge. An operator's merge in the Forgejo UI
|
||||
- A config repo per agent, `agent-configs/<name>`. The agent is a read
|
||||
collaborator there: it opens config PRs through the AGit flow, has no push
|
||||
access, and only the `operators` team can merge, so it can't self-merge. An operator's merge in the Forgejo UI
|
||||
deploys the merged commit (see
|
||||
[persistence.md § Config changes](../agents/persistence.md#config-changes)).
|
||||
Repos stay private, so an agent can't read another agent's config.
|
||||
|
|
|
|||
Loading…
Reference in a new issue