claude-usage-limits 1.11.6 → 1.11.7

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "usage-limits",
   "displayName": "Usage Limits",
-  "version": "1.11.6",
+  "version": "1.11.7",
   "description": "Puts your remaining Claude Code usage limit into Claude's context before every prompt, so it opens with what fits in the budget instead of starting work that gets cut off. Reports headroom as turns rather than percentages, prices a job before you start it, and detects your plan tier.",
   "author": {
     "name": "Ridelink",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "usage-limits",
-  "version": "1.11.6",
+  "version": "1.11.7",
   "description": "Reports how much of your Codex usage limit is left as turns of work rather than a percentage, prices a job before you start it, and counts the other agents sharing the same budget.",
   "author": {
     "name": "Ridelink",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-usage-limits",
-  "version": "1.11.6",
+  "version": "1.11.7",
   "description": "Puts your remaining Claude Code usage limit into Claude's context before every prompt, so it opens with what fits in the budget instead of starting work that gets cut off. Reports headroom as turns rather than percentages, prices a job before you start it, and detects your plan tier.",
   "keywords": [
     "claude",

package/skills/usage-limits/scripts/brief.js

@@ -59,6 +59,16 @@ const DEFAULTS = {
 // A hook has ten seconds; the reading gets four of them at most.
 const REFRESH_TIMEOUT_MS = 4000;
 
+// Past this much of a per-model week, say how to free it. Below it the advice
+// is noise: there is room, and the model in use is the right one.
+const HALF_SPENT = 50;
+
+// "fable" -> "Fable", the way the account names the window.
+function familyLabel(family) {
+  const name = String(family || '');
+  return name ? name.charAt(0).toUpperCase() + name.slice(1) : name;
+}
+
 // The runway is worth saying long before it is worth acting on, because it is
 // the figure that stops a turn count from flattering. Two hundred turns sounds
 // like plenty and can be twenty minutes when three sessions are spending.
@@ -269,6 +279,10 @@ function pressure(window, now, config, turnsLeft) {
 const CACHED_BINDING_FIELDS = [
   'key',
   'label',
+  // The model family a per-model weekly is scoped to. Read by the line that
+  // says a model switch is the only thing that frees such a window, so it has
+  // to survive the cache like every other field the wording depends on.
+  'family',
   'applies',
   'percentUsed',
   'stale',
@@ -446,6 +460,17 @@ function briefText(parts) {
         'the amount that ran out last time, not a fresh allowance.'
     );
   }
+  // A per-model weekly is the one window effort cannot help with. Nothing you
+  // do more cheaply on this model frees it; only running a different model
+  // does, and that has to be said, because the obvious move at 90 percent is
+  // to drop the effort and keep going, which spends the same window slower.
+  if (parts.family) {
+    sentences.push(
+      'That window counts ' + parts.family + ' turns only, so lowering effort does not free it: ' +
+        'switching model does. Use /model (or scripts/lowpower.js on --model <other>) for work ' +
+        'that does not need ' + parts.family + ', and keep this one for what does.'
+    );
+  }
   if (parts.othersSummary) sentences.push('Other windows: ' + parts.othersSummary + '.');
 
   // A window that is not binding can still be the expensive one to exhaust.
@@ -721,6 +746,12 @@ async function run(now, hookInput) {
         ? usage.formatDuration(now - binding.refusedAt)
         : null,
     binding,
+    // Named only while the window is actually tight: at 20 percent nobody
+    // needs telling how to free it.
+    family:
+      binding && binding.family && Number.isFinite(binding.percentUsed) && binding.percentUsed >= HALF_SPENT
+        ? familyLabel(binding.family)
+        : null,
     othersSummary: view.othersSummary,
     turnsLeft: view.turnsLeft,
     resetsIn: