Add production rollout tooling and semantic index ops docs

Capture the production plugin rollout workflow and Qdrant validation steps so operations stay repeatable. Also harden redMCP stdio/schema compatibility to keep diverse MCP clients and validators working.
This commit is contained in:
Jason Thistlethwaite
2026-05-06 22:18:02 -04:00
parent 1f4c3d35ef
commit bd26c8894f
10 changed files with 765 additions and 4 deletions
+22
View File
@@ -38,6 +38,28 @@ SEMANTIC_INDEX_OVERLAP_MINUTES=15
Keep `OPENAI_API_KEY`, `QDRANT_URL`, `REDMINE_URL`, and `REDMINE_API_KEY` in the
existing `.env` workflow or in the service manager environment.
Current WireGuard addressing used by this environment:
- production server: `10.11.0.100`
- LAN server: `10.11.0.105`
If Qdrant stays on the LAN server, set:
```sh
QDRANT_URL=http://10.11.0.105:6333
```
Keep Qdrant bound to the WireGuard/LAN path only and protect it with
`QDRANT_API_KEY`.
From the production server, run `./validate_qdrant.py` to verify Qdrant liveness,
readiness, auth, and a minimal create/upsert/read/delete round trip.
```sh
QDRANT_API_KEY=... ./validate_qdrant.py
./validate_qdrant.py --skip-write-test
```
For production-style deployment, use `/opt/semantic-index` for code,
`/etc/semantic-index.env` for service environment, `/var/lib/semantic-index`
for refresh state, and `/var/log/semantic-index` for refresh logs. Systemd