v0 state

errForeignNamespace

errForeignNamespace is the one rule this realm adds on top of the library: a namespace is yours or it is not.

f

caller

height

repo

repo resolves a repo id or aborts. Read paths use f.Repo directly and return a rendered "not found" instead.

requireNamespace

requireNamespace enforces the ownership rule. Two namespaces exist and they cannot collide, since an address is 40 characters and a name caps at 39: - an address namespace ("g1.../forge") belongs to that account, always, with nothing to register and nothing to lose; - a name namespace ("moul/forge") belongs to whoever holds that name in r/sys/users, including through a rename, since the lookup resolves aliases to the same record. A realm caller passes the same way a user does, which is what makes a DAO-owned repo possible: the DAO's address is its namespace.

must

splitList

splitList parses the comma-separated lists the transaction API has to use: gnokey can only pass strings, so a \[]string parameter would not be callable.

CreateRepo

CreateRepo registers "\<namespace>/\<name>" with the caller as owner. defaultRef may be empty for refs/heads/main. The namespace must be one the caller owns: an r/sys/users name registered to their address, or their own bech32 address. Nobody squats anybody.

Fork

Fork registers newID as a fork of srcID, snapshotting the parent's current refs into the fork's log so the lineage records exactly what was forked.

SetDescription

SetDescription updates the repo description (admin).

SetMirrors

SetMirrors replaces the fetch locators, comma-separated, first one canonical (maintainer). The chain records them; it never fetches.

SetDefaultRef

SetDefaultRef points the repo at another default branch (maintainer).

SetPolicy

SetPolicy sets how many writer approvals a change needs, and whether the author's own approval counts (admin).

SetMember

SetMember grants a role: none, reader, writer, maintainer, admin, owner.

SetArchived

SetArchived freezes or unfreezes a repo (admin). The log stays readable.

SetRef

SetRef moves a ref by compare-and-swap (writer). expectedOID is the tip the caller last saw, empty to create. A stale expectation aborts instead of overwriting: git's --force-with-lease, with consensus holding the lease.

ForceSetRef

ForceSetRef moves a ref with no expectation (maintainer). It is not forbidden, it is recorded as a force, in a log nobody can rewrite.

DeleteRef

DeleteRef removes a ref by compare-and-swap (maintainer). The default branch is not deletable.

emitRef

OpenIssue

OpenIssue files an issue. Permissionless: the author pays for their bytes. labels is comma-separated. Returns the issue id.

CommentIssue

CommentIssue appends a reply.

CloseIssue

CloseIssue closes an issue (author or maintainer).

ReopenIssue

ReopenIssue reopens an issue (author or maintainer).

SetIssueLabels

SetIssueLabels replaces an issue's labels, comma-separated (maintainer).

OpenChange

OpenChange proposes moving targetRef to include headOID. sourceRepo may be another forge repo id, a mirror locator, or empty for this repo. Returns the change id.

UpdateChangeHead

UpdateChangeHead repoints an open change at a new object (author or writer). Every approval of the previous head stops counting, by construction.

ReviewChange

ReviewChange records a verdict: approve, request-changes, comment: against the change's current head. Anyone may review; a writer's approval counts.

CommentChange

CommentChange appends a reply to a change request.

CloseChange

CloseChange withdraws or rejects a change (author or maintainer).

MergeChange

MergeChange moves the target ref to mergedOID and records the move as a merge entry naming the change (maintainer). expectedTargetOID is a compare-and-swap on the target: a change approved against a base that has moved is refused, not silently rebased.

PublishPackage

PublishPackage records that a repo publishes a deployed package path. The claim is not verified and cannot be: a realm cannot ask the chain who deployed a path. What is guaranteed is that someone with write access to the repo said it, under a namespace r/sys/users governs. A reader weighs it the way they weigh a go.mod. ref, oid and tag may each be empty when unstated.

UnpublishPackage

UnpublishPackage withdraws the claim. The package stays on chain; only the repo's assertion about it goes away.

CutRelease

CutRelease names a point in a repo's history. A tag cannot be re-cut: see YankRelease for withdrawing one.

YankRelease

YankRelease marks a release withdrawn. It stays visible: a version that vanished reads as "never published" rather than "do not use this".

PackageRepo

PackageRepo is the lookup an explorer makes: given a deployed package path, which repo claims to publish it. Empty when nobody does.

PackageCount

PackageCount is how many package paths the whole forge claims.

LatestReleaseTag

LatestReleaseTag is the most recently cut release of a repo that is neither a prerelease nor yanked, or "". Most recently CUT, never highest version: tags here are not required to be semver, so there is no order to sort by that would not be wrong for somebody.

ReleaseCount

ReleaseCount is how many releases a repo has cut, yanked ones included.

RefOID

RefOID returns the object a ref points at, or "" if there is no such ref.

LogHead

LogHead returns the repo's chain digest: pin it off chain and the whole history of every ref becomes falsifiable.

HasRepo

HasRepo reports whether a repo id is registered.

RepoCount

RepoCount is the number of repos on this forge.

pageSize

pageSize bounds every listing: a Render that walks unbounded state is a Render that eventually stops rendering.

Render

Render routes gnoweb paths: / the forge: every repo /<ns>/<name> repo overview /<ns>/<name>/log the full reference log (?page=N) /<ns>/<name>/issues issues (?page=N) /<ns>/<name>/issues/<id> one issue and its replies /<ns>/<name>/changes change requests (?page=N) /<ns>/<name>/changes/<id> one change, its reviews and its replies /help what this realm is and how to call it

renderHome

renderRepo

renderLog

renderIssues

renderIssue

renderChanges

renderChange

renderHelp

logList

issueList

changeList

pager

base

repoURL

issueURL

changeURL

link

link builds a markdown link. Internal targets are realm paths this file built, so only the text needs escaping.

userLink

notFound

state

onOff

refOID

oidCode

oidCode shows the short object id, code-spanned. An empty id renders as "(none)": that is a ref being created or deleted, not a zero object.

shortDigest

mirrorRest

refSuffix

codeList

pageOf

itoa

btoa

btoa renders a bool for an event value: chain.Emit takes strings only.