fix: re-enable batch state debouncing to resolve Auto Run performance regression

playbooks/agent-inbox/2026-02-26-Encore-Inbox-Refactor/ENCORE-INBOX-02.md

@@ -0,0 +1,34 @@
+# ENCORE-INBOX-02: Add `unifiedInbox` flag to EncoreFeatureFlags
+
+## Objective
+Register the Unified Inbox as an Encore Feature with a type flag and default value.
+
+## Context
+- `EncoreFeatureFlags` interface is at `src/renderer/types/index.ts:906` — currently only has `directorNotes: boolean`
+- `DEFAULT_ENCORE_FEATURES` is at `src/renderer/stores/settingsStore.ts:110` — currently `{ directorNotes: false }`
+- The settings store hydration merges saved values with defaults at `settingsStore.ts:1669-1673` using spread: `{ ...DEFAULT_ENCORE_FEATURES, ...(saved) }` — so new fields with defaults are safe
+- Both type AND default MUST be updated in the same task to avoid runtime `undefined`
+
+## Tasks
+
+- [x] In `src/renderer/types/index.ts`, find the `EncoreFeatureFlags` interface at line 906. Add `unifiedInbox: boolean` below `directorNotes`. Also in `src/renderer/stores/settingsStore.ts`, find `DEFAULT_ENCORE_FEATURES` at line 110. Add `unifiedInbox: false` to the object. Both changes must happen together:
+  ```typescript
+  // types/index.ts:906
+  export interface EncoreFeatureFlags {
+    directorNotes: boolean;
+    unifiedInbox: boolean;
+  }
+
+  // stores/settingsStore.ts:110
+  export const DEFAULT_ENCORE_FEATURES: EncoreFeatureFlags = {
+    directorNotes: false,
+    unifiedInbox: false,
+  };
+  ```
+
+- [x] Run `npm run lint` to verify the new field doesn't cause type errors. Existing code spreading `encoreFeatures` will pick up the new field automatically via the default merge at line 1669-1673.
+
+## Gate
+- `npm run lint` passes
+- `EncoreFeatureFlags` has both `directorNotes` and `unifiedInbox` fields
+- `DEFAULT_ENCORE_FEATURES` has `unifiedInbox: false`

playbooks/agent-inbox/2026-02-26-Encore-Inbox-Refactor/ENCORE-INBOX-04.md

