@vue-skuilder/db 0.2.16 → 0.2.17

package/dist/core/index.mjs

@@ -1644,6 +1644,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, {
@@ -2008,6 +2032,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);
 }
@@ -2016,6 +2047,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;
@@ -2092,6 +2124,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,
@@ -2140,7 +2173,7 @@ var init_prescribed = __esm({
             courseId,
             emittedIds
           );
-          const practiceCards = this.buildPracticeCards({
+          const practice = this.buildPracticeCards({
             group,
             courseId,
             emittedIds,
@@ -2153,7 +2186,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);
@@ -2169,6 +2203,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" : "")
@@ -2230,6 +2265,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);
@@ -2386,6 +2475,7 @@ var init_prescribed = __esm({
           supportTags: [...supportTags],
           pressureMultiplier,
           supportMultiplier,
+          sessionsSinceSurfaced,
           debugVersion: PRESCRIBED_DEBUG_VERSION
         };
       }
@@ -2518,13 +2608,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();
@@ -2539,6 +2629,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,
@@ -2547,7 +2642,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)`
         );
@@ -2577,7 +2672,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
@@ -5254,6 +5349,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)),
@@ -5286,7 +5382,9 @@ __export(navigators_exports, {
   NavigatorRole: () => NavigatorRole,
   NavigatorRoles: () => NavigatorRoles,
   Navigators: () => Navigators,
+  captureStrategyPressure: () => captureStrategyPressure,
   clearSrsBacklogDebug: () => clearSrsBacklogDebug,
+  clearStrategyPressureDebug: () => clearStrategyPressureDebug,
   diversityRerank: () => diversityRerank,
   getActivePipeline: () => getActivePipeline,
   getCardOrigin: () => getCardOrigin,
@@ -5294,6 +5392,7 @@ __export(navigators_exports, {
   getRegisteredNavigatorNames: () => getRegisteredNavigatorNames,
   getRegisteredNavigatorRole: () => getRegisteredNavigatorRole,
   getSrsBacklogDebug: () => getSrsBacklogDebug,
+  getStrategyPressureDebug: () => getStrategyPressureDebug,
   hasRegisteredNavigator: () => hasRegisteredNavigator,
   initializeNavigatorRegistry: () => initializeNavigatorRegistry,
   isFilter: () => isFilter,
@@ -5376,6 +5475,7 @@ var init_navigators = __esm({
     init_diversityRerank();
     init_PipelineDebugger();
     init_SrsDebugger();
+    init_StrategyPressureDebugger();
     init_logger();
     init_();
     init_2();
@@ -8416,7 +8516,9 @@ export {
   aggregateOutcomesForGradient,
   areQuestionRecords,
   buildStrategyStateId,
+  captureStrategyPressure,
   clearSrsBacklogDebug,
+  clearStrategyPressureDebug,
   computeDeviation,
   computeEffectiveWeight,
   computeOutcomeSignal,
@@ -8433,6 +8535,7 @@ export {
   getRegisteredNavigatorNames,
   getRegisteredNavigatorRole,
   getSrsBacklogDebug,
+  getStrategyPressureDebug,
   getStudySource,
   hasRegisteredNavigator,
   importParsedCards,