From: Jérôme Benoit <jerome.benoit@sap.com>
Date: Thu, 7 May 2026 08:57:20 +0000 (+0200)
Subject: docs(sandcastle): fix stale JSDoc referencing empty string sentinel
X-Git-Tag: cli@v4.7.0~21
X-Git-Url: https://git.piment-noir.org/?a=commitdiff_plain;h=dc6de0ec81fd87a4e71b09091899cf96d4facee3;p=e-mobility-charging-stations-simulator.git

docs(sandcastle): fix stale JSDoc referencing empty string sentinel
---

diff --git a/.sandcastle/refinement-loop.ts b/.sandcastle/refinement-loop.ts
index b82275a1..e3f12080 100644
--- a/.sandcastle/refinement-loop.ts
+++ b/.sandcastle/refinement-loop.ts
@@ -233,9 +233,9 @@ export async function runRefinementLoop (
 }
 
 /**
- * Captures the current HEAD SHA, returning empty string on failure.
+ * Captures the current HEAD SHA, returning null on failure.
  * @param cwd - Working directory for git operations.
- * @returns The HEAD SHA or empty string.
+ * @returns The HEAD SHA or null.
  */
 async function captureHeadSha (cwd: string): Promise<null | string> {
   try {
@@ -631,7 +631,7 @@ async function runCritic (
 /**
  * Returns true if the best-state reset should be applied after the loop.
  * @param status - Final loop status.
- * @param bestSha - Best intermediate SHA (empty string if none captured).
+ * @param bestSha - Best intermediate SHA (null if none captured).
  * @returns True if reset should be applied.
  */
 function shouldResetToBest (status: LoopStatus, bestSha: null | string): boolean {