ci: add GitHub Actions workflows and test scripts

Author: ARHAEEM

.github/scripts/bump-version.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+set -Eeuo pipefail
+IFS=$'\n\t'
+
+# Script to bump version in n8n-manager.sh and create a version commit
+
+SCRIPT_FILE="n8n-manager.sh"
+
+# Function to get current version
+get_current_version() {
+    grep -E '^SCRIPT_VERSION=' "$SCRIPT_FILE" | cut -d'"' -f2
+}
+
+# Function to bump version (major, minor, patch)
+# Expects one argument: major, minor, or patch
+bump_version_component() {
+    local current_version=$1
+    local component=$2
+    local major minor patch
+
+    major=$(echo "$current_version" | cut -d. -f1)
+    minor=$(echo "$current_version" | cut -d. -f2)
+    patch=$(echo "$current_version" | cut -d. -f3)
+
+    case "$component" in
+        major) major=$((major + 1)); minor=0; patch=0 ;;
+        minor) minor=$((minor + 1)); patch=0 ;;
+        patch) patch=$((patch + 1)) ;;
+        *) echo "Error: Invalid version component '$component' specified."; exit 1 ;;
+    esac
+    echo "$major.$minor.$patch"
+}
+
+# Determine version bump based on commit messages (simplified placeholder)
+# In a real scenario, this would involve analyzing commit messages (e.g., conventional commits)
+# For now, we'll default to 'patch' or take it from an environment variable
+BUMP_TYPE="${VERSION_BUMP_TYPE:-patch}" # Default to patch, can be overridden by env var
+
+CURRENT_VERSION=$(get_current_version)
+NEW_VERSION=$(bump_version_component "$CURRENT_VERSION" "$BUMP_TYPE")
+
+echo "Current version: $CURRENT_VERSION"
+echo "Bumping type: $BUMP_TYPE"
+echo "New version: $NEW_VERSION"
+
+# Update version in script file
+sed -i "s/^SCRIPT_VERSION=.*/SCRIPT_VERSION=\"$NEW_VERSION\"/" "$SCRIPT_FILE"
+
+# Output new version for GitHub Actions
+echo "new_version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+
+# Create a commit for the version bump
+# This part will be handled by the GitHub workflow using the new version
+
+exit 0

.github/scripts/generate-changelog.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+set -Eeuo pipefail
+IFS=$'\n\t'
+
+# Script to generate changelog using conventional-changelog-cli
+
+# Ensure conventional-changelog-cli is installed
+if ! command -v conventional-changelog &> /dev/null
+then
+    echo "conventional-changelog-cli not found. Installing..."
+    npm install -g conventional-changelog-cli conventional-changelog-conventionalcommits
+fi
+
+# Generate changelog
+# The preset 'conventionalcommits' is a good default. Others can be specified.
+# It will overwrite CHANGELOG.md by default.
+conventional-changelog -p conventionalcommits -i CHANGELOG.md -s -r 0
+
+echo "Changelog generated/updated successfully: CHANGELOG.md"
+
+# The workflow will handle committing this file.
+
+exit 0

.github/scripts/test-docs.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+set -e
+
+SCRIPT_FILE='n8n-manager.sh'
+README_FILE='readme.md'
+
+echo "Validating README.md structure..."
+required_sections=("Features" "Prerequisites" "Installation" "Configuration" "Usage")
+
+for section in "${required_sections[@]}"; do
+  if grep -q "## .*$section" $README_FILE; then
+    echo "✅ Found: $section"
+  else
+    echo "❌ Missing: $section"
+    exit 1
+  fi
+done
+
+echo "Checking help text consistency..."
+./$SCRIPT_FILE --help > script-help.txt
+
+if grep -q "Usage:" $README_FILE; then
+  echo "✅ README contains usage information"
+else
+  echo "❌ README missing usage information"
+  exit 1
+fi
+
+echo "Checking version consistency..."
+SCRIPT_VERSION=$(grep -E '^SCRIPT_VERSION=' $SCRIPT_FILE | cut -d'"' -f2)
+
+if grep -q "$SCRIPT_VERSION" $README_FILE; then
+  echo "✅ Version consistent: $SCRIPT_VERSION"
+else
+  echo "❌ Version mismatch in README"
+  echo "Script version: $SCRIPT_VERSION"
+  echo "README version references:"
+  grep -n "version\|Version" $README_FILE || echo "None found"
+  exit 1
+fi

