feat(graph): continual-learning graph data model + dark-Bauhaus viz

Adds the team_model graph layer (the "it learned" view) and its visualization, per docs/graph.md. Demo-backed first; built on origin/main conventions. - shared: PodGraph / node / edge / metric types + GraphNodeDoc / GraphEdgeDoc - backend/src/graph: demo graph data; Mongo store (loadPodGraph w/ demo fallback, seedGraph, reachFrom via $graphLookup); graph:seed script - backend/src/server.ts: additive GET /api/pods/:id/graph + /graph/reach/:node - frontend: dark-Bauhaus GraphView + fetch helper, reachable from a "Team memory" toggle in App.tsx - docs/graph.md: spec (data model, $graphLookup, API, demo-first plan) Demo-backed: the route serves a grounded demo graph when team_model has no graph yet; graph:seed writes team_model + graph_nodes/graph_edges so the $graphLookup traversal is real. Swap loadPodGraph to live team_model later. Known follow-ups before merge: branch is based on 65a0791; origin/main is now at 1294b84, so this needs a rebase + App.tsx conflict resolution (teammate rewrote App.tsx with live room view / one-click join). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 17:34:02 -07:00
parent 1294b8428d
commit 546aeeed70
11 changed files with 892 additions and 7 deletions
@@ -0,0 +1,88 @@
+import type { PodGraph, GraphNodeDoc, GraphEdgeDoc } from '@podman/shared';
+import { getDb } from '../memory/db.js';
+import { createDemoPodGraph } from './demo.js';
+
+interface TeamModelDoc {
+  podId: string;
+  graph?: PodGraph;
+  updatedAt?: string;
+}
+
+/**
+ * Load a pod's continual-learning graph. Reads the embedded `team_model.graph`;
+ * falls back to a grounded demo graph when none exists yet or Mongo is
+ * unreachable — so the demo path never depends on a populated DB.
+ */
+export async function loadPodGraph(podId: string): Promise<PodGraph> {
+  try {
+    const db = await getDb();
+    const doc = await db.collection<TeamModelDoc>('team_model').findOne({ podId });
+    if (doc?.graph) return doc.graph;
+  } catch (err) {
+    console.warn(`[graph] loadPodGraph fell back to demo: ${(err as Error).message}`);
+  }
+  return createDemoPodGraph(podId);
+}
+
+/**
+ * Seed a pod's graph into Mongo: embed it in `team_model` and mirror nodes/edges
+ * into `graph_nodes` / `graph_edges` so `$graphLookup` traversal is real, not a
+ * mock. Idempotent — safe to run repeatedly.
+ */
+export async function seedGraph(podId: string): Promise<PodGraph> {
+  const db = await getDb();
+  const graph = createDemoPodGraph(podId);
+  const nodes = db.collection<GraphNodeDoc>('graph_nodes');
+  const edges = db.collection<GraphEdgeDoc>('graph_edges');
+
+  await Promise.all([
+    nodes.createIndex({ podId: 1, id: 1 }, { unique: true }),
+    edges.createIndex({ podId: 1, source: 1 }),
+    db.collection('team_model').createIndex({ podId: 1 }, { unique: true }),
+  ]);
+
+  await db
+    .collection<TeamModelDoc>('team_model')
+    .updateOne(
+      { podId },
+      { $set: { podId, graph, updatedAt: new Date().toISOString() } },
+      { upsert: true },
+    );
+
+  await Promise.all([nodes.deleteMany({ podId }), edges.deleteMany({ podId })]);
+  if (graph.nodes.length) await nodes.insertMany(graph.nodes.map((n) => ({ ...n, podId })));
+  if (graph.edges.length) await edges.insertMany(graph.edges.map((e) => ({ ...e, podId })));
+
+  return graph;
+}
+
+export interface ReachResult {
+  start: string;
+  reaches: GraphEdgeDoc[];
+}
+
+/**
+ * Walk the directed edge chain from a node with MongoDB `$graphLookup` — answers
+ * "what does this node's work reach?" (engineer -> file -> collision ->
+ * intervention). This is the graph-database traversal that powers the risk path.
+ */
+export async function reachFrom(podId: string, startNodeId: string): Promise<ReachResult> {
+  const db = await getDb();
+  const rows = await db
+    .collection<GraphEdgeDoc>('graph_edges')
+    .aggregate<{ reaches: GraphEdgeDoc[] }>([
+      { $match: { podId, source: startNodeId } },
+      {
+        $graphLookup: {
+          from: 'graph_edges',
+          startWith: '$target',
+          connectFromField: 'target',
+          connectToField: 'source',
+          as: 'reaches',
+          restrictSearchWithMatch: { podId },
+        },
+      },
+    ])
+    .toArray();
+  return { start: startNodeId, reaches: rows.flatMap((r) => r.reaches) };
+}