From 396cb08f8180964b55cbc504aabd5d2fee17c19f Mon Sep 17 00:00:00 2001 From: "@permadeath.com" Date: Sat, 5 Sep 2026 19:21:10 -0400 Subject: [PATCH] docs(README): clarify that matches are not guaranteed deterministic The README claimed SDS determinism is guaranteed with the same seed, contradicting the documented behavior in SeededRandom.java. Matches are not fully deterministic despite seeding; only individual decisions are. Co-Authored-By: Claude Haiku 4.5 Change-Id: I7aada800dab552ca6d22ea8ae38347f3787db5af --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 435db3c..e09b7a7 100644 --- a/README.md +++ b/README.md @@ -45,9 +45,9 @@ SDS makes decisions at both unit and force levels using machine learning. Howeve SDS also ships with a live viewer for its decisions, which can be run alongside a match to visualize how the bot understands the current match and what decision it plans to make next. -### SDS is deterministic and reproducible. +### SDS is reproducible. -Two instances of SDS playing each other on the same scenario with the same seed should be _guaranteed_ to replay to the same outcome, regardless of factors like parallelism or system load. +SDS decisions are deterministic — the same observation yields the same decision. However, matches are not guaranteed to replay identically with the same seed; see `bridge/sds/SeededRandom.java` for what seeding guarantees and what it does not. ## Design -- 2.51.2