@bike4mind/cli 0.7.0 → 0.8.1

package/dist/{ConfigStore-Bu_plzvP.mjs → ConfigStore-Bj1IOvWn.mjs}

@@ -862,9 +862,27 @@ const GenericCreditDeductTransaction = BaseCreditTransaction.extend({
 	*/
 	userId: z.string().optional(),
 	/**
-	* Optional reason/source for the transaction (e.g., 'admin_adjustment', 'legacy_usage', 'manual_deduction')
+	* Reason/source for the transaction. Use GenericDeductReasons for new callers.
 	*/
-	reason: z.string().optional()
+	reason: z.enum([
+		"dispute_clawback",
+		"refund_clawback",
+		"payment_failed_clawback",
+		"notebook_curation",
+		"manual",
+		"admin_adjustment",
+		"refund_adjustment"
+	]).optional(),
+	/**
+	* Stripe dispute ID — set for dispute clawback transactions.
+	* Used for idempotency (unique sparse index prevents duplicate clawbacks).
+	*/
+	stripeDisputeId: z.string().optional(),
+	/**
+	* Stripe refund ID — set for refund clawback transactions.
+	* Used for idempotency (unique sparse index prevents duplicate clawbacks).
+	*/
+	stripeRefundId: z.string().optional()
 });
 const TextGenerationUsageTransaction = BaseCreditTransaction.extend({
 	type: z.literal("text_generation_usage"),

package/dist/commands/doctorCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as version, n as compareSemver, r as fetchLatestVersion } from "../updateChecker-Dn-Ri8zw.mjs";
+import { a as version, n as compareSemver, r as fetchLatestVersion } from "../updateChecker-BVKr0OXs.mjs";
 import { execSync } from "child_process";
 import { constants, existsSync, promises } from "fs";
 import { homedir } from "os";

package/dist/commands/headlessCommand.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { $ as SessionStore, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, I as generateCliTools, J as isReadOnlyTool, K as buildSystemPrompt, M as loadContextFiles, N as getApiUrl, O as McpManager, S as ApiClient, T as FallbackLlmBackend, W as setWebSocketToolExecutor, X as CustomCommandStore, Y as ReActAgent, Z as CheckpointStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, m as createCoordinateTaskTool, p as createWriteTodosTool, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-DY-JzNoY.mjs";
-import { n as logger, t as ConfigStore } from "../ConfigStore-Bu_plzvP.mjs";
+import { C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, I as generateCliTools, M as loadContextFiles, N as getApiUrl, O as McpManager, Q as CheckpointStore, S as ApiClient, T as FallbackLlmBackend, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, m as createCoordinateTaskTool, p as createWriteTodosTool, q as buildSystemPrompt, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-DDoiKdgk.mjs";
+import { n as logger, t as ConfigStore } from "../ConfigStore-Bj1IOvWn.mjs";
 import { t as DEFAULT_SANDBOX_CONFIG } from "../types-DBEjF9YS.mjs";
 import { t as createSandboxRuntime } from "../SandboxRuntimeAdapter-C1B4t20N.mjs";
 import { t as SandboxOrchestrator } from "../SandboxOrchestrator-BEW3rqYi.mjs";

package/dist/commands/mcpCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-Bu_plzvP.mjs";
+import { t as ConfigStore } from "../ConfigStore-Bj1IOvWn.mjs";
 //#region src/commands/mcpCommand.ts
 /**
 * External MCP commands (b4m mcp list, b4m mcp add, etc.)

package/dist/commands/updateCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as version, i as forceCheckForUpdate } from "../updateChecker-Dn-Ri8zw.mjs";
+import { a as version, i as forceCheckForUpdate } from "../updateChecker-BVKr0OXs.mjs";
 import { execSync } from "child_process";
 //#region src/commands/updateCommand.ts
 /**

package/dist/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { n as useCliStore, t as selectActiveBackgroundAgents } from "./store-FkY4K-0M.mjs";
-import { $ as SessionStore, A as formatStep, B as DEFAULT_RETRY_CONFIG, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, G as OllamaBackend, H as clearFeatureModuleTools, I as generateCliTools, J as isReadOnlyTool, K as buildSystemPrompt, L as ALWAYS_DENIED_FOR_AGENTS, M as loadContextFiles, N as getApiUrl, O as McpManager, P as getEnvironmentName, Q as CommandHistoryStore, R as DEFAULT_AGENT_MODEL, S as ApiClient, T as FallbackLlmBackend, U as registerFeatureModuleTools, V as DEFAULT_THOROUGHNESS, W as setWebSocketToolExecutor, X as CustomCommandStore, Y as ReActAgent, Z as CheckpointStore, _ as createAgentDelegateTool, a as createBlockerTools, at as formatFileSize, b as createSkillTool, c as createDecisionStore, d as createFindDefinitionTool, et as OAuthClient, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as mergeCommands, j as extractCompactInstructions, k as substituteArguments, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as processFileReferences, o as formatBlockersOutput, ot as searchFiles, p as createWriteTodosTool, q as buildSkillsPromptSection, r as formatReviewGatesOutput, rt as searchCommands, s as createDecisionLogTool, st as warmFileCache, t as createReviewGateStore, tt as hasFileReferences, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_MAX_ITERATIONS } from "./tools-DY-JzNoY.mjs";
-import { Mt as validateNotebookPath$1, g as ChatModels, jt as validateJupyterKernelName, m as CREDIT_DEDUCT_TRANSACTION_TYPES, n as logger, t as ConfigStore } from "./ConfigStore-Bu_plzvP.mjs";
-import { a as version, t as checkForUpdate } from "./updateChecker-Dn-Ri8zw.mjs";
+import { n as useCliStore, t as selectActiveBackgroundAgents } from "./store-B0ImnWR4.mjs";
+import { $ as CommandHistoryStore, A as formatStep, B as DEFAULT_RETRY_CONFIG, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, G as OllamaBackend, H as clearFeatureModuleTools, I as generateCliTools, J as buildSkillsPromptSection, K as getPlanModeFilePath, L as ALWAYS_DENIED_FOR_AGENTS, M as loadContextFiles, N as getApiUrl, O as McpManager, P as getEnvironmentName, Q as CheckpointStore, R as DEFAULT_AGENT_MODEL, S as ApiClient, T as FallbackLlmBackend, U as registerFeatureModuleTools, V as DEFAULT_THOROUGHNESS, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, a as createBlockerTools, at as mergeCommands, b as createSkillTool, c as createDecisionStore, ct as warmFileCache, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as searchCommands, j as extractCompactInstructions, k as substituteArguments, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as hasFileReferences, o as formatBlockersOutput, ot as formatFileSize, p as createWriteTodosTool, q as buildSystemPrompt, r as formatReviewGatesOutput, rt as processFileReferences, s as createDecisionLogTool, st as searchFiles, t as createReviewGateStore, tt as OAuthClient, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_MAX_ITERATIONS } from "./tools-DDoiKdgk.mjs";
+import { Mt as validateNotebookPath$1, g as ChatModels, jt as validateJupyterKernelName, m as CREDIT_DEDUCT_TRANSACTION_TYPES, n as logger, t as ConfigStore } from "./ConfigStore-Bj1IOvWn.mjs";
+import { a as version, t as checkForUpdate } from "./updateChecker-BVKr0OXs.mjs";
 import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
-import { Box, Static, Text, render, useApp, useInput } from "ink";
+import { Box, Static, Text, render, useApp, useInput, usePaste } from "ink";
 import { execSync } from "child_process";
 import { randomBytes, randomUUID } from "crypto";
 import { existsSync, promises, readFileSync, statSync } from "fs";
@@ -25,16 +25,19 @@ import { get_encoding } from "tiktoken";
 import WsWebSocket from "ws";
 //#region src/components/StatusBar.tsx
 const StatusBar = React.memo(function StatusBar({ sessionName, model, tokenUsage, creditsUsage }) {
-	const autoAcceptEdits = useCliStore((state) => state.autoAcceptEdits);
+	const interactionMode = useCliStore((state) => state.interactionMode);
 	return /* @__PURE__ */ React.createElement(Box, {
 		flexDirection: "row",
 		justifyContent: "space-between",
 		width: "100%",
 		paddingX: 1
-	}, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, sessionName), /* @__PURE__ */ React.createElement(Box, { gap: 2 }, autoAcceptEdits && /* @__PURE__ */ React.createElement(Text, {
+	}, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, sessionName), /* @__PURE__ */ React.createElement(Box, { gap: 2 }, interactionMode === "auto-accept" && /* @__PURE__ */ React.createElement(Text, {
 		color: "green",
 		bold: true
-	}, "AUTO ACCEPT: Edits"), tokenUsage > 0 && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, tokenUsage.toLocaleString(), " tokens"), creditsUsage !== void 0 && creditsUsage > 0 && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, creditsUsage.toLocaleString(), " ", creditsUsage === 1 ? "credit" : "credits"), /* @__PURE__ */ React.createElement(Text, { dimColor: true }, model)));
+	}, "AUTO ACCEPT: Edits"), interactionMode === "plan" && /* @__PURE__ */ React.createElement(Text, {
+		color: "yellow",
+		bold: true
+	}, "PLAN MODE"), tokenUsage > 0 && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, tokenUsage.toLocaleString(), " tokens"), creditsUsage !== void 0 && creditsUsage > 0 && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, creditsUsage.toLocaleString(), " ", creditsUsage === 1 ? "credit" : "credits"), /* @__PURE__ */ React.createElement(Text, { dimColor: true }, model)));
 });
 /**
 * Maximum paste size in characters (~500KB) to prevent memory issues
@@ -74,6 +77,20 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 		while (pos < text.length && /\s/.test(text[pos])) pos++;
 		return pos;
 	};
+	usePaste((text) => {
+		const normalized = (text.length > 5e5 ? text.slice(0, MAX_PASTE_SIZE) : text).replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+		if (normalized.split("\n").length >= 5 && onPaste) {
+			onPaste(normalized);
+			return;
+		}
+		if (pasteIndicator) {
+			emitChange(normalized);
+			setCursorOffset(normalized.length);
+			return;
+		}
+		emitChange(value.slice(0, cursorOffset) + normalized + value.slice(cursorOffset));
+		setCursorOffset(cursorOffset + normalized.length);
+	}, { isActive: !disabled });
 	useInput((input, key) => {
 		if (key.return && !key.meta && !key.shift) {
 			if (value.length > 0 && value[cursorOffset - 1] === "\\") {
@@ -98,7 +115,7 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 				setCursorOffset(findNextWordBoundary(value, cursorOffset));
 				return;
 			}
-			if (key.backspace || key.delete) {
+			if (key.backspace) {
 				const beforeCursor = value.slice(0, cursorOffset);
 				const afterCursor = value.slice(cursorOffset);
 				const newPos = findPreviousWordBoundary(beforeCursor, beforeCursor.length);
@@ -106,6 +123,13 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 				setCursorOffset(newPos);
 				return;
 			}
+			if (key.delete) {
+				const beforeCursor = value.slice(0, cursorOffset);
+				const afterCursor = value.slice(cursorOffset);
+				const newPos = findNextWordBoundary(afterCursor, 0);
+				emitChange(beforeCursor + afterCursor.slice(newPos));
+				return;
+			}
 		} else {
 			if (key.leftArrow) {
 				setCursorOffset(0);
@@ -115,11 +139,15 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 				setCursorOffset(value.length);
 				return;
 			}
-			if (key.backspace || key.delete) {
+			if (key.backspace) {
 				emitChange(value.slice(cursorOffset));
 				setCursorOffset(0);
 				return;
 			}
+			if (key.delete) {
+				emitChange(value.slice(0, cursorOffset));
+				return;
+			}
 		}
 		if (key.home) {
 			setCursorOffset(0);
@@ -188,7 +216,7 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 				}
 				return;
 		}
-		if (key.backspace || key.delete) {
+		if (key.backspace) {
 			if (pasteIndicator) {
 				emitChange("");
 				setCursorOffset(0);
@@ -200,6 +228,15 @@ function CustomTextInput({ value, onChange, onSubmit, onPaste, pasteIndicator, p
 			}
 			return;
 		}
+		if (key.delete) {
+			if (pasteIndicator) {
+				emitChange("");
+				setCursorOffset(0);
+				return;
+			}
+			if (cursorOffset < value.length) emitChange(value.slice(0, cursorOffset) + value.slice(cursorOffset + 1));
+			return;
+		}
 		if (key.leftArrow && !key.meta && !key.ctrl) {
 			setCursorOffset(Math.max(0, cursorOffset - 1));
 			return;
@@ -721,10 +758,9 @@ function InputPrompt({ onSubmit, onBashCommand, onImageDetected, disabled = fals
 		setFileAutocomplete(null);
 	};
 	const handlePaste = (content) => {
-		const truncated = content.length > 5e5 ? content.slice(0, MAX_PASTE_SIZE) : content;
-		const lineCount = truncated.split("\n").length;
+		const lineCount = content.split("\n").length;
 		const prefix = value.trim();
-		setPastedContent(prefix ? `${prefix}\n${truncated}` : truncated, lineCount);
+		setPastedContent(prefix ? `${prefix}\n${content}` : content, lineCount);
 	};
 	const handleChange = async (newValue) => {
 		if (pastedContent) clearPaste();
@@ -1403,7 +1439,7 @@ function ReviewGatePrompt({ description, options, recommendation, onResponse })
 		onChange: setNote,
 		onSubmit: handleConfirm,
 		placeholder: "Type a note and press Enter…"
-	}))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, noteMode ? "Type note + Enter to submit, ↑↓ to switch action" : "Press 1-4, y/n, or ↑↓ + Enter")));
+	}))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, noteMode ? note.trim().length === 0 ? "Note required — type a note + Enter to submit, ↑↓ to switch action" : "Type note + Enter to submit, ↑↓ to switch action" : "Press 1-4, y/n, or ↑↓ + Enter")));
 }
 //#endregion
 //#region src/components/ConfigEditor.tsx
@@ -1856,21 +1892,22 @@ function McpViewer({ config, mcpManager, onClose }) {
 }
 //#endregion
 //#region src/components/MarkdownRenderer.tsx
-function MarkdownRenderer({ content }) {
+function MarkdownRenderer({ content, columns: columnsProp }) {
+	const columns = columnsProp ?? process.stdout.columns ?? 80;
 	const tokens = marked.lexer(content);
-	return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, tokens.map((token, idx) => renderToken(token, idx)));
+	return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, tokens.map((token, idx) => renderToken(token, idx, columns)));
 }
-function renderToken(token, idx) {
+function renderToken(token, idx, columns) {
 	switch (token.type) {
 		case "heading": return renderHeading(token, idx);
 		case "code": return renderCodeBlock(token, idx);
 		case "paragraph": return renderParagraph(token, idx);
 		case "list": return renderList(token, idx);
-		case "blockquote": return renderBlockquote(token, idx);
+		case "blockquote": return renderBlockquote(token, idx, columns);
 		case "hr": return /* @__PURE__ */ React.createElement(Text, {
 			key: idx,
 			dimColor: true
-		}, "─".repeat(50));
+		}, "─".repeat(Math.max(1, columns - 4)));
 		case "space": return null;
 		default:
 			if ("text" in token) return /* @__PURE__ */ React.createElement(Text, { key: idx }, token.text);
