Skip to main content

manifest-audit Contract

Purpose​

Check standard-suite manifests for required sections and missing local artifact references.

Usage​

manifest-audit [root] [--json]

Inputs​

  • Arguments: optional root path; defaults to current directory.
  • Options: --json emits machine-readable output.
  • Environment: none.
  • Files: */CTS.manifest.toml.

Outputs​

Human Output​

Summary of manifests checked, missing sections, missing artifact paths, and final result.

Machine Output​

With --json, stdout contains one JSON object:

  • root
  • manifests_checked
  • errors
  • warnings
  • status

Diagnostics​

Unreadable files, parse errors, and filesystem diagnostics go to stderr.

Exit Codes​

CodeMeaning
0All checked manifests passed.
2Invalid arguments.
3Root path missing.
4One or more manifests failed validation.

Stability​

  • Command name: stable after first release.
  • Flag names: --json is stable.
  • Machine-readable fields: additive changes allowed in minor releases.
  • Breaking-change policy: field removals require a major version.

Examples​

Human Use​

manifest-audit D:\010-CITY-HALL

Automation Use​

manifest-audit D:\010-CITY-HALL --json