# External Beta Feedback Process

Status: BETA3 support workflow.

## Before Reporting

1. Open BrowserBridge Control Tower.
2. Review **Helper Health** and **Troubleshooting**.
3. Click **Run Doctor**.
4. Click **Fix Now** only when the UI lists a safe remediation.
5. Click **Export Diagnostics**.

The exported support bundle is redacted. It must not include tokens, auth
headers, full URLs, raw DOM, cookies, storage, screenshots, local absolute
paths, or secret-like values.

The bundle includes a BETA3 checklist summary for build identity, helper
health, MCP reachability, extension/native messaging, target-tab lease, policy
mode, audit evidence, and panic state. Treat `unknown` or `stale_or_expired`
checklist values as setup context, not proof of a browser failure.

## Issue Template

Use this shape:

```text
BrowserBridge external beta issue
Build:
Helper:
Runtime:
Panic:
What happened:
Expected:
Steps to reproduce:
Diagnostics attached:
```

## What To Include

- Build commit and release channel.
- Helper Health state.
- Policy mode.
- Target tab lease state.
- BETA3 checklist values from Export Diagnostics.
- Queue summary.
- Audit health.
- Whether **Set Target Tab** and origin grant were completed.

## Feedback Themes

Prioritize feedback about external tester readiness:

- Installation or update friction.
- First-run confusion.
- Helper Health accuracy and remediation usefulness.
- Whether **Set Target Tab** and origin grants are understandable.
- Whether approval cards make live action risk clear.
- Whether limited experimental click/fill/type checks, safe test submit, and
  blocked actions behave as documented on safe test pages.
- Whether exported diagnostics are useful without exposing secrets.
- Whether panic and audit behavior are visible enough to trust.

## What Not To Include

- Session tokens.
- Pairing codes.
- Auth headers.
- Full URLs with paths, query strings, or fragments.
- Passwords, MFA codes, payment details, API keys, or cookies.
- Raw DOM or screenshots.

## Triage Labels

- `install`: download, checksum, extension reload, native host setup.
- `helper-health`: disconnected, stale version, auth failure, token expiry.
- `target-lease`: Set Target Tab, stale lease, tab mismatch.
- `policy`: origin grant, action limit, mode or override issue.
- `action`: navigation, DOM summary, click, fill, type, safe fixture submit.
- `audit-panic`: audit verification or panic enforcement.