stars.config.* can fail to load or validate is a structured diagnostic exported from
@wolfstar/http-framework/config as configDiagnostics. @wolfstar/cli renders these the same way as its own
CLI errors and exits with code 2 for all of them.
ROOT_NOT_FOUND
The project root does not exist. Fix: pointroot to an existing directory, relative to the configuration file.
PACKAGE_JSON_INVALID
The project’spackage.json failed to parse.
Fix: fix the JSON syntax of the package.json file.
ENTRY_NOT_FOUND
Theentry file does not exist.
Fix: point entry to the file that starts the bot, relative to the project root.
ENTRY_DEFAULT_NOT_FOUND
Could not find an entry file in the project root under any of the default names. Fix: setentry in the configuration, or create one of the default entry files.
INVALID_BUILD_TOOL
build.tool is set to an unknown value.
Fix: use one of 'tsdown', 'tsc', 'vite', 'none' or 'auto'.
EXPERIMENTAL_BUILD_TOOL
The selected build tool is experimental. Fix: set the matchingexperimental.* flag to true to opt in.
BUILD_TOOL_REQUIRED
The entry file is TypeScript butbuild.tool is 'none'.
Fix: set build.tool to 'tsdown' or 'tsc', or point entry to a JavaScript file.
TSCONFIG_EXPLICIT_NOT_FOUND
Thetsconfig.json file pointed to explicitly by the configuration does not exist.
Fix: point that option to an existing tsconfig.json, relative to the project root.
TSCONFIG_NOT_FOUND
Could not find atsconfig.json in the project root.
Fix: create src/tsconfig.json or tsconfig.json, or set the suggested option explicitly.
TSDOWN_OPTIONS_REQUIRE_TSDOWN
tsdown options were set but build.tool isn’t 'tsdown'.
Fix: set build.tool to 'tsdown', or remove the tsdown options.
VITE_OPTIONS_REQUIRE_VITE
vite options were set but build.tool isn’t 'vite'.
Fix: set build.tool to 'vite' with experimental.enableVite, or remove the vite options.
TSDOWN_CONFIG_FILE_UNSUPPORTED
Atsdown config file exists but isn’t used at the project’s current compatibility version.
Fix: move its options into the tsdown configuration option, drop the config file, or lower
future.compatibilityVersion to the legacy version.
INVALID_TYPE
An option was set to a value of the wrong type. Fix: the message names the option, the type it expects, and the value it actually received.INVALID_COMPATIBILITY_VERSION
future.compatibilityVersion is set to an unknown version.
Fix: use the legacy compatibility version for the legacy build pipeline, or the latest version for today’s
defaults.
UNKNOWN_OPTION
The configuration contains an option name@wolfstar/http-framework doesn’t recognize.
Fix: the message lists the known options for that section — check for a typo.
EXPERIMENT_REQUIRED
An option needs anexperimental.* flag that isn’t set.
Fix: set the required flag to true as well, or drop the option that needs it.
IMPORTS_REQUIRE_TSDOWN
imports was set but build.tool isn’t 'tsdown'.
Fix: set build.tool to 'tsdown', or remove imports (or set it to false).
LOCALES_NOT_FOUND
codegen.i18n.locales points to a directory that does not exist.
Fix: point it to the base locale directory, relative to the project root.
INVALID_URL
An option that expects a URL received a value that isn’t a valid URL. Fix: the message includes what a valid value looks like for that option.TUNNEL_URL_NOT_HTTPS
The tunnel URL isn’thttps.
Fix: Discord only accepts an https interactions endpoint.
INVALID_TYPECHECKER
The configured type checker is set to an unknown value. Fix: use one of'tsc', 'golar', 'tsz' or 'auto'.
CONFIG_NOT_FOUND
Nostars.config.* file was found.
Fix: pass an existing file to --config, or create one of the recognized config file names in the current
directory.
CONFIG_LOAD_FAILED
The configuration file failed to load. Fix: the file must be valid TypeScript/JavaScript and export the configuration as its default export.CONFIG_NOT_OBJECT
The configuration file’s default export isn’t an object. Fix: useexport default defineConfig({ ... }) from @wolfstar/http-framework/config.