chargelink capture
==================

Start generic captures and run MCS bench capture automation.

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

   usage: chargelink capture [-h] {start,stop,mcs-list,mcs} ...

   positional arguments:
     {start,stop,mcs-list,mcs}

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

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

   * - Subcommand
     - Purpose
   * - ``start``
     - Start a named capture session.
   * - ``stop``
     - Stop a named capture session.
   * - ``mcs-list``
     - List predefined MCS bench capture profiles.
   * - ``mcs``
     - Run an MCS bench capture in dry-run or real mode.

start
-----

Start a named capture session.

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

   usage: chargelink capture start [-h] [--runtime-root RUNTIME_ROOT] name

   positional arguments:
     name

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Start a generic capture.**

.. code-block:: bash

   chargelink capture start 'cap1' --runtime-root '.tmp/runtime'

**Start a second capture.**

.. code-block:: bash

   chargelink capture start 'cap2' --runtime-root '.tmp/runtime'


stop
----

Stop a named capture session.

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

   usage: chargelink capture stop [-h] [--runtime-root RUNTIME_ROOT] name

   positional arguments:
     name

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Stop a named run.**

.. code-block:: bash

   chargelink capture stop 'demo-run' --runtime-root '.tmp/runtime'

**Stop a second named run.**

.. code-block:: bash

   chargelink capture stop 'release-smoke' --runtime-root '.tmp/runtime'


mcs-list
--------

List predefined MCS bench capture profiles.

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

   usage: chargelink capture mcs-list [-h] [--output OUTPUT]

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

Production examples
~~~~~~~~~~~~~~~~~~~
**List MCS capture profiles.**

.. code-block:: bash

   chargelink capture mcs-list

**Write MCS capture profiles to JSON.**

.. code-block:: bash

   chargelink capture mcs-list --output 'artifacts/mcs_capture_profiles.json'


mcs
---

Run an MCS bench capture in dry-run or real mode.

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

   usage: chargelink capture mcs [-h]
                                 [--scope {baseline,safety,fault_injection,all}]
                                 [--driver {all,mock,ni_daqmx,veristand}]
                                 [--mode {dry_run,real}]
                                 [--output-root OUTPUT_ROOT] [--run-id RUN_ID]
                                 [--hardware-profile-id HARDWARE_PROFILE_ID]
                                 [--real-hardware] [--safe-stop-observed]
                                 [--fault-code FAULT_CODE] [--reviewer REVIEWER]
                                 [--output OUTPUT]

   options:
     -h, --help            show this help message and exit
     --scope {baseline,safety,fault_injection,all}
     --driver {all,mock,ni_daqmx,veristand}
     --mode {dry_run,real}
     --output-root OUTPUT_ROOT
     --run-id RUN_ID
     --hardware-profile-id HARDWARE_PROFILE_ID
     --real-hardware
     --safe-stop-observed
     --fault-code FAULT_CODE
     --reviewer REVIEWER
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Run the baseline MCS dry-run capture through NI-DAQmx semantics.**

.. code-block:: bash

   chargelink capture mcs --scope 'baseline' --driver 'ni_daqmx' --mode 'dry_run' --output-root 'artifacts/mcs_capture' --run-id 'baseline' --output 'artifacts/mcs_capture/baseline_result.json'

**Run the safety dry-run capture through VeriStand semantics.**

.. code-block:: bash

   chargelink capture mcs --scope 'safety' --driver 'veristand' --mode 'dry_run' --safe-stop-observed --fault-code 'hv_interlock_open' --fault-code 'over_current' --output-root 'artifacts/mcs_capture' --run-id 'safety' --output 'artifacts/mcs_capture/safety_result.json'