Integrate canonical architecture: two-process backend + LiveKit agent

Promote all 12 staged canonical files from docs/generated/files/ to their
live paths, creating the full PodMan architecture:

Backend:
- server.ts: HTTP service (token mint, sync-PR, outcome recording, /health, WS relay)
- agent.ts: worker joining LiveKit room, grabbing screenshare frames at ~1fps
- agent/podman.ts: orchestrator loop (vision -> collision detection -> intervention)
- env.ts: flat env var accessors replacing nested stub
- vision/gemini.ts: JPEG -> Gemini vision -> EngineerContext (real implementation)
- collision/detector.ts: fused vision+GitHub collision detection (the moat)
- github/client.ts: Octokit wrapper with caching + sync PR creation
- memory/store.ts: extended with recordObservation/recordCollision/recordIntervention/recordOutcome helpers
- memory/vectors.ts: stub for Voyage+Atlas vector recall (Loop A)
- memory/policy.ts: stub for intervention policy gate (Loop B)
- voice/live.ts: stub for Gemini Live TTS voice output

Shared:
- messages.ts: LiveKit data-channel wire protocol (DataMessage, InterventionOutcome, TeamModel, LocalGitReport)
- index.ts: re-exports messages module

Frontend:
- livekit/useScreenPublish.ts: hook for joining pod and publishing screenshare
- livekit/useInterventions.ts: hook for receiving collision cards and responding
- lib/api.ts: fetchToken + postOutcome HTTP helpers

Database:
- database/init.ts: MongoDB Atlas collections + indexes + vector search index

Infra:
- infra/.do/app.yaml: DO App Platform spec (static_site + service + worker)

Retire stubs superseded by canonical decomposition:
- backend/src/index.ts (replaced by server.ts)
- backend/src/intervention/engine.ts (logic now in agent/podman.ts)
- backend/src/livekit/token.ts (token minting now in server.ts)

Install missing dependencies: @livekit/rtc-node, sharp, mongodb, ws, @types/ws

Type error fixes:
- vision/gemini.ts: use MediaResolution.MEDIA_RESOLUTION_LOW enum value (not string literal)
- agent/podman.ts: wrap SuggestedActionKind into { kind: action } SuggestedAction object

All packages pass pnpm -r typecheck and pnpm -r build.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

database/init.ts

@@ -0,0 +1,41 @@
+import { MongoClient } from 'mongodb';
+
+const uri = process.env.MONGODB_URI!;
+const DB = 'podman';
+
+async function main() {
+  const client = new MongoClient(uri);
+  await client.connect();
+  const db = client.db(DB);
+
+  await db.collection('pods').createIndex({ id: 1 }, { unique: true });
+  // High-volume observations expire after 6h to keep the cluster light.
+  await db.collection('observations').createIndex({ observedAt: 1 }, { expireAfterSeconds: 21600 });
+  await db.collection('observations').createIndex({ podId: 1, engineerId: 1 });
+  await db.collection('collisions').createIndex({ podId: 1, detectedAt: -1 });
+  await db.collection('interventions').createIndex({ id: 1 }, { unique: true });
+  await db.collection('team_model').createIndex({ podId: 1 }, { unique: true });
+  await db.collection('policy').createIndex({ pattern: 1 }, { unique: true });
+
+  // Atlas Vector Search index for collision-pattern recall (Voyage voyage-3 = 1024 dims).
+  try {
+    await db.command({
+      createSearchIndexes: 'memory_vectors',
+      indexes: [
+        {
+          name: 'vector_index',
+          type: 'vectorSearch',
+          definition: {
+            fields: [{ type: 'vector', path: 'embedding', numDimensions: 1024, similarity: 'cosine' }],
+          },
+        },
+      ],
+    });
+  } catch (e) {
+    console.warn('vector index (create in Atlas UI if this errors):', (e as Error).message);
+  }
+
+  console.log('PodMan DB initialized.');
+  await client.close();
+}
+main().catch((e) => { console.error(e); process.exit(1); });