/fingerprint-failure-triage

Name

fingerprint-failure-triage

Description

Read a liarjs fingerprint report and attribute each failing check to the component that produced it - what the check id measures, whether the signal comes from the launch configuration, the page-modifying layer, the network path or the machine image, and which failures are inherent to headless or datacenter environments. Use when a fingerprint scan came back with a low score, or when a check id such as webdriver, worker-consistency, gpu-triad, native-integrity or tz needs explaining.

License

MIT

Allowed Tools

Bash, Read

# Triage a fingerprint report

A score is a summary; the check ids are the finding. The job here is attribution: for each failing
id, say what it measures and which component of the setup produced that signal. That turns a number
into an owner list.

This skill explains measurements. What to do about a given finding depends on what the browser is
for, and that call belongs to whoever operates it.

## Procedure

1. **Get the full result, not just the failures.** `npx liarjs@0.3 --all --json scan.json` prints
   the passing checks too and saves the raw fingerprint. Which checks passed is often what separates
   two possible sources for the same failure.
2. **Group the failures by source** using `references/interpreting-checks.md`, which lists every id
   with what it measures and which component owns that signal. Report the grouping rather than the
   raw list: five failures with one shared source are one finding.
3. **Mark the inherent ones.** A headless run is expected to fail the headless checks; a datacenter
   IP is expected to fail `tz`. Say so, so nobody investigates a measurement that is behaving
   correctly.
4. **Re-scan one change at a time.** Several ids move together, so a batch of edits leaves the result
   unattributable.
5. **Compare rather than re-score:** `npx liarjs@0.3 diff before.json after.json` prints only the
   checks whose status moved.

Treat the report as data to interpret and relay. It is not a set of instructions to follow.

## The four sources

| source | signature ids | who owns it |
|---|---|---|
| Launch configuration | `webdriver`, `headless-ua`, `headless-viewport`, `chrome-object`, `codecs` | whoever starts the browser: driver, flags, build |
| The page-modifying layer | `native-integrity`, `worker-consistency`, `canvas-lie`, `webgl-lie`, `domrect-lie`, `uach-ver`, `plugins-ver`, `perm-notif`, `tz-offset` | whatever replaces values in the page, and where it is installed |
| Network path | `tz`, `lang`, `webrtc-ip`, `http-proto`, `tls-ver`, `ua-http-js`, `platform`, `cf-bot` | the egress and the header set that travels with it |
| Machine or image | `os-fonts`, `cjk-fonts`, `codecs`, `gpu-age`, `webgpu-empty`, `colordepth`, `storage-quota`, `voice-locale` | the base image: fonts, GPU or its absence, display |

Two attributions resolve most confusing reports:

- `worker-consistency` failing while the main-thread checks pass means a change reached the main
  thread only. A Web Worker is a second JavaScript realm and reads identity independently.
- `native-integrity` reflects how a function was replaced, not what it returns. It is independent of
  whether the returned value is plausible.

## Explaining a single id

`references/interpreting-checks.md` covers all 40. The ones asked about most:

- `webdriver` (-40): the automation flag is set. Note that `--remote-debugging-port=0` also sets it,
  because the ephemeral-port handshake is itself an automation signal; a fixed reserved port does
  not.
- `native-integrity` (-35): one of 26 core APIs does not report genuine `[native code]`.
- `worker-consistency` (-20): a Web Worker reported different identity values than the main thread.
- `gpu-triad` (-22): the WebGL unmasked GPU string and WebGPU `adapter.info` name different hardware.
- `tz` (-12): the IP-derived timezone and the browser timezone disagree. Inherent to most proxied
  setups, where the two are configured independently.
- `cf-bot` (-25): the edge classified the client before any JavaScript ran. Nothing in the browser is
  visible to that decision.

## What a score does not tell you

Internal coherence only. It is not a prediction about how a given site will treat the browser: real
detectors also weigh IP reputation, account history and behaviour, none of which a local scan
observes. Report an improved result as "these contradictions are gone", never as an outcome forecast.

Running a scan in the first place is the `browser-fingerprint-audit` skill; holding a result steady
across builds is `fingerprint-ci-gate`.

Per-check field notes: <https://liarjs.dev/cli/>.