@vue-skuilder/db 0.2.16 → 0.2.18

package/dist/index.mjs

@@ -1797,6 +1797,30 @@ var init_SrsDebugger = __esm({
   }
 });
 
+// src/core/navigators/StrategyPressureDebugger.ts
+var StrategyPressureDebugger_exports = {};
+__export(StrategyPressureDebugger_exports, {
+  captureStrategyPressure: () => captureStrategyPressure,
+  clearStrategyPressureDebug: () => clearStrategyPressureDebug,
+  getStrategyPressureDebug: () => getStrategyPressureDebug
+});
+function captureStrategyPressure(snapshot) {
+  snapshots2.set(`${snapshot.source}:${snapshot.courseId}`, snapshot);
+}
+function getStrategyPressureDebug() {
+  return [...snapshots2.values()].sort((a, b) => b.timestamp - a.timestamp);
+}
+function clearStrategyPressureDebug() {
+  snapshots2.clear();
+}
+var snapshots2;
+var init_StrategyPressureDebugger = __esm({
+  "src/core/navigators/StrategyPressureDebugger.ts"() {
+    "use strict";
+    snapshots2 = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/core/navigators/generators/CompositeGenerator.ts
 var CompositeGenerator_exports = {};
 __export(CompositeGenerator_exports, {
@@ -2161,6 +2185,13 @@ function shuffleInPlace(arr) {
     [arr[i], arr[j]] = [arr[j], arr[i]];
   }
 }
+function formatAge(ms) {
+  const minutes = Math.max(0, Math.round(ms / 6e4));
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.round(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  return `${Math.round(hours / 24)}d`;
+}
 function pickTopByScore(cards, limit) {
   return [...cards].sort((a, b) => b.score - a.score || a.cardId.localeCompare(b.cardId)).slice(0, limit);
 }
@@ -2169,6 +2200,7 @@ var init_prescribed = __esm({
   "src/core/navigators/generators/prescribed.ts"() {
     "use strict";
     init_navigators();
+    init_StrategyPressureDebugger();
     init_logger();
     DEFAULT_FRESHNESS_WINDOW = 3;
     DEFAULT_MAX_DIRECT_PER_RUN = 3;
@@ -2245,6 +2277,7 @@ var init_prescribed = __esm({
         const groupRuntimes = [];
         const priorPracticeDebt = progress.practiceDebt ?? {};
         const nextPracticeDebt = {};
+        const practiceDebtsByGroup = /* @__PURE__ */ new Map();
         for (const group of this.config.groups) {
           const runtime = this.buildGroupRuntimeState({
             group,
@@ -2293,7 +2326,7 @@ var init_prescribed = __esm({
             courseId,
             emittedIds
           );
-          const practiceCards = this.buildPracticeCards({
+          const practice = this.buildPracticeCards({
             group,
             courseId,
             emittedIds,
@@ -2306,7 +2339,8 @@ var init_prescribed = __esm({
             priorPracticeDebt,
             nextPracticeDebt
           });
-          emitted.push(...directCards, ...supportCards, ...discoveredSupportCards, ...practiceCards);
+          practiceDebtsByGroup.set(group.id, practice.debts);
+          emitted.push(...directCards, ...supportCards, ...discoveredSupportCards, ...practice.cards);
         }
         nextState.practiceDebt = nextPracticeDebt;
         const hintSummary = this.buildSupportHintSummary(groupRuntimes);
@@ -2322,6 +2356,7 @@ var init_prescribed = __esm({
         } else {
           logger.info("[Prescribed] No hints to emit (no blocked targets or no support tags)");
         }
+        this.capturePressureSnapshot(courseId, groupRuntimes, practiceDebtsByGroup, emitted, hints);
         if (emitted.length === 0) {
           logger.info(
             "[Prescribed] 0 cards emitted (all targets blocked, authored/discovered support candidates exhausted)" + (hints ? " \u2014 boost hints emitted but may not survive filters" : "")
@@ -2383,6 +2418,60 @@ var init_prescribed = __esm({
           supportTags: [...supportTags].sort()
         };
       }
+      /**
+       * Translate this run's per-group runtimes and practice debts into gauges on
+       * the generic strategy-pressure debug channel (rendered by the live session
+       * overlay's "strategy backpressure" section).
+       */
+      capturePressureSnapshot(courseId, groupRuntimes, practiceDebtsByGroup, emitted, hints) {
+        const now = Date.now();
+        const gauges = [];
+        for (const runtime of groupRuntimes) {
+          const group = runtime.group;
+          const window2 = group.freshnessWindowSessions ?? DEFAULT_FRESHNESS_WINDOW;
+          gauges.push({
+            id: `group:${group.id}:target`,
+            label: `${group.id} targets`,
+            multiplier: runtime.pressureMultiplier,
+            max: MAX_TARGET_MULTIPLIER,
+            detail: `${runtime.pendingTargets.length} pending (${runtime.surfaceableTargets.length} surfaceable, ${runtime.blockedTargets.length} blocked) \xB7 sinceSurfaced ${runtime.sessionsSinceSurfaced}/${window2}`,
+            items: runtime.blockedTargets.map((cardId) => ({ label: cardId, value: "blocked" }))
+          });
+          if (runtime.blockedTargets.length > 0) {
+            const mode = runtime.supportCandidates.length > 0 ? "direct-support" : runtime.discoveredSupportCandidates.length > 0 ? "inserted-support" : "boost-only";
+            gauges.push({
+              id: `group:${group.id}:support`,
+              label: `${group.id} support`,
+              multiplier: runtime.supportMultiplier,
+              max: MAX_SUPPORT_MULTIPLIER,
+              detail: `mode=${mode} \xB7 ${runtime.supportTags.length} support tag(s)`,
+              items: runtime.supportTags.map((tag) => ({ label: tag }))
+            });
+          }
+          const debts = practiceDebtsByGroup.get(group.id) ?? [];
+          if (debts.length > 0) {
+            gauges.push({
+              id: `group:${group.id}:practice-debt`,
+              label: `${group.id} practice debt`,
+              multiplier: Math.max(...debts.map((d) => d.multiplier)),
+              max: MAX_PRACTICE_MULTIPLIER,
+              detail: `${debts.length} under-practiced skill(s)`,
+              items: debts.map((d) => ({
+                label: d.tag,
+                value: `\xD7${d.multiplier.toFixed(2)} \xB7 open ${formatAge(now - new Date(d.firstOwedAt).getTime())}`
+              }))
+            });
+          }
+        }
+        captureStrategyPressure({
+          source: "prescribed",
+          courseId,
+          gauges,
+          topScore: emitted.length > 0 ? Math.max(...emitted.map((c) => c.score)) : null,
+          hintsLabel: hints?._label,
+          timestamp: now
+        });
+      }
       parseConfig(serializedData) {
         try {
           const parsed = JSON.parse(serializedData);
@@ -2539,6 +2628,7 @@ var init_prescribed = __esm({
           supportTags: [...supportTags],
           pressureMultiplier,
           supportMultiplier,
+          sessionsSinceSurfaced,
           debugVersion: PRESCRIBED_DEBUG_VERSION
         };
       }
@@ -2671,13 +2761,13 @@ var init_prescribed = __esm({
           nextPracticeDebt
         } = args;
         const patterns = group.practiceTagPatterns ?? [];
-        if (patterns.length === 0) return [];
+        if (patterns.length === 0) return { cards: [], debts: [] };
         const practiceMinCount = group.practiceMinCount ?? DEFAULT_PRACTICE_MIN_COUNT;
         const maxPractice = group.maxPracticeCardsPerRun ?? DEFAULT_MAX_PRACTICE_PER_RUN;
         const practiceTags = [...cardsByTag.keys()].filter(
           (tag) => patterns.some((p) => matchesTagPattern(tag, p)) && this.isUnlockedGatedSkill(tag, hierarchyConfigs, userTagElo, userGlobalElo) && (userTagElo[tag]?.count ?? 0) < practiceMinCount
         );
-        if (practiceTags.length === 0) return [];
+        if (practiceTags.length === 0) return { cards: [], debts: [] };
         const now = Date.now();
         const DAY_MS = 24 * 60 * 60 * 1e3;
         const tagMultiplier = /* @__PURE__ */ new Map();
@@ -2692,6 +2782,11 @@ var init_prescribed = __esm({
           );
           tagMultiplier.set(tag, mult);
         }
+        const debts = practiceTags.map((tag) => ({
+          tag,
+          multiplier: tagMultiplier.get(tag) ?? PRACTICE_BASE_MULT,
+          firstOwedAt: nextPracticeDebt[tag]
+        })).sort((a, b) => b.multiplier - a.multiplier || a.tag.localeCompare(b.tag));
         const practiceCardIds = this.findDiscoveredSupportCards({
           supportTags: practiceTags,
           cardsByTag,
@@ -2700,7 +2795,7 @@ var init_prescribed = __esm({
           excludedIds: emittedIds,
           limit: maxPractice
         });
-        if (practiceCardIds.length === 0) return [];
+        if (practiceCardIds.length === 0) return { cards: [], debts };
         logger.info(
           `[Prescribed] Group '${group.id}' practice: ${practiceTags.length} unlocked under-practiced skill(s), emitting ${practiceCardIds.length} drill card(s)`
         );
@@ -2730,7 +2825,7 @@ var init_prescribed = __esm({
             ]
           });
         }
-        return cards;
+        return { cards, debts };
       }
       /**
        * True for a skill that was *gated and is now reached*: it has at least one
@@ -5407,6 +5502,7 @@ var init_3 = __esm({
       "./PipelineAssembler.ts": () => Promise.resolve().then(() => (init_PipelineAssembler(), PipelineAssembler_exports)),
       "./PipelineDebugger.ts": () => Promise.resolve().then(() => (init_PipelineDebugger(), PipelineDebugger_exports)),
       "./SrsDebugger.ts": () => Promise.resolve().then(() => (init_SrsDebugger(), SrsDebugger_exports)),
+      "./StrategyPressureDebugger.ts": () => Promise.resolve().then(() => (init_StrategyPressureDebugger(), StrategyPressureDebugger_exports)),
       "./defaults.ts": () => Promise.resolve().then(() => (init_defaults(), defaults_exports)),
       "./diversityRerank.ts": () => Promise.resolve().then(() => (init_diversityRerank(), diversityRerank_exports)),
       "./filters/WeightedFilter.ts": () => Promise.resolve().then(() => (init_WeightedFilter(), WeightedFilter_exports)),
@@ -5439,7 +5535,9 @@ __export(navigators_exports, {
   NavigatorRole: () => NavigatorRole,
   NavigatorRoles: () => NavigatorRoles,
   Navigators: () => Navigators,
+  captureStrategyPressure: () => captureStrategyPressure,
   clearSrsBacklogDebug: () => clearSrsBacklogDebug,
+  clearStrategyPressureDebug: () => clearStrategyPressureDebug,
   diversityRerank: () => diversityRerank,
   getActivePipeline: () => getActivePipeline,
   getCardOrigin: () => getCardOrigin,
@@ -5447,6 +5545,7 @@ __export(navigators_exports, {
   getRegisteredNavigatorNames: () => getRegisteredNavigatorNames,
   getRegisteredNavigatorRole: () => getRegisteredNavigatorRole,
   getSrsBacklogDebug: () => getSrsBacklogDebug,
+  getStrategyPressureDebug: () => getStrategyPressureDebug,
   hasRegisteredNavigator: () => hasRegisteredNavigator,
   initializeNavigatorRegistry: () => initializeNavigatorRegistry,
   isFilter: () => isFilter,
@@ -5529,6 +5628,7 @@ var init_navigators = __esm({
     init_diversityRerank();
     init_PipelineDebugger();
     init_SrsDebugger();
+    init_StrategyPressureDebugger();
     init_logger();
     init_();
     init_2();
@@ -7238,6 +7338,8 @@ var init_CouchDBSyncStrategy = __esm({
     CouchDBSyncStrategy = class {
       syncHandle;
       // Handle to cancel sync if needed
+      /** In-flight one-shot hydration pull, so a timed-out pull can be abandoned. */
+      hydrationHandle;
       setupRemoteDB(username) {
         if (username === GuestUsername || username.startsWith(GuestUsername)) {
           return getLocalUserDB(username);
@@ -7252,8 +7354,26 @@ var init_CouchDBSyncStrategy = __esm({
           return this.getUserDB(username);
         }
       }
+      /**
+       * One-shot remote → local pull. Resolves once the local mirror is caught up.
+       *
+       * Pull only: pushing here would upload whatever the local DB happens to hold
+       * before we know what the remote already has, which is the conflict-leaf
+       * problem hydration exists to avoid. Local changes go up when startSync()
+       * takes over.
+       */
+      async hydrate(localDB, remoteDB) {
+        const replication = pouchdb_setup_default.replicate(remoteDB, localDB, {});
+        this.hydrationHandle = replication;
+        try {
+          const info = await replication;
+          return { docsWritten: info.docs_written };
+        } finally {
+          this.hydrationHandle = void 0;
+        }
+      }
       startSync(localDB, remoteDB) {
-        if (localDB !== remoteDB) {
+        if (localDB.name !== remoteDB.name) {
           this.syncHandle = pouchdb_setup_default.sync(localDB, remoteDB, {
             live: true,
             retry: true
@@ -7261,8 +7381,20 @@ var init_CouchDBSyncStrategy = __esm({
         }
       }
       stopSync() {
+        if (this.hydrationHandle) {
+          try {
+            this.hydrationHandle.cancel();
+          } catch (e) {
+            logger.warn(`Failed to cancel hydration pull (continuing anyway): ${e}`);
+          }
+          this.hydrationHandle = void 0;
+        }
         if (this.syncHandle) {
-          this.syncHandle.cancel();
+          try {
+            this.syncHandle.cancel();
+          } catch (e) {
+            logger.warn(`Failed to cancel user sync (continuing anyway): ${e}`);
+          }
           this.syncHandle = void 0;
         }
       }
@@ -7533,6 +7665,19 @@ var init_couch = __esm({
 // src/impl/common/BaseUserDB.ts
 import { Status as Status3 } from "@vue-skuilder/common";
 import moment6 from "moment";
+function withTimeout(p, ms, label) {
+  let timer;
+  return Promise.race([
+    p,
+    new Promise((_resolve, reject) => {
+      timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+    })
+  ]).finally(() => {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+    }
+  });
+}
 function accomodateGuest() {
   logger.log("[funnel] accomodateGuest() called");
   if (typeof localStorage === "undefined") {
@@ -7706,7 +7851,7 @@ async function dropUserFromClassroom(user, classID) {
 async function getUserClassrooms(user) {
   return getOrCreateClassroomRegistrationsDoc(user);
 }
-var log4, BaseUser, userCoursesDoc, userClassroomsDoc;
+var log4, HYDRATION_TIMEOUT_MS, BaseUser, userCoursesDoc, userClassroomsDoc;
 var init_BaseUserDB = __esm({
   "src/impl/common/BaseUserDB.ts"() {
     "use strict";
@@ -7721,6 +7866,7 @@ var init_BaseUserDB = __esm({
     log4 = (s) => {
       logger.info(s);
     };
+    HYDRATION_TIMEOUT_MS = 15e3;
     BaseUser = class _BaseUser {
       static _instance;
       static _initialized = false;
@@ -7749,6 +7895,29 @@ var init_BaseUserDB = __esm({
       writeDB;
       // Database to use for write operations (local-first approach)
       updateQueue;
+      _hydration = { state: "not-required" };
+      /**
+       * How far the local mirror can be trusted. See {@link UserHydrationStatus}.
+       *
+       * Consumers that would otherwise read a 404 as "new user" — onboarding
+       * gates, first-run experiences, progress dashboards — should check for
+       * `failed` and present a retry affordance rather than an empty state.
+       */
+      hydrationStatus() {
+        return { ...this._hydration };
+      }
+      /**
+       * Whether a missing document may be treated as genuinely absent, allowing
+       * callers to create it with defaults.
+       *
+       * False only when hydration failed or is still running: a 404 then may just
+       * mean "not pulled down yet", and materializing a default would both lie to
+       * the user and, once live sync starts, push a rev-1 document that loses to
+       * the real one — silently discarding it.
+       */
+      canMaterializeDefaults() {
+        return this._hydration.state !== "failed" && this._hydration.state !== "hydrating";
+      }
       async createAccount(username, password) {
         if (!this.syncStrategy.canCreateAccount()) {
           throw new Error("Account creation not supported by current sync strategy");
@@ -7866,6 +8035,11 @@ Currently logged-in as ${this._username}.`
         } catch (e) {
           const err = e;
           if (err.status === 404) {
+            if (!this.canMaterializeDefaults()) {
+              throw new Error(
+                `Cannot read course registrations for ${this._username}: the local mirror is unavailable (hydration state '${this._hydration.state}'). Refusing to create an empty registration doc \u2014 that would report an existing user as unregistered, and then lose to their real document once sync resumes.`
+              );
+            }
             await this.localDB.put({
               _id: _BaseUser.DOC_IDS.COURSE_REGISTRATIONS,
               courses: [],
@@ -8108,6 +8282,11 @@ Currently logged-in as ${this._username}.`
         } catch (e) {
           const err = e;
           if (err.name && err.name === "not_found") {
+            if (!this.canMaterializeDefaults()) {
+              throw new Error(
+                `Cannot read config for ${this._username}: the local mirror is unavailable (hydration state '${this._hydration.state}'). Refusing to write a default config over what may be an existing one.`
+              );
+            }
             await this.localDB.put(defaultConfig);
             return this.getConfig();
           } else {
@@ -8181,7 +8360,9 @@ Currently logged-in as ${this._username}.`
           _BaseUser._initialized = true;
           return;
         }
+        this.syncStrategy.stopSync?.();
         this.setDBandQ();
+        await this.hydrateLocalMirror();
         this.syncStrategy.startSync(this.localDB, this.remoteDB);
         this.applyDesignDocs().catch((error) => {
           log4(`Error in applyDesignDocs background task: ${error}`);
@@ -8197,6 +8378,85 @@ Currently logged-in as ${this._username}.`
         });
         _BaseUser._initialized = true;
       }
+      /**
+       * Pull this account's documents into the local mirror, if that hasn't
+       * happened on this device before.
+       *
+       * Runs between setDBandQ() and startSync() — after the handles exist, before
+       * anything can observe an empty local DB or replicate one upward.
+       *
+       * Never throws: a failure is recorded as `failed` state and reported through
+       * hydrationStatus(), because throwing here would abort init() and leave
+       * BaseUser._initialized false forever (BaseUser.instance() polls it with no
+       * ceiling). Callers decide what a failure means for them.
+       */
+      async hydrateLocalMirror() {
+        if (this.localDB.name === this.remoteDB.name || !this.syncStrategy.hydrate) {
+          this._hydration = { state: "not-required" };
+          return;
+        }
+        if (await this.hasHydrationMarker()) {
+          this._hydration = { state: "stale" };
+          return;
+        }
+        this._hydration = { state: "hydrating" };
+        const start = Date.now();
+        try {
+          const { docsWritten } = await withTimeout(
+            this.syncStrategy.hydrate(this.localDB, this.remoteDB),
+            HYDRATION_TIMEOUT_MS,
+            `Hydration of local mirror for ${this._username}`
+          );
+          await this.writeHydrationMarker();
+          this._hydration = {
+            state: "hydrated",
+            docsWritten,
+            durationMs: Date.now() - start
+          };
+          log4(
+            `Hydrated local mirror for ${this._username}: ${docsWritten} docs in ${this._hydration.durationMs}ms`
+          );
+        } catch (e) {
+          this.syncStrategy.stopSync?.();
+          this._hydration = {
+            state: "failed",
+            durationMs: Date.now() - start,
+            error: e instanceof Error ? e.message : String(e)
+          };
+          logger.error(`Failed to hydrate local mirror for ${this._username}:`, e);
+        }
+      }
+      /**
+       * Has a full pull completed on this device for the CURRENT account?
+       *
+       * The marker is a `_local/` document, which never replicates — so its
+       * presence describes this device's mirror and cannot arrive from elsewhere.
+       */
+      async hasHydrationMarker() {
+        try {
+          const marker = await this.localDB.get(HYDRATION_MARKER_ID);
+          return marker.username === this._username;
+        } catch {
+          return false;
+        }
+      }
+      async writeHydrationMarker() {
+        try {
+          let existingRev;
+          try {
+            existingRev = (await this.localDB.get(HYDRATION_MARKER_ID))._rev;
+          } catch {
+          }
+          await this.localDB.put({
+            _id: HYDRATION_MARKER_ID,
+            _rev: existingRev,
+            username: this._username,
+            hydratedAt: (/* @__PURE__ */ new Date()).toISOString()
+          });
+        } catch (e) {
+          logger.warn(`Could not write hydration marker for ${this._username}: ${e}`);
+        }
+      }
       static designDocs = [
         {
           _id: "_design/reviewCards",
@@ -8533,6 +8793,11 @@ Currently logged-in as ${this._username}.`
         } catch (e) {
           const err = e;
           if (err.status === 404) {
+            if (!this.canMaterializeDefaults()) {
+              throw new Error(
+                `Cannot read strategy state '${strategyKey}' for ${this._username}: the local mirror is unavailable (hydration state '${this._hydration.state}').`
+              );
+            }
             return null;
           }
           throw e;
@@ -10052,6 +10317,15 @@ var init_userOutcome = __esm({
   }
 });
 
+// src/core/types/hydration.ts
+var HYDRATION_MARKER_ID;
+var init_hydration = __esm({
+  "src/core/types/hydration.ts"() {
+    "use strict";
+    HYDRATION_MARKER_ID = "_local/hydration";
+  }
+});
+
 // src/core/bulkImport/cardProcessor.ts
 import { Status as Status5 } from "@vue-skuilder/common";
 async function importParsedCards(parsedCards, courseDB, config) {
@@ -10531,6 +10805,7 @@ var init_core = __esm({
     init_user();
     init_strategyState();
     init_userOutcome();
+    init_hydration();
     init_Loggable();
     init_util();
     init_navigators();
@@ -13471,6 +13746,7 @@ mountMixerDebugger();
 init_logger();
 init_PipelineDebugger();
 init_SrsDebugger();
+init_StrategyPressureDebugger();
 
 // src/study/SessionOverlay.ts
 init_logger();
@@ -13561,7 +13837,7 @@ function render() {
     attachHandlers();
     return;
   }
-  overlayEl.innerHTML = headerHtml() + replanHtml(s) + metaHtml(s) + hintsHtml(s.sessionHints) + backlogHtml(s.reviewBacklog) + queueHtml("supplyQ", "supplyQ", s.supplyQ) + queueHtml("failedQ", "failedQ", s.failedQ) + drawnHtml("drawn", s.drawnCards);
+  overlayEl.innerHTML = headerHtml() + replanHtml(s) + metaHtml(s) + hintsHtml(s.sessionHints) + backlogHtml(s.reviewBacklog) + strategyPressureHtml(s.strategyPressure) + queueHtml("supplyQ", "supplyQ", s.supplyQ) + queueHtml("failedQ", "failedQ", s.failedQ) + drawnHtml("drawn", s.drawnCards);
   attachHandlers();
 }
 function attachHandlers() {
@@ -13665,6 +13941,46 @@ function backlogHtml(backlog) {
   }).join("");
   return `<div style="margin-bottom:6px"><div style="color:#93c5fd">review backpressure</div>${rows}</div>`;
 }
+function pressureColor(multiplier, max) {
+  if (multiplier <= 1.001) return "#86efac";
+  if (max !== void 0 && max > 1) {
+    return (multiplier - 1) / (max - 1) >= 0.75 ? "#fca5a5" : "#fcd34d";
+  }
+  return multiplier >= 3 ? "#fca5a5" : "#fcd34d";
+}
+function toggleKey(raw) {
+  return raw.replace(/[^\w:.|-]/g, "_");
+}
+function gaugeHtml(sectionKey, g) {
+  const cap = g.max !== void 0 ? `<span style="opacity:.5">/${g.max}</span>` : "";
+  const detail = g.detail ? ` <span style="opacity:.6">${esc(g.detail)}</span>` : "";
+  let html = `<div style="margin-left:6px">${esc(g.label)} <span style="color:${pressureColor(g.multiplier, g.max)}">\xD7${g.multiplier.toFixed(2)}</span>${cap}${detail}`;
+  const items = g.items ?? [];
+  if (items.length > 0) {
+    const key = toggleKey(`sp|${sectionKey}|${g.id}`);
+    const isOpen = !!expanded[key];
+    const shown = isOpen ? items : items.slice(0, INLINE_THRESHOLD);
+    html += `<div style="margin-left:6px">` + shown.map(
+      (it) => `<div style="white-space:nowrap;opacity:.75">${esc(it.label)}${it.value ? ` <span style="opacity:.6">${esc(it.value)}</span>` : ""}</div>`
+    ).join("");
+    if (items.length > INLINE_THRESHOLD) {
+      const footer = isOpen ? "\u25BE show less" : `\u2026 +${items.length - shown.length} more`;
+      html += `<div data-q="${key}" style="cursor:pointer;opacity:.6">${footer}</div>`;
+    }
+    html += `</div>`;
+  }
+  return html + `</div>`;
+}
+function strategyPressureHtml(list) {
+  if (!list.length) return "";
+  const sections = list.map((s) => {
+    const sectionKey = `${s.source}:${s.courseId.slice(0, 8)}`;
+    const top = s.topScore !== null && s.topScore !== void 0 ? s.topScore.toFixed(2) : "\u2014";
+    const hints = s.hintsLabel ? `<div style="margin-left:6px;opacity:.6">hints: ${esc(s.hintsLabel)}</div>` : "";
+    return `<div style="margin-left:6px"><span style="opacity:.7">${esc(s.source)} \xB7 ${esc(s.courseId.slice(0, 8))}</span> <span style="opacity:.6">top score ${top}</span>` + s.gauges.map((g) => gaugeHtml(sectionKey, g)).join("") + hints + `</div>`;
+  }).join("");
+  return `<div style="margin-bottom:6px"><div style="color:#fdba74">strategy backpressure</div>${sections}</div>`;
+}
 function fmtScore(score) {
   if (score === void 0) return "";
   if (!Number.isFinite(score)) return "REQ";
@@ -13765,6 +14081,24 @@ function snapshotToText(s) {
       );
     }
   }
+  if (s.strategyPressure.length) {
+    lines.push("");
+    lines.push("strategy backpressure:");
+    for (const sp of s.strategyPressure) {
+      const top = sp.topScore !== null && sp.topScore !== void 0 ? sp.topScore.toFixed(2) : "\u2014";
+      lines.push(`  ${sp.source} (${sp.courseId.slice(0, 8)}): top score ${top}`);
+      for (const g of sp.gauges) {
+        const cap = g.max !== void 0 ? `/${g.max}` : "";
+        lines.push(
+          `    ${g.label} \xD7${g.multiplier.toFixed(2)}${cap}${g.detail ? ` \u2014 ${g.detail}` : ""}`
+        );
+        for (const it of g.items ?? []) {
+          lines.push(`      ${it.label}${it.value ? ` (${it.value})` : ""}`);
+        }
+      }
+      if (sp.hintsLabel) lines.push(`    hints: ${sp.hintsLabel}`);
+    }
+  }
   const queueText = (label, q) => {
     lines.push("");
     lines.push(`${label}: ${q.length} (drawn ${q.dequeueCount})`);
@@ -13802,6 +14136,7 @@ var MAX_HISTORY = 5;
 function clearStaleSessionDebugState() {
   clearRunHistory();
   clearSrsBacklogDebug();
+  clearStrategyPressureDebug();
 }
 function startSessionTracking(supplyQLength, failedQLength) {
   const sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
@@ -14490,6 +14825,7 @@ var SessionController = class _SessionController extends Loggable {
       supplyQ: describe(this.supplyQ),
       failedQ: describe(this.failedQ),
       reviewBacklog: getSrsBacklogDebug(),
+      strategyPressure: getStrategyPressureDebug(),
       drawnCards
     };
   }
@@ -15175,6 +15511,7 @@ export {
   ENV,
   FileSystemError,
   GuestUsername,
+  HYDRATION_MARKER_ID,
   Loggable,
   NOT_SET,
   NavigatorRole,
@@ -15190,8 +15527,10 @@ export {
   areQuestionRecords,
   buildStrategyStateId,
   captureMixerRun,
+  captureStrategyPressure,
   clearSrsBacklogDebug,
   clearStaleSessionDebugState,
+  clearStrategyPressureDebug,
   computeDeviation,
   computeEffectiveWeight,
   computeOutcomeSignal,
@@ -15214,6 +15553,7 @@ export {
   getRegisteredNavigatorNames,
   getRegisteredNavigatorRole,
   getSrsBacklogDebug,
+  getStrategyPressureDebug,
   getStudySource,
   hasRegisteredNavigator,
   importParsedCards,