pi-cockpit 0.18.0 → 0.19.0

package/README.md

@@ -120,7 +120,7 @@ The tab title is `frame + pi - <session> - <working state>`. The session part fo
 - `theme`: named theme override; empty string follows the Pi session theme.
 - `usage.enabled`: master switch for the usage bars (quota, balance, spend). On by default; off hides the footer segment and disables the `/usage` command. Ports the [`hknet/pi-usage-bars`](https://github.com/hknet/pi-usage-bars) extension.
 - `usage.footer`: when `true`, render the live quota bar on a dedicated footer line. The `/usage` command works regardless of this toggle. On by default.
-- `usage.pollIntervalMs`: how often to refresh usage data, in milliseconds. Clamped to `30000`..`1800000` (30s..30min). Default `120000` (2min). Lower values hit provider APIs more often.
+- `usage.pollIntervalMs`: how often to refresh usage data, in milliseconds. Clamped to `30000`..`1800000` (30s..30min); `0` switches to manual refresh — no background polling and no footer bar; the `/usage` overlay fetches on open and re-fetches with `r`. Default `120000` (2min). Lower values hit provider APIs more often.
 - `usage.barWidth`: characters per quota bar in the footer. Clamped to `4`..`16`. Default `8`.
 - `usage.commandKey`: the `/`-command that opens the usage selector overlay. Default `"usage"`. Requires `/reload` to take effect (commands register at session start).
 
@@ -136,7 +136,7 @@ The tab title is `frame + pi - <session> - <working state>`. The session part fo
 - `/cockpit sidebar auto|on|off` — selects dock behavior.
 - `/cockpit sidebar resize` or `Ctrl+Shift+R` — enters temporary Resize mode. Left/Right adjusts one column, Shift+Left/Shift+Right adjusts four, Enter accepts, and Escape rolls back. Mouse reporting is active only during Resize mode.
 - `/cockpit quiet` — toggles quiet mode; `/cockpit bg` shows background jobs.
-- `/usage` — opens the usage selector overlay: quota, balance, and spend for every configured provider, with the active one marked `✓`. Search filters by name; arrows/`j`/`k` move, Enter expands the selected provider, Esc closes. Expanding a provider also shows its **7-day token trend** — a sparkline of daily token usage, a `total tok · $cost · turns/day` summary, and the top 2 models by token share — read from the optional `pi-maestro-flow` usage-history store (`~/.pi/agent/usage-history`), so it appears once that extension has recorded turns and is omitted on bare Pi. The command key is configurable via `usage.commandKey` (default `"usage"`, requires `/reload`). Disabled while `usage.enabled` is off.
+- `/usage` — opens the usage selector overlay: quota, balance, and spend for every configured provider, with the active one marked `✓`. Search filters by name; arrows/`j`/`k` move, Enter expands the selected provider, Esc closes; `r` (with an empty search box) re-fetches all providers; `p` (with an empty search box) toggles background polling — persisted to `usage.pollIntervalMs` (off writes `0`, on restores the default `120000`), so the footer bar starts/stops. Expanding a provider also shows its **7-day token trend** — a sparkline of daily token usage, a `total tok · $cost · turns/day` summary, and the top 2 models by token share — read from the optional `pi-maestro-flow` usage-history store (`~/.pi/agent/usage-history`), so it appears once that extension has recorded turns and is omitted on bare Pi. The command key is configurable via `usage.commandKey` (default `"usage"`, requires `/reload`). Disabled while `usage.enabled` is off.
 - `/theme` — switch theme with live preview; `/theme <name>` applies directly. `cockpit-zen` is the restrained warm-gold theme designed for the Zen stack; selecting it does not change `stackStyle`. Pi ships no standalone theme command; cockpit provides one.
 
 ## Sidebar compatibility

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cockpit",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
   "type": "module",
   "keywords": [
@@ -72,7 +72,7 @@
     "@earendil-works/pi-coding-agent": "0.83.0",
     "@earendil-works/pi-tui": "0.83.0",
     "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "2.1.0",
+    "pi-maestro-teammate": "2.2.0",
     "typebox": "1.3.7",
     "typescript": "^5.5.0"
   },

package/src/ambient.ts

@@ -135,3 +135,51 @@ export function titleFor(
 export function statusText(problem: string | undefined, mark: string): string | undefined {
 	return problem ? `${mark} cockpit: ${problem}` : undefined;
 }
+
+/**
+ * Some host UI setters invalidate the whole TUI even when the value did not
+ * change. Cache the last ambient values so the 250ms Cockpit tick only mutates
+ * host surfaces when there is a real text change.
+ */
+export class AmbientSurfaceCache {
+	private workingMessageKnown = false;
+	private workingMessage: string | undefined;
+	private titleKnown = false;
+	private title: string | undefined;
+	private readonly statuses = new Map<string, string | undefined>();
+
+	reset(): void {
+		this.workingMessageKnown = false;
+		this.workingMessage = undefined;
+		this.titleKnown = false;
+		this.title = undefined;
+		this.statuses.clear();
+	}
+
+	setWorkingMessage(setter: (message: string | undefined) => void, message: string | undefined): boolean {
+		if (this.workingMessageKnown && this.workingMessage === message) return false;
+		this.workingMessageKnown = true;
+		this.workingMessage = message;
+		setter(message);
+		return true;
+	}
+
+	setTitle(setter: (title: string) => void, title: string): boolean {
+		if (this.titleKnown && this.title === title) return false;
+		this.titleKnown = true;
+		this.title = title;
+		setter(title);
+		return true;
+	}
+
+	setStatus(
+		key: string,
+		setter: (key: string, text: string | undefined) => void,
+		text: string | undefined,
+	): boolean {
+		if (this.statuses.has(key) && this.statuses.get(key) === text) return false;
+		this.statuses.set(key, text);
+		setter(key, text);
+		return true;
+	}
+}

package/src/config.ts

@@ -23,7 +23,9 @@ function mergeUsageConfig(base: UsageConfig, raw: unknown): UsageConfig {
 	const isFiniteInt = (v: unknown): v is number =>
 		typeof v === "number" && Number.isFinite(v) && Number.isSafeInteger(v);
 	const pollIntervalMs = isFiniteInt(o.pollIntervalMs)
-		? Math.min(USAGE_POLL_MAX_MS, Math.max(USAGE_POLL_MIN_MS, o.pollIntervalMs))
+		? o.pollIntervalMs <= 0
+			? 0 // 0 = manual refresh: no background poll, /usage fetches on open and on `r`
+			: Math.min(USAGE_POLL_MAX_MS, Math.max(USAGE_POLL_MIN_MS, o.pollIntervalMs))
 		: base.pollIntervalMs;
 	const barWidth = isFiniteInt(o.barWidth)
 		? Math.min(USAGE_BAR_MAX_WIDTH, Math.max(USAGE_BAR_MIN_WIDTH, o.barWidth))

package/src/editor/input-history-store.ts

@@ -7,7 +7,7 @@
  * so a brand new session picks up where the previous one left off.
  */
 
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
@@ -19,6 +19,9 @@ const DEFAULT_MAX_ENTRIES = 100;
 const DEFAULT_SAVE_DEBOUNCE_MS = 250;
 const PRIVATE_DIRECTORY_MODE = 0o700;
 const PRIVATE_FILE_MODE = 0o600;
+const DEFAULT_SAVE_RETRY_DELAYS_MS = Object.freeze([25, 75, 150]);
+
+type RenameFile = (oldPath: string, newPath: string) => Promise<void>;
 
 /**
  * Serializes every save across store instances so a fresh store's load() never
@@ -32,6 +35,8 @@ export interface InputHistoryStoreOptions {
   maxEntries?: number;
   debounceMs?: number;
   onError?: (error: unknown) => void;
+  renameFile?: RenameFile;
+  retryDelaysMs?: readonly number[];
 }
 
 /**
@@ -59,6 +64,8 @@ export class InputHistoryStore {
   private readonly maxEntries: number;
   private readonly debounceMs: number;
   private readonly onError: ((error: unknown) => void) | undefined;
+  private readonly renameFile: RenameFile;
+  private readonly retryDelaysMs: readonly number[];
   private entries: string[] = [];
   private timer: NodeJS.Timeout | undefined;
   private writes: Promise<void> = Promise.resolve();
@@ -70,6 +77,8 @@ export class InputHistoryStore {
     this.maxEntries = Math.max(1, options.maxEntries ?? DEFAULT_MAX_ENTRIES);
     this.debounceMs = Math.max(0, options.debounceMs ?? DEFAULT_SAVE_DEBOUNCE_MS);
     this.onError = options.onError;
+    this.renameFile = options.renameFile ?? rename;
+    this.retryDelaysMs = retryDelays(options.retryDelaysMs);
   }
 
   /** Newest first. */
@@ -124,21 +133,30 @@ export class InputHistoryStore {
   }
 
   private async save(): Promise<void> {
+    await mkdir(this.dir, { recursive: true, mode: PRIVATE_DIRECTORY_MODE });
+    for (let attempt = 0; ; attempt += 1) {
+      await this.mergeDiskEntries();
+      const temp = `${this.filePath}.${process.pid}.${randomUUID()}.tmp`;
+      try {
+        const payload = JSON.stringify({ version: 1, entries: this.entries }, null, 2);
+        await writeFile(temp, payload, { mode: PRIVATE_FILE_MODE, flag: "wx" });
+        await this.renameFile(temp, this.filePath);
+        return;
+      } catch (error) {
+        await rm(temp, { force: true }).catch(() => undefined);
+        const retryDelay = this.retryDelaysMs[attempt];
+        if (retryDelay === undefined || !isTransientReplaceError(error)) throw error;
+        await delay(retryDelay);
+      }
+    }
+  }
+
+  private async mergeDiskEntries(): Promise<void> {
     // Another pi window in the same workspace may have written since we loaded;
     // keep whatever it added instead of overwriting it.
     const known = new Set(this.entries);
     const disk = (await this.readFromDisk()).filter((value) => !known.has(value));
     this.entries = capped([...this.entries, ...disk], this.maxEntries);
-    await mkdir(this.dir, { recursive: true, mode: PRIVATE_DIRECTORY_MODE });
-    const temp = `${this.filePath}.${process.pid}.tmp`;
-    try {
-      const payload = JSON.stringify({ version: 1, entries: this.entries }, null, 2);
-      await writeFile(temp, payload, { mode: PRIVATE_FILE_MODE });
-      await rename(temp, this.filePath);
-    } catch (error) {
-      await rm(temp, { force: true });
-      throw error;
-    }
   }
 
   private async readFromDisk(): Promise<string[]> {
@@ -171,3 +189,17 @@ function parseEntries(raw: unknown): string[] {
 function capped(entries: string[], maxEntries: number): string[] {
   return entries.length > maxEntries ? entries.slice(0, maxEntries) : entries;
 }
+
+function retryDelays(value: readonly number[] | undefined): readonly number[] {
+  const source = value ?? DEFAULT_SAVE_RETRY_DELAYS_MS;
+  return Object.freeze(source.map((delayMs) => Math.max(0, delayMs)).filter(Number.isFinite));
+}
+
+function isTransientReplaceError(error: unknown): boolean {
+  const code = (error as NodeJS.ErrnoException | null)?.code;
+  return code === "EPERM" || code === "EBUSY" || code === "EACCES";
+}
+
+function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/src/icons.ts

@@ -149,13 +149,11 @@ export function resolveGlyphs(mode: IconMode): IconGlyphs {
 /**
  * One source of truth for animation cadence.
  *
- * The frame clock and the redraw tick must be the same number. When frames
- * advanced every 120ms but the UI only repainted every 250ms, each repaint
- * skipped ~2 frames: the 6-frame braille spinner ran at half speed and the
- * 4-frame ASCII spinner degenerated into a two-glyph flip (| ↔ -), which reads
- * as blinking rather than rotation.
+ * The frame clock and redraw tick stay aligned so terminal animation advances
+ * one frame per paint. A half-second cadence remains legible without keeping
+ * the terminal renderer busy during long-running work.
  */
-export const ANIMATION_PERIOD_MS = 250;
+export const ANIMATION_PERIOD_MS = 500;
 
 /**
  * The frame to draw at `now`, or a stable glyph when nothing is driving redraws.

package/src/index.ts

@@ -5,7 +5,7 @@ import type { TUI } from "@earendil-works/pi-tui";
 import { ambientKeysShouldYield, capturingOverlayVisible } from "./capturing-overlay.ts";
 import { Key, decodeKittyPrintable, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { AgentReadStoreRouter, effectiveAgentStatus, type CompletePayload, type MessagePayload, type StartedPayload } from "./agents-store.ts";
-import { statusText, titleFor, workingMessage, type AmbientState } from "./ambient.ts";
+import { AmbientSurfaceCache, statusText, titleFor, workingMessage, type AmbientState } from "./ambient.ts";
 import { generateTitleWithModel } from "./title-llm.ts";
 import { suggestTitle } from "./title-gen.ts";
 import { BashBgStore } from "./bash-bg-store.ts";
@@ -89,6 +89,7 @@ import {
 	COCKPIT_PREEMPT_RESIZE_EVENT,
 	COCKPIT_SESSION_LIST_EVENT,
 	COCKPIT_TODO_TOGGLE_EVENT,
+	MAESTRO_TODO_STATE_CHANGED_EVENT,
 	MAESTRO_UI_SNAPSHOT_EVENT,
 	MAESTRO_UI_SNAPSHOT_VERSION,
 	SUPERVISION_EVENT,
@@ -152,7 +153,7 @@ const COCKPIT_STATUS_KEY = "cockpit";
 // a turn runs (screens/REPL.tsx TITLE_STATIC_PREFIX / TITLE_ANIMATION_FRAMES).
 const TITLE_STATIC = "✳";
 const TITLE_FRAMES = ["⠂", "⠐"];
-const WIDTH_POLL_INTERVAL_MS = 250;
+const WIDTH_POLL_INTERVAL_MS = 500;
 // Static mode keeps token totals fresh enough without recomputing on every message.
 const USAGE_REFRESH_THROTTLE_MS = 10_000;
 // Quiet mode's rename of pi's hidden-thinking label. The live thinking timer
@@ -416,6 +417,7 @@ export default function (pi: ExtensionAPI): void {
 	// Persisted rather than toasted: a config that failed to load silently downgrades
 	// the whole session to defaults, so it belongs in a slot that does not scroll away.
 	let configProblem: string | undefined;
+	const ambientSurfaces = new AmbientSurfaceCache();
 	let quietToolsRegistered = false;
 
 	// Register quiet tools at extension load time, not just in session_start.
@@ -483,8 +485,8 @@ export default function (pi: ExtensionAPI): void {
 		const g = resolveGlyphs(config.icons.mode);
 		try {
 			if (!config.enabled) {
-				ctx.ui.setWorkingMessage(undefined);
-				ctx.ui.setStatus(COCKPIT_STATUS_KEY, undefined);
+				ambientSurfaces.setWorkingMessage((message) => ctx.ui.setWorkingMessage(message), undefined);
+				ambientSurfaces.setStatus(COCKPIT_STATUS_KEY, (key, text) => ctx.ui.setStatus(key, text), undefined);
 				return;
 			}
 			const activeTool = [...activeTools.values()].at(-1);
@@ -500,7 +502,7 @@ export default function (pi: ExtensionAPI): void {
 				hideLiveDuration: config.staticMode,
 				separator: ` ${g.separator} `,
 			};
-			ctx.ui.setWorkingMessage(workingMessage(state, now));
+			ambientSurfaces.setWorkingMessage((message) => ctx.ui.setWorkingMessage(message), workingMessage(state, now));
 			if (title.enabled) {
 				state.session = title.showSession ? sessionTag(ctx.sessionManager, aiTitle) : undefined;
 				state.model = title.showModel ? modelTag(ctx.model) : undefined;
@@ -511,9 +513,12 @@ export default function (pi: ExtensionAPI): void {
 					? maestroKnowledgeTag(maestro.snapshot()?.workflow?.knowledge)
 					: undefined;
 				state.frame = titleFrame(running);
-				ctx.ui.setTitle(titleFor(state, { ok: g.check, fail: g.cross }, g.separator, { maxLength: title.maxLength }));
+				ambientSurfaces.setTitle(
+					(value) => ctx.ui.setTitle(value),
+					titleFor(state, { ok: g.check, fail: g.cross }, g.separator, { maxLength: title.maxLength }),
+				);
 			}
-			ctx.ui.setStatus(COCKPIT_STATUS_KEY, statusText(configProblem, g.blocked));
+			ambientSurfaces.setStatus(COCKPIT_STATUS_KEY, (key, text) => ctx.ui.setStatus(key, text), statusText(configProblem, g.blocked));
 		} catch {
 			// ambient surfaces are best-effort; never let them break a render
 		}
@@ -601,6 +606,12 @@ export default function (pi: ExtensionAPI): void {
 		pi,
 		getConfig: () => config,
 		onStatusChange: () => req(),
+		setPollIntervalMs: (ms: number) => {
+			config = { ...config, usage: { ...config.usage, pollIntervalMs: ms } };
+			const result = saveConfig(config);
+			req();
+			return result.ok;
+		},
 	});
 	const policy = (): TickPolicyState => ({
 		staticMode: config.staticMode,
@@ -1333,6 +1344,7 @@ export default function (pi: ExtensionAPI): void {
 		} catch {
 			// ambient surfaces are best-effort
 		}
+		ambientSurfaces.reset();
 		stopTick();
 		viewportStabilityPatch?.detach();
 		viewportStabilityPatch = undefined;
@@ -1694,6 +1706,12 @@ export default function (pi: ExtensionAPI): void {
 				if (!maestro.applySnapshot(payload)) return;
 				req();
 			}),
+			pi.events.on(MAESTRO_TODO_STATE_CHANGED_EVENT, (payload) => {
+				if (!payload || typeof payload !== "object" || (payload as { version?: unknown }).version !== 1) return;
+				const ctx = lastCtx;
+				if (!ctx || !todos.hydrateFromEntries(ctx.sessionManager.getEntries())) return;
+				req();
+			}),
 			pi.events.on(SUPERVISION_EVENT, (payload) => {
 				if (!supervision.applyEvent(payload)) return;
 				req();
@@ -1748,6 +1766,7 @@ export default function (pi: ExtensionAPI): void {
 	// --- session + agent lifecycle ---
 	pi.on("session_start", (_e, ctx) => {
 		lastCtx = ctx;
+		ambientSurfaces.reset();
 		agentReads.bindSession(ctx.sessionManager.getSessionId());
 		agents = agentReads.current;
 		usingRuntimeV2 = false;
@@ -2465,7 +2484,8 @@ export default function (pi: ExtensionAPI): void {
 					else usageSubsystem?.stop(ctx);
 			}
 				// footer/footer-toggle/barWidth change only the rendered string (the
-				// next render reads them fresh); pollIntervalMs change restarts the poller.
+				// next render reads them fresh); pollIntervalMs change restarts the
+				// poller (0 switches to manual refresh: no timer, no footer bar).
 				if (previous.usage.pollIntervalMs !== nextConfig.usage.pollIntervalMs && nextConfig.usage.enabled) {
 					usageSubsystem?.rescheduleTimer();
 					usageSubsystem?.refresh();

package/src/public/v1/events.ts

@@ -3,6 +3,10 @@
 export const COCKPIT_MAESTRO_QUERY_EVENT = "cockpit:maestro-query";
 export const MAESTRO_UI_SNAPSHOT_EVENT = "maestro:ui-snapshot";
 export const MAESTRO_UI_SNAPSHOT_VERSION = 1 as const;
+export const MAESTRO_TODO_STATE_CHANGED_EVENT = "maestro:todo-state-changed";
+export interface MaestroTodoStateChangedV1 {
+	version: 1;
+}
 
 /**
  * Unified supervision telemetry emitted by the shared supervision layer
@@ -190,6 +194,7 @@ export interface CockpitUiOwnershipV1 {
 export interface MaestroEventMapV1 {
 	"cockpit:maestro-query": MaestroQueryV1;
 	"maestro:ui-snapshot": MaestroUiSnapshotV1;
+	"maestro:todo-state-changed": MaestroTodoStateChangedV1;
 	"cockpit:ui-ownership": CockpitUiOwnershipV1;
 	"cockpit:open-session-list": CockpitSessionListRequestV1;
 	"cockpit:preempt-resize": undefined;

package/src/settings/cockpit-provider.ts

@@ -211,7 +211,7 @@ const CATALOGS = {
 		"cockpit.usage.footer": "Show in footer",
 		"cockpit.usage.footer.description": "Render the live quota bar on a dedicated footer line. The /usage command works regardless of this toggle.",
 		"cockpit.usage.pollIntervalMs": "Poll interval (ms)",
-		"cockpit.usage.pollIntervalMs.description": "How often to refresh usage data. Clamped to 30s..30min. Lower values hit provider APIs more often.",
+		"cockpit.usage.pollIntervalMs.description": "How often to refresh usage data. Clamped to 30s..30min; 0 = manual refresh only (no polling, no footer bar; /usage fetches on open and with `r`). Lower values hit provider APIs more often.",
 		"cockpit.usage.barWidth": "Bar width",
 		"cockpit.usage.barWidth.description": "Characters per quota bar in the footer. Clamped to 4..16.",
 		"cockpit.usage.commandKey": "Command key",
@@ -296,7 +296,7 @@ const CATALOGS = {
 		"cockpit.usage.footer": "在状态栏显示",
 		"cockpit.usage.footer.description": "在专属状态栏行渲染实时配额条。/usage 命令不受此开关影响。",
 		"cockpit.usage.pollIntervalMs": "轮询间隔（毫秒）",
-		"cockpit.usage.pollIntervalMs.description": "刷新用量数据的频率，钳制在 30 秒..30 分钟。值越小调用供应商 API 越频繁。",
+		"cockpit.usage.pollIntervalMs.description": "刷新用量数据的频率，钳制在 30 秒..30 分钟；0 = 仅手动刷新（不轮询、不显示状态栏；进入 /usage 时抓取并按 r 刷新）。值越小调用供应商 API 越频繁。",
 		"cockpit.usage.barWidth": "进度条宽度",
 		"cockpit.usage.barWidth.description": "状态栏中每条配额条的字符宽度，钳制在 4..16。",
 		"cockpit.usage.commandKey": "命令键",
@@ -423,7 +423,7 @@ const DEFINITIONS: readonly SettingDefinition[] = [
 		activation: "live",
 		sensitivity: "public",
 		reversibility: "full",
-		editor: { kind: "integer", min: 30_000, max: 1_800_000, step: 1000 },
+		editor: { kind: "integer", min: 0, max: 1_800_000, step: 1000 },
 	},
 	{
 		key: "usage.barWidth",
@@ -795,7 +795,7 @@ function validValue(key: CockpitSettingKey, value: JsonValue): boolean {
 	if (key === "title.generationModel") return typeof value === "string";
 	if (key.startsWith("title.")) return typeof value === "boolean";
 	if (key === "usage.enabled" || key === "usage.footer") return typeof value === "boolean";
-	if (key === "usage.pollIntervalMs") return typeof value === "number" && Number.isSafeInteger(value) && value >= 30_000 && value <= 1_800_000;
+	if (key === "usage.pollIntervalMs") return typeof value === "number" && Number.isSafeInteger(value) && (value === 0 || (value >= 30_000 && value <= 1_800_000));
 	if (key === "usage.barWidth") return typeof value === "number" && Number.isSafeInteger(value) && value >= 4 && value <= 16;
 	if (key === "usage.commandKey") return typeof value === "string" && value.trim().length > 0;
 	if (key === "quietSymbols") return value === "check" || value === "dot";

package/src/todo-store.ts

@@ -48,6 +48,17 @@ function asSkills(value: unknown): TodoSkill[] {
 	return skills;
 }
 
+function sameActor(left: TodoActor | undefined, right: TodoActor | undefined): boolean {
+	return left?.id === right?.id && left?.label === right?.label;
+}
+
+function sameSkills(left: readonly TodoSkill[], right: readonly TodoSkill[]): boolean {
+	return left.length === right.length && left.every((skill, index) => {
+		const candidate = right[index];
+		return candidate !== undefined && skill.name === candidate.name && skill.role === candidate.role;
+	});
+}
+
 // Map the todo tool's status strings onto our four display states.
 // "deleted" is returned verbatim so the caller can drop the task.
 export function mapStatus(raw: unknown): TodoState | "deleted" {
@@ -115,7 +126,11 @@ export class TodoStore {
 				|| item.status !== candidate.status
 				|| item.subject !== candidate.subject
 				|| item.blockedBy.length !== candidate.blockedBy.length
-				|| item.blockedBy.some((id, blockedIndex) => id !== candidate.blockedBy[blockedIndex]);
+				|| item.blockedBy.some((id, blockedIndex) => id !== candidate.blockedBy[blockedIndex])
+				|| !sameActor(item.createdBy, candidate.createdBy)
+				|| !sameActor(item.assignee, candidate.assignee)
+				|| !sameSkills(item.skills, candidate.skills)
+				|| item.updatedAt !== candidate.updatedAt;
 		});
 		if (!changed) return false;
 		this.items = next;

package/src/types.ts

@@ -221,7 +221,7 @@ export interface UsageConfig {
 	enabled: boolean;
 	/** Show the live quota bar in the Cockpit footer (a dedicated footer line). */
 	footer: boolean;
-	/** Poll interval in milliseconds; clamped 30s..30min. Default 2min. */
+	/** Poll interval in milliseconds; clamped 30s..30min. Default 2min. 0 = manual refresh (no polling, no footer bar; /usage fetches on open and on `r`). */
 	pollIntervalMs: number;
 	/** Characters per quota bar in the footer; clamped 4..16. Default 8. */
 	barWidth: number;