chargelink suite
================

Run named ChargeLink suites that aggregate campaigns and qualification checks.

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

   usage: chargelink suite [-h] {list,run,verify,export} ...

   positional arguments:
     {list,run,verify,export}

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

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

   * - Subcommand
     - Purpose
   * - ``list``
     - List named ChargeLink suites such as focused standards, conformance, interoperability, and release gates.
   * - ``run``
     - Run a named suite and materialize its output bundle.
   * - ``verify``
     - Verify a suite against expected status, gate, and artifact outcomes.
   * - ``export``
     - Export a completed suite as a ZIP or customer bundle.

list
----

List named ChargeLink suites such as focused standards, conformance, interoperability, and release gates.

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

   usage: chargelink suite list [-h] [--output OUTPUT]

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

Production examples
~~~~~~~~~~~~~~~~~~~
**List the current catalog.**

.. code-block:: bash

   chargelink suite list

**Write the catalog to JSON.**

.. code-block:: bash

   chargelink suite list --output 'artifacts/suite/list.json'


run
---

Run a named suite and materialize its output bundle.

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

   usage: chargelink suite run [-h] [--artifact-root ARTIFACT_ROOT]
                               [--output-root OUTPUT_ROOT] [--run-id RUN_ID]
                               [--rerun] [--rerun-failed] [--verify-only]
                               [--output OUTPUT]
                               suite_id

   positional arguments:
     suite_id

   options:
     -h, --help            show this help message and exit
     --artifact-root ARTIFACT_ROOT
     --output-root OUTPUT_ROOT
     --run-id RUN_ID
     --rerun
     --rerun-failed
     --verify-only
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Run the focused ISO 15118-20 suite.**

.. code-block:: bash

   chargelink suite run 'chargelink-iso15118-20' --artifact-root 'artifacts/evcc_campaign_runs' --output-root 'artifacts/suites' --run-id 'chargelink-iso15118-20' --rerun-failed

**Run the production release suite.**

.. code-block:: bash

   chargelink suite run 'chargelink-production-release' --artifact-root 'artifacts/evcc_campaign_runs' --output-root 'artifacts/suites' --run-id 'chargelink-production-release' --rerun-failed


verify
------

Verify a suite against expected status, gate, and artifact outcomes.

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

   usage: chargelink suite verify [-h] [--expect-status EXPECT_STATUS]
                                  [--expect-suite EXPECT_SUITE]
                                  [--expect-qualification-passed EXPECT_QUALIFICATION_PASSED]
                                  [--expect-production-graded EXPECT_PRODUCTION_GRADED]
                                  [--expect-claim-safe EXPECT_CLAIM_SAFE]
                                  [--expect-qualification EXPECT_QUALIFICATION]
                                  [--require-exportable-bundle]
                                  [--require-artifact REQUIRE_ARTIFACT]
                                  [--strict] [--output OUTPUT]
                                  path

   positional arguments:
     path

   options:
     -h, --help            show this help message and exit
     --expect-status EXPECT_STATUS
     --expect-suite EXPECT_SUITE
     --expect-qualification-passed EXPECT_QUALIFICATION_PASSED
     --expect-production-graded EXPECT_PRODUCTION_GRADED
     --expect-claim-safe EXPECT_CLAIM_SAFE
     --expect-qualification EXPECT_QUALIFICATION
     --require-exportable-bundle
     --require-artifact REQUIRE_ARTIFACT
     --strict
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Verify the focused ISO 15118-20 suite.**

.. code-block:: bash

   chargelink suite verify 'artifacts/suites/chargelink-iso15118-20' --expect-suite 'chargelink-iso15118-20' --expect-status 'passed' --expect-qualification-passed 'true' --require-exportable-bundle --strict --output 'artifacts/verification/suite_iso20_verify.json'

**Verify the production release suite in its gated state.**

.. code-block:: bash

   chargelink suite verify 'artifacts/suites/chargelink-production-release' --expect-suite 'chargelink-production-release' --expect-status 'attention_required' --expect-production-graded 'false' --expect-claim-safe 'false' --require-exportable-bundle --strict --output 'artifacts/verification/suite_release_verify.json'


export
------

Export a completed suite as a ZIP or customer bundle.

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

   usage: chargelink suite export [-h] [--format FORMAT] [--output OUTPUT]
                                  [--customer-name CUSTOMER_NAME]
                                  [--release-label RELEASE_LABEL]
                                  path

   positional arguments:
     path

   options:
     -h, --help            show this help message and exit
     --format FORMAT
     --output OUTPUT
     --customer-name CUSTOMER_NAME
     --release-label RELEASE_LABEL

Production examples
~~~~~~~~~~~~~~~~~~~
**Export the focused ISO 15118-20 suite.**

.. code-block:: bash

   chargelink suite export 'artifacts/suites/chargelink-iso15118-20' --format 'zip' --customer-name 'ChargeLink Lab' --release-label 'ISO20' --output 'artifacts/exports/chargelink-iso15118-20.zip'

**Export the release-candidate suite for customer delivery.**

.. code-block:: bash

   chargelink suite export 'artifacts/suites/chargelink-release-candidate' --format 'zip' --customer-name 'ChargeLink Lab' --release-label 'RC1' --output 'artifacts/exports/chargelink-release-candidate.zip'