chargelink protocol
===================

Decode, validate, inspect, and sequence protocol artifacts.

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

   usage: chargelink protocol [-h] {decode,validate,inspect,timeline} ...

   positional arguments:
     {decode,validate,inspect,timeline}

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

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

   * - Subcommand
     - Purpose
   * - ``decode``
     - Decode a message envelope or stored payload.
   * - ``validate``
     - Validate a protocol run or case directory.
   * - ``inspect``
     - Inspect protocol-level artifacts.
   * - ``timeline``
     - Render a timeline view for protocol messages.

decode
------

Decode a message envelope or stored payload.

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

   usage: chargelink protocol decode [-h] [--codec CODEC] input

   positional arguments:
     input

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Decode a saved message envelope.**

.. code-block:: bash

   chargelink protocol decode 'examples/session_setup_req.json' --codec 'deterministic'

**Decode the same envelope through the default codec.**

.. code-block:: bash

   chargelink protocol decode 'examples/session_setup_req.json'


validate
--------

Validate a protocol run or case directory.

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

   usage: chargelink protocol validate [-h] [--codec CODEC] [--protocol PROTOCOL]
                                       path

   positional arguments:
     path

   options:
     -h, --help           show this help message and exit
     --codec CODEC
     --protocol PROTOCOL

Production examples
~~~~~~~~~~~~~~~~~~~
**Validate an interoperability case.**

.. code-block:: bash

   chargelink protocol validate 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic/case_1'

**Validate a conformance case.**

.. code-block:: bash

   chargelink protocol validate 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed/case_1'


inspect
-------

Inspect protocol-level artifacts.

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

   usage: chargelink protocol inspect [-h] [--codec CODEC] [--output OUTPUT]
                                      input

   positional arguments:
     input

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Inspect a representative target.**

.. code-block:: bash

   chargelink protocol inspect 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic/case_1'

**Inspect a second target.**

.. code-block:: bash

   chargelink protocol inspect 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed/case_1'


timeline
--------

Render a timeline view for protocol messages.

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

   usage: chargelink protocol timeline [-h] [--limit LIMIT] path

   positional arguments:
     path

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Render a short timeline for the latest interoperability case.**

.. code-block:: bash

   chargelink protocol timeline 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic/case_1' --limit 20

**Render a short timeline for the conformance case.**

.. code-block:: bash

   chargelink protocol timeline 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed/case_1' --limit 20