cli: standardise reporting tool invocation patterns

[NoahOksuz]

resolves #1368

issue 1368: Standardizes CLI patterns across all CLI-accessible scripts in garak.analyze. Each script now:

• Uses argparse with consistent flags and help/description (pattern aligned with garak.cli)
• Prints a version banner (garak <description> v<version>)
• Provides short and long options (e.g., -r/--report_path, -o/--output_path)
• Executes only under if __name__ == "__main__": and not on import

Updated scripts: aggregate_reports, analyze_log, count_tokens, get_tree, misp, perf_stats, qual_review, report_avid (kept report_digest as the canonical example). No specific GitHub issue linked; this addresses CLI consistency and import-side-effect issues.

Verification

List the steps needed to make sure this thing works

• garak -m <model_type> -n <model_name>
• Run the tests and ensure they pass python -m pytest tests/
• Generate a small report to use for analysis tools:
  • python -m garak -m test.Blank -p test.Blank --report_prefix _cli_std_check
• Verify each analyze CLI runs with help text and version banner:
  • python -m garak.analyze.aggregate_reports --help
  • python -m garak.analyze.analyze_log --help
  • python -m garak.analyze.count_tokens --help
  • python -m garak.analyze.get_tree --help
  • python -m garak.analyze.misp --help
  • python -m garak.analyze.perf_stats --help
  • python -m garak.analyze.qual_review --help
  • python -m garak.analyze.report_avid --help
• Run each tool against the generated report (replace <REPORT> with the path to _cli_std_check.report.jsonl):
  • python -m garak.analyze.analyze_log -r <REPORT>
  • python -m garak.analyze.count_tokens -r <REPORT>
  • python -m garak.analyze.get_tree -r <REPORT>
  • python -m garak.analyze.misp -u
  • python -m garak.analyze.perf_stats -r <REPORT> <REPORT>
  • python -m garak.analyze.qual_review -r <REPORT>
  • python -m garak.analyze.aggregate_reports -o agg.jsonl <REPORT> <REPORT>
  • python -m garak.analyze.report_avid -r <REPORT>
  • python -m garak.analyze.report_digest -r <REPORT>

[github-actions]

DCO Assistant Lite bot All contributors have signed the DCO ✍️ ✅

[NoahOksuz]

I have read the DCO Document and I hereby sign the DCO

[NoahOksuz]

recheck

[NoahOksuz]

guys i know it looks like there are a lot of changes in the code but really its just the refactoring

[leondz]

nice, thanks. few small changes & minor clarifications requested

[leondz]

Good PR, thank you.

lgtm