ltcai 4.5.1 → 4.6.1

package/frontend/src/App.tsx

@@ -1,259 +1,704 @@
 import * as React from "react";
-import { useQuery } from "@tanstack/react-query";
-import { BrainCircuit, CheckCircle2, Command, Menu, Moon, Search, Sparkles, Sun, X } from "lucide-react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { ImagePlus, Search, Send } from "lucide-react";
 import { latticeApi } from "@/api/client";
 import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { FirstRunGuide } from "@/components/FirstRunGuide";
-import { useAppStore, WorkspaceMode } from "@/store/appStore";
-import { commandRoutes, go, parseHash, primaryRoutes, PrimaryRoute } from "@/routes";
-import { BrainPage } from "@/pages/Brain";
-import { AskPage } from "@/pages/Ask";
-import { CapturePage } from "@/pages/Capture";
-import { ActPage } from "@/pages/Act";
-import { LibraryPage } from "@/pages/Library";
-import { SystemPage } from "@/pages/System";
-import { cn } from "@/lib/utils";
-
-const modes: Array<{ id: WorkspaceMode; label: string }> = [
-  { id: "basic", label: "Calm" },
-  { id: "advanced", label: "Deep" },
-  { id: "admin", label: "Admin" },
+import { type BrainState, LivingBrain, triggerBrainRecall } from "@/components/LivingBrain";
+import { ProductFlow, readProductFlowComplete } from "@/components/ProductFlow";
+import { useAppStore } from "@/store/appStore";
+import { asArray } from "@/lib/utils";
+
+type ApiRecord = Record<string, unknown>;
+type BrainDepth = 1 | 2 | 3 | 4 | 5;
+
+type Message = {
+  role: "user" | "assistant";
+  content: string;
+};
+
+type MemoryFragment = {
+  id: string;
+  title: string;
+  kind: string;
+};
+
+type KnowledgeConcept = {
+  id: string;
+  label: string;
+  type: string;
+  summary: string;
+  importance: number;
+};
+
+type RelationshipThread = {
+  id: string;
+  source: string;
+  target: string;
+  label: string;
+  weight: number;
+};
+
+type KnowledgeGraphModel = {
+  nodes: KnowledgeConcept[];
+  edges: RelationshipThread[];
+};
+
+const DEPTHS: Array<{ level: BrainDepth; label: string; state: BrainState }> = [
+  { level: 1, label: "Living Brain", state: "idle" },
+  { level: 2, label: "Memory Layer", state: "recalling" },
+  { level: 3, label: "Knowledge Layer", state: "synthesizing" },
+  { level: 4, label: "Relationship Layer", state: "planning" },
+  { level: 5, label: "Knowledge Graph", state: "synthesizing" },
 ];
 
-function useRoute() {
-  const [route, setRoute] = React.useState(parseHash);
+export default function App() {
+  const theme = useAppStore((state) => state.theme);
+  const [flowComplete, setFlowComplete] = React.useState(readProductFlowComplete);
+  const { state: brainState, intensity, setBrain } = useBrainState();
+
   React.useEffect(() => {
-    const onHash = () => setRoute(parseHash());
-    window.addEventListener("hashchange", onHash);
-    return () => window.removeEventListener("hashchange", onHash);
+    document.documentElement.dataset.theme = theme;
+  }, [theme]);
+
+  React.useEffect(() => {
+    const onKey = (event: KeyboardEvent) => {
+      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") {
+        event.preventDefault();
+        document.querySelector<HTMLTextAreaElement>(".brain-composer textarea")?.focus();
+      }
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
   }, []);
-  return route;
-}
 
-function Page({ primary, tab }: { primary: PrimaryRoute; tab?: string }) {
-  if (primary === "ask") return <AskPage />;
-  if (primary === "capture") return <CapturePage initialTab={tab} />;
-  if (primary === "act") return <ActPage initialTab={tab} />;
-  if (primary === "library") return <LibraryPage initialTab={tab} />;
-  if (primary === "system") return <SystemPage initialTab={tab} />;
-  return <BrainPage initialTab={tab} />;
-}
+  if (!flowComplete) {
+    return <ProductFlow onComplete={() => setFlowComplete(true)} />;
+  }
 
-function AmbientBrain() {
   return (
-    <div className="ambient-brain" aria-hidden="true">
-      <span className="signal-line signal-line-a" />
-      <span className="signal-line signal-line-b" />
-      <span className="signal-line signal-line-c" />
-      <span className="signal-tile signal-tile-a" />
-      <span className="signal-tile signal-tile-b" />
-      <span className="signal-tile signal-tile-c" />
+    <div className="brain-space">
+      <div className="brain-field" />
+      <BrainHome brainState={brainState} intensity={intensity} onBrainChange={setBrain} />
     </div>
   );
 }
 
-function CommandPalette({ open, onClose }: { open: boolean; onClose: () => void }) {
-  const [query, setQuery] = React.useState("");
-  const normalized = query.trim().toLowerCase();
-  const matches = commandRoutes.filter((route) => (
-    route.label.toLowerCase().includes(normalized) || route.key.includes(normalized)
-  ));
+function useBrainState() {
+  const [state, setState] = React.useState<BrainState>("idle");
+  const [intensity, setIntensity] = React.useState(0.58);
+
+  const setBrain = React.useCallback((next: BrainState, nextIntensity?: number) => {
+    setState(next);
+    if (nextIntensity !== undefined) setIntensity(clamp(nextIntensity, 0.38, 1));
+  }, []);
+
+  return { state, intensity, setBrain };
+}
+
+function BrainHome({
+  brainState,
+  intensity,
+  onBrainChange,
+}: {
+  brainState: BrainState;
+  intensity: number;
+  onBrainChange: (state: BrainState, intensity?: number) => void;
+}) {
+  const qc = useQueryClient();
+  const [messages, setMessages] = React.useState<Message[]>([]);
+  const [draft, setDraft] = React.useState("");
+  const [imageData, setImageData] = React.useState<string | null>(null);
+  const [streaming, setStreaming] = React.useState(false);
+  const [conversationId, setConversationId] = React.useState<string | null>(null);
+  const [explorationDepth, setExplorationDepth] = React.useState<BrainDepth>(1);
+  const [graphSearch, setGraphSearch] = React.useState("");
+  const [selectedGraphId, setSelectedGraphId] = React.useState<string | null>(null);
+  const streamRef = React.useRef<HTMLDivElement>(null);
+  const recallTimerRef = React.useRef<number | null>(null);
+
+  const memoriesQ = useQuery({ queryKey: ["memoryManager"], queryFn: latticeApi.memoryManager });
+  const historyQ = useQuery({ queryKey: ["chatHistory"], queryFn: latticeApi.chatHistory });
+  const graphQ = useQuery({ queryKey: ["graph"], queryFn: latticeApi.graph });
+  const modelsQ = useQuery({ queryKey: ["models"], queryFn: latticeApi.models });
+
+  const memoryFragments = React.useMemo(
+    () => buildMemoryFragments(memoriesQ.data?.data, historyQ.data?.data),
+    [memoriesQ.data, historyQ.data],
+  );
+  const graphModel = React.useMemo(() => parseKnowledgeGraph(graphQ.data?.data), [graphQ.data]);
+  const knowledgeConcepts = React.useMemo(
+    () => graphModel.nodes.slice(0, 10),
+    [graphModel.nodes],
+  );
+  const relationshipThreads = React.useMemo(
+    () => graphModel.edges.slice(0, 10),
+    [graphModel.edges],
+  );
+  const modelName = React.useMemo(() => currentModelName(modelsQ.data?.data), [modelsQ.data]);
+  const currentDepth = DEPTHS[explorationDepth - 1];
 
   React.useEffect(() => {
-    if (!open) return;
-    const onKey = (event: KeyboardEvent) => {
-      if (event.key === "Escape") onClose();
+    if (streaming) onBrainChange("thinking", 0.94);
+    else if (draft.trim().length > 4) onBrainChange("listening", 0.76);
+    else onBrainChange(currentDepth.state, explorationDepth === 1 ? 0.58 : 0.66 + explorationDepth * 0.06);
+  }, [streaming, draft, currentDepth.state, explorationDepth, onBrainChange]);
+
+  React.useEffect(() => {
+    const stream = streamRef.current;
+    if (stream) stream.scrollTop = stream.scrollHeight;
+  }, [messages]);
+
+  React.useEffect(() => {
+    return () => {
+      if (recallTimerRef.current !== null) window.clearTimeout(recallTimerRef.current);
     };
-    window.addEventListener("keydown", onKey);
-    return () => window.removeEventListener("keydown", onKey);
-  }, [open, onClose]);
+  }, []);
+
+  async function send() {
+    const text = draft.trim();
+    if (!text || streaming) return;
+    const activeConversationId = conversationId || `brain-${Date.now()}`;
+    if (!conversationId) setConversationId(activeConversationId);
+
+    setMessages((items) => [...items, { role: "user", content: text }, { role: "assistant", content: "" }]);
+    setDraft("");
+    setImageData(null);
+    setStreaming(true);
+    onBrainChange("thinking", 0.96);
+
+    try {
+      const result = await latticeApi.streamChat(
+        { message: text, conversation_id: activeConversationId, image_data: imageData || undefined },
+        {
+          onChunk: (_delta, fullText) => {
+            setMessages((items) => {
+              const next = [...items];
+              next[next.length - 1] = { role: "assistant", content: fullText };
+              return next;
+            });
+          },
+          onTrace: (trace) => {
+            if (!trace) return;
+            onBrainChange("recalling", 0.9);
+            triggerBrainRecall();
+            if (recallTimerRef.current !== null) window.clearTimeout(recallTimerRef.current);
+            recallTimerRef.current = window.setTimeout(() => onBrainChange("thinking", 0.9), 900);
+          },
+        },
+      );
+      if (result.error) {
+        setMessages((items) => {
+          const next = [...items];
+          next[next.length - 1] = { role: "assistant", content: `Unavailable: ${result.error}` };
+          return next;
+        });
+      }
+    } finally {
+      setStreaming(false);
+      void qc.invalidateQueries({ queryKey: ["chatHistory"] });
+      void qc.invalidateQueries({ queryKey: ["memoryManager"] });
+      void qc.invalidateQueries({ queryKey: ["graph"] });
+    }
+  }
+
+  function deepen() {
+    setExplorationDepth((depth) => {
+      const next = Math.min(5, depth + 1) as BrainDepth;
+      const nextDepth = DEPTHS[next - 1];
+      onBrainChange(nextDepth.state, 0.66 + next * 0.06);
+      if (next >= 2) triggerBrainRecall();
+      return next;
+    });
+  }
+
+  function surface() {
+    setExplorationDepth(1);
+    setSelectedGraphId(null);
+    setGraphSearch("");
+    onBrainChange("idle", 0.58);
+  }
+
+  function recallMemory(fragment: MemoryFragment) {
+    triggerBrainRecall();
+    setExplorationDepth((depth) => Math.max(depth, 2) as BrainDepth);
+    setMessages((items) => [
+      ...items,
+      { role: "assistant", content: `I am recalling ${fragment.kind.toLowerCase()}: ${fragment.title}` },
+    ]);
+  }
 
-  if (!open) return null;
   return (
-    <div className="command-scrim" role="dialog" aria-modal="true" aria-label="Lattice command palette">
-      <div className="command-panel">
-        <div className="command-search">
-          <Search className="h-4 w-4 text-muted-foreground" />
-          <Input value={query} onChange={(event) => setQuery(event.target.value)} autoFocus placeholder="Jump to anything in Lattice" />
-          <Button variant="ghost" size="icon" onClick={onClose} aria-label="Close command palette"><X className="h-4 w-4" /></Button>
+    <main className="brain-home" aria-label="Lattice Brain">
+      <section className="brain-presence" aria-label="Brain exploration">
+        <div className="brain-exploration" data-depth={explorationDepth}>
+          <LivingBrain
+            state={brainState}
+            intensity={intensity + explorationDepth * 0.035}
+            size="large"
+            depth={explorationDepth}
+            showLabel={false}
+            onInteract={deepen}
+          />
+
+          <div className="brain-depth-badge" aria-live="polite">
+            <span>Level {explorationDepth}</span>
+            <strong>{currentDepth.label}</strong>
+          </div>
+
+          <div className="brain-field-layer" aria-hidden={explorationDepth < 2}>
+            <DepthEmergence
+              depth={explorationDepth}
+              memories={memoryFragments}
+              concepts={knowledgeConcepts}
+              relationships={relationshipThreads}
+              graphModel={graphModel}
+              graphSearch={graphSearch}
+              selectedGraphId={selectedGraphId}
+              onGraphSearch={setGraphSearch}
+              onSelectGraphNode={setSelectedGraphId}
+              onRecallMemory={recallMemory}
+            />
+          </div>
+
+          {explorationDepth > 1 ? (
+            <button className="brain-surface-control" type="button" onClick={surface}>
+              Surface
+            </button>
+          ) : null}
         </div>
-        <div className="command-list soft-scrollbar">
-          {matches.map((route) => {
-            const Icon = route.icon;
-            return (
-              <button
-                key={route.key}
-                onClick={() => {
-                  go(route.key);
-                  onClose();
+      </section>
+
+      <section className="brain-conversation" aria-label="Conversation">
+        <div className="brain-conversation-header">
+          <div>
+            <h1>Lattice Brain</h1>
+            <span>{currentDepth.label}</span>
+          </div>
+          <div>{modelName}</div>
+        </div>
+
+        <div ref={streamRef} className="brain-stream">
+          {messages.length === 0 ? (
+            <div className="mind-empty">
+              <div className="mind-empty-kicker">Begin</div>
+              <div>What are you thinking about?</div>
+            </div>
+          ) : (
+            messages.map((message, index) => (
+              <div key={`${message.role}-${index}`} className={`brain-message ${message.role}`}>
+                <div className="brain-message-bubble">{message.content}</div>
+              </div>
+            ))
+          )}
+        </div>
+
+        <div className="brain-composer">
+          <textarea
+            value={draft}
+            onChange={(event) => setDraft(event.target.value)}
+            onKeyDown={(event) => {
+              if (event.key === "Enter" && !event.shiftKey) {
+                event.preventDefault();
+                void send();
+              }
+            }}
+            placeholder="Talk to your Brain..."
+          />
+          <div className="brain-composer-actions">
+            <label className="brain-image-input">
+              <ImagePlus className="h-3.5 w-3.5" />
+              <span>Image</span>
+              <input
+                type="file"
+                accept="image/*"
+                className="sr-only"
+                onChange={async (event) => {
+                  const file = event.target.files?.[0];
+                  if (file) setImageData(await fileToDataUrl(file));
                 }}
-                className="command-row"
-              >
-                <span className="command-icon"><Icon className="h-4 w-4" /></span>
-                <span>
-                  <span className="block text-sm font-semibold">{route.label}</span>
-                  <span className="block text-xs text-muted-foreground">Open {route.key.replace(/[-/]/g, " ")}</span>
-                </span>
-              </button>
-            );
-          })}
+              />
+            </label>
+            {imageData ? <span className="brain-quiet-success">Image attached</span> : null}
+            <Button onClick={() => void send()} disabled={!draft.trim() || streaming} className="rounded-full px-5">
+              <Send className="h-4 w-4" /> Send
+            </Button>
+          </div>
         </div>
-      </div>
-    </div>
+      </section>
+    </main>
+  );
+}
+
+function DepthEmergence({
+  depth,
+  memories,
+  concepts,
+  relationships,
+  graphModel,
+  graphSearch,
+  selectedGraphId,
+  onGraphSearch,
+  onSelectGraphNode,
+  onRecallMemory,
+}: {
+  depth: BrainDepth;
+  memories: MemoryFragment[];
+  concepts: KnowledgeConcept[];
+  relationships: RelationshipThread[];
+  graphModel: KnowledgeGraphModel;
+  graphSearch: string;
+  selectedGraphId: string | null;
+  onGraphSearch: (value: string) => void;
+  onSelectGraphNode: (id: string | null) => void;
+  onRecallMemory: (fragment: MemoryFragment) => void;
+}) {
+  if (depth === 1) return null;
+
+  return (
+    <>
+      {depth >= 2 ? (
+        <MemoryLayer memories={memories} depth={depth} onRecallMemory={onRecallMemory} />
+      ) : null}
+      {depth >= 3 && depth < 5 ? (
+        <KnowledgeLayer concepts={concepts} depth={depth} />
+      ) : null}
+      {depth >= 4 && depth < 5 ? (
+        <RelationshipLayer concepts={concepts} relationships={relationships} />
+      ) : null}
+      {depth >= 5 ? (
+        <EmergentKnowledgeGraph
+          model={graphModel}
+          search={graphSearch}
+          selectedId={selectedGraphId}
+          onSearch={onGraphSearch}
+          onSelect={onSelectGraphNode}
+        />
+      ) : null}
+    </>
   );
 }
 
-function PrimaryDock({ active, onNavigate }: { active: PrimaryRoute; onNavigate?: () => void }) {
+function MemoryLayer({
+  memories,
+  depth,
+  onRecallMemory,
+}: {
+  memories: MemoryFragment[];
+  depth: BrainDepth;
+  onRecallMemory: (fragment: MemoryFragment) => void;
+}) {
+  const visible = memories.slice(0, depth >= 3 ? 8 : 6);
+  if (!visible.length) return <div className="memory-fragment is-empty">Memory is quiet</div>;
+
   return (
-    <nav className="primary-dock" aria-label="Primary navigation">
-      {primaryRoutes.map((item) => {
-        const Icon = item.icon;
-        const selected = active === item.id;
+    <>
+      {visible.map((memory, index) => {
+        const point = polarPoint(index, visible.length, depth >= 3 ? 39 : 31, depth >= 3 ? 24 : 18, -112);
         return (
           <button
-            key={item.id}
-            className={cn("dock-button", selected && "is-active")}
-            onClick={() => {
-              go(item.id);
-              onNavigate?.();
-            }}
-            aria-current={selected ? "page" : undefined}
+            key={memory.id}
+            type="button"
+            className="memory-fragment"
+            style={layerStyle({ "--x": `${point.x}%`, "--y": `${point.y}%`, "--delay": `${index * 55}ms` })}
+            onClick={() => onRecallMemory(memory)}
           >
-            <Icon className="h-4 w-4" />
-            <span>{item.label}</span>
+            <span>{memory.kind}</span>
+            <strong>{memory.title}</strong>
           </button>
         );
       })}
-    </nav>
+    </>
   );
 }
 
-function ModeSwitch({ mode, setMode }: { mode: WorkspaceMode; setMode: (mode: WorkspaceMode) => void }) {
+function KnowledgeLayer({ concepts, depth }: { concepts: KnowledgeConcept[]; depth: BrainDepth }) {
+  const visible = concepts.slice(0, depth >= 4 ? 10 : 7);
+  if (!visible.length) return <div className="concept-signal is-empty">Knowledge is forming</div>;
+
   return (
-    <div className="mode-switch" aria-label="Experience mode">
-      {modes.map((item) => (
-        <button
-          key={item.id}
-          className={cn(mode === item.id && "is-active")}
-          onClick={() => setMode(item.id)}
-          aria-pressed={mode === item.id}
-        >
-          {item.label}
-        </button>
-      ))}
-    </div>
+    <>
+      {visible.map((concept, index) => {
+        const point = polarPoint(index, visible.length, 24, 15, -70);
+        return (
+          <button
+            key={concept.id}
+            type="button"
+            className="concept-signal"
+            style={layerStyle({ "--x": `${point.x}%`, "--y": `${point.y}%`, "--delay": `${index * 45}ms` })}
+            title={concept.summary || concept.type}
+          >
+            <span>{concept.type}</span>
+            {concept.label}
+          </button>
+        );
+      })}
+    </>
   );
 }
 
-export default function App() {
-  const route = useRoute();
-  const { theme, setTheme, mode, setMode } = useAppStore();
-  const [drawer, setDrawer] = React.useState(false);
-  const [palette, setPalette] = React.useState(false);
-  const health = useQuery({ queryKey: ["health"], queryFn: latticeApi.health });
-  const desktop = useQuery({
-    queryKey: ["desktopBackendStatus"],
-    queryFn: latticeApi.desktopBackendStatus,
-    enabled: Boolean(window.__TAURI_INTERNALS__),
-    refetchInterval: 5000,
-  });
-  const workspace = useQuery({ queryKey: ["workspaceOs"], queryFn: latticeApi.workspaceOs });
+function RelationshipLayer({
+  concepts,
+  relationships,
+}: {
+  concepts: KnowledgeConcept[];
+  relationships: RelationshipThread[];
+}) {
+  const visibleConcepts = concepts.slice(0, 10);
+  const layout = layoutGraphNodes(visibleConcepts, 30, 20);
+  const positionById = new Map(layout.map((item) => [item.node.id, item]));
+  const visibleRelationships = relationships
+    .map((relationship, index) => {
+      const source = positionById.get(relationship.source) || layout[index % Math.max(layout.length, 1)];
+      const target = positionById.get(relationship.target) || layout[(index + 3) % Math.max(layout.length, 1)];
+      return source && target && source.node.id !== target.node.id ? { relationship, source, target } : null;
+    })
+    .filter(Boolean)
+    .slice(0, 8) as Array<{
+      relationship: RelationshipThread;
+      source: ReturnType<typeof layoutGraphNodes>[number];
+      target: ReturnType<typeof layoutGraphNodes>[number];
+    }>;
 
-  React.useEffect(() => {
-    document.documentElement.dataset.theme = theme;
-  }, [theme]);
+  if (!visibleRelationships.length) return null;
 
-  React.useEffect(() => {
-    const onKey = (event: KeyboardEvent) => {
-      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") {
-        event.preventDefault();
-        setPalette(true);
-      }
-    };
-    window.addEventListener("keydown", onKey);
-    return () => window.removeEventListener("keydown", onKey);
-  }, []);
+  return (
+    <svg className="relationship-weave" viewBox="0 0 100 100" aria-hidden>
+      {visibleRelationships.map(({ relationship, source, target }, index) => (
+        <line
+          key={`${relationship.id}-${index}`}
+          x1={source.x}
+          y1={source.y}
+          x2={target.x}
+          y2={target.y}
+          style={{ animationDelay: `${index * 80}ms` }}
+        />
+      ))}
+    </svg>
+  );
+}
 
-  const healthData = (health.data?.data || {}) as Record<string, unknown>;
-  const workspaceData = (workspace.data?.data || {}) as Record<string, unknown>;
-  const desktopData = (desktop.data?.data || {}) as Record<string, unknown>;
-  const appVersion = typeof healthData.version === "string" ? healthData.version : null;
-  const activeRoute = primaryRoutes.find((item) => item.id === route.primary);
-  const workspaceName = String(workspaceData.active_workspace || "Personal space");
-  const backendReady = Boolean(health.data?.ok);
-  const desktopReady = !window.__TAURI_INTERNALS__ || Boolean(desktopData.running);
+function EmergentKnowledgeGraph({
+  model,
+  search,
+  selectedId,
+  onSearch,
+  onSelect,
+}: {
+  model: KnowledgeGraphModel;
+  search: string;
+  selectedId: string | null;
+  onSearch: (value: string) => void;
+  onSelect: (id: string | null) => void;
+}) {
+  const query = search.trim().toLowerCase();
+  const visibleNodes = React.useMemo(() => {
+    const filtered = model.nodes.filter((node) => {
+      if (!query) return true;
+      return `${node.label} ${node.type} ${node.summary}`.toLowerCase().includes(query);
+    });
+    return filtered.slice(0, 18);
+  }, [model.nodes, query]);
+  const layout = React.useMemo(() => layoutGraphNodes(visibleNodes, 38, 24), [visibleNodes]);
+  const positionById = React.useMemo(() => new Map(layout.map((item) => [item.node.id, item])), [layout]);
+  const visibleEdges = React.useMemo(
+    () => model.edges.filter((edge) => positionById.has(edge.source) && positionById.has(edge.target)).slice(0, 36),
+    [model.edges, positionById],
+  );
+  const selected = visibleNodes.find((node) => node.id === selectedId) || visibleNodes[0] || null;
 
   return (
-    <div className="app-backdrop min-h-screen text-foreground">
-      <AmbientBrain />
-      <CommandPalette open={palette} onClose={() => setPalette(false)} />
-
-      <header className="app-chrome">
-        <div className="brand-lockup">
-          <button className="mobile-menu" onClick={() => setDrawer(true)} aria-label="Open navigation"><Menu className="h-5 w-5" /></button>
-          <button className="brand-mark" onClick={() => go("brain")} aria-label="Open Lattice home">
-            <BrainCircuit className="h-5 w-5" />
-          </button>
-          <div className="brand-copy">
-            <div className="brand-name">Lattice</div>
-            <div className="brand-subtitle">Digital Brain</div>
-          </div>
+    <section className="mind-core-graph" data-testid="emergent-knowledge-graph" aria-label="Knowledge Graph">
+      <div className="brain-graph-head">
+        <div>
+          <span>Level 5</span>
+          <strong>Knowledge Graph</strong>
         </div>
+        <label className="brain-graph-search">
+          <Search className="h-3.5 w-3.5" />
+          <input
+            value={search}
+            onChange={(event) => onSearch(event.target.value)}
+            placeholder="Search"
+            aria-label="Search knowledge graph"
+          />
+        </label>
+      </div>
 
-        <div className="desktop-dock">
-          <PrimaryDock active={route.primary} />
+      {visibleNodes.length ? (
+        <div className="brain-graph-canvas">
+          <svg className="brain-graph-edges" viewBox="0 0 100 100" aria-hidden>
+            {visibleEdges.map((edge, index) => {
+              const source = positionById.get(edge.source);
+              const target = positionById.get(edge.target);
+              if (!source || !target) return null;
+              return (
+                <line
+                  key={`${edge.id}-${index}`}
+                  x1={source.x}
+                  y1={source.y}
+                  x2={target.x}
+                  y2={target.y}
+                  style={{ "--weight": String(clamp(edge.weight, 0.4, 2.8)) } as React.CSSProperties}
+                />
+              );
+            })}
+          </svg>
+          {layout.map(({ node, x, y }, index) => (
+            <button
+              key={node.id}
+              type="button"
+              className={`graph-node ${selected?.id === node.id ? "is-selected" : ""}`}
+              style={layerStyle({ "--x": `${x}%`, "--y": `${y}%`, "--delay": `${index * 35}ms` })}
+              onClick={() => onSelect(node.id)}
+            >
+              <span>{node.type}</span>
+              {node.label}
+            </button>
+          ))}
         </div>
+      ) : (
+        <div className="brain-graph-empty">No matching knowledge yet</div>
+      )}
 
-        <div className="chrome-actions">
-          <button className="status-chip" onClick={() => go("settings")}>
-            <span className={cn("status-light", backendReady && desktopReady ? "is-ready" : "is-waiting")} />
-            <span>{backendReady && desktopReady ? "Ready" : "Starting"}</span>
-          </button>
-          <Button variant="outline" onClick={() => setPalette(true)}><Command className="h-4 w-4" /> Find</Button>
-          <Button variant="outline" size="icon" onClick={() => setTheme(theme === "dark" ? "light" : "dark")} aria-label="Toggle theme">
-            {theme === "dark" ? <Sun className="h-4 w-4" /> : <Moon className="h-4 w-4" />}
-          </Button>
-        </div>
-      </header>
-
-      {drawer ? (
-        <div className="mobile-drawer">
-          <button className="drawer-scrim" aria-label="Close navigation" onClick={() => setDrawer(false)} />
-          <div className="drawer-panel">
-            <div className="drawer-header">
-              <div>
-                <div className="font-semibold">Lattice</div>
-                <div className="text-xs text-muted-foreground">Choose a room</div>
-              </div>
-              <Button variant="ghost" size="icon" onClick={() => setDrawer(false)} aria-label="Close navigation"><X className="h-4 w-4" /></Button>
-            </div>
-            <PrimaryDock active={route.primary} onNavigate={() => setDrawer(false)} />
-          </div>
-        </div>
-      ) : null}
+      <div className="brain-graph-focus">
+        {selected ? (
+          <>
+            <span>{selected.type}</span>
+            <strong>{selected.label}</strong>
+            <p>{selected.summary || "This concept is part of the deepest knowledge layer."}</p>
+          </>
+        ) : (
+          <p>Capture documents, conversations, or projects to grow the graph.</p>
+        )}
+      </div>
+    </section>
+  );
+}
 
-      <main className="page-shell">
-        <section className="workspace-ribbon" aria-label="Current workspace">
-          <div className="min-w-0">
-            <div className="ribbon-kicker"><Sparkles className="h-4 w-4" /> {activeRoute?.label || "Home"}</div>
-            <h1>{activeRoute?.description || "A calm place to think with your knowledge."}</h1>
-          </div>
-          <div className="ribbon-meta">
-            <div className="meta-card">
-              <CheckCircle2 className="h-4 w-4 text-primary" />
-              <span>{workspaceName}</span>
-            </div>
-            <div className="meta-card">
-              <span>{appVersion ? `v${appVersion}` : "Version checking"}</span>
-            </div>
-            <ModeSwitch mode={mode} setMode={setMode} />
-          </div>
-        </section>
+function buildMemoryFragments(memoryData: unknown, historyData: unknown): MemoryFragment[] {
+  const memory = isRecord(memoryData) ? memoryData : {};
+  const sourceRows = asArray<ApiRecord>(memory.sources).length
+    ? asArray<ApiRecord>(memory.sources)
+    : asArray<ApiRecord>(memory.tiers);
+  const sourceFragments = sourceRows.map((item, index) => ({
+    id: textValue(item, ["id", "source", "label"], `memory-${index}`),
+    title: textValue(item, ["title", "label", "source", "path", "name"], "Workspace memory"),
+    kind: titleValue(item, ["type", "source_type", "kind", "health"], "Memory"),
+  }));
+  const conversationFragments = asArray<ApiRecord>(historyData).map((item, index) => ({
+    id: textValue(item, ["id", "conversation_id"], `conversation-${index}`),
+    title: textValue(item, ["title", "summary", "id"], "Conversation"),
+    kind: "Conversation",
+  }));
 
-        <FirstRunGuide />
-        <Page primary={route.primary} tab={route.tab} />
-      </main>
-    </div>
-  );
+  return uniqueById([...sourceFragments, ...conversationFragments]).slice(0, 10);
+}
+
+function parseKnowledgeGraph(data: unknown): KnowledgeGraphModel {
+  const graph = isRecord(data) ? data : {};
+  const rawNodes = asArray<ApiRecord>(graph.nodes);
+  const rawEdges = asArray<ApiRecord>(graph.edges);
+  const nodes = rawNodes.flatMap((node): KnowledgeConcept[] => {
+    const id = textValue(node, ["id", "node_id", "title", "label"]);
+    if (!id) return [];
+    const metadata = isRecord(node.metadata) ? node.metadata : {};
+    const type = titleValue(node, ["type", "kind", "category"], "Concept");
+    const label = textValue(node, ["title", "label", "name"], id.replace(/^[^:]+:/, ""));
+    const summary = textValue(node, ["summary", "description", "snippet"]) || textValue(metadata, ["summary", "description", "relative_path", "filename"]);
+    const importance = clamp(numberValue(node, ["importance_norm", "importance", "score"]) || 0.5, 0.08, 1);
+    return [{ id, label, type, summary, importance }];
+  }).sort((left, right) => right.importance - left.importance);
+  const ids = new Set(nodes.map((node) => node.id));
+  const edges = rawEdges.flatMap((edge, index): RelationshipThread[] => {
+    const source = textValue(edge, ["from", "source", "source_id"]);
+    const target = textValue(edge, ["to", "target", "target_id"]);
+    if (!source || !target || !ids.has(source) || !ids.has(target)) return [];
+    return [{
+      id: textValue(edge, ["id"], `edge-${index}`),
+      source,
+      target,
+      label: titleValue(edge, ["type", "label", "relationship"], "Relates"),
+      weight: numberValue(edge, ["weight", "score", "confidence"]) || 1,
+    }];
+  });
+  return { nodes, edges };
+}
+
+function currentModelName(data: unknown) {
+  const record = isRecord(data) ? data : {};
+  const current = textValue(record, ["current", "current_model", "local_model"]);
+  if (current) return current;
+  const loaded = asArray<ApiRecord>(record.loaded || record.loaded_models);
+  const firstLoaded = loaded.find((item) => item.id || item.name || item.model_id);
+  return firstLoaded ? textValue(firstLoaded, ["name", "id", "model_id"], "local mind") : "local mind";
+}
+
+function fileToDataUrl(file: File) {
+  return new Promise<string>((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(String(reader.result || ""));
+    reader.onerror = () => reject(reader.error);
+    reader.readAsDataURL(file);
+  });
+}
+
+function layoutGraphNodes(nodes: KnowledgeConcept[], radiusX: number, radiusY: number) {
+  return nodes.map((node, index) => {
+    const point = polarPoint(index, nodes.length, radiusX, radiusY, -88);
+    return { node, x: point.x, y: point.y };
+  });
+}
+
+function polarPoint(index: number, total: number, radiusX: number, radiusY: number, offsetDegrees = -90) {
+  const count = Math.max(total, 1);
+  const angle = ((360 / count) * index + offsetDegrees) * Math.PI / 180;
+  return {
+    x: 50 + Math.cos(angle) * radiusX,
+    y: 50 + Math.sin(angle) * radiusY,
+  };
+}
+
+function layerStyle(values: Record<string, string>) {
+  return values as React.CSSProperties;
+}
+
+function uniqueById<T extends { id: string }>(items: T[]) {
+  const seen = new Set<string>();
+  return items.filter((item) => {
+    if (seen.has(item.id)) return false;
+    seen.add(item.id);
+    return true;
+  });
+}
+
+function isRecord(value: unknown): value is ApiRecord {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+function textValue(record: ApiRecord, keys: string[], fallback = "") {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim()) return value;
+    if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  }
+  return fallback;
+}
+
+function titleValue(record: ApiRecord, keys: string[], fallback = "") {
+  const value = textValue(record, keys, fallback);
+  return value
+    .replace(/[_-]+/g, " ")
+    .replace(/\b\w/g, (character) => character.toUpperCase());
+}
+
+function numberValue(record: ApiRecord, keys: string[]) {
+  for (const key of keys) {
+    const value = Number(record[key]);
+    if (Number.isFinite(value)) return value;
+  }
+  return 0;
+}
+
+function clamp(value: number, min: number, max: number) {
+  return Math.max(min, Math.min(max, value));
 }