chargelink audit

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

Reference syntax

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

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

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.

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.

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

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.

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

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

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

source-origin

Generate source-origin traceability output.

CLI help

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.

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

Fail when source-origin blockers are present.

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

sbom

Generate a software bill of materials.

CLI help

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.

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

Fail when the SBOM step detects blockers.

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

license-policy

Generate a license policy report.

CLI help

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.

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

Fail the build on license-policy blockers.

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

productization

Generate the full productization audit.

CLI help

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.

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

Fail the build when commercialization blockers remain.

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

release-blockers

Generate release blockers derived from commercialization policy.

CLI help

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.

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

Fail the build when release blockers exist.

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