savemytokens 0.2.0

package/dist/report/settings.js

@@ -0,0 +1,237 @@
+import { COLUMNS, HUD_PRESETS, HUD_PRESET_ABOUT, POLICIES as ALL_POLICIES, presetMatching, DEFAULT_COLUMNS, DEFAULT_HUD_SEGMENTS, HUD_SEGMENTS, builtinThemes, loadTheme, paint, paintHead, policyNames, renderSegments, stageText, userThemes, } from "../runtime/kernel.mjs";
+import { clip, padEndVisible, padStartVisible } from "../util/ansi.js";
+export const PRESERVE_KINDS = ["implementation", "tests", "end-to-end checks", "documentation", "exploration"];
+const COLUMN_ABOUT = {
+    allocation: "the share of the window you want this project to get",
+    used: "how much of that allocation it has spent",
+    share: "its part of the tokens measured on disk",
+    tokens: "tokens it burned in this window",
+    priority: "who gets spare capacity first",
+    "last prompt": "the last thing you typed there",
+};
+const SEGMENT_ABOUT = {
+    tag: "SMT, to mark our half of a wrapped status line",
+    project: "the project this session belongs to",
+    target: "its allocation, as a percentage of the window",
+    used: "how much of the window this session has spent",
+    share: "its part of the tokens measured on disk",
+    pair: "used and allocation together, as 21%/50%",
+    bar: "how far through its allocation it is",
+    priority: "HIGH, NORMAL or LOW",
+    "5h": "the 5-hour window Anthropic publishes",
+    "7d": "the weekly window",
+    spend: "a gateway spend limit, when you have one",
+    reset: "how long until the 5-hour window resets",
+    meter5h: "the 5-hour window drawn as a bar",
+    spark: "the shape of the window so far",
+    pace: "how far ahead or behind the clock you are",
+    empty: "when you run dry at this rate",
+};
+export function settingsRows(config) {
+    const rows = [];
+    rows.push({ kind: "header", label: "COLUMNS", hint: "space toggles" });
+    for (const id of COLUMNS)
+        rows.push({ kind: "column", id });
+    rows.push({ kind: "blank" });
+    rows.push({ kind: "header", label: "THEME", hint: "← → changes it" });
+    rows.push({ kind: "theme", surface: "tui" });
+    rows.push({ kind: "theme", surface: "hud" });
+    rows.push({ kind: "blank" });
+    rows.push({ kind: "header", label: "STATUS LINE", hint: "← → picks a shape · space adds or removes a piece" });
+    rows.push({ kind: "preset" });
+    rows.push({ kind: "preview" });
+    const chosen = config.hud?.segments ?? DEFAULT_HUD_SEGMENTS;
+    const rest = HUD_SEGMENTS.filter((id) => !chosen.includes(id));
+    for (const id of [...chosen, ...rest])
+        rows.push({ kind: "segment", id });
+    rows.push({ kind: "blank" });
+    rows.push({ kind: "header", label: "WHEN IT GETS TIGHT", hint: "← → changes it" });
+    rows.push({ kind: "policy" });
+    rows.push({ kind: "pressure" });
+    const policy = ALL_POLICIES[config.policy] ?? ALL_POLICIES.finish;
+    for (const stage of policy?.stages ?? [])
+        rows.push({ kind: "stage", at: stage.at });
+    rows.push({ kind: "blank" });
+    for (let index = 0; index < PRESERVE_KINDS.length; index++)
+        rows.push({ kind: "preserve", index });
+    rows.push({ kind: "advice" });
+    rows.push({ kind: "blank" });
+    rows.push({ kind: "reset" });
+    return rows;
+}
+export function withToggled(list, id) {
+    return list.includes(id) ? list.filter((value) => value !== id) : [...list, id];
+}
+export function withMoved(list, id, delta) {
+    const at = list.indexOf(id);
+    if (at === -1)
+        return list;
+    const to = Math.max(0, Math.min(list.length - 1, at + delta));
+    if (to === at)
+        return list;
+    const next = [...list];
+    const [item] = next.splice(at, 1);
+    if (item)
+        next.splice(to, 0, item);
+    return next;
+}
+export function selectableRows(rows) {
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        if (!["header", "blank", "preview", "pressure"].includes(row.kind))
+            out.push(index);
+    }
+    return out;
+}
+function wrap(text, width) {
+    const out = [];
+    let line = "";
+    for (const word of text.split(" ")) {
+        if (line.length === 0)
+            line = word;
+        else if (line.length + 1 + word.length <= width)
+            line += ` ${word}`;
+        else {
+            out.push(line);
+            line = word;
+        }
+    }
+    if (line)
+        out.push(line);
+    return out;
+}
+function themeNames() {
+    return [...new Set([...builtinThemes(), ...userThemes()])];
+}
+const INDENT = 4;
+function clockAt(ms) {
+    const at = new Date(ms);
+    return `${String(at.getHours()).padStart(2, "0")}:${String(at.getMinutes()).padStart(2, "0")}`;
+}
+function whenStage(at, tight) {
+    if (!(tight.target > 0))
+        return "no allocation";
+    if (tight.pressure >= at / 100)
+        return "now";
+    if (!tight.ratePerHour || tight.ratePerHour <= 0.05)
+        return "not burning";
+    const needed = (at / 100) * tight.target * 100 - tight.usedPoints;
+    const hours = needed / tight.ratePerHour;
+    if (!Number.isFinite(hours) || hours < 0)
+        return "now";
+    if (hours > 12)
+        return "not today";
+    return `~${clockAt(tight.now + hours * 3_600_000)}`;
+}
+export function renderSettings(config, rows, cursor, editing, draft, preview, theme, color, tight, width = 100) {
+    const columns = config.columns ?? DEFAULT_COLUMNS;
+    const segments = config.hud?.segments ?? DEFAULT_HUD_SEGMENTS;
+    const preserve = config.preserveFor.default ?? [];
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const here = index === cursor;
+        const mark = here ? paint(theme, "accent", theme.tui?.cursor ?? "❯", color) : " ";
+        if (row.kind === "blank") {
+            out.push("");
+            continue;
+        }
+        if (row.kind === "header") {
+            out.push(`  ${paintHead(theme, row.label, color)}  ${paint(theme, "dim", clip(row.hint ?? "", Math.max(0, width - row.label.length - 6)), color)}`);
+            continue;
+        }
+        if (row.kind === "preset") {
+            const names = Object.keys(HUD_PRESETS);
+            const current = presetMatching(segments);
+            const at = current ? names.indexOf(current) : -1;
+            const label = current ?? "custom";
+            const about = clip(current ? HUD_PRESET_ABOUT[current] ?? "" : "your own arrangement", Math.max(0, width - 42));
+            out.push(`  ${mark} ${padEndVisible("shape", 15)} ${paint(theme, "dim", "‹", color)} ${paint(theme, "accent", padEndVisible(label, 11), color)} ${paint(theme, "dim", "›", color)} ${paint(theme, "dim", at >= 0 ? `${at + 1}/${names.length}` : "   ", color)}   ${paint(theme, "dim", about, color)}`);
+            continue;
+        }
+        if (row.kind === "preview") {
+            out.push(`${" ".repeat(INDENT)}${renderSegments(segments, preview, loadTheme(config.theme.hud), color)}`);
+            out.push("");
+            continue;
+        }
+        if (row.kind === "column") {
+            const on = columns.includes(row.id);
+            const about = clip(COLUMN_ABOUT[row.id] ?? "", Math.max(0, width - 24));
+            out.push(`  ${mark} ${on ? paint(theme, "ok", "◉", color) : paint(theme, "dim", "○", color)} ${padEndVisible(row.id, 12)} ${paint(theme, "dim", about, color)}`);
+            continue;
+        }
+        if (row.kind === "segment") {
+            const at = segments.indexOf(row.id);
+            const on = at !== -1;
+            const order = on ? paint(theme, "dim", String(at + 1).padStart(2), color) : "  ";
+            const name = padEndVisible(row.id, 9);
+            const about = clip(SEGMENT_ABOUT[row.id] ?? "", Math.max(0, width - 24));
+            out.push(`  ${mark} ${on ? paint(theme, "ok", "◉", color) : paint(theme, "dim", "○", color)} ${order} ${on ? name : paint(theme, "dim", name, color)} ${paint(theme, "dim", about, color)}`);
+            continue;
+        }
+        if (row.kind === "theme") {
+            const names = themeNames();
+            const current = config.theme[row.surface];
+            const at = Math.max(0, names.indexOf(current));
+            const shown = loadTheme(current);
+            const name = `${paint(theme, "dim", "‹", color)} ${paint(theme, "accent", padEndVisible(current, 11), color)} ${paint(theme, "dim", "›", color)}`;
+            const position = paint(theme, "dim", `${at + 1}/${names.length}`, color);
+            const sample = row.surface === "tui"
+                ? `${paint(shown, "accent", shown.tui.cursor ?? "", color)} ${paint(shown, "ok", shown.tui.active ?? "", color)} ${paint(shown, "dim", shown.tui.done ?? "", color)}  ${paint(shown, "ok", (shown.tui.fill ?? "|").repeat(4), color)}${paint(shown, "track", (shown.tui.empty ?? ".").repeat(4), color)}`
+                : renderSegments(["project", "pair", "5h"], preview, shown, color);
+            out.push(`  ${mark} ${padEndVisible(row.surface === "tui" ? "control centre" : "status line", 15)} ${name} ${position}   ${sample}`);
+            continue;
+        }
+        if (row.kind === "pressure") {
+            if (!tight)
+                continue;
+            const rate = tight.ratePerHour && tight.ratePerHour > 0.05 ? `, burning ${tight.ratePerHour.toFixed(1)}% of it an hour` : ", nothing burning";
+            const note = `${tight.label} is at ${Math.round(tight.pressure * 100)}% of its allocation${rate}`;
+            out.push(`${" ".repeat(INDENT)}${paint(theme, "dim", clip(note, Math.max(0, width - INDENT)), color)}`);
+            out.push("");
+            continue;
+        }
+        if (row.kind === "stage") {
+            const policy = ALL_POLICIES[config.policy] ?? ALL_POLICIES.finish;
+            const stage = (policy?.stages ?? []).find((entry) => entry.at === row.at);
+            const passed = tight ? tight.pressure >= row.at / 100 : false;
+            const dot = passed ? paint(theme, "warn", "●", color) : paint(theme, "dim", "○", color);
+            const when = tight ? whenStage(row.at, tight) : "";
+            const head = `${dot} ${padStartVisible(`${row.at}%`, 4)}  ${paint(theme, passed ? "warn" : "dim", padEndVisible(when, 10), color)} ${paint(theme, here ? "accent" : "fg", (stage?.actions ?? []).join(" + "), color)}`;
+            out.push(`  ${mark} ${head}`);
+            if (here && tight) {
+                const text = stageText(row.at, {
+                    target: tight.target,
+                    observed: 0,
+                    pressure: tight.pressure,
+                    basis: "budget",
+                    preserve: tight.preserve,
+                    policy,
+                    custom: tight.custom,
+                });
+                for (const line of wrap(text, Math.max(30, width - INDENT - 8)))
+                    out.push(`${" ".repeat(INDENT + 6)}${paint(theme, "dim", line, color)}`);
+            }
+            continue;
+        }
+        if (row.kind === "reset") {
+            out.push(`  ${mark} ${paint(theme, "warn", "reset everything to defaults", color)}  ${paint(theme, "dim", "columns, themes, status line, policy. Your allocations stay.", color)}`);
+            continue;
+        }
+        if (row.kind === "policy") {
+            const rendered = policyNames()
+                .map((name) => (name === config.policy ? paint(theme, "accent", `[${name}]`, color) : paint(theme, "dim", name, color)))
+                .join(" ");
+            out.push(`  ${mark} ${padEndVisible("policy", 15)} ${rendered}`);
+            continue;
+        }
+        if (row.kind === "preserve") {
+            const kind = PRESERVE_KINDS[row.index] ?? "";
+            const on = preserve.includes(kind);
+            out.push(`  ${mark} ${on ? paint(theme, "ok", "◉", color) : paint(theme, "dim", "○", color)} ${paint(theme, on ? "fg" : "dim", `preserve ${kind}`, color)}`);
+            continue;
+        }
+        const text = editing && here ? `${draft}${paint(theme, "accent", "▏", color)}` : config.customAdvice.default || paint(theme, "dim", "nothing yet, enter writes one", color);
+        out.push(`  ${mark} ${padEndVisible("your own line", 15)} ${text}`);
+    }
+    return out;
+}

