Architecture

grind/
├── packages/
│   ├── core/     # @grindxp/core   Domain engine
│   ├── cli/      # @grindxp/cli    Clack-based CLI
│   ├── tui/      # @grindxp/tui    OpenTUI terminal dashboard
│   └── web/      # @grindxp/web    TanStack Start web app
├── docs/                         Mintlify documentation
├── package.json                  Bun workspaces root
├── tsconfig.json                 Shared TypeScript config
└── biome.json                    Shared formatter/linter

User Action (CLI / TUI / Web / Webhook)
        ↓
@grindxp/core domain functions
        ↓
Repository layer (CRUD operations)
        ↓
Vault (SQLite via libsql)
        ↓
Optional: Turso cloud sync

User message (TUI chat / CLI chat)
        ↓
agent/runtime.ts (runAgent() async generator)
        ↓
Vercel AI SDK (streams tokens, tool calls)
        ↓
agent/tools.ts (executes tools: quest ops, file ops, bash)
        ↓
Results streamed back to user

Signal arrives (webhook / git hook / file event / cron)
        ↓
forge/runtime.ts (forge tick)
        ↓
forge/engine.ts (rule evaluation)
        ↓
Action plan built and executed
        ↓
Quest created / completed / XP awarded

// Wrong
const obj = { optionalProp: undefined };

// Right
const obj = { ...(value !== undefined && { optionalProp: value }) };