Run diagnostics from the smallest relevant directory. Each command has a distinct responsibility:
| Command | Primary boundary | Writes? | Failure means |
|---|---|---|---|
arc dsl format <dir> --check | Formatting drift | No | Source would be reformatted |
arc dsl format <dir> --write | Formatting normalization | Yes | The command could not safely format source |
arc dsl lint <dir> | DSL static authoring issues | No | Error-level lint findings; warnings still need review |
arc dsl validate <dir> | Parsed AUP/DSL semantics | No | A source/configuration contract is invalid |
arc dsl generate <dir> --check | Compatibility-artifact drift | No | Materialized output would differ |
arc dsl generate <dir> --write | Compatibility-artifact materialization | Yes | Output could not be generated safely |
arc blocklet check <dir> | Combined source checks, Content Space when present, and selected profile structure | No | The declared blocklet shape is invalid for that check |
dsl validate scans AUP sources and Web layouts, including pages/**/layout.aup, object-level content/**/layout.aup, and layouts/*.aup. A passing scan does not inspect reader-facing visual hierarchy or all runtime target behavior.
A simple acceptance order
arc dsl lint .
arc dsl validate .
arc blocklet check .
arc blocklet build .
arc blocklet run .The first four establish increasingly broader static/build evidence. The final command is where a person or a clean acceptance agent opens the actual URL, checks the intended interaction, and records what was observed.
I18n migration is a separate narrow maintenance operation. It does not automatically translate content or reliably resolve every historical locale structure; review its diff rather than treating it as a generic upgrade command.
For source-generation detail, see Generate, lint, and migrate. Web-site diagnostic categories remain target-specific and are outside this AUP reference.