Added a wrapper around lagoon-cli to allow faster deletion of PR environments.

Author: richardgaunt

.gitignore

@@ -0,0 +1,29 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+.logs/
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Output of 'npm pack'
+*.tgz
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local 

README.md

@@ -0,0 +1,98 @@
+# Lagoon CLI Wrapper
+
+A Node.js CLI wrapper for the Lagoon CLI that provides an interactive interface for common operations.
+
+## Prerequisites
+
+- Node.js (v14 or higher)
+- Lagoon CLI installed and configured
+- A valid `.lagoon.yml` file in your home directory
+
+## Installation
+
+1. Clone this repository
+2. Install dependencies:
+
+```bash
+npm install
+```
+
+3. Link the CLI globally:
+
+```bash
+npm link
+```
+
+## Usage
+
+Simply run the command:
+
+```bash
+lagoon-wrapper
+```
+
+This will start the interactive mode, which will guide you through:
+
+1. Selecting a Lagoon instance
+2. Selecting a project
+3. Performing operations on the selected project:
+   - Listing environments
+   - Listing users
+   - Deleting environments (except protected ones)
+   - Generating login links for environments
+   - Clearing Drupal caches
+   - Viewing GitHub PR links for PR environments
+
+## Features
+
+- Interactive CLI interface
+- Easy navigation between instances and projects
+- Safe environment deletion (prevents deletion of protected environments)
+- GitHub PR integration for PR environments
+- One-click login link generation for Drupal environments
+- Quick Drupal cache clearing for any environment
+- Comprehensive logging of all operations
+- Extensible architecture for adding new commands
+
+## Protected Environments
+
+The following environments cannot be deleted:
+- production
+- master
+- develop
+- Any environment starting with `project/`
+
+## GitHub Integration
+
+For projects hosted on GitHub, the CLI will:
+- Automatically detect PR environments (environments named `pr-XX`)
+- Display links to the corresponding GitHub pull requests
+- Show PR information when listing, deleting, or generating login links for environments
+
+## Login Link Generation
+
+The CLI can generate login links for Drupal environments by:
+- Unblocking the admin user (uid=1)
+- Generating a one-time login link
+- Displaying the link in the terminal
+
+Note: Login links cannot be generated for production or master environments.
+
+## Cache Clearing
+
+The CLI can clear Drupal caches on any environment:
+- Works on all environments including production and master
+- Executes the `drush cr` command on the selected environment
+- Shows the command output in the terminal
+
+## Logging
+
+All operations performed by the CLI are logged to daily log files in the `.logs` directory:
+- Log files are named in the format `log--YYYYMMDD.txt`
+- Each log entry includes a timestamp, the action performed, and the Lagoon command executed
+- Errors are also logged with detailed error messages
+- The logs directory is excluded from Git
+
+## Adding New Commands
+
+To add new commands, modify the `src/interactive.js` file to add new menu options and implement the corresponding functionality in the appropriate modules.

index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { startInteractiveMode } from './src/interactive.js';
+
+program
+  .name('lagoon-wrapper')
+  .description('A CLI wrapper for Lagoon CLI')
+  .version('1.0.0');
+
+program
+  .command('interactive')
+  .description('Start interactive mode')
+  .action(startInteractiveMode);
+
+// Default to interactive mode if no command is specified
+if (process.argv.length === 2) {
+  startInteractiveMode();
+} else {
+  program.parse(process.argv);
+}