Docs/CLI

Migrating to v2

v2 reorganizes a few config fields and tightens defaults. This page lists the breaking changes and the mechanical rewrites needed to move a v1 project over.

Breaking changes

Config file renamed: assrtrc.yaml → assrt.config.yaml.
Default timeout tightened from 5 minutes to 2 minutes.
retries defaults to 0. Opt in explicitly on flaky tests.
Secrets no longer fall back to env.*. Use secret.* for masked values.

Automatic migration

bash

npx @assrt/cli migrate v2

The migration tool rewrites config files, renames referenced fields in tests, and prints a report of anything that needs manual attention.

Run the migration on a branch and review the diff before merging. It is safe and reversible, but seeing every change in a PR is a good checkpoint.