cc-cream 0.3.4 → 0.3.6

package/CHANGELOG.md

@@ -6,6 +6,23 @@ All notable changes to cc-cream are documented here. Format follows
 
 ## [Unreleased]
 
+## [0.3.6] — 2026-06-04
+
+### Changed
+- **Plugin is now distributed via a lean catalogue repo (`bart-turczynski/claude-plugins`) instead of the full dev repo.** Previously the marketplace pointed at `bart-turczynski/cc-cream`, so every user who registered the marketplace got a full clone of the development repository — `features/`, `fixtures/`, `package-lock.json` (114 KB), `CHANGELOG.md` (31 KB), and the full git history — landing in `~/.claude/plugins/marketplaces/`. The marketplace source is now `bart-turczynski/claude-plugins`, a purpose-built catalogue containing only the plugin payload and `marketplace.json`. The marketplaces clone shrinks from ~1 MB to ~260 KB (irreducible floor: `.git/` + `.claude-plugin/`). Existing installs should remove and re-add the marketplace: `claude plugin marketplace remove bart-turczynski && claude plugin marketplace add bart-turczynski/claude-plugins`.
+
+### Infrastructure
+- Added `.github/workflows/sync-catalogue.yml`: on each GitHub Release, syncs `plugin/` contents to `cc-cream/` in the `bart-turczynski/claude-plugins` catalogue repo so the distribution copy stays current without manual maintenance.
+
+## [0.3.5] — 2026-06-04
+
+### Fixed
+- **`/cc-cream:setup --force` now actually replaces an existing statusLine.** The setup slash command shelled out to `install.js --plugin` but never forwarded `$ARGUMENTS`, so `--force` (and any other flag) was silently dropped — `--force` appeared to do nothing when another tool already owned the statusLine. `commands/setup.md` now passes `$ARGUMENTS` through, matching `uninstall.md`. `install.js` already honored `--force`; only the command wiring was broken.
+- **Plugin install no longer balloons the cache to ~114 MB.** Claude Code's plugin installer runs `npm install` whenever it finds a `package.json` in the cached plugin tree, which pulled the entire devDependency tree (Biome, Cucumber, knip, c8, …) into `~/.claude/plugins/cache/cc-cream/`. The plugin payload now lives in a `plugin/` subdirectory and the marketplace `source` points to `"./plugin"`, so only `plugin/`'s contents (`src/`, `commands/`, `hooks/`, `.claude-plugin/plugin.json`) are copied to the cache — with no `package.json` there, the installer has nothing to install. `package.json`, dev configs, and `marketplace.json` stay at the repo root; npm `bin`/`files` now point at `plugin/src/`. No behavior change to the rendered bar.
+
+### Added
+- **The `peak` segment now shows when the window closes and when the next one opens (CREAM-scwwzbxh).** Inside the faster-drain window it reads `peak until HH:MM` — the close time in your **local** timezone, not PT — so you can see how long the elevated drain lasts. In the hour before the window opens it counts down `peak in Nm`. The new `peak.lead` config key sets how many minutes ahead the countdown appears (default `60`). Previously the segment showed only the bare word `peak` while in-window and nothing otherwise.
+
 ## [0.3.4] — 2026-05-31
 
 ### Changed

package/README.md

@@ -19,7 +19,7 @@ With all segments enabled:
 
 ```
 ctx:21% [43k] | cache:99% | write:2% | ttl:60 | effort:high | think:on | ∿ api:74% | ~$0.23
-5h:13% ↺2h57m | ~3h12m | 7d:6% ↺Sat 21:00 | peak
+5h:13% ↺2h57m | ~3h12m | 7d:6% ↺Sat 21:00 | peak until 11:00
 Sonnet 4.6 | My project session
 ```
 
@@ -35,7 +35,7 @@ Sonnet 4.6 | My project session
 
 **Rate-limit budgets.** `5h` and `7d` show how much of your rolling usage is gone and when each window resets. `burn` adds a live projection based on your current pace — useful before committing to a long agent run.
 
