[#1] Implemented branch deployment feature.

Author: richardgaunt

CLAUDE.md

@@ -29,5 +29,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 - Checkout Github issues for outstanding issues
 - Implement each issue in a feature branch based on main
+- Commit messages are written in past tense and are 1 line to explain what has been fixed, added, enhanced.
 - Create a pull request with changes using the PR template located in `.github/PULL_REQUEST_TEMPLATE.md`
 - Add tests as required to prove the work

README.md

@@ -48,6 +48,7 @@ This will start the interactive mode, which will guide you through:
    - Deleting environments (except protected ones)
    - Generating login links for environments
    - Clearing Drupal caches
+   - Deploying branches to environments
    - Viewing GitHub PR links for PR environments
 
 ## Features
@@ -58,6 +59,8 @@ This will start the interactive mode, which will guide you through:
 - GitHub PR integration for PR environments
 - One-click login link generation for Drupal environments
 - Quick Drupal cache clearing for any environment
+- Branch deployment with autocomplete selection
+- SSH key configuration for Lagoon authentication
 - Comprehensive logging of all operations
 - Extensible architecture for adding new commands
 
@@ -92,6 +95,17 @@ The CLI can clear Drupal caches on any environment:
 - Executes the `drush cr` command on the selected environment
 - Shows the command output in the terminal
 
+## Branch Deployment
+
+The CLI can deploy any branch from a project's git repository:
+- Automatically fetches and lists all available branches with autocomplete search
+- Prioritizes main branches (main, master, develop) at the top of the list
+- Initiates deployment of the selected branch to the Lagoon environment
+- Provides real-time feedback about the deployment status
+- Validates branch names to prevent command injection
+
+Note: Branch deployment is asynchronous and may take several minutes to complete. You can check the status in the Lagoon UI.
+
 ## Logging
 
 All operations performed by the CLI are logged to daily log files in the `.logs` directory:

index.js index.mjsindex.js renamed to index.mjs

@@ -1,6 +1,6 @@
 
 import { program } from 'commander';
-import { startInteractiveMode } from './src/interactive';
+import { startInteractiveMode } from './src/interactive.mjs';
 
 program
   .name('lagoon-wrapper')

package-lock.json

@@ -2,10 +2,9 @@
   "name": "lagoon-cli-wrapper",
   "version": "1.0.0",
   "description": "A CLI wrapper for Lagoon CLI",
-  "main": "index.js",
-  "type": "module",
+  "main": "index.mjs",
   "scripts": {
-    "start": "node index.js",
+    "start": "node index.mjs",
     "lint": "eslint . --ext .mjs",
     "lint:fix": "eslint . --ext .mjs --fix",
     "lint:report": "eslint . --ext .mjs -f json -o eslint-report.json"
@@ -24,7 +23,11 @@
     "eslint-plugin-n": "^17.17.0",
     "globals": "^16.1.0",
     "inquirer": "^9.2.12",
+    "inquirer-autocomplete-prompt": "^3.0.1",
     "js-yaml": "^4.1.0",
     "ora": "^7.0.1"
+  },
+  "engine": {
+    "node": ">22"
   }
 }