@mseep/ai-tech-app-agent 1.0.0

package/logs/error.log

@@ -0,0 +1,50 @@
+{"level":"error","message":"Failed to initialize MCP server: Cannot connect to Appium server at http://localhost:4723: Error","service":"ai-test-runner","timestamp":"2025-11-30 22:10:29"}
+{"level":"error","message":"Failed to initialize MCP server: Cannot connect to Appium server at http://localhost:4723: Error","service":"ai-test-runner","timestamp":"2025-11-30 22:42:14"}
+{"level":"error","message":"Failed to get UI context: No active Appium session","service":"ai-test-runner","timestamp":"2025-11-30 22:44:49"}
+{"level":"error","message":"Failed to get UI context: No active Appium session","service":"ai-test-runner","timestamp":"2025-11-30 22:44:51"}
+{"level":"error","message":"Failed to get UI context: No active Appium session","service":"ai-test-runner","timestamp":"2025-11-30 22:44:53"}
+{"level":"error","message":"Screenshot failed: Request failed with status code 500","service":"ai-test-runner","timestamp":"2025-11-30 22:44:54"}
+{"level":"error","message":"Failed to initialize MCP server: Failed to create Appium session: Request failed with status code 500","service":"ai-test-runner","timestamp":"2025-11-30 22:46:34"}
+{"level":"error","message":"Session creation failed with status 500","service":"ai-test-runner","timestamp":"2025-11-30 22:48:06"}
+{"level":"error","message":"Session creation failed with status 500","service":"ai-test-runner","timestamp":"2025-11-30 22:49:00"}
+{"level":"error","message":"Test execution failed: Setup failed at step: Launch the DmgPro app","service":"ai-test-runner","timestamp":"2025-11-30 22:55:03"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:57:34"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:57:43"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:57:53"}
+{"level":"error","message":"Test failed at step: Click on 'Allow' if notifications dialog displayed","service":"ai-test-runner","timestamp":"2025-11-30 22:57:57"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:58:01"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:58:07"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 22:58:12"}
+{"level":"error","message":"Failed to initialize MCP server: Failed to create Appium session: timeout of 30000ms exceeded","service":"ai-test-runner","timestamp":"2025-11-30 23:00:09"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:02:26"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:02:33"}
+{"level":"error","message":"Test execution failed: Setup failed at step: Launch the DmgPro app","service":"ai-test-runner","timestamp":"2025-11-30 23:02:35"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:05:32"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:05:45"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:05:58"}
+{"level":"error","message":"Test failed at step: Click on 'Allow' if notifications dialog displayed","service":"ai-test-runner","timestamp":"2025-11-30 23:06:01"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:06:05"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:06:14"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-11-30 23:06:24"}
+{"level":"error","message":"Failed to initialize MCP server: Failed to create Appium session: timeout of 30000ms exceeded","service":"ai-test-runner","timestamp":"2025-12-01 01:55:39"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:17"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:23"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:28"}
+{"level":"error","message":"Test failed at step: Click on 'Get Started' button","service":"ai-test-runner","timestamp":"2025-12-01 01:58:30"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:38"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:47"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 01:58:56"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:02:33"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:02:41"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:02:50"}
+{"level":"error","message":"Test failed at step: Login with mobile number \"112233445\"","service":"ai-test-runner","timestamp":"2025-12-01 02:02:52"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:03:00"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:03:05"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:03:11"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:07:49"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:07:57"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:08:06"}
+{"level":"error","message":"Test failed at step: Input the mobile number \"112233445\" into the Phone Number input field","service":"ai-test-runner","timestamp":"2025-12-01 02:08:08"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:08:17"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:08:22"}
+{"level":"error","message":"Tap failed: Element not found","service":"ai-test-runner","timestamp":"2025-12-01 02:08:28"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@mseep/ai-tech-app-agent",
+  "version": "1.0.0",
+  "description": "AI-powered mobile test automation using MCP and LLM",
+  "main": "dist/index.js",
+  "bin": {
+    "ai-test-runner": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "npm run build && node dist/index.js run tests/nlp-specs",
+    "test:single": "npm run build && node dist/index.js run tests/nlp-specs/login-flow.yaml",
+    "test:knowledge": "npm run build && node dist/index.js run tests/nlp-specs/login-flow.yaml --knowledge knowledge/app-knowledge.txt --output reports/test-report.json",
+    "validate": "node dist/index.js validate tests/nlp-specs",
+    "health": "node dist/index.js health",
+    "check-services": "bash scripts/check-mcp-server.sh",
+    "start-mcp": "bash scripts/start-mcp-server.sh",
+    "setup": "node scripts/pre-test-setup.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/**/*.ts",
+    "prepublish": "npm run build"
+  },
+  "keywords": [
+    "mobile",
+    "automation",
+    "ai",
+    "mcp",
+    "llm",
+    "appium",
+    "testing",
+    "mseep",
+    "mcp-server"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "mcp-appium": "^1.0.0",
+    "axios": "^1.6.0",
+    "js-yaml": "^4.1.0",
+    "winston": "^3.11.0",
+    "dotenv": "^16.3.1",
+    "commander": "^11.1.0",
+    "allure-mocha": "^2.14.0",
+    "chai": "^4.3.10",
+    "fast-xml-parser": "^4.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/js-yaml": "^4.0.9",
+    "typescript": "^5.3.0",
+    "ts-node": "^10.9.2",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.54.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publisher": "mseep"
+}

package/reports/test-report.json

@@ -0,0 +1,106 @@
+{
+  "timestamp": "2025-11-30T20:38:31.008Z",
+  "summary": {
+    "total": 1,
+    "passed": 0,
+    "failed": 1,
+    "skipped": 0
+  },
+  "results": [
+    {
+      "specName": "Technician App Login Flow",
+      "status": "failed",
+      "duration": 104020,
+      "steps": [
+        {
+          "step": "Launch the DmgPro app",
+          "status": "passed",
+          "duration": 13851,
+          "actions": [
+            {
+              "type": "tap",
+              "selector": {
+                "strategy": "text",
+                "value": "Allow DMG Pro to send you notifications?"
+              },
+              "direction": null,
+              "assertionType": "exists",
+              "expectedValue": null
+            },
+            {
+              "type": "wait",
+              "selector": {
+                "strategy": "xpath",
+                "value": "//android.widget.Button[@id='com.android.permissioncontroller:id/permission_allow_button']"
+              },
+              "direction": null,
+              "assertionType": "enabled",
+              "expectedValue": null
+            },
+            {
+              "type": "tap",
+              "selector": {
+                "strategy": "text",
+                "value": "Allow"
+              },
+              "direction": null,
+              "assertionType": "exists",
+              "expectedValue": null
+            }
+          ]
+        },
+        {
+          "step": "Click on 'Allow' if notifications dialog displayed",
+          "status": "passed",
+          "duration": 9555,
+          "actions": [
+            {
+              "type": "wait",
+              "selector": {
+                "strategy": "exists",
+                "value": "android.widget.Button text='Allow' id='com.android.permissioncontroller:id/permission_allow_button'",
+                "index": 0
+              },
+              "direction": "",
+              "assertionType": "exists",
+              "expectedValue": ""
+            },
+            {
+              "type": "tap",
+              "selector": {
+                "strategy": "id",
+                "value": "com.android.permissioncontroller:id/permission_allow_button"
+              },
+              "value": "",
+              "direction": "",
+              "assertionType": "enabled",
+              "expectedValue": ""
+            }
+          ]
+        },
+        {
+          "step": "Click on 'Get Started' button",
+          "status": "passed",
+          "duration": 5544,
+          "actions": [
+            {
+              "type": "tap",
+              "selector": {
+                "strategy": "text",
+                "value": "Get Started"
+              },
+              "direction": "up"
+            }
+          ]
+        },
+        {
+          "step": "Input the mobile number \"112233445\" into the Phone Number input field",
+          "status": "failed",
+          "duration": 27788,
+          "actions": [],
+          "error": "Action failed: tap"
+        }
+      ]
+    }
+  ]
+}

package/scripts/check-mcp-server.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "=========================================="
+echo "MCP Server Status Checker"
+echo "=========================================="
+echo ""
+
+# Check if Ollama (LLM) is running
+echo "1. Checking Ollama (LLM) Server..."
+if pgrep -x "ollama" > /dev/null; then
+    echo -e "${GREEN}✓${NC} Ollama is running"
+    
+    # Try to query Ollama
+    if curl -s http://localhost:11434/api/tags > /dev/null 2>&1; then
+        echo -e "${GREEN}✓${NC} Ollama API is accessible"
+        
+        # Check if llama3.2:3b is available
+        if curl -s http://localhost:11434/api/tags | grep -q "llama3.2:3b"; then
+            echo -e "${GREEN}✓${NC} llama3.2:3b model is available"
+        else
+            echo -e "${YELLOW}⚠${NC}  llama3.2:3b model not found"
+            echo "   Run: ollama pull llama3.2:3b"
+        fi
+    else
+        echo -e "${RED}✗${NC} Ollama API is not accessible"
+    fi
+else
+    echo -e "${RED}✗${NC} Ollama is not running"
+    echo "   Start with: ollama serve"
+fi
+
+echo ""
+
+# Check if Appium is running
+echo "2. Checking Appium Server..."
+APPIUM_URL="${APPIUM_SERVER_URL:-http://localhost:4723}"
+
+if curl -s "$APPIUM_URL/status" > /dev/null 2>&1; then
+    echo -e "${GREEN}✓${NC} Appium server is running at $APPIUM_URL"
+else
+    echo -e "${YELLOW}⚠${NC}  Appium server is not running locally"
+    echo "   This is OK if you're using LambdaTest remote grid"
+    echo "   LambdaTest URL: https://mobile-hub.lambdatest.com/wd/hub"
+fi
+
+echo ""
+
+# Check for MCP-Appium process
+echo "3. Checking MCP-Appium Server..."
+if pgrep -f "mcp-appium" > /dev/null; then
+    echo -e "${GREEN}✓${NC} MCP-Appium process is running"
+    echo "   PID: $(pgrep -f 'mcp-appium')"
+else
+    echo -e "${YELLOW}⚠${NC}  MCP-Appium process not found"
+    echo "   Note: MCP-Appium starts automatically when tests run"
+fi
+
+echo ""
+
+# Check if port 3000 (MCP default) is in use
+echo "4. Checking MCP Server Port (3000)..."
+if lsof -Pi :3000 -sTCP:LISTEN -t >/dev/null 2>&1; then
+    echo -e "${GREEN}✓${NC} Port 3000 is in use (likely MCP server)"
+    echo "   Process: $(lsof -Pi :3000 -sTCP:LISTEN | tail -n 1 | awk '{print $1}')"
+else
+    echo -e "${YELLOW}⚠${NC}  Port 3000 is not in use"
+    echo "   MCP server will start automatically with tests"
+fi
+
+echo ""
+echo "=========================================="
+echo "Summary"
+echo "=========================================="
+
+# Overall status
+ALL_OK=true
+
+if ! pgrep -x "ollama" > /dev/null; then
+    ALL_OK=false
+    echo -e "${RED}✗${NC} Ollama is not running - REQUIRED"
+fi
+
+if [ "$ALL_OK" = true ]; then
+    echo -e "${GREEN}✓${NC} System is ready for AI testing!"
+else
+    echo -e "${YELLOW}⚠${NC}  Some components are not running"
+    echo ""
+    echo "Quick fixes:"
+    echo "  - Start Ollama: ollama serve"
+    echo "  - Pull model: ollama pull llama3.2:3b"
+    echo "  - MCP starts automatically when running tests"
+fi
+
+echo ""

package/scripts/extract-pom-knowledge.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+/**
+ * Extract knowledge from existing Page Object Model files
+ * Usage: node scripts/extract-pom-knowledge.js --input <pom-dir> --output <knowledge-file>
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function parseArguments() {
+    const args = process.argv.slice(2);
+    const config = {
+        input: null,
+        output: 'knowledge/extracted-pom-knowledge.txt'
+    };
+
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--input' && args[i + 1]) {
+            config.input = args[i + 1];
+            i++;
+        } else if (args[i] === '--output' && args[i + 1]) {
+            config.output = args[i + 1];
+            i++;
+        }
+    }
+
+    return config;
+}
+
+function extractElementsFromFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const elements = [];
+    const screens = [];
+
+    // Extract screen name from file name
+    const fileName = path.basename(filePath, path.extname(filePath));
+    const screenName = fileName.replace(/(Android|Ios|\.page)/gi, '');
+    screens.push(screenName);
+
+    // Patterns to match element definitions
+    const patterns = [
+        // Getter methods: get elementName() { return $('selector') }
+        /get\s+(\w+)\s*\(\)\s*\{[^}]*\$\(['"`]([^'"`]+)['"`]\)/g,
+        // Direct assignments: this.element = $('selector')
+        /this\.(\w+)\s*=\s*\$\(['"`]([^'"`]+)['"`]\)/g,
+        // Const/let/var: const element = $('selector')
+        /(?:const|let|var)\s+(\w+)\s*=\s*\$\(['"`]([^'"`]+)['"`]\)/g,
+    ];
+
+    patterns.forEach(pattern => {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            elements.push({
+                name: match[1],
+                selector: match[2],
+                screen: screenName
+            });
+        }
+    });
+
+    return { elements, screens };
+}
+
+function generateKnowledge(pomDir, outputFile) {
+    console.log(`Extracting knowledge from: ${pomDir}`);
+
+    if (!fs.existsSync(pomDir)) {
+        console.error(`Error: Directory not found: ${pomDir}`);
+        process.exit(1);
+    }
+
+    const allElements = [];
+    const allScreens = new Set();
+    const platformData = {
+        android: [],
+        ios: []
+    };
+
+    function processDirectory(dir) {
+        const files = fs.readdirSync(dir);
+
+        files.forEach(file => {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+
+            if (stat.isDirectory()) {
+                processDirectory(filePath);
+            } else if (file.endsWith('.page.js') || file.endsWith('.page.ts')) {
+                const { elements, screens } = extractElementsFromFile(filePath);
+
+                allElements.push(...elements);
+                screens.forEach(s => allScreens.add(s));
+
+                // Categorize by platform
+                const platform = file.toLowerCase().includes('android') ? 'android' :
+                    file.toLowerCase().includes('ios') ? 'ios' : 'both';
+
+                if (platform === 'android' || platform === 'both') {
+                    platformData.android.push(...elements);
+                }
+                if (platform === 'ios' || platform === 'both') {
+                    platformData.ios.push(...elements);
+                }
+            }
+        });
+    }
+
+    processDirectory(pomDir);
+
+    console.log(`Found ${allElements.length} elements across ${allScreens.size} screens`);
+
+    // Generate knowledge file
+    const knowledge = [];
+
+    knowledge.push('# App Knowledge Extracted from Page Object Models');
+    knowledge.push('');
+    knowledge.push(`Generated: ${new Date().toISOString()}`);
+    knowledge.push(`Source: ${pomDir}`);
+    knowledge.push('');
+
+    // Screens overview
+    knowledge.push('## Available Screens');
+    knowledge.push('');
+    Array.from(allScreens).sort().forEach(screen => {
+        knowledge.push(`- ${screen}`);
+    });
+    knowledge.push('');
+
+    // Group elements by screen
+    const elementsByScreen = {};
+    allElements.forEach(el => {
+        if (!elementsByScreen[el.screen]) {
+            elementsByScreen[el.screen] = [];
+        }
+        elementsByScreen[el.screen].push(el);
+    });
+
+    knowledge.push('## Screen Elements and Selectors');
+    knowledge.push('');
+
+    Object.keys(elementsByScreen).sort().forEach(screen => {
+        knowledge.push(`### ${screen} Screen`);
+        knowledge.push('');
+
+        const elements = elementsByScreen[screen];
+        elements.forEach(el => {
+            // Convert camelCase to readable text
+            const readable = el.name
+                .replace(/([A-Z])/g, ' $1')
+                .replace(/^./, str => str.toUpperCase())
+                .trim();
+
+            knowledge.push(`- **${readable}**: \`${el.selector}\``);
+        });
+        knowledge.push('');
+    });
+
+    // Common patterns
+    knowledge.push('## Common Selector Patterns');
+    knowledge.push('');
+
+    const selectorPatterns = {
+        'Resource ID': allElements.filter(e => e.selector.includes('resource-id')),
+        'Accessibility ID': allElements.filter(e => e.selector.includes('accessibility id') || e.selector.includes('~')),
+        'Text': allElements.filter(e => e.selector.includes('@text') || e.selector.includes('text=')),
+        'XPath': allElements.filter(e => e.selector.startsWith('//')),
+    };
+
+    Object.keys(selectorPatterns).forEach(pattern => {
+        const count = selectorPatterns[pattern].length;
+        if (count > 0) {
+            knowledge.push(`- **${pattern}**: ${count} elements use this strategy`);
+        }
+    });
+    knowledge.push('');
+
+    // Platform-specific notes
+    knowledge.push('## Platform-Specific Information');
+    knowledge.push('');
+    knowledge.push(`### Android`);
+    knowledge.push(`- Total elements: ${platformData.android.length}`);
+    knowledge.push(`- Common selectors: resource-id, text, xpath`);
+    knowledge.push('');
+    knowledge.push(`### iOS`);
+    knowledge.push(`- Total elements: ${platformData.ios.length}`);
+    knowledge.push(`- Common selectors: accessibility-id, name, label`);
+    knowledge.push('');
+
+    // Tips for AI
+    knowledge.push('## Tips for AI Agent');
+    knowledge.push('');
+    knowledge.push('1. Prefer using accessibility IDs when available');
+    knowledge.push('2. Text-based selectors are reliable for buttons and labels');
+    knowledge.push('3. Resource IDs (Android) are stable across app versions');
+    knowledge.push('4. Use XPath only as a last resort');
+    knowledge.push('5. Elements may have slight variations across different device sizes');
+    knowledge.push('');
+
+    // Write to file
+    const outputDir = path.dirname(outputFile);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+
+    fs.writeFileSync(outputFile, knowledge.join('\n'));
+    console.log(`Knowledge file generated: ${outputFile}`);
+    console.log(`Summary: ${allElements.length} elements, ${allScreens.size} screens`);
+}
+
+// Main execution
+const config = parseArguments();
+
+if (!config.input) {
+    console.error('Usage: node extract-pom-knowledge.js --input <pom-directory> [--output <output-file>]');
+    console.error('');
+    console.error('Example:');
+    console.error('  node extract-pom-knowledge.js --input ../dmg.qa.test.technician-app-3/pages --output knowledge/app-knowledge.txt');
+    process.exit(1);
+}
+
+generateKnowledge(config.input, config.output);