merway7 / hivebrain-docs

# Session Log

## 2026-04-04/05 — Major build session

### Features built
- **Combs** — project knowledge repos (schema, lib, API, MCP, UI)
- **Wikis** — personal knowledge bases, Karpathy pattern (schema, lib, API, MCP, Wikipedia-style UI)
- **Vercel deployment** — Turso cloud DB, @astrojs/vercel adapter
- **Local-only wikis** — getLocalDb() in db.ts, wikis never touch cloud

### Known bugs for next session
1. Wiki markdown renderer broken — shows raw # and ** instead of HTML
2. Wiki CSS required is:global and rgba() fallbacks (color-mix broke it)
3. SVG icons needed explicit width/height attributes

### Architecture
- Combs: cloud (Turso via @libsql/client/http)
- Wikis: local (SQLite via getLocalDb())
- MCP tools: 4 comb tools + 6 wiki tools
- Web UI: /combs, /wikis routes
- CLAUDE.md Rule 2.5: push to combs/wikis during sessions

### Files changed
- db/schema.sql — combs tables (v13) + wiki tables (v14)
- src/lib/combs.ts — new (500 lines)
- src/lib/wikis.ts — new (734 lines)
- src/lib/db.ts — getLocalDb(), initLocalClient(), HTTP client for Turso
- mcp-server/index.ts — 10 new tools
- src/pages/api/combs.ts, combs/[...slug].ts — new
- src/pages/api/wikis.ts, wikis/[...slug].ts — new
- src/pages/combs/index.astro, [...slug].astro — new
- src/pages/wikis/index.astro, [...slug].astro — new (3195 lines)
- astro.config.mjs — @astrojs/vercel adapter
- src/middleware.ts — try/catch on initDb
- .vercelignore — exclude db files