From 532d762678e0eda7ac08fcc6a361069114f12d79 Mon Sep 17 00:00:00 2001 From: Christophe Besson Date: Sun, 13 Sep 2026 21:55:08 +0200 Subject: docs: what this week's review left open, and a harness that lies MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit §15.3 gains the items the review found and did not close, each as what it is rather than as a plan: the packaged install that has never been installed, QUIC serving content outside every cap it does not implement, a relay registry nothing calls, an unmetered third-party search, disk I/O on the node's event loop, unbounded node announcements, and a migration chain exercised on a database it does not ship on. They are in the design rather than in a tracker because each is a sentence about what the system currently is, and §15.3 is where the document already keeps those. The seven that were closed this week are in §13.5b as AV20–AV25 and in the sections they belong to. CLAUDE.md gains the Firefox harness, which is the other kind of entry: eleven errors at setup that look exactly like a regression, are not, and cost a full diagnosis to place. `HOME` isolates the profile and not snap's single instance, so any running Firefox blocks the headless probe, `--no-remote` and `--new-instance` do not help, and a failed run leaves a process that blocks the next. The chrome half covers the same geometry meanwhile. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01UMxEQadpzPkYLFf5CYKhpW --- CLAUDE.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'CLAUDE.md') diff --git a/CLAUDE.md b/CLAUDE.md index 528ee0e..284841a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -144,6 +144,18 @@ These are about working on the tree rather than about the design: - **The SPA served in production may be older than this tree.** Check the served `/a//` against `meshbay_hub.api.webapp.ASSET_V` before concluding a fix is missing. `site/` and the Caddy config have never been deployed +- **`test_sticky_header.py[firefox]` needs no Firefox instance on the machine, + and says nothing about the code when one is there.** The harness launches + `firefox --headless --screenshot` with `HOME` pointed at a throwaway + directory, which isolates the *profile* and not snap's single instance: with + any Firefox already up it prints "Firefox is already running, but is not + responding", never loads the page, and the fixture times out at 60 s — eleven + errors at setup that look like a regression and are not. Neither + `--no-remote` nor `--new-instance` changes it; a failed run also appears to + leave a process behind, which blocks the next one. Before reading anything + into these: `ps -eo pid,etimes,args | grep firefox`, and re-run against a + stashed tree. The `[chrome]` half of the same file covers the same geometry + and is the one to trust meanwhile - **One UI source.** `packages/meshbay-hub/src/meshbay_hub/static/` is the interface, for the web and the app alike; `packages/meshbay-client/scripts/ sync-ui.js` copies it (`npm run sync-ui`) and CI fails if the copy drifts — -- cgit v1.2.3