How hhv01/automation_becaros works
This repository is a shared Playwright QC automation framework with an AI-agent runtime and reusable UI/API/WebSocket test support. Its main agent workflow takes a user request and feature scope, selects a testcase, exploratory, or regression workflow, lets the QC agent inspect project context and run tests through guarded tools, then validates and emits a report. The tree and sampled source support the agent and helper-layer connections shown; the broader documented BA-to-automation pipeline is not represented in the supplied tree, so its stages are omitted.
Main entry points: qc.agent.ts QC agent · run-agent.ts Agent entrypoint · index.ts Workflow selector · playwright.tool.ts Playwright runner tool
Components 24
Agent runtime
- Agent entrypoint
automation-agent-kit/run-agent.ts - Workflow selector
automation-agent-kit/workflows/index.ts - Regression workflow
automation-agent-kit/workflows/regression.workflow.ts - Testcase workflow
automation-agent-kit/workflows/testcase.workflow.ts - Exploratory workflow
automation-agent-kit/workflows/exploratory.workflow.ts - QC agent
automation-agent-kit/agents/qc.agent.ts - Harness context
automation-agent-kit/agents/context.ts - Execution guardrails
automation-agent-kit/guardrails/execution.guardrail.ts - Result guardrails
automation-agent-kit/guardrails/result.guardrail.ts - Result schemas
automation-agent-kit/schemas/test-result.schema.ts
Test execution
- Project context tools
automation-agent-kit/tools/testcase.tool.ts - Playwright runner tool
automation-agent-kit/tools/playwright.tool.ts - Project test runner
scripts/project-test.mjs - Playwright report tool
automation-agent-kit/tools/report.tool.ts
Test support
- API request client
api/base.api.ts - API call recorder
utils/api-report-recorder.ts - WebSocket helpers
utils/ws-helper.ts - Mission form page
pages/mission-form.page.ts - Scheduler page
pages/scheduler.page.ts
Results and reporting
- QC report renderer
automation-agent-kit/reporting/final-report.ts - QC reports
Other components
- QC requester
- Test application
- WebSocket API
Connections 23
- QC requester → Agent entrypoint: submits request
- Agent entrypoint → Workflow selector: builds workflow input
- Workflow selector → Regression workflow: selects regression
- Workflow selector → Testcase workflow: selects testcase
- Workflow selector → Exploratory workflow: selects exploratory
- Agent entrypoint → QC agent: runs agent
- QC agent → Execution guardrails: checks input
- QC agent → Result guardrails: checks output
- Result guardrails → Result schemas: validates result
- QC agent → Project context tools: dispatches context tools
- QC agent → Playwright runner tool: dispatches test tool
- QC agent → Playwright report tool: dispatches report tool
- Playwright runner tool → Execution guardrails: guards execution
- Playwright runner tool → Project test runner: spawns runner
- Project test runner → Test application: runs tests against
- Playwright report tool → QC reports: reads run report
- Agent entrypoint → Result schemas: parses result
- Agent entrypoint → QC report renderer: renders report
- QC report renderer → QC reports: writes HTML
- API request client → API call recorder: records calls
- WebSocket helpers → WebSocket API: subscribes to topics
- Mission form page → Test application: drives mission UI
- Scheduler page → Test application: drives scheduler UI