chargelink scenario
===================

Validate and execute single JSON scenarios.

Reference syntax
----------------
.. code-block:: text

   usage: chargelink scenario [-h] {run,validate,dry-run} ...

   positional arguments:
     {run,validate,dry-run}

   options:
     -h, --help            show this help message and exit

Subcommands
-----------
.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Subcommand
     - Purpose
   * - ``run``
     - Execute one scenario file and write artifacts for the resulting run.
   * - ``validate``
     - Validate the schema and content of a scenario JSON file.
   * - ``dry-run``
     - Resolve a scenario without running the session, useful for authoring and review.

run
---

Execute one scenario file and write artifacts for the resulting run.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink scenario run [-h] [--artifact-root ARTIFACT_ROOT] scenario

   positional arguments:
     scenario

   options:
     -h, --help            show this help message and exit
     --artifact-root ARTIFACT_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Execute the sample scenario and store its artifacts.**

.. code-block:: bash

   chargelink scenario run 'scenarios/sample_scenario.json' --artifact-root 'artifacts/scenario_runs'

**Run the same scenario as part of a pre-release acceptance pass.**

.. code-block:: bash

   chargelink scenario run 'scenarios/sample_scenario.json' --artifact-root 'artifacts/release_smoke/scenario_runs'


validate
--------

Validate the schema and content of a scenario JSON file.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink scenario validate [-h] scenario

   positional arguments:
     scenario

   options:
     -h, --help  show this help message and exit

Production examples
~~~~~~~~~~~~~~~~~~~
**Validate one production input.**

.. code-block:: bash

   chargelink scenario validate 'scenarios/sample_scenario.json'

**Validate a second representative input.**

.. code-block:: bash

   chargelink scenario validate 'scenarios/sample_scenario.json'


dry-run
-------

Resolve a scenario without running the session, useful for authoring and review.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink scenario dry-run [-h] [--artifact-root ARTIFACT_ROOT]
                                      scenario

   positional arguments:
     scenario

   options:
     -h, --help            show this help message and exit
     --artifact-root ARTIFACT_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Resolve the sample scenario without running it.**

.. code-block:: bash

   chargelink scenario dry-run 'scenarios/sample_scenario.json'

**Resolve the sample scenario for release review.**

.. code-block:: bash

   chargelink scenario dry-run 'scenarios/sample_scenario.json' --artifact-root 'artifacts/scenario_preview'