Automation Script Generator MCP Server

# Automation Script Generator ## 🚀 Project Mission: Hybrid AI Automation Framework (Notion -> Playwright) This project creates an autonomous end-to-end testing framework that bridges the gap between manual test case management and automated execution. It leverages Generative AI to automatically generate robust Playwright test scripts from Notion test tickets. ## 🎯 Objectives 1. **Read**: Fetch test scenarios directly from a Notion Database. 2. **Generate**: Create executable Playwright (TypeScript) scripts automatically using **Google Gemini**. 3. **Execute**: Run tests with a "Self-Healing" mechanism for resilient locators. 4. **Report**: Generate detailed reports via Allure and reflect status updates back to Notion. ## 🛠️ Tech Stack * **Language**: TypeScript, Node.js (v20+) * **Framework**: [Playwright](https://playwright.dev/) * **AI Model**: Google Gemini (`gemini-2.0-flash` via `@google/genai` SDK) * **Integration**: Notion API (`@notionhq/client`) * **Reporting**: Allure Report ## 📂 Directory Structure ```text / ├── .agent/rules/ # Antigravity context rules ├── config/ # Configuration files │ └── notion.config.ts # Notion API keys and DB IDs ├── src/ │ ├── generator/ # THE BUILDER │ │ ├── fetcher.ts # Pulls from Notion │ │ ├── translator.ts # Gemini Agent (Notion -> TS Code) │ │ └── writer.ts # Saves .spec.ts files │ ├── framework/ # THE RUNNER │ │ ├── pages/ # Page Objects (POM) │ │ └── actions/ # Self-healing wrappers │ └── tests/ # Generated Spec files live here ├── playwright.config.ts ├── .env # Contains API Keys └── package.json ``` ## ⚙️ Setup & Installation 1. **Clone the repository:** ```bash git clone <repository-url> cd automation-script-generator ``` 2. **Install dependencies:** ```bash npm install ``` 3. **Environment Configuration:** Create a `.env` file in the root directory and add your keys: ```env GEMINI_API_KEY=your_google_gemini_api_key NOTION_TOKEN=your_notion_integration_token NOTION_DATABASE_ID=your_notion_database_id ``` ## 🏃 Usage ### 1. Generate Tests To fetch "Ready for Automation" tickets from Notion and generate Playwright test files with **strict Page Object Model separation**: ```bash npx ts-node src/generator/main.ts ``` * **Artifacts**: * `src/framework/pages/*.page.ts`: Page Objects (private selectors, public methods). * `src/tests/[module]/[module].data.ts`: Shared test data per module. * `src/tests/[module]/[id]...spec.ts`: Clean test specs. ### 2. Run Tests To execute the generated Playwright tests: ```bash npm test ``` * **Video**: Recorded for ALL runs (available in Allure report). * **Screenshots**: Captured only on failure. ### 3. View Reports To generate and view the Allure test report: ```bash npm run test:report # Generates report (cleans old results) npm run test:open # Opens report in browser ``` ## 🧠 Smart Actions (Self-Healing) The framework includes a `SmartPage` wrapper that handles flaky selectors. If a primary selector fails, it attempts to "heal" by using fallback strategies (like text hints) and logs the event, preventing brittle test failures.