How virtocommerce/ai-tools works
ai-tools is an agentic QA system for Virto Commerce, with the marketplace-installable vc-fix plugin as its flagship and a broader direct-clone QA crew. The primary workflow configures a project, routes a reported bug to the right repository and tracker, supports an autonomous fix, then verifies and transitions the ticket; monitoring is a parallel day-two workflow. The graph also preserves regression orchestration and performance tooling. Relationships for unsampled subsystems rely on README descriptions; omitted source limits finer call-level detail.
Main entry points: vc-fix Autonomous fix · run-regression.ts Regression runner · project-init Project onboarding · repo-router.ts Repository routing
Components 25
Bug lifecycle plugin
- Project onboarding
plugins/vc-fix/skills/project-init - Bug reproduction
plugins/vc-fix - Autonomous fix
plugins/vc-fix - Fix verification
plugins/vc-fix - Bug monitoring
plugins/vc-fix/skills/qa-monitoring
Project integrations
- Repository routing
plugins/vc-fix/skills/qa-fix-routing/repo-router.ts - Tracker adapters
plugins/vc-fix/skills/qa-fix-routing/trackers - Code-host adapters
plugins/vc-fix/skills/qa-fix-routing/vcs - Jira or Azure Boards
- GitHub or Azure Repos
Regression QA
- Monitoring runner
ci/run-monitor.ts - App Insights client
ci/lib/appinsights.ts - Signal fingerprints
ci/lib/fingerprint-store.ts - Regression runner
ci/run-regression.ts - Suite selection
ci/lib/suite-manifest.ts - Lane scheduler
ci/lib/scheduler.ts - Test-case curation
scripts/test-cases/append-test-cases-to-suite.ts - Azure App Insights
Performance QA
- Load-test scenarios
plugins/vc-perf/skills/perf-loadtest/loadtests/scenarios - Trace analysis
plugins/vc-perf/skills/perf-trace/perftools - Benchmark comparison
plugins/vc-perf/skills/perf-benchmark/compare-reports.cs
Shared configuration
- Project profile
plugins/vc-fix/scripts/lib/project-profile.mjs - Environment config
config.js
Other components
- QA operator
- Virto Commerce platform
Connections 24
- QA operator → Project onboarding: onboards project
README.md - Project onboarding → Project profile: writes profile
README.md - Project onboarding → Environment config: writes environment
README.md - QA operator → Bug reproduction: reports issue
README.md - Bug reproduction → Tracker adapters: files bug
README.md - Bug reproduction → Repository routing: routes fix
README.md - Repository routing → Project profile: loads routing data
plugins/vc-fix/skills/qa-fix-routing/repo-router.ts - Autonomous fix → Repository routing: selects repository
plugins/vc-fix/skills/qa-fix-routing/repo-router.ts - Autonomous fix → Code-host adapters: contributes changes
README.md - Autonomous fix → Tracker adapters: updates bug
README.md - QA operator → Autonomous fix: requests fix
README.md - QA operator → Fix verification: requests verification
README.md - Fix verification → Tracker adapters: transitions ticket
README.md - QA operator → Bug monitoring: requests monitoring
README.md - Monitoring runner → App Insights client: queries telemetry
ci/run-monitor.ts - Monitoring runner → Signal fingerprints: records signals
ci/run-monitor.ts - Bug monitoring → Azure App Insights: queries telemetry
README.md - Regression runner → Suite selection: resolves suites
ci/run-regression.ts - Regression runner → Lane scheduler: schedules lanes
ci/run-regression.ts - QA operator → Regression runner: runs regression
README.md - Test-case curation → Regression runner: supplies suite cases
ci/run-regression.ts - QA operator → Load-test scenarios: runs load test
- Load-test scenarios → Virto Commerce platform: generates workload
- Trace analysis → Benchmark comparison: informs analysis