@@ -1929,14 +1966,14 @@ function renderListItem(item, idx, ordered, number) {
 		paddingLeft: 2
 	}, /* @__PURE__ */ React.createElement(Text, null, bullet, " ", parseInlineText(item.text)));
 }
-function renderBlockquote(token, idx) {
+function renderBlockquote(token, idx, columns) {
 	return /* @__PURE__ */ React.createElement(Box, {
 		key: idx,
 		paddingLeft: 2,
 		borderStyle: "single",
 		borderLeft: true,
 		borderColor: "gray"
-	}, token.tokens.map((t, i) => renderToken(t, i)));
+	}, token.tokens.map((t, i) => renderToken(t, i, columns)));
 }
 /**
 * Parse inline markdown formatting (bold, italic, code, links)
@@ -2048,9 +2085,9 @@ function App({ onMessage, onBackgroundCompletion, onCommand, onBashCommand, onPe
 		setPendingBackgroundTrigger,
 		onBackgroundCompletion
 	]);
-	const toggleAutoAcceptEdits = useCliStore((state) => state.toggleAutoAcceptEdits);
+	const cycleInteractionMode = useCliStore((state) => state.cycleInteractionMode);
 	useInput((_input, key) => {
-		if (key.tab && key.shift) toggleAutoAcceptEdits();
+		if (key.tab && key.shift) cycleInteractionMode();
 	});
 	const [isBashMode, setIsBashMode] = useState(false);
 	const handleSubmit = React.useCallback(async (input) => {
@@ -5906,15 +5943,18 @@ function CliApp() {
 			if (contextResult.projectContext) startupLog.push(`📄 Project context: ${contextResult.projectContext.filename}`);
 			for (const error of contextResult.errors) startupLog.push(`⚠️  Context file error: ${error}`);
 			const featureModulePrompts = featureRegistry.getSystemPromptSections();
-			const cliSystemPrompt = buildSystemPrompt(config.preferences.promptVariant ?? "current", {
+			const promptVariant = config.preferences.promptVariant ?? "current";
+			const buildPromptForMode = (mode) => buildSystemPrompt(promptVariant, {
 				contextContent: contextResult.mergedContent,
 				agentStore,
 				customCommands: state.customCommandStore.getAllCommands(),
 				enableSkillTool,
 				enableDynamicAgentCreation: config.preferences.enableDynamicAgentCreation === true,
 				additionalDirectories,
-				featureModulePrompts: featureModulePrompts || void 0
+				featureModulePrompts: featureModulePrompts || void 0,
+				planModeFilePath: mode === "plan" ? getPlanModeFilePath(newSession.id) : void 0
 			});
+			const cliSystemPrompt = buildPromptForMode(useCliStore.getState().interactionMode);
 			const maxIterations = config.preferences.maxIterations === null ? 999999 : config.preferences.maxIterations;
 			const agent = new ReActAgent({
 				userId: config.userId,
@@ -5928,6 +5968,14 @@ function CliApp() {
 				systemPrompt: cliSystemPrompt
 			});
 			agentContext.currentAgent = agent;
+			const agentInternalContext = agent.context;
+			let lastInteractionMode = useCliStore.getState().interactionMode;
+			useCliStore.subscribe((s) => {
+				if (s.interactionMode === lastInteractionMode) return;
+				lastInteractionMode = s.interactionMode;
+				if (agentContext.currentAgent !== agent) return;
+				agentInternalContext.systemPrompt = buildPromptForMode(s.interactionMode);
+			});
 			agent.observationQueue = agentContext.observationQueue;
 			const stepHandler = (step) => {
 				const { pendingMessages, updatePendingMessage } = useCliStore.getState();
@@ -7250,7 +7298,6 @@ Multi-line Input:
 				logger.debug("=== New Session Started via /clear ===");
 				decisionStoreRef.current.decisions = [];
 				blockerStoreRef.current.blockers = [];
-				reviewGateStoreRef.current.reviewGates = [];
 				if (state.checkpointStore) state.checkpointStore.setSessionId(newSession.id);
 				setState((prev) => ({
 					...prev,
@@ -7258,6 +7305,17 @@ Multi-line Input:
 				}));
 				setStoreSession(newSession);
 				useCliStore.getState().clearPendingMessages();
+				const staleGate = useCliStore.getState().reviewGatePrompt;
+				if (staleGate) {
+					dequeueReviewGatePrompt();
+					staleGate.resolve({
+						decision: "rejected",
+						note: "Session cleared."
+					});
+				}
+				queueMicrotask(() => {
+					reviewGateStoreRef.current.reviewGates = [];
+				});
 				usageCache = null;
 				console.log("New session started.");
 				console.log(`\n📝 Session: ${newSession.name}  |  🤖 Model: ${newSession.model}  |  📊 Tokens: 0\n`);
@@ -8071,6 +8129,7 @@ Multi-line Input:
 			const newFeatureTools = newFeatureRegistry.getAllTools();
 			agentContext.tools = [...baseTools, ...newFeatureTools];
 			const newFeaturePrompts = newFeatureRegistry.getSystemPromptSections();
+			const planFilePathForRebuild = useCliStore.getState().interactionMode === "plan" && state.session ? getPlanModeFilePath(state.session.id) : void 0;
 			agentContext.systemPrompt = buildSystemPrompt(updatedConfig.preferences.promptVariant ?? "current", {
 				contextContent: state.contextContent,
 				agentStore: state.agentStore || void 0,
@@ -8078,7 +8137,8 @@ Multi-line Input:
 				enableSkillTool: updatedConfig.preferences.enableSkillTool !== false,
 				enableDynamicAgentCreation: updatedConfig.preferences.enableDynamicAgentCreation === true,
 				additionalDirectories: state.additionalDirectories,
-				featureModulePrompts: newFeaturePrompts || void 0
+				featureModulePrompts: newFeaturePrompts || void 0,
+				planModeFilePath: planFilePathForRebuild
 			});
 			const moduleNames = newFeatureRegistry.getModuleNames();
 			if (moduleNames.length > 0) console.error(`\n\x1b[36m🏰 Feature modules hot-reloaded: ${moduleNames.join(", ")}\x1b[0m`);
@@ -8217,15 +8277,15 @@ Multi-line Input:
 		onUserQuestionResponse: (response, promptId) => {
 			const currentPrompt = useCliStore.getState().userQuestionPrompt;
 			if (currentPrompt?.id !== promptId) return;
-			currentPrompt.resolve(response);
 			dequeueUserQuestionPrompt();
+			currentPrompt.resolve(response);
 			emitNextAwaitingStatus();
 		},
 		onReviewGateResponse: (response, promptId) => {
 			const currentPrompt = useCliStore.getState().reviewGatePrompt;
 			if (currentPrompt?.id !== promptId) return;
-			currentPrompt.resolve(response);
 			dequeueReviewGatePrompt();
+			currentPrompt.resolve(response);
 			emitNextAwaitingStatus();
 		}
 	});
@@ -8236,6 +8296,9 @@ try {
 } catch {}
 if (import.meta.url.includes("/src/") || process.env.NODE_ENV === "development") logger.debug("🔧 Running in development mode (using TypeScript source)\n");
 warmFileCache();
-render(/* @__PURE__ */ React.createElement(CliApp, null), { exitOnCtrlC: false });
+render(/* @__PURE__ */ React.createElement(CliApp, null), {
+	exitOnCtrlC: false,
+	alternateScreen: true
+});
 //#endregion
 export {};

