From dfda6a5af50eea44971aab41206fe9120f2faf1e Mon Sep 17 00:00:00 2001
From: Meta Vens <rwvens@hotmail.com>
Date: Sun, 16 Aug 2026 22:23:28 +0200
Subject: [PATCH] Clarify release provenance ownership

---
 crates/ghostlight-dungeon/build.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/crates/ghostlight-dungeon/build.rs b/crates/ghostlight-dungeon/build.rs
index ca2d5ee..d8427bd 100644
--- a/crates/ghostlight-dungeon/build.rs
+++ b/crates/ghostlight-dungeon/build.rs
@@ -3,6 +3,9 @@ use std::process::Command;
 fn main() {
     println!("cargo:rerun-if-env-changed=GHOSTLIGHT_BUILD_COMMIT");
     println!("cargo:rerun-if-changed=../../.git/HEAD");
+    // Release tooling injects the clean-tree commit. Git discovery is only a
+    // convenience for local builds because Cargo cannot reliably observe a
+    // moving branch ref through `.git/HEAD` alone.
     let commit = std::env::var("GHOSTLIGHT_BUILD_COMMIT")
         .ok()
         .filter(|value| is_commit(value))