DevMemory AI is structured around a Single Runtime Architecture. All entry points—CLI commands, Chokidar filesystem watcher daemons, and local Web Dashboard handlers—delegate execution to a single central Runtime instance (src/runtime/index.ts).
| Component | Responsibility | Writes Engineering Memory? |
|---|---|---|
CLI (src/cli) |
Command argument parsing & output rendering | No — Delegates to Runtime |
Watcher (src/watcher) |
Observes filesystem events & calculates cooldown | No — Observes & notifies |
Transactions (src/transactions) |
Groups events into build transactions | No — Groups events only |
Compiler (src/compiler) |
AST parsing & intent synthesis | Yes — Sole writer |
Database (src/database) |
SQLite index (WAL mode) & repositories | No — Stores & queries |
Dashboard (src/dashboard) |
Local HTTP server & browser UI | No — Reads runtime API |
Search (src/search) |
SQLite FTS5 query engine | No — Queries index |
Filesystem Event -> Watcher -> Transaction Manager -> Engineering Compiler -> SQLite Index -> Dashboard / CLI / AI