SyslogSolution/prose-contracts
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: capture all session changes — port conflict, health check, streaming
PR Pipeline — Authorize → Validate → Review → Merge / auth (push) Successful in 4s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (push) Failing after 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (push) Has been skipped
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (push) Has been skipped
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (push) Has been skipped
Details

Browse Source 
Updated contracts to reflect all infrastructure changes made 2026-07-05/06:

gpu-fleet.prose.md:
  - Port conflict detection on all 3 GPU wrappers
  - Ghost process root cause documented (.8 stale pid 25836)

infrastructure-control.prose.md:
  - Section 7: Agent Health Check (consolidated, non-disruptive)
  - Disabled scripts documented (zulip-watchdog, zulip-monitor)

hermes-agent-baseline.prose.md:
  - Health verification section + GPU port conflict detection
  - Change log updated

zulip-health.prose.md:
  - Streaming support section (edit_message + PATCH API)
This commit is contained in:
root
2026-07-06 02:46:41 +00:00
parent 79855ea9e1
commit 5aa93117de
4 changed files with 66 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
hermes-agent-baseline.prose.md
+20
View File
@@ -179,6 +179,25 @@ EnvironmentFile=/etc/environment # sources LITELLM_API_KEY
| Documents | `~/.hermes/cache/documents/` |
| Audio | `~/.hermes/cache/audio/` |
## Health Verification
Run the consolidated health check:
```bash
python3 /root/scripts/agent-health-check.py
```
This validates all 4 LiteLLM keys, detects GPU port conflicts (ghost processes),
verifies gateway liveness, confirms Zulip streaming (`edit_message` present),
and counts recent errors. Non-disruptive — never restarts anything.
## GPU Port Conflict Detection
All 3 GPU hosts have pre-start ghost detection in their launch wrappers:
- `.8` and `.110`: inline check in `llama-wrapper.sh`
- `.15`: `/usr/local/bin/port-cleanup.sh` (ExecStartPre, replaces blanket `pkill`)
Detection pattern: `ss -tlnp` on port 8080 → compare pid against `systemctl MainPID`.
If they differ → ghost detected → kill ghost → start fresh.
## Related Contracts
- `hermes-key-enforcement.prose.md` — key policy, rotation, detection query
@@ -191,4 +210,5 @@ EnvironmentFile=/etc/environment # sources LITELLM_API_KEY
| Date | Change |
|------|--------|
| 2026-07-06 | Port conflict detection added to all 3 GPU wrappers. Consolidated health check script deployed. Zulip streaming edit_message enabled for Tanko/Mumuni. |
| 2026-07-05 | Baseline created. All 4 agents audited, master key removed, api_key workaround applied |