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
truly 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, so you can usually omit this argument.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
Directory to write the merged results to. The folder is overwritten if it
exists.
view
Launch the local run viewer to inspect results without uploading.
Arguments
Path to a folder containing a
runs/ subfolder. Defaults to test-results.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
Port for the local run viewer server. Defaults to
58889.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 truly green 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, typically the --output-dir
of a preceding momentic results merge.Options
Treat runs that passed via in-run failure recovery as clean (exit
0).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.