From 4aa6e7a5afce32fad3217350b02cb30c074244d7 Mon Sep 17 00:00:00 2001 From: Viktor Barzin Date: Thu, 4 Jun 2026 05:33:34 +0000 Subject: [PATCH] chrome-service docs: clarify f1-stream is not a real caller MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit stacks/f1-stream/files/backend/playback_verifier.py and chrome_browser.py describe an in-cluster CDP caller, but the deployed f1-stream image is built from github.com/ViktorBarzin/f1-stream which has neither file — verified by `kubectl exec ls /app/backend/` and grepping for 'CHROME' in the deployed pod. The infra/stacks/f1-stream/files/backend/ tree is a vestigial design that was never wired up to a build pipeline. Calling it out so the next reader doesn't waste time debugging why the migration "didn't take effect" — it took effect on dead code. The hourly snapshot-harvester CronJob is the only live in-cluster caller of the CDP endpoint today. --- docs/architecture/chrome-service.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/architecture/chrome-service.md b/docs/architecture/chrome-service.md index c5c43326..b70fe185 100644 --- a/docs/architecture/chrome-service.md +++ b/docs/architecture/chrome-service.md @@ -6,12 +6,16 @@ Chromium browser exposed over the Chrome DevTools Protocol (CDP). It serves two distinct populations: -1. **In-cluster automation callers** (e.g. `f1-stream`'s - `playback_verifier`, `chrome_browser` extractor) — connect via +1. **In-cluster automation callers** — connect via `chromium.connect_over_cdp("http://chrome-service.chrome-service.svc:9222")` to drive a real browser when upstream anti-bot trips a headless one (`disable-devtool.js` redirect-to-google trap, `navigator.webdriver` - checks, console-clear timing tricks). + checks, console-clear timing tricks). The only currently-active + in-cluster caller is the `chrome-service-snapshot-harvester` CronJob; + the `stacks/f1-stream/files/backend/playback_verifier.py` + + `chrome_browser.py` tree is a vestigial design — the deployed + f1-stream image (built from `github.com/ViktorBarzin/f1-stream`) + does not use this code path. 2. **External dev-box Claude Code sessions** — pull an hourly snapshot of cookies + localStorage from `chrome.viktorbarzin.me/api/snapshot` (bearer-gated) and seed local `@playwright/mcp` instances in