The console reads the assigner's state assignments and imports the contracts' new paths (issue 1966)

Claude-Session: https://claude.ai/code/session_01NcbgfFSnn24M3GcqttoU7i

node-tools/internal/firstview/firstview.go

@@ -1,5 +1,5 @@
 // Package firstview is the tool runner's picture of the four states it reads of the indexer and the assigner: the assigner's
-// placement and seat-holders, the indexer's manifests and modules (novox/hq ADR 0615 §1, §3; ADR 0621 §2; issue 1966 TLS-5).
+// assignments and seat-holders, the indexer's manifests and modules (novox/hq ADR 0615 §1, §3; ADR 0621 §2; issue 1966 TLS-5).
 //
 // **It never reads the owners' state.** At start it asks each owner's first-view tool until answered (the owner answers in a
 // runtime of its own, never through this one: ADR 0621 §1), then follows the owner's views family, one event per changed key;
@@ -32,7 +32,7 @@ const (
 // The names the console reads the four states by (`<owner>.<state>`), as the manifest's `consumes` names their views
 // families (no seat's client names a holder, novox/hq ADR 0625 §4; TestTheFirstViewsAreTheManifestsViews).
 const (
-	PlacementRead   = Assigner + ".placement"
+	AssignmentsRead = Assigner + ".assignments"
 	SeatHoldersRead = Assigner + ".seat-holders"
 	ModulesRead     = Indexer + ".modules"
 	ManifestsRead   = Indexer + ".manifests"
@@ -43,13 +43,13 @@ type Spec struct{ Owner, Tool, State string }
 
 // Specs are the four.
 var Specs = []Spec{
-	{Assigner, "placement", "placement"},
+	{Assigner, "assignments", "assignments"},
 	{Assigner, "seat-holders", "seat-holders"},
 	{Indexer, "manifests", "manifests"},
 	{Indexer, "modules", "modules"},
 }
 
-// Name is the name a state is read by, `<owner>.<state>`: PlacementRead, SeatHoldersRead and the indexer's.
+// Name is the name a state is read by, `<owner>.<state>`: AssignmentsRead, SeatHoldersRead and the indexer's.
 func (s Spec) Name() string { return s.Owner + "." + s.State }
 
 // Views is the four followers.

node-tools/internal/firstview/firstview_integration_test.go

@@ -92,7 +92,7 @@ func TestTheRunnersConsumerCarriesTheOwnersViewsFamiliesWhenTheOwnersAreDownThen
 	t.Cleanup(stop)
 
 	// The owners are down: no tool answers, nothing is claimed, and past the bound each view is a finding.
-	if _, err := v.State(Assigner + ".placement"); err == nil {
+	if _, err := v.State(Assigner + ".assignments"); err == nil {
 		t.Fatal("a state its owner has not answered is claimed")
 	}
 	mt.Until(t, func() error {

node-tools/internal/firstview/firstview_test.go

@@ -28,9 +28,9 @@ type owners struct {
 }
 
 func newOwners() *owners {
-	return &owners{state: map[string]map[string]string{"placement": {"anchor": `{"p":1}`}, "seat-holders": {"seat": `{"h":1}`},
+	return &owners{state: map[string]map[string]string{"assignments": {"anchor": `{"p":1}`}, "seat-holders": {"seat": `{"h":1}`},
 		"manifests": {"d1": `{"m":1}`}, "modules": {"web": `{"w":1}`}},
-		rev: map[string]uint64{"placement": 4, "seat-holders": 2, "manifests": 7, "modules": 3}, asked: map[string]int{}, finds: map[string]bool{}}
+		rev: map[string]uint64{"assignments": 4, "seat-holders": 2, "manifests": 7, "modules": 3}, asked: map[string]int{}, finds: map[string]bool{}}
 }
 
 func (o *owners) ask(address string, _ any) (json.RawMessage, error) {
@@ -104,7 +104,7 @@ func TestTheRunnerHoldsTheFourStatesFromTheOwnersFirstViewsAndTheirEvents(t *tes
 	defer stop()
 
 	// Down: nothing is claimed, and past the bound each unanswered view is a finding.
-	if _, err := v.State("mesh-delivery-assigner.placement"); err == nil || !strings.Contains(err.Error(), "not been answered") {
+	if _, err := v.State("mesh-delivery-assigner.assignments"); err == nil || !strings.Contains(err.Error(), "not been answered") {
 		t.Fatalf("a state its owner has not answered is claimed: %v", err)
 	}
 	eventually(t, "no finding past the bound", func() bool { o.mu.Lock(); defer o.mu.Unlock(); return len(o.finds) == 4 })
@@ -124,31 +124,31 @@ func TestTheRunnerHoldsTheFourStatesFromTheOwnersFirstViewsAndTheirEvents(t *tes
 
 	// Events: the next revision is applied; an old one passed over; a deletion removes; none of it asks again.
 	asked := func(tool string) int { o.mu.Lock(); defer o.mu.Unlock(); return o.asked[tool] }
-	before := asked("placement")
-	o.say(t, "placement", "laptop", `{"p":2}`, 5, false)
-	o.say(t, "placement", "laptop", `{"p":0}`, 5, false)
-	o.say(t, "placement", "anchor", "", 6, false)
+	before := asked("assignments")
+	o.say(t, "assignments", "laptop", `{"p":2}`, 5, false)
+	o.say(t, "assignments", "laptop", `{"p":0}`, 5, false)
+	o.say(t, "assignments", "anchor", "", 6, false)
 	// (a deleted mark carries no value: Deleted is the encoding's, set below)
-	if got, _ := v.Entry("mesh-delivery-assigner.placement", "laptop"); string(got) != `{"p":2}` {
+	if got, _ := v.Entry("mesh-delivery-assigner.assignments", "laptop"); string(got) != `{"p":2}` {
 		t.Errorf("the next revision is not applied: %q", got)
 	}
-	if n := asked("placement"); n != before {
+	if n := asked("assignments"); n != before {
 		t.Errorf("an event in order asked the first view again (%d asks, was %d)", n, before)
 	}
 
 	// A gap (revision 9 where 7 was next) asks the first view once more, said in the log.
-	o.say(t, "placement", "x", `{"p":9}`, 9, false)
-	eventually(t, "a gap did not ask the first view again", func() bool { return asked("placement") > before })
+	o.say(t, "assignments", "x", `{"p":9}`, 9, false)
+	eventually(t, "a gap did not ask the first view again", func() bool { return asked("assignments") > before })
 
 	// The status says owner, tool, revision and the asks; the hand ask asks every view again.
-	var placement views.Status
+	var assignments views.Status
 	for _, s := range v.Status() {
-		if s.State == "placement" {
-			placement = s
+		if s.State == "assignments" {
+			assignments = s
 		}
 	}
-	if placement.Owner != "mesh-delivery-assigner" || placement.Tool != "placement" || placement.Asks < 2 || placement.Answered.IsZero() {
-		t.Errorf("the status of placement is %+v", placement)
+	if assignments.Owner != "mesh-delivery-assigner" || assignments.Tool != "assignments" || assignments.Asks < 2 || assignments.Answered.IsZero() {
+		t.Errorf("the status of assignments is %+v", assignments)
 	}
 	manifests := asked("manifests")
 	if errs := v.Again(context.Background(), "doubted"); len(errs) != 0 {
@@ -181,7 +181,7 @@ func TestTheFirstViewsAreTheManifestsViews(t *testing.T) {
 	if err := json.Unmarshal(raw, &m); err != nil {
 		t.Fatal(err)
 	}
-	want := map[string]bool{PlacementRead: true, SeatHoldersRead: true, ModulesRead: true, ManifestsRead: true}
+	want := map[string]bool{AssignmentsRead: true, SeatHoldersRead: true, ModulesRead: true, ManifestsRead: true}
 	for _, s := range Specs {
 		if !want[s.Name()] {
 			t.Errorf("the first view %s is read by no name here", s.Name())