@lvlup-sw/exarchos 2.4.3 → 2.5.0

package/scripts/reconcile-state.sh

@@ -1,346 +0,0 @@
-#!/usr/bin/env bash
-# Reconcile State
-# Compares workflow state file to git reality: verifies worktrees exist,
-# branches exist, task statuses are consistent, and phase is valid.
-#
-# Usage: reconcile-state.sh --state-file <path> --repo-root <path>
-#
-# Exit codes:
-#   0 = state is consistent with git
-#   1 = discrepancies found
-#   2 = usage error (missing required args)
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-# ============================================================
-# ARGUMENT PARSING
-# ============================================================
-
-STATE_FILE=""
-REPO_ROOT=""
-
-usage() {
-    cat << 'USAGE'
-Usage: reconcile-state.sh --state-file <path> --repo-root <path>
-
-Required:
-  --state-file <path>   Path to the workflow state JSON file
-  --repo-root <path>    Git repository root directory
-
-Optional:
-  --help                Show this help message
-
-Exit codes:
-  0  State is consistent with git
-  1  Discrepancies found
-  2  Usage error (missing required args)
-USAGE
-}
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --state-file)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --state-file requires a path argument" >&2
-                exit 2
-            fi
-            STATE_FILE="$2"
-            shift 2
-            ;;
-        --repo-root)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --repo-root requires a path argument" >&2
-                exit 2
-            fi
-            REPO_ROOT="$2"
-            shift 2
-            ;;
-        --help)
-            usage
-            exit 0
-            ;;
-        *)
-            echo "Error: Unknown argument '$1'" >&2
-            usage >&2
-            exit 2
-            ;;
-    esac
-done
-
-if [[ -z "$STATE_FILE" || -z "$REPO_ROOT" ]]; then
-    echo "Error: --state-file and --repo-root are required" >&2
-    usage >&2
-    exit 2
-fi
-
-# ============================================================
-# DEPENDENCY CHECK
-# ============================================================
-
-if ! command -v jq &>/dev/null; then
-    echo "Error: jq is required but not installed" >&2
-    exit 2
-fi
-
-if ! command -v git &>/dev/null; then
-    echo "Error: git is required but not installed" >&2
-    exit 2
-fi
-
-# ============================================================
-# CHECK FUNCTIONS
-# ============================================================
-
-CHECK_PASS=0
-CHECK_FAIL=0
-RESULTS=()
-
-check_pass() {
-    local name="$1"
-    RESULTS+=("- **PASS**: $name")
-    CHECK_PASS=$((CHECK_PASS + 1))
-}
-
-check_fail() {
-    local name="$1"
-    local detail="${2:-}"
-    if [[ -n "$detail" ]]; then
-        RESULTS+=("- **FAIL**: $name — $detail")
-    else
-        RESULTS+=("- **FAIL**: $name")
-    fi
-    CHECK_FAIL=$((CHECK_FAIL + 1))
-}
-
-# ============================================================
-# CHECK 1: State file exists and is valid JSON
-# ============================================================
-
-check_state_file() {
-    if [[ ! -f "$STATE_FILE" ]]; then
-        check_fail "State file exists" "File not found: $STATE_FILE"
-        return 1
-    fi
-
-    if ! jq empty "$STATE_FILE" 2>/dev/null; then
-        check_fail "State file exists" "Invalid JSON: $STATE_FILE"
-        return 1
-    fi
-
-    check_pass "State file exists"
-    return 0
-}
-
-# ============================================================
-# CHECK 2: Phase is valid for workflow type
-# ============================================================
-
-check_phase_valid() {
-    local workflow_type
-    local phase
-
-    workflow_type="$(jq -r '.workflowType // "feature"' "$STATE_FILE")"
-    phase="$(jq -r '.phase // "unknown"' "$STATE_FILE")"
-
-    # Define valid phases per workflow type
-    local -a valid_phases
-    case "$workflow_type" in
-        feature)
-            valid_phases=(ideate plan plan-review delegate review synthesize completed cancelled blocked)
-            ;;
-        debug)
-            valid_phases=(triage investigate rca design debug-implement debug-validate debug-review hotfix-implement hotfix-validate synthesize completed cancelled blocked)
-            ;;
-        refactor)
-            valid_phases=(explore brief polish-implement polish-validate polish-update-docs overhaul-plan overhaul-delegate overhaul-review overhaul-update-docs synthesize completed cancelled blocked)
-            ;;
-        *)
-            check_fail "Phase is valid" "Unknown workflow type: $workflow_type"
-            return 1
-            ;;
-    esac
-
-    local found=false
-    for valid_phase in "${valid_phases[@]}"; do
-        if [[ "$phase" == "$valid_phase" ]]; then
-            found=true
-            break
-        fi
-    done
-
-    if [[ "$found" == true ]]; then
-        check_pass "Phase is valid ($phase for $workflow_type)"
-        return 0
-    else
-        check_fail "Phase is valid" "Phase '$phase' is not valid for workflow type '$workflow_type' (valid: ${valid_phases[*]})"
-        return 1
-    fi
-}
-
-# ============================================================
-# CHECK 3: Task branches exist in git
-# ============================================================
-
-check_task_branches() {
-    local task_count
-    task_count="$(jq '.tasks | length' "$STATE_FILE")"
-
-    if [[ "$task_count" -eq 0 ]]; then
-        check_pass "Task branches exist (no tasks to check)"
-        return 0
-    fi
-
-    local missing_branches=()
-    local branches_checked=0
-
-    # Get all branches from the task array
-    local task_branches
-    task_branches="$(jq -r '.tasks[] | select(.branch != null and .branch != "") | .branch' "$STATE_FILE")"
-
-    while IFS= read -r branch; do
-        [[ -z "$branch" ]] && continue
-        branches_checked=$((branches_checked + 1))
-
-        # Check if branch exists in git
-        if ! git -C "$REPO_ROOT" rev-parse --verify "refs/heads/$branch" &>/dev/null; then
-            missing_branches+=("$branch")
-        fi
-    done <<< "$task_branches"
-
-    if [[ -z "${missing_branches+x}" ]] || [[ ${#missing_branches[@]} -eq 0 ]]; then
-        check_pass "Task branches exist ($branches_checked branches verified)"
-        return 0
-    else
-        local missing_list
-        missing_list="$(IFS=', '; echo "${missing_branches[*]}")"
-        check_fail "Task branches exist" "Missing branches: $missing_list"
-        return 1
-    fi
-}
-
-# ============================================================
-# CHECK 4: Worktrees listed in state exist on disk
-# ============================================================
-
-check_worktrees_exist() {
-    local worktree_count
-    worktree_count="$(jq '.worktrees | length' "$STATE_FILE")"
-
-    if [[ "$worktree_count" -eq 0 ]]; then
-        check_pass "Worktrees exist (no worktrees to check)"
-        return 0
-    fi
-
-    # Get actual git worktrees
-    local git_worktrees
-    git_worktrees="$(git -C "$REPO_ROOT" worktree list --porcelain 2>/dev/null | grep '^worktree ' | sed 's/^worktree //' || true)"
-
-    local missing_worktrees=()
-    local worktrees_checked=0
-
-    # Check each worktree in state
-    local worktree_paths
-    worktree_paths="$(jq -r '.worktrees | to_entries[] | select(.value.status == "active") | .value.path // empty' "$STATE_FILE")"
-
-    while IFS= read -r wt_path; do
-        [[ -z "$wt_path" ]] && continue
-        worktrees_checked=$((worktrees_checked + 1))
-
-        if [[ ! -d "$wt_path" ]]; then
-            missing_worktrees+=("$wt_path")
-        elif ! echo "$git_worktrees" | grep -qFx "$wt_path"; then
-            missing_worktrees+=("$wt_path (not a git worktree)")
-        fi
-    done <<< "$worktree_paths"
-
-    if [[ -z "${missing_worktrees+x}" ]] || [[ ${#missing_worktrees[@]} -eq 0 ]]; then
-        check_pass "Worktrees exist ($worktrees_checked worktrees verified)"
-        return 0
-    else
-        local missing_list
-        missing_list="$(IFS=', '; echo "${missing_worktrees[*]}")"
-        check_fail "Worktrees exist" "Missing worktree paths: $missing_list"
-        return 1
-    fi
-}
-
-# ============================================================
-# CHECK 5: Task status consistency
-# ============================================================
-
-check_task_status_consistency() {
-    local task_count
-    task_count="$(jq '.tasks | length' "$STATE_FILE")"
-
-    if [[ "$task_count" -eq 0 ]]; then
-        check_pass "Task status consistency (no tasks to check)"
-        return 0
-    fi
-
-    local inconsistencies=()
-
-    # Check for in-progress tasks without branches
-    local in_progress_no_branch
-    in_progress_no_branch="$(jq -r '.tasks[] | select(.status == "in-progress" and (.branch == null or .branch == "")) | .id' "$STATE_FILE")"
-
-    while IFS= read -r task_id; do
-        [[ -z "$task_id" ]] && continue
-        inconsistencies+=("Task $task_id is in-progress but has no branch")
-    done <<< "$in_progress_no_branch"
-
-    if [[ -z "${inconsistencies+x}" ]] || [[ ${#inconsistencies[@]} -eq 0 ]]; then
-        check_pass "Task status consistency ($task_count tasks checked)"
-        return 0
-    else
-        local issue_list
-        issue_list="$(IFS='; '; echo "${inconsistencies[*]}")"
-        check_fail "Task status consistency" "$issue_list"
-        return 1
-    fi
-}
-
-# ============================================================
-# EXECUTE CHECKS
-# ============================================================
-
-if check_state_file; then
-    check_phase_valid || true
-    check_task_branches || true
-    check_worktrees_exist || true
-    check_task_status_consistency || true
-fi
-
-# ============================================================
-# STRUCTURED OUTPUT
-# ============================================================
-
-echo "## State Reconciliation Report"
-echo ""
-echo "**State file:** \`$STATE_FILE\`"
-echo "**Repo root:** \`$REPO_ROOT\`"
-echo ""
-
-for result in "${RESULTS[@]}"; do
-    echo "$result"
-done
-
-echo ""
-TOTAL=$((CHECK_PASS + CHECK_FAIL))
-echo "---"
-echo ""
-
-if [[ $CHECK_FAIL -eq 0 ]]; then
-    echo "**Result: PASS** — State is consistent with git ($CHECK_PASS/$TOTAL checks passed)"
-    exit 0
-else
-    echo "**Result: FAIL** — Discrepancies found ($CHECK_FAIL/$TOTAL checks failed)"
-    exit 1
-fi

package/scripts/review-diff.sh

@@ -1,63 +0,0 @@
-#!/usr/bin/env bash
-#
-# review-diff.sh - Generate context-efficient diff for code review
-#
-# Usage: review-diff.sh <worktree-path> [base-branch]
-#
-# Output: Structured diff with only changed sections
-#   - Stats summary
-#   - Unified diff with 3-line context
-#
-# This reduces context consumption by 80-90% compared to full file contents.
-#
-
-set -euo pipefail
-
-WORKTREE="${1:-.}"
-BASE="${2:-main}"
-
-if [ ! -d "$WORKTREE" ]; then
-    echo "ERROR: Directory not found: $WORKTREE" >&2
-    exit 1
-fi
-
-cd "$WORKTREE"
-
-# Check if we're in a git repository
-if ! git rev-parse --git-dir > /dev/null 2>&1; then
-    echo "ERROR: Not a git repository: $WORKTREE" >&2
-    exit 1
-fi
-
-# Get current branch
-CURRENT_BRANCH=$(git branch --show-current)
-
-echo "## Review Diff"
-echo ""
-echo "**Worktree:** $WORKTREE"
-echo "**Branch:** $CURRENT_BRANCH"
-echo "**Base:** $BASE"
-echo ""
-
-# Stats summary
-echo "### Changed Files"
-echo ""
-echo '```'
-git diff "$BASE"...HEAD --stat 2>/dev/null || git diff "$BASE"..HEAD --stat
-echo '```'
-echo ""
-
-# File list for quick reference
-echo "### Files Modified"
-echo ""
-git diff "$BASE"...HEAD --name-only 2>/dev/null || git diff "$BASE"..HEAD --name-only | while read -r file; do
-    echo "- \`$file\`"
-done
-echo ""
-
-# Unified diff with context
-echo "### Diff Content"
-echo ""
-echo '```diff'
-git diff "$BASE"...HEAD --unified=3 2>/dev/null || git diff "$BASE"..HEAD --unified=3
-echo '```'

package/scripts/review-verdict.sh

@@ -1,169 +0,0 @@
-#!/usr/bin/env bash
-# Review Verdict Classification
-# Classifies review findings into a routing verdict for the quality-review workflow.
-#
-# Usage: review-verdict.sh --high <n> --medium <n> --low <n> [--blocked <reason>]
-#        review-verdict.sh --findings-file <path>
-#
-# Exit codes:
-#   0 = APPROVED (no HIGH findings)
-#   1 = NEEDS_FIXES (HIGH findings present)
-#   2 = BLOCKED (--blocked flag) or usage error
-
-set -euo pipefail
-
-# ============================================================
-# ARGUMENT PARSING
-# ============================================================
-
-HIGH_COUNT=""
-MEDIUM_COUNT=""
-LOW_COUNT=""
-BLOCKED_REASON=""
-FINDINGS_FILE=""
-
-usage() {
-    cat << 'USAGE'
-Usage: review-verdict.sh --high <n> --medium <n> --low <n> [--blocked <reason>]
-       review-verdict.sh --findings-file <path>
-
-Classify review findings into a routing verdict.
-
-Options:
-  --high <n>            Number of HIGH-severity findings
-  --medium <n>          Number of MEDIUM-severity findings
-  --low <n>             Number of LOW-severity findings
-  --blocked <reason>    Mark as BLOCKED with the given reason
-  --findings-file <path> JSON file with {high:N, medium:N, low:N}
-  --help                Show this help message
-
-Exit codes:
-  0  APPROVED (no HIGH findings)
-  1  NEEDS_FIXES (HIGH findings present)
-  2  BLOCKED or usage error
-USAGE
-}
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --high)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --high requires a number argument" >&2
-                exit 2
-            fi
-            HIGH_COUNT="$2"
-            shift 2
-            ;;
-        --medium)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --medium requires a number argument" >&2
-                exit 2
-            fi
-            MEDIUM_COUNT="$2"
-            shift 2
-            ;;
-        --low)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --low requires a number argument" >&2
-                exit 2
-            fi
-            LOW_COUNT="$2"
-            shift 2
-            ;;
-        --blocked)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --blocked requires a reason argument" >&2
-                exit 2
-            fi
-            BLOCKED_REASON="$2"
-            shift 2
-            ;;
-        --findings-file)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --findings-file requires a path argument" >&2
-                exit 2
-            fi
-            FINDINGS_FILE="$2"
-            shift 2
-            ;;
-        --help)
-            usage
-            exit 0
-            ;;
-        *)
-            echo "Error: Unknown argument '$1'" >&2
-            usage >&2
-            exit 2
-            ;;
-    esac
-done
-
-# ============================================================
-# INPUT RESOLUTION
-# ============================================================
-
-# If --findings-file provided, parse JSON
-if [[ -n "$FINDINGS_FILE" ]]; then
-    if [[ ! -f "$FINDINGS_FILE" ]]; then
-        echo "Error: Findings file not found: $FINDINGS_FILE" >&2
-        exit 2
-    fi
-
-    if ! command -v jq &>/dev/null; then
-        echo "Error: jq is required to parse findings file" >&2
-        exit 2
-    fi
-
-    HIGH_COUNT="$(jq -r '.high // 0' "$FINDINGS_FILE")"
-    MEDIUM_COUNT="$(jq -r '.medium // 0' "$FINDINGS_FILE")"
-    LOW_COUNT="$(jq -r '.low // 0' "$FINDINGS_FILE")"
-
-    # Ensure numeric values (guard against malformed JSON)
-    [[ "$HIGH_COUNT" =~ ^[0-9]+$ ]] || HIGH_COUNT=0
-    [[ "$MEDIUM_COUNT" =~ ^[0-9]+$ ]] || MEDIUM_COUNT=0
-    [[ "$LOW_COUNT" =~ ^[0-9]+$ ]] || LOW_COUNT=0
-fi
-
-# Validate we have the required inputs (either via flags or file)
-if [[ -z "$HIGH_COUNT" && -z "$BLOCKED_REASON" ]]; then
-    echo "Error: Must provide --high/--medium/--low counts, --findings-file, or --blocked" >&2
-    usage >&2
-    exit 2
-fi
-
-# Default counts to 0 if not set
-HIGH_COUNT="${HIGH_COUNT:-0}"
-MEDIUM_COUNT="${MEDIUM_COUNT:-0}"
-LOW_COUNT="${LOW_COUNT:-0}"
-
-# ============================================================
-# VERDICT LOGIC
-# ============================================================
-
-# Priority: BLOCKED > NEEDS_FIXES > APPROVED
-if [[ -n "$BLOCKED_REASON" ]]; then
-    echo "## Review Verdict: BLOCKED"
-    echo ""
-    echo "**Reason:** $BLOCKED_REASON"
-    echo ""
-    echo "Return to design phase. Route to \`/ideate --redesign\`."
-    exit 2
-fi
-
-if [[ "$HIGH_COUNT" -gt 0 ]]; then
-    TOTAL=$((HIGH_COUNT + MEDIUM_COUNT + LOW_COUNT))
-    echo "## Review Verdict: NEEDS_FIXES"
-    echo ""
-    echo "Found $HIGH_COUNT HIGH-severity findings. Route to \`/delegate --fixes\`."
-    echo ""
-    echo "**Finding summary:** $HIGH_COUNT high, $MEDIUM_COUNT medium, $LOW_COUNT low ($TOTAL total)"
-    exit 1
-fi
-
-TOTAL=$((HIGH_COUNT + MEDIUM_COUNT + LOW_COUNT))
-echo "## Review Verdict: APPROVED"
-echo ""
-echo "No HIGH-severity findings. Proceed to synthesis."
-echo ""
-echo "**Finding summary:** $HIGH_COUNT high, $MEDIUM_COUNT medium, $LOW_COUNT low ($TOTAL total)"
-exit 0