CLI

dialogassert run

Runs behavioural QA scenarios, generated suites or business-authored journeys.

uv run dialogassert run [options]

-c, --config PATH              Config file. Default: dialogassert.yaml
--agent VALUE                  Override agent from config
--contract PATH                Override contract from config
--scenarios PATH               Override scenarios from config
--output PATH                  Override JSON report output
--html PATH                    Override HTML report output
--semantic-mode MODE           off, heuristic, or llm
--workflow-id ID               Run one workflow only
--repeats N                    Override evaluation.repeat
--business PATH                Business journey file with turns and acceptance
--inputs PATH                  Runtime inputs for the business journey
--generated-dir PATH           Hidden generated artifacts directory. Default: .dialogassert/generated
--no-fail-on-findings          Return exit code 0 even when findings exist

dialogassert generate

--source PATH                  Required business source file
--inputs PATH                  Optional runtime inputs file
--out-dir PATH                 Output directory. Default: generated

dialogassert author

Experimental plain-text authoring command.

--text TEXT                    Required business text
--id ID                        Journey id
--customer-id ID               Default: cust_001
--source-out PATH              Where to write the business source
--out-dir PATH                 Generated artifact directory. Default: generated
--base-config PATH             Base config. Default: dialogassert.openai.generated.yaml
--config-out PATH              Where to write generated config
--run                          Run after generating
--semantic-mode MODE           off, heuristic, or llm
--repeats N                    Override repeat count
--no-fail-on-findings          Return exit code 0 even when findings exist

This flow is experimental. The primary MVP contract is still explicit turns plus acceptance.

dialogassert author-ui

Starts the local business authoring web app.

--base-config PATH             Base config for generated suites
--out-dir PATH                 Generated artifact directory. Default: generated
--source-dir PATH              Source directory. Default: authoring/generated
--host HOST                    Default: 127.0.0.1
--port PORT                    Default: 15570

dialogassert replay

-c, --config PATH              Config file. Default: dialogassert.yaml
--from-report PATH             Required saved report JSON
--workflow-id ID               Replay one workflow only
--output PATH                  Override JSON report output
--html PATH                    Override HTML report output
--semantic-mode MODE           off, heuristic, or llm
--no-fail-on-findings          Return exit code 0 even when findings exist

dialogassert view

--report PATH                  Report JSON. Default: reports/latest.json
--host HOST                    Default: 127.0.0.1
--port PORT                    Default: 15560