| name | maven-artifact-listing |
| description | Extract maven artifacts from an Axon Ivy product.json file and generate a clean list with sequential numbering and Maven dependency XML snippets. |
| argument-hint | <product.json path> [output file] |
| user-invocable | true |
Maven Artifact Listing
Generate a clean Maven artifact listing from Axon Ivy product.json files with sequential numbering and raw XML dependency declarations.
Inputs
- Required: Path to
product.json file (e.g., docuware-connector-product/product.json)
- Optional: Output file path. If omitted, output prints to stdout
Features
Extracts artifacts from all installer types:
- maven-dependency – Dependencies array
- maven-import – Projects array
- maven-dropins – Dropins array
For each artifact, generates:
- Sequential number with artifact id: installer/internal types are not exposed in the listing
- Raw XML
<dependency> declaration: includes groupId, artifactId and type (versions are omitted)
Ordering and optional handling:
maven-dependency artifacts are listed first.maven-import artifacts follow; projects with importInWorkspace=false are treated as optional and are listed after strictly imported projects.
Prerequisites
jq must be installed. The script exits with a clear error if it is not found.
Install: apt install jq (Linux/WSL) | brew install jq (macOS) | choco install jq (Windows)
Usage
Before running, check the current OS. If on Windows, git bash or WSL is recommended to use for best compatibility.
Print to stdout
bash ./.github/skills/maven-artifact-listing/scripts/extract-maven-artifacts.sh {product json path}
Write to file
bash ./.github/skills/maven-artifact-listing/scripts/extract-maven-artifacts.sh {product json path} docs/maven-artifacts.md
Output Format
See format reference for detailed output structure and examples.
Quality Criteria
- No test artifacts are included (artifactIds ending with
test are silently excluded).
- If no artifacts are found, output is empty.
- Installer types are not exposed in the listing.
