chargelink evidence
===================

Map evidence, validate manifests, attest, sign, import, list, and export MCS or release evidence bundles.

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

   usage: chargelink evidence [-h]
                              {map,validate,attest,sign,import,list,export} ...

   positional arguments:
     {map,validate,attest,sign,import,list,export}

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

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

   * - Subcommand
     - Purpose
   * - ``map``
     - Map evidence-relevant artifacts from a run directory.
   * - ``validate``
     - Validate an evidence manifest.
   * - ``attest``
     - Create or update the attestation fields of an evidence manifest.
   * - ``sign``
     - Apply an evidence signature record.
   * - ``import``
     - Import an evidence manifest into a suite or release gate.
   * - ``list``
     - List imported evidence for a suite root.
   * - ``export``
     - Export imported evidence as a ZIP bundle.

map
---

Map evidence-relevant artifacts from a run directory.

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

   usage: chargelink evidence map [-h] path

   positional arguments:
     path

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

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

.. code-block:: bash

   chargelink evidence map 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic'

**Generate a second map.**

.. code-block:: bash

   chargelink evidence map 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed'


validate
--------

Validate an evidence manifest.

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

   usage: chargelink evidence validate [-h] [--require-signature]
                                       [--require-artifacts-exist]
                                       [--no-attestation] [--allow-simulated]
                                       [--output OUTPUT]
                                       path

   positional arguments:
     path

   options:
     -h, --help            show this help message and exit
     --require-signature
     --require-artifacts-exist
     --no-attestation
     --allow-simulated
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Validate a baseline evidence manifest.**

.. code-block:: bash

   chargelink evidence validate 'validations/bench_proof/mcs_release_baseline.json' --require-signature --output 'artifacts/evidence/baseline_validate.json'

**Validate the safety evidence manifest and require raw artifacts.**

.. code-block:: bash

   chargelink evidence validate 'validations/bench_proof/mcs_release_safety.json' --require-signature --require-artifacts-exist --output 'artifacts/evidence/safety_validate.json'


attest
------

Create or update the attestation fields of an evidence manifest.

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

   usage: chargelink evidence attest [-h] --reviewer REVIEWER [--status STATUS]
                                     [--notes NOTES] [--safe-stop-observed]
                                     [--fault-code FAULT_CODE]
                                     [--case-id CASE_ID] [--artifact ARTIFACT]
                                     [--output OUTPUT]
                                     path

   positional arguments:
     path

   options:
     -h, --help            show this help message and exit
     --reviewer REVIEWER
     --status STATUS
     --notes NOTES
     --safe-stop-observed
     --fault-code FAULT_CODE
     --case-id CASE_ID
     --artifact ARTIFACT   Relative or absolute raw evidence artifact path to add
                           to proof_bundle.artifacts.
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Attest a baseline MCS release proof manifest.**

.. code-block:: bash

   chargelink evidence attest 'validations/bench_proof/mcs_release_baseline.template.json' --reviewer 'qa' --status 'passed' --case-id 'mcs_dc_josev_session_contract' --artifact 'mcs_release_baseline_trace.json' --output 'validations/bench_proof/mcs_release_baseline.json'

**Attest a safety manifest with safe-stop evidence.**

.. code-block:: bash

   chargelink evidence attest 'validations/bench_proof/mcs_release_safety.template.json' --reviewer 'qa' --status 'passed' --safe-stop-observed --fault-code 'hv_interlock_open' --fault-code 'over_current' --artifact 'mcs_release_safety_trace.json' --output 'validations/bench_proof/mcs_release_safety.json'


sign
----

Apply an evidence signature record.

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

   usage: chargelink evidence sign [-h] --signer SIGNER [--note NOTE]
                                   [--output OUTPUT]
                                   path

   positional arguments:
     path

   options:
     -h, --help       show this help message and exit
     --signer SIGNER
     --note NOTE
     --output OUTPUT

Production examples
~~~~~~~~~~~~~~~~~~~
**Apply a signature record to the baseline manifest.**

.. code-block:: bash

   chargelink evidence sign 'validations/bench_proof/mcs_release_baseline.json' --signer 'qa' --output 'validations/bench_proof/mcs_release_baseline.json'

**Apply a signature record to the safety manifest.**

.. code-block:: bash

   chargelink evidence sign 'validations/bench_proof/mcs_release_safety.json' --signer 'qa' --note 'verified on bench A' --output 'validations/bench_proof/mcs_release_safety.json'


import
------

Import an evidence manifest into a suite or release gate.

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

   usage: chargelink evidence import [-h] --suite-root SUITE_ROOT
                                     [--install-to-release-gate]
                                     [--install-root INSTALL_ROOT]
                                     [--allow-unsigned]
                                     [--require-artifacts-exist]
                                     path

   positional arguments:
     path

   options:
     -h, --help            show this help message and exit
     --suite-root SUITE_ROOT
     --install-to-release-gate
     --install-root INSTALL_ROOT
     --allow-unsigned
     --require-artifacts-exist

Production examples
~~~~~~~~~~~~~~~~~~~
**Import a baseline manifest into the production release suite root.**

.. code-block:: bash

   chargelink evidence import 'validations/bench_proof/mcs_release_baseline.json' --suite-root 'artifacts/suites/chargelink-production-release' --install-to-release-gate --install-root 'validations/bench_proof' --require-artifacts-exist

**Import a safety manifest into the production release suite root.**

.. code-block:: bash

   chargelink evidence import 'validations/bench_proof/mcs_release_safety.json' --suite-root 'artifacts/suites/chargelink-production-release' --install-to-release-gate --install-root 'validations/bench_proof' --require-artifacts-exist


list
----

List imported evidence for a suite root.

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

   usage: chargelink evidence list [-h] --suite-root SUITE_ROOT [--output OUTPUT]

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

Production examples
~~~~~~~~~~~~~~~~~~~
**List imported evidence for the production release suite.**

.. code-block:: bash

   chargelink evidence list --suite-root 'artifacts/suites/chargelink-production-release' --output 'artifacts/evidence/evidence_list.json'

**List imported evidence for a dedicated MCS qualification suite.**

.. code-block:: bash

   chargelink evidence list --suite-root 'artifacts/suites/chargelink-mcs' --output 'artifacts/evidence/mcs_evidence_list.json'


export
------

Export imported evidence as a ZIP bundle.

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

   usage: chargelink evidence export [-h] --suite-root SUITE_ROOT --output OUTPUT

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Export imported evidence from the production release suite.**

.. code-block:: bash

   chargelink evidence export --suite-root 'artifacts/suites/chargelink-production-release' --output 'artifacts/evidence/production_release_evidence.zip'

**Export imported evidence from the MCS suite.**

.. code-block:: bash

   chargelink evidence export --suite-root 'artifacts/suites/chargelink-mcs' --output 'artifacts/evidence/mcs_evidence.zip'