docs(oss): record the confirmed WhatsApp browser source and v1 platforms

ADR-0005's open item is closed: the installed Chrome or Edge first, a
downloaded Chrome for Testing only when none is found. The v1 platform
list is confirmed and leaves the pending table. ADR-0005 no longer
mentions install.sh or an npm install on the user's machine.
This commit is contained in:
shumeiko.it
2026-11-04 01:33:11 +01:00
parent 187364dedf
commit eb3b54b1c6
2 changed files with 6 additions and 10 deletions

View File

@@ -1,6 +1,6 @@
# ADR-0005: The WhatsApp channel uses whatsapp-web.js
- Status: Accepted, one open item (browser source)
- Status: Accepted (browser source confirmed by the owner on 2026-11-04)
- Date: 2026-10-14
## Context
@@ -27,12 +27,10 @@ Implemented in P1.7 with `whatsapp-web.js` 1.34.7 (Puppeteer 24).
`<dataDir>/channels/whatsapp-auth` are left untouched because the data directory may still
be shared with the commercial edition. Users scan the QR once more.
- Installing dependencies does not download a browser: the root `.puppeteerrc.cjs` sets
`skipDownload`. This covers `npm install` and `npm ci` in this repository (development,
`install.sh`, Tauri staging). It does not cover `npx @waggle-ai/waggle`: there npm runs
Puppeteer's install script with no config in reach, and it downloads Chrome unless
`PUPPETEER_SKIP_DOWNLOAD=1` is set.
- Open item, implemented as proposed and still awaiting the owner: the browser source. The
order is `CHROME_PATH` or `PUPPETEER_EXECUTABLE_PATH`, an installed Chrome, Edge or Chromium
`skipDownload`. This covers `npm install` and `npm ci` in this repository (development and
the release staging). The server installer runs no npm install on the user's machine: it
unpacks the staged payload (ADR-0009).
- Browser source, confirmed by the owner on 2026-11-04. The order is `CHROME_PATH` or `PUPPETEER_EXECUTABLE_PATH`, an installed Chrome, Edge or Chromium
in the standard Windows, macOS and Linux locations, then a browser downloaded earlier.
Only when none is found does starting WhatsApp download the current stable Chrome for
Testing (about 170 MB) into `<dataDir>/browsers` with `@puppeteer/browsers`. Settings

View File

@@ -10,7 +10,7 @@ decision, add a new record that supersedes the old one.
| [0002](0002-memory-contract-local-mem0.md) | Memory goes through a contract backed by local mem0 | Accepted |
| [0003](0003-team-mode-postponed.md) | Team mode stays in the repository but is not built or shipped | Accepted |
| [0004](0004-cost-tracking-in-self-learning-out.md) | Cost tracking is open; self-learning and `optimizer` are excluded | Accepted |
| [0005](0005-whatsapp-web-js.md) | The WhatsApp channel uses `whatsapp-web.js` | Accepted, one open item |
| [0005](0005-whatsapp-web-js.md) | The WhatsApp channel uses `whatsapp-web.js` | Accepted |
| [0006](0006-opt-in-analytics.md) | Analytics are opt-in | Accepted, one open item |
| [0007](0007-memory-contract.md) | The memory contract and how it maps onto mem0 | Accepted |
| [0008](0008-native-modules.md) | Native modules ship with a pinned Node runtime | Accepted |
@@ -27,8 +27,6 @@ work packages wait for the answer.
| Licensing review (includes code copied from the Apache-2.0 `hive-mind-core` into MIT `core`, ADR-0007, and the third-party descriptions in the marketplace catalog, ADR-0010) | Technical license checks continue | P2.3, P2.6 |
| Product name and system identifiers | Temporary names | P1.3d, P2.6 |
| Location of the public repository | `release.yml` is ready but has not run; the installer has no default download location (`--from`) | P2.6, P2.7 |
| 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 |