AutoMax
Reference

Attachment and file naming

The names AutoMax gives to attachments and files so every tool can find them.

Attachments

NameContent
automax/shot/scenario/start, automax/shot/scenario/end, automax/shot/scenario/failurescenario-level screenshots
automax/shot/step/NN/before, automax/shot/step/NN/afterstep screenshots; NN is the zero-based, two-digit step index in the pickle (background steps included, hooks excluded)
automax/visual/NN/<name>visual baseline comparison
automax/api/NN/n/request, automax/api/NN/n/responseAPI call n in step NN
automax/heal/NN/nheal event
automax/perf/NN, automax/a11y/NNmetrics and axe results
automax/metathe scenario meta document
automax/cleanup-errorscleanup failures

Playwright's own trace, screenshot, video and <name>-expected.png/-actual.png/-diff.png are recognised as well. Names never start with _.

Run directory

.automax/runs/<runId>/
  run.json  summary.json  run.log
  messages.ndjson | messages.shard-N.ndjson
  pw-results.json          # recorded layer
  playwright-report/  dashboard/  pw-output/  junit.xml
  <slug>/<fingerprint>/r<retry>/
    meta.json
    scenario-start.png  scenario-end.png  failure.png
    NN-before.png  NN-after.png
    api/NN-n-request.json  api/NN-n-response.json
    perf/NN.json  a11y/NN.json
    heal.jsonl

Identifiers

  • runId: UUID v7, sortable by time; --run-id overrides (CI uses gh-<run id>).
  • Fingerprint: sha256(project, featureUri, scenarioName, exampleIndex, layer) truncated to 16 hex characters.
  • Playwright project: <slug>--<layer>--<browser> or <slug>--api.

On this page