@drakulavich/cogload 0.12.3 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,26 @@ All notable changes to this project are documented here. The format follows
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.13.0] - 2026-10-09
9
+
10
+ ### Added
11
+ - `status` writes `restAt`, when the running streak reaches 40 minutes, and
12
+ `restMin`, how long a rest must be to end it. (#192)
13
+ - Each score names the parts at their cap (`capped`) and the one closest to
14
+ it (`top`). (#192)
15
+
16
+ ### Changed
17
+ - The live index counts the streak running now and cools after a break:
18
+ 10 minutes away keep about half of the load from before, 20 minutes keep
19
+ none. (#192)
20
+ - The `cognitive-load` plugin 0.10.0 takes every number from cogload, so the
21
+ band, `/cogload` and the rest no longer disagree. It needs cogload 0.13.0
22
+ and says so once if an older one is installed. (#192)
23
+
24
+ ### Fixed
25
+ - Right after a rest, `/cogload` no longer says a short streak is at the
26
+ cap. (#187)
27
+
8
28
  ## [0.12.3] - 2026-10-07
9
29
 
10
30
  ### Changed
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@drakulavich/cogload",
3
- "version": "0.12.3",
3
+ "version": "0.13.0",
4
4
  "description": "Keep your head cold. A thermometer for your Claude Code days: every hour scored 0 to 100 from the transcripts already on your disk. Nothing leaves your machine.",
5
5
  "license": "MIT",
6
6
  "author": "Anton Yakutovich",
@@ -10,7 +10,7 @@ import type { Day } from "../lib/types.ts";
10
10
  import type { Args } from "./args.ts";
11
11
 
12
12
  export async function table(a: Args, now: Date, cache: TranscriptCache | null, timing?: Timing): Promise<number> {
13
- const days: Day[] = await report({ projects: a.projects, to: a.to, days: a.days, now }, timing, cache);
13
+ const days: Day[] = await report({ projects: a.projects, to: a.to, days: a.days, now, streakFrom: streakFrom(now) }, timing, cache);
14
14
  const data = a.command === "day" ? days[0] : days;
15
15
  const text = a.json ? renderJson(data!) : a.command === "day" ? renderDay(days[0]!, { explain: a.explain, color: a.color }) : renderWeek(days, a.color);
16
16
  // Not console.log: in Bun 1.4.2, once process.stdout is touched (isTTY in parseArgs), console.log into a pipe stops at 64 KiB.
@@ -1,10 +1,13 @@
1
- import { score } from "./score.ts";
2
- import type { Day, Event, EventKind, HourBucket, LiveBucket, Metrics, Totals, Window } from "../types.ts";
1
+ import { fractionsOf, NORMS, score, scoreOf } from "./score.ts";
2
+ import type { Day, Event, EventKind, HourBucket, LiveBucket, Metrics, Part, Totals, Window } from "../types.ts";
3
3
 
4
4
  const LOOKBACK_MS = 3 * 60 * 60 * 1000;
5
5
  export const GAP_MS = 10 * 60 * 1000;
6
6
  const SLOT_MS = 5 * 60 * 1000;
7
7
  const LIVE_MS = 60 * 60 * 1000;
8
+ // The reader contract's ceiling for activeMin and streakMin (status file spec):
9
+ // a reader treats a larger value as no data, so a longer streak is written as this.
10
+ export const MAX_STREAK_MIN = 1500;
8
11
  const LATE_HOURS = new Set([23, 0, 1, 2, 3, 4, 5]);
9
12
 
10
13
  // Not localeCompare: a result must not depend on the locale.
@@ -83,11 +86,11 @@ function accumulate(a: Acc, e: Event, streakStart: number): void {
83
86
 
84
87
  // `lateNight` is the caller's: an hour's own label, or the hour of `now` for the
85
88
  // live bucket. A fresh accumulator is an empty hour and scores null.
86
- function finish(a: Acc, lateNight: boolean): LiveBucket {
89
+ function finish(a: Acc, lateNight: boolean, streakMin = Math.round(a.maxStreakMs / 60000)): LiveBucket {
87
90
  const m = a.m;
88
91
  m.sessions = a.sessions.size;
89
92
  m.activeMin = a.slots.size * 5;
90
- m.streakMin = Math.round(a.maxStreakMs / 60000);
93
+ m.streakMin = streakMin;
91
94
  m.decisions = m.interrupts + m.rejects + m.questions + m.plans + m.modeSwitches;
92
95
  m.lateNight = lateNight;
93
96
  return { ...m, score: score(m) };
@@ -134,10 +137,10 @@ function foldEvents(sorted: Event[], startMs: number): { acc: Map<string, Acc>;
134
137
  // runs from the first event, so a streak older than the window is measured from
135
138
  // where it began. Events before the day's start count here, unlike in a bucket:
136
139
  // the window is a clock's hour, not a calendar's.
137
- function foldLive(sorted: Event[], nowMs: number): Acc {
140
+ function foldLive(sorted: Event[], nowMs: number, sinceMs = -Infinity): Acc {
138
141
  const a = newAcc();
139
142
  const fromMs = nowMs - LIVE_MS;
140
- const inWindow = (t: number): boolean => t > fromMs && t <= nowMs;
143
+ const inWindow = (t: number): boolean => t > fromMs && t >= sinceMs && t <= nowMs;
141
144
  let prevPresenceTs: number | null = null;
142
145
  let streakStart = 0;
143
146
  for (const e of sorted) {
@@ -152,6 +155,25 @@ function foldLive(sorted: Event[], nowMs: number): Acc {
152
155
  return a;
153
156
  }
154
157
 
158
+ // statusOf reads this streakMin; a break before the streak cools the score.
159
+ function liveBucket(sorted: Event[], presenceTs: number[], presence: Day["presence"], nowMs: number, lateNight: boolean): LiveBucket {
160
+ const lastMs = presence ? Date.parse(presence.lastAt) : null;
161
+ const startMs = lastMs !== null && nowMs - lastMs <= GAP_MS ? Date.parse(presence!.streakStartAt) : null;
162
+ const streakMin = startMs === null ? 0 : Math.min(MAX_STREAK_MIN, Math.round((nowMs - startMs) / 60000));
163
+ const full = finish(foldLive(sorted, nowMs), lateNight, streakMin);
164
+ if (full.score === null) return full;
165
+ const f = fractionsOf(full);
166
+ const after = startMs === null ? null : fractionsOf(finish(foldLive(sorted, nowMs, startMs), lateNight, streakMin));
167
+ const breakFrom = startMs === null ? lastMs : presenceTs.findLast((t) => t < startMs);
168
+ const w = breakFrom == null ? 0 : Math.max(0, 1 - ((startMs ?? nowMs) - breakFrom) / (NORMS.coolMin * 60_000));
169
+ const cooled = { ...f };
170
+ for (const p of Object.keys(f) as Part[]) {
171
+ const a = after?.[p] ?? 0;
172
+ cooled[p] = a + w * (f[p] - a);
173
+ }
174
+ return { ...full, score: scoreOf(cooled) };
175
+ }
176
+
155
177
  function buildDay(date: string, acc: Map<string, Acc>): Day {
156
178
  const buckets: HourBucket[] = [];
157
179
  // Hours run in time order, so the last write is the day's last action.
@@ -214,7 +236,8 @@ export function derive(events: Event[], w: Window): Day[] {
214
236
  const open = days.find((d) => d.date === today);
215
237
  if (open) {
216
238
  open.asOf = w.now.toISOString();
217
- open.live = finish(foldLive(sorted, w.now.getTime()), LATE_HOURS.has(w.now.getHours()));
239
+ const presenceTs = read.filter((e) => PRESENCE.has(e.kind)).map((e) => e.ts);
240
+ open.live = liveBucket(sorted, presenceTs, open.presence, w.now.getTime(), LATE_HOURS.has(w.now.getHours()));
218
241
  }
219
242
  }
220
243
  return days;
@@ -1,3 +1,3 @@
1
1
  export { analyze, analyzeEvents } from "./analyze.ts";
2
- export { GAP_MS, localDate, windowBounds } from "./derive.ts";
2
+ export { GAP_MS, localDate, MAX_STREAK_MIN, windowBounds } from "./derive.ts";
3
3
  export { levelOf, NORMS, score, WEIGHTS } from "./score.ts";
@@ -1,9 +1,9 @@
1
- import type { Level, Metrics, Parts, Score } from "../types.ts";
1
+ import type { Level, Metrics, Part, Parts, Score } from "../types.ts";
2
2
 
3
3
  // Calibration lives here and nowhere else. Integer points of 100, so 0.5 sums
4
4
  // stay exact; norms are the p90 of two weeks on two machines (see CHANGELOG).
5
5
  export const WEIGHTS = { parallel: 25, pace: 15, supervision: 30, reading: 10, streak: 10, late: 10 } as const;
6
- export const NORMS = { parallelSpan: 4, pacePerHour: 20, supervisionPerHour: 45, decisionWeight: 3, readingTokens: 80_000, streakMin: 40 } as const;
6
+ export const NORMS = { parallelSpan: 4, pacePerHour: 20, supervisionPerHour: 45, decisionWeight: 3, readingTokens: 80_000, streakMin: 40, coolMin: 20 } as const;
7
7
  const LEVELS: readonly { max: number; level: Level }[] = [
8
8
  { max: 29, level: "Calm" },
9
9
  { max: 59, level: "Warming" },
@@ -11,6 +11,8 @@ const LEVELS: readonly { max: number; level: Level }[] = [
11
11
  { max: 100, level: "Fried" },
12
12
  ];
13
13
 
14
+ const BY_WEIGHT = (Object.keys(WEIGHTS) as Part[]).sort((a, b) => WEIGHTS[b] - WEIGHTS[a]);
15
+
14
16
  const clamp01 = (x: number): number => Math.min(1, Math.max(0, x));
15
17
 
16
18
  export function levelOf(index: number): Level {
@@ -18,8 +20,13 @@ export function levelOf(index: number): Level {
18
20
  return "Fried";
19
21
  }
20
22
 
23
+ export type Fractions = Record<Part, number>;
24
+
21
25
  export function score(m: Metrics): Score | null {
22
- if (m.sessions === 0) return null;
26
+ return m.sessions === 0 ? null : scoreOf(fractionsOf(m));
27
+ }
28
+
29
+ export function fractionsOf(m: Metrics): Fractions {
23
30
  const parallel = clamp01((m.sessions - 1) / NORMS.parallelSpan);
24
31
  const pace = clamp01(m.prompts / NORMS.pacePerHour);
25
32
  // A decision costs `decisionWeight` reports or session hops; the three share a norm.
@@ -29,6 +36,13 @@ export function score(m: Metrics): Score | null {
29
36
  const reading = clamp01(m.outputTokens / NORMS.readingTokens);
30
37
  const streak = clamp01(m.streakMin / NORMS.streakMin);
31
38
  const late = m.lateNight ? 1 : 0;
39
+ return { parallel, pace, supervision, reading, streak, late };
40
+ }
41
+
42
+ export function scoreOf(fractions: Fractions): Score {
43
+ const { parallel, pace, supervision, reading, streak, late } = fractions;
44
+ const capped = BY_WEIGHT.filter((p) => fractions[p] === 1);
45
+ const top = BY_WEIGHT.reduce((a, b) => (fractions[b] > fractions[a] ? b : a));
32
46
 
33
47
  const raw = {
34
48
  parallel: WEIGHTS.parallel * parallel,
@@ -51,5 +65,5 @@ export function score(m: Metrics): Score | null {
51
65
  const index = Math.round(
52
66
  raw.parallel + raw.pace + raw.supervision + raw.reading + raw.streak + raw.late,
53
67
  );
54
- return { index, level: levelOf(index), parts };
68
+ return { index, level: levelOf(index), parts, capped, top };
55
69
  }
@@ -1,7 +1,7 @@
1
- import { GAP_MS } from "../metrics/index.ts";
1
+ import { GAP_MS, MAX_STREAK_MIN, NORMS } from "../metrics/index.ts";
2
2
  import type { Day, Level } from "../types.ts";
3
3
 
4
- // The status file's nine values. The field order is the file format.
4
+ // The status file's eleven values. The field order is the file format.
5
5
  export type Status = {
6
6
  schema: 1;
7
7
  asOf: string;
@@ -12,17 +12,15 @@ export type Status = {
12
12
  peak: number | null;
13
13
  activeMin: number;
14
14
  streakMin: number;
15
+ restAt: string | null;
16
+ restMin: number;
15
17
  };
16
18
 
17
- // The reader contract's ceiling for activeMin and streakMin (status file spec):
18
- // a reader treats a larger value as no data, so a longer streak is written as this.
19
- const MAX_MIN = 1500;
20
-
21
19
  // How far back `status` reads to find where the live streak began: as far as
22
20
  // the file can show it, and one gap more, so that a streak longer than that
23
- // still reaches past the ceiling and reads as MAX_MIN, not a few minutes under.
21
+ // still reaches past the ceiling instead of reading a few minutes under it.
24
22
  export function streakFrom(now: Date): Date {
25
- return new Date(now.getTime() - MAX_MIN * 60_000 - GAP_MS);
23
+ return new Date(now.getTime() - MAX_STREAK_MIN * 60_000 - GAP_MS);
26
24
  }
27
25
 
28
26
  // index and level are the day's `live` bucket, not the hour's: an hour's bucket
@@ -33,7 +31,7 @@ export function streakFrom(now: Date): Date {
33
31
  export function statusOf(day: Day, now: Date): Status {
34
32
  const hour = now.getHours();
35
33
  const index = day.live?.score?.index ?? null;
36
- const live = day.presence !== null && now.getTime() - Date.parse(day.presence.lastAt) <= GAP_MS;
34
+ const streakMin = day.live?.streakMin ?? 0;
37
35
  return {
38
36
  schema: 1,
39
37
  asOf: day.asOf ?? now.toISOString(),
@@ -43,7 +41,9 @@ export function statusOf(day: Day, now: Date): Status {
43
41
  level: day.live?.score?.level ?? null,
44
42
  peak: index === null ? day.peak : Math.max(index, day.peak ?? 0),
45
43
  activeMin: day.activeMin,
46
- streakMin: live ? Math.min(MAX_MIN, Math.round((now.getTime() - Date.parse(day.presence!.streakStartAt)) / 60000)) : 0,
44
+ streakMin,
45
+ restAt: streakMin > 0 ? new Date(Date.parse(day.presence!.streakStartAt) + NORMS.streakMin * 60000).toISOString() : null,
46
+ restMin: GAP_MS / 60000,
47
47
  };
48
48
  }
49
49
 
package/src/lib/types.ts CHANGED
@@ -11,7 +11,8 @@ export type Metrics = {
11
11
  };
12
12
  export type Level = "Calm" | "Warming" | "Heating" | "Fried";
13
13
  export type Parts = { parallel: number; pace: number; supervision: number; reading: number; streak: number; late: number }; // weighted points, sum ≈ index
14
- export type Score = { index: number; level: Level; parts: Parts };
14
+ export type Part = keyof Parts;
15
+ export type Score = { index: number; level: Level; parts: Parts; capped: Part[]; top: Part };
15
16
  export type LiveBucket = Metrics & { score: Score | null };
16
17
  export type HourBucket = LiveBucket & { hour: number };
17
18
  export type Totals = { prompts: number; reports: number; outputTokens: number; interrupts: number; rejects: number; questions: number; plans: number; modeSwitches: number; decisions: number; contextSwitches: number; maxSessions: number };