31 lines
2.1 KiB
Plaintext
31 lines
2.1 KiB
Plaintext
# Ralph Progress Log
|
|
Started: Thu Feb 19 16:33:18 CET 2026
|
|
---
|
|
|
|
## Codebase Patterns
|
|
- Vite configs use `.mts` extension to avoid ESM/CJS issues with electron-forge
|
|
- Native Node modules (e.g. better-sqlite3) must be externalized in `vite.main.config.mts` rollupOptions.external
|
|
- `AutoUnpackNativesPlugin` from `@electron-forge/plugin-auto-unpack-natives` must be first in plugins array in forge.config.ts for native module asar compatibility
|
|
- DB is initialized in main process `app.on('ready')` handler; use `getDb()` singleton everywhere else in main process
|
|
- All table IDs are TEXT (UUID); timestamps are INTEGER (unix ms); status/priority columns use TEXT with enum values
|
|
- TypeScript types use `InferSelectModel` / `InferInsertModel` from drizzle-orm — no manual type duplication
|
|
- `drizzle.config.ts` at project root points drizzle-kit CLI at `src/main/db/schema.ts`
|
|
|
|
---
|
|
|
|
## 2026-02-19 - US-002
|
|
- Installed `better-sqlite3`, `drizzle-orm` (runtime) and `@types/better-sqlite3`, `drizzle-kit` (dev)
|
|
- Created `src/main/db/schema.ts`: 5 tables (clients, projects, tasks, checkpoints, notes) with exported InferSelectModel/InferInsertModel types
|
|
- Created `src/main/db/index.ts`: `initDb()` opens/creates `adiuva.db` at `app.getPath('userData')`, runs CREATE TABLE IF NOT EXISTS (non-destructive), enables WAL mode; `getDb()` singleton accessor
|
|
- Updated `src/main/index.ts`: call `initDb()` in `app.on('ready')`
|
|
- Updated `vite.main.config.mts`: externalized `better-sqlite3`
|
|
- Updated `forge.config.ts`: added `AutoUnpackNativesPlugin`
|
|
- Added `drizzle.config.ts` for drizzle-kit CLI
|
|
- Typecheck: passes with zero errors
|
|
- **Learnings for future iterations:**
|
|
- better-sqlite3 is CommonJS with native addon; Vite must NOT bundle it — always add to rollupOptions.external
|
|
- The CREATE TABLE IF NOT EXISTS approach satisfies "never destructive" and works perfectly in electron without needing migration file resolution
|
|
- electron-forge rebuilds native modules automatically on `electron-forge start`; no manual rebuild step needed
|
|
- `app.getPath('userData')` is only available after `app.on('ready')` fires — do not call earlier
|
|
---
|