Name no node in claude-code's, messenger's, nats's and brother's help texts, comments and README (issue 1838)

Their examples named this mesh's machines; they name neutral ones now (1838/AC3). The sealed box's info string and the route-adapter's marker name the software, not a node, and stay: changing either would break what is already sealed or written.
2026-10-22 21:35:23 +02:00
parent dd074ecb18
commit 1db1965073
11 changed files with 22 additions and 22 deletions
@@ -160,7 +160,7 @@ func tools(settingsFile string, now func() time.Time) []stdio.Tool {
 			Input: map[string]any{"type": "object", "properties": map[string]any{
 				"object": str("a stored document's key: a scan's key, as scan.added names it, or the key node-files.upload answered"),
 				"path":   str("an absolute path of a file on the machine node names"),
-				"node":   str("the machine path is on, such as g14"),
+				"node":   str("the machine path is on, such as node-b"),
 				"url":    str("an http or https address of a document or a page"),
 				"ask":    str("the ask id of an earlier print that was answered as started: alone, it reads that print's outcome"),
 				"copies": num("1 to 99 (default 1)"),
@@ -813,7 +813,7 @@ func (m *MemoryCarrier) unwritten(key, project, path string, err error) {
 }

 // OlderBeside is where the older of two versions too large to share one file is kept: beside the file, named for
-// the node it was changed on ("MEMORY.md" from shanks: "MEMORY.older-from-shanks.md").
+// the node it was changed on ("MEMORY.md" from node-d: "MEMORY.older-from-node-d.md").
 func OlderBeside(path, node string) string {
 	ext := filepath.Ext(path)
 	return strings.TrimSuffix(path, ext) + ".older-from-" + node + ext
@@ -900,7 +900,7 @@ func (m *MemoryCarrier) Take(key, op string, value json.RawMessage, revision uin
 	}
 	// Only noted here, never applied: the runtime hands the watch's values over one at a time and gives the whole
 	// current set ten seconds, so a watch whose handler reads the state, waits for a look or writes a file never
-	// starts on a node with a few hundred memory files (issue 367, seen on shanks on 2026-10-13). Drain applies
+	// starts on a node with a few hundred memory files (issue 367, seen on node-d on 2026-10-13). Drain applies
 	// what was noted, the newest revision of each key.
 	m.queueMu.Lock()
 	if m.queue == nil {
@@ -117,7 +117,7 @@ func proposalTools(p Paths) []stdio.Tool {
 			Input: map[string]any{
 				"scope":  str("mesh (every node) or node (the nodes given, or this one)"),
 				"nodes":  str("for scope node: a comma-separated list of nodes; absent is this node"),
-				"name":   str("the section's name: lower-case letters, digits and -, e.g. handoff-from-g14"),
+				"name":   str("the section's name: lower-case letters, digits and -, e.g. handoff-from-node-b"),
 				"text":   str("the section's text, markdown, as every session will read it"),
 				"remove": map[string]any{"type": "boolean", "description": "propose removing the approved section of this name and scope instead"},
 			},
@@ -173,7 +173,7 @@ func questionTools(p Paths, notLaunched error) []stdio.Tool {
 					}, "required": []string{"label", "means"}}},
 				"why":       str("why the recommended option is the one you recommend, at most 120 bytes"),
 				"on_expiry": str("what you do if nobody answers before it expires, e.g. 'I leave the pull request open'"),
-				"by":        str("required: your session's name, as who@node or who, e.g. fix-589@g14"),
+				"by":        str("required: your session's name, as who@node or who, e.g. fix-589@node-b"),
 				"expires_minutes": map[string]any{"type": "integer",
 					"description": "minutes until it expires, 5 to 1430; 60 when absent"},
 			},
@@ -351,7 +351,7 @@ func AskQuestion(p Paths, in QuestionInput, store QuestionStore, bus AskBus, now
 		by = who
 	}
 	if by == "" {
-		return refuse("it does not say who asks: give by, your session's name as who@node, such as fix-589@g14")
+		return refuse("it does not say who asks: give by, your session's name as who@node, such as fix-589@node-b")
 	}
 	life := in.Expires
 	if life == 0 {
@@ -106,17 +106,17 @@ what is said is decided by the state now and by when a thing happened, never by
  what arrives meanwhile goes out, coalesced, when the minute ends.

 **A message reads in one glance** (novox/hq ADR 0253). Its title is the condition's headline — a few
-plain words such as "openrazer not working on g14" — prefixed "Urgent:", "Still open:" or "Now urgent:"
+plain words such as "openrazer not working on node-b" — prefixed "Urgent:", "Still open:" or "Now urgent:"
 where that applies; its body is the condition's explanation (what happened, what it means, whether the
 operator needs to act) and since when, in the operator's time zone. No key, id, commit, command or markup:
 those stay in the controller's `conditions` and in this module's history. A clearance is one line, the
-condition's resolved line and how long it was open: "Resolved: openrazer works again on g14, after 26 min".
+condition's resolved line and how long it was open: "Resolved: openrazer works again on node-b, after 26 min".
 A condition from a controller older than plain words, or a module's notice without a headline, is said from
 its summary, with code spans taken out (`cmd/messenger/words.go`).

 **A condition's message says which issue tracks it** (novox/hq ADR 0285, issue 400). Below the explanation,
 one line from the issue tracker's `tracking` verb, asked outside the work at most once a minute and used for
-ten minutes: "Tracked as issue 386: fix-386 on g14 is fixing it since 21:10.", "…: nobody is working on it.",
+ten minutes: "Tracked as issue 386: fix-386 on node-b is fixing it since 21:10.", "…: nobody is working on it.",
 "…: its fix is merged and on its way.", "…: it waits for your answer.", up to three issues and then a count;
 "No issue tracks this yet." when no issue links the condition's key; "Whether an issue tracks this could not
 be checked." when the tracker gave no answer in ten minutes. "Nothing for you to do." becomes "Needs you:
@@ -100,7 +100,7 @@ func (c Condition) When(event string) time.Time {
 	return time.Time{}
 }

-// SubjectWords is the subject as a person reads it: "machine ace", "plan 41", "provider keycloak".
+// SubjectWords is the subject as a person reads it: "machine node-a", "plan 41", "provider keycloak".
 func (c Condition) SubjectWords() string {
 	parts := []string{}
 	if c.Scope != "" {
@@ -145,7 +145,7 @@ func randomRun(text string) (Refusal, bool) {
 }

 // isPath: absolute, home-relative or dot-relative, or two separators deep. A mesh address names one
-// machine and one tool (`ace/postgres.query`) and has one; a ratio ("3/4") has digits only.
+// machine and one tool (`node-a/postgres.query`) and has one; a ratio ("3/4") has digits only.
 func isPath(w string) bool {
 	if w == "" {
 		return false
@@ -162,7 +162,7 @@ func isPath(w string) bool {
 }

 // isHostName: two names or more, the last a top-level one. A condition key's last name is its kind
-// (`machine.ace.silent`), which none of these is.
+// (`machine.node-a.silent`), which none of these is.
 func isHostName(w string) bool {
 	w = strings.ToLower(w)
 	if w == "localhost" {
@@ -675,14 +675,14 @@ func tools(h *Holder, l *listening) []stdio.Tool {
 				"Roles and words only: an address, a path or a secret is refused. Deduplicated, capped and routed " +
 				"like the controller's conditions.",
 			Input: map[string]any{
-				"key":      str("what makes it the same message the next time, e.g. backup.ace.failed"),
+				"key":      str("what makes it the same message the next time, e.g. backup.node-a.failed"),
 				"severity": map[string]any{"type": "string", "enum": []string{Urgent, Warning}},
 				"summary":  str("one line in the mesh's words"),
 				"subject":  str("what it is about: a machine's role, a module, a plan"),
-				"headline": str("a few plain words the operator reads as the title, e.g. backup failed on ace: no ids, keys or commands"),
+				"headline": str("a few plain words the operator reads as the title, e.g. backup failed on node-a: no ids, keys or commands"),
 				"explanation": str("one or two plain sentences: what happened, what it means for the operator, and whether " +
 					"they need to act"),
-				"resolved": str("the one short line said when it is over, e.g. backups run again on ace"),
+				"resolved": str("the one short line said when it is over, e.g. backups run again on node-a"),
 				"clear":    map[string]any{"type": "boolean", "description": "it is over: the message is edited to say so"},
 			},
 			Run: func(a map[string]any) (any, error) {
@@ -696,7 +696,7 @@ func tools(h *Holder, l *listening) []stdio.Tool {
 				"words are, and offering Details like any message. Never escalated, never kept open, never reminded; " +
 				"its own cap of 10 a channel an hour, apart from the conditions' and notify's.",
 			Input: map[string]any{
-				"headline": str("a few plain words the operator reads as the title, e.g. new mail arrived for ace"),
+				"headline": str("a few plain words the operator reads as the title, e.g. new mail arrived for node-a"),
 				"lines":    map[string]any{"type": "array", "items": map[string]any{"type": "string"}, "description": "one or two plain lines"},
 				"subject":  str("what it is about: a machine's role, a module, a plan"),
 			},
@@ -326,7 +326,7 @@ func issueState(is TrackedIssue, now time.Time, loc *time.Location) string {
 	return "nobody is working on it"
 }

-// workerWords is who@node as said: "fix-400 on g14".
+// workerWords is who@node as said: "fix-400 on node-b".
 func workerWords(worker string) string {
 	who, node, ok := strings.Cut(worker, "@")
 	if !ok {
@@ -9,7 +9,7 @@ package main
 //     controller where the condition is made, so every channel says the same thing. A condition from a
 //     controller older than them, or a module's notice without a headline, is said from its summary,
 //     with what the operator cannot read taken out (plainSummary).
-//   - A clearance is one short line: "Resolved: openrazer works again on g14, after 26 min".
+//   - A clearance is one short line: "Resolved: openrazer works again on node-b, after 26 min".
 //   - A reminder, an escalation and a reopening say so in the title, before the same headline.
 //   - Times are the operator's (the setting time-zone; this machine's zone when not given), and said as a
 //     clock time today, a weekday this week, a date before that.
@@ -168,7 +168,7 @@ func fallbackHeadline(r *Record) string {
 	return capital(what) + " on " + about
 }

-// machineOf is the machine a record's subject words name: "machine ace" or "x on ace".
+// machineOf is the machine a record's subject words name: "machine node-a" or "x on node-a".
 func machineOf(subject string) string {
 	if _, on, ok := strings.Cut(subject, " on "); ok {
 		return on
@@ -55,7 +55,7 @@ func tools(monitor Monitor, users func(context.Context) ([]byte, error), written
 			}},
 		{Name: "nats_connections",
 			Description: "Every client connected to the bus, named by the mesh user it is (a machine's host `node.<machine>`, a machine's runtime `<machine>.node-tools`, the controller, a person): address, uptime, round trip, traffic and pending bytes. Narrowed by a user or connection name, sorted by out_bytes (default), in_bytes, pending, msgs or subscriptions.",
-			Input:       map[string]any{"user": str("part of a user or connection name, e.g. g14"), "sort": str("out_bytes, in_bytes, pending, msgs or subscriptions"), "limit": num("at most this many (default 50)")},
+			Input:       map[string]any{"user": str("part of a user or connection name, e.g. node-b"), "sort": str("out_bytes, in_bytes, pending, msgs or subscriptions"), "limit": num("at most this many (default 50)")},
 			Run: func(a map[string]any) (any, error) {
 				connz, err := get("/connz?auth=1&limit=1024")
 				if err != nil {
@@ -115,7 +115,7 @@ func tools(monitor Monitor, users func(context.Context) ([]byte, error), written
 			}},
 		{Name: "nats_users",
 			Description: "The bus's users as the controller composed them — never a password hash. Without a user, each with how many grants it holds; with part of a user's name, its publish and subscribe grants in full.",
-			Input:       map[string]any{"user": str("part of a user name, e.g. g14.node-tools or controller")},
+			Input:       map[string]any{"user": str("part of a user name, e.g. node-b.node-tools or controller")},
 			Run: func(a map[string]any) (any, error) {
 				c, err := conf()
 				if err != nil {
@@ -125,7 +125,7 @@ func tools(monitor Monitor, users func(context.Context) ([]byte, error), written
 			}},
 		{Name: "nats_user_can",
 			Description: "Whether a bus user may publish or subscribe to a subject, and the grant that allows it — the question behind a request that timed out because the bus refused it. Also whether the running server holds it: `in_force` is true only when the user list on the machine allows it and the server reloaded its configuration after that list was written (novox/hq issue 353: a list sent is not a list the bus enforces until it reloads).",
-			Input:       map[string]any{"user": str("the user exactly, e.g. g14.node-tools"), "action": str("publish or subscribe"), "subject": str("a concrete subject, e.g. $KV.claude-code_servers.all.x")},
+			Input:       map[string]any{"user": str("the user exactly, e.g. node-b.node-tools"), "action": str("publish or subscribe"), "subject": str("a concrete subject, e.g. $KV.claude-code_servers.all.x")},
 			Run: func(a map[string]any) (any, error) {
 				c, err := conf()
 				if err != nil {