NATS3 (part, branch-independent): which module sends, and a catalog entry read for the bus module

Sends reads a claim of a seat whose definition has a verb or an event, or an event of its own; AsksOf reads
an entry's bus-state asks and claims. The follower's branch and the wiring wait on the design's answer.

Builds: design 47 G §344, §433

Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
2026-11-11 12:23:40 +01:00
parent fc90e6c67b
commit 6062feaa22
4 changed files with 131 additions and 0 deletions
@@ -14,6 +14,7 @@ import (
occ "git.novox.be/novox/mesh-contracts/operator-and-conversation/go/clients/operatorchannelclient"
oc "git.novox.be/novox/mesh-contracts/operator-and-conversation/go/seats/operatorchannel"
"git.novox.be/novox/mesh-sdk/go/catalogue"
"git.novox.be/novox/mesh-sdk/go/seatdef"
)
// fakeBus holds objects by stream, as a bus would, and refuses what a test tells it to.
@@ -794,3 +795,31 @@ func TestTheKeeperMakesWhatAVerdictAsksForAndSaysIt(t *testing.T) {
})
}
}
func TestSends(t *testing.T) {
defs := map[string]seatdef.Definition{
"verbed": {Verbs: []seatdef.Verb{{Name: "go"}}},
"evented": {Events: []seatdef.Message{{Name: "done"}}},
"included": {Includes: []string{"part"}},
"bare": {},
}
for _, c := range []struct {
name string
claims []string
own bool
want bool
}{
{"a seat with a verb", []string{"verbed"}, false, true},
{"a seat with an event", []string{"evented"}, false, true},
{"a seat that includes parts", []string{"included"}, false, true},
{"a seat with neither", []string{"bare"}, false, false},
{"a seat the list does not hold", []string{"unknown"}, false, false},
{"an event of its own", nil, true, true},
{"nothing claimed", nil, false, false},
{"one of two claims sends", []string{"bare", "verbed"}, false, true},
} {
if got := Sends(c.claims, c.own, defs); got != c.want {
t.Errorf("%s: Sends = %v, want %v", c.name, got, c.want)
}
}
}
+17
View File
@@ -16,6 +16,7 @@ import (
"git.novox.be/novox/mesh-sdk/go/buscompose"
"git.novox.be/novox/mesh-sdk/go/catalogue"
"git.novox.be/novox/mesh-sdk/go/membership"
"git.novox.be/novox/mesh-sdk/go/seatdef"
)
// The kinds of bus object an entry is made of: a stream, a key-value bucket (stream KV_<name>) and an object store
@@ -48,6 +49,22 @@ const (
SentAgeDays = 7
)
// Sends says whether a module sends (design 47 G §344): it claims a seat whose definition has a verb or an event, or it
// declares an event of its own (emitsOwn). claims are the seats its catalog graph entry claims, defs the seat list's
// definitions by seat; a claimed seat the list does not hold counts for nothing. A definition that includes parts takes
// their verbs and events whole (seatdef.Resolve), so one counts as having some.
func Sends(claims []string, emitsOwn bool, defs map[string]seatdef.Definition) bool {
if emitsOwn {
return true
}
for _, c := range claims {
if d, ok := defs[c]; ok && (len(d.Verbs) > 0 || len(d.Events) > 0 || len(d.Includes) > 0) {
return true
}
}
return false
}
// Settings are one bus object's settings, as asked and as held: what check compares.
type Settings struct {
// MaxBytes is its cap in bytes; MaxAgeSeconds its age, 0 for none.