@@ -0,0 +1,46 @@
+# ENCORE-INBOX-04: Port useAgentInbox hook and AgentInbox components
+
+## Objective
+Port the data hook and all 3 component files from `feature/inbox-focus-polish` into the current codebase, adapting imports to the new architecture.
+
+## Context
+- Source branch: `feature/inbox-focus-polish`
+- Files to port:
+  - `src/renderer/hooks/useAgentInbox.ts` — data aggregation hook
+  - `src/renderer/components/AgentInbox/index.tsx` — modal shell + view switching
+  - `src/renderer/components/AgentInbox/InboxListView.tsx` — virtualized list view
+  - `src/renderer/components/AgentInbox/FocusModeView.tsx` — focus mode detail view
+- The new codebase uses `settingsStore.ts` (Zustand) instead of prop-drilling settings
+- `useModalLayer` hook and `MODAL_PRIORITIES` still exist in the same locations
+- `modalStore` still exists at `src/renderer/stores/modalStore.ts`
+- `formatRelativeTime` is at `src/renderer/utils/formatters.ts`
+
+## Tasks
+
+- [x] Create `src/renderer/hooks/useAgentInbox.ts` by extracting from old branch: `git show feature/inbox-focus-polish:src/renderer/hooks/useAgentInbox.ts`. Copy the full content. Verify imports: `Session`, `Group` from `../types`, `InboxItem`, `InboxFilterMode`, `InboxSortMode` from `../types/agent-inbox`. These should resolve since Phase 01 created the types file. Run `npm run lint` to check.
+
+- [x] Create the directory `src/renderer/components/AgentInbox/` and port all 3 component files. For each, extract from old branch and copy:
+  1. `git show feature/inbox-focus-polish:src/renderer/components/AgentInbox/index.tsx` → `src/renderer/components/AgentInbox/index.tsx`
+  2. `git show feature/inbox-focus-polish:src/renderer/components/AgentInbox/InboxListView.tsx` → `src/renderer/components/AgentInbox/InboxListView.tsx`
+  3. `git show feature/inbox-focus-polish:src/renderer/components/AgentInbox/FocusModeView.tsx` → `src/renderer/components/AgentInbox/FocusModeView.tsx`
+  After copying, verify all imports resolve. Key imports to check:
+  - `../../types` should export `Theme`, `Session`, `Group`, `ThinkingMode`, `LogEntry`
+  - `../../types/agent-inbox` should export all inbox types (from Phase 01)
+  - `../../hooks/useAgentInbox` should resolve (created above)
+  - `../../hooks/ui/useModalLayer` — verify this exists: `ls src/renderer/hooks/ui/useModalLayer*`
+  - `../../constants/modalPriorities` — verify: `grep -n "AGENT_INBOX" src/renderer/constants/modalPriorities.ts`. If `AGENT_INBOX` doesn't exist in priorities, add it (use priority 555, same as old branch)
+  - `../../stores/modalStore` — verify `selectModalData` is exported
+  - `../../utils/formatters` — verify `formatRelativeTime` is exported
+  - The ported `InboxListView.tsx` uses `react-window` for virtualization, but this dependency does NOT exist in the project. The codebase already uses `@tanstack/react-virtual` (used by Director's Notes `UnifiedHistoryTab.tsx`). After copying the files, replace ALL `react-window` imports with `@tanstack/react-virtual` equivalents. Specifically: replace `import { FixedSizeList } from 'react-window'` (or similar) with `import { useVirtualizer } from '@tanstack/react-virtual'` and refactor the list rendering to use the `useVirtualizer` hook pattern (see `src/renderer/components/DirectorNotes/UnifiedHistoryTab.tsx` lines 201-221 for reference). This avoids adding an unnecessary dependency.
+  - `../../utils/markdownConfig` — verify `generateTerminalProseStyles` exists
+  - `../../components/MarkdownRenderer` — verify exists
+  **Notes:** react-window → @tanstack/react-virtual migration completed. Added `agentInbox` to ModalId type, AgentInboxModalData interface, ModalDataMap, and getModalActions() in modalStore.ts. AGENT_INBOX priority added at 555 in modalPriorities.ts.
+
+- [x] Run `npm run lint` and fix any import resolution errors. Common issues: renamed types, moved hooks, missing re-exports. Fix each error by finding the new location of the imported symbol.
+  **Notes:** Fixed 2 type narrowing issues in index.tsx (filterMode/sortMode from ModalData needed explicit casts to InboxFilterMode/InboxSortMode). Lint passes clean.
+
+## Gate
+- `src/renderer/hooks/useAgentInbox.ts` exists
+- `src/renderer/components/AgentInbox/` directory has 3 files: `index.tsx`, `InboxListView.tsx`, `FocusModeView.tsx`
+- `npm run lint` passes (zero errors)
+- `AGENT_INBOX` priority registered in `modalPriorities.ts`

playbooks/agent-inbox/2026-02-26-Encore-Inbox-Refactor/ENCORE-INBOX-05.md

@@ -0,0 +1,61 @@
+# ENCORE-INBOX-05: Integrate Unified Inbox into App.tsx (modal + state + Encore gating)
+
+## Objective
+Wire the Unified Inbox modal into App.tsx with Encore Feature gating, following the Director's Notes pattern exactly.
+
+## Context
+- App.tsx is at `src/renderer/App.tsx` (6,563 lines post-refactor)
+- Director's Notes pattern to mirror:
+  - Line 46-47: lazy import `const DirectorNotesModal = lazy(() => import('./components/DirectorNotes')...)`
+  - Line 356-357: modal state from `useModalActions()` — `directorNotesOpen, setDirectorNotesOpen`
+  - Line 508: `encoreFeatures` destructured from settings
+  - Line 5220: conditional setter for SessionList: `setDirectorNotesOpen: encoreFeatures.directorNotes ? setDirectorNotesOpen : undefined`
+  - Line 5634: conditional handler for QuickActions: `encoreFeatures.directorNotes ? () => setDirectorNotesOpen(true) : undefined`
+  - Line 6017: gated modal render: `{encoreFeatures.directorNotes && directorNotesOpen && (<Suspense>...</Suspense>)}`
+- `useModalActions()` comes from `src/renderer/stores/modalStore.ts` — need to add `agentInboxOpen`/`setAgentInboxOpen` there first
+- `modalStore.ts` has `agentInbox` in valid modal IDs (check with `grep "agentInbox" src/renderer/stores/modalStore.ts`) — if not, add it
+
+## Tasks
+
+- [x] In `src/renderer/stores/modalStore.ts`, verify that `agentInbox` is registered as a valid modal ID. Search for `type ModalId` or the array/union of valid modal IDs. If `agentInbox` is NOT present, add it following the pattern used by `directorNotes` or other modals. Also verify `useModalActions()` returns `agentInboxOpen` and `setAgentInboxOpen` — if not, add them following the `directorNotesOpen`/`setDirectorNotesOpen` pattern.
+  > `agentInbox` was already registered as ModalId (line 230) with `AgentInboxModalData` and `setAgentInboxOpen` action. Added `agentInboxOpen` reactive selector to `useModalActions()` return object.
+
+- [x] In `src/renderer/App.tsx`, add the lazy import for AgentInbox near line 46 (next to Director's Notes import):
+  ```typescript
+  const AgentInbox = lazy(() => import('./components/AgentInbox'));
+  ```
+  Then destructure `agentInboxOpen` and `setAgentInboxOpen` from `useModalActions()` (find where `directorNotesOpen` is destructured, around line 356).
+  > Added lazy import at line 49. Destructured `agentInboxOpen` and `setAgentInboxOpen` from `useModalActions()` at lines 360-361.
+
+- [x] In `src/renderer/App.tsx`, add the gated modal render. Find the Director's Notes modal block (line 6017: `{encoreFeatures.directorNotes && directorNotesOpen && (`). AFTER that block, add:
+  ```tsx
+  {encoreFeatures.unifiedInbox && agentInboxOpen && (
+    <Suspense fallback={null}>
+      <AgentInbox
+        theme={theme}
+        sessions={sessions}
+        groups={groups}
+        onClose={() => setAgentInboxOpen(false)}
+        onNavigateToSession={handleNavigateToSession}
+      />
+    </Suspense>
+  )}
+  ```
+  Verify `handleNavigateToSession` or equivalent callback exists (search for the function used by Director's Notes `onResumeSession`). If the exact callback doesn't exist, create a minimal one or use `handleDirectorNotesResumeSession` pattern as reference.
+  > Created `handleAgentInboxNavigateToSession` callback (closes inbox, switches to session). Gated modal render at line 6051 with full props including `enterToSendAI`.
+
+- [x] Wire conditional setters for child components. Find the props assembly area (around line 5220 where Director's Notes does it):
+  - For SessionList: `setAgentInboxOpen: encoreFeatures.unifiedInbox ? setAgentInboxOpen : undefined`
+  - For QuickActionsModal (around line 5634): `onOpenUnifiedInbox: encoreFeatures.unifiedInbox ? () => setAgentInboxOpen(true) : undefined`
+  > Both wired. Also added `setAgentInboxOpen` to keyboard handler ref object for future keybinding support.
+
+- [x] Run `npm run lint` — expect type errors for SessionList/QuickActionsModal props not accepting optional. Note errors for next phases.
+  > 2 expected type errors:
+  > 1. `TS2353`: `setAgentInboxOpen` not in `UseSessionListPropsDeps` type (line 5236)
+  > 2. `TS2322`: `onOpenUnifiedInbox` not in `AppModalsProps` type (line 5652)
+  > Both will be resolved in phases 06-08 when those component prop interfaces are updated.
+
+## Gate
+- `npm run lint` may have type errors (resolved in phases 06-08)
+- `grep -n "agentInboxOpen" src/renderer/App.tsx` returns lazy import, state, gated render, and conditional setters
+- Modal is gated: `encoreFeatures.unifiedInbox && agentInboxOpen`

src/renderer/App.tsx

@@ -46,6 +46,7 @@ const DocumentGraphView = lazy(() =>
 const DirectorNotesModal = lazy(() =>
 	import('./components/DirectorNotes').then((m) => ({ default: m.DirectorNotesModal }))
 );
+const AgentInbox = lazy(() => import('./components/AgentInbox'));
 
 // Re-import the type for SymphonyContributionData (types don't need lazy loading)
 import type { SymphonyContributionData } from './components/SymphonyModal';
@@ -355,6 +356,9 @@ function MaestroConsoleInner() {
 		// Director's Notes Modal
 		directorNotesOpen,
 		setDirectorNotesOpen,
+		// Agent Inbox Modal
+		agentInboxOpen,
+		setAgentInboxOpen,
 	} = useModalActions();
 
 	// --- MOBILE LANDSCAPE MODE (reading-only view) ---
@@ -628,8 +632,11 @@ function MaestroConsoleInner() {
 		setSelectedSidebarIndex,
 	} = useUIStore.getState();
 
-	const { setSelectedFileIndex: _setSelectedFileIndex, setFileTreeFilter: _setFileTreeFilter, setFileTreeFilterOpen } =
-		useFileExplorerStore.getState();
+	const {
+		setSelectedFileIndex: _setSelectedFileIndex,
+		setFileTreeFilter: _setFileTreeFilter,
+		setFileTreeFilterOpen,
+	} = useFileExplorerStore.getState();
 
 	// --- GROUP CHAT STATE (now in groupChatStore) ---
 
@@ -1509,6 +1516,16 @@ function MaestroConsoleInner() {
 		}
 	}, [activeSession?.id, handleResumeSession]);
 
+	// --- AGENT INBOX SESSION NAVIGATION ---
+	// Close inbox modal and switch to the target agent session
+	const handleAgentInboxNavigateToSession = useCallback(
+		(sessionId: string) => {
+			setAgentInboxOpen(false);
+			setActiveSessionId(sessionId);
+		},
+		[setAgentInboxOpen, setActiveSessionId]
+	);
+
 	// --- BATCH HANDLERS (Auto Run processing, quit confirmation, error handling) ---
 	const {
 		startBatchRun,
@@ -4710,6 +4727,7 @@ function MaestroConsoleInner() {
 		setMarketplaceModalOpen,
 		setSymphonyModalOpen,
 		setDirectorNotesOpen,
+		setAgentInboxOpen,
 		encoreFeatures,
 		setShowNewGroupChatModal,
 		deleteGroupChatWithConfirmation,
@@ -5218,6 +5236,7 @@ function MaestroConsoleInner() {
 		setUsageDashboardOpen,
 		setSymphonyModalOpen,
 		setDirectorNotesOpen: encoreFeatures.directorNotes ? setDirectorNotesOpen : undefined,
+		setAgentInboxOpen: encoreFeatures.unifiedInbox ? setAgentInboxOpen : undefined,
 		setGroups,
 		setSessions,
 		setRenameInstanceModalOpen,
@@ -5633,6 +5652,9 @@ function MaestroConsoleInner() {
 					onOpenDirectorNotes={
 						encoreFeatures.directorNotes ? () => setDirectorNotesOpen(true) : undefined
 					}
+					onOpenUnifiedInbox={
+						encoreFeatures.unifiedInbox ? () => setAgentInboxOpen(true) : undefined
+					}
 					autoScrollAiMode={autoScrollAiMode}
 					setAutoScrollAiMode={setAutoScrollAiMode}
 					tabSwitcherOpen={tabSwitcherOpen}
@@ -6028,6 +6050,20 @@ function MaestroConsoleInner() {
 					</Suspense>
 				)}
 
+				{/* --- AGENT INBOX MODAL (lazy-loaded, Encore Feature) --- */}
+				{encoreFeatures.unifiedInbox && agentInboxOpen && (
+					<Suspense fallback={null}>
+						<AgentInbox
+							theme={theme}
+							sessions={sessions}
+							groups={groups}
+							enterToSendAI={enterToSendAI}
+							onClose={() => setAgentInboxOpen(false)}
+							onNavigateToSession={handleAgentInboxNavigateToSession}
+						/>
+					</Suspense>
+				)}
+
 				{/* --- GIST PUBLISH MODAL --- */}
 				{/* Supports both file preview tabs and tab context gist publishing */}
 				{gistPublishModalOpen && (activeFileTab || tabGistContent) && (