docs: add workflow research, architecture, strategy, and critique

Generated by the planning workflow: validated API findings (Gemini/LiveKit/ GitHub/DO), full architecture synthesis, winning strategy, and red-team critique. Canonical source files staged under docs/generated/files/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 14:31:25 -07:00
parent da5b2622b2
commit 2d7adea8e5
16 changed files with 1577 additions and 0 deletions
@@ -0,0 +1,35 @@
+import 'dotenv/config';
+
+function req(name: string): string {
+  const v = process.env[name];
+  if (!v) throw new Error(`Missing required env var: ${name}`);
+  return v;
+}
+function opt(name: string, fallback = ''): string {
+  return process.env[name] ?? fallback;
+}
+
+export const env = {
+  // LiveKit
+  LIVEKIT_URL: req('LIVEKIT_URL'),
+  LIVEKIT_API_KEY: req('LIVEKIT_API_KEY'),
+  LIVEKIT_API_SECRET: req('LIVEKIT_API_SECRET'),
+  // Gemini
+  GEMINI_API_KEY: req('GEMINI_API_KEY'),
+  GEMINI_VISION_MODEL: opt('GEMINI_VISION_MODEL', 'gemini-3.5-flash'),
+  GEMINI_LIVE_MODEL: opt('GEMINI_LIVE_MODEL', 'gemini-3.1-flash-live-preview'),
+  // GitHub
+  GITHUB_TOKEN: req('GITHUB_TOKEN'),
+  GITHUB_REPO: req('GITHUB_REPO'), // owner/name
+  // Mongo + Voyage
+  MONGODB_URI: req('MONGODB_URI'),
+  VOYAGE_API_KEY: opt('VOYAGE_API_KEY'),
+  // Server
+  PORT: Number(opt('PORT', '8787')),
+} as const;
+
+export function repoParts(): { owner: string; repo: string } {
+  const [owner, repo] = env.GITHUB_REPO.split('/');
+  if (!owner || !repo) throw new Error('GITHUB_REPO must be "owner/name"');
+  return { owner, repo };
+}