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.

Number issues and change requests for human references

e05f1c48d4ee55635cd7b77889f0545137198106 · Keenan Nemetz · 13d ago · parent 41d1fee9

Number issues and change requests for human references

A ULID is an unreadable handle, and the 8-character prefix the list showed
is mostly timestamp: this repository's 27 issues shared seven distinct
six-character prefixes and two pairs already collided at eight. The part
people actually type carried almost no information.

Issues and change requests now share one gap-free sequence (#1, #42, ...)
derived from the creation order in the metadata branch's history, the way
one forge counts both in a single run.

The number is not stored. It is the rank of the entity's creation commit,
so nothing is written when an entity is created, a repository needs no
backfill, the same history gives the same numbers on every clone, and
`vole admin index rebuild` reproduces them from git. A ULID stays the
identity: paths, front matter, `closes:` and audit entries are unchanged,
and data/index.db only caches the mapping so a page render does not walk
history.

Every id-taking command accepts a number, `#42` links in a body through a
kind-agnostic /r/<repo>/n/42 route, and --closes resolves an alias to the
ULID before writing.

Closes #45

docs/architecture.md +1−1

@@ -60,7 +60,7 @@ auditable.
	60	60	\| Repositories \| `data/repos/<name>.git` \| It is the source \|
	61	61	\| Issues, requests, approvals, release pointers, CI records \| The `vole` branch in each repository \| It is the source \|
	62	62	\| Accounts, instance roles, SSH keys, passkeys, enrollment links, sessions, access rules, locks, page-view counters \| `data/users.db` \| No; back it up \|
	63		\| Web/search index \| `data/index.db` \| Yes, with `vole admin index rebuild` \|
		63	\| Web/search index, including the `#42` alias numbering \| `data/index.db` \| Yes, with `vole admin index rebuild` \|
	64	64	\| CI queue, run index, contributor CI approvals \| `data/runs.db` \| Partly; in-progress work and approvals are lost \|
	65	65	\| LFS files, CI logs, build artifacts \| `data/lfs/` \| No; stored by content \|
	66	66	\| Privileged-action history \| `data/audit.log` \| It is the record \|