endorphin-ai 0.6.1 → 0.7.0

package/README.md

@@ -42,8 +42,15 @@ comprehensive test management.
 
 ### 📦 Installation & Setup
 
-Get started in under 2 minutes:
+Get started in under 30 seconds:
 
+```bash
+# ⚡ Quick setup (recommended)
+npx create-endorphin-ai my-ai-tests
+cd my-ai-tests
+```
+
+**Or manual setup:**
 ```bash
 # 1. Create your project
 mkdir my-ai-tests && cd my-ai-tests
@@ -52,7 +59,7 @@ mkdir my-ai-tests && cd my-ai-tests
 npm install endorphin-ai
 
 # 3. Initialize with everything you need
-npx endorphin init
+npx endorphin-ai init
 ```
 
 **What you get:**
@@ -74,10 +81,10 @@ echo "OPENAI_API_KEY=your-openai-api-key-here" > .env
 
 ```bash
 # Run the sample health check test
-npx endorphin run test HEALTH-001
+npx endorphin-ai run test HEALTH-001
 
 # Generate a beautiful HTML report
-npx endorphin generate report && npx endorphin open report
+npx endorphin-ai generate report && npx endorphin-ai open report
 ```
 
 **🎉 That's it!** You now have:
@@ -87,7 +94,7 @@ npx endorphin generate report && npx endorphin open report
 
 ### 🔧 Troubleshooting Installation
 
-If `npx endorphin` doesn't work, try these **guaranteed solutions**:
+If `npx endorphin-ai` doesn't work, try these **guaranteed solutions**:
 
 ```bash
 # Option 1: Use npm scripts (always works)
@@ -97,14 +104,14 @@ npm run endorphin:help                # Get help
 
 # Option 2: Clear npx cache and retry
 npx --clear-cache
-npx endorphin init
+npx endorphin-ai init
 
 # Option 3: Use direct path
-./node_modules/.bin/endorphin init
+./node_modules/.bin/endorphin-ai init
 
 # Option 4: Global installation
 npm install -g endorphin-ai
-endorphin init
+endorphin-ai init
 ```
 
 **Why this happens:** This is a known npm/npx issue with local binary resolution, not a problem with Endorphin AI. The npm scripts above always work regardless of npx behavior.
@@ -173,12 +180,12 @@ If you prefer manual setup:
    ```json
    {
      "scripts": {
-       "test": "endorphin run test all",
-       "test:smoke": "endorphin run test --tag smoke",
-       "test:auth": "endorphin run test --tag authentication", 
-       "test:single": "endorphin run test",
-       "test:record": "endorphin run test-recorder",
-       "endorphin:init": "./node_modules/.bin/endorphin init",
+       "test": "endorphin-ai run test all",
+       "test:smoke": "endorphin-ai run test --tag smoke",
+       "test:auth": "endorphin-ai run test --tag authentication", 
+       "test:single": "endorphin-ai run test",
+       "test:record": "endorphin-ai run test-recorder",
+       "endorphin:init": "./node_modules/.bin/endorphin-ai init",
        "endorphin:version": "./node_modules/.bin/endorphin --version"
      }
    }
@@ -215,25 +222,25 @@ If you prefer manual setup:
 
 ## 🔄 Staying Updated
 
-### Current Version: v0.6.0
+### Current Version: v0.6.1
 
 ```bash
 # Check your current version
-npx endorphin --version
+npx endorphin-ai --version
 
 # Update to the latest version
 npm update endorphin-ai
 
 # Get help and see new features
-npx endorphin --help
+npx endorphin-ai --help
 ```
 
-### What's New in v0.6.0
-- ✅ **Enhanced CLI** with dual command names (`endorphin` and `endorphin-ai`)
-- ✅ **Improved HTML Reports** with better filtering and search
-- ✅ **Security-First** with automated vulnerability scanning
-- ✅ **Cross-Platform CI/CD** support for Windows, Linux, and macOS
-- ✅ **Production-Ready** compiled JavaScript without tsx dependency
+### What's New in v0.6.1
+- ✅ **Fixed npx Resolution Issues** with post-install script and npm script alternatives
+- ✅ **Enhanced User Experience** with clear troubleshooting guidance
+- ✅ **Reliable Installation** that works regardless of npm/npx behavior
+- ✅ **Multiple Access Methods** including guaranteed npm scripts
+- ✅ **Better Documentation** with comprehensive troubleshooting section
 
 ## 🚀 Project Initialization
 
@@ -242,7 +249,7 @@ npx endorphin --help
 ```bash
 # Quick setup for new projects
 mkdir my-test-project && cd my-test-project
