From 469acf53af778a0304dd27c080b838a111204f8a Mon Sep 17 00:00:00 2001
From: Tibsfox <tibsfox@tibsfox.com>
Date: Sun, 5 Apr 2026 11:57:25 -0700
Subject: [PATCH] test(cli): add update diagnostics regression test

---
 src/tests/update-cmd-diagnostics.test.ts | 27 ++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 src/tests/update-cmd-diagnostics.test.ts

diff --git a/src/tests/update-cmd-diagnostics.test.ts b/src/tests/update-cmd-diagnostics.test.ts
new file mode 100644
index 000000000..71fff7b36
--- /dev/null
+++ b/src/tests/update-cmd-diagnostics.test.ts
@@ -0,0 +1,27 @@
+/**
+ * Regression test for #3445: gsd update must print both current and latest
+ * versions for diagnostics, and bypass npm cache.
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+test("update-cmd prints latest version before comparison (#3445)", () => {
+  const src = readFileSync(join(__dirname, "..", "update-cmd.ts"), "utf-8");
+  const latestPrintIdx = src.indexOf("Latest version:");
+  const comparisonIdx = src.indexOf("compareSemver(latest, current)");
+  assert.ok(latestPrintIdx !== -1, "Must print latest version");
+  assert.ok(latestPrintIdx < comparisonIdx, "Must print latest BEFORE comparison");
+});
+
+test("update-cmd bypasses npm cache (#3445)", () => {
+  const src = readFileSync(join(__dirname, "..", "update-cmd.ts"), "utf-8");
+  assert.ok(
+    src.includes("npm_config_cache"),
+    "Must clear npm cache env to bypass stale registry data",
+  );
+});