# NousResearch/hermes-agent · WhatsApp Baileys creds.json corruption and preflight validation

## Open now

- 1 issue, 2 PRs open on GitHub.
- #138627: \[Bug\]: WhatsApp Baileys bridge: 0-byte creds.json corruption causes headless timeout loop + Windows file lock contention on re-pair
- PR #138634: fix(whatsapp): fail preflight on a truncated or invalid creds.json
- PR #139191: fix(whatsapp): handle locked session dir on re-pair and reject empty creds in preflight

The members concern WhatsApp session credentials: one bug report describes a 0-byte creds.json leading to a headless timeout loop and Windows file lock contention on re-pair. Two pull requests propose preflight checks for truncated, invalid, or empty creds, with one also handling a locked session directory during re-pair.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 2 open PR(s), 0 merged PR(s), 0 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

- #138627: \[Bug\]: WhatsApp Baileys bridge: 0-byte creds.json corruption causes headless timeout loop + Windows file lock contention on re-pair

## Prior & competing PRs

- **#138634: fix(whatsapp): fail preflight on a truncated or invalid creds.json**. open
  - maintainer direction: category `silent_close`; implication `active`
  - files: `plugins/platforms/whatsapp/adapter.py`, `tests/gateway/test_whatsapp_connect.py`, `tests/gateway/test_whatsapp_creds_preflight.py`
- **#139191: fix(whatsapp): handle locked session dir on re-pair and reject empty creds in preflight**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `36a47b3fcc`
  - files: `hermes_cli/main_platform_setup.py`, `plugins/platforms/whatsapp/adapter.py`, `tests/gateway/test_whatsapp_connect.py`, `tests/hermes_cli/test_whatsapp_setup_ordering.py`

## Fix status

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