feat: scaffold Brain of Reese — FastAPI RAG chat over Postgres 17 + pgvector

Foundation (phase 01, verified): - FastAPI app: /api/health, /api/suggestions, /api/chat (placeholder), static frontend served locally (no CDN) - Postgres 17 + pgvector via db/Containerfile + compose.yaml (podman compose up -d db), Alembic initial migration (documents, chunks with vector(768), query_log) - LLM client targeting https://aipi.reeseapps.com/v1 (turbo/embed); scripts/llm_probe.py verified models + 768-dim embeddings live - Conditional debugpy: imported only when DEBUGPY=1 (attach on demand, :5678); logging config for clean single-line logs - Frontend shell: mobile-first chat + Sources pages, tokens, a11y baselines - Tests: 24 unit+integration (99% coverage on app/), ruff + pyright clean, Playwright smoke E2E (3 tests) against a deterministic mock LLM - Planning: .agent/PLAN.md (architecture + LOCKED decisions), AGENTS.md, 6 user stories, 7 phase files (one story / one phase / one Playwright suite each)
2026-08-21 13:42:21 -04:00
commit 022da8e2bc
63 changed files with 5225 additions and 0 deletions
@@ -0,0 +1,76 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  <meta name="description" content="Ask Brain of Reese anything about the homelab and deployments.">
+  <title>Brain of Reese</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>🧠</text></svg>">
+  <link rel="stylesheet" href="/assets/styles.css">
+</head>
+<body>
+  <a class="skip-link" href="#main">Skip to content</a>
+
+  <header class="app-header">
+    <div class="container header-inner">
+      <span class="brand">
+        <span class="brand-mark" aria-hidden="true">🧠</span>
+        <span class="brand-text">Brain of <strong>Reese</strong></span>
+      </span>
+      <nav class="app-nav" aria-label="Primary">
+        <a href="/" class="nav-link is-active" aria-current="page">Chat</a>
+        <a href="/sources.html" class="nav-link">Sources</a>
+      </nav>
+    </div>
+  </header>
+
+  <main id="main" class="app-main">
+    <div class="container chat-shell" data-state="empty">
+      <div class="kb-banner" id="kb-banner" role="status" hidden>
+        <span aria-hidden="true">⚠️</span>
+        <span id="kb-banner-text"></span>
+      </div>
+
+      <section class="messages" id="messages" aria-live="polite" aria-label="Conversation with Brain of Reese">
+        <div class="empty-state" id="empty-state">
+          <div class="empty-state-emoji" aria-hidden="true">👋</div>
+          <h1 class="empty-state-title">Hey! I'm Brain of Reese.</h1>
+          <p class="empty-state-sub">
+            I've read through the homelab and deployment notes — ask me anything,
+            and I'll point you at the exact doc. You've got this.
+          </p>
+          <div class="suggestions" id="suggestions" role="list" aria-label="Suggested questions">
+            <!-- suggestion chips rendered by app.js from /api/suggestions -->
+          </div>
+        </div>
+      </section>
+
+      <form class="composer" id="composer">
+        <label class="visually-hidden" for="message-input">Ask Brain of Reese a question</label>
+        <textarea
+          id="message-input"
+          name="message"
+          rows="1"
+          placeholder="Ask me about the homelab…"
+          autocomplete="off"
+          required
+        ></textarea>
+        <button type="submit" class="send-btn" id="send-btn">
+          <span class="spinner" aria-hidden="true" hidden></span>
+          <span class="btn-label" id="send-label">Send</span>
+          <span class="visually-hidden" aria-live="polite" id="send-status"></span>
+        </button>
+      </form>
+    </div>
+  </main>
+
+  <footer class="app-footer">
+    <div class="container footer-inner">
+      <span>Powered by Reese's self-hosted models</span>
+      <span class="footer-version" id="app-version"></span>
+    </div>
+  </footer>
+
+  <script type="module" src="/assets/app.js"></script>
+</body>
+</html>