royalesim 0.1.11__tar.gz

royalesim-0.1.11/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 RoyaleGym contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This licence does not cover the files under data/raw/, which are Supercell game-data tables
+reproduced for interoperability research. They remain Supercell's property and are not licensed
+by this project.

royalesim-0.1.11/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: royalesim
+Version: 0.1.11
+Requires-Dist: numpy>=2.0 ; extra == 'dev'
+Requires-Dist: msgspec>=0.19 ; extra == 'dev'
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Requires-Dist: hypothesis>=6.100 ; extra == 'dev'
+Requires-Dist: ruff>=0.16 ; extra == 'dev'
+Requires-Dist: mypy>=2.0 ; extra == 'dev'
+Requires-Dist: maturin>=1.15,<2.0 ; extra == 'dev'
+Requires-Dist: opencv-python>=4.10 ; extra == 'oracle'
+Provides-Extra: dev
+Provides-Extra: oracle
+License-File: LICENSE
+Summary: RoyaleSim: deterministic, integer-only Clash Royale battle engine (Rust, PyO3 binding)
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+<p align="center"><img src="docs/media/logo.png" width="128" alt="The RoyaleSim logo: a red crown shield with a white gear on it, outlined in gold"></p><h1 align="center">RoyaleSim</h1>
+
+<p align="center"><a href="https://github.com/RoyaleGym/RoyaleSim/actions/workflows/suite.yml"><img alt="CI" src="https://github.com/RoyaleGym/RoyaleSim/actions/workflows/suite.yml/badge.svg"></a> <img alt="License" src="https://img.shields.io/github/license/RoyaleGym/RoyaleSim?style=flat-square&color=555"> <img alt="Python" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776AB?style=flat-square&logo=python&logoColor=white"> <a href="https://royalegym.github.io/RoyaleGym/"><img alt="Docs" src="https://img.shields.io/badge/docs-royalegym.github.io-8957e5?style=flat-square&logo=readthedocs&logoColor=white"></a> <a href="https://discord.gg/4D2BS5JBHP"><img alt="Discord" src="https://img.shields.io/discord/1551699576304705647?style=flat-square&logo=discord&logoColor=white&label=discord&color=5865F2"></a> <img alt="Last commit" src="https://img.shields.io/github/last-commit/RoyaleGym/RoyaleSim?style=flat-square&color=555"></p>
+
+<p align="center"><img alt="Engine: Rust, whole numbers only" src="https://img.shields.io/badge/engine-Rust%2C%20whole%20numbers%20only-DEA584?style=flat-square&logo=rust&logoColor=white"> <img alt="Tick: 50 ms, 20 per second" src="https://img.shields.io/badge/tick-50%20ms%2C%2020%20per%20second-555?style=flat-square"> <img alt="Coordinates: 18,000 units to one tile" src="https://img.shields.io/badge/coordinates-18%2C000%20per%20tile-555?style=flat-square"></p>
+
+The Clash Royale battle engine your bot plays in. It runs the whole match on your own machine.
+Most people use it through [RoyaleGym](https://github.com/RoyaleGym/RoyaleGym) and never call it directly.
+
+<p align="center"><img src="docs/media/battle-page.gif" width="100%" alt="An engine battle in the RoyaleViser viewer, 18 units on the board"></p>
+
+## Install
+
+```bash
+pip install "royalegym[all]"
+```
+
+That installs this engine and everything else. Use Python 3.12. [Install](https://royalegym.github.io/RoyaleGym/install/) has more.
+
+## Try it
+
+```python
+import json, royalesim
+
+b = royalesim.Battle(card_names=None, slot_of_k=[[0, 1, 2], [0, 1, 2]])
+ids = {row[0]: i for i, row in enumerate(json.loads(b.catalogue_json()))}
+deck = [ids[n] for n in ["Knight", "Archer", "Goblins", "Giant", "Musketeer", "Fireball", "Arrows", "Skeletons"]]
+b.reset(seed=0, decks=[deck, deck], shuffle=1, start_tick=0, elixir_milli=[5000, 5000], tower_hp=None, spawns=[])
+b.step([], 100)                                          # nobody can play in the opening seconds
+r = b.step([(0, 0, 9000 * 18, 10000 * 18)], 20)         # blue plays its first card, then 20 ticks pass
+print(json.loads(b.state_json())["tick"], royalesim.DEPLOY_REASONS[r[0][1]])   # 120 OK
+```
+
+## Next
+
+- The engine's Python API: [API](https://royalegym.github.io/RoyaleGym/repos/royalesim/api/)
+- How it works inside, how fast and how accurate it is, building from source: [Engine](https://royalegym.github.io/RoyaleGym/repos/royalesim/engine/)
+- Questions: [Discord](https://discord.gg/4D2BS5JBHP)
+
+MIT License.
+

royalesim-0.1.11/README.md

@@ -0,0 +1,40 @@
+<p align="center"><img src="docs/media/logo.png" width="128" alt="The RoyaleSim logo: a red crown shield with a white gear on it, outlined in gold"></p><h1 align="center">RoyaleSim</h1>
+
+<p align="center"><a href="https://github.com/RoyaleGym/RoyaleSim/actions/workflows/suite.yml"><img alt="CI" src="https://github.com/RoyaleGym/RoyaleSim/actions/workflows/suite.yml/badge.svg"></a> <img alt="License" src="https://img.shields.io/github/license/RoyaleGym/RoyaleSim?style=flat-square&color=555"> <img alt="Python" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776AB?style=flat-square&logo=python&logoColor=white"> <a href="https://royalegym.github.io/RoyaleGym/"><img alt="Docs" src="https://img.shields.io/badge/docs-royalegym.github.io-8957e5?style=flat-square&logo=readthedocs&logoColor=white"></a> <a href="https://discord.gg/4D2BS5JBHP"><img alt="Discord" src="https://img.shields.io/discord/1551699576304705647?style=flat-square&logo=discord&logoColor=white&label=discord&color=5865F2"></a> <img alt="Last commit" src="https://img.shields.io/github/last-commit/RoyaleGym/RoyaleSim?style=flat-square&color=555"></p>
+
+<p align="center"><img alt="Engine: Rust, whole numbers only" src="https://img.shields.io/badge/engine-Rust%2C%20whole%20numbers%20only-DEA584?style=flat-square&logo=rust&logoColor=white"> <img alt="Tick: 50 ms, 20 per second" src="https://img.shields.io/badge/tick-50%20ms%2C%2020%20per%20second-555?style=flat-square"> <img alt="Coordinates: 18,000 units to one tile" src="https://img.shields.io/badge/coordinates-18%2C000%20per%20tile-555?style=flat-square"></p>
+
+The Clash Royale battle engine your bot plays in. It runs the whole match on your own machine.
+Most people use it through [RoyaleGym](https://github.com/RoyaleGym/RoyaleGym) and never call it directly.
+
+<p align="center"><img src="docs/media/battle-page.gif" width="100%" alt="An engine battle in the RoyaleViser viewer, 18 units on the board"></p>
+
+## Install
+
+```bash
+pip install "royalegym[all]"
+```
+
+That installs this engine and everything else. Use Python 3.12. [Install](https://royalegym.github.io/RoyaleGym/install/) has more.
+
+## Try it
+
+```python
+import json, royalesim
+
+b = royalesim.Battle(card_names=None, slot_of_k=[[0, 1, 2], [0, 1, 2]])
+ids = {row[0]: i for i, row in enumerate(json.loads(b.catalogue_json()))}
+deck = [ids[n] for n in ["Knight", "Archer", "Goblins", "Giant", "Musketeer", "Fireball", "Arrows", "Skeletons"]]
+b.reset(seed=0, decks=[deck, deck], shuffle=1, start_tick=0, elixir_milli=[5000, 5000], tower_hp=None, spawns=[])
+b.step([], 100)                                          # nobody can play in the opening seconds
+r = b.step([(0, 0, 9000 * 18, 10000 * 18)], 20)         # blue plays its first card, then 20 ticks pass
+print(json.loads(b.state_json())["tick"], royalesim.DEPLOY_REASONS[r[0][1]])   # 120 OK
+```
+
+## Next
+
+- The engine's Python API: [API](https://royalegym.github.io/RoyaleGym/repos/royalesim/api/)
+- How it works inside, how fast and how accurate it is, building from source: [Engine](https://royalegym.github.io/RoyaleGym/repos/royalesim/engine/)
+- Questions: [Discord](https://discord.gg/4D2BS5JBHP)
+
+MIT License.

royalesim-0.1.11/crates/royalesim/Cargo.lock

@@ -0,0 +1,254 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "libc"
+version = "0.2.189"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "royalesim"
+version = "0.1.11"
+dependencies = [
+ "pyo3",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.151"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12df2e0110f65b775f769bb17ef989067a1d931b2eb822bd4346631eeada89f9"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

royalesim-0.1.11/crates/royalesim/Cargo.toml

@@ -0,0 +1,53 @@
+[package]
+name = "royalesim"
+version = "0.1.11"
+edition = "2021"
+license = "MIT"
+rust-version = "1.80"
+
+[lib]
+name = "royalesim"
+# cdylib: the Python extension. rlib: so benches/tests and other crates can link it.
+crate-type = ["cdylib", "rlib"]
+
+[features]
+# CHECKOUT DATA: read data/derived/cards.json from the checkout this crate was built in, at run time, when it exists.
+# On for every build from a checkout (cargo test, maturin develop, the gate), so a regenerated card table is picked up
+# without a rebuild. OFF for a wheel (`maturin build --no-default-features`, .github/workflows/wheels.yml): a wheel
+# runs only its compiled-in table, and never a file at a path from the machine that built it.
+default = ["checkout-data"]
+checkout-data = []
+
+[dependencies]
+# abi3-py310: one wheel per platform runs on CPython 3.10 and every later version (the stable ABI).
+pyo3 = { version = "0.22", features = ["extension-module", "abi3-py310"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+
+[profile.release]
+opt-level = 3
+lto = "fat"
+codegen-units = 1
+panic = "abort"
+
+# The determinism profile. Overflow checks stay ON in release, because in an
+# integer engine a silent wrap is a silently wrong battle that no test will
+# attribute to the right cause. The cost is a few percent; the alternative is
+# the class of bug this project cannot afford.
+[profile.release.package.royalesim]
+overflow-checks = true
+
+# The TEST GATE's profile (`cargo test --profile gate`): the release optimisation and the overflow checks, without the
+# fat link. Fat LTO with one codegen unit is for the shipped wheel and exe; every test binary paying for it made the
+# full suite take 45 to 87 minutes. An integer engine's results do not depend on how it is linked, and the gate's own
+# hash_continuity check would show it if they did.
+[profile.gate]
+inherits = "release"
+lto = false
+codegen-units = 16
+
+[profile.gate.package.royalesim]
+overflow-checks = true
+
+[profile.bench]
+inherits = "release"

royalesim-0.1.11/crates/royalesim/build.rs

@@ -0,0 +1,75 @@
+//! Stamp the extension with the source it was built from.
+//!
+//! WHY. The compiled engine is loaded from the venv at runtime, with no checkout around it, so
+//! nothing could answer "was this code the code in the last commit". The data side was already
+//! answerable (the ledger is embedded and compared against the file on disk), and the code side
+//! was not, so a rebuild from a dirty tree was invisible to every guard in the family. On
+//! 2026-09-22 the engine was rebuilt twice from trees with uncommitted changes and no tool could
+//! have said so.
+//!
+//! WHAT IT DOES NOT PROVE. The commit is what `git` reported in the crate directory at build
+//! time. `dirty` covers tracked, modified files under the repo, which is what makes a build
+//! unreproducible in practice; an untracked file that the build reads would not show. When git is
+//! not available at all, both come out "unknown", which a consumer must treat as unknown rather
+//! than as clean.
+
+use std::process::Command;
+
+fn git(args: &[&str]) -> Option<String> {
+    let out = Command::new("git").args(args).output().ok()?;
+    if !out.status.success() {
+        return None;
+    }
+    Some(String::from_utf8_lossy(&out.stdout).trim().to_string())
+}
+
+fn main() {
+    let commit = git(&["rev-parse", "HEAD"]).unwrap_or_else(|| "unknown".into());
+    // Tracked files only. `--porcelain` prints one line per changed path, so empty means clean.
+    let dirty = match git(&["status", "--porcelain", "--untracked-files=no"]) {
+        None => "unknown",
+        Some(s) if s.is_empty() => "clean",
+        Some(_) => "dirty",
+    };
+    println!("cargo:rustc-env=ROYALESIM_BUILD_COMMIT={commit}");
+    println!("cargo:rustc-env=ROYALESIM_BUILD_TREE={dirty}");
+
+    // Rebuild the stamp when HEAD moves. The files are found through git, not at `../../.git`:
+    // in a linked worktree `.git` is a FILE naming the worktree's own directory, so a fixed
+    // `../../.git/HEAD` does not exist there and a commit never re-ran this script. On
+    // 2026-09-26 a wheel built in a worktree right after a commit reported the PARENT commit
+    // and "dirty" (the stamp left by a `cargo check` run before the commit) while holding the
+    // committed code. HEAD and the index live in the worktree's directory (`--git-dir`); the
+    // branch a commit moves lives in the shared one (`--git-common-dir`), as a loose ref or in
+    // packed-refs. Without git (a fresh archive) none of these exist and the stamp keeps its
+    // last value, which is why `provenance()` is documented as best-effort rather than as a
+    // guarantee.
+    let dir = |flag: &str| git(&["rev-parse", "--path-format=absolute", flag]).map(std::path::PathBuf::from);
+    let mut watched = Vec::new();
+    if let Some(d) = dir("--git-dir") {
+        watched.push(d.join("HEAD"));
+        watched.push(d.join("index"));
+    }
+    if let Some(c) = dir("--git-common-dir") {
+        watched.push(c.join("packed-refs"));
+        if let Some(branch) = git(&["symbolic-ref", "-q", "HEAD"]) {
+            watched.push(c.join(branch));
+        }
+    }
+    for path in watched {
+        // A path that does not exist would re-run this script on every build.
+        if path.exists() {
+            println!("cargo:rerun-if-changed={}", path.display());
+        }
+    }
+    // AND WHEN ANY BUILD INPUT CHANGES. Declaring even one `rerun-if-changed` switches OFF
+    // cargo's default of re-running this script on any change in the package, so with only
+    // the two git files above an EDITED-BUT-UNSTAGED source file recompiled the crate and left
+    // this stamp at its previous value. On 2026-09-24 that shipped a wheel containing
+    // uncommitted changes to four files while `provenance()` reported ("a44ef09...", "clean"):
+    // the lie this file exists to prevent, told by the file itself. The sources, the manifest
+    // and the data the crate `include_str!`s all re-stamp now; a directory is scanned whole.
+    for path in ["src", "Cargo.toml", "../../data"] {
+        println!("cargo:rerun-if-changed={path}");
+    }
+}