Command reference
stax validate
Validate definitions without producing an artifact
Check agent or package definitions against the current CLI validation rules without producing an artifact.
Usage
stax validate
stax validate .stax/backend/agent.ts
stax validate .stax/shared/package.tsWhen run without arguments, stax validate auto-discovers entries only from:
.stax/<name>/agent.ts.stax/<name>/package.ts
What gets validated
Validation currently checks:
| Check | What it catches |
|---|---|
| Required fields | Missing name, version, description, adapter |
| Path existence | Referenced files or directories that don't exist |
| Path type | File-vs-directory mismatches for known layer fields |
| Name / version | Invalid names and semver values |
| Tag uniqueness | Duplicate tag entries |
| Symlink policy | Rejected symlinks when symlinkMode is reject |
| Package references | Empty or malformed package reference strings |
Example output
Validation passed.
Warnings:
[OPTIONAL_MISSING_PATH] /repo/.stax/backend/memory: Optional path for "memory" does not existRelated commands
stax build— Build after validation succeedsstax inspect— Inspect a built artifact