Initial Ralph scaffold

agent_docs/tech_stack.md

@@ -0,0 +1,51 @@
+# Tech Stack Decisions
+
+# Tech Stack
+
+- **Language**: TypeScript
+- **Runtime**: Node.js 20
+- **Framework**: NestJS 10
+- **Testing**: Jest (backend), Vitest (frontend)
+- **Build Tool**: Docker Compose, pnpm workspaces, tsup
+
+## Libraries
+
+- TypeORM
+- PostgreSQL
+- @nestjs/jwt
+- @nestjs/passport
+- @nestjs/websockets
+- @nestjs/platform-socket.io
+- @nestjs/schedule
+- @nestjs/config
+- class-validator
+- class-transformer
+- bcrypt
+- date-fns
+- ical.js
+- node-caldav
+- @microsoft/microsoft-graph-client
+- imap
+- axios
+- bull
+- ioredis
+- helmet
+- express-rate-limit
+- React 18
+- Vite 5
+- React Router
+- TanStack Query (React Query)
+- Zustand
+- FullCalendar
+- react-beautiful-dnd
+- socket.io-client
+- date-fns
+- React Hook Form
+- Zod
+- TailwindCSS
+- Radix UI
+
+
+## Rationale
+
+TypeScript provides type safety across full stack for complex scheduling logic and GTD workflows. NestJS offers robust REST API structure, dependency injection for external integrations (CalDAV, ConnectWise, IMAP, Microsoft Graph), scheduled jobs for recurring reviews, and WebSocket support. React with a calendar library (FullCalendar or react-big-calendar) handles the interactive drag-drop week view. PostgreSQL over SQLite for better concurrency with multiple capture sources and complex scheduling queries. Docker Compose orchestrates backend, database, and frontend nginx container for simple self-hosted deployment.