IPC Handlers

Domain-organized IPC request handlers for main process.

Structure

ipc/
├── handlers.ts          # Initialization and registration
├── config.ts            # App configuration handlers
├── configValidation.ts  # Config input validation/sanitization
├── guards.ts            # IPC argument type guards
├── notifications.ts     # Notification management
├── projects.ts          # Project listing, repository grouping
├── search.ts            # Session content search
├── sessions.ts          # Session operations, pagination
├── subagents.ts         # Subagent detail drill-down
├── utility.ts           # Shell operations, file reading
└── validation.ts        # Path validation, file mentioning

Handler Pattern

Each domain module exports:

// Setup with services
initialize{Domain}Handlers(services)

// Register with ipcMain
register{Domain}Handlers(ipcMain)

// Cleanup on app quit
remove{Domain}Handlers(ipcMain)

Service Dependencies

initializeIpcHandlers() receives service instances:

• ProjectScanner - File system scanning
• SessionParser - JSONL parsing
• SubagentResolver - Subagent linking
• ChunkBuilder - Chunk analysis
• DataCache - Result caching

Response Pattern

Config handlers use IpcResult<T> wrapper:

return { success: true, data: result };
return { success: false, error: message };

Other handlers return data directly or null on error.

Adding New Handler

1. Add to existing domain file or create new file
2. Call initialize{Domain}Handlers() if new domain
3. Add register/remove{Domain}Handlers in handlers.ts
4. Add channel constant in preload/constants/ipcChannels.ts
5. Add method to ElectronAPI in preload/index.ts
6. Implement service logic in src/main/services/