package/dist/store-44C_Fvdb.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { n as useCliStore } from "./store-B0ImnWR4.mjs";
+export { useCliStore };

package/dist/{store-FkY4K-0M.mjs → store-B0ImnWR4.mjs}

@@ -3,6 +3,14 @@ import { create } from "zustand";
 //#region src/store/index.ts
 /** Active job statuses (jobs still in progress) */
 const ACTIVE_STATUSES = new Set(["running", "queued"]);
+const INTERACTION_MODE_CYCLE = [
+	"normal",
+	"auto-accept",
+	"plan"
+];
+function nextInteractionMode(current) {
+	return INTERACTION_MODE_CYCLE[(INTERACTION_MODE_CYCLE.indexOf(current) + 1) % INTERACTION_MODE_CYCLE.length];
+}
 /** Check if a job status is active (running or queued) */
 function isActiveStatus(status) {
 	return ACTIVE_STATUSES.has(status);
@@ -122,8 +130,9 @@ const useCliStore = create((set) => ({
 	setShowConfigEditor: (show) => set({ showConfigEditor: show }),
 	showMcpViewer: false,
 	setShowMcpViewer: (show) => set({ showMcpViewer: show }),
-	autoAcceptEdits: false,
-	toggleAutoAcceptEdits: () => set((state) => ({ autoAcceptEdits: !state.autoAcceptEdits })),
+	interactionMode: "normal",
+	cycleInteractionMode: () => set((state) => ({ interactionMode: nextInteractionMode(state.interactionMode) })),
+	setInteractionMode: (mode) => set({ interactionMode: mode }),
 	exitRequested: false,
 	setExitRequested: (requested) => set({ exitRequested: requested }),
 	backgroundAgents: [],

package/dist/{tools-DY-JzNoY.mjs → tools-DDoiKdgk.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as RechartsChartTypeList, A as ImageGenerationUsageTransaction, At as secureParameters, B as NotFoundError, C as FileEvents, Ct as getMcpProviderMetadata, D as GenericCreditAddTransaction, Dt as obfuscateApiKey, E as GenerateImageToolCallSchema, Et as isGPTImageModel, F as KnowledgeType, G as ProfileEvents, H as OpenAIImageGenerationInput, I as LLMEvents, J as PurchaseTransaction, K as ProjectEvents, L as MiscEvents, M as InboxEvents, N as InviteEvents, Nt as CollectionType, O as GenericCreditDeductTransaction, Ot as resolveNavigationIntents, P as InviteType, Q as ReceivedCreditTransaction, R as ModalEvents, S as FeedbackEvents, St as getDataLakeTags, T as GEMINI_IMAGE_MODELS, Tt as isGPTImage2Model, U as Permission, V as OpenAIEmbeddingModel, W as PermissionDeniedError, X as REASONING_SUPPORTED_MODELS, Y as QuestMasterParamsSchema, Z as RealtimeVoiceUsageTransaction, _ as CompletionApiUsageTransaction, _t as VideoModels, a as ApiKeyEvents, at as SessionEvents, b as FIXED_TEMPERATURE_MODELS, bt as b4mLLMTools, c as AppFileEvents, ct as SupportedFabFileMimeTypes, d as BFL_IMAGE_MODELS, dt as TextGenerationUsageTransaction, et as RegInviteEvents, f as BFL_SAFETY_TOLERANCE, ft as ToolUsageTransaction, g as ChatModels, gt as VideoGenerationUsageTransaction, h as ChatCompletionCreateInputSchema, ht as VIDEO_SIZE_CONSTRAINTS, i as AiEvents, it as ResearchTaskType, j as ImageModels, k as ImageEditUsageTransaction, kt as sanitizeTelemetryError, l as ArtifactTypeSchema, lt as TagType, mt as UiNavigationEvents, n as logger, nt as ResearchTaskExecutionType, o as ApiKeyScope, ot as SpeechToTextModels, p as BedrockEmbeddingModel, pt as TransferCreditTransaction, q as PromptMetaZodSchema, r as ALERT_THRESHOLDS, rt as ResearchTaskPeriodicFrequencyType, s as ApiKeyType, st as SubscriptionCreditTransaction, t as ConfigStore, tt as ResearchModeParamsSchema, u as AuthEvents, ut as TaskScheduleHandler, v as DashboardParamsSchema, vt as VoyageAIEmbeddingModel, w as FriendshipEvents, wt as getViewById, x as FavoriteDocumentType, xt as getAccessibleDataLakes, y as ElabsEvents, yt as XAI_IMAGE_MODELS, z as ModelBackend } from "./ConfigStore-Bu_plzvP.mjs";
+import { $ as RechartsChartTypeList, A as ImageGenerationUsageTransaction, At as secureParameters, B as NotFoundError, C as FileEvents, Ct as getMcpProviderMetadata, D as GenericCreditAddTransaction, Dt as obfuscateApiKey, E as GenerateImageToolCallSchema, Et as isGPTImageModel, F as KnowledgeType, G as ProfileEvents, H as OpenAIImageGenerationInput, I as LLMEvents, J as PurchaseTransaction, K as ProjectEvents, L as MiscEvents, M as InboxEvents, N as InviteEvents, Nt as CollectionType, O as GenericCreditDeductTransaction, Ot as resolveNavigationIntents, P as InviteType, Q as ReceivedCreditTransaction, R as ModalEvents, S as FeedbackEvents, St as getDataLakeTags, T as GEMINI_IMAGE_MODELS, Tt as isGPTImage2Model, U as Permission, V as OpenAIEmbeddingModel, W as PermissionDeniedError, X as REASONING_SUPPORTED_MODELS, Y as QuestMasterParamsSchema, Z as RealtimeVoiceUsageTransaction, _ as CompletionApiUsageTransaction, _t as VideoModels, a as ApiKeyEvents, at as SessionEvents, b as FIXED_TEMPERATURE_MODELS, bt as b4mLLMTools, c as AppFileEvents, ct as SupportedFabFileMimeTypes, d as BFL_IMAGE_MODELS, dt as TextGenerationUsageTransaction, et as RegInviteEvents, f as BFL_SAFETY_TOLERANCE, ft as ToolUsageTransaction, g as ChatModels, gt as VideoGenerationUsageTransaction, h as ChatCompletionCreateInputSchema, ht as VIDEO_SIZE_CONSTRAINTS, i as AiEvents, it as ResearchTaskType, j as ImageModels, k as ImageEditUsageTransaction, kt as sanitizeTelemetryError, l as ArtifactTypeSchema, lt as TagType, mt as UiNavigationEvents, n as logger, nt as ResearchTaskExecutionType, o as ApiKeyScope, ot as SpeechToTextModels, p as BedrockEmbeddingModel, pt as TransferCreditTransaction, q as PromptMetaZodSchema, r as ALERT_THRESHOLDS, rt as ResearchTaskPeriodicFrequencyType, s as ApiKeyType, st as SubscriptionCreditTransaction, t as ConfigStore, tt as ResearchModeParamsSchema, u as AuthEvents, ut as TaskScheduleHandler, v as DashboardParamsSchema, vt as VoyageAIEmbeddingModel, w as FriendshipEvents, wt as getViewById, x as FavoriteDocumentType, xt as getAccessibleDataLakes, y as ElabsEvents, yt as XAI_IMAGE_MODELS, z as ModelBackend } from "./ConfigStore-Bj1IOvWn.mjs";
 import { n as isPathAllowed, t as assertPathAllowed } from "./pathValidation-CIytuhr3-Dt5dntLx.mjs";
 import { execFile, execFileSync, spawn } from "child_process";
 import { createHash, randomBytes } from "crypto";
@@ -2268,6 +2268,15 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		return this.toolCallCount;
 	}
 	/**
+	* Get current iteration count.
+	* Cheap accessor for hot paths (e.g., per-step event listeners) — prefer this
+	* over `toCheckpoint().iteration`, which deep-clones messages, steps, and
+	* confidence log on every call.
+	*/
+	getIteration() {
+		return this.iterations;
+	}
+	/**
 	* Serialize the agent's current execution state for persistence.
 	*
 	* Call this after each iteration to create a durable checkpoint that can
@@ -3023,6 +3032,84 @@ const TOOL_WRITE_TODOS = "write_todos";
 const TOOL_CREATE_DYNAMIC_AGENT = "create_dynamic_agent";
 const EXPLORE_SUBAGENT_TYPE = "explore";
 /**
+* Plan-mode section: tells the model that write tools are blocked and where to put the plan.
+* Appended dynamically when the user cycles into plan mode via Shift+Tab.
+*
+* The phased workflow (understand → clarify → design → present) mirrors Claude Code's
+* plan-mode prompting: research before designing, ask the user before assuming, and only
+* write the plan after ambiguities are resolved.
+*/
+function buildPlanModePromptSection(planModeFilePath) {
+	return `
+
+## PLAN MODE ACTIVE
+
+The user has cycled into plan mode (Shift+Tab). Plan mode restricts WRITING, not READING. You still have a complete read toolkit — use it.
+
+**Tools available in plan mode (use these aggressively):**
+- \`grep_search\` — find symbols, strings, patterns across files
+- \`glob_files\` — list files by pattern (use this instead of \`ls\` / \`find\`)
+- \`file_read\` — read file contents
+- \`find_definition\` — locate where a symbol is defined
+- \`get_file_structure\` — AST overview of a file
+- \`agent_delegate\` — delegate to read-only subagents (e.g. 'explore', 'plan')
+- \`ask_user_question\` — ask the user clarifying questions
+- \`current_datetime\`, \`math_evaluate\`, \`web_search\`, \`web_fetch\` — also fine
+
+**Tools blocked in plan mode:**
+- \`bash_execute\`, \`edit_local_file\`, \`create_file\`, \`delete_file\` — and any other tool that mutates state.
+- Exception: \`create_file\` / \`edit_local_file\` targeting paths under \`${planModeFilePath.replace(/\/plan-[^/]+\.md$/, "/")}\` are allowed (that's where you write the plan).
+
+**Forbidden responses:**
+- ❌ "I can't explore the directory because plan mode blocks shell commands."
+- ❌ "I'd need to run bash to check this."
+- ❌ Any variant of "plan mode prevents me from researching."
+- ✅ Instead: use \`glob_files\`, \`grep_search\`, \`file_read\`, or delegate to the \`explore\` subagent. Bash is not the only way to investigate code.
+
+Ground every claim in files you have actually read. Do not write pseudocode in chat as a substitute for reading the real code.
+
+Follow this phased workflow. Do not skip phases.
+
+### Phase 1 — Understand
+- Read the relevant code before forming opinions. Use grep_search / glob_files / file_read directly for narrow lookups.
+- For broad or uncertain scope, delegate to the 'explore' subagent via agent_delegate so the main context stays focused.
+- Identify what already exists vs. what needs to be built. Reuse existing functions and patterns rather than proposing new ones.
+
+### Phase 2 — Clarify (REQUIRED if anything is ambiguous)
+- If requirements are unclear, if there are multiple reasonable approaches, or if you would otherwise be guessing about user intent, **call the ask_user_question tool BEFORE writing the plan**.
+- Ask about: trade-offs the user should pick between, scope (which files / how broad), behavior on edge cases, naming, dependencies you would add.
+- Do NOT ask "is the plan ready?" or "should I proceed?" — those are decided by the user pressing Shift+Tab. Only ask substantive design questions.
+- If the request is fully unambiguous, skip this phase. Do not invent questions.
+
+### Phase 3 — Design
+- For complex tasks, delegate to the 'plan' subagent via agent_delegate to get a structured implementation plan, then critique its output.
+- For simple tasks, design directly.
+
+### Phase 4 — Write the plan
+Write the plan to \`${planModeFilePath}\` (writes to this path are permitted in plan mode). Build it incrementally — append sections as you research, do not wait until the end. Structure it as:
+
+\`\`\`markdown
+## Context
+Why this change is being made — the problem, what prompted it, the intended outcome.
+
+## Approach
+The chosen approach in 1-3 sentences. Mention rejected alternatives only if non-obvious.
+
+## Files to change
+- path/to/file.ts — what changes and why
+- path/to/other.ts — what changes and why
+
+## Reused existing code
+- function/module path — how it will be reused
+
+## Verification
+How to confirm the change works end-to-end (commands, tests, manual steps).
+\`\`\`
+
+### Phase 5 — Hand off
+Tell the user the plan is ready and where it lives (\`${planModeFilePath}\`). Summarize in 1-2 sentences. Do not ask for approval — the user will press Shift+Tab to exit plan mode and authorize execution.`;
+}
+/**
 * Build the CLI system prompt with optional project context
 * @param contextSection - Optional project-specific context to append (legacy string) or config object
 * @param config - Configuration object for building context sections (when first param is string)
@@ -3034,6 +3121,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 	let dynamicAgentSection = "";
 	let directoriesSection = "";
 	let featureModulesSection = "";
+	let planModeSection = "";
 	if (typeof contextSection === "string") {
 		projectContextSection = contextSection;
 		if (config) {
@@ -3041,6 +3129,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 			if (config.agentStore) agentDirectoryContext = config.agentStore.getDirectoryContext();
 			if (config.enableDynamicAgentCreation) dynamicAgentSection = buildDynamicAgentPromptSection();
 			if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
+			if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
 		}
 	} else if (contextSection && typeof contextSection === "object") {
 		config = contextSection;
@@ -3050,6 +3139,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 		if (config.enableDynamicAgentCreation) dynamicAgentSection = buildDynamicAgentPromptSection();
 		if (config.additionalDirectories && config.additionalDirectories.length > 0) directoriesSection = `\n\n## Additional Allowed Directories\n\nIn addition to the working directory (${process.cwd()}), you have read/write access to these directories:\n${config.additionalDirectories.map((d) => `- ${d}`).join("\n")}\n\nTo access files in additional directories, pass the full path to the 'dir_path' parameter of file tools:\n- ${TOOL_GREP_SEARCH}(pattern="...", dir_path="/path/to/additional/dir")\n- ${TOOL_GLOB_FILES}(pattern="**/*.ts", dir_path="/path/to/additional/dir")\n- ${TOOL_FILE_READ}(path="/path/to/additional/dir/file.ts")\n\nWhen the user asks about content in an additional directory, search there first using the dir_path parameter.`;
 		if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
+		if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
 	}
 	return `You are an autonomous AI assistant with access to tools. Your job is to help users by taking action and solving problems proactively.
 
@@ -3152,7 +3242,7 @@ You have tools for tracking decisions, blockers, and human review gates during y
 
 - request_review_gate: Pause for explicit human approval before crossing a significant decision point — one that affects interpretation, evidence, cost, credentials, platform, or public commitment (e.g., narrowing research scope after synthesis, hard-to-reverse refactors, architectural pivots, dependency swaps). Do NOT use for routine operations or actions already covered by the standard permission system (file edits, bash commands). Treat a rejection as a hard stop — re-plan, do not retry.
 
-These tools are lightweight — use them naturally as part of your work, not as a ceremony.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}`;
+These tools are lightweight — use them naturally as part of your work, not as a ceremony.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}`;
 }
 /**
 * Build the minimal-variant system prompt. Reuses the project context,
@@ -3165,16 +3255,18 @@ function buildMinimalSystemPrompt(config = {}) {
 	let skillsSection = "";
 	let directoriesSection = "";
 	let featureModulesSection = "";
+	let planModeSection = "";
 	if (config.contextContent) projectContextSection = `\n\n## Project Context\n\nFollow these project-specific instructions:\n\n${config.contextContent}`;
 	if (config.enableSkillTool !== false && config.customCommands && config.customCommands.length > 0) skillsSection = buildSkillsPromptSection(config.customCommands);
 	if (config.additionalDirectories && config.additionalDirectories.length > 0) directoriesSection = `\n\n## Additional Allowed Directories\n\nIn addition to the working directory (${process.cwd()}), you have read/write access to these directories:\n${config.additionalDirectories.map((d) => `- ${d}`).join("\n")}\n\nPass full paths to file tools' \`dir_path\` parameter to access these directories.`;
 	if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
+	if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
 	return `You are an expert coding assistant. You help users by reading files, executing commands, editing code, and writing new files using the tools available to you.
 
 Guidelines:
 - Be concise in your responses.
 - Show file paths clearly when working with files.
-- When the task is done, give the user a direct answer — no recap of steps already visible in the tool history.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}`;
+- When the task is done, give the user a direct answer — no recap of steps already visible in the tool history.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}`;
 }
 /**
 * Pick a system prompt by variant. The dispatch point for the
@@ -3234,6 +3326,41 @@ You have access to the '${TOOL_CREATE_DYNAMIC_AGENT}' tool, which lets you creat
    thoroughness: "quick"`;
 }
 //#endregion
