aidevops 2.52.1 → 2.53.2

package/.agent/scripts/gitlab-cli-helper.sh

@@ -1,682 +0,0 @@
-#!/bin/bash
-# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
-
-# GitLab CLI Helper Script
-# Comprehensive GitLab management using GitLab CLI (glab)
-# Managed by AI DevOps Framework
-
-# Set strict mode
-set -euo pipefail
-
-# ------------------------------------------------------------------------------
-# CONFIGURATION & CONSTANTS
-# ------------------------------------------------------------------------------
-
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
-readonly SCRIPT_DIR="$script_dir"
-
-repo_root="$(dirname "$SCRIPT_DIR")"
-readonly REPO_ROOT="$repo_root"
-readonly CONFIG_FILE="$REPO_ROOT/configs/gitlab-cli-config.json"
-
-# Colors
-readonly BLUE='\033[0;34m'
-readonly GREEN='\033[0;32m'
-readonly YELLOW='\033[1;33m'
-readonly RED='\033[0;31m'
-readonly NC='\033[0m'
-
-# Common constants
-readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
-# Error Messages
-readonly ERROR_CONFIG_MISSING="Configuration file not found at $CONFIG_FILE"
-readonly ERROR_GLAB_NOT_INSTALLED="GitLab CLI (glab) is required but not installed"
-readonly ERROR_NOT_LOGGED_IN="GitLab CLI is not authenticated. Run 'glab auth login'"
-readonly ERROR_ACCOUNT_MISSING="Account configuration not found"
-readonly ERROR_ARGS_MISSING="Missing required arguments"
-readonly ERROR_API_FAILED="GitLab API request failed"
-
-readonly ERROR_PROJECT_NOT_FOUND="Project not found"
-readonly ERROR_INSTANCE_URL_NOT_CONFIGURED="Instance URL not configured for account"
-readonly ERROR_FAILED_TO_READ_CONFIG="Failed to read configuration"
-readonly ERROR_PROJECT_NAME_REQUIRED="Project name is required"
-readonly ERROR_ISSUE_TITLE_REQUIRED="Issue title is required"
-readonly ERROR_ISSUE_NUMBER_REQUIRED="Issue number is required"
-readonly ERROR_MR_TITLE_REQUIRED="Merge request title is required"
-readonly ERROR_MR_NUMBER_REQUIRED="Merge request number is required"
-readonly ERROR_BRANCH_NAME_REQUIRED="Branch name is required"
-
-# Success Messages
-readonly SUCCESS_PROJECT_CREATED="Project created successfully"
-readonly SUCCESS_ISSUE_CREATED="Issue created successfully"
-readonly SUCCESS_MR_CREATED="Merge request created successfully"
-readonly SUCCESS_BRANCH_CREATED="Branch created successfully"
-readonly SUCCESS_ISSUE_CLOSED="Issue closed successfully"
-readonly SUCCESS_MR_MERGED="Merge request merged successfully"
-
-# Common constants
-readonly CONTENT_TYPE_JSON="$CONTENT_TYPE_JSON"
-readonly AUTH_HEADER_TOKEN="Authorization: token"
-
-# ------------------------------------------------------------------------------
-# UTILITY FUNCTIONS
-# ------------------------------------------------------------------------------
-
-print_info() {
-    local msg="$1"
-    echo -e "${BLUE}[INFO]${NC} $msg"
-    return 0
-}
-
-print_success() {
-    local msg="$1"
-    echo -e "${GREEN}[SUCCESS]${NC} $msg"
-    return 0
-}
-
-print_warning() {
-    local msg="$1"
-    echo -e "${YELLOW}[WARNING]${NC} $msg"
-    return 0
-}
-
-print_error() {
-    local msg="$1"
-    echo -e "${RED}[ERROR]${NC} $msg" >&2
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# DEPENDENCY CHECKING
-# ------------------------------------------------------------------------------
-
-check_dependencies() {
-    if ! command -v glab &> /dev/null; then
-        print_error "$ERROR_GLAB_NOT_INSTALLED"
-        print_info "Install GitLab CLI:"
-        print_info "  macOS: brew install glab"
-        print_info "  Ubuntu: sudo apt install glab"
-        print_info "  Other: https://glab.readthedocs.io/en/latest/installation/"
-        exit 1
-    fi
-
-    if ! glab auth status &> /dev/null; then
-        print_error "$ERROR_NOT_LOGGED_IN"
-        print_info "Authenticate with: glab auth login"
-        exit 1
-    fi
-
-    if ! command -v jq &> /dev/null; then
-        print_error "jq is required but not installed"
-        print_info "Install: brew install jq (macOS) or sudo apt install jq (Ubuntu)"
-        exit 1
-    fi
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# CONFIGURATION LOADING
-# ------------------------------------------------------------------------------
-
-load_config() {
-    if [[ ! -f "$CONFIG_FILE" ]]; then
-        print_error "$ERROR_CONFIG_MISSING"
-        print_info "Create configuration: cp configs/gitlab-cli-config.json.txt $CONFIG_FILE"
-        return 1
-    fi
-    return 0
-}
-
-get_account_config() {
-    local account_name="$1"
-    
-    if [[ -z "$account_name" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local config
-    if ! config=$(jq -r ".accounts.\"$account_name\"" "$CONFIG_FILE" 2>/dev/null); then
-        print_error "$ERROR_FAILED_TO_READ_CONFIG"
-        return 1
-    fi
-
-    if [[ "$config" == "null" ]]; then
-        print_error "$ERROR_ACCOUNT_MISSING: $account_name"
-        return 1
-    fi
-
-    echo "$config"
-    return 0
-}
-
-get_project_info() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local config
-    config=$(get_account_config "$account_name") || exit 1
-
-    local instance_url
-    instance_url=$(echo "$config" | jq -r '.instance_url // "EMPTY"')
-    if [[ "$instance_url" == "EMPTY" || -z "$instance_url" ]]; then
-        print_error "Instance URL not configured for account: $account_name"
-        return 1
-    fi
-
-    # Try to find project by name or ID
-    local project_info
-    if project_info=$(glab api "projects?search=$project_identifier" --jq ".[] | select(.name_with_namespace == \"$project_identifier\" or .path == \"$project_identifier\" or .id == ($project_identifier | tonumber?))" 2>/dev/null) && [[ -n "$project_info" ]]; then
-        echo "$project_info" | jq -r '.id'
-        return 0
-    fi
-
-    # If not found, try exact match
-    if project_info=$(glab api "projects?search=$project_identifier" --jq ".[] | select(.path_with_namespace == \"$project_identifier\") | .id" 2>/dev/null); then
-        echo "$project_info"
-        return 0
-    fi
-
-    print_error "$ERROR_PROJECT_NOT_FOUND: $project_identifier"
-    return 1
-}
-
-# ------------------------------------------------------------------------------
-# PROJECT MANAGEMENT
-# ------------------------------------------------------------------------------
-
-list_projects() {
-    local account_name="$1"
-    local filter="${2:-}"
-    local visibility="${3:-}"
-    
-    local config
-    config=$(get_account_config "$account_name") || exit 1
-
-    local instance_url
-    instance_url=$(echo "$config" | jq -r '.instance_url // "EMPTY"')
-    if [[ "$instance_url" == "EMPTY" || -z "$instance_url" ]]; then
-        print_error "Instance URL not configured for account: $account_name"
-        return 1
-    fi
-
-    print_info "Listing projects from $instance_url..."
-    
-    local api_path="projects"
-    local query_params=""
-    
-    if [[ -n "$filter" ]]; then
-        query_params="${query_params}&search=$filter"
-    fi
-    if [[ -n "$visibility" ]]; then
-        query_params="${query_params}&visibility=$visibility"
-    fi
-
-    if [[ -n "$query_params" ]]; then
-        api_path="$api_path?${query_params#&}"
-    fi
-
-    if ! glab api "$api_path" --jq '.[] | "\(.id): \(.name_with_namespace) (\(.visibility))"'; then
-        print_error "$ERROR_API_FAILED"
-        return 1
-    fi
-    return 0
-}
-
-create_project() {
-    local account_name="$1"
-    local project_name="$2"
-    local project_description="${3:-}"
-    local visibility="${4:-public}"
-    local initialize_with_readme="${5:-false}"
-
-    if [[ -z "$project_name" ]]; then
-        print_error "$ERROR_PROJECT_NAME_REQUIRED"
-        print_info "Usage: gitlab-cli-helper.sh create-project <account> <name> [description] [visibility] [init]"
-        return 1
-    fi
-
-    local config
-    config=$(get_account_config "$account_name") || exit 1
-
-    local instance_url
-    instance_url=$(echo "$config" | jq -r '.instance_url // "EMPTY"')
-    if [[ "$instance_url" == "EMPTY" || -z "$instance_url" ]]; then
-        print_error "$ERROR_INSTANCE_URL_NOT_CONFIGURED: $account_name"
-        return 1
-    fi
-
-    local group_path
-    group_path=$(echo "$config" | jq -r '.default_group // "EMPTY"')
-
-    print_info "Creating project: $project_name"
-
-    local project_data
-    project_data="{\"name\": \"$project_name\""
-    if [[ -n "$project_description" ]]; then
-        project_data="$project_data, \"description\": \"$project_description\""
-    fi
-    project_data="$project_data, \"visibility\": \"$visibility\""
-    if [[ "$initialize_with_readme" == "true" ]]; then
-        project_data="$project_data, \"initialize_with_readme\": true"
-    fi
-
-    local api_path="projects"
-    if [[ "$group_path" != "EMPTY" && -n "$group_path" ]]; then
-        api_path="groups/$group_path/projects"
-    fi
-
-    local create_data
-    if create_data=$(glab api --method POST "$api_path" --field "$project_data" 2>/dev/null); then
-        local project_id
-        project_id=$(echo "$create_data" | jq -r '.id')
-        local project_path
-        project_path=$(echo "$create_data" | jq -r '.path_with_namespace')
-        print_success "$SUCCESS_PROJECT_CREATED: $project_path (ID: $project_id)"
-        
-        # Add to configuration
-        jq --arg project_id "$project_id" --arg project_path "$project_path" --arg name "$project_name" \
-           '.projects[$project_id] = {id: $project_id, path: $project_path, name: $name, account: $account_name}' \
-           "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
-    else
-        print_error "Failed to create project"
-        return 1
-    fi
-    return 0
-}
-
-delete_project() {
-    local account_name="$1"
-    local project_identifier="$2"
-
-    if [[ -z "$project_identifier" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_warning "This will permanently delete project (ID: $project_id)"
-    print_info "To confirm, type 'DELETE':"
-    read -r confirmation
-
-    if [[ "$confirmation" != "DELETE" ]]; then
-        print_info "Deletion cancelled"
-        return 0
-    fi
-
-    print_info "Deleting project ID: $project_id"
-    
-    if glab api --method DELETE "projects/$project_id"; then
-        print_success "Project deleted successfully"
-        
-        # Remove from configuration
-        jq --arg project_id "$project_id" 'del(.projects[$project_id])' \
-           "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
-    else
-        print_error "Failed to delete project"
-        return 1
-    fi
-    return 0
-}
-
-get_project_details() {
-    local account_name="$1"
-    local project_identifier="$2"
-
-    if [[ -z "$project_identifier" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Project details (ID: $project_id):"
-    glab api "projects/$project_id"
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# ISSUE MANAGEMENT
-# ------------------------------------------------------------------------------
-
-list_issues() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local state="${3:-opened}"
-
-    if [[ -z "$project_identifier" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Listing issues for project (ID: $project_id) (state: $state)"
-    glab api "projects/$project_id/issues?state=$state" --jq '.[] | "##\(.iid): \(.title) (\(.state))"'
-    return 0
-}
-
-create_issue() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local title="$3"
-    local description="${4:-}"
-
-    if [[ -z "$title" ]]; then
-        print_error "$ERROR_ISSUE_TITLE_REQUIRED"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Creating issue in project (ID: $project_id)"
-
-    if glab issue create --project "$project_id" --title "$title" --description "$description"; then
-        print_success "$SUCCESS_ISSUE_CREATED"
-    else
-        print_error "Failed to create issue"
-        return 1
-    fi
-    return 0
-}
-
-close_issue() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local issue_number="$3"
-
-    if [[ -z "$issue_number" ]]; then
-        print_error "$ERROR_ISSUE_NUMBER_REQUIRED"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Closing issue #$issue_number in project (ID: $project_id)"
-
-    if glab issue update --project "$project_id" "$issue_number" --state-event close; then
-        print_success "$SUCCESS_ISSUE_CLOSED"
-    else
-        print_error "Failed to close issue"
-        return 1
-    fi
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# MERGE REQUEST MANAGEMENT
-# ------------------------------------------------------------------------------
-
-list_merge_requests() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local state="${3:-opened}"
-
-    if [[ -z "$project_identifier" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Listing merge requests for project (ID: $project_id) (state: $state)"
-    glab api "projects/$project_id/merge_requests?state=$state" --jq '.[] | "!#\(.iid): \(.title) (\(.state))"'
-    return 0
-}
-
-create_merge_request() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local title="$3"
-    local source_branch="${4:-}"
-    local target_branch="${5:-main}"
-    local description="${6:-}"
-
-    if [[ -z "$title" || -z "$source_branch" ]]; then
-        print_error "$ERROR_MR_TITLE_REQUIRED"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Creating merge request in project (ID: $project_id)"
-
-    if glab mr create --project "$project_id" --title "$title" --source-branch "$source_branch" --target-branch "$target_branch" --description "$description"; then
-        print_success "$SUCCESS_MR_CREATED"
-    else
-        print_error "Failed to create merge request"
-        return 1
-    fi
-    return 0
-}
-
-merge_merge_request() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local mr_number="$3"
-    local merge_method="${4:-merge}"
-
-    if [[ -z "$mr_number" ]]; then
-        print_error "$ERROR_MR_NUMBER_REQUIRED"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Merging merge request !#$mr_number in project (ID: $project_id)"
-
-    if glab mr merge --project "$project_id" "$mr_number" --yes --"$merge_method"; then
-        print_success "$SUCCESS_MR_MERGED"
-    else
-        print_error "Failed to merge merge request"
-        return 1
-    fi
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# BRANCH MANAGEMENT
-# ------------------------------------------------------------------------------
-
-list_branches() {
-    local account_name="$1"
-    local project_identifier="$2"
-
-    if [[ -z "$project_identifier" ]]; then
-        print_error "$ERROR_ARGS_MISSING"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Listing branches for project (ID: $project_id)"
-    glab api "projects/$project_id/repository/branches" --jq '.[] | .name'
-    return 0
-}
-
-create_branch() {
-    local account_name="$1"
-    local project_identifier="$2"
-    local branch_name="$3"
-    local source_branch="${4:-main}"
-
-    if [[ -z "$branch_name" ]]; then
-        print_error "$ERROR_BRANCH_NAME_REQUIRED"
-        return 1
-    fi
-
-    local project_id
-    project_id=$(get_project_info "$account_name" "$project_identifier") || exit 1
-
-    print_info "Creating branch '$branch_name' in project (ID: $project_id) from '$source_branch'"
-
-    local branch_data
-    branch_data="{\"branch\": \"$branch_name\", \"ref\": \"$source_branch\"}"
-
-    if glab api --method POST "projects/$project_id/repository/branches" --field "$branch_data"; then
-        print_success "$SUCCESS_BRANCH_CREATED"
-    else
-        print_error "Failed to create branch"
-        return 1
-    fi
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# ACCOUNT MANAGEMENT
-# ------------------------------------------------------------------------------
-
-list_accounts() {
-    print_info "Configured GitLab accounts:"
-    if [[ -f "$CONFIG_FILE" ]]; then
-        jq -r '.accounts | keys[]' "$CONFIG_FILE" 2>/dev/null || print_warning "No accounts configured"
-    else
-        print_warning "Configuration file not found"
-    fi
-    return 0
-}
-
-show_help() {
-    cat << EOF
-GitLab CLI Helper Script
-Usage: $0 [command] [account] [arguments]
-
-GitLab management using GitLab CLI (glab)
-
-COMMANDS:
-  Project Management:
-    list-projects [account] [filter] [vis]   - List projects
-      filter: search term
-      visibility: internal|private|public
-    create-project <account> <name> [desc] [vis] [init] - Create project
-      visibility: internal|private|public (default: public)
-      init: true|false to create README (default: false)
-    delete-project <account> <project_id>    - Delete project (requires confirmation)
-    get-project <account> <identifier>       - Get project details
-
-  Issue Management:
-    list-issues <account> <project> [state]  - List issues (opened|closed|all)
-    create-issue <account> <project> <title> [desc] - Create issue
-    close-issue <account> <project> <number> - Close issue
-
-  Merge Request Management:
-    list-mrs <account> <project> [state]     - List merge requests
-    create-mr <account> <project> <title> <source> [target] [desc] - Create MR
-    merge-mr <account> <project> <number> [method] - Merge MR (merge|squash|rebase)
-
-  Branch Management:
-    list-branches <account> <project>        - List branches
-    create-branch <account> <project> <branch> [source] - Create branch
-
-  Account Management:
-    list-accounts                           - List configured accounts
-    help                                    - $HELP_SHOW_MESSAGE
-
-EXAMPLES:
-  $0 list-projects marcusquinn
-  $0 create-project marcusquinn new-project "My GitLab project" private true
-  $0 list-issues marcusquinn my-project opened
-  $0 create-issue marcusquinn my-project "Bug report" "Issue description"
-  $0 create-mr marcusquinn my-project "Fix feature" fix-branch main
-
-CONFIGURATION:
-  File: configs/gitlab-cli-config.json
-  Example: cp configs/gitlab-cli-config.json.txt configs/gitlab-cli-config.json
-
-REQUIREMENTS:
-  - GitLab CLI (glab) installed and authenticated
-  - jq JSON processor
-  - Valid GitLab access token
-
-For more information, see the GitLab CLI documentation: https://glab.readthedocs.io/
-EOF
-    return 0
-}
-
-# ------------------------------------------------------------------------------
-# MAIN COMMAND HANDLER
-# ------------------------------------------------------------------------------
-
-main() {
-    local command="${1:-help}"
-    local account_name="$2"
-    local target="$3"
-    local options="$4"
-
-    case "$command" in
-        "list-projects")
-            list_projects "$account_name" "$target" "$options"
-            ;;
-        "create-project")
-            local proj_desc="$options"
-            local proj_vis="$5"
-            local proj_init="$6"
-            create_project "$account_name" "$target" "$proj_desc" "$proj_vis" "$proj_init"
-            ;;
-        "delete-project")
-            delete_project "$account_name" "$target"
-            ;;
-        "get-project")
-            get_project_details "$account_name" "$target"
-            ;;
-        "list-issues")
-            list_issues "$account_name" "$target" "$options"
-            ;;
-        "create-issue")
-            local issue_desc="$5"
-            create_issue "$account_name" "$target" "$options" "$issue_desc"
-            ;;
-        "close-issue")
-            close_issue "$account_name" "$target" "$options"
-            ;;
-        "list-mrs")
-            list_merge_requests "$account_name" "$target" "$options"
-            ;;
-        "create-mr")
-            local mr_src="$5"
-            local mr_tgt="$6"
-            local mr_desc="$7"
-            create_merge_request "$account_name" "$target" "$options" "$mr_src" "$mr_tgt" "$mr_desc"
-            ;;
-        "merge-mr")
-            local mr_method="$5"
-            merge_merge_request "$account_name" "$target" "$options" "$mr_method"
-            ;;
-        "list-branches")
-            list_branches "$account_name" "$target"
-            ;;
-        "create-branch")
-            local branch_src="$5"
-            create_branch "$account_name" "$target" "$options" "$branch_src"
-            ;;
-        "list-accounts")
-            list_accounts
-            ;;
-        "help"|"-h"|"--help")
-            show_help
-            ;;
-        *)
-            print_error "$ERROR_UNKNOWN_COMMAND $command"
-            print_info "Use '$0 help' for usage information"
-            exit 1
-            ;;
-    esac
-    
-    return 0
-}
-
-# Initialize
-check_dependencies
-load_config
-
-# Execute main function
-main "$@"