Feature/graph visualization clustering improvements

.flake8

@@ -0,0 +1,12 @@
+[flake8]
+max-line-length = 100
+select = E9,F63,F7,F82
+show_source = True
+extend-exclude =
+  .venv,
+  venv,
+  node_modules,
+  packages/graph-viewer/node_modules,
+  packages/graph-viewer/dist,
+  packages/graph-viewer/.vite,
+  tests/benchmarks

.gitignore

@@ -27,3 +27,6 @@ tests/benchmarks/locomo/
 node_modules/
 # Experiment results (promote notable runs to tests/benchmarks/results/)
 /tests/benchmarks/experiments/results_*/
+packages/graph-viewer/dist/
+packages/graph-viewer/node_modules/
+automem/static/viewer/

AGENTS.md

@@ -44,6 +44,19 @@
 - Never commit secrets. Configure via env vars: `AUTOMEM_API_TOKEN`, `ADMIN_API_TOKEN`, `OPENAI_API_KEY`, `FALKORDB_PASSWORD`, `QDRANT_API_KEY`.
 - Local dev uses Docker defaults; see `docs/ENVIRONMENT_VARIABLES.md` and `docker-compose.yml` for ports and credentials.
 
+## Task Completion Checklist
+**CRITICAL**: Before declaring any coding task complete, ALWAYS:
+1. **Run the build**: `make build` (Python) or `npm run build` (graph-viewer)
+2. **Run lints**: `make lint` (Python) or `npm run tsc` (TypeScript)
+3. **Run tests** (if applicable): `make test` or `npm test`
+4. **If any fail**: Iterate and fix until all pass
+5. **Never commit or deploy** code that doesn't build
+
+For graph-viewer specifically:
+```bash
+cd packages/graph-viewer && npm run build
+```
+
 ## Agent Memory Protocol
 
 Follow rules in `.cursor/rules/automem.mdc` for memory operations.

Dockerfile

@@ -1,22 +1,41 @@
-# Dockerfile - Flask API runtime image
+# Dockerfile - Flask API runtime image with optional Graph Viewer
+# Multi-stage build: Node.js for frontend, Python for backend
+
+# Stage 1: Build the Graph Viewer frontend
+FROM node:20-slim AS frontend-builder
+
+WORKDIR /build
+
+# Copy package files and install dependencies
+COPY packages/graph-viewer/package*.json ./
+RUN npm ci --silent
+
+# Copy source and build
+COPY packages/graph-viewer/ ./
+RUN npm run build
+
+# Stage 2: Python runtime
 FROM python:3.11-slim
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1
 
 WORKDIR /app
 
-# Install system deps (none currently, but keep hook for Falkor client libs if needed)
+# Install system deps
 RUN apt-get update && apt-get install -y --no-install-recommends \
     build-essential \
     && rm -rf /var/lib/apt/lists/*
 
 COPY requirements.txt ./
 RUN pip install --no-cache-dir -r requirements.txt
 
-# Copy the full application source into the image
+# Copy the full application source
 COPY . .
 
+# Copy the built frontend from stage 1
+COPY --from=frontend-builder /build/dist/ ./automem/static/viewer/
+
 EXPOSE 8001
 
 CMD ["python", "app.py"]