Function noticeFrom

src/upgrade/update-check.ts:141–153

(cache: UpdateCheckCacheFile | null, d: ResolvedDeps)

}

function noticeFrom(cache: UpdateCheckCacheFile | null, d: ResolvedDeps): string | null {
  if (!cache?.latest) return null;
  // A dev build whose package.json couldn't be read reports the sentinel
  // version; any comparison against it would always claim an update.
  if (d.currentVersion === '0.0.0-unknown') return null;
  // Canonicalize BOTH sides before comparing or rendering — a non-semver
  // `latest` (garbage redirect, tampered cache) yields no notice at all
  // rather than flowing into agent-visible text.
  const latest = canonicalVersionTag(cache.latest);
  const current = canonicalVersionTag(d.currentVersion);
  if (!latest || !current) return null;
  return isUpdateAvailable(current, latest) ? formatUpdateNotice(current, latest) : null;
}

function cacheIsFresh(cache: UpdateCheckCacheFile | null, nowMs: number): boolean {
  if (!cache) return false;