@blockrun/franklin 3.15.92 → 3.15.93

package/dist/commands/doctor.js

@@ -17,9 +17,17 @@ import os from 'node:os';
 import { setupAgentWallet, setupAgentSolanaWallet, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION, BLOCKRUN_DIR } from '../config.js';
 import { isTelemetryEnabled, readAllRecords } from '../telemetry/store.js';
-import { getAvailableUpdate, kickoffVersionCheck } from '../version-check.js';
+import { getAvailableUpdateFresh, kickoffVersionCheck } from '../version-check.js';
 async function runChecks() {
     const out = [];
+    // Kick off the authoritative version fetch FIRST, in parallel with the
+    // other checks. Doctor is a diagnostic — the user just asked "am I
+    // healthy?" — so a 24h-stale cache is the wrong answer. The fetch is
+    // bounded by the same 2s timeout the background check uses, and falls
+    // back to the cached value on failure. By the time we render the
+    // Franklin-version check below, the fetch has typically settled in
+    // <300ms (npm is fast) and we have a current answer.
+    const freshUpdatePromise = getAvailableUpdateFresh();
     // ── 1. Runtime ────────────────────────────────────────────────────
     const nodeVer = process.versions.node;
     const nodeMajor = parseInt(nodeVer.split('.')[0], 10);
@@ -30,10 +38,10 @@ async function runChecks() {
         remedy: nodeMajor >= 20 ? undefined : 'Upgrade Node.js: https://nodejs.org',
     });
     // ── 2. Franklin version ───────────────────────────────────────────
-    // Kick the daily cache refresh so subsequent doctor runs carry fresh
-    // data. Current run uses whatever's already cached.
+    // Keep kickoffVersionCheck() so non-doctor entry points (banner etc.)
+    // still warm the cache through their normal daily refresh path.
     kickoffVersionCheck();
-    const update = getAvailableUpdate();
+    const update = await freshUpdatePromise;
     out.push({
         name: 'Franklin',
         status: update ? 'warn' : 'ok',

package/dist/version-check.d.ts

@@ -37,3 +37,17 @@ export interface UpdateInfo {
  * background check settles — returns null (we don't speculate).
  */
 export declare function getAvailableUpdate(): UpdateInfo | null;
+/**
+ * Authoritative check that forces a fresh fetch (up to FETCH_TIMEOUT_MS).
+ * Use for on-demand diagnostics like `franklin doctor` where the user
+ * explicitly asked "am I up to date?" and a 24h-stale cache is the wrong
+ * answer. Verified 2026-05-11: between two same-day releases (3.15.91 →
+ * 3.15.92), the daily cache made `franklin doctor` show green for a user
+ * who was actually 4 versions behind (3.15.88), because they ran doctor
+ * in the brief gap between npm publish and the next cache refresh.
+ *
+ * Falls back to the cached value if the fetch fails (offline, slow npm,
+ * etc.) — same behavior as the cached check, just refreshed when
+ * possible.
+ */
+export declare function getAvailableUpdateFresh(): Promise<UpdateInfo | null>;

package/dist/version-check.js

@@ -132,3 +132,30 @@ export function getAvailableUpdate() {
     }
     return null;
 }
+/**
+ * Authoritative check that forces a fresh fetch (up to FETCH_TIMEOUT_MS).
+ * Use for on-demand diagnostics like `franklin doctor` where the user
+ * explicitly asked "am I up to date?" and a 24h-stale cache is the wrong
+ * answer. Verified 2026-05-11: between two same-day releases (3.15.91 →
+ * 3.15.92), the daily cache made `franklin doctor` show green for a user
+ * who was actually 4 versions behind (3.15.88), because they ran doctor
+ * in the brief gap between npm publish and the next cache refresh.
+ *
+ * Falls back to the cached value if the fetch fails (offline, slow npm,
+ * etc.) — same behavior as the cached check, just refreshed when
+ * possible.
+ */
+export async function getAvailableUpdateFresh() {
+    if (isDisabled())
+        return getAvailableUpdate();
+    const latest = await fetchLatestVersion();
+    if (latest) {
+        writeCache({ latestVersion: latest, checkedAt: Date.now() });
+        if (compareSemver(latest, VERSION) > 0) {
+            return { current: VERSION, latest };
+        }
+        return null;
+    }
+    // Fetch failed — fall back to whatever the cache says.
+    return getAvailableUpdate();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.15.92",
+  "version": "3.15.93",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {