driggsby 0.2.3 → 0.2.4

package/dist/dev/host-page.js

@@ -82,12 +82,56 @@ export const HOST_PAGE_JS = [
     "",
     "let appRoute = sanitizeAppRoute(window.location.hash);",
     "",
-    "// URL writes are bounded (leading + one trailing per window) because",
-    "// the frame controls their rate, and each write is guarded: Safari",
-    "// hard-errors on rapid replaceState bursts.",
-    "const ROUTE_WRITE_WINDOW_MS = 1000;",
+    "// URL writes are bounded because the frame controls their rate, but",
+    "// ordinary clicking should not feel the bound — a token bucket does",
+    "// both, matching the production host: a flurry of up to 15",
+    "// navigations writes instantly, sustained clicking faster than one",
+    "// per 600ms then paces at 600ms, and a frame spamming routes drains",
+    "// the bucket and degrades to paced trailing writes that still land",
+    "// the final state. Burst (15) plus refills (one per 600ms = 50 per",
+    "// 30s) tops out at 65 writes per 30s, leaving at least ~35 of",
+    "// Safari's ~100-per-30s per-document replaceState budget for the",
+    "// host page's own writes. Keep these two constants identical to the",
+    "// production host's; nothing pins them across the two codebases.",
+    "const ROUTE_WRITE_BUCKET_CAPACITY = 15;",
+    "const ROUTE_WRITE_REFILL_MS = 600;",
+    "let routeTokens = ROUTE_WRITE_BUCKET_CAPACITY;",
+    "let routeLastRefillMs = Date.now();",
     "let routeWriteTimer = null;",
     "",
+    "function refillRouteTokens() {",
+    "  const now = Date.now();",
+    "  // A backward clock step would otherwise strand the refill mark in",
+    "  // the future and stall every write until the clock caught back up.",
+    "  if (now < routeLastRefillMs) {",
+    "    routeLastRefillMs = now;",
+    "  }",
+    "  const earned = Math.floor((now - routeLastRefillMs) / ROUTE_WRITE_REFILL_MS);",
+    "  if (earned < 1) {",
+    "    return;",
+    "  }",
+    "  routeTokens = Math.min(ROUTE_WRITE_BUCKET_CAPACITY, routeTokens + earned);",
+    "  routeLastRefillMs += earned * ROUTE_WRITE_REFILL_MS;",
+    "}",
+    "",
+    "function takeRouteToken() {",
+    "  refillRouteTokens();",
+    "  if (routeTokens < 1) {",
+    "    return false;",
+    "  }",
+    "  routeTokens -= 1;",
+    "  return true;",
+    "}",
+    "",
+    "function routeRetryDelayMs() {",
+    "  refillRouteTokens();",
+    "  if (routeTokens >= 1) {",
+    "    return 1;",
+    "  }",
+    "  const sinceRefill = Date.now() - routeLastRefillMs;",
+    "  return Math.min(ROUTE_WRITE_REFILL_MS, Math.max(1, ROUTE_WRITE_REFILL_MS - sinceRefill));",
+    "}",
+    "",
     "function writeRouteToUrl() {",
     "  if (window.location.hash === appRoute) {",
     "    return;",
@@ -100,16 +144,33 @@ export const HOST_PAGE_JS = [
     "  }",
     "}",
     "",
+    "function scheduleTrailingRouteWrite() {",
+    "  routeWriteTimer = setTimeout(() => {",
+    "    routeWriteTimer = null;",
+    "    if (takeRouteToken()) {",
+    "      writeRouteToUrl();",
+    "    } else {",
+    "      // The clock can land a hair before the token accrues; wait out",
+    "      // the remainder rather than writing over budget.",
+    "      scheduleTrailingRouteWrite();",
+    "    }",
+    "  }, routeRetryDelayMs());",
+    "}",
+    "",
     "function applyRoute(hash) {",
     "  appRoute = hash;",
     "  if (routeWriteTimer !== null) {",
+    "    return; // the trailing write reads appRoute",
+    "  }",
+    "  // Already mirrored: nothing to write, no token spent on nothing.",
+    "  if (window.location.hash === hash) {",
     "    return;",
     "  }",
-    "  writeRouteToUrl();",
-    "  routeWriteTimer = setTimeout(() => {",
-    "    routeWriteTimer = null;",
+    "  if (takeRouteToken()) {",
     "    writeRouteToUrl();",
-    "  }, ROUTE_WRITE_WINDOW_MS);",
+    "    return;",
+    "  }",
+    "  scheduleTrailingRouteWrite();",
     "}",
     "",
     "function postToApp(message) {",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "driggsby",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Set up and build on Driggsby, the MCP server for personal finance.",
   "license": "Apache-2.0",
   "repository": {
@@ -28,7 +28,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@driggsby/deploy": "0.2.3",
-    "@driggsby/sdk": "0.2.3"
+    "@driggsby/deploy": "0.2.4",
+    "@driggsby/sdk": "0.2.4"
   }
 }