Rename 'BGE Server' to 'Embedding Server' - no longer uses BGE model

[DarrenZal]

Problem

The embedding server is named "BGE Server" but it no longer uses the BGE (BAAI General Embedding) model. It now uses OpenAI's text-embedding-3-large API.

Current code in src/core/bge_server.py:

OPENAI_MODEL = "text-embedding-3-large"

This naming inconsistency causes confusion when debugging and reviewing logs/alerts.

Scope of Rename

koi-processor repo

• src/core/bge_server.py → embedding_server.py
• Systemd service: koi-bge-server.service → koi-embedding-server.service
• Log files: logs/bge_server.log → logs/embedding_server.log
• Monitoring scripts referencing "BGE"
• Any imports or references in other files

Other repos to search

• koi-sensors - may reference BGE server URL/health checks
• koi-net - if it exists, may have references
• regen-koi - MCP server may reference embedding service
• GAIA - may have embedding service references
• Documentation repos - READMEs, guides

System-level changes

• Systemd unit files in /etc/systemd/system/
• Any nginx/proxy configs
• Monitoring/alerting configs
• Environment variables

Search Commands

Run these across all repos to find references:

# Find all references to "bge" (case insensitive)
grep -ri "bge" --include="*.py" --include="*.sh" --include="*.yaml" --include="*.yml" --include="*.json" --include="*.md" --include="*.service" .

# Find URL references
grep -ri "8090\|bge.server\|bge_server\|bge-server" .

# Find in systemd
grep -ri "bge" /etc/systemd/system/

# Find in nginx/configs
grep -ri "bge" /etc/nginx/ 2>/dev/null

Proposed New Names

Current	Proposed
bge_server.py	embedding_server.py
koi-bge-server.service	koi-embedding-server.service
BGE Server (in alerts/logs)	Embedding Server
BGE_SERVER_URL	EMBEDDING_SERVER_URL

Migration Steps

1. Search phase - Find all references across all repos
2. Update code - Rename files and update imports
3. Update configs - Systemd, nginx, monitoring
4. Update services - Stop old, start new service name
5. Symlink (temporary) - Keep old log path working during transition
6. Update docs - READMEs, runbooks, etc.
7. Cleanup - Remove old service files, symlinks

Risks

• Service downtime during rename if not done carefully
• Broken references if not all repos updated
• Log rotation configs may need updating
• Monitoring alerts may need reconfiguring

Alternative

Keep the name but add a comment explaining the history:

# Note: "BGE Server" is a legacy name. Now uses OpenAI embeddings.

This is lower effort but doesn't fix the confusion.

Labels

tech-debt, cleanup, documentation