🚀 GUS Test Suite Automation Extension

A VS Code/Cursor extension for automating GUS Test Suite creation with AI-powered test scenario generation.

Note: Works with both VS Code and Cursor

✨ Key Features

• 🔗 Multi-repository support (GitCore, GitSoma, GitHub)
• 🤖 AI-powered test scenario generation from PR analysis
• 📦 Bulk processing for multiple work items
• 📄 Generate tests directly from file URLs
• 🔒 Secure authentication with GUS and Git tokens
• 🎯 Smart filtering by Epic, Release, or Date Range
• ✏️ Interactive editing before saving to GUS

Table of Contents

• Installation
• Quick Start
• How to Use
• Authentication Setup
• FAQ
• Development
• Contributing

💾 Installation

With options 1 and 2, you will get automatic updates

VS Code: Install from VS Code Marketplace

Cursor: Install from Open VSX Registry

Manual Installation (Alternative):

1. Download the gustestsuiteautomation-1.0.9.vsix file
2. Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
3. Select "Extensions: Install from VSIX"
4. Choose the downloaded file

🚀 Quick Start

1. Install the extension (see above)
2. Set up authentication (see below) - GUS and GIT
3. Set up Claude token (see below)
4. Open Command Palette → Enter "Gusify"
5. Choose your option: Single PR, Bulk Work Items, or File URL

📝 How to Use

Option 1: Single PR Processing

1. Command Palette → Enter "Gusify"
2. Select option "Gusify Single PR"
3. Paste your PR link (GitCore, GitSoma, or GitHub)
4. Review AI-generated test scenarios
5. Edit as needed
6. Save to GUS

Option 2: Bulk Work Item Processing

1. Command Palette → Enter "Gusify"
2. Select option "Gusify My Work Items (Bulk)"
3. Filter by Epic, Release, or Date Range (optional)
4. Click "Gusify"
5. Review test scenarios for all PRs
6. Save to GUS

Features:

• Filter by Epic name or ID
• Filter by Release/Build (main and patch builds)
• Automatic PR discovery across all repositories

Option 3: File URL Processing

1. Command Palette → Enter "Gusify"
2. Select option "Gusify From File URL"
3. Paste the complete file URL (including https://)
4. Enter Work Item name (format: W-XXXXXXXX)
5. Review and edit test scenarios
6. Save to GUS

🔐 Authentication Setup

Git Access Tokens

You only need tokens for repositories you use. All tokens are stored securely.

How to get your token:

1. Go to your Git platform:
   • GitCore
   • GitSoma
   • GitHub
2. Click profile picture → Settings → Developer Settings
3. Personal Access Token → Tokens (Classic) → Generate new token
4. Give it a descriptive name
5. Select scopes: repo and read:org
6. Click "Generate Token" and copy immediately
7. Launch tool by opening Command Palette → Enter "Gusify"
8. Go to Settings (4th option)

GUS Authentication

Choose one of three methods:

Method 1: Browser-Based Login (Recommended)

1. Select "Login via Browser"
2. Sign in GUS when browser opens and Allow
3. Copy the complete URL and paste it into tool

Method 2: Standard Login

1. Enter credentials:
   • Username: gusdomainusername@gus.com (e.g., prateek.jha@gus.com)
   • Password: Your SSO password
   • Okta 2FA: 6-digit code from authenticator app

If authentication fails:

• Unregister old devices: https://salesforce.okta.com/enduser/settings

Method 3: Workbench Access Token

1. Open Workbench for GUS org
2. Login with Salesforce
3. Open browser Dev Tools → Network tab
4. Run any query
5. Find the network call → Headers → Copy Bearer token from Authorization header

🔑 Set up Claude Token

1. Command Palette → Enter "Gusify"
2. Open Settings (4th option)

💡 Tips

• Always review AI-generated test scenarios before saving
• Add additional context and edge cases where needed
• Use descriptive names for test scenarios
• Group related tests under appropriate GUS themes

❓ Frequently Asked Questions (FAQ)

Q: What repositories are supported? A: GitCore, GitSoma, and GitHub.

Q: Do I need tokens for all repositories? A: No, only for the ones you use.

Q: Is my data secure? A: Yes, all credentials are encrypted and stored securely in VS Code's secret storage.

Q: Can I edit generated test scenarios? A: Yes, review and edit everything before saving to GUS.

Q: How are test scenarios generated? A: AI analyzes your PR changes and generates relevant test scenarios automatically.

Q: What if I don't have a PR but want to generate tests? A: Use "Gusify from File URL" to generate tests from any file in your repository.

Q: How long do tokens last? A: Git tokens don't expire (unless you set one). GUS tokens expire after inactivity—just re-authenticate when prompted.

👨‍💻 Development

To modify or extend this extension:

1. Clone the repository from GitSoma
2. Run npm install to install dependencies
3. Make your changes to the TypeScript files in the src/ directory
4. Press F5 to start debugging in a new Extension Development Host window
5. Use vsce package to create a new VSIX file for distribution

Building the Extension

To compile the TypeScript source to JavaScript:

npm run compile

To package the extension into a VSIX file:

npx vsce package

🤝 Contributing

Contributions are welcome! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch
3. Make your changes with clear commit messages
4. Test thoroughly
5. Submit a pull request

Made with ❤️ by the Salesforce Alchemy Team