-npx endorphin init
+npx endorphin-ai init
 ```
 
 The `init` command creates:
@@ -266,7 +273,7 @@ For existing Endorphin projects, the `init` command is optional and safe:
 
 ```bash
 # Safe to run in existing projects
-npx endorphin init
+npx endorphin-ai init
 ```
 
 ### Usage Commands
@@ -275,10 +282,10 @@ npx endorphin init
 
 ```bash
 # Check current version
-npx endorphin --version
+npx endorphin-ai --version
 
 # Get help and see all commands
-npx endorphin --help
+npx endorphin-ai --help
 
 # Update to latest version
 npm update endorphin-ai
@@ -288,7 +295,7 @@ npm update endorphin-ai
 
 ```bash
 # Create a new Endorphin AI project with all necessary files
-npx endorphin init
+npx endorphin-ai init
 
 # What gets created:
 # ├── tests/sample-test.ts     # Ready-to-run TypeScript test
@@ -725,14 +732,14 @@ npx endorphin list
 
 ```bash
 # Initialize new project (recommended for new projects)
-npx endorphin init
+npx endorphin-ai init
 
 # Show help and available commands
-npx endorphin --help
+npx endorphin-ai --help
 npx endorphin help
 
 # Check current version
-npx endorphin --version
+npx endorphin-ai --version
 ```
 
 ### HTML Reports & Analytics
@@ -824,7 +831,7 @@ Add these to your `package.json`:
     "test:summary": "endorphin generate report --summary",
     "test:open": "endorphin open report",
     "test:cleanup": "endorphin cleanup results",
-    "endorphin:init": "./node_modules/.bin/endorphin init",
+    "endorphin:init": "./node_modules/.bin/endorphin-ai init",
     "endorphin:version": "./node_modules/.bin/endorphin --version",
     "endorphin:help": "./node_modules/.bin/endorphin --help"
   }
@@ -851,7 +858,7 @@ npm run endorphin:help  # Get help
 
 ```bash
 # Check current installed version
-npx endorphin --version
+npx endorphin-ai --version
 
 # Check latest available version on npm
 npm view endorphin-ai version
@@ -870,15 +877,16 @@ npm update endorphin-ai
 npm install endorphin-ai@latest
 
 # Verify the update
