compiler status

Arguments and rejection

Use topaz compiler status with no positional operand. Accept only --format human or --format json, at most once, with human as the default.

Reject --json, equals forms, repeated options, unsupported format values, missing values, source operands, compiler and language selectors and all other options before inspecting the installation.

Output

Human output on standard output identifies the product release, language mode, default compiler and its scope, reference compiler, bootstrap seed engine, installed self compiler health and absence of silent fallback.

--format json writes one UTF-8 JSON object followed by a newline using topaz.compiler-support/v5. Its top level fields are schema, productVersion, languageMode, selfCompilationProductSchema, defaultCompiler, defaultScope, referenceCompiler, bootstrapSeedEngine, silentFallback, selectionOrigins, compilers, routes and previewProducers.

silentFallback is false. selectionOrigins and previewProducers are string arrays. Each compiler row has string selector, producer and status. A supported self row also records its producer stage, execution kind, source, link, toolchain, target and digest identities. An unhealthy self row carries a string reason.

Each route row has string command, rust, self, omitted and condition fields. The omitted selector route agrees with the installed product default. Human and JSON forms describe the same inventory.

Usage or report production failures use standard error. Do not mix human banners into JSON output.

Exit status

Exit 0 after producing the complete report even when a compiler row reports unhealthy. An unhealthy inspected compiler is report data rather than a failed inspection command.

Exit 1 for invalid arguments or failure to produce the report. The status command does not execute a source program to determine its exit code.

Filesystem effects

Inspect the installed compiler identity and admitted metadata. Do not compile source, allocate a build workspace, repair the installation or write any user file.

Network access

Perform no network access, update check, registry query or compiler download.

Reproducibility

The same executable, admitted identity records, target and installation health produce identical JSON bytes and inventory ordering.

A changed installation or health state is changed input. Current directory contents, wall clock time and a user package do not choose a different report.

Packages and locks

Do not discover or load the current directory as a package. Do not read, create or rewrite its manifest, lock or vendor tree.

Compiler route inventory describes installed support and does not promise that dependencies for an arbitrary package are available.

The invocation topaz compiler status main.tpz --language-version 5.21 is expected to exit with 1.