ager-validate

name	ager-validate
description	Validate AGER bundle structure and field rules, then delegate link/graph validation to okf-plugin (okf-graph-eng). Use before merge or after authoring multi-agent graphs.

AGER Validate

Run AGER validation

python3 <plugin-root>/scripts/ager-validate.py <bundle> --strict

The command emits JSON and exits non-zero on errors; --strict also gates warnings. It requires only the Python standard library.

Checks (this plugin)

1. Bundle root has okf_version and preferably ager_version: "0.3.0".
2. Every AgentNode-like concept has input_schema and output_schema (or documents exception).
3. AgentGraph (if present) links LoopPolicy and ScratchPad.
4. LoopPolicy has ≥1 control; warn if missing deadline or price on production graphs.
5. Tools with side_effects: irreversible should have dual_control or require_human rule or compensation.
6. No inline secret values — only SecretRef paths.
7. Workers that claim parallel use should record_output_to with mode: append.

Delegate to okf-graph-eng

okf validate <bundle> --strict
# or
python3 <okf-plugin>/scripts/okf-graph.py validate <bundle> --strict

If okf tooling missing, report AGER checks only and instruct user to install okf-plugin.

Done when

• AGER structural issues listed (errors vs warnings)
• OKF validation results included or skip reason stated