You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
These came out of the codebase audit and product thinking. None are committed work. Each needs an entry in docs/roadmap/architecture-decisions.md before it becomes a scheduled issue — that is the bar for anything that changes the agent-facing contract.
Comment on this issue to argue for one; when a decision is recorded, it graduates to its own issue and this box gets checked.
Ideas
G1 — headless doctor — one command validating runtime, ffmpeg, socket dir, permissions, and printing fix hints (pieces exist across install-linux.sh, runtime, sandbox doctor).
G2 — Structured host logging — today host stderr goes to /dev/null unless HEADLESS_HOST_LOG is set (HeadlessCLI/main.swift); startup failures are near-invisible. Default to a rotating log in the runtime dir.
G4 — Session metadata — session list returning current URL/title/age; cheap, big agent QoL.
G5 — wait --network-idle — Chromium engine has the events; declared capability on WKWebView.
G6 — Element screenshot on Linux --by-region @rN — region-scoped series capture, pairs naturally with the pruning ladder.
G7 — Trace export — capture-info already returns an action trace; report create bundles it; a --format junit/markdown export would slot into CI comments.
G8 — Multi-host coexistence — one socket per user today (/tmp/headless-<uid>/host.sock); named hosts (--host qa) would allow parallel isolated instances; today requires manual HEADLESS_SOCKET.
G9 — Cookie import for authenticated QA — deliberately absent today; needs a security design (gated like sensitive diagnostics) before any work.
An arbitrary-JavaScript verb, a TCP listener, and page-download support are permanent non-goals — see docs/roadmap/what-is-excellent.md. Proposals for those will be closed.
These came out of the codebase audit and product thinking. None are committed work. Each needs an entry in
docs/roadmap/architecture-decisions.mdbefore it becomes a scheduled issue — that is the bar for anything that changes the agent-facing contract.Comment on this issue to argue for one; when a decision is recorded, it graduates to its own issue and this box gets checked.
Ideas
headless doctor— one command validating runtime, ffmpeg, socket dir, permissions, and printing fix hints (pieces exist acrossinstall-linux.sh,runtime, sandboxdoctor)./dev/nullunlessHEADLESS_HOST_LOGis set (HeadlessCLI/main.swift); startup failures are near-invisible. Default to a rotating log in the runtime dir.console list,network list,artifacts list.session listreturning current URL/title/age; cheap, big agent QoL.wait --network-idle— Chromium engine has the events; declared capability on WKWebView.--by-region @rN— region-scoped series capture, pairs naturally with the pruning ladder.capture-infoalready returns an action trace;report createbundles it; a--format junit/markdown export would slot into CI comments./tmp/headless-<uid>/host.sock); named hosts (--host qa) would allow parallel isolated instances; today requires manualHEADLESS_SOCKET.Not on this list, deliberately
An arbitrary-JavaScript verb, a TCP listener, and page-download support are permanent non-goals — see
docs/roadmap/what-is-excellent.md. Proposals for those will be closed.