cc-devflow 2.4.6 → 4.1.0

package/.claude/scripts/common.sh

@@ -36,7 +36,7 @@ get_repo_root() {
     fi
 }
 
-# Get current requirement ID from branch or environment
+# Get current requirement ID from worktree path, branch, or environment
 # Returns: REQ-XXX or BUG-XXX format
 get_current_req_id() {
     # First check if DEVFLOW_REQ_ID environment variable is set
@@ -45,8 +45,19 @@ get_current_req_id() {
         return
     fi
 
-    # Then check git branch if available
-    if git rev-parse --abbrev-ref HEAD >/dev/null 2>&1; then
+    # Check if in git repo
+    if git rev-parse --show-toplevel >/dev/null 2>&1; then
+        # Try to extract from worktree directory name first (e.g., cc-devflow-REQ-123)
+        local git_root
+        git_root=$(git rev-parse --show-toplevel)
+        local dir_name
+        dir_name=$(basename "$git_root")
+        if [[ "$dir_name" =~ -([A-Z]+-[0-9]+(-[0-9]+)?)$ ]]; then
+            echo "${BASH_REMATCH[1]}"
+            return
+        fi
+
+        # Then check git branch
         local branch=$(git rev-parse --abbrev-ref HEAD)
         # Extract REQ-XXX or BUG-XXX from branch name like feature/REQ-123-title or feature/REQ-20251006-001-title
         # Support formats: REQ-123, REQ-20251006-001, BUG-456, etc.
@@ -562,9 +573,665 @@ list_archived_reqs() {
     fi
 }
 
+# Get archive summary for a requirement
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: JSON summary of archived requirement
+get_archive_summary() {
+    local repo_root="$1"
+    local req_id="$2"
+    local archived_path=$(find_archived_req "$repo_root" "$req_id")
+
+    if [[ -z "$archived_path" ]]; then
+        echo "{\"error\": \"not_found\"}"
+        return 1
+    fi
+
+    local status_file="$archived_path/orchestration_status.json"
+    if [[ -f "$status_file" ]]; then
+        jq '{
+            reqId: .reqId,
+            title: .title,
+            status: .status,
+            archivedReason: .archivedReason,
+            archivedAt: .archivedAt,
+            archiveLocation: .archiveLocation,
+            statusBeforeArchive: .statusBeforeArchive
+        }' "$status_file"
+    else
+        echo "{\"reqId\": \"$req_id\", \"archiveLocation\": \"$archived_path\"}"
+    fi
+}
+
+# Check if requirement has deltas to archive
+# Args: $1 - requirement directory
+# Returns: 0 if has deltas, 1 if not
+has_deltas_to_archive() {
+    local req_dir="$1"
+    local deltas_dir="$req_dir/deltas"
+
+    if [[ -d "$deltas_dir" ]]; then
+        local count=$(find "$deltas_dir" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l)
+        [[ $count -gt 0 ]] && return 0
+    fi
+    return 1
+}
+
+# Get delta count for a requirement
+# Args: $1 - requirement directory
+# Returns: number of deltas
+get_delta_count() {
+    local req_dir="$1"
+    local deltas_dir="$req_dir/deltas"
+
+    if [[ -d "$deltas_dir" ]]; then
+        find "$deltas_dir" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' '
+    else
+        echo "0"
+    fi
+}
+
+# =============================================================================
+# Git Worktree Functions (v4.3)
+# =============================================================================
+
+# Check if currently in a git worktree (not main repo)
+# Returns: 0 if in worktree, 1 if in main repo or not in git
+is_in_worktree() {
+    local git_dir
+    git_dir=$(git rev-parse --git-dir 2>/dev/null) || return 1
+
+    # If .git is a file (not directory), we're in a worktree
+    if [[ -f "$(git rev-parse --show-toplevel 2>/dev/null)/.git" ]]; then
+        return 0
+    fi
+    return 1
+}
+
+# Get the main repository path (works from any worktree)
+# Returns: absolute path to main repository
+get_main_repo_path() {
+    local git_root
+    git_root=$(git rev-parse --show-toplevel 2>/dev/null) || return 1
+
+    if is_in_worktree; then
+        # Read gitdir from .git file and extract main repo path
+        local gitdir_content
+        gitdir_content=$(cat "$git_root/.git" 2>/dev/null)
+        if [[ "$gitdir_content" =~ ^gitdir:\ (.+)$ ]]; then
+            local gitdir="${BASH_REMATCH[1]}"
+            # gitdir format: /path/to/main/.git/worktrees/name
+            echo "$gitdir" | sed 's|/.git/worktrees/.*||'
+        fi
+    else
+        echo "$git_root"
+    fi
+}
+
+# Get current worktree path
+# Returns: absolute path to current worktree (or main repo if not in worktree)
+get_worktree_path() {
+    git rev-parse --show-toplevel 2>/dev/null
+}
+
+# Get worktree directory for a specific REQ_ID
+# Args: $1 - REQ_ID
+# Returns: expected worktree path (may not exist)
+get_worktree_dir_for_req() {
+    local req_id="$1"
+    local main_repo
+    main_repo=$(get_main_repo_path) || return 1
+
+    local repo_name
+    repo_name=$(basename "$main_repo")
+
+    echo "$(dirname "$main_repo")/${repo_name}-${req_id}"
+}
+
+# Check if a worktree exists for a specific REQ_ID
+# Args: $1 - REQ_ID
+# Returns: 0 if exists, 1 if not
+worktree_exists_for_req() {
+    local req_id="$1"
+    local worktree_dir
+    worktree_dir=$(get_worktree_dir_for_req "$req_id")
+
+    [[ -d "$worktree_dir" ]]
+}
+
+# Extract REQ_ID from current worktree path or branch
+# Returns: REQ_ID or empty string
+get_req_id_from_worktree() {
+    local git_root
+    git_root=$(git rev-parse --show-toplevel 2>/dev/null) || return 1
+
+    # Try to extract from directory name first (e.g., cc-devflow-REQ-123)
+    local dir_name
+    dir_name=$(basename "$git_root")
+    if [[ "$dir_name" =~ -([A-Z]+-[0-9]+(-[0-9]+)?)$ ]]; then
+        echo "${BASH_REMATCH[1]}"
+        return 0
+    fi
+
+    # Fall back to branch name
+    local branch
+    branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+    if [[ "$branch" =~ (REQ-[0-9]+(-[0-9]+)?|BUG-[0-9]+(-[0-9]+)?) ]]; then
+        echo "${BASH_REMATCH[1]}"
+        return 0
+    fi
+
+    echo ""
+}
+
+# List all worktrees with their REQ_IDs
+# Output format: path|branch|req_id (one per line)
+list_worktrees_with_req() {
+    local main_repo
+    main_repo=$(get_main_repo_path) || return 1
+
+    git -C "$main_repo" worktree list --porcelain | while IFS= read -r line; do
+        if [[ "$line" =~ ^worktree ]]; then
+            local path="${line#worktree }"
+        elif [[ "$line" =~ ^branch ]]; then
+            local branch="${line#branch refs/heads/}"
+            local req_id=""
+            local dir_name
+            dir_name=$(basename "$path")
+            if [[ "$dir_name" =~ -([A-Z]+-[0-9]+(-[0-9]+)?)$ ]]; then
+                req_id="${BASH_REMATCH[1]}"
+            elif [[ "$branch" =~ (REQ-[0-9]+(-[0-9]+)?|BUG-[0-9]+(-[0-9]+)?) ]]; then
+                req_id="${BASH_REMATCH[1]}"
+            fi
+            echo "${path}|${branch}|${req_id}"
+        elif [[ "$line" =~ ^detached ]]; then
+            local req_id=""
+            local dir_name
+            dir_name=$(basename "$path")
+            if [[ "$dir_name" =~ -([A-Z]+-[0-9]+(-[0-9]+)?)$ ]]; then
+                req_id="${BASH_REMATCH[1]}"
+            fi
+            echo "${path}|(detached)|${req_id}"
+        fi
+    done
+}
+
 # Color output helpers
 color_red() { echo -e "\033[0;31m$1\033[0m"; }
 color_green() { echo -e "\033[0;32m$1\033[0m"; }
 color_yellow() { echo -e "\033[0;33m$1\033[0m"; }
 color_blue() { echo -e "\033[0;34m$1\033[0m"; }
 color_bold() { echo -e "\033[1m$1\033[0m"; }
+
+# =============================================================================
+# Claude Team Functions (v4.7)
+# =============================================================================
+
+# Check if Team mode is enabled for a requirement
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: 0 if Team mode enabled, 1 if not
+is_team_mode_enabled() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ -f "$status_file" ]]; then
+        local team_mode
+        team_mode=$(jq -r '.team.mode // empty' "$status_file" 2>/dev/null)
+        [[ -n "$team_mode" ]] && return 0
+    fi
+    return 1
+}
+
+# Initialize Team state in orchestration_status.json
+# Args: $1 - repo root, $2 - requirement ID, $3 - team mode (sequential|parallel), $4 - lead ID
+init_team_state() {
+    local repo_root="$1"
+    local req_id="$2"
+    local mode="${3:-parallel}"
+    local lead="${4:-team-lead}"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    # Add team state using jq
+    jq --arg mode "$mode" --arg lead "$lead" --arg now "$now" '
+        .team = {
+            mode: $mode,
+            lead: $lead,
+            teammates: [],
+            taskAssignments: {},
+            createdAt: $now,
+            updatedAt: $now
+        } |
+        .ralphLoop = {
+            enabled: true,
+            teammates: {},
+            globalIteration: 0,
+            maxIterations: 10,
+            startedAt: $now
+        }
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# Add a teammate to Team state
+# Args: $1 - repo root, $2 - requirement ID, $3 - teammate ID, $4 - role
+add_teammate() {
+    local repo_root="$1"
+    local req_id="$2"
+    local teammate_id="$3"
+    local role="${4:-developer}"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    jq --arg id "$teammate_id" --arg role "$role" --arg now "$now" '
+        .team.teammates += [{
+            id: $id,
+            role: $role,
+            status: "idle",
+            currentTask: null,
+            completedTasks: [],
+            lastActiveAt: $now
+        }] |
+        .team.updatedAt = $now |
+        .ralphLoop.teammates[$id] = {
+            iteration: 0,
+            lastVerifyResult: "skipped"
+        }
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# Update teammate status
+# Args: $1 - repo root, $2 - requirement ID, $3 - teammate ID, $4 - status, $5 - current task (optional)
+update_teammate_status() {
+    local repo_root="$1"
+    local req_id="$2"
+    local teammate_id="$3"
+    local status="$4"
+    local current_task="${5:-null}"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    # Handle null vs string for current_task
+    if [[ "$current_task" == "null" ]]; then
+        jq --arg id "$teammate_id" --arg status "$status" --arg now "$now" '
+            (.team.teammates[] | select(.id == $id)) |= (
+                .status = $status |
+                .currentTask = null |
+                .lastActiveAt = $now
+            ) |
+            .team.updatedAt = $now
+        ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+    else
+        jq --arg id "$teammate_id" --arg status "$status" --arg task "$current_task" --arg now "$now" '
+            (.team.teammates[] | select(.id == $id)) |= (
+                .status = $status |
+                .currentTask = $task |
+                .lastActiveAt = $now
+            ) |
+            .team.updatedAt = $now
+        ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+    fi
+}
+
+# Mark task as completed by teammate
+# Args: $1 - repo root, $2 - requirement ID, $3 - teammate ID, $4 - task ID
+mark_teammate_task_complete() {
+    local repo_root="$1"
+    local req_id="$2"
+    local teammate_id="$3"
+    local task_id="$4"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    jq --arg id "$teammate_id" --arg task "$task_id" --arg now "$now" '
+        (.team.teammates[] | select(.id == $id)) |= (
+            .completedTasks += [$task] |
+            .currentTask = null |
+            .status = "idle" |
+            .lastActiveAt = $now
+        ) |
+        .team.updatedAt = $now
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# Assign task to teammate
+# Args: $1 - repo root, $2 - requirement ID, $3 - task ID, $4 - teammate ID
+assign_task_to_teammate() {
+    local repo_root="$1"
+    local req_id="$2"
+    local task_id="$3"
+    local teammate_id="$4"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    jq --arg task "$task_id" --arg id "$teammate_id" --arg now "$now" '
+        .team.taskAssignments[$task] = $id |
+        (.team.teammates[] | select(.id == $id)) |= (
+            .currentTask = $task |
+            .status = "working" |
+            .lastActiveAt = $now
+        ) |
+        .team.updatedAt = $now
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# Get teammate by ID
+# Args: $1 - repo root, $2 - requirement ID, $3 - teammate ID
+# Returns: JSON object of teammate state
+get_teammate() {
+    local repo_root="$1"
+    local req_id="$2"
+    local teammate_id="$3"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "{}"
+        return 1
+    fi
+
+    jq --arg id "$teammate_id" '.team.teammates[] | select(.id == $id)' "$status_file" 2>/dev/null
+}
+
+# List all teammates
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: JSON array of teammates
+list_teammates() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "[]"
+        return 1
+    fi
+
+    jq '.team.teammates // []' "$status_file" 2>/dev/null
+}
+
+# Get unassigned tasks (tasks not in taskAssignments)
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: List of unassigned task IDs
+get_unassigned_tasks() {
+    local repo_root="$1"
+    local req_id="$2"
+    local req_dir
+    req_dir=$(get_req_dir "$repo_root" "$req_id")
+    local tasks_file="$req_dir/TASKS.md"
+    local status_file="$req_dir/orchestration_status.json"
+
+    if [[ ! -f "$tasks_file" ]] || [[ ! -f "$status_file" ]]; then
+        echo ""
+        return 1
+    fi
+
+    # Extract task IDs from TASKS.md (format: - [ ] **T001** ...)
+    local all_tasks
+    all_tasks=$(grep -oE '\*\*T[0-9]+\*\*' "$tasks_file" | sed 's/\*\*//g' | sort -u)
+
+    # Get assigned tasks from status file
+    local assigned_tasks
+    assigned_tasks=$(jq -r '.team.taskAssignments | keys[]' "$status_file" 2>/dev/null)
+
+    # Find unassigned tasks
+    for task in $all_tasks; do
+        if ! echo "$assigned_tasks" | grep -q "^${task}$"; then
+            echo "$task"
+        fi
+    done
+}
+
+# Update Ralph Loop state for teammate
+# Args: $1 - repo root, $2 - requirement ID, $3 - teammate ID, $4 - verify result (passed|failed)
+update_teammate_ralph_state() {
+    local repo_root="$1"
+    local req_id="$2"
+    local teammate_id="$3"
+    local verify_result="$4"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo "ERROR: orchestration_status.json not found" >&2
+        return 1
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    jq --arg id "$teammate_id" --arg result "$verify_result" --arg now "$now" '
+        .ralphLoop.teammates[$id].iteration += 1 |
+        .ralphLoop.teammates[$id].lastVerifyResult = $result |
+        .ralphLoop.teammates[$id].lastVerifyAt = $now |
+        .ralphLoop.globalIteration += 1
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# Check if all teammates are idle or completed
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: 0 if all idle/completed, 1 if any working
+all_teammates_idle() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        return 1
+    fi
+
+    local working_count
+    working_count=$(jq '[.team.teammates[] | select(.status == "working")] | length' "$status_file" 2>/dev/null)
+
+    [[ "$working_count" == "0" ]] && return 0
+    return 1
+}
+
+# Clean up Team state
+# Args: $1 - repo root, $2 - requirement ID
+cleanup_team_state() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        return 0
+    fi
+
+    local now
+    now=$(get_beijing_time_iso)
+
+    jq --arg now "$now" '
+        del(.team) |
+        del(.ralphLoop) |
+        .updatedAt = $now
+    ' "$status_file" > "${status_file}.tmp" && mv "${status_file}.tmp" "$status_file"
+}
+
+# =============================================================================
+# Team Monitoring Functions (v4.7)
+# =============================================================================
+
+# Get Team status summary
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: JSON summary of Team status
+get_team_status_summary() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo '{"error": "Status file not found"}'
+        return 1
+    fi
+
+    jq '{
+        mode: .team.mode,
+        lead: .team.lead,
+        teammateCount: (.team.teammates | length),
+        workingCount: ([.team.teammates[] | select(.status == "working")] | length),
+        idleCount: ([.team.teammates[] | select(.status == "idle")] | length),
+        completedTaskCount: ([.team.teammates[].completedTasks | length] | add),
+        assignedTaskCount: (.team.taskAssignments | keys | length),
+        ralphLoop: {
+            globalIteration: .ralphLoop.globalIteration,
+            maxIterations: .ralphLoop.maxIterations
+        },
+        lastUpdated: .team.updatedAt
+    }' "$status_file" 2>/dev/null
+}
+
+# Check for timed out teammates
+# Args: $1 - repo root, $2 - requirement ID, $3 - timeout seconds (default 300)
+# Returns: JSON array of timed out teammates
+get_timed_out_teammates() {
+    local repo_root="$1"
+    local req_id="$2"
+    local timeout_seconds="${3:-300}"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        echo '[]'
+        return 1
+    fi
+
+    local now_epoch
+    now_epoch=$(date +%s)
+
+    jq --argjson now "$now_epoch" --argjson timeout "$timeout_seconds" '
+        [.team.teammates[] |
+            select(.status == "working") |
+            select(
+                ($now - ((.lastActiveAt | sub("\\.[0-9]+"; "") | sub("Z$"; "+00:00") | fromdateiso8601) // 0)) > $timeout
+            )
+        ]
+    ' "$status_file" 2>/dev/null
+}
+
+# Log Team event to EXECUTION_LOG.md
+# Args: $1 - repo root, $2 - requirement ID, $3 - event type, $4 - message
+log_team_event() {
+    local repo_root="$1"
+    local req_id="$2"
+    local event_type="$3"
+    local message="$4"
+    local log_file
+    log_file=$(get_req_dir "$repo_root" "$req_id")/EXECUTION_LOG.md
+
+    local timestamp
+    timestamp=$(get_beijing_time_iso)
+
+    local icon
+    case "$event_type" in
+        info) icon="ℹ️" ;;
+        warning) icon="⚠️" ;;
+        error) icon="❌" ;;
+        success) icon="✅" ;;
+        *) icon="📝" ;;
+    esac
+
+    local entry="
+## [$timestamp] $icon Team Event: $event_type
+
+$message
+
+---
+"
+
+    if [[ -f "$log_file" ]]; then
+        echo "$entry" >> "$log_file"
+    else
+        echo "# Execution Log
+
+$entry" > "$log_file"
+    fi
+}
+
+# Check Team health and log warnings
+# Args: $1 - repo root, $2 - requirement ID
+# Returns: 0 if healthy, 1 if issues found
+check_team_health() {
+    local repo_root="$1"
+    local req_id="$2"
+    local status_file
+    status_file=$(get_req_dir "$repo_root" "$req_id")/orchestration_status.json
+
+    if [[ ! -f "$status_file" ]]; then
+        return 1
+    fi
+
+    local issues=0
+
+    # Check for timed out teammates
+    local timed_out
+    timed_out=$(get_timed_out_teammates "$repo_root" "$req_id")
+    local timed_out_count
+    timed_out_count=$(echo "$timed_out" | jq 'length')
+
+    if [[ "$timed_out_count" -gt 0 ]]; then
+        local teammate_ids
+        teammate_ids=$(echo "$timed_out" | jq -r '.[].id' | tr '\n' ', ' | sed 's/,$//')
+        log_team_event "$repo_root" "$req_id" "warning" "Timed out teammates: $teammate_ids"
+        issues=$((issues + 1))
+    fi
+
+    # Check Ralph Loop iteration limit
+    local global_iter max_iter
+    global_iter=$(jq '.ralphLoop.globalIteration // 0' "$status_file")
+    max_iter=$(jq '.ralphLoop.maxIterations // 10' "$status_file")
+
+    if [[ "$global_iter" -ge "$max_iter" ]]; then
+        log_team_event "$repo_root" "$req_id" "error" "Ralph Loop reached max iterations ($global_iter/$max_iter)"
+        issues=$((issues + 1))
+    elif [[ "$global_iter" -ge $((max_iter * 80 / 100)) ]]; then
+        log_team_event "$repo_root" "$req_id" "warning" "Ralph Loop approaching limit ($global_iter/$max_iter)"
+    fi
+
+    [[ "$issues" -eq 0 ]] && return 0
+    return 1
+}
+