vole
Clone
Read only, no credentials:
https://rodent.software/git/vole.git
Write over SSH with a registered key:
git clone ssh://git@0.0.0.0:2222/vole.git
A free and open-source forge that lives in your Git repo.
Accounts with stable ids; the roster moves into the system repository
31df8baea9c9e8acf74b71bdda26d27907b30f2a · Keenan Nemetz · 17d ago · parent 36293228
Accounts with stable ids; the roster moves into the system repository
Names were the primary key everywhere — the keys file name, the ACL entry, the
approval file — so renaming someone broke their access, orphaned their approvals,
and left a retired name able to hand a newcomer the old holder's rights. This
splits identity into an account (stable id, anchored by its SSH keys) and a name
(mutable, never reissued).
data/system.git refs/heads/main
users/<ulid>/meta.json name, status, keys, former_names
Everything that grants authority now holds the id: ACL entries, approval files,
and the identity resolved at the SSH handshake (VOLE_ACTOR_ID). A rename is a
one-file change that disturbs nothing else, and both the old and new names stay
reserved forever.
The roster moved from a trusted-keys directory back into git, which reverses an
earlier simplification — deliberately, and in a smaller shape (one file per
account, one writer, no CAS plumbing for unused fields). Git buys what a directory
could not: `git log` answers who renamed whom and when a key appeared, and the
roster is now readable by anyone who can clone, since it is served read-only at
ssh://host/system.git. `vole request new` and `approve` use exactly that to turn a
name typed on the command line into the account id they store.
Two latent bugs surfaced, both caught by tests added here:
- gitx inherited git's repository-scoped environment. pre-receive runs with
GIT_OBJECT_DIRECTORY and GIT_QUARANTINE_PATH pointing at the pushed repository's
quarantine, so every git call a hook made for a *different* repository silently
read the pushed one: the hook saw an empty roster. gitx now scrubs those
variables and the hook restores them for the pushed repository only.
- The hook built the repository name with filepath.Base on receive-pack's path,
which carries a trailing separator, so refusals read "does not have write access
to .". Cleaned first.
Verified end to end on a live instance: two accounts file, approve and land a
change; `vole user rename wilbur robert` keeps the same key's write access and the
approval still reads as current, now credited to robert; the roster history shows
"user: rename wilbur to robert"; retiring an account rejects its key within five
seconds and refuses to reissue the name.
internal/web/web.go +4−2
| @@ -18,6 +18,7 @@ import ( | |||
| 18 | 18 | "github.com/rodent-software/vole/internal/acl" | |
| 19 | 19 | "github.com/rodent-software/vole/internal/config" | |
| 20 | 20 | "github.com/rodent-software/vole/internal/gitx" | |
| 21 | "github.com/rodent-software/vole/internal/identity" | ||
| 21 | 22 | "github.com/rodent-software/vole/internal/index" | |
| 22 | 23 | "github.com/rodent-software/vole/internal/repo" | |
| 23 | 24 | ) | |
| @@ -25,12 +26,13 @@ import ( | |||
| 25 | 26 | type Web struct { | |
| 26 | 27 | Repos *repo.Store | |
| 27 | 28 | Index *index.Store | |
| 29 | Ident *identity.Store | ||
| 28 | 30 | Cfg *config.Config | |
| 29 | 31 | Tmpl *template.Template | |
| 30 | 32 | Logger func(format string, args ...any) | |
| 31 | 33 | } | |
| 32 | 34 | ||
| 33 | func New(repos *repo.Store, ix *index.Store, cfg *config.Config) (*Web, error) { | ||
| 35 | func New(repos *repo.Store, ix *index.Store, ident *identity.Store, cfg *config.Config) (*Web, error) { | ||
| 34 | 36 | t, err := template.New("vole").Funcs(template.FuncMap{ | |
| 35 | 37 | "since": humanSince, | |
| 36 | 38 | "short": shortSHA, | |
| @@ -39,7 +41,7 @@ func New(repos *repo.Store, ix *index.Store, cfg *config.Config) (*Web, error) { | |||
| 39 | 41 | if err != nil { | |
| 40 | 42 | return nil, err | |
| 41 | 43 | } | |
| 42 | w := &Web{Repos: repos, Index: ix, Cfg: cfg, Tmpl: t} | ||
| 44 | w := &Web{Repos: repos, Index: ix, Ident: ident, Cfg: cfg, Tmpl: t} | ||
| 43 | 45 | w.Logger = func(string, ...any) {} | |
| 44 | 46 | return w, nil | |
| 45 | 47 | } | |