# NousResearch/hermes-agent · Signal gateway setup docs gaps and fixes

## Open now

- 1 issue, 1 PR open on GitHub.
- #31674: Signal gateway setup: four pitfalls undocumented in signal.md (Java 25 pinning, ACI UUID auth, 409 stuck-state recovery, bbernhard incompatibility)
- PR #55689: fix(signal): align setup guidance with native daemon

These items address undocumented pitfalls in Signal gateway setup, covering Java 25 pinning, ACI UUID authentication, 409 stuck-state recovery, and bbernhard incompatibility warnings. The work spans both documentation updates and alignment of setup guidance with the native daemon.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 1 open PR(s), 0 merged PR(s), 1 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.67`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #31674: Signal gateway setup: four pitfalls undocumented in signal.md (Java 25 pinning, ACI UUID auth, 409 stuck-state recovery, bbernhard incompatibility)

## Prior & competing PRs

- **#31919: docs(signal): document Java 25, ACI UUID allowlist, 409 recovery, bbernhard warning**. closed without merge
  - maintainer direction: category `stale_abandoned`; implication `active`
- **#55689: fix(signal): align setup guidance with native daemon**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `dc7d504ac`
  - files: `apps/desktop/src/app/messaging/index.tsx`, `apps/desktop/src/i18n/ar_command_center.ts`, `apps/desktop/src/i18n/de.ts`, `apps/desktop/src/i18n/en.ts`, `apps/desktop/src/i18n/es.ts`, `apps/desktop/src/i18n/fr.ts`, `apps/desktop/src/i18n/ja.ts`, `apps/desktop/src/i18n/ru.ts`, `apps/desktop/src/i18n/zh-hant_command_center.ts`, `apps/desktop/src/i18n/zh.ts`, `hermes_cli/web_routers/messaging.py`, `plugins/platforms/signal/plugin.yaml`, `plugins/platforms/signal/register.py`, `plugins/platforms/signal/setup.py`, `tests/hermes_cli/test_signal_setup_metadata.py`, `website/docs/user-guide/messaging/signal.md`

## Fix status

- No merged fix on record.
- Subsystem: `docs`