mirror of https://github.com/bitsocialnet/5chan.git synced 2026-08-03 07:41:04 +02:00

Files

T

Tommaso Casaburi 1a33f7dc88 chore(agents): add a machine-wide Playwright browser resource budget

Playwright disables normal background throttling, so a hidden 5chan page keeps
doing P2P and rendering work after a check finishes. Agents verifying in
parallel across worktrees stacked whole browser engines on one machine.

Add scripts/pw-session.sh, a wrapper that permits one active Playwright browser
at a time and records who holds it:

- The lock is machine-wide, not per-repository, because the contended resource
  is RAM and CPU. Every worktree and checkout shares one slot.
- Acquisition is an atomic mkdir. Stale locks clear themselves: `open` reclaims
  any slot whose recorded browser is no longer `status: open` in
  `playwright-cli list --all`, so an interrupted workflow cannot strand the
  budget. When that list cannot be read the lock is left alone, so a broken CLI
  never silently disables the budget.
- `open` exits 75 when the slot is busy; `--wait[=SECONDS]` blocks instead.
- `close` always stops the browser, even when the lock was already lost, and
  never releases a slot held by a different session.
- `status` reports the holder and whether its browser is still alive.

Agent policy now runs browser engines and profiler batches sequentially, uses
Chrome/Blink during iteration and the full engine matrix only for final
verification, and never uses `close-all` or `kill-all` while other agents may
own sessions.

Covered by scripts/pw-session.test.js.

2026-08-01 19:21:01 +02:00

1.7 KiB

Raw Blame History

scripts/AGENTS.md

These rules apply to scripts/**. Follow the repo-root AGENTS.md first, then use this file for automation and workflow helpers.

Keep scripts non-interactive and idempotent. Print the command, URL, branch, or path being acted on so failures are diagnosable.
Use repo-relative paths and environment variables instead of user-specific absolute paths.
For dev-server helpers, default to https://5chan.localhost, but allow a branch-scoped *.5chan.localhost route when the launcher is avoiding a Portless name collision. Start the Portless HTTPS proxy on port 443 before registering routes so legacy ~/.portless state on port 1355 is not reused. Respect the existing PORTLESS=0 fallback instead of hard-coding alternate ports. For USB Android preview, scripts/start-android-usb.mjs mirrors bitsocial-web: adb reverse plus Vite on 127.0.0.1, then am start VIEW to open the default browser when the port is listening (disable with ANDROID_USB_OPEN_BROWSER=0).
Keep shell helpers thin. When logic becomes stateful or cross-platform, prefer a Node script.
scripts/pw-session.sh owns the machine-wide Playwright resource lock shared by every worktree and checkout, so its default lock path must stay repository-independent. Keep acquisition atomic, treat playwright-cli list --all as the only liveness oracle and leave the lock alone when it cannot be read, require exact-owner release, and close the named browser before normal release; never broaden cleanup to unrelated sessions.
Git and worktree helpers must validate input and default to safe operations.
If a helper deletes local branches automatically, document the exact eligibility checks and keep the behavior conservative.

1.7 KiB Raw Blame History

scripts/AGENTS.md

1.7 KiB

Raw Blame History