@serfab/cadre-core 1.17.0 → 1.19.0

package/src/strand-move.ts

@@ -284,8 +284,8 @@ function settledStrands(report: StrandMoveReport): SettledStrands {
 }
 
 /**
- * Seat one strand, in the order the adopting node's strand watcher demands. The watcher polls
- * `Strand` and `JoinedStrand` every five seconds and launches, or offers, a new row at once; a
+ * Seat one strand, in the order the adopting node's strand watcher demands. The watcher runs
+ * on every change to `Strand` and `JoinedStrand` and launches, or offers, a new row at once; a
  * closed strand's founder launch resolves the party key and, finding none, mints a fresh one,
  * which would found the strand a second time under a stranger's identity. So the party key is
  * seated before the row, and the strand's peers (its saved routing table and carried addresses)
@@ -313,6 +313,9 @@ async function adoptStrand(
 			await node.ensureStrandPartyKey(strandId, entry.partyKey, approval.sign);
 		}
 		if (entry.kind === 'own') {
+			// NOTE: with the party key seated first, a closed strand's founding transaction is refused
+			// on `StrandPartyKey.Id` and written again without a key: a local refusal, no extra commit.
+			// If moves of many closed strands get slow, let publishStrand take a known party key.
 			await node.publishStrand(strandId, entry.row.Type, entry.row.MemberPrivateKey ?? undefined, approval.sign);
 		} else {
 			await seatJoinedStrand(database, approval, entry.row, live.joined);