Builds and returns a list of a desired set of build artifacts

    usage: fx list-build-artifacts [--build] [--allow-empty | --expect-one] [FILTERS...] MODE

    Builds and returns a list of paths to special sets of build artifacts within
    the GN graph relative to the build directory.

     --build       build the artifacts as well as returning a list of them
     --show-label  show the GN label rather than the path
     --allow-empty do not fail if no such artifacts are found
     --expect-one  fail if zero or more than one artifacts are found. This
                   option is mutually exclusive from `--allow-empty`.
     --name        filter the set of artifacts to pick out the particular one of
                   the same name
     --os          filter the set of artifacts by intended operating system: one
                   of `fuchsia` or `linux`. Defaults to $HOST_OS when
                   the mode is `tools.`
     --cpu         filter the set of artifacts by intended architecture: one of
                   `x64` or `arm64`. Defaults to $HOST_CPU when the mode is
                   `tools`.
     --type         filter the set of artifacts by type.

     MODE          One of the following:
                   `images` -- returns the list of images
                   `flash`-- returns the list of images needed to flash
                   `mkzedboot` -- returns the list of images needed to mkzedboot
                   `tools` -- returns the list of host tools
                   `boot-tests`-- returns the list of boot tests
                   `generated-sources`-- returns the list of generated sources
                    (e.g., FIDL and Banjo bindings).
                   `product-bundle` -- returns the root of the product bundle


[list-build-artifacts source code](https://cs.opensource.google/fuchsia/fuchsia/+/main:tools/devshell/list-build-artifacts)