.github/scripts/test-functional.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+set -e
+
+SCRIPT_FILE='n8n-manager.sh'
+
+echo "Creating test n8n container..."
+docker run -d \
+  --name test-n8n \
+  -p 5678:5678 \
+  -e N8N_BASIC_AUTH_ACTIVE=true \
+  -e N8N_BASIC_AUTH_USER=admin \
+  -e N8N_BASIC_AUTH_PASSWORD=password \
+  n8nio/n8n:latest
+
+sleep 30
+docker ps
+
+chmod +x $SCRIPT_FILE
+
+echo "Testing container detection..."
+./$SCRIPT_FILE --action backup --container test-n8n --dry-run --verbose || true
+
+echo "Testing help functionality..."
+./$SCRIPT_FILE --help
+
+echo "Testing configuration file parsing..."
+mkdir -p ~/.config/n8n-manager
+echo 'CONF_VERBOSE=true' > ~/.config/n8n-manager/config
+./$SCRIPT_FILE --action backup --container test-n8n --dry-run || true

.github/scripts/test-integration.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+set -e
+
+INSTALL_FILE='install.sh'
+
+echo "Testing installation process..."
+
+chmod +x $INSTALL_FILE
+
+TEST_DIR=$(mktemp -d)
+cd $TEST_DIR
+
+cp $GITHUB_WORKSPACE/$INSTALL_FILE ./test-install.sh
+
+sed -i 's|/usr/local/bin|./bin|g' ./test-install.sh
+sed -i 's|sudo ||g' ./test-install.sh
+
+mkdir -p ./bin
+
+bash ./test-install.sh || echo "Install test completed (errors expected in CI)"
+
+echo "# Integration Test Results" > integration-report.md
+echo "" >> integration-report.md
+echo "- Test environment: Ubuntu Latest" >> integration-report.md
+echo "- Docker available: $(docker --version)" >> integration-report.md
+echo "- Git available: $(git --version)" >> integration-report.md
+echo "- Curl available: $(curl --version | head -1)" >> integration-report.md

.github/scripts/test-security.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e
+
+SCRIPT_FILE='n8n-manager.sh'
+INSTALL_FILE='install.sh'
+
+echo "# Security Scan Results" > security-report.md
+echo "" >> security-report.md
+
+echo "## Potential Security Issues" >> security-report.md
+
+echo "### Command Injection Risks" >> security-report.md
+grep -n 'eval\|exec\|[`]' $SCRIPT_FILE $INSTALL_FILE >> security-report.md || echo "None found" >> security-report.md
+
+echo "" >> security-report.md
+echo "### Unsafe Variable Usage" >> security-report.md
+grep -n '\$[a-zA-Z_][a-zA-Z0-9_]*[^"]' $SCRIPT_FILE $INSTALL_FILE | head -20 >> security-report.md || echo "None found" >> security-report.md
+
+echo "" >> security-report.md
+echo "### Hardcoded Secrets Check" >> security-report.md
+grep -i -n "password\|secret\|key\|token" $SCRIPT_FILE $INSTALL_FILE | grep -v "GITHUB_TOKEN\|CONF_" >> security-report.md || echo "None found" >> security-report.md

.github/scripts/test-shellcheck.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+set -e
+
+SCRIPT_FILE='n8n-manager.sh'
+INSTALL_FILE='install.sh'
+
+echo "Running ShellCheck on $SCRIPT_FILE..."
+shellcheck -f gcc -e SC1091 -e SC2034 -e SC2154 $SCRIPT_FILE
+
+echo "Running ShellCheck on $INSTALL_FILE..."
+shellcheck -f gcc -e SC1091 $INSTALL_FILE
+
+echo "# ShellCheck Results" > shellcheck-report.md
+echo "" >> shellcheck-report.md
+echo "## Main Script ($SCRIPT_FILE)" >> shellcheck-report.md
+shellcheck -f diff $SCRIPT_FILE >> shellcheck-report.md 2>&1 || true
+echo "" >> shellcheck-report.md
+echo "## Install Script ($INSTALL_FILE)" >> shellcheck-report.md
+shellcheck -f diff $INSTALL_FILE >> shellcheck-report.md 2>&1 || true

