changelog prepare-artifact
Note
This command is intended for CI automation. It is used internally by the changelog GitHub Actions and is not typically invoked directly by users.
Package the changelog artifact for cross-workflow transfer.
Resolves the final status from the evaluate-pr and changelog add outcomes, copies the generated YAML file (if any), writes metadata.json, and sets GitHub Actions outputs.
This command always exits with code 0 so the subsequent artifact upload step runs regardless of the internal status.
docs-builder changelog prepare-artifact [options...] [-h|--help]
--staging-dir <string>- Directory where
changelog addwrote the generated YAML. --output-dir <string>- Directory to write the artifact (
metadata.json+ YAML). --evaluate-status <string>- Status output from the
evaluate-prstep. --generate-outcome <string>- Outcome of the
changelog addstep (success,failure, orskipped). --pr-number <int>- Pull request number.
--head-ref <string>- PR head branch ref.
--head-sha <string>- PR head commit SHA.
--label-table <string?>- Optional: markdown label table from
evaluate-pr. --config <string?>- Optional: path to
changelog.yml(used to extract creation rules for metadata).
| Output | Description |
|---|---|
status |
Final artifact status: success, no-label, no-title, error, skipped, or manually-edited |
| File | Condition |
|---|---|
{output-dir}/metadata.json |
Always written |
{output-dir}/{pr_number}.yaml |
Only when the changelog was generated successfully |
Package a successful changelog generation:
docs-builder changelog prepare-artifact \
--staging-dir /tmp/changelog-staging \
--output-dir /tmp/changelog-result \
--evaluate-status proceed \
--generate-outcome success \
--pr-number 42 \
--head-ref feature-branch \
--head-sha abc123 \
--config docs/changelog.yml