-npx endorphin --version
+npx endorphin-ai --version
 ```
 
 ### Version History & Features
 
-- **v0.6.0** *(Latest)*: Enhanced CLI, security-first publishing, cross-platform CI/CD
+- **v0.6.1** *(Latest)*: Fixed npx resolution issues, enhanced user experience
+- **v0.6.0**: Enhanced CLI, security-first publishing, cross-platform CI/CD
 - **v0.5.0**: Advanced HTML reporting with interactive features
 - **v0.4.0**: TypeScript-first experience with full type definitions
-- **v0.3.0**: Added `endorphin init` command for instant project setup
+- **v0.3.0**: Added `endorphin-ai init` command for instant project setup
 - **v0.2.x**: Core framework with AI-powered testing
 - **v0.1.x**: Initial release with basic functionality
 

package/dist/framework/cli/init-command.js

@@ -33,7 +33,7 @@ export async function initProject(targetDir = process.cwd()) {
             (await fileExists(path.join(targetDir, 'endorphin.config.ts')));
         if (configExists) {
             console.log('⚠️  Endorphin AI already initialized in this directory');
-            console.log('💡 Run: npx endorphin run test HEALTH-001');
+            console.log('💡 Run: npx endorphin-ai run test HEALTH-001');
             return;
         }
         // Create directories
@@ -44,8 +44,8 @@ export async function initProject(targetDir = process.cwd()) {
         console.log('');
         console.log('🚀 Next steps:');
         console.log('  1. Edit .env and add your OpenAI API key');
-        console.log('  2. Run: npx endorphin run test HEALTH-001');
-        console.log('  3. Try: npx endorphin run test-recorder');
+        console.log('  2. Run: npx endorphin-ai run test HEALTH-001');
+        console.log('  3. Try: npx endorphin-ai run test-recorder');
         console.log('');
         console.log('📚 Learn more: https://github.com/andrewnovykov/endorphin-ai');
     }
@@ -115,7 +115,7 @@ function processEnvFile(content) {
 # 2. Create new secret key
 # 3. Replace "your_openai_api_key_here" above with your actual key
 # 4. Save this file
-# 5. Run: npx endorphin run test HEALTH-001`;
+# 5. Run: npx endorphin-ai run test HEALTH-001`;
 }
 function processConfigFile(content) {
     // Add helpful comments for beginners
@@ -149,7 +149,7 @@ async function createBasicFiles(targetDir) {
 # 2. Create new secret key
 # 3. Replace "your_openai_api_key_here" above with your actual key
 # 4. Save this file
-# 5. Run: npx endorphin run test HEALTH-001`;
+# 5. Run: npx endorphin-ai run test HEALTH-001`;
     await fs.writeFile(path.join(targetDir, '.env'), envContent);
     console.log('📄 Created: .env');
     // Create basic config file
@@ -261,7 +261,7 @@ Welcome to your new Endorphin AI testing project! 🎯
 
 2. **Run your first test:**
    \`\`\`bash
-   npx endorphin run test HEALTH-001
+   npx endorphin-ai run test HEALTH-001
    \`\`\`
 
 3. **View test results:**
@@ -278,7 +278,7 @@ Welcome to your new Endorphin AI testing project! 🎯
 
 - Add more tests in the \`tests/\` directory
 - Customize your configuration in \`endorphin.config.js\`
-- Explore the interactive test recorder: \`npx endorphin run test-recorder\`
+- Explore the interactive test recorder: \`npx endorphin-ai run test-recorder\`
 
 Happy testing! 🚀`;
     await fs.writeFile(path.join(targetDir, 'README-ENDORPHIN.md'), readmeContent);

package/dist/framework/cli/init-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-command.js","sourceRoot":"","sources":["../../../framework/cli/init-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init-command.js","sourceRoot":"","sources":["../../../framework/cli/init-command.ts"],"names":[],"mappings":"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"}

package/examples/README-ENDORPHIN.md

@@ -17,27 +17,27 @@ Get your API key from: https://platform.openai.com/api-keys
 ### 2. Run Example Test
 
 ```bash
-npx endorphin run test HEALTH-001
+npx endorphin-ai run test HEALTH-001
 ```
 
 ### 3. Generate reporter
 
 ```bash
-npx endorphin generate report
-npx endorphin open report
+npx endorphin-ai generate report
+npx endorphin-ai open report
 
 ```
 
 ### 4. Record Your Own Test
 
 ```bash
-npx endorphin run test-recorder
+npx endorphin-ai run test-recorder
 ```
 
 ### 5. List All Tests
 
 ```bash
-npx endorphin list
+npx endorphin-ai list
 ```
 
 ## 📁 Project Structure
@@ -58,7 +58,7 @@ npx endorphin list
 
 ```bash
 # Check your current version
-npx endorphin --version
+npx endorphin-ai --version
 
 # Check latest available version
 npm view endorphin-ai version
@@ -77,7 +77,7 @@ npm update endorphin-ai
 npm install endorphin-ai@latest
 
 # Verify the update worked
-npx endorphin --version
+npx endorphin-ai --version
 ```
 
 ## 📋 Common Commands
@@ -86,43 +86,43 @@ npx endorphin --version
 
 ```bash
 # Run specific test
-npx endorphin run test HEALTH-001
+npx endorphin-ai run test HEALTH-001
 
 # Run all tests
-npx endorphin run test all
+npx endorphin-ai run test all
 
 # Run tests by tag
-npx endorphin run test --tag smoke
-npx endorphin run test --tag authentication
+npx endorphin-ai run test --tag smoke
+npx endorphin-ai run test --tag authentication
 
 # Run tests by priority
-npx endorphin run test --priority High
+npx endorphin-ai run test --priority High
 ```
 
 ### Test Management
 
 ```bash
 # List all available tests
-npx endorphin list
+npx endorphin-ai list
 
 # Start test recorder for creating new tests
-npx endorphin run test-recorder
+npx endorphin-ai run test-recorder
 
 # Get help and see all commands
-npx endorphin --help
+npx endorphin-ai --help
 ```
 
 ### Browser Options
 
 ```bash
 # Run with visible browser (default)
-npx endorphin run test HEALTH-001 --no-headless
+npx endorphin-ai run test HEALTH-001 --no-headless
 
 # Run in headless mode (faster)
-npx endorphin run test HEALTH-001 --headless
+npx endorphin-ai run test HEALTH-001 --headless
 
 # Set custom viewport size
-npx endorphin run test HEALTH-001 --viewport 1920x1080
+npx endorphin-ai run test HEALTH-001 --viewport 1920x1080
 ```
 
 ## ⚙️ Configuration
@@ -184,7 +184,7 @@ export const MY_TEST = {
 cat .env
 
 # Test API key works
-npx endorphin run test HEALTH-001
+npx endorphin-ai run test HEALTH-001
 ```
 
 ### Version Issues
@@ -202,7 +202,7 @@ node --version
 
 ```bash
 # Check test file format
-npx endorphin list
+npx endorphin-ai list
 
 # Verify exports are correct
 node -e "import('./tests/sample-test.js').then(console.log)"
@@ -210,8 +210,8 @@ node -e "import('./tests/sample-test.js').then(console.log)"
 
 ## 🎯 Next Steps
 
-1. **Run the sample test**: `npx endorphin run test HEALTH-001`
-2. **Record your first test**: `npx endorphin run test-recorder`
+1. **Run the sample test**: `npx endorphin-ai run test HEALTH-001`
+2. **Record your first test**: `npx endorphin-ai run test-recorder`
 3. **Write custom tests**: Add new files to `tests/` directory
 4. **Configure settings**: Edit `endorphin.config.js` for your needs
 5. **Set up CI/CD**: Add Endorphin tests to your pipeline

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "endorphin-ai",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "E2E Testing Reinvented with AI - A powerful TypeScript browser automation framework using AI-powered testing with LangChain, OpenAI GPT-4o, and Playwright",
   "main": "dist/framework/index.js",
   "bin": {
@@ -18,10 +18,11 @@
     "test:dev": "jest --selectProjects='Development Tests'",
     "test:all": "jest --selectProjects='Development Tests'",
     "test:package": "cd tests/package-tests && ./run-all-tests.sh",
-    "build": "tsc && node scripts/fix-imports.js && cp framework/templates/reporter/*.html framework/templates/reporter/*.css framework/templates/reporter/*.js dist/framework/templates/reporter/ && chmod +x dist/bin/endorphin.js",
+    "build": "tsc && node scripts/fix-imports.js && cp framework/templates/reporter/*.html framework/templates/reporter/*.css framework/templates/reporter/*.js dist/framework/templates/reporter/ && chmod +x dist/bin/endorphin.js && chmod +x dist/bin/cli-handlers.js",
     "build:watch": "tsc --watch",
     "pack:local": "npm run build && npm pack --pack-destination dist",
     "test:local": "npm run pack:local && ./tests/package-tests/run-all-tests.sh",
+    "test:install": "npm run build && ./scripts/test-npm-install.sh",
     "type-check": "tsc --noEmit",
     "framework:test": "tsx framework/index.ts --test",
     "framework:demo": "tsx framework/index.ts",
@@ -42,11 +43,13 @@
     "cleanup": "./scripts/cleanup-test-artifacts.sh",
     "postinstall": "node scripts/postinstall.js",
     "endorphin": "./node_modules/.bin/endorphin",
-    "endorphin:init": "./node_modules/.bin/endorphin init",
-    "endorphin:version": "./node_modules/.bin/endorphin --version",
-    "endorphin:help": "./node_modules/.bin/endorphin --help",
+    "endorphin-ai": "./node_modules/.bin/endorphin",
+    "endorphin-ai:init": "./node_modules/.bin/endorphin init",
+    "endorphin-ai:version": "./node_modules/.bin/endorphin --version",
+    "endorphin-ai:help": "./node_modules/.bin/endorphin --help",
     "prepare": "echo 'Husky disabled temporarily'",
-    "precommit": "echo 'Pre-commit hooks disabled temporarily'"
+    "precommit": "echo 'Pre-commit hooks disabled temporarily'",
+    "prepublishOnly": "npm run build && npm run test:unit"
   },
   "keywords": [
     "ai",

package/scripts/fix-imports.js

@@ -11,7 +11,8 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-const distDir = path.join(__dirname, '..', 'dist', 'framework');
+const distFrameworkDir = path.join(__dirname, '..', 'dist', 'framework');
+const distBinDir = path.join(__dirname, '..', 'dist', 'bin');
 
 // Path alias mappings
 const pathMappings = {
@@ -80,5 +81,15 @@ function processDirectory(dir) {
 }
 
 console.log('🔧 Fixing TypeScript path aliases in compiled JavaScript...');
-processDirectory(distDir);
+
+// Process framework directory
+if (fs.existsSync(distFrameworkDir)) {
+  processDirectory(distFrameworkDir);
+}
+
+// Process bin directory  
+if (fs.existsSync(distBinDir)) {
+  processDirectory(distBinDir);
+}
+
 console.log('✅ Import paths fixed!');

package/scripts/postinstall.js

@@ -46,19 +46,28 @@ function printUsageInstructions() {
 ✅ Endorphin AI installed successfully!
 
 🚀 Quick start:
-  npx endorphin init                    # Initialize new project
-  npm run endorphin:init                # Alternative method
+  npx endorphin-ai init                    # Initialize new project (recommended)
+  ./node_modules/.bin/endorphin init       # Direct method
 
 📚 More commands:
-  npx endorphin --version               # Check version
-  npm run endorphin:version             # Alternative method
+  npx endorphin-ai --version               # Check version
+  ./node_modules/.bin/endorphin --version  # Direct method
   
-  npx endorphin --help                  # Get help
-  npm run endorphin:help                # Alternative method
+  npx endorphin-ai --help                  # Get help
+  ./node_modules/.bin/endorphin --help     # Direct method
 
-🔧 If npx doesn't work, use npm scripts:
-  npm run endorphin:init                # Always works
-  npm run endorphin:version             # Always works
+⚠️  Note: Use 'endorphin-ai' with npx to avoid conflicts with other packages
+
+🔧 Alternative: Add these scripts to your package.json:
+  {
+    "scripts": {
+      "endorphin-ai:init": "./node_modules/.bin/endorphin init",
+      "endorphin-ai:version": "./node_modules/.bin/endorphin --version",
+      "endorphin-ai:help": "./node_modules/.bin/endorphin --help"
+    }
+  }
+  
+  Then use: npm run endorphin-ai:init
   
 📖 Documentation: https://github.com/andrewnovykov/endorphin-ai#readme
 `);

package/scripts/test-npm-install.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+
+# Test script to verify npm installation works properly
+
+set -e
+
+echo "🧪 Testing npm installation..."
+
+# Clean up any previous test
+rm -rf /tmp/endorphin-test-install
+mkdir -p /tmp/endorphin-test-install
+cd /tmp/endorphin-test-install
+
+echo "📦 Creating test package..."
+npm pack /Users/papapin777/Documents/CODE/AI/endorphin-ai
+
+# Find the generated .tgz file
+PACKAGE_FILE=$(ls endorphin-ai-*.tgz | head -1)
+
+if [ -z "$PACKAGE_FILE" ]; then
+  echo "❌ Failed: No package file generated"
+  exit 1
+fi
+
+echo "📥 Installing package locally..."
+npm init -y > /dev/null 2>&1
+npm install "./$PACKAGE_FILE" > /dev/null 2>&1
+
+echo "🧪 Testing npx endorphin-ai command..."
+if npx endorphin-ai --version > /dev/null 2>&1; then
+  echo "✅ npx endorphin-ai --version works!"
+else
+  echo "❌ npx endorphin-ai --version failed"
+  exit 1
+fi
+
+echo "🧪 Testing direct binary execution..."
+if ./node_modules/.bin/endorphin-ai --version > /dev/null 2>&1; then
+  echo "✅ Direct binary execution works!"
+else
+  echo "❌ Direct binary execution failed"
+  exit 1
+fi
+
+echo "🧪 Testing global installation..."
+npm install -g "./$PACKAGE_FILE" > /dev/null 2>&1
+
+if endorphin-ai --version > /dev/null 2>&1; then
+  echo "✅ Global installation works!"
+else
+  echo "❌ Global installation failed"
+  exit 1
+fi
+
+# Clean up global install
+npm uninstall -g endorphin-ai > /dev/null 2>&1
+
+echo "🎉 All installation tests passed!"
+cd /
+rm -rf /tmp/endorphin-test-install