package/dist/report/views.js

@@ -0,0 +1,418 @@
+import { visibleRows, workingSet } from "../scheduler/plan.js";
+import { formatCountdown, formatReset, loadMeter, meterBar, paint, paintHead, pressureRole, } from "../runtime/kernel.mjs";
+import { clip, padEndVisible, padStartVisible, visibleWidth } from "../util/ansi.js";
+import { ago, compactNumber } from "../util/fmt.js";
+import { emptyBar, heatStrip, miniSpark, percentLabel, smallBar } from "./graphs.js";
+function barCellsFor(columns) {
+    if (columns >= 130)
+        return 18;
+    if (columns >= 110)
+        return 15;
+    if (columns >= 95)
+        return 12;
+    if (columns >= 80)
+        return 9;
+    return 6;
+}
+const UNATTRIBUTED_FLOOR = 5;
+export function labelsFor(views) {
+    const labels = new Map();
+    for (const view of views)
+        labels.set(view.project, view.label);
+    return labels;
+}
+function capacityRow(control, context) {
+    const { theme, color } = context;
+    const now = control.schedule.now;
+    const published = control.resources.filter((resource) => resource.usedPercent !== null || resource.rolledOver);
+    if (published.length === 0) {
+        const installed = control.installed;
+        const head = installed ? "waiting for the first reading" : "not installed";
+        const tails = installed
+            ? ["· it arrives the next time a Claude session draws its status line", "· wait for a Claude session to draw it", ""]
+            : ["· nothing is live until you run: npx savemytokens install", "· run: npx savemytokens install", ""];
+        for (const tail of tails) {
+            const line = `  ${paint(theme, "warn", head, color)}${tail ? ` ${paint(theme, "dim", tail, color)}` : ""}`;
+            if (visibleWidth(line) <= context.columns)
+                return [line];
+        }
+        return [`  ${paint(theme, "warn", clip(head, context.columns - 2), color)}`];
+    }
+    const levels = [
+        { bar: 12, reset: "clock", gap: 4 },
+        { bar: 12, reset: "long", gap: 4 },
+        { bar: 10, reset: "short", gap: 3 },
+        { bar: 6, reset: "short", gap: 2 },
+        { bar: 0, reset: "none", gap: 2 },
+    ];
+    const build = (level) => {
+        const parts = published.map((resource) => {
+            const used = resource.usedPercent ?? 0;
+            const key = resource.id.split(":")[1] ?? "";
+            const name = key === "five_hour" ? "5h" : key === "seven_day" ? "7d" : "spend";
+            const fresh = resource.usedPercent === null;
+            const countdown = !fresh && resource.window.resetsAt ? formatCountdown(resource.window.resetsAt, now) : "";
+            const reset = !countdown || level.reset === "none"
+                ? ""
+                : level.reset === "clock"
+                    ? ` ${paint(theme, "dim", `resets in ${countdown} (${formatReset(resource.window.resetsAt ?? 0, now)})`, color)}`
+                    : level.reset === "long"
+                        ? ` ${paint(theme, "dim", `resets in ${countdown}`, color)}`
+                        : ` ${paint(theme, "dim", countdown, color)}`;
+            const bar = level.bar > 0 ? ` ${meterBar(theme, used / 100, level.bar, pressureRole(used / 100), color)}` : "";
+            const figure = fresh
+                ? paint(theme, "dim", percentLabel(0), color)
+                : paint(theme, pressureRole(used / 100), percentLabel(used), color);
+            const note = fresh ? ` ${paint(theme, "dim", "window just reset", color)}` : reset;
+            return `${paint(theme, "dim", name, color)}${bar} ${figure}${note}`;
+        });
+        return `  ${parts.join(" ".repeat(level.gap))}`;
+    };
+    for (const level of levels) {
+        const line = build(level);
+        if (visibleWidth(line) <= context.columns)
+            return [line];
+    }
+    return [clip(build(levels[levels.length - 1]), context.columns)];
+}
+const COLUMN_WIDTH = {
+    allocation: 10,
+    used: 15,
+    share: 6,
+    tokens: 7,
+    priority: 8,
+};
+const DROP_ORDER = ["tokens", "share", "priority", "allocation"];
+const MIN_LABEL = 8;
+function columnWidths(context, wanted) {
+    const bar = barCellsFor(context.columns);
+    const usedWidth = bar + 8;
+    const spanOf = (list) => {
+        let total = 3;
+        for (const name of list) {
+            const width = name === "used" ? usedWidth : COLUMN_WIDTH[name];
+            if (width)
+                total += width + 1;
+        }
+        return total;
+    };
+    let columns = [...wanted];
+    for (const drop of DROP_ORDER) {
+        if (spanOf(columns) + MIN_LABEL <= context.columns)
+            break;
+        columns = columns.filter((name) => name !== drop);
+    }
+    const fixed = spanOf(columns);
+    const ideal = Math.min(26, Math.max(14, ...[...context.labels.values()].map((value) => value.length + 2), 14));
+    const room = Math.max(MIN_LABEL, context.columns - fixed);
+    const wantsPrompt = columns.includes("last prompt");
+    const label = Math.max(MIN_LABEL, Math.min(ideal, wantsPrompt ? Math.max(MIN_LABEL, room - 15) : room));
+    const spare = room - label - 1;
+    const prompt = wantsPrompt && spare >= 14 ? spare : 0;
+    return { label, prompt, bar, used: usedWidth, columns };
+}
+function headerRow(context, widths, columns) {
+    const { theme, color } = context;
+    const cells = [`    ${padEndVisible(clip("PROJECT", widths.label - 1), widths.label - 1)}`];
+    if (columns.includes("allocation"))
+        cells.push(padStartVisible("ALLOCATION", 10));
+    if (columns.includes("used"))
+        cells.push(padEndVisible("USED OF IT", widths.used));
+    if (columns.includes("share"))
+        cells.push(padStartVisible("SHARE", 6));
+    if (columns.includes("tokens"))
+        cells.push(padStartVisible("TOKENS", 7));
+    if (columns.includes("priority"))
+        cells.push(padEndVisible("PRIORITY", 8));
+    if (columns.includes("last prompt") && widths.prompt > 0)
+        cells.push(clip("LAST PROMPT", widths.prompt));
+    return paintHead(theme, cells.join(" "), color);
+}
+function row(view, index, context, widths, columns) {
+    const { theme, color } = context;
+    const role = pressureRole(view.pressure.value);
+    const cursor = context.interactive && context.selected === index ? paint(theme, "accent", theme.tui?.cursor ?? "❯", color) : " ";
+    const pin = view.settings.pinned ? paint(theme, "accent", theme.tui?.pin ?? "★", color) : " ";
+    const open = view.bucket === "active";
+    const tone = (want) => (open ? want : "dim");
+    const sessions = view.liveSessions > 1 ? paint(theme, "dim", `${view.liveSessions}`, color) : " ";
+    const label = padEndVisible(paint(theme, tone("fg"), clip(view.label, widths.label - 1), color), widths.label - 1);
+    const held = view.allocation.target > 0 ? view.allocation.target : (view.settings.share ?? 0);
+    const asked = view.settings.share;
+    const squeezed = asked != null && asked - held > 0.005;
+    const allocationCell = padStartVisible(held > 0
+        ? paint(theme, squeezed ? tone("warn") : tone("fg"), percentLabel(held * 100, 5), color)
+        : paint(theme, "dim", view.settings.share === 0 ? "none" : "-", color), 10);
+    const starved = view.allocation.target <= 0;
+    const used = padEndVisible(starved
+        ? `${emptyBar(widths.bar, theme, color)} ${padStartVisible(paint(theme, "dim", open ? "-" : "idle", color), 4)}`
+        : `${smallBar(view.pressure.value, widths.bar, theme, color, tone(role))} ${padStartVisible(paint(theme, tone(role), percentLabel(view.pressure.value * 100, 4), color), 4)}`, widths.used);
+    const share = padStartVisible(paint(theme, "dim", percentLabel(view.observed * 100, 5), color), 6);
+    const tokens = padStartVisible(paint(theme, "dim", compactNumber(view.usage.tokens), color), 7);
+    const priority = padEndVisible(paint(theme, view.settings.priority === "high" ? tone("accent") : "dim", view.settings.priority.toUpperCase(), color), 8);
+    const cells = [`${cursor}${pin}${sessions} ${label}`];
+    if (columns.includes("allocation"))
+        cells.push(allocationCell);
+    if (columns.includes("used"))
+        cells.push(used);
+    if (columns.includes("share"))
+        cells.push(share);
+    if (columns.includes("tokens"))
+        cells.push(tokens);
+    if (columns.includes("priority"))
+        cells.push(priority);
+    if (columns.includes("last prompt") && widths.prompt > 0) {
+        cells.push(paint(theme, "dim", clip(view.prompt || "-", widths.prompt), color));
+    }
+    return cells.join(" ");
+}
+function promptColumn(widths, columns) {
+    let at = 4 + (widths.label - 1);
+    for (const name of columns) {
+        if (name === "last prompt")
+            continue;
+        const width = name === "used" ? widths.used : COLUMN_WIDTH[name];
+        if (width)
+            at += width + 1;
+    }
+    return at + 1;
+}
+function idleHeaderRow(context, widths, columns) {
+    const { theme, color } = context;
+    const head = `    ${padEndVisible("PROJECT", widths.label - 1)} ${padStartVisible("LAST TURN", 10)}`;
+    const gap = Math.min(8, Math.max(2, promptColumn(widths, columns) - visibleWidth(head)));
+    return paintHead(theme, `${head}${" ".repeat(gap)}LAST PROMPT`, color);
+}
+function idleRow(view, index, context, widths, now, columns) {
+    const { theme, color } = context;
+    const cursor = context.interactive && context.selected === index ? paint(theme, "accent", theme.tui?.cursor ?? "❯", color) : " ";
+    const pin = view.settings.pinned ? paint(theme, "accent", theme.tui?.pin ?? "★", color) : " ";
+    const label = padEndVisible(clip(view.label, widths.label - 1), widths.label - 1);
+    const when = padStartVisible(ago(view.lastSeen, now), 10);
+    const reserved = view.settings.share != null && view.settings.share > 0 ? `${percentLabel(view.settings.share * 100, 4)} held` : "";
+    const tag = view.settings.parked ? "parked" : reserved;
+    const head = `${label} ${when}`;
+    const gap = Math.min(8, Math.max(2, promptColumn(widths, columns) - 4 - visibleWidth(head)));
+    const room = Math.max(10, context.columns - 4 - visibleWidth(head) - gap - (tag ? tag.length + 2 : 0));
+    const prompt = padEndVisible(clip(view.prompt || "-", room), tag ? room : 0);
+    return `${cursor}${pin}  ${paint(theme, "dim", `${head}${" ".repeat(gap)}${prompt}${tag ? `  ${tag}` : ""}`, color)}`;
+}
+function footerNote(control, context) {
+    const { theme, color } = context;
+    const set = workingSet(control.schedule, context.expanded);
+    const open = set.members.filter((view) => view.bucket === "active");
+    const sessions = open.reduce((sum, view) => sum + view.liveSessions, 0);
+    const spare = Math.round(control.schedule.unusedPool * 100);
+    const room = Math.max(10, context.columns - 2);
+    const waiting = set.members.length - open.length;
+    const long = `${open.length} of ${set.members.length} open, across ${sessions} ${sessions === 1 ? "session" : "sessions"}${waiting > 0 ? `, ${waiting} waiting` : ""}${spare > 0 ? `, ${spare}% unclaimed` : ""}.`;
+    const short = `${open.length}/${set.members.length} open · ${sessions}s${spare > 0 ? ` · ${spare}% spare` : ""}`;
+    const out = [`  ${paint(theme, "dim", long.length <= room ? long : short, color)}`];
+    const drift = control.unattributed ?? 0;
+    if (drift >= UNATTRIBUTED_FLOOR) {
+        const head = `${Math.round(drift)}% of the window was spent outside these projects`;
+        const tail = "from claude.ai, another machine, or usage SaveMyTokens was not running for";
+        const fits = head.length + 1 + tail.length <= room;
+        out.push(`  ${paint(theme, "warn", clip(head, room), color)}${fits ? ` ${paint(theme, "dim", tail, color)}` : ""}`);
+    }
+    return out;
+}
+function sectionTitle(name, count, context) {
+    const { theme, color } = context;
+    return `  ${paintHead(theme, name, color)} ${paint(theme, "dim", String(count), color)}`;
+}
+export function planRows(control, context) {
+    const set = workingSet(control.schedule, context.expanded);
+    const columns = control.config.columns ?? [];
+    const widths = columnWidths(context, columns);
+    const shown = widths.columns;
+    const now = control.schedule.now;
+    const out = [...capacityRow(control, context)];
+    let index = 0;
+    let printed = 0;
+    const budget = context.expanded ? Number.MAX_SAFE_INTEGER : Math.max(6, context.rows - 15);
+    out.push("");
+    if (set.members.length === 0) {
+        out.push(`  ${paint(context.theme, "dim", "Nothing sharing the window yet. Open Claude Code in a project, or press a on one below.", context.color)}`);
+    }
+    else {
+        out.push(sectionTitle("ACTIVE", set.members.length, context));
+        out.push(headerRow(context, widths, shown));
+        for (const view of set.members) {
+            if (printed < budget)
+                out.push(row(view, index, context, widths, shown));
+            index += 1;
+            printed += 1;
+        }
+    }
+    if (set.candidates.length > 0) {
+        out.push("");
+        out.push(sectionTitle("RECENT", set.candidates.length, context));
+        out.push(idleHeaderRow(context, widths, shown));
+        for (const view of set.candidates) {
+            if (printed < budget)
+                out.push(idleRow(view, index, context, widths, now, shown));
+            index += 1;
+            printed += 1;
+        }
+    }
+    const total = set.members.length + set.candidates.length + set.hidden;
+    if (total > printed) {
+        out.push(`  ${paint(context.theme, "dim", `+${total - printed} more`, context.color)}`);
+    }
+    out.push("");
+    out.push(...footerNote(control, context));
+    return out;
+}
+export function detailRows(control, context) {
+    const { theme, color } = context;
+    const rows = visibleRows(control.schedule, context.expanded);
+    const view = rows[Math.max(0, Math.min(context.selected, rows.length - 1))];
+    if (!view)
+        return [`  ${paint(theme, "dim", "nothing to show", color)}`];
+    const width = Math.min(46, Math.max(20, context.columns - 26));
+    const strip = Math.min(66, Math.max(20, context.columns - 10));
+    const from = control.schedule.bounds.from;
+    const to = control.schedule.bounds.to;
+    const live = view.bucket === "active";
+    const buckets = view.sessions.flatMap((session) => loadMeter(control.provider.id, session.claimant.id).buckets);
+    const at = Math.max(0, Math.min(context.selected, rows.length - 1));
+    const walk = rows.length > 1 ? `   ${at + 1}/${rows.length} · ↑↓ moves to the next project` : "";
+    const out = [
+        `  ${paint(theme, "accent", view.label, color)} ${paint(theme, "dim", `· ${view.bucket}${view.settings.pinned ? " · pinned" : ""}${view.settings.parked ? " · parked" : ""} · ${view.settings.priority}${walk}`, color)}`,
+        `  ${paint(theme, "dim", clip(view.project, context.columns - 4), color)}`,
+        "",
+    ];
+    if (live) {
+        out.push(`  ${paint(theme, "dim", "allocation", color)} ${meterBar(theme, view.allocation.target, width, "accent", color)} ${percentLabel(view.allocation.target * 100)}`);
+        out.push(`  ${paint(theme, "dim", "used of it", color)} ${smallBar(view.pressure.value, width, theme, color, pressureRole(view.pressure.value))} ${percentLabel(view.pressure.value * 100)}`);
+    }
+    else {
+        out.push(`  ${paint(theme, "dim", `nothing running. Last turn ${ago(view.lastSeen, control.schedule.now)}, holding no allocation`, color)}`);
+    }
+    out.push("");
+    out.push(`  ${paint(theme, "dim", "of the window", color)} ${percentLabel(view.attributedPercent ?? 0)} ${paint(theme, "dim", `· ${percentLabel(view.observed * 100)} of measured tokens · ${compactNumber(view.usage.tokens)} tokens · ${view.usage.requests} requests`, color)}`);
+    out.push("");
+    out.push(`  ${paint(theme, "dim", "when it burned", color)}`);
+    out.push(`  ${heatStrip(buckets, from, to, strip, theme, color)}`);
+    out.push(`  ${paint(theme, "accent", miniSpark(buckets, from, to, strip), color)}`);
+    out.push(`  ${paint(theme, "dim", `${new Date(from).toTimeString().slice(0, 5)}${" ".repeat(Math.max(1, strip - 11))}${new Date(to).toTimeString().slice(0, 5)}`, color)}`);
+    out.push("");
+    out.push(`  ${paint(theme, "accent", `SESSIONS ${view.sessions.length}`, color)}`);
+    for (const session of view.sessions.slice(0, 8)) {
+        const alive = session.bucket === "active";
+        const mark = paint(theme, alive ? "ok" : "dim", alive ? "•" : "·", color);
+        const when = alive
+            ? paint(theme, "dim", `${percentLabel(session.allocation.target * 100)} of the window`, color)
+            : paint(theme, "dim", ago(session.claimant.lastSeen, control.schedule.now), color);
+        out.push(`    ${mark} ${padEndVisible(session.claimant.id.slice(0, 8), 9)} ${padEndVisible(when, 18)} ${paint(theme, "dim", clip(session.claimant.prompt || "-", context.columns - 36), color)}`);
+        if (!alive) {
+            out.push(`      ${paint(theme, "dim", clip(`claude --resume ${session.claimant.id}`, context.columns - 8), color)}`);
+        }
+    }
+    const deferred = control.deferred.find((group) => group.project === view.project);
+    if (deferred && deferred.items.length > 0) {
+        out.push("");
+        out.push(`  ${paint(theme, "warn", "deferred here", color)}`);
+        for (const item of deferred.items.slice(-4))
+            out.push(`    ${paint(theme, "dim", clip(item.text, context.columns - 8), color)}`);
+    }
+    return out;
+}
+const HELP_KEYS = [
+    ["↑ ↓", "select a project"],
+    ["⏎", "open it and see its sessions, esc comes back"],
+    ["← →", "move its allocation by 5 points"],
+    ["u", "unset this target: back to an even split with the rest"],
+    ["e", "unset every target at once"],
+    ["p", "priority: high → normal → low, who gets spare capacity first"],
+    ["space", "move it up: hidden to RECENT, RECENT to ACTIVE"],
+    ["x", "move it down: ACTIVE to RECENT, RECENT to hidden"],
+    ["f", "pin the row to the top of the list"],
+    ["d", "mark it done: hands its unspent share to the others now"],
+    ["b n", "mark it blocked, or needs-more"],
+    ["m", "show every project, not just the first screenful"],
+    ["s", "settings: columns, theme, status line, what to protect"],
+    ["r", "read everything again now"],
+    ["? q", "this help · quit"],
+];
+function helpSection(title, context) {
+    return ["", `  ${paintHead(context.theme, title.toUpperCase(), context.color)}`, ""];
+}
+function helpProse(text, context) {
+    const { theme, color } = context;
+    const room = Math.max(24, context.columns - 6);
+    const out = [];
+    let line = "";
+    for (const word of text.split(" ")) {
+        if (line.length === 0)
+            line = word;
+        else if (line.length + 1 + word.length <= room)
+            line += ` ${word}`;
+        else {
+            out.push(`    ${paint(theme, "dim", line, color)}`);
+            line = word;
+        }
+    }
+    if (line)
+        out.push(`    ${paint(theme, "dim", line, color)}`);
+    return out;
+}
+export function helpOverlay(control, context) {
+    const { theme, color } = context;
+    const policy = control.config.policy;
+    const stages = policy === "strict" ? "35/60/80" : policy === "relaxed" ? "80/95" : policy === "off" ? "" : "50/80/90";
+    const keyWidth = Math.max(...HELP_KEYS.map(([key]) => key.length));
+    const room = Math.max(16, context.columns - keyWidth - 8);
+    const out = [`  ${paintHead(theme, "KEYS", color)}`, ""];
+    for (const [key, what] of HELP_KEYS) {
+        const wrapped = [];
+        let line = "";
+        for (const word of what.split(" ")) {
+            if (line.length === 0)
+                line = word;
+            else if (line.length + 1 + word.length <= room)
+                line += ` ${word}`;
+            else {
+                wrapped.push(line);
+                line = word;
+            }
+        }
+        if (line)
+            wrapped.push(line);
+        for (const [at, text] of wrapped.entries()) {
+            const gutter = at === 0 ? paint(theme, "accent", padEndVisible(key, keyWidth), color) : " ".repeat(keyWidth);
+            out.push(`    ${gutter}  ${paint(theme, "dim", text, color)}`);
+        }
+    }
+    out.push(...helpSection("the two tables", context));
+    out.push(...helpProse("ACTIVE is what shares your window. A project joins it on its own the moment you open Claude Code there, and stays after you close it, holding whatever target you gave it.", context));
+    out.push("");
+    out.push(...helpProse("RECENT is everything else SaveMyTokens has seen, holding nothing. Space moves the selected project up a level and x moves it down, so x on a RECENT row hides it for good. Press m to see what is hidden and space to bring one back. A target you set is remembered wherever the project sits.", context));
+    out.push("");
+    out.push(...helpProse("A filled dot means a session is open there right now. Only those spend the window, so one sitting in ACTIVE with nothing running lends its share to the rest and takes it back when you return.", context));
+    out.push(...helpSection("allocation and priority", context));
+    out.push(...helpProse("Allocation is what you asked for: the share of the window this project should get. Move it with the arrows.", context));
+    out.push("");
+    out.push(...helpProse("Priority decides who gets the leftovers. Capacity is released whenever a project finishes or sits idle under its target, and that spare goes to every HIGH project first, then NORMAL, then LOW. It is an order, not a weighting: a LOW project gets nothing while a HIGH one still has room.", context));
+    out.push("");
+    out.push(...helpProse("So allocation is your intent and priority is the tie-break. If pinned targets already add up to the whole window there is no spare, and priority does nothing.", context));
+    out.push(...helpSection("the status line", context));
+    out.push(...helpProse(control.installed
+        ? "Installed. It is the only place Anthropic publishes your 5h and 7d usage, and it is what proves a session is still open, so without it nothing here is live. Change its shape with P."
+        : "Not installed, so nothing here is live. It is the only place Anthropic publishes your 5h and 7d usage, and it is what proves a session is still open. Run: npx savemytokens install", context));
+    out.push(...helpSection("the numbers", context));
+    out.push(...helpProse("5h and 7d are Anthropic's own. Share is measured from the tokens in your transcripts. Used of it is their number split by that share, so the split between rows is ours, not theirs.", context));
+    const drift = control.unattributed ?? 0;
+    if (drift >= UNATTRIBUTED_FLOOR) {
+        out.push("");
+        out.push(...helpProse("Window spent outside these projects is claude.ai, another machine, or work done before SaveMyTokens was watching.", context));
+    }
+    out.push(...helpSection("when it gets tight", context));
+    out.push(...helpProse(stages
+        ? `Claude is told to wind down at ${stages}% of a project's target. Change it with P.`
+        : "Nothing is ever said to Claude, because the policy is off. Change it with P.", context));
+    out.push(...helpSection("anything else", context));
+    out.push(...helpProse("Questions, bugs and ideas: hello@offbeatport.com", context));
+    return out;
+}