# liquio-qa-bot

A headless QA automation service for Liquio environments. Exposes an **MCP (Model Context Protocol)** server that lets AI agents define, run, and monitor multi-step browser test scenarios using [Playwright](https://playwright.dev/).

---

## Overview

The bot manages four core concepts:

| Concept | Description |
|---|---|
| **Environment** | A named set of URLs for a deployment target (e.g. `liquio-diia-stg`) |
| **Key** | A JSON descriptor in `keys/` that points to an EDS key file + password |
| **Session** | Saved browser state (cookies + localStorage) produced by a login |
| **Scenario** | An ordered list of steps that run in sequence against a shared browser instance |

---

## Architecture

See [docs/architecture.md](docs/architecture.md).

---

## Key descriptors

See [docs/key-descriptors.md](docs/key-descriptors.md).

---

## MCP tools

See [docs/mcp.md](docs/mcp.md).

---

## Scenario execution

See [docs/scenario.md](docs/scenario.md).

---

## Development

See [docs/development.md](docs/development.md) for setup, running, testing, linting, and Docker instructions.