@zhiweiliu/playwright-generator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhiwei Liu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,344 @@
+# Playwright LLM Test Case Generator
+
+This module streamlines the generation of Playwright test cases by integrating with Large Language Models. While there are many AI-based test frameworks that allow test cases to be written in natural language, the following drawbacks are commonly found with these approaches.
+
+## Table of Contents
+
+- [Drawbacks of Current AI-Based Test Frameworks](#drawbacks-of-current-ai-based-test-frameworks)
+- [Why Playwright + AI Test Case Generator?](#why-playwright--ai-test-case-generator)
+- [Features](#features)
+- [Prerequisites](#prerequisites)
+- [Installation & Quick Start](#installation--quick-start)
+- [Project Structure](#project-structure)
+- [Configuration](#configuration)
+  - [Environment Variables (.env)](#environment-variables-env)
+  - [Preset Test Framework](#preset-test-framework)
+  - [Test Cases Written in Natural Language](#test-cases-written-in-natural-language)
+  - [Generation](#generation)
+  - [Test Results & Reporting](#test-results--reporting)
+  - [Execution and Debugging](#execution-and-debugging)
+  - [Advanced Features](#advanced-features)
+  - [CI/CD Integration](#cicd-integration)
+  - [Best Practices](#best-practices)
+  - [Troubleshooting](#troubleshooting)
+  - [GitHub Integration](#github-integration)
+- [Contributing](#contributing)
+  - [Development Setup](#development-setup)
+- [License](#license)
+- [Support](#support)
+
+## Drawbacks of Current AI-Based Test Frameworks
+
+1. **Lack of Precision and Accuracy**: AI-generated tests may not accurately capture complex user interactions, edge cases, or application-specific logic, leading to false positives or missed bugs.
+
+2. **Maintenance Overhead**: As applications evolve, AI-generated tests often require manual updates and refactoring, negating some of the time-saving benefits.
+
+3. **Reliability Issues**: Large Language Models can hallucinate or generate incorrect test logic, especially for dynamic web applications with complex state management.
+
+4. **Limited Integration**: Many AI-based frameworks lack seamless integration with existing CI/CD pipelines, version control systems, and testing infrastructure.
+
+5. **Cost and Resource Intensity**: Frequent API calls to LLM services can become expensive, and there's a dependency on external services that may have rate limits or downtime.
+
+6. **Security Concerns**: Sharing application details with external AI services raises potential security risks, especially for proprietary or sensitive codebases.
+
+## Why Playwright + AI Test Case Generator?
+
+Playwright combined with AI offers a powerful solution that addresses these drawbacks:
+
+1. **Robust Web Testing Foundation**: Playwright provides a reliable, battle-tested framework for end-to-end web testing, handling modern web applications with features like auto-waiting, network interception, and cross-browser support.
+
+2. **Enhanced Test Generation**: AI integration allows for natural language test case descriptions, accelerating test creation while maintaining the precision and reliability of Playwright's code generation.
+
+3. **Maintainable Code**: Generated Playwright tests are actual code that can be easily reviewed, modified, and maintained by developers, unlike some AI frameworks that produce abstract test descriptions.
+
+4. **Seamless Integration**: Playwright integrates well with existing development workflows, CI/CD pipelines, and can be enhanced with AI without compromising existing infrastructure.
+
+5. **Cost-Effective**: By generating high-quality Playwright code upfront, this approach reduces the need for continuous AI API calls during test maintenance and execution.
+
+6. **Security-First**: The AI integration can be implemented with local models or controlled API usage, minimizing security risks associated with external AI services.
+
+## Features
+
+This project implements an npx command in TypeScript and is released as an NPM module `@zhiweiliu/playwright-generator`. After installing the command, you can easily set up a Playwright framework with AI support by running a command.
+
+```bash
+npx playwright-generator init
+```
+
+The installed module will have amazing features to facilitate your day-to-day test automation tasks.
+
+## Prerequisites
+
+- **Node.js**: Version 16.0 or higher
+- **npm**: Version 7.0 or higher
+- **Git**: For version control integration
+- **LLM API Access** (optional): Depending on your AI model choice
+  - Copilot: GitHub Copilot API credentials
+  - Claude: Anthropic API key
+
+## Installation & Quick Start
+
+1. **Install the generator**:
+
+   ```bash
+   npm install -g @zhiweiliu/playwright-generator
+   ```
+
+2. **Initialize a new project**:
+
+   ```bash
+   npx playwright-generator init
+   ```
+
+3. **Configure your environment**:
+
+   ```bash
+   cp .env.example .env
+   # Edit .env with your API credentials
+   ```
+
+4. **Write your first test case** in the `tests/` folder
+
+5. **Generate Playwright code**:
+   ```bash
+   npx playwright-generator generate --tc TC-0001
+   ```
+
+## Project Structure
+
+```
+project-root/
+├── tests/                    # Natural language test cases
+│   └── *.test.md
+├── generated/                # Generated Playwright test code
+│   └── generated.test.ts
+├── page-objects/             # Page Object Models (optional)
+│   └── *.po.ts
+├── utils/                    # Helper utilities
+│   └── *.ts
+├── audit/                    # Screenshots and artifacts from failed tests
+│   └── screenshots/
+├── .env                      # Environment variables (local only, ignored by Git)
+├── .env.example              # Example environment file
+├── playwright.config.ts      # Playwright configuration
+└── package.json
+
+```
+
+## Configuration
+
+### Environment Variables (.env)
+
+```env
+# AI Model Configuration
+AI_MODEL=copilot                    # Options: copilot, claude
+COPILOT_API_KEY=your_key_here       # Required if using Copilot
+CLAUDE_API_KEY=your_key_here        # Required if using Claude
+
+# Playwright Configuration
+BROWSER=chromium                    # Options: chromium, firefox, webkit
+HEADLESS=true                       # Run in headless mode
+BASE_URL=http://localhost:3000      # Application under test URL
+
+# Execution Configuration
+TIMEOUT=30000                       # Test timeout in milliseconds
+RETRIES=1                           # Number of retries on failure
+```
+
+### Preset Test Framework
+
+- A fully working Playwright test automation framework is already set up
+
+### Test Cases Written in Natural Language
+
+- Test cases are stored in the `tests/` folder under the project root using `.test.md` files
+- Tags with format `[TAG-NAME]` can be applied to natural language test cases to allow grouping and running related tests
+- Each test case must have a unique ID tag in format `[TC-xxxx]` (e.g., `[TC-0001]`), which enables running specific test cases
+- You can specify an output file in the `generated/` folder; otherwise, generated code will output to `generated.test.ts`
+- Natural language descriptions should be clear and specific to improve AI-generated code quality
+
+**Example Test Case File (tests/login.test.md)**:
+
+```
+[TC-0001] [SMOKE] [LOGIN]
+User logs in with valid credentials
+Given the user is on the login page
+When the user enters valid username and password
+And clicks the login button
+Then the user should be redirected to the dashboard
+```
+
+### Generation
+
+Playwright test automation code is generated by running a command, with generated code placed in the `generated/` folder under the project root.
+
+- Generated Playwright code is in TypeScript
+- The test case ID tag must be specified with the generation command, allowing generation of one test case at a time
+- If an output file is specified, the command will either append the generated test case to the file or update it if it already exists
+- If no output file is specified, the command will either append to `generated.test.ts` or update the test case if it exists
+- The following AI models are supported (specify with generation command; Copilot is used by default):
+  - **Copilot**: GitHub Copilot API
+  - **Claude**: Anthropic Claude API
+- Credentials (LLM API keys, usernames, passwords) are retrieved from environment variables in the `.env` file for local development; the `.env` file should be ignored by Git
+
+**Generation Commands**:
+
+```bash
+# Generate with default model (Copilot)
+npx playwright-generator generate --tc TC-0001
+
+# Generate with specific model
+npx playwright-generator generate --tc TC-0001 --model claude
+
+# Generate to specific output file
+npx playwright-generator generate --tc TC-0001 --output login.test.ts
+
+# Generate multiple test cases
+npx playwright-generator generate --tc TC-0001,TC-0002,TC-0003
+```
+
+### Test Results & Reporting
+
+- Test execution produces detailed reports with pass/fail status
+- HTML reports are generated in the `reports/` folder
+- Screenshots for failed test cases are automatically captured and stored in the `audit/` folder
+- Videos for failed test cases can be captured (disabled by default; enable with `--video` option)
+- Test results can be exported in multiple formats (JSON, XML, HTML)
+- Audit artifacts help with debugging and root cause analysis of test failures
+
+### Execution and Debugging
+
+Various npm scripts are provided to run and debug Playwright test cases.
+
+**Available Commands**:
+
+```bash
+# Run all tests
+npm test
+
+# Run tests by specific tag
+npm run test:tag -- --tag SMOKE
+
+# Run a specific test case
+npm run test:case -- --tc TC-0001
+
+# Debug mode (opens inspector)
+npm run test:debug -- --tag SMOKE
+
+# Run tests in headed mode (see browser UI)
+npm run test:headed
+
+# Run tests with specific browser
+npm run test:browser -- --browser firefox
+
+# Run tests with video recording enabled for failed cases
+npm test -- --video on-failure
+
+# Generate HTML report
+npm run report
+```
+
+### Advanced Features
+
+**Page Object Models (POM)**:
+
+- Create reusable page objects in the `page-objects/` folder to improve test maintainability
+- Example: `page-objects/login.po.ts` for login page interactions
+- Reference page objects in your natural language test cases for better structure
+
+**Test Utilities**:
+
+- Helper functions available in `utils/` for common operations (wait strategies, error handling, etc.)
+- Custom assertions and reporters can be added for specialized testing needs
+
+**Parallel Execution**:
+
+- Configure parallel test execution in `playwright.config.ts`
+- Default: runs 4 tests in parallel
+- Adjust with `fullyParallel` and `workers` settings
+
+**Cross-Browser Testing**:
+
+- Configure browsers in `playwright.config.ts`
+- Default: Chromium
+- Supported: Chromium, Firefox, WebKit
+
+### CI/CD Integration
+
+GitHub Actions workflow files are created to run Playwright tests automatically:
+
+- **On merge to main**: Runs full test suite
+- **Scheduled daily**: Runs at midnight UTC every day
+- **On-demand**: Manual trigger available in GitHub Actions UI
+
+Workflow file location: `.github/workflows/playwright-tests.yml`
+
+### Best Practices
+
+1. **Test Case Naming**: Use clear, descriptive names that explain what is being tested
+2. **Tags Strategy**: Organize tests with tags (SMOKE, REGRESSION, SANITY, etc.)
+3. **AI Prompting**: Write natural language descriptions with:
+   - Given-When-Then format for clarity
+   - Specific selectors or UI elements mentioned
+   - Expected outcomes clearly stated
+4. **Code Review**: Always review generated code before committing
+5. **Page Objects**: Use POM for maintainability as your test suite grows
+6. **Assertions**: Be explicit about what you're asserting
+7. **Wait Strategies**: Use Playwright's built-in auto-waiting; avoid hardcoded waits
+
+### Troubleshooting
+
+**Common Issues**:
+
+| Issue                               | Solution                                                                              |
+| ----------------------------------- | ------------------------------------------------------------------------------------- |
+| `API key not found`                 | Verify `.env` file exists and `COPILOT_API_KEY` or `CLAUDE_API_KEY` is set            |
+| `Tests timing out`                  | Increase `TIMEOUT` in `.env` or use explicit waits in test cases                      |
+| `Generated code doesn't compile`    | Review the natural language description for clarity; regenerate with a refined prompt |
+| `Tests pass locally but fail in CI` | Check `BASE_URL` environment variable and add debugging with screenshots              |
+| `Selector not found`                | Ensure selectors are unique and reference current UI state                            |
+
+### GitHub Integration
+
+- GitHub Actions workflows automatically run Playwright tests when code is merged to the main branch
+- Tests also run on a scheduled basis (daily at midnight UTC)
+- Workflow status badges can be added to the README to display test status
+
+## Contributing
+
+Contributions are welcome! Please follow these guidelines:
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes and write tests
+4. Commit with clear messages: `git commit -m "Add feature: description"`
+5. Push to your fork and submit a Pull Request
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/playwright-generator.git
+cd playwright-generator
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+```
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Support
+
+For issues, questions, or suggestions, please open an issue on GitHub or contact the maintainers.
+
+---
+
+**Happy Testing! 🎭**

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const generate_1 = require("./commands/generate");
+const chalk_1 = __importDefault(require("chalk"));
+const program = new commander_1.Command();
+program
+    .name("playwright-generator")
+    .description("Generate Playwright test cases from natural language using LLM")
+    .version("1.0.0");
+// Init command
+program
+    .command("init [projectPath]")
+    .description("Initialize a new Playwright test project")
+    .action(async (projectPath) => {
+    const targetPath = projectPath || process.cwd();
+    try {
+        await (0, init_1.initializeProject)(targetPath);
+    }
+    catch (error) {
+        process.exit(1);
+    }
+});
+// Generate command
+program
+    .command("generate")
+    .description("Generate Playwright test code from natural language test cases")
+    .option("-tc, --tc <testCaseIds>", "Comma-separated test case IDs (e.g., TC-0001,TC-0002)")
+    .option("-m, --model <model>", "LLM model to use (copilot or claude)", "copilot")
+    .option("-o, --output <outputFile>", "Output file name (relative to generated/ folder)")
+    .action(async (options) => {
+    try {
+        if (!options.tc) {
+            console.error(chalk_1.default.red("Error: Test case IDs are required"));
+            console.log("Usage: playwright-generator generate --tc TC-0001 [--tc TC-0002 ...]");
+            process.exit(1);
+        }
+        const testCaseIds = options.tc.split(",").map((id) => id.trim());
+        const projectRoot = process.cwd();
+        await (0, generate_1.generateTestCode)(projectRoot, {
+            testCaseIds,
+            model: options.model,
+            outputFile: options.output,
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("Generation failed"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+// Help for test case format
+program
+    .command("help:testcases")
+    .description("Show help about test case format")
+    .action(() => {
+    console.log(chalk_1.default.cyan(`
+Test Case Format
+================
+
+Test cases should be written in Markdown format in the tests/ directory.
+File name: *.test.md
+
+Format:
+-------
+# [TC-XXXX] [TAG1] [TAG2]
+
+## Test: Clear description of what is being tested
+
+Given the initial state or precondition
+When the user performs an action
+And additional actions
+Then expected result should occur
+And another expected result
+
+Example:
+--------
+# [TC-0001] [SMOKE] [LOGIN]
+
+## Test: User logs in with valid credentials
+
+Given the user is on the login page
+When the user enters username and password
+And clicks the login button
+Then the user should see the dashboard
+And the welcome message should contain the user name
+
+Tags:
+-----
+- [TC-XXXX] - Required: Unique test case identifier
+- [TAG-NAME] - Optional: Tag for grouping tests (SMOKE, REGRESSION, etc.)
+
+Tips for better AI-generated code:
+----------------------------------
+1. Use clear, specific language
+2. Mention element types (button, input, link, etc.)
+3. Include exact text or identifiers when possible
+4. Use Given-When-Then structure for clarity
+5. Keep test cases focused on one feature
+6. Review generated code before committing
+    `));
+});
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AAEpC,0CAAoD;AACpD,kDAAuD;AACvD,kDAA0B;AAE1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,sBAAsB,CAAC;KAC5B,WAAW,CAAC,gEAAgE,CAAC;KAC7E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,oBAAoB,CAAC;KAC7B,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;IAC5B,MAAM,UAAU,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,IAAA,wBAAiB,EAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mBAAmB;AACnB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CACL,yBAAyB,EACzB,uDAAuD,CACxD;KACA,MAAM,CACL,qBAAqB,EACrB,sCAAsC,EACtC,SAAS,CACV;KACA,MAAM,CACL,2BAA2B,EAC3B,kDAAkD,CACnD;KACA,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAElC,MAAM,IAAA,2BAAgB,EAAC,WAAW,EAAE;YAClC,WAAW;YACX,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,MAAM;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAC9B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,4BAA4B;AAC5B,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4CZ,CAAC,CACD,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,7 @@
+export interface GenerateOptions {
+    testCaseIds?: string[];
+    model?: "copilot" | "claude";
+    outputFile?: string;
+}
+export declare function generateTestCode(projectRoot: string, options: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Ff"}

package/dist/commands/generate.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestCode = generateTestCode;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const glob_1 = require("glob");
+const chalk_1 = __importDefault(require("chalk"));
+const llm_1 = require("../llm");
+async function generateTestCode(projectRoot, options) {
+    try {
+        if (!options.testCaseIds || options.testCaseIds.length === 0) {
+            throw new Error("Please specify at least one test case ID with --tc flag");
+        }
+        const llmProvider = llm_1.LLMFactory.createProvider();
+        // Validate LLM connection
+        console.log(chalk_1.default.blue("Validating LLM connection..."));
+        const isConnected = await llmProvider.validateConnection();
+        if (!isConnected) {
+            console.warn(chalk_1.default.yellow("⚠ Warning: Could not validate LLM connection"));
+        }
+        else {
+            console.log(chalk_1.default.green("✓ LLM connection validated"));
+        }
+        const testsDir = path_1.default.join(projectRoot, "tests");
+        const generatedDir = path_1.default.join(projectRoot, "generated");
+        // Ensure generated directory exists
+        await fs_extra_1.default.ensureDir(generatedDir);
+        let outputFilePath = options.outputFile
+            ? path_1.default.join(generatedDir, options.outputFile)
+            : path_1.default.join(generatedDir, "generated.test.ts");
+        // Ensure output file exists with imports if it's new
+        if (!fs_extra_1.default.existsSync(outputFilePath)) {
+            const header = `import { test, expect } from '@playwright/test';\n\n`;
+            await fs_extra_1.default.writeFile(outputFilePath, header);
+        }
+        for (const testCaseId of options.testCaseIds) {
+            console.log(chalk_1.default.blue(`\\nGenerating test case: ${testCaseId}...`));
+            // Find the test case file
+            const testCaseFile = await findTestCaseFile(testsDir, testCaseId);
+            if (!testCaseFile) {
+                console.error(chalk_1.default.red(`✗ Test case file not found for: ${testCaseId}`));
+                continue;
+            }
+            console.log(chalk_1.default.gray(`Found: ${path_1.default.relative(projectRoot, testCaseFile)}`));
+            // Read test case content
+            const testCaseContent = await fs_extra_1.default.readFile(testCaseFile, "utf-8");
+            // Extract tags
+            const tags = extractTags(testCaseContent);
+            // Create LLM prompt
+            const prompt = {
+                testCase: testCaseContent,
+                testCaseId: testCaseId,
+                tags: tags,
+            };
+            // Generate code
+            const generatedCode = await llmProvider.generateTestCode(prompt);
+            // Append to output file
+            await appendTestCodeToFile(outputFilePath, generatedCode.code, testCaseId);
+            console.log(chalk_1.default.green(`✓ Generated test case: ${testCaseId}`));
+        }
+        console.log(chalk_1.default.green.bold(`\\n✓ Code generation completed!`));
+        console.log(chalk_1.default.cyan(`Generated file: ${path_1.default.relative(projectRoot, outputFilePath)}`));
+        console.log(chalk_1.default.cyan("Next: Review the generated code and run: npm test"));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("Error generating test code:"), error);
+        throw error;
+    }
+}
+async function findTestCaseFile(testsDir, testCaseId) {
+    try {
+        const files = await (0, glob_1.glob)(path_1.default.join(testsDir, "**/*.test.md"));
+        for (const file of files) {
+            const content = await fs_extra_1.default.readFile(file, "utf-8");
+            if (content.includes(`[${testCaseId}]`)) {
+                return file;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        console.error("Error finding test case file:", error);
+        return null;
+    }
+}
+function extractTags(testCaseContent) {
+    const tagRegex = /\[([A-Z0-9\-]+)\]/g;
+    const matches = testCaseContent.match(tagRegex) || [];
+    return matches.map((tag) => tag.slice(1, -1)).filter((tag) => tag.length > 0);
+}
+async function appendTestCodeToFile(filePath, generatedCode, testCaseId) {
+    let currentContent = await fs_extra_1.default.readFile(filePath, "utf-8");
+    // Check if test case already exists
+    const testCaseRegex = new RegExp(`test\\(['\`"].*?${testCaseId}.*?['\`"].*?\\)\\s*=>\\s*{[^}]*}`, "s");
+    if (testCaseRegex.test(currentContent)) {
+        // Replace existing test case
+        const updatedContent = currentContent.replace(testCaseRegex, generatedCode);
+        await fs_extra_1.default.writeFile(filePath, updatedContent);
+    }
+    else {
+        // Append new test case
+        const code = generatedCode.trim();
+        if (!currentContent.endsWith("\\n\\n")) {
+            currentContent += "\\n\\n";
+        }
+        currentContent += code + "\\n";
+        await fs_extra_1.default.writeFile(filePath, currentContent);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":";;;;;AAaA,4CAgGC;AA7GD,gDAAwB;AACxB,wDAA0B;AAC1B,+BAA4B;AAC5B,kDAA0B;AAC1B,gCAAoC;AAS7B,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,OAAwB;IAExB,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,gBAAU,CAAC,cAAc,EAAE,CAAC;QAEhD,0BAA0B;QAC1B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,kBAAkB,EAAE,CAAC;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CACV,eAAK,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAC7D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAEzD,oCAAoC;QACpC,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEjC,IAAI,cAAc,GAAG,OAAO,CAAC,UAAU;YACrC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC;YAC7C,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;QAEjD,qDAAqD;QACrD,IAAI,CAAC,kBAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,sDAAsD,CAAC;YACtE,MAAM,kBAAE,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4BAA4B,UAAU,KAAK,CAAC,CAAC,CAAC;YAErE,0BAA0B;YAC1B,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAElE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAC3D,CAAC;gBACF,SAAS;YACX,CAAC;YAED,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,UAAU,cAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,CACjE,CAAC;YAEF,yBAAyB;YACzB,MAAM,eAAe,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAEjE,eAAe;YACf,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;YAE1C,oBAAoB;YACpB,MAAM,MAAM,GAAc;gBACxB,QAAQ,EAAE,eAAe;gBACzB,UAAU,EAAE,UAAU;gBACtB,IAAI,EAAE,IAAI;aACX,CAAC;YAEF,gBAAgB;YAChB,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAEjE,wBAAwB;YACxB,MAAM,oBAAoB,CACxB,cAAc,EACd,aAAa,CAAC,IAAI,EAClB,UAAU,CACX,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,mBAAmB,cAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAChE,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAChE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAgB,EAChB,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAA,WAAI,EAAC,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,eAAuB;IAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IACtC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,QAAgB,EAChB,aAAqB,EACrB,UAAkB;IAElB,IAAI,cAAc,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1D,oCAAoC;IACpC,MAAM,aAAa,GAAG,IAAI,MAAM,CAC9B,mBAAmB,UAAU,kCAAkC,EAC/D,GAAG,CACJ,CAAC;IAEF,IAAI,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACvC,6BAA6B;QAC7B,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC5E,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,uBAAuB;QACvB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,cAAc,IAAI,QAAQ,CAAC;QAC7B,CAAC;QACD,cAAc,IAAI,IAAI,GAAG,KAAK,CAAC;QAC/B,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initializeProject(projectPath: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2M1E"}