vole

Clone

Read only, no credentials:

https://rodent.software/vole.git

Write over SSH with a registered key:

git clone ssh://git@rodent.software: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

server/web/writes.go +6−2

@@ -285,8 +285,12 @@ func (w Web) CreateChangeRequest(rw http.ResponseWriter, r http.Request) {
	285	285	}
	286	286	req.HeadRef = head
	287	287	// Issues this request promises to close. They are checked when the request is
	288		// written, so a typo fails here rather than at the landing.
	289		req.Closes = closesField(r.PostFormValue("closes"))
		288	// written, so a typo fails here rather than at the landing. A number is turned
		289	// into the id here, the same way the CLI flag does, so the file holds ids.
		290	if req.Closes, err = w.resolveCloses(m, closesField(r.PostFormValue("closes"))); err != nil {
		291	http.Error(rw, err.Error(), http.StatusBadRequest)
		292	return
		293	}
	290	294	if err := metadata.CreateRequest(m.Git(), req, ctx.Name); err != nil {
	291	295	w.serverError(rw, r, "cannot open the change request: "+err.Error())
	292	296	return