+//#region src/utils/planMode.ts
+const PLAN_MODE_DIR = ".b4m-cli/plans";
+const PATH_TOOLS = new Set([
+	"create_file",
+	"edit_local_file",
+	"delete_file"
+]);
+/**
+* Directory plan-mode artifacts are written to (under the working directory).
+* Writes to paths under this directory are permitted while plan mode is active.
+*/
+function getPlanModeFileDir(cwd = process.cwd()) {
+	return path.resolve(cwd, PLAN_MODE_DIR);
+}
+/**
+* Default plan file for the current session. Sessions can override this if needed.
+*/
+function getPlanModeFilePath(sessionId, cwd = process.cwd()) {
+	const safeId = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
+	return path.join(getPlanModeFileDir(cwd), `plan-${safeId}.md`);
+}
+/**
+* Whether a write/edit/delete tool call targets a path inside the plan-mode directory.
+* Used to allow incremental plan-file writes while plan mode blocks other writes.
+*/
+function isWriteTargetingPlanFile(toolName, args, cwd = process.cwd()) {
+	if (!PATH_TOOLS.has(toolName)) return false;
+	const argPath = args?.path;
+	if (typeof argPath !== "string" || argPath.length === 0) return false;
+	const resolved = path.resolve(cwd, argPath);
+	const planDir = getPlanModeFileDir(cwd);
+	const rel = path.relative(planDir, resolved);
+	return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+//#endregion
 //#region ../../b4m-core/utils/dist/imageGeneration/AIImageService.mjs
 /**
 * Abstract class for AI Image Service
@@ -5723,7 +5850,7 @@ z.object({
 * @see https://platform.openai.com/docs/guides/function-calling
 */
 const MAX_GOAL_LENGTH = 1e3;
-const MAX_DESCRIPTION_LENGTH = 2e3;
+const MAX_DESCRIPTION_LENGTH$1 = 2e3;
 ChatModels.GPT5, ChatModels.GPT5_MINI, ChatModels.GPT5_NANO, ChatModels.GPT5_1, ChatModels.GPT5_2, ChatModels.GPT5_4, ChatModels.GPT5_4_MINI, ChatModels.GPT5_4_NANO, ChatModels.GPT5_5;
 /**
 * Invokes the image processor Lambda to convert and resize images
@@ -15204,7 +15331,8 @@ updateUserSchema.extend({
 		note: z.string(),
 		userName: z.string()
 	})).optional(),
-	numReferralsAvailable: z.number().optional()
+	numReferralsAvailable: z.number().optional(),
+	disputePending: z.boolean().optional()
 });
 z.object({
 	username: z.string(),
@@ -15907,7 +16035,7 @@ z.object({
 const questSchema = z.object({
 	id: z.string(),
 	title: z.string().min(1).max(255),
-	description: z.string().max(MAX_DESCRIPTION_LENGTH),
+	description: z.string().max(MAX_DESCRIPTION_LENGTH$1),
 	status: z.enum([
 		"not_started",
 		"in_progress",
@@ -15930,7 +16058,7 @@ const questResourceSchema = z.object({
 });
 z.object({
 	title: z.string().min(1).max(255),
-	description: z.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+	description: z.string().max(MAX_DESCRIPTION_LENGTH$1).optional(),
 	goal: z.string().min(1).max(MAX_GOAL_LENGTH),
 	complexity: z.enum([
 		"beginner",
@@ -18970,9 +19098,18 @@ function wrapToolWithPermission(tool, permissionManager, showPermissionPrompt, a
 				});
 				return result;
 			}
+			const { useCliStore } = await import("./store-44C_Fvdb.mjs");
+			const interactionMode = useCliStore.getState().interactionMode;
+			if (interactionMode === "plan" && !isReadOnlyTool(toolName) && !isWriteTargetingPlanFile(toolName, args)) {
+				const result = `Tool "${toolName}" is blocked while plan mode is active. Plan mode is read-only — research the codebase, then write your plan to a file under ${getPlanModeFileDir()}/. The user will press Shift+Tab to exit plan mode and authorize execution.`;
+				agentContext.observationQueue.push({
+					toolName,
+					result
+				});
+				return result;
+			}
 			if (!permissionManager.needsPermission(toolName, { isSandboxed })) return executeAndRecord();
-			const { useCliStore } = await import("./store-D2zh6DFz.mjs");
-			if (useCliStore.getState().autoAcceptEdits) return executeAndRecord();
+			if (interactionMode === "auto-accept") return executeAndRecord();
 			const response = await showPermissionPrompt(toolName, effectiveArgs, await generateToolPreview(toolName, args, isSandboxed));
 			if (response.action === "deny") throw new PermissionDeniedError(toolName, args);
 			if (response.action === "allow-session") permissionManager.trustToolForSession(toolName);
@@ -23989,6 +24126,10 @@ function createBlockerStore(onUpdate) {
 }
 //#endregion
 //#region src/tools/reviewGateTool.ts
+const MAX_DESCRIPTION_LENGTH = 2e3;
+const MAX_RECOMMENDATION_LENGTH = 1e3;
+const MAX_OPTION_LENGTH = 500;
+const MAX_OPTIONS_COUNT = 10;
 /**
 * Validate request_review_gate parameters
 * @throws Error if validation fails
@@ -23996,11 +24137,19 @@ function createBlockerStore(onUpdate) {
 function validateParams(args) {
 	const params = args;
 	if (typeof params.description !== "string" || params.description.trim() === "") throw new Error("request_review_gate: description must be a non-empty string");
+	if (params.description.length > MAX_DESCRIPTION_LENGTH) throw new Error(`request_review_gate: description must be ${MAX_DESCRIPTION_LENGTH} characters or fewer`);
 	if (params.options !== void 0) {
 		if (!Array.isArray(params.options)) throw new Error("request_review_gate: options must be an array of strings");
-		for (const opt of params.options) if (typeof opt !== "string") throw new Error("request_review_gate: each option must be a string");
+		if (params.options.length > MAX_OPTIONS_COUNT) throw new Error(`request_review_gate: options must contain ${MAX_OPTIONS_COUNT} entries or fewer`);
+		for (const opt of params.options) {
+			if (typeof opt !== "string") throw new Error("request_review_gate: each option must be a string");
+			if (opt.length > MAX_OPTION_LENGTH) throw new Error(`request_review_gate: each option must be ${MAX_OPTION_LENGTH} characters or fewer`);
+		}
+	}
+	if (params.recommendation !== void 0) {
+		if (typeof params.recommendation !== "string") throw new Error("request_review_gate: recommendation must be a string");
+		if (params.recommendation.length > MAX_RECOMMENDATION_LENGTH) throw new Error(`request_review_gate: recommendation must be ${MAX_RECOMMENDATION_LENGTH} characters or fewer`);
 	}
-	if (params.recommendation !== void 0 && typeof params.recommendation !== "string") throw new Error("request_review_gate: recommendation must be a string");
 	const options = params.options?.map((o) => o.trim()).filter((o) => o.length > 0);
 	return {
 		description: params.description.trim(),
@@ -24015,6 +24164,11 @@ function formatReviewGatesOutput(gates) {
 	if (gates.length === 0) return "No review gates recorded in this session.";
 	return gates.map((gate, index) => {
 		const lines = [`${index + 1}. **${gate.description}**`, `   Status: ${gate.status}`];
+		if (gate.recommendation) lines.push(`   Recommendation: ${gate.recommendation}`);
+		if (gate.options && gate.options.length > 0) {
+			lines.push("   Options:");
+			for (const opt of gate.options) lines.push(`     • ${opt}`);
+		}
 		if (gate.userNote) lines.push(`   Note: ${gate.userNote}`);
 		const requested = new Date(gate.timestamp).toLocaleTimeString();
 		lines.push(`   Requested at: ${requested}`);
@@ -24053,7 +24207,9 @@ function createReviewGateTool(store, requestReviewFn) {
 				description: params.description,
 				status: response.decision,
 				resolvedAt: (/* @__PURE__ */ new Date()).toISOString(),
