Toju/electron/AGENTS.md

Electron Guidelines

This directory contains the Electron main process, preload bridge, IPC, desktop integration, and local persistence glue.

Workflow

• Build with npm run build:electron.
• Use npm run electron:dev or npm run dev when you need the integrated desktop stack.
• See ../doc/typescript.md for shared TypeScript rules.

Boundaries

• Keep bootstrapping and lifecycle concerns in app/.
• Keep desktop platform integrations in focused modules such as audio/, update/, and window/.
• Keep renderer-exposed APIs typed in preload.ts and routed through explicit IPC handlers.
• When adding a new renderer-facing capability, update the Electron implementation, the preload surface, and the renderer bridge together.
• Keep persistence entities, migrations, and CQRS helpers aligned with the desktop database model rather than duplicating renderer types.

Generated Output

• Treat dist/electron/ and packaged artifacts in dist-electron/ as build output, not source.

Before You Finish

• Validate whether relevant markdown docs or AGENTS.md files need updates. If behavior, workflows, commands, or architecture changed, update those docs in the same task.