Files

gsxdsm d8f0b1a268 Restore PostgreSQL integration parity (#2089 )

## Summary

- add asynchronous PostgreSQL parity to research commands and engine
execution paths
- persist Roadmap, Compound Engineering sessions, and WhatsApp state in
PostgreSQL
- harden cancellation, concurrency, reconnect, replay-claim, and
detached-promise behavior
- bundle the PostgreSQL-backed integration implementations in the
published CLI

This is PR 2 of 2 and is intentionally stacked on #2088. It contains 44
changed files; merge #2088 first, then retarget this PR to `main` if
GitHub does not do so automatically.

## Verification

- `pnpm check:changesets --strict`
- `pnpm lint`
- `pnpm test:gate`: 463 tests passed
- Compound Engineering plugin: 299 tests passed
- Roadmap plugin: 144 tests passed
- WhatsApp plugin: 27 tests passed
- research CLI: 18 tests passed
- `pnpm verify:fast`: all scoped typechecks, builds, CLI build, and boot
smoke passed

## Post-Deploy Monitoring & Validation

- deploy only after #2088 and verify schema migration `0002` is present
- monitor research cancellation, automation claims, agent execution,
plugin schema initialization, and unhandled rejections
- validate Roadmap ownership, Compound Engineering session recovery, and
WhatsApp reconnect/replay deduplication
- compare per-project plugin and workflow counts after cutover
- restore the pre-deploy backup for data rollback; avoid an in-place
schema downgrade

2026-07-14 08:17:36 -07:00

src

Restore PostgreSQL integration parity (#2089 )

2026-07-14 08:17:36 -07:00

CHANGELOG.md

chore(release): v0.60.0

2026-07-13 10:32:12 -07:00

manifest.json

feat(FN-3713): migrate WhatsApp plugin to Baileys pairing flow

2026-05-07 18:26:14 -07:00

package.json

Restore PostgreSQL integration parity (#2089 )

2026-07-14 08:17:36 -07:00

README.md

feat(FN-3795): add WhatsApp dedupe retention pruning and reports plugin sca

2026-05-09 10:31:04 -07:00

tsconfig.json

Restore PostgreSQL integration parity (#2089 )

2026-07-14 08:17:36 -07:00

vitest.config.ts

FN-6042: raise dependency security floors

2026-06-08 15:19:27 -07:00

README.md

WhatsApp Chat Plugin

WhatsApp Web (Baileys) bridge for Fusion. It pairs with your phone (QR or pairing code), keeps a background connection alive, forwards inbound direct text messages to a Fusion AI session, and sends the assistant reply back to WhatsApp.

No Meta Cloud app, webhook URL, verify token, or Graph API credentials are required.

Setup

Enable/install the plugin in Plugin Manager.
Configure allowedSenders (empty means nobody is allowed).
Choose pairingMode:
- qr (default): fetch QR from /api/plugins/fusion-plugin-whatsapp-chat/qr and scan in WhatsApp.
- code: set pairingPhoneNumber (E.164 digits without +) and request code via /pair-code.
Confirm /status reports connected.

Settings

pairingMode: qr or code.
pairingPhoneNumber: E.164 digits without + (used for code mode).
allowedSenders: allowed WhatsApp JIDs or E.164 digits.
agentSystemPrompt: system prompt for replies.
historyTurnLimit: persisted turn window (default 40).
dedupeRetentionDays: replay-protection retention window for inbound message IDs (default 7 days). Rows older than this are pruned lazily whenever a new inbound message is processed.

Routes

GET /api/plugins/fusion-plugin-whatsapp-chat/status
GET /api/plugins/fusion-plugin-whatsapp-chat/qr
POST /api/plugins/fusion-plugin-whatsapp-chat/pair-code
POST /api/plugins/fusion-plugin-whatsapp-chat/logout

Storage and lifecycle

Starts socket on onLoad, stops on onUnload.
Persists transcript and dedupe state in:
- whatsapp_chat_sessions
- whatsapp_chat_dedupe
Persists Baileys auth state in:
- whatsapp_auth_creds
- whatsapp_auth_keys
After restart, plugin reconnects automatically when auth is valid.

Troubleshooting

Stuck awaiting-qr: fetch a fresh QR and scan promptly.
loggedOut: call /logout (or wait for clear) and re-pair.
Pair code not generated: ensure pairingPhoneNumber is E.164 digits without +.
No replies: check allowedSenders; empty list blocks all inbound messages by design.

Compliance warning

Baileys is an unofficial WhatsApp Web protocol client. Use may violate WhatsApp Terms of Service. This plugin is intended for self-hosted, single-user use at your own risk.