agents-cli-automation 1.0.6 → 1.0.7

package/README.md

@@ -23,30 +23,47 @@ npx agents init
 
 ## Quick Start
 
-Run the setup command and select your testing type:
+Run the setup command and follow the interactive prompts:
 ```bash
 npx agents-cli-automation init
 ```
 
-Choose from:
-1. **Playwright Setup for UI Testing** - Browser automation, E2E tests, component testing
-2. **Playwright Setup for API Testing** - REST API tests, integration testing, backend validation
+### Step 1: Select Framework Type
+Choose your testing type:
+1. **Playwright UI Testing** - Browser automation, E2E tests, component testing
+2. **Playwright API Testing** - REST API tests, integration testing, backend validation
 
-Follow the interactive prompts and your agent will be generated!
+### Step 2: Select Your Language (for UI Testing)
+Choose your preferred language:
+- **TypeScript** (Recommended) - Latest & Type Safe
+- **JavaScript** - ES Modules, modern syntax
+- **Java** - Maven + JUnit5
+- **C#** - NUnit + .NET
+
+Your scalable, production-ready framework will be generated automatically!
 
 ## Available Agents
 
-### 📊 Playwright Setup for UI Testing
-Creates a production-ready Playwright framework for UI automation with:
-- ✅ Complete UI test project structure
-- ✅ UI, component, and E2E testing templates
-- ✅ Fixture configurations
-- ✅ WebServer setup for local development
-- ✅ All npm scripts configured
-- ✅ Sample tests with SauceDemo credentials
-- ✅ Headed and headless test modes
-
-### 🔌 Playwright Setup for API Testing
+### 📊 Playwright UI Testing Framework
+Creates a production-ready Playwright framework for UI automation with support for **TypeScript, JavaScript, Java, and C#**.
+
+**Core Features:**
+- ✅ **Page Object Model (POM)** - Reusable page classes with best practices
+- ✅ **Fixtures & Setup** - Built-in browser lifecycle management
+- ✅ **Parallel Execution** - Run tests simultaneously (4 workers by default)
+- ✅ **Chromium Only** - Single browser for consistency and speed
+- ✅ **Test Data Readers** - Support for JSON, CSV, and YAML files
+- ✅ **Form Helpers** - Handle dropdowns, radio buttons, checkboxes, text inputs
+- ✅ **BDD Support** - Cucumber/Gherkin feature files for scenario-based testing
+- ✅ **Latest APIs** - Uses latest Playwright versions with full type safety
+
+**Language Options:**
+- **TypeScript** - Full tsconfig with strict mode and path aliases (@pages/@utils/@fixtures/@data)
+- **JavaScript** - ES Modules with modern syntax (no build step required)
+- **Java** - Maven-based structure with JUnit 5 and all dependencies
+- **C#** - .NET 8 with NUnit and async/await patterns
+
+### 🔌 Playwright API Testing
 Creates a production-ready Playwright framework for API automation with:
 - ✅ Complete API test project structure
 - ✅ REST API request handling
@@ -60,46 +77,112 @@ The generated agent will include everything you need to start automating tests i
 
 ## What Gets Created
 
-When you run `agents init`, a `.github/agents` directory is created in your project with one of these files:
-
-### For UI Testing
-- `playwright-ui-testing-agent.md` - Complete UI framework setup
-  - WebServer configuration
-  - Sample UI tests with SauceDemo
-  - Fixture setup
-  - Headed and headless modes
-  - Visual regression ready
+When you run `agents init`, a `.github/agents` directory is created in your project with language-specific framework files.
+
+### For UI Testing (Choose Your Language)
+
+**TypeScript**
+- `playwright-ui-testing-typescript-agent.md`
+  - Complete TypeScript framework with strict type checking
+  - tsconfig.json with path aliases
+  - Full type definitions for all utilities
+  - ES2020 module syntax
+
+**JavaScript**
+- `playwright-ui-testing-javascript-es-modules-agent.md`
+  - Modern ES Modules syntax (Node.js 18+)
+  - No build step required
+  - Same features as TypeScript without type annotations
+
+**Java**
+- `playwright-ui-testing-java-agent.md`
+  - Maven-based project structure
+  - JUnit 5 test framework
+  - Complete pom.xml with all dependencies
+  - Maven parallel execution support
+
+**C#**
+- `playwright-ui-testing-c#-agent.md`
+  - .NET 8+ project structure
+  - NUnit test framework
+  - Complete .csproj configuration
+  - Async/await patterns throughout
 
 ### For API Testing
 - `playwright-api-testing-agent.md` - Complete API framework setup
-  - REST API examples (GET, POST, etc.)
-  - Response validation
-  - Authentication fixtures
-  - Database integration helpers
-  - CI/CD ready configuration
-
-Each agent file includes:
-- Full setup instructions
-- Working sample tests
-- Verification checklist
-- Best practices
-- Environment configuration
-- Ready-to-use code snippets
+
+## Framework Structure (All Languages)
+
+Each generated framework includes:
+
+**📂 Project Structure**
+```
+framework/
+├── pages/               # Page Object Model classes
+├── utils/              # DataReader, FormHelper, TestDataManager
+├── fixtures/           # Browser setup and fixtures
+├── tests/              # Test files
+├── features/           # Gherkin/BDD scenarios
+├── data/               # Test data (JSON, CSV, YAML)
+├── config files        # Language-specific (tsconfig.json, pom.xml, etc.)
+└── Sample tests        # Working examples ready to run
+```
+
+**✨ Included in Every Framework:**
+- Page Object Model classes with selectors
+- Form helpers for complex form interactions
+- Test data readers for JSON, CSV, YAML
+- BDD/Gherkin feature files
+- Browser fixtures with proper cleanup
+- Parallel execution configuration
+- Sample tests with SauceDemo app
+- Complete setup and run instructions
 
 ## Requirements
 
