momentic run. Use upload after
running with --upload-results disabled, merge to combine sharded runs,
view to inspect runs locally without uploading, and check to gate CI on
clean results.
upload
Upload local test results to the Momentic dashboard.
Arguments
Folder containing results from
momentic run or momentic results merge.
Defaults to test-results, which matches the default --output-dir of
momentic run; pass a different folder when your results are elsewhere.Options
merge
Merge results from multiple sharded runs into a single folder before uploading.
Arguments
Parent folder of the results to merge. For example, if shards wrote into
test-results/shard-1 and test-results/shard-2, pass test-results.Options
Include run groups that produced no runs, such as shards where AI test
selection chose zero tests. Their metadata, including the
selection plans, is merged instead of skipped, so the uploaded run group can
explain why nothing ran. A results path that is missing or contains no run
groups becomes a no-op instead of an error. Recommended whenever AI test
selection is enabled;
upload and check accept the same flag so the whole
chain can run unconditionally in CI.view
Launch the local run viewer to inspect results without uploading.
Arguments
Run ID to open, matching a zip file in the
runs/ subfolder. For example, for
runs/eed92602-7355-43dc-8d79-1c43029bec26.zip, pass
eed92602-7355-43dc-8d79-1c43029bec26. When omitted, the viewer opens to the
run group table.Options
check
Exit non-zero if any non-quarantined run in a results archive did not pass
cleanly. Use it as a CI gate after merge to require clean results.
1) when it is not
quarantined and any of the following is true:
- its final status is
FAILEDorCANCELLED, - it only passed after an in-run failure recovery, or
- it carries a failure classification
(any category, including ones routed to
heal/warn).
0 only when every
non-quarantined run passed outright with no recovery and no classification.
Pass --allow-recovered to treat runs that passed via in-run failure recovery
as clean. They no longer fail the check, while FAILED/CANCELLED runs and
failure classifications still exit 1.
Arguments
Path to a folder containing a
runs/ subfolder, such as the --output-dir of
a preceding momentic results merge.Options
Exit successfully when the results path does not exist. A results archive with
zero runs is already accepted without this flag.
Suppress progress output and print the check report as JSON. The report
includes per-run detail for each not-clean run (
uncleanRuns) and a summary
with descriptive per-category counts: total, clean, quarantined,
failed, cancelled, recovered, and classified. These counts overlap (a
run can be both recovered and classified), so they do not sum to total.