validator-status
/validator-status
Show a detailed summary of the most recent validator session.
Step 1: Run the status script
agent-validate status 2>&1
The script parses the .debug.log for session-level data (run count, gate results, pass/fail status) and lists all log files with their paths and sizes.
Step 2: Read failed gate details
For each gate marked FAIL in the Gate Results table, read the corresponding log files to extract failure details:
- Check failures (e.g.,
check:src:code-health): Read the matchingcheck_*.logfile. Check log formats vary by tool (linters, test runners, code health analyzers) — read the file and extract the relevant error/warning output. - Review failures (e.g.,
review:.:code-quality): Read the matchingreview_*.jsonfile(s). These contain structured violation data withfile,line,issue,priority, andstatusfields.
Use the file paths from the "Log Files" section of the script output. Match gate IDs to file names: check:.:lint corresponds to check_._lint.*.log, review:.:code-quality corresponds to review_._code-quality_*.{log,json}.
More from codagent-ai/agent-validator
validator-help
Diagnoses and explains validator behavior from runtime evidence for requests such as "why did validator fail", "explain validator behavior", "diagnose validator logs", or "what went wrong in the validator run".
16validator-commit
>-
16validator-check
>-
16validator-skip
Advances the validator execution state baseline without running checks for requests such as "skip validator", "advance validator baseline", or "mark current tree as validated without running checks".
16validator-setup
Scans the project and configures checks and reviews for Agent Validator for requests such as "set up validator", "configure checks and reviews", or "initialize validator for this repo".
16validator-issue
Files structured GitHub bug reports for agent-validator when users ask to file, report, or open an issue for a suspected defect
16