Turns a structured test plan (base URL, weighted request mix, load profile, thresholds) into a runnable k6 JavaScript script. Deterministic templating, not an LLM call -- reviewable before running. Returns a runDir that all later steps (smoke_test_script, run_load_test, get_test_metrics) take as input.

Runs the script for 1 VU / 1 iteration to catch syntax or runtime errors fast, before committing to a full load test. Always call this before run_load_test.

Executes the load test at the VUs/duration/stages baked into the generated script by generate_k6_script. Only runs against hosts listed in perf-agent.config.json's allowedHosts -- add a host there yourself (the tools won't do it for you) once you've confirmed you're authorized to load-test it. Can take as long as the test's own duration/stages; call smoke_test_script first.

Parses the k6 summary JSON into deterministic structured metrics: overall + per-endpoint p50/p90/p95/p99 latency, error rate, RPS, and threshold pass/fail. Use this data (not raw k6 console output) to write the human-readable performance summary -- the numbers here are computed in code, not guessed.

Convenience tool that chains generate_k6_script -> smoke_test_script -> run_load_test -> get_test_metrics. Use the granular tools instead when you want to inspect/adjust the script between steps, or re-run the same script with different load without regenerating it.