chargelink audit
================

Run commercialization and source-origin audits, including SBOM and release-blocker exports.

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

   usage: chargelink audit [-h]
                           {export,open-source,source-origin,sbom,license-policy,productization,release-blockers} ...

   positional arguments:
     {export,open-source,source-origin,sbom,license-policy,productization,release-blockers}

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

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

   * - Subcommand
     - Purpose
   * - ``export``
     - Export a generic audit payload from a run directory.
   * - ``open-source``
     - Generate an open-source finding report.
   * - ``source-origin``
     - Generate source-origin traceability output.
   * - ``sbom``
     - Generate a software bill of materials.
   * - ``license-policy``
     - Generate a license policy report.
   * - ``productization``
     - Generate the full productization audit.
   * - ``release-blockers``
     - Generate release blockers derived from commercialization policy.

export
------

Export a generic audit payload from a run directory.

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

   usage: chargelink audit export [-h] path output

   positional arguments:
     path
     output

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Export an audit payload for a run root.**

.. code-block:: bash

   chargelink audit export 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic' 'artifacts/audit/run_audit.json'

**Export an audit payload for a second run root.**

.. code-block:: bash

   chargelink audit export 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed' 'artifacts/audit/run_audit_2.json'


open-source
-----------

Generate an open-source finding report.

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

   usage: chargelink audit open-source [-h] [--root ROOT] [--output OUTPUT]
                                       [--fail-on-attention]

   options:
     -h, --help           show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-attention

Production examples
~~~~~~~~~~~~~~~~~~~
**Run the open-source audit for the repo root.**

.. code-block:: bash

   chargelink audit open-source --root '.' --output 'artifacts/audit/open_source_audit.json'

**Fail the pipeline when the open-source audit reports attention items.**

.. code-block:: bash

   chargelink audit open-source --root '.' --output 'artifacts/audit/open_source_audit.json' --fail-on-attention


source-origin
-------------

Generate source-origin traceability output.

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

   usage: chargelink audit source-origin [-h] [--root ROOT] [--output OUTPUT]
                                         [--fail-on-blockers]

   options:
     -h, --help          show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-blockers

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate source-origin traceability.**

.. code-block:: bash

   chargelink audit source-origin --root '.' --output 'artifacts/audit/source_origin_report.json'

**Fail when source-origin blockers are present.**

.. code-block:: bash

   chargelink audit source-origin --root '.' --output 'artifacts/audit/source_origin_report.json' --fail-on-blockers


sbom
----

Generate a software bill of materials.

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

   usage: chargelink audit sbom [-h] [--root ROOT] [--output OUTPUT]
                                [--fail-on-blockers]

   options:
     -h, --help          show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-blockers

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate the ChargeLink SBOM.**

.. code-block:: bash

   chargelink audit sbom --root '.' --output 'artifacts/audit/chargelink_sbom.json'

**Fail when the SBOM step detects blockers.**

.. code-block:: bash

   chargelink audit sbom --root '.' --output 'artifacts/audit/chargelink_sbom.json' --fail-on-blockers


license-policy
--------------

Generate a license policy report.

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

   usage: chargelink audit license-policy [-h] [--root ROOT] [--output OUTPUT]
                                          [--fail-on-blockers]

   options:
     -h, --help          show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-blockers

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate the license policy report.**

.. code-block:: bash

   chargelink audit license-policy --root '.' --output 'artifacts/audit/license_policy_report.json'

**Fail the build on license-policy blockers.**

.. code-block:: bash

   chargelink audit license-policy --root '.' --output 'artifacts/audit/license_policy_report.json' --fail-on-blockers


productization
--------------

Generate the full productization audit.

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

   usage: chargelink audit productization [-h] [--root ROOT] [--output OUTPUT]
                                          [--fail-on-blockers]

   options:
     -h, --help          show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-blockers

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate the full productization audit.**

.. code-block:: bash

   chargelink audit productization --root '.' --output 'artifacts/audit/productization_audit.json'

**Fail the build when commercialization blockers remain.**

.. code-block:: bash

   chargelink audit productization --root '.' --output 'artifacts/audit/productization_audit.json' --fail-on-blockers


release-blockers
----------------

Generate release blockers derived from commercialization policy.

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

   usage: chargelink audit release-blockers [-h] [--root ROOT] [--output OUTPUT]
                                            [--fail-on-blockers]

   options:
     -h, --help          show this help message and exit
     --root ROOT
     --output OUTPUT
     --fail-on-blockers

Production examples
~~~~~~~~~~~~~~~~~~~
**Generate release blockers for the current repo snapshot.**

.. code-block:: bash

   chargelink audit release-blockers --root '.' --output 'artifacts/audit/release_blockers.json'

**Fail the build when release blockers exist.**

.. code-block:: bash

   chargelink audit release-blockers --root '.' --output 'artifacts/audit/release_blockers.json' --fail-on-blockers