+### To Run CLI
 - Node.js 18+
 - npm or yarn
 
-## Need Help?
+### To Run Generated Frameworks
+
+**TypeScript & JavaScript:**
+- Node.js 18+
+- npm or yarn
+
+**Java:**
+- Java 11+
+- Maven 3.8+
+
+**C#:**
+- .NET 8 SDK
+- Visual Studio 2022 or VS Code with C# extension
+
+## Why Choose This Framework?
+
+✅ **Multi-Language Support** - Use TypeScript, JavaScript, Java, or C#
+✅ **Minimal Setup** - Fully scaffolded projects, developers focus on tests, not setup
+✅ **Page Object Model** - Reusable, maintainable test code patterns
+✅ **Scalable Architecture** - Ready for enterprise-grade test suites
+✅ **Parallel Execution** - Run tests faster across multiple workers
+✅ **BDD Ready** - Cucumber/Gherkin support for business-readable scenarios
+✅ **Test Data Management** - JSON, CSV, YAML support out of the box
+✅ **Form Helpers** - Handle complex forms, dropdowns, checkboxes easily
+✅ **Latest Playwright** - Always using cutting-edge Playwright features
+✅ **Production Ready** - Fixtures, proper cleanup, error handling included
+
+## Framework Quick Features
 
-Each generated agent file provides comprehensive guidance:
+Each generated framework provides:
 
 **For UI Testing:**
-- WebServer setup for local testing
-- SauceDemo test examples (login, add to cart)
-- How to replace with your own application
-- Debugging tips for browser tests
+- SauceDemo test examples (login, shopping cart)
+- Complete page objects with all selectors
+- Form interaction helpers for any element type
+- Test data loading from multiple formats
+- BDD scenario examples with step definitions
+- Parallel execution (4 workers by default)
+- Chromium-only for reliability
 
 **For API Testing:**
 - Writing GET, POST, PUT, DELETE tests

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-cli-automation",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Agents CLI",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -7,28 +7,64 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 export default async function initCommand() {
-  console.log("\n🚀 Agents CLI setup\n");
+  console.log("\n🚀 Agents CLI - Scalable Test Framework Setup\n");
 
   const { setup } = await inquirer.prompt([
     {
       type: "list",
       name: "setup",
-      message: "Select setup",
+      message: "Select framework setup",
       choices: [
-        "Playwright Setup for UI Testing",
-        "Playwright Setup for API Testing"
+        "Playwright UI Testing (Recommended)",
+        "Playwright API Testing"
       ]
     }
   ]);
 
-  if (setup === "Playwright Setup for UI Testing") {
-    // Template for UI testing
-    const templatePath = path.resolve(
-      __dirname,
-      "../templates/playwright-agent.md"
-    );
+  if (setup === "Playwright UI Testing (Recommended)") {
+    // Ask for language preference
+    const { language } = await inquirer.prompt([
+      {
+        type: "list",
+        name: "language",
+        message: "Select your preferred language",
+        choices: [
+          "TypeScript (Recommended - Latest & Type Safe)",
+          "JavaScript (ES Modules)",
+          "Java (Maven + JUnit)",
+          "C# (NUnit + .NET)"
+        ]
+      }
+    ]);
+
+    let templateFile;
+    let templateName;
+
+    if (language.includes("TypeScript")) {
+      templateFile = "playwright-agent-ts.md";
+      templateName = "TypeScript";
+    } else if (language.includes("JavaScript")) {
+      templateFile = "playwright-agent-js.md";
+      templateName = "JavaScript ES Modules";
+    } else if (language.includes("Java")) {
+      templateFile = "playwright-agent-java.md";
+      templateName = "Java";
+    } else if (language.includes("C#")) {
+      templateFile = "playwright-agent-csharp.md";
+      templateName = "C#";
+    }
 
-    // Target folder **inside the user's project**
+    const templatePath = path.resolve(__dirname, `../templates/${templateFile}`);
+
+    // Check if template exists
+    if (!fs.existsSync(templatePath)) {
+      console.error(
+        `\n❌ Template not found: ${templateFile}\n`
+      );
+      return;
+    }
+
+    // Target folder in user's project
     const userProjectRoot = process.cwd();
     const agentsDir = path.join(userProjectRoot, ".github", "agents");
 
@@ -36,15 +72,18 @@ export default async function initCommand() {
     await fs.ensureDir(agentsDir);
 
     // Save file with .agent extension
-    const destFile = path.join(agentsDir, "playwright-ui-testing-agent.md");
+    const fileName = `playwright-ui-testing-${templateName.toLowerCase().replace(/\s/g, "-")}-agent.md`;
+    const destFile = path.join(agentsDir, fileName);
 
     // Copy template content
     await fs.copyFile(templatePath, destFile);
 
-    console.log(`\n✅ Playwright UI Testing agent created at ${destFile}\n`);
+    console.log(`\n✅ Playwright UI Testing Framework created!`);
+    console.log(`📝 Language: ${templateName}`);
+    console.log(`📍 Location: ${destFile}\n`);
   }
 
-  if (setup === "Playwright Setup for API Testing") {
+  if (setup === "Playwright API Testing") {
     // Template for API testing
     const templatePath = path.resolve(
       __dirname,
@@ -67,5 +106,5 @@ export default async function initCommand() {
     console.log(`\n✅ Playwright API Testing agent created at ${destFile}\n`);
   }
 
-  console.log("Setup complete 🎉\n");
+  console.log("🎉 Setup complete!\n");
 }