jackherd 1.1.0 → 1.3.0

package/src/watch/update-available.ts

@@ -0,0 +1,26 @@
+import { latestVersionIfDue, type UpdateCheck } from '../sync/if-changed'
+import { isNewerVersion } from '../version/release'
+
+/** The one line that wakes the coordinator when npm has a newer release; the orchestrate skill asks the user. */
+export const updateAvailableLine = (installed: string, latest: string): string =>
+  `=== update available ${installed} → ${latest}`
+
+/**
+ * The watcher's daily look at npm, on the hook's timestamp and check, so a day holds one registry question across
+ * both. Prints a line only for a newer plain release it has not announced yet; otherwise nothing, so a quiet
+ * day costs no tokens. Call it on every poll: the timestamp decides whether npm is asked at all.
+ */
+export const updateAnnouncer = (
+  home: string,
+  installed: string,
+  check: UpdateCheck,
+  log: (line: string) => void,
+): (() => Promise<void>) => {
+  let announced: string | null = null
+  return async () => {
+    const latest = await latestVersionIfDue(home, check)
+    if (latest === null || latest === announced || !isNewerVersion(latest, installed)) return
+    announced = latest
+    log(updateAvailableLine(installed, latest))
+  }
+}