Docs/CLI reference

CLI reference

tama validate

Validates the sealed hook catalog, its source archive, justification metadata, secrets posture, and material runtime-install drift.

Validates the sealed hook catalog, its source archive, justification metadata, secrets posture, and material runtime-install drift.

#Invocation

tama validate [--json]

The command takes no positional input. --json prints ok, errors, warnings, hookCount, and orphanSourceCount. Text mode prints counts, WARN lines to stdout, and ERROR lines to stderr.

#Output and state

Validation is read-only. It exits 0 only when the error list is empty and exits 1 when validation finds an error.

#Refusals and failures

Errors include duplicate hook ids, missing source files or event bindings, invalid justification requirements, high-entropy tokens in managed validation files, and material runtime-install drift. An unmappable source path and acknowledged or otherwise non-material drift are warnings, not refusals. File or JSON failures are written as underlying errors and exit 1.

Return to the complete CLI command tree.