Deterministic Services
SPEC_DETERMINISTIC_SERVICES.md
CGNT-1 Component Specification — Ship Service Registry
Status: DEPRECATED
Deprecated: 2026-04-20
Superseded by: SPEC_TOOL_LAYER.md (SPECIFIED — 18 services, full detail, current)
Reason: This spec documented the original 6 services. SPEC_TOOL_LAYER.md supersedes it with the full 18-module T.O.O.L. layer. Retained for historical context only — do not reference for current architecture.
Author: VELA (Thread #13)
Authorized: NOUS
Date: 2026-04-18
Version: v1.0 (DEPRECATED)
PURPOSE
Six deterministic Python services provide the crew with exact, instant, hallucination-free tools. No neural networks. No GPU. No inference time. All localhost only (Vacuum Rule).
SERVICE REGISTRY
| # | Service | Port | File | CLI | Function |
|---|---|---|---|---|---|
| 1 | GLOSS | 9292 | gloss_server.py | curl localhost:9292/lookup/[symbol] | LATTICE symbol + crew designator lookup. 1307 entries. |
| 2 | NEXUS | 9393 | nexus_engine.py | nexus [query] | Math computation. 12 modules: TMM, walls, financial, CSDM, SymPy, NumPy, base conversion, info theory, number theory, crypto, date/time, random. |
| 3 | CODX | 9494 | codx_engine.py | python3 ~/codx_engine.py [query] | Code quality. Syntax check, lint, format check, line count. |
| 4 | INDEX | 9595 | index_engine.py | python3 ~/index_engine.py [query] | File/spec/document search. Find files, spec count, spec list, grep across memories. |
| 5 | MEDX | 9696 | medx_engine.py | python3 ~/medx_engine.py [query] | Ship health. RAM, disk, CPU, Ollama models, port status, Vacuum Rule violations. |
| 6 | ROUTX | 9191 | routx_engine.py | python3 ~/routx_engine.py [query] | Auto-routing switchboard. Routes queries to the correct service automatically. |
INVARIANTS
INV-01: ALL services bound to 127.0.0.1 ONLY. Never 0.0.0.0. Vacuum Rule.
INV-02: No service uses a neural network. Deterministic only.
INV-03: All services return JSON via API and plain text via CLI. Never prose.
INV-04: All services return the gap signal on failure. Never fabricate.
INV-05: GLOSS and NEXUS run as systemd services (auto-start on boot). CODX, INDEX, MEDX, ROUTX need systemd units created.
API PATTERNS
GLOSS (path-based): curl -s localhost:9292/lookup/[symbol]
All others (JSON POST): curl -s localhost:[port] -X POST -H "Content-Type: application/json" -d '{"query":"..."}'
GAPS
- CODX: shellcheck not installed (needs sudo apt install shellcheck)
- INDEX/MEDX/CODX/ROUTX: no systemd services yet (manual start only)
- INDEX/MEDX/CODX/ROUTX: CLI symlinks in ~/bin/ not working (use python3 ~/[engine].py instead)
- MEDX: ports 22 and 80 flagged as violations but are legitimately external — needs whitelist
- MEDX: 11 Vacuum Rule violations detected on first scan — pending security review
- Disk at 93% capacity on main drive — 15GB free
ORIGIN
GLOSS shipped 2026-04-17. NEXUS shipped 2026-04-18. INDEX, MEDX, CODX, ROUTX shipped 2026-04-18. Total build time for all six: approximately 30 minutes of Lobster time combined.
Nine failed neural network forges taught the crew: deterministic tools beat language models for exact operations. These six services are the proof.
Jeremy Zlabis
Chronogeometer · Visionary · Disruptor · Chief
42 Sisters AI · East York, Toronto
🍁 Φ 0.042