From 86f9a1a5c5088b60f694324e84dc31f682156a1b Mon Sep 17 00:00:00 2001 From: jochen Date: Wed, 21 Oct 2026 15:48:22 +0200 Subject: [PATCH] Cite ADR 0488 in the per-node bucket's doc comments (issue 1694) --- go/declaration/filereference.go | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/go/declaration/filereference.go b/go/declaration/filereference.go index a0aa172..665b0fe 100644 --- a/go/declaration/filereference.go +++ b/go/declaration/filereference.go @@ -16,7 +16,7 @@ const ( FileReferenceThreshold = 64 * 1024 // FileBucketPrefix starts the name of a node's object bucket, FileBucketFor(node), which holds the contents of the // files of that node's declaration, each under the hex of its sha256 digest (ObjectName). One bucket per node, - // so a grant names it and a literal `*` is never needed (ADR 0486 §2). The controller alone writes it; the + // so a grant names it and a literal `*` is never needed (ADR 0486 §2, changed by ADR 0488 §1 and §2). The controller alone writes it; the // node's engine reads an object by name. FileBucketPrefix = "declaration-files-" // FileStreamPrefix starts the name of the stream behind such a bucket, which the bus's grants name. @@ -27,7 +27,8 @@ const ( var nodeToken = regexp.MustCompile(`^[A-Za-z0-9_-]+$`) -// FileBucketFor is the name of the object bucket of a node's files. The node name must be a name the bus accepts in a +// FileBucketFor is the name of the object bucket of a node's files, "declaration-files-" (novox/hq ADR 0488 +// §4, which replaces the single bucket constant of issue 1694). The node name must be a name the bus accepts in a // bucket and in a subject token: letters, digits, '_' and '-', so no '.', '*', '>' or space. func FileBucketFor(node string) (string, error) { if !nodeToken.MatchString(node) {