claude-usage-limits 1.40.2 → 1.40.3

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "usage-limits",
   "displayName": "Usage Limits",
-  "version": "1.40.2",
+  "version": "1.40.3",
   "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.40.2",
+  "version": "1.40.3",
   "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/README.md

@@ -418,6 +418,13 @@ would fire into a session that never stopped. A weekly wall still arms. The
 acknowledgement lapses by itself when the 5-hour window it was made against
 resets.
 
+A deferral is different from a wake, and is treated differently. `defer` is a
+time **you** named, so it is always scheduled — but if you defer to `reset` while
+low-priority is acknowledged, the confirmation says that this session carries
+past the 5-hour reset and waiting for it buys nothing. The mid-turn pulse follows
+the brief onto the weekly too, out of the same function, so the two can never
+report different windows.
+
 **The graceful wrap-up note.** Claude Code can inject its own "finish up"
 instruction at the wall. The mechanism is real, and the gate is
 `tengu_lantern_wick_mode` — the bundle's own normalizer keeps only `"wrap-up"`
@@ -1295,7 +1302,7 @@ test/                             node --test, no dependencies
 node --test
 ```
 
-895 tests over the pricing, the window arithmetic, plan and credit detection,
+901 tests over the pricing, the window arithmetic, plan and credit detection,
 the status line, the before-prompt line, the mid-turn pulse, the after-reply tally and the session history, job forecasting,
 per-project attribution, the Codex reader and its installer, the CLI,
 packaging, the settings save/restore, and what Claude Code's own wall-time

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-usage-limits",
-  "version": "1.40.2",
+  "version": "1.40.3",
   "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/defer.js

@@ -140,7 +140,10 @@ function confirmation(parts) {
   const tail = [];
   tail.push('Nothing has been started');
   if (parts.items) tail.push(parts.items + ' saved');
-  if (parts.resetNote) tail.push(parts.resetNote);
+  // Every note, not only the first: two can apply at once.
+  for (const note of parts.notes && parts.notes.length ? parts.notes : [parts.resetNote]) {
+    if (note) tail.push(note);
+  }
   return line + tail.join('; ') + '. Run "defer cancel" to call it off.';
 }
 
@@ -154,7 +157,7 @@ function bindingReset(now) {
     usage.setHost(host.detect(process.argv.slice(2), process.env));
     const collected = usage.collect(now);
     const utilization = collected && collected.utilization;
-    if (!utilization) return { resetsAt: null, percent: null };
+    if (!utilization) return { resetsAt: null, percent: null, windowKey: null };
     let worst = null;
     for (const key of Object.keys(utilization)) {
       const window = utilization[key];
@@ -163,12 +166,24 @@ function bindingReset(now) {
       if (!Number.isFinite(percent)) continue;
       const resets = Date.parse(window.resets_at);
       if (!worst || percent > worst.percent) {
-        worst = { percent, resetsAt: Number.isFinite(resets) ? resets : null };
+        worst = { percent, resetsAt: Number.isFinite(resets) ? resets : null, windowKey: key };
       }
     }
     return worst || { resetsAt: null, percent: null };
   } catch (err) {
-    return { resetsAt: null, percent: null };
+    return { resetsAt: null, percent: null, windowKey: null };
+  }
+}
+
+// Claude Code only, like every other reader of this fact: /low-priority is its
+// slash command against its account, and Codex files a five-hour window under the
+// same key.
+function lowPriorityAcknowledged(now) {
+  try {
+    if (host.detect(process.argv.slice(2), process.env) !== host.CLAUDE) return false;
+    return Boolean(require('./lowpri.js').readAck(now));
+  } catch (err) {
+    return false;
   }
 }
 
@@ -198,13 +213,29 @@ function plan(options) {
       notes.push('note: that is before the window resets at ' + formatClock(binding.resetsAt));
     }
   }
+  // A deferral is a time the user named, so it is honoured whatever else is
+  // true - unlike an automatic relay wake, which the acknowledgement refuses.
+  // But waiting for a 5-hour reset this session carries straight past is
+  // waiting for nothing, and that is worth one line before the task is
+  // registered rather than after it fires.
+  if (options.lowPriorityAck && binding.windowKey === 'five_hour') {
+    notes.push(
+      'note: you have said /low-priority is on, so this session carries past the 5-hour reset ' +
+        'and waiting for it buys nothing - the weekly is the window that still stops work'
+    );
+  }
   return {
     ok: true,
     at: when.at,
     label: when.label,
     clock: formatClock(when.at),
     in: when.at - now,
+    // resetNote is the first of them, kept because the confirmation and the
+    // tests have always read that field. `notes` is all of them, because there
+    // can now be two and dropping the second would have hidden the one fact
+    // worth printing: that waiting for this reset buys nothing.
     resetNote: notes[0] || null,
+    notes,
   };
 }
 
@@ -256,7 +287,7 @@ function main(argv, now) {
   }
 
   const binding = bindingReset(at);
-  const decided = plan({ now: at, when: first, binding });
+  const decided = plan({ now: at, when: first, binding, lowPriorityAck: lowPriorityAcknowledged(at) });
   if (!decided.ok) return decided.error;
 
   const id = sessionId(args, process.env);
@@ -304,6 +335,7 @@ function main(argv, now) {
     in: decided.in,
     items,
     resetNote: decided.resetNote,
+    notes: decided.notes,
   });
 }
 
@@ -317,4 +349,4 @@ if (require.main === module) {
   }
 }
 
-module.exports = { parseWhen, formatClock, formatSpan, confirmation, plan, status, cancel, main, MINUTE, HOUR };
+module.exports = { lowPriorityAcknowledged, parseWhen, formatClock, formatSpan, confirmation, plan, status, cancel, main, MINUTE, HOUR };