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