Architecture

Architecture

LangGraph orchestrator + Playwright + optional Rust diff. Deep: architecture.md.

GitHub / local specs / NL
        │
        ▼
LangGraph: fetch → discover → gap_analyze → parse → generate → execute
        → regression → api_validate → log_analyze → v8_coverage
        │
   pass → report → notify
   fail → analyze → autofix → apply_autofix → re-execute (≤ retries)

Layers

Layer	Language	Location
Orchestrator + agents	Python	orchestrator/, agents/, github_integration/
Test execution	TypeScript	playwright/, tests/
Screenshot diff (optional)	Rust	rust/ → zyvor-diff

Pipeline nodes (abbrev.)

Node	Role
fetch	Local/GitHub specs, issues, discovery files
discover / gap_analyze	Coverage inventory vs existing tests
parse	Spec → Requirement (LLM or rules)
generate	.spec.ts into tests/generated/ (quality gate → Jinja fallback)
execute	Playwright on tests/manual/ + generated
regression	Pixel vs screenshots/baselines/
api_validate / log_analyze / v8_coverage	Optional / always-on log noise filter
analyze / autofix / apply_autofix	Fail branch self-heal
report / notify	HTML/PDF + Slack/Teams/email/PR comment

Design notes

• Cursor is a development assistant only — not a runtime dependency
• LLM optional: rule/template fallbacks everywhere except zyvor-qa create
• State: PipelineState TypedDict in orchestrator/state.py

See also Autofix and Regression · Configuration.