-**Peak hours.** Anthropic's rate-limit drain accelerates Mon–Fri during Pacific business hours. The `peak` segment lights up when you're in that window so you can pace yourself accordingly. No other Claude Code status tool surfaces this.
+**Peak hours.** Anthropic's rate-limit drain accelerates Mon–Fri during Pacific business hours. The `peak` segment tells you when the current window closes (`peak until 11:00`, in your local time) while you're in it, and counts down to the next one (`peak in 47m`) in the hour before it opens — so you can pace yourself or wait it out. No other Claude Code status tool surfaces this.
 
 **Context window.** `ctx` shows occupancy and input-token magnitude. On large-context models where "50% of window" still means 500k tokens, you can set a fixed-token ceiling instead — warnings fire at the same absolute count regardless of window size.
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "cc-cream",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "See cache health, context fill, token burn, rate limits, and peak hours in Claude Code CLI. The status line for tokenminning - cache rules everything around me - dolla, dolla bill, y'all.",
   "directories": {
     "doc": "docs"
   },
   "scripts": {
-    "lint": "biome lint src/ hooks/",
+    "lint": "biome lint plugin/src/ plugin/hooks/",
     "knip": "knip",
-    "validate": "command -v claude >/dev/null 2>&1 && claude plugin validate . || echo 'cc-cream: claude CLI not found — skipping plugin validation'",
+    "validate": "command -v claude >/dev/null 2>&1 && claude plugin validate plugin || echo 'cc-cream: claude CLI not found — skipping plugin validation'",
     "pretest": "npm run lint && npm run knip && npm run validate",
     "test": "cucumber-js",
     "test:manual": "cucumber-js --profile manual",
@@ -23,11 +23,11 @@
     "pre-push": "npm run coverage"
   },
   "bin": {
-    "cc-cream": "src/cc-cream.js",
-    "cc-cream-setup": "src/install.js"
+    "cc-cream": "plugin/src/cc-cream.js",
+    "cc-cream-setup": "plugin/src/install.js"
   },
   "files": [
-    "src/",
+    "plugin/src/",
     "LICENSE",
     "README.md",
     "CHANGELOG.md"

package/{src → plugin/src}/config.js

@@ -48,6 +48,7 @@ const SEGMENT_FIELDS = {
   display: ctxDisplayOr,
   start: hourOr,
   end: hourOr,
+  lead: posOr,
 };
 
 function mergeConfig(parsed) {

package/{src → plugin/src}/defaults.js

@@ -19,10 +19,12 @@ export const DEFAULTS = {
     cost:     { on: true,  row: 1, order: 5 },
     '5h':     { on: true,  row: 2, order: 1, amber: 75, red: 90 },
     '7d':     { on: true,  row: 2, order: 2, amber: 75, red: 90 },
-    // peak: amber "peak" word during Anthropic's faster-drain window (PRDv2 §2).
-    // start/end are Pacific-time hours (0–23, exclusive end); weekday (Mon–Fri)
-    // and the America/Los_Angeles timezone are hardcoded policy facts, not config.
-    peak:     { on: true,  row: 2, order: 3, start: 5, end: 11 },
+    // peak: amber peak-window indicator (PRDv2 §2). start/end are Pacific-time
+    // hours (0–23, exclusive end); weekday (Mon–Fri) and the America/Los_Angeles
+    // timezone are hardcoded policy facts, not config. Inside the window it reads
+    // "peak until HH:MM" (local close time); the `lead` minutes before it opens it
+    // counts down "peak in Nm".
+    peak:     { on: true,  row: 2, order: 3, start: 5, end: 11, lead: 60 },
     burn:         { on: true,  row: 2, order: 1.5 },
     effort:       { on: false, row: 1, order: 6 },
     thinking:     { on: false, row: 1, order: 7 },

package/{src → plugin/src}/segments.js

@@ -1,4 +1,4 @@
-import { band, countdown, flipPct, fmtNum, isNum, isPeak, numOr, pad2 } from './utils.js';
+import { band, countdown, flipPct, fmtNum, isNum, localHM, numOr, pad2, peakStatus } from './utils.js';
 import { hasWindow } from './ttl.js';
 
 function magnitudeTokens(cw) {
@@ -125,8 +125,12 @@ function segCacheWrite(data) {
 function segPeak(data, cfg, now, tz) {
   // peak rides the account-budget row, so it shows only when that row has windows.
   if (!hasWindow(data?.rate_limits)) return null;
-  if (!isPeak(now, cfg, tz)) return null;
-  return { text: 'peak', color: 'amber' };
+  const st = peakStatus(now, cfg, tz);
+  if (!st) return null;
+  const text = st.state === 'approaching'
+    ? `peak in ${st.startsInMin}m`        // counting down to the window opening
+    : `peak until ${localHM(st.endsAtMs)}`; // inside it: local clock time it closes
+  return { text, color: 'amber' };
 }
 
 function segBurn(fiveHour, prev, now) {

package/{src → plugin/src}/utils.js

@@ -75,24 +75,48 @@ export const flipPct = (consumedShown, cfg) => (
   cfg.percentage === 'remaining' ? 100 - consumedShown : consumedShown
 );
 
-// True during Anthropic's faster-drain "peak" window (PRDv2 §2): a weekday
-// (Mon–Fri) within [start, end) Pacific-time hours.
-export function isPeak(now, cfg, tz = 'America/Los_Angeles') {
+// Resolve the "peak" window (PRDv2 §2) relative to `now`. Anthropic drains the
+// 5h budget faster on weekdays (Mon–Fri) within [start, end) Pacific-time hours.
+// Returns one of:
+//   { state: 'in',          endsAtMs }    — inside [start, end); endsAtMs is the
+//                                           window close as an epoch (format local)
+//   { state: 'approaching', startsInMin } — inside [start-lead, start)
+//   null                                  — off-window, weekend, or Intl failure
+// `lead` (minutes, default 60) is how early the approaching countdown appears.
+export function peakStatus(now, cfg, tz = 'America/Los_Angeles') {
   const s = cfg?.segments?.peak ?? {};
   const start = isNum(s.start) ? s.start : 5;
   const end = isNum(s.end) ? s.end : 11;
+  const lead = isNum(s.lead) && s.lead > 0 ? s.lead : 60;
   try {
     const parts = new Intl.DateTimeFormat('en-US', {
-      timeZone: tz, hour: 'numeric', hour12: false, weekday: 'short',
+      timeZone: tz, hour: 'numeric', minute: 'numeric', hour12: false, weekday: 'short',
     }).formatToParts(new Date(now));
     const p = Object.fromEntries(parts.map((x) => [x.type, x.value]));
-    const hour = Number(p.hour) % 24; // some ICU builds emit "24" for midnight
-    return !['Sat', 'Sun'].includes(p.weekday) && hour >= start && hour < end;
+    if (['Sat', 'Sun'].includes(p.weekday)) return null;
+    const ptMin = (Number(p.hour) % 24) * 60 + Number(p.minute); // some ICU builds emit "24" for midnight
+    const startMin = start * 60;
+    const endMin = end * 60;
+    if (ptMin >= startMin && ptMin < endMin) {
+      return { state: 'in', endsAtMs: now + (endMin - ptMin) * 60000 };
+    }
+    if (ptMin >= startMin - lead && ptMin < startMin) {
+      return { state: 'approaching', startsInMin: startMin - ptMin };
+    }
+    return null;
   } catch {
-    return false;
+    return null;
   }
 }
 
+// Back-compat predicate: true only inside the window itself (not while approaching).
+export const isPeak = (now, cfg, tz = 'America/Los_Angeles') => peakStatus(now, cfg, tz)?.state === 'in';
+
+// Wall-clock HH:MM in the host's local timezone (TZ-driven, like countdown's day branch).
+export const localHM = (ms) => new Date(ms).toLocaleTimeString(undefined, {
+  hour: '2-digit', minute: '2-digit', hour12: false,
+});
+
 // resets_at - now, on the §4.4 format ladder: >=1d -> "Fri 23:45", >=1h -> HhMMm, else MMm.
 export function countdown(resetsAt, now) {
   const t = toEpochMs(resetsAt);