The node agent begins again composing its own when the catalogue places its node, with no restart (issue 1126, ADR 0549 §4)

cmd/mesh-host/nodeagent.go

@@ -496,12 +496,18 @@ func nodeAgent(ctx context.Context, opts options, signer ed25519.PublicKey, sess
 		}
 		// The node composes its own modules once the catalogue places it (novox/hq ADR 0547 §2, ADR 0549, issue 1126): its
 		// placement key is read at the agent's start; until then it applies the controller's compositions as before.
+		run, stopRun := context.WithCancel(linked)
 		if composer := selfComposer(linked, session, node, say); composer != nil {
 			env.Composed, env.SelfComposed, env.Trusted, env.Policy = composer, true, nil, composer.Policy
+		} else {
+			// And once the catalogue places it, the agent begins again composing its own: the placement key appearing ends
+			// this run, so a node does not wait for a restart to follow the seed of its placement (ADR 0549 §4).
+			go endWhenPlaced(run, session, node, stopRun, say)
 		}
 		ag = agent.New(env)
 		current.set(ag)
-		err = ag.Run(linked)
+		err = ag.Run(run)
+		stopRun()
 		cancel()
 		current.set(nil)
 		if ctx.Err() != nil {
@@ -818,3 +824,25 @@ func selfComposer(ctx context.Context, session *link.Session, node string, say f
 		// And the vault's word that a secret changed, on which it composes again (ADR 0547 §2).
 		Hear: session.Hear})
 }
+
+// endWhenPlaced calls stop once this node's placement key appears in the indexer's placement (a value after the watch
+// caught up, or one already there), so the agent begins again and composes its own. A watch that cannot be made is said;
+// the node then switches at its next start.
+func endWhenPlaced(ctx context.Context, session *link.Session, node string, stop func(), say link.Announce) {
+	key, err := delivery.PlacementKey(node)
+	if err != nil {
+		return
+	}
+	updates, err := bucketWatch{session, delivery.PlacementBucket}.Watch(ctx, key)
+	if err != nil {
+		say("whether the catalogue places this node is not followed (" + err.Error() + "): it composes its own from its next start")
+		return
+	}
+	for u := range updates {
+		if !u.Caught && !u.Deleted && len(u.Value) > 0 {
+			say("the catalogue places this node now (" + key + "): the node agent begins again, composing its own modules")
+			stop()
+			return
+		}
+	}
+}