Metadata-Version: 2.4
Name: qaos-agent
Version: 0.1.2
Summary: Quality Assurance Operating System — engine-agnostic, documentation-driven, AI-native QA platform
Author: QAOS Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/fahmi-zan/qa-agent-os
Project-URL: Repository, https://github.com/fahmi-zan/qa-agent-os
Project-URL: Documentation, https://github.com/fahmi-zan/qa-agent-os#readme
Keywords: qa,testing,automation,platform,ai
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: selenium
Requires-Dist: selenium>=4.0; extra == "selenium"
Provides-Extra: playwright
Requires-Dist: playwright>=1.40; extra == "playwright"
Provides-Extra: rest
Requires-Dist: requests>=2.0; extra == "rest"
Provides-Extra: report
Requires-Dist: jinja2>=3.0; extra == "report"
Provides-Extra: ai
Requires-Dist: openai>=1.0; extra == "ai"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Dynamic: license-file

# QAOS — Quality Assurance Operating System

Enterprise-grade, engine-agnostic QA platform. Not a test framework. Not a test repository.

QAOS is an operating system for Quality Assurance:

- **Documentation Driven** — blueprint and specifications are the contract.
- **Test Case First** — test cases are the source of truth; automation is generated from them.
- **AI Native** — ten specialized AI agents collaborate on QA work.
- **Multi Product / Multi Engine** — one platform, unlimited products, unlimited automation engines.
- **Engine Agnostic** — never coupled to Selenium, Playwright, Cypress, Appium, or any vendor technology.

```
Requirement → PRD → FSD → Scenario → Test Case → Automation → Execution → Report
```

If a requirement changes, the **test case changes first**. Automation is regenerated.

## Repository Structure

```
qaos/
  blueprint/        Architecture, principles, conventions, roadmap, governance
  specifications/   Contracts every artifact must obey
  knowledge/        Reusable, cross-project engineering knowledge
  agents/           AI agent definitions and system prompts
  templates/        Test case, page object, project scaffolding
  framework/        Engine-agnostic core (Python package)
  packages/         Optional shared packages
  adapters/         Engine adapters (Selenium, Playwright, REST, ...)
  cli/              qaos command-line interface
  docs/             User documentation
  examples/         Reference product integration
  docker/           Container definitions
  scripts/          Maintenance scripts
  integrations/     CI/CD platform integrations
```

## Quick Start

```bash
pip install qaos-agent      # install qaos CLI from PyPI
# or, isolated without global install:
pipx install qaos-agent

qaos doctor                 # verify platform health
qaos init my-product        # scaffold a new product workspace
qaos validate my-product    # validate test cases against specifications
qaos generate my-product    # emit pytest automation + page objects
qaos review my-product      # quality gates on locators and page code
qaos run my-product         # execute automation (--engine selenium|playwright|rest)
qaos report my-product      # generate reports
qaos migrate my-product --engine selenium   # switch primary engine
qaos explore my-product --prompt "testing pada login"   # AI: prompt -> test case
qaos analyze my-product     # failure analysis + flaky intelligence
```

> **Contributors / local dev:** clone the repo and run `pip install -e ".[dev]"` instead.

See [docs/quickstart.md](qaos/docs/quickstart.md) (complete usage guide)
and the canonical [blueprint](qaos/blueprint/README.md).

## License

MIT. See [LICENSE](LICENSE).
