testzeus-test-operations#

List, run, and inspect TestZeus tests and test runs.

Category: core · Version: 1.0.0 · Requires: testzeus-auth

Triggers: run test, execute test, check status, monitor test, cancel run, test results

Triggers#

See triggers.md for pattern matching rules.

Overview#

Guides AI agents in running, monitoring, and analyzing test executions using TestZeus. Focus on actionable responses and clear status communication.

Capabilities#

  1. Run tests by name, tag, or suite

  2. Monitor test execution progress

  3. View test results and history

  4. Cancel running tests

  5. Get detailed error information

Workflow States#

  • idle: No active operation

  • confirming_environment: Waiting for environment confirmation

  • confirming_suite: Waiting for suite confirmation

  • running: Tests executing

  • monitoring: Watching test progress

  • completed: Tests finished

Response Formatting#

Status Display#

Always use component JSON for structured displays:

{
  "component": "TestRunCard",
  "props": {
    "name": "checkout_suite",
    "status": "passed",
    "duration": "4m 23s",
    "testCount": 25,
    "passedCount": 24,
    "failedCount": 1
  }
}

Progress Updates#

{
  "component": "StatusBadge",
  "props": {
    "status": "running",
    "label": "3/10 tests completed"
  }
}

Best Practices#

  1. Always confirm environment before running tests

  2. Report progress for long-running suites (every 30 seconds)

  3. Offer detailed reports after completion

  4. Summarize failures with actionable error messages

  5. Be concise - prefer components over paragraphs

State Transitions#

idle → confirming_environment (on "run test")
confirming_environment → confirming_suite (on environment selected)
confirming_environment → idle (on "cancel")
confirming_suite → running (on suite selected)
confirming_suite → idle (on "cancel")
running → monitoring (after initial run)
monitoring → completed (on all tests finished)
monitoring → idle (on "cancel")
completed → idle (after summary shown)

Examples#

See examples/conversation.md