Instruction file imported from krovomi/WorkPilot-AI (.github/instructions/electron-main.instructions.md). Copyright stays with the author.

Electron Main Process — Instructions

Stack

• Electron + TypeScript, build via electron-vite.
• IPC handlers organisés par domaine dans apps/frontend/src/main/ipc-handlers/.
• Services métier au niveau racine du dossier main/ (un fichier par service).
• Terminal multi-PTY via node-pty (terminal/).

Règles

1. Tout handler IPC est défini par ipcMain.handle(channel, ...) dans ipc-handlers/ et exposé côté preload via apps/frontend/src/preload/api/.
2. Channels nommés via constantes de apps/frontend/src/shared/constants/ipc.ts ou ipc-namespaces.ts. Jamais de string littéral.
3. Tout type de réponse IPC est dans apps/frontend/src/shared/types/ipc.ts.
4. Logs via app-logger.ts — pas de console.log en prod.
5. Lecture de fichiers projet : passer par fs-utils.ts (sandboxing).
6. Aucune exécution shell sans validation (security.ts côté backend).
7. Hot-reload via electron-vite ; les services doivent être idempotents au reload.

Sections clés (gros services)

Token-saving

• Beaucoup de fichiers > 500 lignes. Préférer grep ciblé.
• Voir apps/frontend/AGENTS.md pour la cartographie complète.

Anti-patterns

• Importer du code renderer/ dans main/ — interdit (Electron isolation).
• Modifier le filesystem hors fs-utils.ts ou worktree-paths.ts.
• Créer un handler IPC sans le déclarer dans ipc-namespaces.ts.