Research-Stack/4-Infrastructure/infra/ene-rds/README.md
Brandon Schneider 9d450756c1 Expand ene-rds Rust workspace and refine devcontainer
- Add ene-node, ene-rds-chat, ene-rds-ephemeral, ene-rds-wiki,
  ene-storage, ene-sync crates to the ene-rds workspace
- Extend ene-rds-core with shared types and cluster messaging
- Add review doc and wiki page for the RDS Rust workspace
- Fix devcontainer: custom /etc/passwd with researcher user,
  add gcc/glibc/binutils for VS Code server compatibility,
  include util-linux, gnutar, gzip; add LD_LIBRARY_PATH
- Ignore Nix build output (`result`) and Rust artifacts

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-05-19 07:52:39 +00:00

2.4 KiB

ENE RDS — Rust workspace replacing the Python RDS stack

Workspace structure

Crate Purpose Replaces
ene-rds-core Shared PostgreSQL client, DSN builder, vec_to_pgtext, receipts ene_rds_* base connection logic
ene-rds-wiki Wiki CRUD + full-text search + revision tracking ene_rds_wiki_layer.py
ene-rds-ephemeral EphemeralNode thermal zones, tasks, receipts, scars, metrics ene_rds_ephemeral_node.py
ene-rds-chat Chat session ingestion, keyword/semantic search ene_rds_chat_log.py
ene-api Axum HTTP server mounting all surfaces on :3000 ene_chat_api.py + FastAPI
ene-sync Polls opencode.db SQLite → upserts into RDS chat tables ene_claw_sync.py

Build

cd 4-Infrastructure/infra/ene-rds
cargo build --release

Run

Initialize schema only

export RDS_PASSWORD=...
./target/release/ene-sync init-schema

One-shot sync

./target/release/ene-sync sync --embed

Watch mode (polls every 60s)

./target/release/ene-sync watch --interval 60 --embed

API server

./target/release/ene-api
# → http://0.0.0.0:3000/health
# → http://0.0.0.0:3000/sessions
# → http://0.0.0.0:3000/search?q=thermal+zone
# → http://0.0.0.0:3000/wiki/search?q=compression
# → http://0.0.0.0:3000/ephemeral/nodes?zone=hot

Environment variables

Variable Default Purpose
RDS_HOST database-1.cluster-c9i0w8eu8fnv.us-east-2.rds.amazonaws.com PostgreSQL host
RDS_PORT 5432 PostgreSQL port
RDS_USER postgres PostgreSQL user
RDS_PASSWORD Password or IAM token
RDS_DB postgres Database name
OLLAMA_HOST http://localhost:11434 Ollama embedding endpoint
OLLAMA_EMBED_MODEL nomic-embed-text Embedding model

What changed from Python

  • No psycopg2 / boto3 runtime dependency — single static binary
  • tokio-postgres with with-serde_json-1 feature for native JSONB support
  • pgvector vectors passed as '[0.1,0.2,...]'::vector text format
  • Ollama embeddings via reqwest instead of requests
  • SQLite source via rusqlite with bundled bindings
  • Axum replaces FastAPI for the API server

Python bridge (optional)

The standalone bridge_wrapper.py still exists for calling legacy Python modules that have not been ported. The Rust surfaces do not depend on it.