.github/scripts/test-syntax.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -e
+
+SCRIPT_FILE='n8n-manager.sh'
+INSTALL_FILE='install.sh'
+
+echo "Validating syntax of $SCRIPT_FILE..."
+bash -n $SCRIPT_FILE
+
+echo "Validating syntax of $INSTALL_FILE..."
+bash -n $INSTALL_FILE
+
+echo "Testing script execution with --help flag..."
+chmod +x $SCRIPT_FILE
+./$SCRIPT_FILE --help || true
+
+echo "Testing script execution with --dry-run flag..."
+./$SCRIPT_FILE --action backup --dry-run --verbose || true

.github/scripts/update-readme-badges.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -Eeuo pipefail
+IFS=$'\n\t'
+
+README_FILE="README.md"
+SCRIPT_FILE="n8n-manager.sh"
+
+# Function to update a badge in README.md
+# Arguments: <badge_name_placeholder> <badge_url>
+update_badge() {
+    local placeholder="$1"
+    local url="$2"
+    # Ensure the placeholder exists before attempting to replace
+    if grep -q "<!-- $placeholder -->" "$README_FILE"; then
+        # Using awk for more robust replacement across lines if needed
+        awk -v placeholder="$placeholder" -v url="$url" '
+        BEGIN {p_start = "<!-- " placeholder " -->"; p_end = "<!-- " placeholder "_END -->"}
+        $0 ~ p_start {print; print url; in_block=1; next}
+        $0 ~ p_end {print; in_block=0; next}
+        !in_block {print}
+        ' "$README_FILE" > tmp_readme.md && mv tmp_readme.md "$README_FILE"
+        echo "Updated badge: $placeholder"
+    else
+        echo "Warning: Placeholder '$placeholder' not found in $README_FILE."
+    fi
+}
+
+# Get script version
+SCRIPT_VERSION=$(grep -E '^SCRIPT_VERSION=' "$SCRIPT_FILE" | cut -d'"' -f2)
+if [ -z "$SCRIPT_VERSION" ]; then
+    echo "Error: Could not extract SCRIPT_VERSION from $SCRIPT_FILE" >&2
+    exit 1
+fi
+
+# Get other dynamic info (placeholders for now, can be expanded)
+REPO_NAME="$(basename -s .git "$(git config --get remote.origin.url)")"
+OWNER_NAME="$(git config --get remote.origin.url | sed -n 's|.*github.com/\([^/]*\)/.*|\1|p')"
+LAST_COMMIT_DATE_FORMATTED=$(date -u +"%Y-%m-%d") # Simplified, actual last commit date is better
+LICENSE_TYPE="MIT" # Assuming MIT, can be made dynamic
+
+# Generate badge URLs (examples)
+VERSION_BADGE_URL="[![Version](https://img.shields.io/badge/version-$SCRIPT_VERSION-blue.svg)](https://github.com/$OWNER_NAME/$REPO_NAME/releases/tag/v$SCRIPT_VERSION)"
+LICENSE_BADGE_URL="[![License](https://img.shields.io/badge/license-$LICENSE_TYPE-green.svg)](LICENSE)"
+LAST_COMMIT_BADGE_URL="[![Last Commit](https://img.shields.io/badge/last%20commit-$LAST_COMMIT_DATE_FORMATTED-orange.svg)](https://github.com/$OWNER_NAME/$REPO_NAME/commits/main)"
+# Add more badges as needed (e.g., open issues, stars, build status from ci.yml)
+# BUILD_STATUS_BADGE_URL="[![Build Status](https://github.com/$OWNER_NAME/$REPO_NAME/actions/workflows/ci.yml/badge.svg)](https://github.com/$OWNER_NAME/$REPO_NAME/actions/workflows/ci.yml)"
+
+# Update badges in README
+update_badge "BADGE_VERSION" "$VERSION_BADGE_URL"
+update_badge "BADGE_LICENSE" "$LICENSE_BADGE_URL"
+update_badge "BADGE_LAST_COMMIT" "$LAST_COMMIT_BADGE_URL"
+# update_badge "BADGE_BUILD_STATUS" "$BUILD_STATUS_BADGE_URL"
+
+echo "README badges update process completed."
+
+# The workflow will handle committing this file.
+
+exit 0