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 # 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 - Date: 2026-10-14
## Context ## 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 `<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. be shared with the commercial edition. Users scan the QR once more.
- Installing dependencies does not download a browser: the root `.puppeteerrc.cjs` sets - Installing dependencies does not download a browser: the root `.puppeteerrc.cjs` sets
`skipDownload`. This covers `npm install` and `npm ci` in this repository (development, `skipDownload`. This covers `npm install` and `npm ci` in this repository (development and
`install.sh`, Tauri staging). It does not cover `npx @waggle-ai/waggle`: there npm runs the release staging). The server installer runs no npm install on the user's machine: it
Puppeteer's install script with no config in reach, and it downloads Chrome unless unpacks the staged payload (ADR-0009).
`PUPPETEER_SKIP_DOWNLOAD=1` is set. - 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
- 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
in the standard Windows, macOS and Linux locations, then a browser downloaded earlier. 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 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 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 | | [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 | | [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 | | [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 | | [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 | | [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 | | [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 | | 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 | | 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 | | 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 | | Installer signing | First release may ship unsigned with launch instructions | P2.5 |
| Separate data directory from the commercial edition | Not separated yet | P1.3c | | 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 | | PostHog project for the community edition | See ADR-0006 | P1.3a |