Feature/basuruk/nu 009 alias matching, delta apply, refcounted provenance

.env.example

@@ -18,8 +18,12 @@ NURON_AI_DB_HOST=127.0.0.1
 NURON_AI_DB_PORT=5432
 
 # --- Neo4j -------------------------------------------------------------------
-# Community edition has exactly one user, `neo4j`.
+# Community edition has exactly one user, `neo4j`, and exactly one database -- no
+# NEO4J_USERNAME/NEO4J_DATABASE var, nothing to configure.
 NEO4J_PASSWORD=changeme
+# Host-published bolt port (see docker-compose.yml) -- nuron-ai isn't containerized yet,
+# so it talks to Neo4j over the host network, not the `nuron` compose network.
+NEO4J_URI=bolt://127.0.0.1:7687
 
 # --- RustFS ------------------------------------------------------------------
 RUSTFS_ACCESS_KEY=changeme

docker-compose.yml

@@ -62,9 +62,10 @@ services:
       NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:?NEO4J_PASSWORD is required}
     volumes:
       - neo4j_data:/data
-    # ports:
-    #   - "127.0.0.1:7474:7474"
-    #   - "127.0.0.1:7687:7687"
+    ports:
+      # ponytail: host-published bolt until nuron-ai joins the `nuron` network (NU-005). HTTP
+      # browser UI (7474) stays commented out -- nothing here needs it.
+      - "127.0.0.1:7687:7687"
     networks:
       - nuron
     healthcheck:

services/nuron-ai/pyproject.toml

@@ -12,6 +12,7 @@ dependencies = [
     "fsspec>=2026.7.0",
     "llama-cloud>=1.0",
     "llama-index-core==0.14.23",
+    "llama-index-graph-stores-neo4j==0.8.0",
     "llama-index-llms-openai-like==0.8.0",
     "openai>=2.54.0,<3",
     "psycopg[binary]>=3.3.5",
@@ -30,7 +31,7 @@ dev = [
 
 [[tool.mypy.overrides]]
 # These libraries ship no py.typed marker; nothing to check against.
-module = ["defusedxml.*", "fsspec.*", "llama_index.llms.openai_like.*"]
+module = ["defusedxml.*", "fsspec.*", "llama_index.llms.openai_like.*", "llama_index.graph_stores.neo4j.*", "neo4j.*"]
 ignore_missing_imports = true