Files
waggle-os/docs/oss/adr
shumeiko.it 625545aa0f feat(server): run the WhatsApp channel on whatsapp-web.js (P1.7)
Baileys depends on libsignal (GPL-3.0), which the sidecar bundled. The
WhatsApp adapter now drives WhatsApp Web through whatsapp-web.js and
keeps its public shape: start, stop, status with the pairing QR, send
and inbound text. LocalAuth stores the session as a browser profile in
<dataDir>/channels/whatsapp; the old Baileys state is left untouched.

The browser comes from whatsapp-browser.ts: CHROME_PATH or
PUPPETEER_EXECUTABLE_PATH, then an installed Chrome, Edge or Chromium
(Windows, macOS, Linux), then a Chrome for Testing build downloaded on
the first start into <dataDir>/browsers, with progress in the status.
The root .puppeteerrc.cjs stops npm install from downloading a browser.
The sidecar build keeps whatsapp-web.js external: bundled, it fails on
__dirname and would inline LGPL node-webpmux. Text only, so ffmpeg is
never needed.

New dependencies, pinned: whatsapp-web.js 1.34.7 (Apache-2.0) and
@puppeteer/browsers 2.13.0 (Apache-2.0). Transitive: puppeteer,
puppeteer-core, chromium-bidi, webdriver-bidi-protocol (Apache-2.0),
devtools-protocol (BSD-3-Clause), extract-zip (BSD-2-Clause),
fluent-ffmpeg and the rest (MIT or ISC), and node-webpmux
(LGPL-3.0-or-later, shipped as a separate package; needs the license
review). Removed: @whiskeysockets/baileys and libsignal.

UF-020 is now Fixed; ADR-0005 records the consequences.
2026-10-24 11:56:38 +02:00
..

Decision records: Waggle community edition

Each record captures one decision that shapes the community edition: the context, what was decided and what follows from it. Records are numbered and never renumbered. To change a decision, add a new record that supersedes the old one.

ADR Decision Status
0001 The community edition has no monetization Accepted
0002 Memory goes through a contract backed by local mem0 Accepted
0003 Team mode stays in the repository but is not built or shipped Accepted
0004 Cost tracking is open; self-learning and optimizer are excluded Accepted
0005 The WhatsApp channel uses whatsapp-web.js Accepted, one open item
0006 Analytics are opt-in Accepted, one open item
0007 The memory contract and how it maps onto mem0 Accepted

Pending decisions

These are open with the project owner. Work continues on temporary choices and the affected work packages wait for the answer.

Topic Temporary choice Blocks
Licensing review (includes code copied from the Apache-2.0 hive-mind-core into MIT core, ADR-0007) Technical license checks continue P2.3, P2.6
Product name and system identifiers Temporary names P1.3d, P2.6
Location of the public repository Manual builds on each OS P1.3d, P2.6
Supported platforms for v1 Windows x64, macOS arm64 and x64, Linux x64 (glibc) P1.3b, P1.3d
Installer signing First release may ship unsigned with launch instructions P2.5
Separate data directory from the commercial edition Not separated yet P1.3c
Browser source for WhatsApp See ADR-0005 P1.7
PostHog project for the community edition See ADR-0006 P1.3a