-				userNote: trimmedNote && trimmedNote.length > 0 ? trimmedNote : void 0
+				userNote: trimmedNote && trimmedNote.length > 0 ? trimmedNote : void 0,
+				options: params.options,
+				recommendation: params.recommendation
 			};
 			store.reviewGates.push(entry);
 			if (store.onUpdate) store.onUpdate(store.reviewGates);
@@ -24111,4 +24267,4 @@ function createReviewGateStore(onUpdate) {
 	};
 }
 //#endregion
-export { SessionStore as $, formatStep as A, DEFAULT_RETRY_CONFIG as B, WebSocketToolExecutor as C, ServerLlmBackend as D, WebSocketLlmBackend as E, PermissionManager as F, OllamaBackend as G, clearFeatureModuleTools as H, generateCliTools as I, isReadOnlyTool as J, buildSystemPrompt as K, ALWAYS_DENIED_FOR_AGENTS as L, loadContextFiles as M, getApiUrl as N, McpManager as O, getEnvironmentName as P, CommandHistoryStore as Q, DEFAULT_AGENT_MODEL as R, ApiClient as S, FallbackLlmBackend as T, registerFeatureModuleTools as U, DEFAULT_THOROUGHNESS as V, setWebSocketToolExecutor as W, CustomCommandStore as X, ReActAgent as Y, CheckpointStore as Z, createAgentDelegateTool as _, createBlockerTools as a, formatFileSize$1 as at, createSkillTool as b, createDecisionStore as c, createFindDefinitionTool as d, OAuthClient as et, createTodoStore as f, BackgroundAgentManager as g, createBackgroundAgentTools as h, createBlockerStore as i, mergeCommands as it, extractCompactInstructions as j, substituteArguments as k, formatDecisionsOutput as l, createCoordinateTaskTool as m, createReviewGateTool as n, processFileReferences as nt, formatBlockersOutput as o, searchFiles as ot, createWriteTodosTool as p, buildSkillsPromptSection as q, formatReviewGatesOutput as r, searchCommands as rt, createDecisionLogTool as s, warmFileCache as st, createReviewGateStore as t, hasFileReferences as tt, createGetFileStructureTool as u, AgentStore as v, WebSocketConnectionManager as w, parseAgentConfig as x, SubagentOrchestrator as y, DEFAULT_MAX_ITERATIONS as z };
+export { CommandHistoryStore as $, formatStep as A, DEFAULT_RETRY_CONFIG as B, WebSocketToolExecutor as C, ServerLlmBackend as D, WebSocketLlmBackend as E, PermissionManager as F, OllamaBackend as G, clearFeatureModuleTools as H, generateCliTools as I, buildSkillsPromptSection as J, getPlanModeFilePath as K, ALWAYS_DENIED_FOR_AGENTS as L, loadContextFiles as M, getApiUrl as N, McpManager as O, getEnvironmentName as P, CheckpointStore as Q, DEFAULT_AGENT_MODEL as R, ApiClient as S, FallbackLlmBackend as T, registerFeatureModuleTools as U, DEFAULT_THOROUGHNESS as V, setWebSocketToolExecutor as W, ReActAgent as X, isReadOnlyTool as Y, CustomCommandStore as Z, createAgentDelegateTool as _, createBlockerTools as a, mergeCommands as at, createSkillTool as b, createDecisionStore as c, warmFileCache as ct, createFindDefinitionTool as d, SessionStore as et, createTodoStore as f, BackgroundAgentManager as g, createBackgroundAgentTools as h, createBlockerStore as i, searchCommands as it, extractCompactInstructions as j, substituteArguments as k, formatDecisionsOutput as l, createCoordinateTaskTool as m, createReviewGateTool as n, hasFileReferences as nt, formatBlockersOutput as o, formatFileSize$1 as ot, createWriteTodosTool as p, buildSystemPrompt as q, formatReviewGatesOutput as r, processFileReferences as rt, createDecisionLogTool as s, searchFiles as st, createReviewGateStore as t, OAuthClient as tt, createGetFileStructureTool as u, AgentStore as v, WebSocketConnectionManager as w, parseAgentConfig as x, SubagentOrchestrator as y, DEFAULT_MAX_ITERATIONS as z };

package/dist/{updateChecker-Dn-Ri8zw.mjs → updateChecker-BVKr0OXs.mjs}

@@ -4,7 +4,7 @@ import { homedir } from "os";
 import path from "path";
 import axios from "axios";
 //#region package.json
-var version = "0.7.0";
+var version = "0.8.1";
 //#endregion
 //#region src/utils/updateChecker.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -118,11 +118,11 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@bike4mind/agents": "0.7.0",
-    "@bike4mind/common": "2.92.1",
-    "@bike4mind/services": "2.79.4",
-    "@bike4mind/utils": "2.19.3",
-    "@bike4mind/mcp": "1.37.3"
+    "@bike4mind/agents": "0.8.0",
+    "@bike4mind/common": "2.92.2",
+    "@bike4mind/mcp": "1.37.4",
+    "@bike4mind/utils": "2.19.4",
+    "@bike4mind/services": "2.80.0"
   },
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.17.1"

package/dist/store-D2zh6DFz.mjs

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import { n as useCliStore } from "./store-FkY4K-0M.mjs";
-export { useCliStore };