Research-Stack/4-Infrastructure/infra/ene-rds/README.md

INFRA:DEAD rds -- AWS RDS is gone. Any file referencing rds_connect.py or this hostname is stale and must be ported.

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	localhost	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 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.