Skip to main content

cirron validate

Validates Cirron configuration. The behavior depends on the cirron.yaml found in the current directory:
  • Single-model mode: the cirron.yaml is a normal model config. validate checks its required fields, framework, and version format.
  • Monorepo mode: the cirron.yaml has a top-level workspace: key. validate checks the root config, discovers every model listed under workspace.models (expanding globs like models/*), applies any workspace.defaults, and validates each model. Results are reported per model.
There is no upward search for a root config. Running cirron validate inside a model subdirectory of a monorepo validates just that model.

Usage

Options

OptionDescriptionDefault
--model <name...>Validate only the named model(s). Matches a model’s name or its workspace-relative path. Repeatable.all models
--jsonOutput results as JSONfalse

Exit code

0 if everything is valid; 1 if the root config is invalid, a model path is missing, a --model name matched nothing, or any model fails validation.

Examples

Single model

Whole workspace

A subset of models

A missing model path

JSON output

In single-model mode the JSON shape is { "name", "ok", "errors", "warnings" }.

See also

  • Monorepo support: the root workspace: config and inheritance rules.
  • cirron lint: deeper project-health checks (structure, dependencies, code).