@gajae-code/coding-agent 0.7.8 → 0.7.10

package/src/tools/ask.ts

@@ -62,6 +62,11 @@ const DeepInterviewMeta = z.object({
 	ambiguity: z.number().min(0).max(1).describe("ambiguity at ask time (0..1)"),
 });
 
+const WorkflowGateMeta = z.object({
+	stage: z.enum(["deep-interview", "ralplan", "ultragoal"]).describe("workflow gate stage"),
+	kind: z.enum(["question", "approval", "execution"]).describe("workflow gate kind"),
+});
+
 const QuestionItem = z.object({
 	id: z.string().describe("question id"),
 	question: z.string().describe("question text"),
@@ -69,6 +74,7 @@ const QuestionItem = z.object({
 	multi: z.boolean().describe("allow multiple selections").optional(),
 	recommended: z.number().describe("recommended option index").optional(),
 	deepInterview: DeepInterviewMeta.describe("optional deep-interview round metadata").optional(),
+	workflowGate: WorkflowGateMeta.describe("optional workflow gate stage/kind override").optional(),
 });
 
 export const askSchema = z.object({
@@ -85,6 +91,7 @@ export interface QuestionResult {
 	multi: boolean;
 	selectedOptions: string[];
 	customInput?: string;
+	clarificationQuestion?: string;
 }
 
 export interface AskToolDetails {
@@ -93,6 +100,7 @@ export interface AskToolDetails {
 	multi?: boolean;
 	selectedOptions?: string[];
 	customInput?: string;
+	clarificationQuestion?: string;
 	/** Multi-part question mode */
 	results?: QuestionResult[];
 }
@@ -102,6 +110,7 @@ export interface AskToolDetails {
 // =============================================================================
 
 const OTHER_OPTION = "Other (type your own)";
+const ASK_CLARIFICATION_OPTION = "Ask about these choices";
 const RECOMMENDED_SUFFIX = " (Recommended)";
 const DEEP_INTERVIEW_SELECTOR_SCROLL_TITLE_ROWS = Number.MAX_SAFE_INTEGER;
 const DEEP_INTERVIEW_RECORDER_AWAIT_TIMEOUT_MS = 250;
@@ -177,6 +186,7 @@ function numberOptionLabels(labels: string[]): string[] {
 interface SelectionResult {
 	selectedOptions: string[];
 	customInput?: string;
+	clarificationQuestion?: string;
 	timedOut: boolean;
 	navigation?: "back" | "forward";
 	cancelled?: boolean;
@@ -195,6 +205,7 @@ interface AskSingleQuestionOptions {
 	navigation?: NavigationControls;
 	scrollTitleRows?: number;
 	otherOptionLabel?: string;
+	clarificationOptionLabel?: string;
 }
 
 interface UIContext {
@@ -213,6 +224,7 @@ interface UIContext {
 			onRight?: () => void;
 			helpText?: string;
 			customInput?: { optionLabel: string; onSubmit: (text: string) => void };
+			clarificationInput?: { optionLabel: string; onSubmit: (text: string) => void; allowEmpty?: boolean };
 		},
 	): Promise<string | undefined>;
 	editor(
@@ -233,6 +245,7 @@ async function askSingleQuestion(
 	const { recommended, timeout, signal, initialSelection, navigation, scrollTitleRows } = options;
 	const doneLabel = getDoneOptionLabel();
 	const otherOptionLabel = options.otherOptionLabel ?? OTHER_OPTION;
+	const clarificationOptionLabel = options.clarificationOptionLabel;
 	let selectedOptions = [...(initialSelection?.selectedOptions ?? [])];
 	let customInput = initialSelection?.customInput;
 	let timedOut = false;
@@ -246,15 +259,17 @@ async function askSingleQuestion(
 		timedOut: boolean;
 		navigation?: "back" | "forward";
 		inlineInput?: string;
+		inlineClarification?: string;
 	}> => {
 		let timeoutTriggered = false;
 		const onTimeout = () => {
 			timeoutTriggered = true;
 		};
-		// Inline custom input: the TUI selector keeps the question and option
-		// list on screen and collects the "Other" text below the list, instead
-		// of swapping to a separate editor screen that hides the question.
+		// Inline custom/clarification input: the TUI selector keeps the question
+		// and option list on screen and collects text below the list, instead of
+		// swapping to a separate editor screen that hides the question.
 		let inlineInput: string | undefined;
+		let inlineClarification: string | undefined;
 		let navigationAction: "back" | "forward" | undefined;
 		const baseHelpText = navigation
 			? "up/down navigate  enter select  ←/→ question  esc cancel"
@@ -280,6 +295,15 @@ async function askSingleQuestion(
 					inlineInput = text;
 				},
 			},
+			clarificationInput: clarificationOptionLabel
+				? {
+						optionLabel: clarificationOptionLabel,
+						allowEmpty: false,
+						onSubmit: (text: string) => {
+							inlineClarification = text;
+						},
+					}
+				: undefined,
 			onLeft: navigation?.allowBack
 				? () => {
 						navigationAction = "back";
@@ -298,7 +322,7 @@ async function askSingleQuestion(
 		if (!timeoutTriggered && choice === undefined && typeof timeout === "number") {
 			timeoutTriggered = Date.now() - startMs >= timeout;
 		}
-		return { choice, timedOut: timeoutTriggered, navigation: navigationAction, inlineInput };
+		return { choice, timedOut: timeoutTriggered, navigation: navigationAction, inlineInput, inlineClarification };
 	};
 
 	// Fallback for UI contexts that don't support inline custom input (they
@@ -309,6 +333,13 @@ async function askSingleQuestion(
 		const input = signal ? await untilAborted(signal, showCustomInput) : await showCustomInput();
 		return { input };
 	};
+	const promptForClarificationInput = async (): Promise<{ input: string | undefined }> => {
+		const dialogOptions = signal ? { signal } : undefined;
+		const showClarificationInput = () =>
+			ui.editor("Ask a clarification question:", undefined, dialogOptions, { promptStyle: true });
+		const input = signal ? await untilAborted(signal, showClarificationInput) : await showClarificationInput();
+		return { input: input !== undefined && input.trim() === "" ? undefined : input };
+	};
 
 	const promptWithProgress = navigation?.progressText ? `${question} (${navigation.progressText})` : question;
 	if (multi) {
@@ -331,6 +362,9 @@ async function askSingleQuestion(
 				opts.push(doneLabel);
 			}
 			opts.push(otherOptionLabel);
+			if (clarificationOptionLabel) {
+				opts.push(clarificationOptionLabel);
+			}
 
 			const prefix = selected.size > 0 ? `(${selected.size} selected) ` : "";
 			const {
@@ -338,6 +372,7 @@ async function askSingleQuestion(
 				timedOut: selectTimedOut,
 				navigation: arrowNavigation,
 				inlineInput,
+				inlineClarification,
 			} = await selectOption(`${prefix}${promptWithProgress}`, opts, cursorIndex);
 
 			if (arrowNavigation) {
@@ -364,6 +399,18 @@ async function askSingleQuestion(
 				customInput = input;
 				break;
 			}
+			if (clarificationOptionLabel && choice === clarificationOptionLabel) {
+				if (selectTimedOut) {
+					timedOut = true;
+					break;
+				}
+				const input =
+					inlineClarification !== undefined ? inlineClarification : (await promptForClarificationInput()).input;
+				if (input === undefined) {
+					break;
+				}
+				return { selectedOptions: [], clarificationQuestion: input, timedOut };
+			}
 
 			const selectedIdx = opts.indexOf(choice);
 			if (selectedIdx >= 0) {
@@ -394,7 +441,9 @@ async function askSingleQuestion(
 		selectedOptions = Array.from(selected);
 	} else {
 		const displayLabels = addRecommendedSuffix(optionLabels, recommended);
-		const optionsWithNavigation = [...displayLabels, otherOptionLabel];
+		const optionsWithNavigation = clarificationOptionLabel
+			? [...displayLabels, otherOptionLabel, clarificationOptionLabel]
+			: [...displayLabels, otherOptionLabel];
 
 		let initialIndex = recommended;
 		const previouslySelected = selectedOptions[0];
@@ -414,6 +463,7 @@ async function askSingleQuestion(
 			timedOut: selectTimedOut,
 			navigation: arrowNavigation,
 			inlineInput,
+			inlineClarification,
 		} = await selectOption(promptWithProgress, optionsWithNavigation, initialIndex);
 		timedOut = selectTimedOut;
 
@@ -433,6 +483,15 @@ async function askSingleQuestion(
 				}
 				// If input was dismissed (undefined), keep prior selectedOptions/customInput intact
 			}
+		} else if (clarificationOptionLabel && choice === clarificationOptionLabel) {
+			if (!selectTimedOut) {
+				const input =
+					inlineClarification !== undefined ? inlineClarification : (await promptForClarificationInput()).input;
+				if (input !== undefined) {
+					return { selectedOptions: [], clarificationQuestion: input, timedOut };
+				}
+				// If input was dismissed (undefined), keep prior selectedOptions/customInput intact
+			}
 		} else {
 			const stripped = stripRecommendedSuffix(choice);
 			if (optionLabels.includes(stripped)) {
@@ -460,6 +519,9 @@ async function askSingleQuestion(
 }
 
 function formatQuestionResult(result: QuestionResult): string {
+	if (result.clarificationQuestion !== undefined) {
+		return `${result.id}: clarification requested: ${result.clarificationQuestion}`;
+	}
 	if (result.customInput !== undefined) {
 		return `${result.id}: "${result.customInput}"`;
 	}
@@ -551,7 +613,10 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 		_onUpdate?: AgentToolUpdateCallback<AskToolDetails>,
 		context?: AgentToolContext,
 	): Promise<AgentToolResult<AskToolDetails>> {
-		await assertUltragoalAskAllowed(this.session.cwd);
+		await assertUltragoalAskAllowed(this.session.cwd, {
+			activeSkillState: this.session.getActiveSkillState?.(),
+			sessionId: this.session.getSessionId?.() ?? null,
+		});
 		const gateEmitter = this.session.getWorkflowGateEmitter?.();
 		const canUseWorkflowGate = gateEmitter?.isUnattended() === true;
 
@@ -665,6 +730,7 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 					multi: q.multi,
 					recommended: q.recommended,
 					deepInterview: q.deepInterview,
+					workflowGate: q.workflowGate,
 				};
 				const answer = await gateEmitter.emitGate(questionToGate(gateQuestion));
 				const decoded = gateAnswerToResult(gateQuestion, answer);
@@ -672,6 +738,7 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 					optionLabels: rawOptionLabels,
 					selectedOptions: decoded.selectedOptions,
 					customInput: decoded.customInput,
+					clarificationQuestion: decoded.clarificationQuestion,
 					navigation: undefined as NavigationControls | undefined,
 					cancelled: false,
 					timedOut: false,
@@ -683,6 +750,9 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 				const displayQuestion = deepInterviewPrompt ?? q.question;
 				const shouldNumberOptions = isDeepInterviewQuestion || isDeepInterviewAskQuestion(q.question);
 				const optionLabels = shouldNumberOptions ? numberOptionLabels(rawOptionLabels) : rawOptionLabels;
+				const clarificationOptionLabel = shouldNumberOptions
+					? formatNumberedOptionLabel(ASK_CLARIFICATION_OPTION, optionLabels.length + 1)
+					: undefined;
 				const initialSelection =
 					shouldNumberOptions && options?.previous
 						? {
@@ -696,6 +766,7 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 				const {
 					selectedOptions: displaySelectedOptions,
 					customInput,
+					clarificationQuestion,
 					navigation,
 					cancelled,
 					timedOut,
@@ -709,6 +780,7 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 					otherOptionLabel: shouldNumberOptions
 						? formatNumberedOptionLabel(OTHER_OPTION, optionLabels.length)
 						: undefined,
+					clarificationOptionLabel,
 				});
 				const selectedOptions = shouldNumberOptions
 					? displaySelectedOptions.map(selected => {
@@ -716,7 +788,15 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 							return displayIndex >= 0 ? (rawOptionLabels[displayIndex] ?? selected) : selected;
 						})
 					: displaySelectedOptions;
-				return { optionLabels: rawOptionLabels, selectedOptions, customInput, navigation, cancelled, timedOut };
+				return {
+					optionLabels: rawOptionLabels,
+					selectedOptions,
+					customInput,
+					clarificationQuestion,
+					navigation,
+					cancelled,
+					timedOut,
+				};
 			} catch (error) {
 				if (error instanceof Error && error.name === "AbortError") {
 					throw new ToolAbortError("Ask input was cancelled");
@@ -727,22 +807,40 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 
 		if (params.questions.length === 1) {
 			const [q] = params.questions;
-			const { optionLabels, selectedOptions, customInput, cancelled, timedOut } = await askQuestion(q);
-
-			if (!timedOut && (cancelled || (selectedOptions.length === 0 && customInput === undefined))) {
+			const { optionLabels, selectedOptions, customInput, clarificationQuestion, cancelled, timedOut } =
+				await askQuestion(q);
+
+			if (
+				!timedOut &&
+				(cancelled ||
+					(selectedOptions.length === 0 && customInput === undefined && clarificationQuestion === undefined))
+			) {
 				context?.abort();
 				throw new ToolAbortError("Ask tool was cancelled by the user");
 			}
-			await this.#recordDeepInterviewRound(q, selectedOptions, customInput);
+			if (clarificationQuestion === undefined) {
+				await this.#recordDeepInterviewRound(q, selectedOptions, customInput);
+			}
 			const details: AskToolDetails = {
 				question: q.question,
 				options: optionLabels,
 				multi: q.multi ?? false,
 				selectedOptions,
 				customInput,
+				clarificationQuestion,
 			};
 
 			const responseParts: string[] = [];
+			if (clarificationQuestion !== undefined) {
+				responseParts.push(
+					clarificationQuestion.includes("\n")
+						? `User asked a clarification question about the choices:\n${clarificationQuestion
+								.split("\n")
+								.map(line => `  ${line}`)
+								.join("\n")}`
+						: `User asked a clarification question about the choices: ${clarificationQuestion}`,
+				);
+			}
 			if (selectedOptions.length > 0) {
 				responseParts.push(
 					q.multi ? `User selected: ${selectedOptions.join(", ")}` : `User selected: ${selectedOptions[0]}`,
@@ -777,6 +875,7 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 				optionLabels,
 				selectedOptions,
 				customInput,
+				clarificationQuestion,
 				navigation: navAction,
 				cancelled,
 				timedOut,
@@ -794,9 +893,12 @@ export class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
 				multi: q.multi ?? false,
 				selectedOptions,
 				customInput,
+				clarificationQuestion,
 			};
 
-			await this.#recordDeepInterviewRound(q, selectedOptions, customInput);
+			if (clarificationQuestion === undefined) {
+				await this.#recordDeepInterviewRound(q, selectedOptions, customInput);
+			}
 
 			if (navAction === "back") {
 				questionIndex = Math.max(0, questionIndex - 1);
@@ -985,7 +1087,10 @@ export const askToolRenderer = {
 		// Multi-part results
 		if (details.results && details.results.length > 0) {
 			const hasAnySelection = details.results.some(
-				r => r.customInput !== undefined || (r.selectedOptions && r.selectedOptions.length > 0),
+				r =>
+					r.clarificationQuestion !== undefined ||
+					r.customInput !== undefined ||
+					(r.selectedOptions && r.selectedOptions.length > 0),
 			);
 			const header = renderStatusLine(
 				{
@@ -1003,7 +1108,8 @@ export const askToolRenderer = {
 				const isLastQuestion = i === details.results.length - 1;
 				const branch = isLastQuestion ? uiTheme.tree.last : uiTheme.tree.branch;
 				const continuation = isLastQuestion ? "   " : `${uiTheme.fg("dim", uiTheme.tree.vertical)}  `;
-				const hasSelection = r.customInput !== undefined || r.selectedOptions.length > 0;
+				const hasSelection =
+					r.clarificationQuestion !== undefined || r.customInput !== undefined || r.selectedOptions.length > 0;
 				const statusIcon = hasSelection
 					? uiTheme.styledSymbol("status.success", "success")
 					: uiTheme.styledSymbol("status.warning", "warning");
@@ -1018,7 +1124,10 @@ export const askToolRenderer = {
 
 				const answerLines: string[] = [];
 				for (let j = 0; j < r.selectedOptions.length; j++) {
-					const isLast = j === r.selectedOptions.length - 1 && r.customInput === undefined;
+					const isLast =
+						j === r.selectedOptions.length - 1 &&
+						r.customInput === undefined &&
+						r.clarificationQuestion === undefined;
 					const optBranch = isLast ? uiTheme.tree.last : uiTheme.tree.branch;
 					const selectedLabel = renderInlineMarkdown(r.selectedOptions[j], mdTheme, t =>
 						uiTheme.fg("toolOutput", t),
@@ -1032,6 +1141,14 @@ export const askToolRenderer = {
 				}
 				if (r.customInput !== undefined) {
 					container.addChild(new Text(renderCustomInput(uiTheme, continuation, r.customInput, true, false), 0, 0));
+				} else if (r.clarificationQuestion !== undefined) {
+					container.addChild(
+						new Text(
+							renderCustomInput(uiTheme, continuation, `Clarification: ${r.clarificationQuestion}`, true, false),
+							0,
+							0,
+						),
+					);
 				} else if (r.selectedOptions.length === 0) {
 					container.addChild(
 						new Text(
@@ -1053,7 +1170,9 @@ export const askToolRenderer = {
 		}
 
 		const hasSelection =
-			details.customInput !== undefined || (details.selectedOptions && details.selectedOptions.length > 0);
+			details.clarificationQuestion !== undefined ||
+			details.customInput !== undefined ||
+			(details.selectedOptions && details.selectedOptions.length > 0);
 		const header = renderStatusLine({ icon: hasSelection ? "success" : "warning", title: "Ask" }, uiTheme);
 		const container = new Container();
 		container.addChild(new Text(header, 0, 0));
@@ -1065,7 +1184,10 @@ export const askToolRenderer = {
 		const answerLines: string[] = [];
 		if (details.selectedOptions && details.selectedOptions.length > 0) {
 			for (let i = 0; i < details.selectedOptions.length; i++) {
-				const isLast = i === details.selectedOptions.length - 1 && details.customInput === undefined;
+				const isLast =
+					i === details.selectedOptions.length - 1 &&
+					details.customInput === undefined &&
+					details.clarificationQuestion === undefined;
 				const branch = isLast ? uiTheme.tree.last : uiTheme.tree.branch;
 				const selectedLabel = renderInlineMarkdown(details.selectedOptions[i], mdTheme, t =>
 					uiTheme.fg("toolOutput", t),
@@ -1080,6 +1202,14 @@ export const askToolRenderer = {
 		}
 		if (details.customInput !== undefined) {
 			container.addChild(new Text(renderCustomInput(uiTheme, " ", details.customInput, true, false), 0, 0));
+		} else if (details.clarificationQuestion !== undefined) {
+			container.addChild(
+				new Text(
+					renderCustomInput(uiTheme, " ", `Clarification: ${details.clarificationQuestion}`, true, false),
+					0,
+					0,
+				),
+			);
 		} else if (!details.selectedOptions || details.selectedOptions.length === 0) {
 			container.addChild(
 				new Text(

package/src/tools/eval.ts

@@ -754,8 +754,8 @@ function formatStatusEventExpanded(event: EvalStatusEvent, theme: Theme): string
 		case "git_log":
 			if (data.entries) {
 				addItems(data.entries as unknown[], e => {
-					const entry = e as { sha: string; subject: string };
-					return `${entry.sha} ${truncateToWidth(entry.subject, 50)}`;
+					const entry = e as { sha?: string; subject?: string };
+					return `${String(entry.sha ?? "")} ${truncateToWidth(String(entry.subject ?? ""), 50)}`;
 				});
 			}
 			break;

package/src/tools/render-utils.ts

@@ -86,6 +86,7 @@ export const EXPAND_HINT = "(Ctrl+O for more)";
  * Get first N lines of text as preview, with each line truncated.
  */
 export function getPreviewLines(text: string, maxLines: number, maxLineLen: number, ellipsis?: Ellipsis): string[] {
+	if (typeof text !== "string") return [];
 	const lines = text.split("\n").filter(l => l.trim());
 	return lines.slice(0, maxLines).map(l => truncateToWidth(l.trim(), maxLineLen, ellipsis));
 }
@@ -568,6 +569,7 @@ export function truncateDiffByHunk(
 // =============================================================================
 
 export function shortenPath(filePath: string, homeDir?: string): string {
+	if (typeof filePath !== "string") return "";
 	const home = homeDir ?? os.homedir();
 	if (home && filePath.startsWith(home)) {
 		return `~${filePath.slice(home.length)}`;

package/src/tools/ultragoal-ask-guard.ts

@@ -10,6 +10,29 @@ const ULTRAGOAL_ASK_GUARD = Symbol.for("gajae-code.ultragoalAskGuard");
 
 type GuardedTool = AgentTool & { [ULTRAGOAL_ASK_GUARD]?: true };
 
+export interface UltragoalAskGuardContext {
+	activeSkillState?: { skill?: string; session_id?: string } | null;
+	sessionId?: string | null;
+}
+
+const UPSTREAM_PLANNING_ASK_SKILLS = new Set(["deep-interview", "ralplan"]);
+
+function normalizedActiveSkill(context?: UltragoalAskGuardContext): string | undefined {
+	const skill = context?.activeSkillState?.skill?.trim();
+	return skill || undefined;
+}
+
+function sessionScopedAskGuardId(
+	context: UltragoalAskGuardContext,
+	activeSkill: string | undefined,
+): string | undefined {
+	if (activeSkill !== "ultragoal" && !UPSTREAM_PLANNING_ASK_SKILLS.has(activeSkill ?? "")) return undefined;
+	const activeSessionId = context.activeSkillState?.session_id?.trim();
+	if (activeSessionId) return activeSessionId;
+	const sessionId = context.sessionId?.trim();
+	return sessionId || undefined;
+}
+
 export function formatUltragoalAskBlockMessage(diagnostic: UltragoalAskBlockDiagnostic): string {
 	return [
 		diagnostic.message,
@@ -18,15 +41,26 @@ export function formatUltragoalAskBlockMessage(diagnostic: UltragoalAskBlockDiag
 	].join("\n");
 }
 
-export async function assertUltragoalAskAllowed(cwd: string): Promise<void> {
-	const diagnostic = await isUltragoalAskBlocked(cwd);
+export async function assertUltragoalAskAllowed(cwd: string, context: UltragoalAskGuardContext = {}): Promise<void> {
+	const activeSkill = normalizedActiveSkill(context);
+	// Deep-interview and ralplan are upstream planning workflows whose core gates
+	// are `ask` calls. Scope their Ultragoal check to the current session so stale
+	// or ambiguous Ultragoal durable state from another session cannot hijack those
+	// prompts; same-session active Ultragoal state still falls through to the
+	// blocker/nudge checks below.
+	const sessionId = sessionScopedAskGuardId(context, activeSkill);
+	const diagnostic = await isUltragoalAskBlocked(cwd, { sessionId });
 	if (!diagnostic.active) return;
-	const nudge = await consumeUltragoalAskNudge(cwd);
+	const nudge = await consumeUltragoalAskNudge(cwd, sessionId);
 	if (nudge.nudged) throw new ToolError(nudge.message);
 	throw new ToolError(formatUltragoalAskBlockMessage(diagnostic));
 }
 
-export function guardToolForUltragoalAsk<T extends AgentTool>(tool: T, getCwd: () => string): T {
+export function guardToolForUltragoalAsk<T extends AgentTool>(
+	tool: T,
+	getCwd: () => string,
+	getContext: () => UltragoalAskGuardContext = () => ({}),
+): T {
 	if (tool.name !== "ask") return tool;
 	const candidate = tool as GuardedTool;
 	if (candidate[ULTRAGOAL_ASK_GUARD]) return tool;
@@ -35,7 +69,7 @@ export function guardToolForUltragoalAsk<T extends AgentTool>(tool: T, getCwd: (
 			if (prop === ULTRAGOAL_ASK_GUARD) return true;
 			if (prop !== "execute") return Reflect.get(target, prop, receiver);
 			return async (...args: unknown[]): Promise<unknown> => {
-				await assertUltragoalAskAllowed(getCwd());
+				await assertUltragoalAskAllowed(getCwd(), getContext());
 				return Reflect.apply(target.execute, target, args);
 			};
 		},

package/src/utils/cmux-workspace.ts

@@ -0,0 +1,106 @@
+import { logger } from "@gajae-code/utils";
+
+const CMUX_COMMAND = "cmux";
+const CMUX_WORKSPACE_ID_ENV = "CMUX_WORKSPACE_ID";
+const CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/g;
+const CMUX_WORKSPACE_RENAME_TIMEOUT_MS = 1500;
+
+export interface CmuxWorkspaceRenameCommand {
+	command: string;
+	args: string[];
+}
+
+export interface CmuxWorkspaceRenameProcess {
+	exited: Promise<number>;
+	kill(): void;
+	unref(): void;
+}
+
+export interface CmuxWorkspaceTitleSyncOptions {
+	env?: NodeJS.ProcessEnv;
+	isTty?: boolean;
+	which?: (command: string) => string | null;
+	spawn?: (
+		command: string[],
+		options: { env: NodeJS.ProcessEnv; stdin: "ignore"; stdout: "ignore"; stderr: "ignore" },
+	) => CmuxWorkspaceRenameProcess;
+}
+
+function defaultSpawn(
+	command: string[],
+	options: { env: NodeJS.ProcessEnv; stdin: "ignore"; stdout: "ignore"; stderr: "ignore" },
+): CmuxWorkspaceRenameProcess {
+	return Bun.spawn(command, options);
+}
+
+export function sanitizeCmuxWorkspaceTitle(title: string | undefined): string | undefined {
+	if (!title) return undefined;
+	const sanitized = title.replace(CONTROL_CHARS, " ").replace(/\s+/g, " ").trim();
+	return sanitized || undefined;
+}
+
+export function buildCmuxWorkspaceRenameCommand(
+	sessionName: string | undefined,
+	env: NodeJS.ProcessEnv = process.env,
+): CmuxWorkspaceRenameCommand | null {
+	const workspaceId = env[CMUX_WORKSPACE_ID_ENV]?.trim();
+	if (!workspaceId) return null;
+
+	const title = sanitizeCmuxWorkspaceTitle(sessionName);
+	if (!title) return null;
+
+	return {
+		command: CMUX_COMMAND,
+		args: ["workspace", "rename", workspaceId, "--title", title],
+	};
+}
+
+export function syncCmuxWorkspaceTitle(
+	sessionName: string | undefined,
+	options: CmuxWorkspaceTitleSyncOptions = {},
+): void {
+	const isTty = options.isTty ?? process.stdout.isTTY === true;
+	if (!isTty) return;
+
+	const env = options.env ?? process.env;
+	const plan = buildCmuxWorkspaceRenameCommand(sessionName, env);
+	if (!plan) return;
+
+	const which = options.which ?? Bun.which;
+	let resolvedCommand: string | null;
+	try {
+		resolvedCommand = which(plan.command);
+	} catch (error) {
+		logger.debug("cmux workspace rename command lookup failed", { error: String(error) });
+		return;
+	}
+	if (!resolvedCommand) return;
+
+	const spawn = options.spawn ?? defaultSpawn;
+	try {
+		const proc = spawn([resolvedCommand, ...plan.args], {
+			env,
+			stdin: "ignore",
+			stdout: "ignore",
+			stderr: "ignore",
+		});
+		proc.unref();
+		const timer = setTimeout(() => {
+			try {
+				proc.kill();
+			} catch {}
+		}, CMUX_WORKSPACE_RENAME_TIMEOUT_MS);
+		timer.unref?.();
+		void proc.exited
+			.then(exitCode => {
+				clearTimeout(timer);
+				if (exitCode !== 0) logger.debug("cmux workspace rename exited non-zero", { exitCode });
+			})
+			.catch(error => {
+				clearTimeout(timer);
+				logger.debug("cmux workspace rename failed", { error: String(error) });
+			});
+	} catch (error) {
+		logger.debug("cmux workspace rename failed to start", { error: String(error) });
+	}
+}

package/src/utils/title-generator.ts

@@ -9,6 +9,7 @@ import type { ModelRegistry } from "../config/model-registry";
 import { resolveRoleSelection } from "../config/model-resolver";
 import type { Settings } from "../config/settings";
 import titleSystemPrompt from "../prompts/system/title-system.md" with { type: "text" };
+import { syncCmuxWorkspaceTitle } from "./cmux-workspace";
 
 const TITLE_SYSTEM_PROMPT = prompt.render(titleSystemPrompt);
 
@@ -218,6 +219,7 @@ export function setTerminalTitle(title: string): void {
 
 export function setSessionTerminalTitle(sessionName: string | undefined, cwd?: string): void {
 	setTerminalTitle(formatSessionTerminalTitle(sessionName, cwd));
+	syncCmuxWorkspaceTitle(sessionName);
 }
 
 /**