Skip to main content
Converts existing local issue YAML files into issues.json arrays for modules or packages. It discovers destinations when none are provided, parses each *.yml file, sorts by file name, and writes a pretty JSON array.

Usage

Examples

Convert every module or package that owns an issues/ directory:
Convert one destination:
Convert multiple destinations:
Pass repeated destination flags:

Options

Discovery

A destination name is resolved under modules/ first, then packages/. When --destination is omitted, the command discovers every module or package that owns an issues/ directory. If a requested destination is not found under either root, the command reports an error and counts that destination as a failure.

Output paths

The command reads the destination type from <name>.yml. If the type is spa, storybook, swagger, or admin, it writes:
For every other type, and when no type descriptor is present, it writes:
Missing output directories are created before writing.

Conversion

The command reads every *.yml file in the destination issues/ directory and converts each valid YAML document to JSON. Invalid or unreadable issue files are skipped with a warning. The resulting array is sorted by file name and written with a trailing newline. A destination with no issues/ directory is a warning and not a failure. A destination with an empty issues/ directory writes [].

Exit codes

The command exits non-zero when no destinations can be discovered, or when any requested destination fails to convert.