Skip to content

feat: add optional Hermes negotiator bridge#1

Open
upsetbit wants to merge 2 commits into
masterfrom
feat/hermes-negotiator-hooks
Open

feat: add optional Hermes negotiator bridge#1
upsetbit wants to merge 2 commits into
masterfrom
feat/hermes-negotiator-hooks

Conversation

@upsetbit

@upsetbit upsetbit commented May 19, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a safe-by-default Ralph Loop Hermes negotiator bridge script for Claude/Codex hook events
  • Clarify that Hermes is a passive TUI unblocker, not a second active coding governor
  • Document that Hermes should only do the minimum safe unblock action: answer blocking TUI prompts, retry after usage/rate limits, or handle max-iteration/restart handoffs so Codex/Ralph can keep running
  • Add Claude settings and Codex notify fragments for optional hook configuration
  • Document the executor/governor/Hermes negotiation flow and guardrails
  • Add unittest coverage for attention classification, RALPH_DONE suppression, dedupe, and no-op behavior when no webhook is configured

Test Plan

  • python3 -m unittest tests/test_hermes_bridge.py
  • git diff --check
  • Previous PR validation remains covered: py_compile, JSON/TOML parse checks, Markdown local-link check

upsetbit added 2 commits May 18, 2026 22:31
Add a safe-by-default Ralph Loop hook bridge that forwards attention-worthy Claude/Codex events to a configured Hermes webhook, plus hook fragments, documentation, and unittest coverage. Missing Hermes or webhook configuration remains a successful no-op so the manual workflow is preserved.

Validation: python -m unittest discover -s tests -v; python -m py_compile .codex/skills/ralph-loop-governor/scripts/ralph-loop-hermes-bridge.py; JSON/TOML parse checks; markdown local-link check; git diff --check
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant