@oh-my-pi/pi-coding-agent 13.9.2 → 13.9.3

package/src/modes/components/settings-selector.ts

@@ -1,4 +1,5 @@
-import type { ThinkingLevel } from "@oh-my-pi/pi-ai";
+import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort } from "@oh-my-pi/pi-ai";
 import {
 	Container,
 	matchesKey,
@@ -134,9 +135,9 @@ function getSettingsTabs(): Tab[] {
  */
 export interface SettingsRuntimeContext {
 	/** Available thinking levels (from session) */
-	availableThinkingLevels: ThinkingLevel[];
+	availableThinkingLevels: Effort[];
 	/** Current thinking level (from session) */
-	thinkingLevel: ThinkingLevel;
+	thinkingLevel: ThinkingLevel | undefined;
 	/** Available themes */
 	availableThemes: string[];
 	/** Working directory for plugins tab */
@@ -272,7 +273,7 @@ export class SettingsSelectorComponent extends Container {
 					id: def.path,
 					label: def.label,
 					description: def.description,
-					currentValue: String(currentValue ?? ""),
+					currentValue: this.#getSubmenuCurrentValue(def.path, currentValue),
 					submenu: (cv, done) => this.#createSubmenu(def, cv, done),
 				};
 		}
@@ -285,6 +286,14 @@ export class SettingsSelectorComponent extends Container {
 		return settings.get(def.path);
 	}
 
+	#getSubmenuCurrentValue(path: SettingPath, value: unknown): string {
+		const rawValue = String(value ?? "");
+		if (path === "compaction.thresholdPercent" && (rawValue === "-1" || rawValue === "")) {
+			return "default";
+		}
+		return rawValue;
+	}
+
 	/**
 	 * Create a submenu for a submenu-type setting.
 	 */
@@ -382,7 +391,9 @@ export class SettingsSelectorComponent extends Container {
 	#setSettingValue(path: SettingPath, value: string): void {
 		// Handle number conversions
 		const currentValue = settings.get(path);
-		if (typeof currentValue === "number") {
+		if (path === "compaction.thresholdPercent" && value === "default") {
+			settings.set(path, -1 as never);
+		} else if (typeof currentValue === "number") {
 			settings.set(path, Number(value) as never);
 		} else if (typeof currentValue === "boolean") {
 			settings.set(path, (value === "true") as never);

package/src/modes/components/status-line/context-thresholds.ts

@@ -0,0 +1,68 @@
+import type { ThemeColor } from "../../../modes/theme/theme";
+
+export type ContextUsageLevel = "normal" | "warning" | "purple" | "error";
+
+const CONTEXT_WARNING_PERCENT_THRESHOLD = 50;
+const CONTEXT_WARNING_TOKEN_THRESHOLD = 150_000;
+const CONTEXT_PURPLE_PERCENT_THRESHOLD = 70;
+const CONTEXT_PURPLE_TOKEN_THRESHOLD = 270_000;
+const CONTEXT_ERROR_PERCENT_THRESHOLD = 90;
+const CONTEXT_ERROR_TOKEN_THRESHOLD = 500_000;
+
+function reachesThreshold(
+	contextPercent: number,
+	contextWindow: number,
+	percentThreshold: number,
+	tokenThreshold: number,
+): boolean {
+	if (!Number.isFinite(contextPercent) || contextPercent <= 0) {
+		return false;
+	}
+
+	if (!Number.isFinite(contextWindow) || contextWindow <= 0) {
+		return contextPercent >= percentThreshold;
+	}
+
+	const tokenPercentThreshold = (tokenThreshold / contextWindow) * 100;
+	return contextPercent >= Math.min(percentThreshold, tokenPercentThreshold);
+}
+
+export function getContextUsageLevel(contextPercent: number, contextWindow: number): ContextUsageLevel {
+	if (
+		reachesThreshold(contextPercent, contextWindow, CONTEXT_ERROR_PERCENT_THRESHOLD, CONTEXT_ERROR_TOKEN_THRESHOLD)
+	) {
+		return "error";
+	}
+
+	if (
+		reachesThreshold(contextPercent, contextWindow, CONTEXT_PURPLE_PERCENT_THRESHOLD, CONTEXT_PURPLE_TOKEN_THRESHOLD)
+	) {
+		return "purple";
+	}
+
+	if (
+		reachesThreshold(
+			contextPercent,
+			contextWindow,
+			CONTEXT_WARNING_PERCENT_THRESHOLD,
+			CONTEXT_WARNING_TOKEN_THRESHOLD,
+		)
+	) {
+		return "warning";
+	}
+
+	return "normal";
+}
+
+export function getContextUsageThemeColor(level: ContextUsageLevel): ThemeColor {
+	switch (level) {
+		case "error":
+			return "error";
+		case "purple":
+			return "thinkingHigh";
+		case "warning":
+			return "warning";
+		case "normal":
+			return "statusLineContext";
+	}
+}

package/src/modes/components/status-line/segments.ts

@@ -1,8 +1,10 @@
 import * as os from "node:os";
+import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import { TERMINAL } from "@oh-my-pi/pi-tui";
 import { formatDuration, formatNumber, getProjectDir } from "@oh-my-pi/pi-utils";
 import { theme } from "../../../modes/theme/theme";
 import { shortenPath } from "../../../tools/render-utils";
+import { getContextUsageLevel, getContextUsageThemeColor } from "./context-thresholds";
 import type { RenderedSegment, SegmentContext, StatusLineSegment, StatusLineSegmentId } from "./types";
 
 export type { SegmentContext } from "./types";
@@ -44,10 +46,14 @@ const modelSegment: StatusLineSegment = {
 
 		let content = withIcon(theme.icon.model, modelName);
 
+		if (ctx.session.isFastModeEnabled() && theme.icon.fast) {
+			content += ` ${theme.icon.fast}`;
+		}
+
 		// Add thinking level with dot separator
-		if (opts.showThinkingLevel !== false && state.model?.reasoning) {
-			const level = state.thinkingLevel || "off";
-			if (level !== "off") {
+		if (opts.showThinkingLevel !== false && state.model?.thinking) {
+			const level = state.thinkingLevel ?? ThinkingLevel.Off;
+			if (level !== ThinkingLevel.Off) {
 				const thinkingText = theme.thinking[level as keyof typeof theme.thinking];
 				if (thinkingText) {
 					content += `${theme.sep.dot}${thinkingText}`;
@@ -244,15 +250,8 @@ const contextPctSegment: StatusLineSegment = {
 		const autoIcon = ctx.autoCompactEnabled && theme.icon.auto ? ` ${theme.icon.auto}` : "";
 		const text = `${pct.toFixed(1)}%/${formatNumber(window)}${autoIcon}`;
 
-		let content: string;
-		if (pct > 90) {
-			content = withIcon(theme.icon.context, theme.fg("error", text));
-		} else if (pct > 70) {
-			content = withIcon(theme.icon.context, theme.fg("warning", text));
-		} else {
-			const colored = theme.fg("statusLineContext", text);
-			content = withIcon(theme.icon.context, colored);
-		}
+		const color = getContextUsageThemeColor(getContextUsageLevel(pct, window));
+		const content = withIcon(theme.icon.context, theme.fg(color, text));
 
 		return { content, visible: true };
 	},

package/src/modes/components/thinking-selector.ts

@@ -1,7 +1,7 @@
-import { getThinkingMetadata, type ThinkingLevel } from "@oh-my-pi/pi-ai";
-
+import type { Effort } from "@oh-my-pi/pi-ai";
 import { Container, type SelectItem, SelectList } from "@oh-my-pi/pi-tui";
 import { getSelectListTheme } from "../../modes/theme/theme";
+import { getThinkingLevelMetadata } from "../../thinking";
 import { DynamicBorder } from "./dynamic-border";
 
 /**
@@ -11,14 +11,14 @@ export class ThinkingSelectorComponent extends Container {
 	#selectList: SelectList;
 
 	constructor(
-		currentLevel: ThinkingLevel,
-		availableLevels: ThinkingLevel[],
-		onSelect: (level: ThinkingLevel) => void,
+		currentLevel: Effort,
+		availableLevels: Effort[],
+		onSelect: (level: Effort) => void,
 		onCancel: () => void,
 	) {
 		super();
 
-		const thinkingLevels: SelectItem[] = availableLevels.map(getThinkingMetadata);
+		const thinkingLevels: SelectItem[] = availableLevels.map(getThinkingLevelMetadata);
 
 		// Add top border
 		this.addChild(new DynamicBorder());
@@ -33,7 +33,7 @@ export class ThinkingSelectorComponent extends Container {
 		}
 
 		this.#selectList.onSelect = item => {
-			onSelect(item.value as ThinkingLevel);
+			onSelect(item.value as Effort);
 		};
 
 		this.#selectList.onCancel = () => {

package/src/modes/components/tree-selector.ts

@@ -1,3 +1,4 @@
+import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import {
 	type Component,
 	Container,
@@ -382,7 +383,7 @@ class TreeList implements Component {
 				parts.push("model", entry.model);
 				break;
 			case "thinking_level_change":
-				parts.push("thinking", entry.thinkingLevel);
+				parts.push("thinking", entry.thinkingLevel ?? ThinkingLevel.Off);
 				break;
 			case "custom":
 				parts.push("custom", entry.customType);
@@ -585,7 +586,7 @@ class TreeList implements Component {
 				result = theme.fg("dim", `[model: ${entry.model}]`);
 				break;
 			case "thinking_level_change":
-				result = theme.fg("dim", `[thinking: ${entry.thinkingLevel}]`);
+				result = theme.fg("dim", `[thinking: ${entry.thinkingLevel ?? ThinkingLevel.Off}]`);
 				break;
 			case "custom":
 				result = theme.fg("dim", `[custom: ${entry.customType}]`);

package/src/modes/controllers/command-controller.ts

@@ -25,7 +25,6 @@ import { getMarkdownTheme, getSymbolTheme, theme } from "../../modes/theme/theme
 import type { InteractiveModeContext } from "../../modes/types";
 import type { AsyncJobSnapshotItem } from "../../session/agent-session";
 import type { AuthStorage } from "../../session/auth-storage";
-import { createCompactionSummaryMessage } from "../../session/messages";
 import { outputMeta } from "../../tools/output-meta";
 import { resolveToCwd } from "../../tools/path-utils";
 import { replaceTabs } from "../../tools/render-utils";
@@ -776,18 +775,10 @@ export class CommandController {
 				customInstructionsOrOptions && typeof customInstructionsOrOptions === "object"
 					? customInstructionsOrOptions
 					: undefined;
-			const result = await this.ctx.session.compact(instructions, options);
+			await this.ctx.session.compact(instructions, options);
 
 			this.ctx.rebuildChatFromMessages();
 
-			const msg = createCompactionSummaryMessage(
-				result.summary,
-				result.tokensBefore,
-				new Date().toISOString(),
-				result.shortSummary,
-			);
-			this.ctx.addMessageToChat(msg);
-
 			this.ctx.statusLine.invalidate();
 			this.ctx.updateEditorTopBorder();
 		} catch (error) {
@@ -834,6 +825,9 @@ export class CommandController {
 			this.ctx.chatContainer.addChild(
 				new Text(`${theme.fg("accent", `${theme.status.success} New session started with handoff context`)}`, 1, 1),
 			);
+			if (result.savedPath) {
+				this.ctx.showStatus(`Handoff document saved to: ${result.savedPath}`);
+			}
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
 			if (message === "Handoff cancelled" || (error instanceof Error && error.name === "AbortError")) {
@@ -959,9 +953,6 @@ function formatAccountLabel(limit: UsageLimit, report: UsageReport, index: numbe
 }
 
 function formatResetShort(limit: UsageLimit, nowMs: number): string | undefined {
-	if (limit.window?.resetInMs !== undefined) {
-		return formatDuration(limit.window.resetInMs);
-	}
 	if (limit.window?.resetsAt !== undefined) {
 		return formatDuration(limit.window.resetsAt - nowMs);
 	}
@@ -1021,19 +1012,13 @@ function formatAggregateAmount(limits: UsageLimit[]): string {
 }
 
 function resolveResetRange(limits: UsageLimit[], nowMs: number): string | null {
-	const resets = limits
-		.map(limit => limit.window?.resetInMs ?? undefined)
-		.filter((value): value is number => value !== undefined && Number.isFinite(value) && value > 0);
-	if (resets.length === 0) {
-		const absolute = limits
-			.map(limit => limit.window?.resetsAt)
-			.filter((value): value is number => value !== undefined && Number.isFinite(value) && value > nowMs);
-		if (absolute.length === 0) return null;
-		const earliest = Math.min(...absolute);
-		return `resets at ${new Date(earliest).toLocaleString()}`;
-	}
-	const minReset = Math.min(...resets);
-	const maxReset = Math.max(...resets);
+	const absolute = limits
+		.map(limit => limit.window?.resetsAt)
+		.filter((value): value is number => value !== undefined && Number.isFinite(value) && value > nowMs);
+	if (absolute.length === 0) return null;
+	const offsets = absolute.map(value => value - nowMs);
+	const minReset = Math.min(...offsets);
+	const maxReset = Math.max(...offsets);
 	if (maxReset - minReset > 60_000) {
 		return `resets in ${formatDuration(minReset)}–${formatDuration(maxReset)}`;
 	}

package/src/modes/controllers/event-controller.ts

@@ -438,11 +438,12 @@ export class EventController {
 				};
 				this.ctx.statusContainer.clear();
 				const reasonText = event.reason === "overflow" ? "Context overflow detected, " : "";
+				const actionLabel = event.action === "handoff" ? "Auto-handoff" : "Auto context-full maintenance";
 				this.ctx.autoCompactionLoader = new Loader(
 					this.ctx.ui,
 					spinner => theme.fg("accent", spinner),
 					text => theme.fg("muted", text),
-					`${reasonText}Auto-compacting… (esc to cancel)`,
+					`${reasonText}${actionLabel}… (esc to cancel)`,
 					getSymbolTheme().spinnerFrames,
 				);
 				this.ctx.statusContainer.addChild(this.ctx.autoCompactionLoader);
@@ -460,8 +461,11 @@ export class EventController {
 					this.ctx.autoCompactionLoader = undefined;
 					this.ctx.statusContainer.clear();
 				}
+				const isHandoffAction = event.action === "handoff";
 				if (event.aborted) {
-					this.ctx.showStatus("Auto-compaction cancelled");
+					this.ctx.showStatus(
+						isHandoffAction ? "Auto-handoff cancelled" : "Auto context-full maintenance cancelled",
+					);
 				} else if (event.result) {
 					this.ctx.chatContainer.clear();
 					this.ctx.rebuildChatFromMessages();
@@ -474,8 +478,17 @@ export class EventController {
 					});
 					this.ctx.statusLine.invalidate();
 					this.ctx.updateEditorTopBorder();
+				} else if (event.errorMessage) {
+					this.ctx.showWarning(event.errorMessage);
+				} else if (isHandoffAction) {
+					this.ctx.chatContainer.clear();
+					this.ctx.rebuildChatFromMessages();
+					this.ctx.statusLine.invalidate();
+					this.ctx.updateEditorTopBorder();
+					await this.ctx.reloadTodos();
+					this.ctx.showStatus("Auto-handoff completed");
 				} else {
-					this.ctx.showWarning("Auto-compaction failed; continuing without compaction");
+					this.ctx.showWarning("Auto context-full maintenance failed; continuing without maintenance");
 				}
 				await this.ctx.flushCompactionQueue({ willRetry: event.willRetry });
 				this.ctx.ui.requestRender();

package/src/modes/controllers/input-controller.ts

@@ -1,5 +1,5 @@
 import * as fs from "node:fs/promises";
-import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import { type AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import { copyToClipboard, readImageFromClipboard, sanitizeText } from "@oh-my-pi/pi-natives";
 import { $env } from "@oh-my-pi/pi-utils";
 import { settings } from "../../config/settings";
@@ -544,7 +544,9 @@ export class InputController {
 			const roleLabel = result.role === "default" ? "default" : result.role;
 			const roleLabelStyled = theme.bold(theme.fg("accent", roleLabel));
 			const thinkingStr =
-				result.model.reasoning && result.thinkingLevel !== "off" ? ` (thinking: ${result.thinkingLevel})` : "";
+				result.model.thinking && result.thinkingLevel !== ThinkingLevel.Off
+					? ` (thinking: ${result.thinkingLevel})`
+					: "";
 			const tempLabel = options?.temporary ? " (temporary)" : "";
 			const cycleSeparator = theme.fg("dim", " > ");
 			const cycleLabel = roleOrder

package/src/modes/controllers/selector-controller.ts

@@ -1,4 +1,5 @@
-import { getOAuthProviders, type OAuthProvider, type ThinkingLevel } from "@oh-my-pi/pi-ai";
+import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import { getOAuthProviders, type OAuthProvider } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { Input, Loader, Spacer, Text } from "@oh-my-pi/pi-tui";
 import { getAgentDbPath, getProjectDir } from "@oh-my-pi/pi-utils";
@@ -380,7 +381,7 @@ export class SelectorController {
 				this.ctx.settings,
 				this.ctx.session.modelRegistry,
 				this.ctx.session.scopedModels,
-				async (model, role, thinkingMode) => {
+				async (model, role, thinkingLevel) => {
 					try {
 						if (role === null) {
 							// Temporary: update agent state but don't persist to settings
@@ -393,8 +394,8 @@ export class SelectorController {
 						} else if (role === "default") {
 							// Default: update agent state and persist
 							await this.ctx.session.setModel(model, role);
-							if (thinkingMode && thinkingMode !== "inherit") {
-								this.ctx.session.setThinkingLevel(thinkingMode as ThinkingLevel);
+							if (thinkingLevel && thinkingLevel !== ThinkingLevel.Inherit) {
+								this.ctx.session.setThinkingLevel(thinkingLevel);
 							}
 							this.ctx.statusLine.invalidate();
 							this.ctx.updateEditorBorderColor();

package/src/modes/interactive-mode.ts

@@ -3,7 +3,7 @@
  * Handles TUI rendering and user interaction, delegating business logic to AgentSession.
  */
 import * as path from "node:path";
-import type { Agent, AgentMessage } from "@oh-my-pi/pi-agent-core";
+import { type Agent, type AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { AssistantMessage, ImageContent, Message, Model, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, Loader, SlashCommand } from "@oh-my-pi/pi-tui";
 import {
@@ -423,7 +423,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		} else if (this.isPythonMode) {
 			this.editor.borderColor = theme.getPythonModeBorderColor();
 		} else {
-			const level = this.session.thinkingLevel || "off";
+			const level = this.session.thinkingLevel ?? ThinkingLevel.Off;
 			this.editor.borderColor = theme.getThinkingBorderColor(level);
 		}
 		this.updateEditorTopBorder();

package/src/modes/rpc/rpc-client.ts

@@ -3,8 +3,8 @@
  *
  * Spawns the agent in RPC mode and provides a typed API for all operations.
  */
-import type { AgentEvent, AgentMessage } from "@oh-my-pi/pi-agent-core";
-import type { ImageContent, ThinkingLevel } from "@oh-my-pi/pi-ai";
+import type { AgentEvent, AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort, ImageContent, Model } from "@oh-my-pi/pi-ai";
 import { isRecord, ptree, readJsonl } from "@oh-my-pi/pi-utils";
 import type { BashResult } from "../../exec/bash-executor";
 import type { SessionStats } from "../../session/agent-session";
@@ -34,12 +34,7 @@ export interface RpcClientOptions {
 	args?: string[];
 }
 
-export interface ModelInfo {
-	provider: string;
-	id: string;
-	contextWindow: number;
-	reasoning: boolean;
-}
+export type ModelInfo = Pick<Model, "provider" | "id" | "contextWindow" | "reasoning" | "thinking">;
 
 export type RpcEventListener = (event: AgentEvent) => void;
 
@@ -284,7 +279,7 @@ export class RpcClient {
 	 */
 	async cycleModel(): Promise<{
 		model: { provider: string; id: string };
-		thinkingLevel: ThinkingLevel;
+		thinkingLevel: ThinkingLevel | undefined;
 		isScoped: boolean;
 	} | null> {
 		const response = await this.#send({ type: "cycle_model" });
@@ -309,7 +304,7 @@ export class RpcClient {
 	/**
 	 * Cycle thinking level.
 	 */
-	async cycleThinkingLevel(): Promise<{ level: ThinkingLevel } | null> {
+	async cycleThinkingLevel(): Promise<{ level: Effort } | null> {
 		const response = await this.#send({ type: "cycle_thinking_level" });
 		return this.#getData(response);
 	}

package/src/modes/rpc/rpc-types.ts

@@ -4,8 +4,8 @@
  * Commands are sent as JSON lines on stdin.
  * Responses and events are emitted as JSON lines on stdout.
  */
-import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
-import type { ImageContent, Model, ThinkingLevel } from "@oh-my-pi/pi-ai";
+import type { AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort, ImageContent, Model } from "@oh-my-pi/pi-ai";
 import type { BashResult } from "../../exec/bash-executor";
 import type { SessionStats } from "../../session/agent-session";
 import type { CompactionResult } from "../../session/compaction";
@@ -70,7 +70,7 @@ export type RpcCommand =
 
 export interface RpcSessionState {
 	model?: Model;
-	thinkingLevel: ThinkingLevel;
+	thinkingLevel: ThinkingLevel | undefined;
 	isStreaming: boolean;
 	isCompacting: boolean;
 	steeringMode: "all" | "one-at-a-time";
@@ -114,7 +114,7 @@ export type RpcResponse =
 			type: "response";
 			command: "cycle_model";
 			success: true;
-			data: { model: Model; thinkingLevel: ThinkingLevel; isScoped: boolean } | null;
+			data: { model: Model; thinkingLevel: ThinkingLevel | undefined; isScoped: boolean } | null;
 	  }
 	| {
 			id?: string;
@@ -131,7 +131,7 @@ export type RpcResponse =
 			type: "response";
 			command: "cycle_thinking_level";
 			success: true;
-			data: { level: ThinkingLevel } | null;
+			data: { level: Effort } | null;
 	  }
 
 	// Queue modes

package/src/modes/theme/theme.ts

@@ -1,6 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import type { ThinkingLevel } from "@oh-my-pi/pi-ai";
+import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort } from "@oh-my-pi/pi-ai";
 import {
 	detectMacOSAppearance,
 	type HighlightColors as NativeHighlightColors,
@@ -108,6 +109,7 @@ export type SymbolKey =
 	| "icon.warning"
 	| "icon.rewind"
 	| "icon.auto"
+	| "icon.fast"
 	| "icon.extensionSkill"
 	| "icon.extensionTool"
 	| "icon.extensionSlashCommand"
@@ -268,6 +270,7 @@ const UNICODE_SYMBOLS: SymbolMap = {
 	"icon.warning": "⚠",
 	"icon.rewind": "↶",
 	"icon.auto": "⟲",
+	"icon.fast": "⚡",
 	"icon.extensionSkill": "✦",
 	"icon.extensionTool": "🛠",
 	"icon.extensionSlashCommand": "⌘",
@@ -499,7 +502,7 @@ const NERD_SYMBOLS: SymbolMap = {
 	"icon.rewind": "\uf0e2",
 	// pick: 󰁨 | alt:   
 	"icon.auto": "\u{f0068}",
-	// pick:  | alt:  
+	"icon.fast": "\uf0e7",
 	"icon.extensionSkill": "\uf0eb",
 	// pick:  | alt:  
 	"icon.extensionTool": "\uf0ad",
@@ -680,6 +683,7 @@ const ASCII_SYMBOLS: SymbolMap = {
 	"icon.warning": "[!]",
 	"icon.rewind": "<-",
 	"icon.auto": "[A]",
+	"icon.fast": ">>",
 	"icon.extensionSkill": "SK",
 	"icon.extensionTool": "TL",
 	"icon.extensionSlashCommand": "/",
@@ -1220,7 +1224,7 @@ export class Theme {
 		return this.mode;
 	}
 
-	getThinkingBorderColor(level: ThinkingLevel): (str: string) => string {
+	getThinkingBorderColor(level: ThinkingLevel | Effort): (str: string) => string {
 		// Map thinking levels to dedicated theme colors
 		switch (level) {
 			case "off":
@@ -1381,6 +1385,7 @@ export class Theme {
 			warning: this.#symbols["icon.warning"],
 			rewind: this.#symbols["icon.rewind"],
 			auto: this.#symbols["icon.auto"],
+			fast: this.#symbols["icon.fast"],
 			extensionSkill: this.#symbols["icon.extensionSkill"],
 			extensionTool: this.#symbols["icon.extensionTool"],
 			extensionSlashCommand: this.#symbols["icon.extensionSlashCommand"],

package/src/priority.json

@@ -10,6 +10,7 @@
 		"mini"
 	],
 	"slow": [
+		"gpt-5.4",
 		"gpt-5.3-codex",
 		"gpt-5.3",
 		"gpt-5.2-codex",

package/src/prompts/system/auto-handoff-threshold-focus.md

@@ -0,0 +1 @@
+Threshold-triggered maintenance: preserve critical implementation state and immediate next actions.

package/src/prompts/system/system-prompt.md

@@ -186,7 +186,7 @@ Use the Task tool unless the change is:
 - A direct answer or explanation with no code changes
 - A command the user asked you to run yourself
 
-For everything else — multi-file changes, refactors, new features, test additions, investigations — break the work into tasks and delegate. Err on the side of delegating. You are an orchestrator first, a coder second.
+For everything else — multi-file changes, refactors, new features, test additions, investigations — break the work into tasks and delegate once the target design is settled. Err on the side of delegating after the architectural direction is fixed.
 </eager-tasks>
 {{/if}}
 
@@ -218,6 +218,18 @@ These are inviolable. Violation is system failure.
 6. You **MUST NOT** ask for information obtainable from tools, repo context, or files. File referenced → you **MUST** locate and read it. Path implied → you **MUST** resolve it.
 7. Full CUTOVER is **REQUIRED**. You **MUST** replace old usage everywhere you touch — no backwards-compat shims, no gradual migration, no "keeping both for now." The old way is dead; lingering instances **MUST** be treated as bugs.
 
+# Design Integrity
+- You **MUST** prefer a coherent final design over a minimally invasive patch.
+- You **MUST NOT** preserve obsolete abstractions to reduce edit scope.
+- Temporary bridges are **PROHIBITED** unless the user explicitly asks for a migration path.
+- If a refactor introduces a new canonical abstraction, you **MUST** migrate consumers to it instead of wrapping it in compatibility helpers.
+- Parallel APIs that express the same concept are a bug, not a convenience.
+- Boolean compatibility helpers that collapse richer capability models are **PROHIBITED**.
+- You **MUST NOT** collapse structured capability data into lossy booleans or convenience wrappers unless the domain is truly boolean.
+- If a change removes a field, type, or API, all fixtures, tests, docs, and callsites using it **MUST** be updated in the same change.
+- You **MUST** optimize for the next maintainer's edit, not for minimizing the current diff.
+- "Works" is insufficient. The result **MUST** also be singular, obvious, and maintainable.
+
 # Procedure
 ## 1. Scope
 {{#if skills.length}}- If a skill matches the domain, you **MUST** read it before starting.{{/if}}
@@ -245,6 +257,8 @@ Justify sequential work; default parallel. Cannot articulate why B depends on A
 - You **MUST** write idiomatic, simple, maintainable code. Complexity **MUST** earn its place.
 - You **MUST** fix in the place the bug lives. You **MUST NOT** bandaid the problem within the caller.
 - You **MUST** clean up unused code ruthlessly: dead parameters, unused helpers, orphaned types. You **MUST** delete them and update callers. Resulting code **MUST** be pristine.
+- For every new abstraction, you **MUST** identify what becomes redundant: old helpers, fallback branches, compatibility adapters, duplicate tests, stale fixtures, and docs that describe removed behavior.
+- You **MUST** delete or rewrite redundant code in the same change. Leaving obsolete code reachable, compilable, or tested is a failure of cutover.
 - You **MUST NOT** leave breadcrumbs. When you delete or move code, you **MUST** remove it cleanly — no `// moved to X` comments, no `// relocated` markers, no re-exports from the old location. The old location **MUST** be removed without trace.
 - You **MUST** fix from first principles. You **MUST NOT** apply bandaids. The root cause **MUST** be found and fixed at its source. A symptom suppressed is a bug deferred.
 - When a tool call fails or returns unexpected output, you **MUST** read the full error and diagnose it.
@@ -297,8 +311,10 @@ Today is '{{date}}', and your work begins now. Get it right.
 
 <critical>
 - You **MUST** use the most specialized tool, **NEVER** `cat` if there's tool.bash, `rg/grep`:tool.grep, `find`:tool.find, `sed`:tool.edit…
-- Every turn **MUST** advance the deliverable. A non-final turn without at least one side-effect is **PROHIBITED**.
+- Every turn **MUST** materially advance the deliverable.
 - You **MUST** default to action. You **MUST NOT** ask for confirmation to continue work. If you hit an error, you **MUST** fix it. If you know the next step, you **MUST** take it. The user will intervene if needed.
+- You **MUST NOT** make speculative edits before understanding the surrounding design.
+- You **MUST** default to informed action. You **MUST NOT** ask for confirmation to continue work. If you hit an error, you **MUST** fix it. If you know the next step, you **MUST** take it. The user will intervene if needed.
 - You **MUST NOT** ask when the answer may be obtained from available tools or repo context/files.
 - You **MUST** verify the effect. When a task involves a behavioral change, you **MUST** confirm the change is observable before yielding: run the specific test, command, or scenario that covers your change.
 </critical>