chargelink requirements
=======================

Map campaign content to requirements and link imported requirement IDs to runs.

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

   usage: chargelink requirements [-h] {map,import,link} ...

   positional arguments:
     {map,import,link}

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

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

   * - Subcommand
     - Purpose
   * - ``map``
     - Map a campaign document to requirement references.
   * - ``import``
     - Import requirement IDs into the runtime registry.
   * - ``link``
     - Link a requirement ID to a run.

map
---

Map a campaign document to requirement references.

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

   usage: chargelink requirements map [-h] campaign

   positional arguments:
     campaign

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate a map from a production input.**

.. code-block:: bash

   chargelink requirements map 'campaigns/interoperability/iso15118_20/ac/cl_int_iso20_ac_negative_realistic.json'

**Generate a second map.**

.. code-block:: bash

   chargelink requirements map 'campaigns/conformance/iso15118_2/dc_pnc/cl_conf_iso2_dc_pnc_seed.json'


import
------

Import requirement IDs into the runtime registry.

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

   usage: chargelink requirements import [-h] [--runtime-root RUNTIME_ROOT] file

   positional arguments:
     file

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Import a requirements file.**

.. code-block:: bash

   chargelink requirements import 'requirements.json' --runtime-root '.tmp/runtime'

**Import a second file.**

.. code-block:: bash

   chargelink requirements import 'requirements_extra.json' --runtime-root '.tmp/runtime'


link
----

Link a requirement ID to a run.

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

   usage: chargelink requirements link [-h] [--runtime-root RUNTIME_ROOT]
                                       requirement_id run_id

   positional arguments:
     requirement_id
     run_id

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Link a requirement to a run.**

.. code-block:: bash

   chargelink requirements link 'REQ-001' 'run_1' --runtime-root '.tmp/runtime'

**Link a second requirement to the same run.**

.. code-block:: bash

   chargelink requirements link 'REQ-ISO20-DC-001' 'run_1' --runtime-root '.tmp/runtime'