claude-plugin-viban 1.3.12 → 1.3.13

package/bin/viban

@@ -131,60 +131,6 @@ cleanup() {
 }
 trap cleanup INT TERM EXIT
 
-# Python coprocess for TUI rendering (eliminates per-frame spawn overhead)
-# Uses explicit file descriptors (fd 7/8) to avoid interfering with read -sk1
-_COPROC_PID=""
-_COPROC_RESULT=""
-
-_start_coproc() {
-    local _in_fifo _out_fifo
-    _in_fifo=$(mktemp -u /tmp/viban_cp_in.XXXXXX)
-    _out_fifo=$(mktemp -u /tmp/viban_cp_out.XXXXXX)
-    mkfifo "$_in_fifo" "$_out_fifo"
-    python3 "$VIBAN_SCRIPT_DIR/scripts/tui_coprocess.py" < "$_in_fifo" > "$_out_fifo" &
-    _COPROC_PID=$!
-    exec 7>"$_in_fifo" 8<"$_out_fifo"
-    rm -f "$_in_fifo" "$_out_fifo"
-}
-
-_stop_coproc() {
-    if [[ -n "$_COPROC_PID" ]] && kill -0 "$_COPROC_PID" 2>/dev/null; then
-        echo "QUIT" >&7 2>/dev/null
-        exec 7>&- 2>/dev/null
-        wait "$_COPROC_PID" 2>/dev/null
-    else
-        exec 7>&- 2>/dev/null
-    fi
-    exec 8<&- 2>/dev/null
-    _COPROC_PID=""
-}
-
-_coproc_batch_trunc() {
-    echo "BATCH_TRUNC" >&7
-    echo "$1" >&7
-    echo "END" >&7
-    _COPROC_RESULT=""
-    local line
-    while read -r line <&8; do
-        [[ "$line" == "END" ]] && break
-        [[ -n "$_COPROC_RESULT" ]] && _COPROC_RESULT+=$'\n'
-        _COPROC_RESULT+="$line"
-    done
-}
-
-_coproc_batch_width() {
-    echo "BATCH_WIDTH" >&7
-    echo "$1" >&7
-    echo "END" >&7
-    _COPROC_RESULT=""
-    local line
-    while read -r line <&8; do
-        [[ "$line" == "END" ]] && break
-        [[ -n "$_COPROC_RESULT" ]] && _COPROC_RESULT+=$'\n'
-        _COPROC_RESULT+="$line"
-    done
-}
-
 # Prevent gum from querying terminal colors
 export CLICOLOR_FORCE=1
 export COLORTERM=truecolor
@@ -249,1654 +195,17 @@ case "$1" in
     *) init_viban_json ;;
 esac
 
-# Colors - Sunset Orange Theme
-typeset -A C
-C=(
-    fg        "#FFE5D9"
-    fg_dim    "#B89685"
-    backlog   "#8B7B6B"
-    progress  "#FF6B35"
-    review    "#C44536"
-    card_bg   "#2D2416"
-    card_bd   "#5A4A3A"
-    selected  "#FF8C42"
-    accent    "#F7931E"
-)
-
-# 3 statuses only
-typeset -A STATUS_LABEL STATUS_COLOR
-STATUS_LABEL=(backlog "To-Do" in_progress "In Progress" review "Human Review")
-STATUS_COLOR=(backlog "${C[backlog]}" in_progress "${C[progress]}" review "${C[review]}")
-
-# Priority levels (P0=Critical, P3=Good to have)
-typeset -A PRIORITY_LABEL PRIORITY_COLOR
-PRIORITY_LABEL=(P0 "CRITICAL" P1 "HIGH" P2 "MEDIUM" P3 "LOW")
-PRIORITY_COLOR=(P0 "\033[38;2;255;69;58m" P1 "\033[38;2;255;159;10m" P2 "\033[38;2;255;214;10m" P3 "\033[38;2;142;142;147m")
-
-# Issue types (displayed as tags alongside priority)
-typeset -A TYPE_LABEL TYPE_COLOR
-TYPE_LABEL=(bug "BUG" feat "FEAT" chore "CHORE" refactor "REFAC")
-TYPE_COLOR=(bug "\033[38;2;255;69;58m" feat "\033[38;2;50;215;75m" chore "\033[38;2;142;142;147m" refactor "\033[38;2;90;200;250m")
-
-VIBAN_STATUSES=(backlog in_progress review)
-
-# Pre-generate horizontal borders (cache) - optimized with printf repeat
-typeset -A BORDER_CACHE
-gen_border() {
-    local w=$1
-    [[ -n "${BORDER_CACHE[$w]}" ]] && { echo "${BORDER_CACHE[$w]}"; return; }
-    # Use printf with dynamic width - single call instead of loop
-    local b=$(printf '─%.0s' {1..$w})
-    BORDER_CACHE[$w]="$b"
-    echo "$b"
-}
-
-# Cached terminal dimensions (with sensible defaults)
-CACHED_TERM_W=100
-CACHED_TERM_H=30
-CACHED_COL_W=32
-CACHED_MAX_H=22
-CACHED_MAX_TASKS=7
-
-# Spinner for in_progress cards (Braille dots - consistent 1-char width)
-SPINNER_FRAMES=('⠋' '⠙' '⠹' '⠸' '⠼' '⠴' '⠦' '⠧' '⠇' '⠏')
-SPINNER_IDX=0
-
-update_term_cache() {
-    if [[ -n "$COLUMNS" ]]; then
-        CACHED_TERM_W=$COLUMNS
-    elif command -v stty &>/dev/null; then
-        CACHED_TERM_W=$(stty size 2>/dev/null | cut -d' ' -f2)
-    else
-        CACHED_TERM_W=$(tput cols 2>/dev/null || echo 100)
-    fi
-    if [[ -n "$LINES" ]]; then
-        CACHED_TERM_H=$LINES
-    elif command -v stty &>/dev/null; then
-        CACHED_TERM_H=$(stty size 2>/dev/null | cut -d' ' -f1)
-    else
-        CACHED_TERM_H=$(tput lines 2>/dev/null || echo 30)
-    fi
-    CACHED_COL_W=$(( (CACHED_TERM_W - 2) / 3 ))
-    local _header_extra=0
-    $VIBAN_IS_GIT_REPO || _header_extra=1
-    CACHED_MAX_H=$((CACHED_TERM_H - 8 - _header_extra))
-    CACHED_MAX_TASKS=$((CACHED_MAX_H / 5))
-    (( CACHED_MAX_TASKS < 2 )) && CACHED_MAX_TASKS=2
-    (( CACHED_MAX_TASKS > 8 )) && CACHED_MAX_TASKS=8
-}
-
-check_deps() {
-    command -v gum &>/dev/null || { echo "Error: gum required"; exit 1; }
-    command -v jq &>/dev/null || { echo "Error: jq required"; exit 1; }
-}
-
-init_json() {
-    if [[ ! -f "$VIBAN_JSON" ]]; then
-        local max_wt_id=0
-        if [[ -d "$VIBAN_DATA_DIR/worktrees" ]]; then
-            local wt_id
-            for d in "$VIBAN_DATA_DIR/worktrees/"*(/N); do
-                wt_id="${d:t}"
-                [[ "$wt_id" =~ ^[0-9]+$ ]] && (( wt_id > max_wt_id )) && max_wt_id=$wt_id
-            done
-        fi
-        local next_id=$((max_wt_id + 1))
-        echo "{\"version\":2,\"next_id\":$next_id,\"issues\":[]}" > "$VIBAN_JSON"
-    elif [[ $(jq '.version // 1' "$VIBAN_JSON") -lt 2 ]]; then
-        jq '{
-            version: 2,
-            next_id: (([.issues[].id] | max // 0) + 1),
-            issues: .issues
-        }' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-    fi
-}
-
-get_next_id() { jq -r '.next_id // (([.issues[].id] | max // 0) + 1)' "$VIBAN_JSON"; }
-
-# Display ID: show external_id if present, otherwise #id
-display_id() { local id="$1" ext_id="${2:-}"; [[ -n "$ext_id" && "$ext_id" != "null" ]] && echo "$ext_id" || echo "#$id"; }
-
-# Get external_id for an issue by internal id
-get_ext_id() { jq -r --argjson id "$1" '.issues[]|select((.id|tonumber)==$id)|.external_id//""' "$VIBAN_JSON"; }
-
-# Calculate effective order for sorting (priority-based virtual order for cards without order)
-# Used internally for fractional indexing calculations
-# Cards with order: use actual order
-# Cards without order: P0=1000000, P1=2000000, P2=3000000, P3=4000000 + id
-calc_effective_order() {
-    local order="$1"
-    local priority="${2:-P3}"
-    local id="$3"
-
-    if [[ -n "$order" && "$order" != "null" ]]; then
-        echo "$order"
-    else
-        local base_order
-        case "$priority" in
-            P0) base_order=1000000;;
-            P1) base_order=2000000;;
-            P2) base_order=3000000;;
-            *)  base_order=4000000;;
-        esac
-        echo $((base_order + id))
-    fi
-}
-
-add_issue() {
-    local title=$(gum input --placeholder "Enter task title..." --width 50 \
-        --prompt.foreground "${C[accent]}" --cursor.foreground "${C[selected]}")
-    [[ -z "$title" ]] && return
-
-    # Select type
-    local issue_type=$(gum choose "bug (BUG)" "feat (FEATURE)" "chore (CHORE)" "refactor (REFACTOR)" \
-        --header "Select type:" --cursor.foreground "${C[selected]}")
-    issue_type="${issue_type%% *}"  # Extract bug, feat, chore, or refactor
-    [[ -z "$issue_type" ]] && issue_type="feat"
-
-    # Select priority
-    local priority=$(gum choose "P0 (CRITICAL)" "P1 (HIGH)" "P2 (MEDIUM)" "P3 (LOW)" \
-        --header "Select priority:" --cursor.foreground "${C[selected]}")
-    priority="${priority%% *}"  # Extract P0, P1, P2, or P3
-    [[ -z "$priority" ]] && priority="P3"
-
-    local desc=""
-    if gum confirm "Add description?" --affirmative "Yes (open editor)" --negative "No" \
-        --selected.foreground="#000000" --selected.background "${C[accent]}"; then
-        local tmpfile=$(mktemp)
-        local editor="${EDITOR:-${VISUAL:-vim}}"
-        local next_id=$(get_next_id)
-        local today=$(date +"%Y-%m-%d")
-        cat > "$tmpfile" <<TEMPLATE
-# ─────────────────────────────────────────────
-# VIBAN Issue #${next_id}
-# ─────────────────────────────────────────────
-# Title: $title
-# Priority: $priority
-# Created: $today
-# Status: backlog
-# ─────────────────────────────────────────────
-
-# ▼ Write description below (content below this line will be saved)
-
-TEMPLATE
-        $editor "$tmpfile"
-        desc=$(sed '/^#/d' "$tmpfile" | sed '/./,$!d')
-        rm -f "$tmpfile"
-    fi
-
-    local id=$(get_next_id) now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    # New cards don't have order - they follow priority-based sorting
-    # Order is only assigned when manually moved
-    local tmpjson=$(mktemp)
-    printf '%s' "$desc" > "$tmpjson"
-    jq --arg id "$id" --arg title "$title" --rawfile desc "$tmpjson" --arg priority "$priority" --arg issue_type "$issue_type" --arg now "$now" '
-        .next_id = ((.next_id // 0) + 1) |
-        .issues += [{
-            id:($id|tonumber),
-            title:$title,
-            description:$desc,
-            status:"backlog",
-            priority:$priority,
-            type:$issue_type,
-            assigned_to:null,
-            created_at:$now,
-            updated_at:$now
-        }]' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-    rm -f "$tmpjson"
-}
-
-# Sort: backlog/in_progress by effective order, review by updated_at desc
-# Effective order: if .order exists -> use it (manually positioned)
-#                  if .order is null -> priority-based virtual order (P0=1M, P1=2M, P2=3M, P3=4M) + id
-# This ensures: manually ordered cards stay fixed, others follow priority order
-get_issues_by_status() {
-    local st="$1"
-    if [[ "$st" == "review" ]]; then
-        jq -r --arg s "$st" '.issues|map(select(.status==$s))|sort_by(.updated_at)|reverse' "$VIBAN_JSON"
-    else
-        jq -r --arg s "$st" '
-            .issues | map(select(.status==$s)) | sort_by(
-                if .order != null then [0, .order]
-                else [1, ({"P0":0,"P1":1,"P2":2,"P3":3}[.priority // "P3"] // 3), .id]
-                end
-            )
-        ' "$VIBAN_JSON"
-    fi
-}
-count_issues_by_status() { jq -r --arg s "$1" '[.issues[]|select(.status==$s)]|length' "$VIBAN_JSON"; }
-
-# Get jq sort expression for status (review uses updated_at, others use order/priority)
-get_sort_expr() {
-    local st="$1"
-    if [[ "$st" == "review" ]]; then
-        echo 'sort_by(.updated_at) | reverse'
-    else
-        echo 'sort_by(if .order != null then [0, .order] else [1, ({"P0":0,"P1":1,"P2":2,"P3":3}[.priority // "P3"] // 3), .id] end)'
-    fi
-}
-
-# Get issue ID by status and card index (uses correct sort order per status)
-get_issue_id_at_index() {
-    local st="$1" idx="$2" json_data="$3"
-    local sort_expr=$(get_sort_expr "$st")
-    printf '%s' "$json_data" | jq -r --arg s "$st" --argjson i "$idx" \
-        ".issues | map(select(.status==\$s)) | $sort_expr | .[\$i].id // empty"
-}
-
-# Find card index by ID after reorder (uses correct sort order per status)
-get_card_index_by_id() {
-    local st="$1" card_id="$2" json_data="$3"
-    local sort_expr=$(get_sort_expr "$st")
-    printf '%s' "$json_data" | jq -r --arg s "$st" --argjson id "$card_id" \
-        ".issues | map(select(.status==\$s)) | $sort_expr | to_entries | map(select(.value.id == \$id)) | .[0].key // 0"
-}
-
-get_term_width() {
-    # Try multiple methods to get terminal width
-    if [[ -n "$COLUMNS" ]]; then
-        echo "$COLUMNS"
-    elif command -v stty &>/dev/null; then
-        stty size 2>/dev/null | cut -d' ' -f2
-    else
-        tput cols 2>/dev/null || echo 100
-    fi
-}
-get_term_height() {
-    if [[ -n "$LINES" ]]; then
-        echo "$LINES"
-    elif command -v stty &>/dev/null; then
-        stty size 2>/dev/null | cut -d' ' -f1
-    else
-        tput lines 2>/dev/null || echo 30
-    fi
-}
-
-
-# ANSI color codes - Orange Theme
-A_RESET="\033[0m"
-A_BOLD="\033[1m"
-A_DIM="\033[2m"
-A_FG="\033[38;2;255;229;217m"        # Warm cream text
-A_GRAY="\033[38;2;139;123;107m"      # Warm gray for backlog
-A_ORANGE="\033[38;2;255;107;53m"     # Vibrant orange for in_progress
-A_DEEP_ORANGE="\033[38;2;196;69;54m" # Deep orange for review
-A_ACCENT="\033[38;2;247;147;30m"     # Golden accent
-A_SELECTED="\033[38;2;255;140;66m"   # Bright selection
-
-# Print centered text (uses cached width)
-print_center() {
-    local text=$1 color=${2:-$A_FG}
-    local w=$CACHED_TERM_W
-    (( w == 0 )) && w=$(get_term_width)
-    local len=${#text}
-    local pad=$(( (w - len) / 2 ))
-    printf "%${pad}s${color}%s${A_RESET}\033[K\n" "" "$text"
-}
-
-# Draw header with pure ANSI
-draw_header() {
-    printf '\033[K\n'
-    print_center "VIBAN" "${A_BOLD}${A_ACCENT}"
-    local _ver repo_name subtitle="Vibe Kanban"
-    _ver=$(grep '"version"' "$VIBAN_SCRIPT_DIR/package.json" 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/')
-    repo_name=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null)
-    [[ -n "$repo_name" ]] && subtitle="Vibe Kanban · $repo_name"
-    if [[ -n "$_ver" ]]; then
-        subtitle="$subtitle · v$_ver"
-        # Check for update availability from cache
-        if [[ -f "$_VIBAN_UPDATE_CACHE" ]]; then
-            local cached_latest
-            cached_latest=$(sed -n '2p' "$_VIBAN_UPDATE_CACHE" 2>/dev/null)
-            if [[ -n "$cached_latest" && "$cached_latest" != "$_ver" ]]; then
-                local -a cv lv
-                cv=("${(@s/./)_ver}")
-                lv=("${(@s/./)cached_latest}")
-                local _is_newer=false _c _l
-                for i in 1 2 3; do
-                    _c=${cv[$i]:-0}; _l=${lv[$i]:-0}
-                    _c=${_c%%[^0-9]*}; _l=${_l%%[^0-9]*}
-                    [[ -z "$_c" ]] && _c=0; [[ -z "$_l" ]] && _l=0
-                    if (( _l > _c )); then
-                        _is_newer=true
-                        break
-                    elif (( _l < _c )); then
-                        break
-                    fi
-                done
-                $_is_newer && subtitle="$subtitle → v$cached_latest"
-            fi
-        fi
-    fi
-    print_center "$subtitle" "${A_DIM}"
-    if ! $VIBAN_IS_GIT_REPO; then
-        print_center "⚠ Not a git repo · assign/PR unavailable" "${A_DIM}"
-    fi
-    printf '\033[K\n'
-}
-
-# Get status color code
-get_status_color() {
-    case "$1" in
-        backlog) echo "$A_GRAY";;
-        in_progress) echo "$A_ORANGE";;
-        review) echo "$A_DEEP_ORANGE";;
-    esac
-}
-
-# Build column lines into array (optimized - single jq call, cached borders)
-# $1: status, $2: col_selected, $3: card_selected (-1 if none), $4: max_h, $5: col_w, $6: json_data
-build_column_lines() {
-    local st="$1"
-    local is_col_selected="${2:-0}"
-    local card_sel="${3:--1}"
-    local max_h="${4:-20}"
-    local col_w="${5:-30}"
-    local json_data="$6"
-    local label="${STATUS_LABEL[$st]:-Unknown}"
-    local color=$(get_status_color "$st")
-
-    # Single jq call to get all issues for this status (include description, priority, type)
-    # Replace newlines/tabs in description to prevent parsing issues
-    # Sort: review by updated_at desc, others by effective order (ordered cards first, then priority)
-    local sort_expr='sort_by(if .order != null then [0, .order] else [1, ({"P0":0,"P1":1,"P2":2,"P3":3}[.priority // "P3"] // 3), .id] end)'
-    [[ "$st" == "review" ]] && sort_expr='sort_by(.updated_at) | reverse'
-    local done_ids_tui=$(printf '%s' "$json_data" | jq '[.issues[]|select(.status=="done")|.id]')
-    local issues_data=$(printf '%s' "$json_data" | jq -r --arg s "$st" --argjson done "$done_ids_tui" "
-        .issues | map(select(.status==\$s)) | $sort_expr |
-        .[] | \"\\(.id)\t\\(.title)\t\\((.description // \"\") | gsub(\"[\\n\\t\\r]\"; \" \"))\t\\(.priority // \"P3\")\t\\(.type // \"\")\t\\(.external_id // \"\")\t\\(if ((.blocked_by // []) | length > 0 and any(. as \$b | \$done | index(\$b) == null)) then \"blocked\" else \"\" end)\"")
-    local count=0
-    # Count total issues (not capped) for overflow indicator
-    if [[ -n "$issues_data" ]]; then
-        local -a _count_arr=("${(f)issues_data}")
-        count=${#_count_arr[@]}
-    fi
-
-    # Header centered in column
-    local hdr_text="● $label"
-    local hdr_w=$((${#label} + 2))
-    local left_pad=$(( (col_w - hdr_w) / 2 ))
-    local right_pad=$((col_w - hdr_w - left_pad))
-    if (( is_col_selected )); then
-        printf "%${left_pad}s${A_BOLD}${A_SELECTED}%s${A_RESET}%${right_pad}s\n" "" "$hdr_text" ""
-        # Underline for selected column - use printf repeat pattern
-        local underline=$(printf '─%.0s' {1..$hdr_w})
-        printf "%${left_pad}s${A_SELECTED}%s${A_RESET}%${right_pad}s\n" "" "$underline" ""
-    else
-        printf "%${left_pad}s${color}%s${A_RESET}%${right_pad}s\n" "" "$hdr_text" ""
-        # Empty line for non-selected columns
-        printf "%${col_w}s\n" ""
-    fi
-
-    local lines_used=2
-    local card_inner=$((col_w - 4))
-    local border=$(gen_border $card_inner)
-
-    # --- Pass 1: Collect card data into arrays ---
-    local -a _ids _titles _descs _priorities _types _ext_ids _title_max_ws _title_pfxs
-    local _has_nonascii=0
-    local _desc_max_w=$((card_inner - 4))
-    local _spinner_w=0
-    [[ "$st" == "in_progress" ]] && _spinner_w=2
-    local _cc _bc _pfx _did
-
-    local -a _blocked_flags=()
-    while IFS=$'\t' read -r _id _title _desc _priority _type _ext_id _blocked; do
-        [[ -z "$_id" ]] && continue
-        (( ${#_ids} >= CACHED_MAX_TASKS )) && break
-        [[ -z "$_priority" || "$_priority" == "null" ]] && _priority="P3"
-        [[ -z "$_type" || "$_type" == "null" ]] && _type=""
-        [[ "$_desc" == "null" ]] && _desc=""
-
-        _ids+=("$_id"); _titles+=("$_title"); _descs+=("$_desc")
-        _priorities+=("$_priority"); _types+=("$_type"); _ext_ids+=("$_ext_id")
-        _blocked_flags+=("$_blocked")
-
-        # Per-card title width limit (use display ID length)
-        _did=$(display_id "$_id" "$_ext_id")
-        _title_max_ws+=($((card_inner - 4 - ${#_did} - _spinner_w)))
-        # Prefix for width calc (X as spinner placeholder - same width 1 as braille chars)
-        _pfx="  "
-        (( _spinner_w )) && _pfx="  X "
-        _title_pfxs+=("${_pfx}${_did} ")
-
-        # Check for non-ASCII
-        if (( ! _has_nonascii )); then
-            _cc=${#_title}
-            LC_ALL=C _bc=${#_title}; unset LC_ALL
-            (( _bc != _cc )) && _has_nonascii=1
-            if (( ! _has_nonascii && ${#_desc} > 0 )); then
-                _cc=${#_desc}; LC_ALL=C _bc=${#_desc}; unset LC_ALL
-                (( _bc != _cc )) && _has_nonascii=1
-            fi
-        fi
-    done <<< "$issues_data"
-
-    local _n=${#_ids}
-
-    # --- Pass 2: Batch compute truncation + widths (single Python call) ---
-    local -a _short_titles _title_cws _short_descs _desc_cws
-
-    if (( _n > 0 )); then
-        if (( _has_nonascii )); then
-            # Build batch input: 2 lines per card (title, desc)
-            # Format: max_w<TAB>prefix<TAB>string
-            local _batch_input=""
-            for (( _i=1; _i<=_n; _i++ )); do
-                _batch_input+="${_title_max_ws[$_i]}"$'\t'"${_title_pfxs[$_i]}"$'\t'"${_titles[$_i]}"$'\n'
-                _batch_input+="${_desc_max_w}"$'\t'"  "$'\t'"${_descs[$_i]}"$'\n'
-            done
-
-            # Single Python call: truncate each string and compute content width
-            local _batch_output
-            _coproc_batch_trunc "$_batch_input"
-            _batch_output="$_COPROC_RESULT"
-
-            local _li=0
-            while IFS=$'\t' read -r _tr _cw; do
-                ((_li++))
-                if (( _li % 2 == 1 )); then
-                    _short_titles+=("$_tr"); _title_cws+=($_cw)
-                else
-                    _short_descs+=("$_tr"); _desc_cws+=($_cw)
-                fi
-            done <<< "$_batch_output"
-        else
-            # All-ASCII fast path - no Python needed
-            local _t _mw _fc _d
-            for (( _i=1; _i<=_n; _i++ )); do
-                _t="${_titles[$_i]}" _mw=${_title_max_ws[$_i]}
-                (( ${#_t} > _mw )) && _t="${_t:0:$_mw}"
-                _short_titles+=("$_t")
-                _fc="${_title_pfxs[$_i]}${_t}"
-                _title_cws+=(${#_fc})
-
-                _d="${_descs[$_i]}"
-                (( ${#_d} > _desc_max_w )) && _d="${_d:0:$_desc_max_w}"
-                _short_descs+=("$_d")
-                _desc_cws+=($((2 + ${#_d})))
-            done
-        fi
-    fi
-
-    # --- Pass 3: Render cards ---
-    local shown=0
-    local id priority issue_type ext_id did
-    local spinner_prefix title_content title_pad
-    local desc_content desc_pad
-    local priority_tag priority_color type_tag type_color tags_w tags_pad
-    local border_color text_color desc_color
-    for (( _i=1; _i<=_n; _i++ )); do
-        id="${_ids[$_i]}"
-        priority="${_priorities[$_i]}"
-        issue_type="${_types[$_i]}"
-        ext_id="${_ext_ids[$_i]}"
-        did=$(display_id "$id" "$ext_id")
-
-        # Title line
-        spinner_prefix=""
-        [[ "$st" == "in_progress" ]] && spinner_prefix="${SPINNER_FRAMES[$((SPINNER_IDX % ${#SPINNER_FRAMES[@]} + 1))]} "
-        title_content="  ${spinner_prefix}${did} ${_short_titles[$_i]}"
-        title_pad=$((card_inner - ${_title_cws[$_i]}))
-        (( title_pad < 0 )) && title_pad=0
-
-        # Description line
-        desc_content="  ${_short_descs[$_i]}"
-        desc_pad=$((card_inner - ${_desc_cws[$_i]}))
-        (( desc_pad < 0 )) && desc_pad=0
-
-        # Priority, type, and blocked tags
-        priority_tag="[$priority]"
-        priority_color="${PRIORITY_COLOR[$priority]:-$A_DIM}"
-        type_tag="" type_color="" tags_w=0
-        local blocked_tag="" blocked_color=""
-        if [[ -n "$issue_type" ]]; then
-            type_tag="[${TYPE_LABEL[$issue_type]:-$issue_type}]"
-            type_color="${TYPE_COLOR[$issue_type]:-$A_DIM}"
-            tags_w=$((${#priority_tag} + 1 + ${#type_tag}))
-        else
-            tags_w=${#priority_tag}
-        fi
-        if [[ "${_blocked_flags[$_i]}" == "blocked" ]]; then
-            blocked_tag=" BLOCKED"
-            blocked_color="\033[38;2;255;69;58m"
-            tags_w=$((tags_w + 8))
-        fi
-        tags_pad=$((card_inner - tags_w - 2))
-
-        border_color="$A_DIM"
-        text_color="$A_FG"
-        desc_color="$A_DIM"
-        if (( is_col_selected && shown == card_sel )); then
-            border_color="${A_SELECTED}"
-            text_color="${A_BOLD}${A_ACCENT}"
-            desc_color="${A_ACCENT}"
-        fi
-
-        # 5-line card with priority+type tags on 4th line
-        printf " ${border_color}╭%s╮${A_RESET} \n" "$border"
-        printf " ${border_color}│${A_RESET}${text_color}%s${A_RESET}%${title_pad}s${border_color}│${A_RESET} \n" "$title_content" ""
-        printf " ${border_color}│${A_RESET}${desc_color}%s${A_RESET}%${desc_pad}s${border_color}│${A_RESET} \n" "$desc_content" ""
-        if [[ -n "$type_tag" ]]; then
-            printf " ${border_color}│${A_RESET}  ${priority_color}%s${A_RESET} ${type_color}%s${A_RESET}${blocked_color}%s${A_RESET}%${tags_pad}s${border_color}│${A_RESET} \n" "$priority_tag" "$type_tag" "$blocked_tag" ""
-        else
-            printf " ${border_color}│${A_RESET}  ${priority_color}%s${A_RESET}${blocked_color}%s${A_RESET}%${tags_pad}s${border_color}│${A_RESET} \n" "$priority_tag" "$blocked_tag" ""
-        fi
-        printf " ${border_color}╰%s╯${A_RESET} \n" "$border"
-
-        ((shown++))
-        lines_used=$((lines_used + 5))
-    done
-
-    # Overflow indicator
-    if (( count > _n )); then
-        local more_text="  +$((count - _n)) more..."
-        printf "${A_DIM}%s${A_RESET}%$((col_w - ${#more_text}))s\n" "$more_text" ""
-        ((lines_used++))
-    fi
-
-    if (( count == 0 )); then
-        local no_text="  No tasks"
-        local no_w=${#no_text}
-        printf "${A_DIM}%s${A_RESET}%$((col_w - no_w))s\n" "$no_text" ""
-        ((lines_used++))
-    fi
-
-    while (( lines_used < max_h )); do
-        printf "%${col_w}s\n" ""
-        ((lines_used++))
-    done
-}
-
-# ESC character for ANSI stripping (defined once at script level)
-_ESC=$'\e'
-
-# Pad line to exact width with spaces
-# Optimized: use zsh parameter expansion to strip ANSI codes
-pad_to_width() {
-    local line="$1"
-    local width="$2"
-    local precomputed_w="${3:-}"
-    # Strip ANSI codes: ESC [ followed by numbers/semicolons, ending with letter
-    local plain="${line//${_ESC}\[[0-9;]#[a-zA-Z]/}"
-    local display_w
-    if [[ -n "$precomputed_w" ]]; then
-        display_w=$precomputed_w
-    else
-        local char_count=${#plain} byte_count
-        LC_ALL=C byte_count=${#plain}
-        unset LC_ALL
-        if [[ $byte_count -eq $char_count ]]; then
-            display_w=$char_count
-        else
-            display_w=$(( char_count + (byte_count - char_count) / 2 ))
-        fi
-    fi
-    local pad=$((width - display_w))
-    printf '%s' "$line"
-    (( pad > 0 )) && printf "%${pad}s" ""
-}
-
-# Draw the board (optimized - arrays instead of temp files)
-# $1: col_sel, $2: card_sel, $3: json_data
-draw_board() {
-    local col_sel=${1:-0}
-    local card_sel=${2:--1}
-    local json_data="$3"
-    local col_w=$CACHED_COL_W
-    local max_h=$CACHED_MAX_H
-
-    local c1=-1 c2=-1 c3=-1
-    case $col_sel in
-        0) c1=$card_sel;;
-        1) c2=$card_sel;;
-        2) c3=$card_sel;;
-    esac
-
-    # Build columns to arrays
-    local -a col1 col2 col3
-    col1=("${(@f)$(build_column_lines "backlog" $((col_sel == 0)) $c1 $max_h $col_w "$json_data")}")
-    col2=("${(@f)$(build_column_lines "in_progress" $((col_sel == 1)) $c2 $max_h $col_w "$json_data")}")
-    col3=("${(@f)$(build_column_lines "review" $((col_sel == 2)) $c3 $max_h $col_w "$json_data")}")
-
-    # Batch compute display widths for all non-ASCII lines (single Python call)
-    # Build input: all lines from all 3 columns, ANSI-stripped
-    local -a all_plains
-    local -a all_widths
-    local _needs_python=0
-    local i _plain _cc _bc
-    for ((i=1; i<=max_h; i++)); do
-        for _col_line in "${col1[$i]}" "${col2[$i]}" "${col3[$i]}"; do
-            _plain="${_col_line//${_ESC}\[[0-9;]#[a-zA-Z]/}"
-            all_plains+=("$_plain")
-            _cc=${#_plain}
-            LC_ALL=C _bc=${#_plain}
-            unset LC_ALL
-            if [[ $_bc -eq $_cc ]]; then
-                all_widths+=($_cc)
-            else
-                all_widths+=(-1)  # marker: needs Python
-                _needs_python=1
-            fi
-        done
-    done
-
-    if (( _needs_python )); then
-        # Single Python call to compute all non-ASCII widths
-        local _input="" _idx
-        for ((_idx=1; _idx<=${#all_plains[@]}; _idx++)); do
-            if [[ ${all_widths[$_idx]} -eq -1 ]]; then
-                _input+="${all_plains[$_idx]}"$'\n'
-            fi
-        done
-        local -a _py_results
-        _coproc_batch_width "$_input"
-        _py_results=("${(@f)_COPROC_RESULT}")
-        # Map Python results back to width array
-        local _pi=1
-        for ((_idx=1; _idx<=${#all_widths[@]}; _idx++)); do
-            if [[ ${all_widths[$_idx]} -eq -1 ]]; then
-                all_widths[$_idx]=${_py_results[$_pi]}
-                ((_pi++))
-            fi
-        done
-    fi
-
-    # Merge line by line using precomputed widths
-    local _wi=1
-    for ((i=1; i<=max_h; i++)); do
-        pad_to_width "${col1[$i]}" $col_w "${all_widths[$_wi]}"
-        ((_wi++))
-        printf "${A_DIM}│${A_RESET}"
-        pad_to_width "${col2[$i]}" $col_w "${all_widths[$_wi]}"
-        ((_wi++))
-        printf "${A_DIM}│${A_RESET}"
-        pad_to_width "${col3[$i]}" $col_w "${all_widths[$_wi]}"
-        ((_wi++))
-        printf '\033[K\n'
-    done
-}
-
-draw_footer() {
-    printf '\033[K\n'
-    print_center "←→ Column  │  ↑↓ Card  │  Shift+↑↓ Reorder  │  Shift+←→ Move  │  Enter Edit/PR  │  ⌫ Del  │  A Add  │  Q Quit" "${A_DIM}"
-}
-
-read_key() {
-    local _rk_timeout="${1:-0.5}"
-    local key result=""
-    # Timeout for spinner animation refresh (default 0.5s)
-    read -sk1 -t "$_rk_timeout" key 2>/dev/null || { echo "timeout"; return; }
-
-    if [[ "$key" == $'\e' ]]; then
-        read -sk1 -t 0.1 c2 2>/dev/null
-        if [[ "$c2" == "[" ]]; then
-            read -sk1 -t 0.1 c3 2>/dev/null
-            case "$c3" in
-                D) result="left";; C) result="right";;
-                A) result="up";; B) result="down";;
-                "1")
-                    # Handle Shift+arrow sequences: ESC[1;2X where X is A/B/C/D
-                    read -sk1 -t 0.1 c4 2>/dev/null
-                    if [[ "$c4" == ";" ]]; then
-                        read -sk1 -t 0.1 c5 2>/dev/null
-                        read -sk1 -t 0.1 c6 2>/dev/null
-                        if [[ "$c5" == "2" ]]; then
-                            case "$c6" in
-                                A) result="shift_up";;
-                                B) result="shift_down";;
-                                C) result="shift_right";;
-                                D) result="shift_left";;
-                            esac
-                        fi
-                    fi
-                    ;;
-            esac
-        elif [[ "$c2" == "]" ]]; then
-            # Drain OSC sequence
-            while read -sk1 -t 0.01 _ 2>/dev/null; do :; done
-        fi
-    elif [[ "$key" == "" || "$key" == $'\n' ]]; then
-        result="enter"
-    elif [[ "$key" == $'\x7f' || "$key" == $'\b' ]]; then
-        result="backspace"
-    else
-        case "$key" in
-            q|Q) result="quit";;
-            a|A) result="add";;
-        esac
-    fi
-
-    echo "$result"
-}
-
-# Move card order up or down within a status column (fractional indexing)
-# $1: status, $2: current card index, $3: direction (-1 for up, 1 for down)
-# When manually moved, the card gets an order value to pin its position
-move_card_order() {
-    local st="$1"
-    local cur_idx="$2"
-    local dir="$3"
-    local new_idx=$((cur_idx + dir))
-
-    # Get issues in current effective order (ordered cards first, then priority-sorted)
-    local issues=$(jq -r --arg s "$st" '
-        .issues | map(select(.status==$s)) | sort_by(
-            if .order != null then [0, .order]
-            else [1, ({"P0":0,"P1":1,"P2":2,"P3":3}[.priority // "P3"] // 3), .id]
-            end
-        )
-    ' "$VIBAN_JSON")
-    local cnt=$(printf '%s' "$issues" | jq 'length')
-
-    # Bounds check
-    (( new_idx < 0 || new_idx >= cnt )) && return 1
-
-    # Get ID of the card to move
-    local cur_id=$(printf '%s' "$issues" | jq -r ".[$cur_idx].id")
-
-    # Calculate effective order for a card (use actual order or virtual priority-based order)
-    get_eff_order() {
-        local idx=$1
-        local order=$(printf '%s' "$issues" | jq -r ".[$idx].order // \"null\"")
-        if [[ "$order" != "null" ]]; then
-            echo "$order"
-        else
-            local priority=$(printf '%s' "$issues" | jq -r ".[$idx].priority // \"P3\"")
-            local id=$(printf '%s' "$issues" | jq -r ".[$idx].id")
-            case "$priority" in
-                P0) echo $((1000000 + id));;
-                P1) echo $((2000000 + id));;
-                P2) echo $((3000000 + id));;
-                *)  echo $((4000000 + id));;
-            esac
-        fi
-    }
-
-    # Calculate new order using fractional indexing
-    # Place card between the target position and its neighbor
-    local new_order
-    if (( dir < 0 )); then
-        # Moving up: place between target and the one above it
-        local target_order=$(get_eff_order $new_idx)
-        if (( new_idx == 0 )); then
-            # Moving to top: use target_order - 1
-            new_order=$(echo "$target_order - 1" | bc)
-        else
-            local above_order=$(get_eff_order $(($new_idx - 1)))
-            new_order=$(echo "scale=6; ($above_order + $target_order) / 2" | bc)
-        fi
-    else
-        # Moving down: place between target and the one below it
-        local target_order=$(get_eff_order $new_idx)
-        if (( new_idx == cnt - 1 )); then
-            # Moving to bottom: use target_order + 1
-            new_order=$(echo "$target_order + 1" | bc)
-        else
-            local below_order=$(get_eff_order $(($new_idx + 1)))
-            new_order=$(echo "scale=6; ($target_order + $below_order) / 2" | bc)
-        fi
-    fi
-
-    # Update the card's order (this pins it to the new position)
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson cur_id "$cur_id" --argjson new_order "$new_order" --arg now "$now" '
-        (.issues[] | select(.id==$cur_id)) |= . + {order:$new_order,updated_at:$now}
-    ' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    return 0
-}
-
-# Get issue ID by status and index (uses correct sort order per status)
-get_issue_id_by_index() {
-    local st=$1 idx=$2
-    local sort_expr=$(get_sort_expr "$st")
-    jq -r --arg s "$st" --argjson i "$idx" ".issues | map(select(.status==\$s)) | $sort_expr | .[\$i].id // empty" "$VIBAN_JSON"
-}
-
-# Delete issue by ID (with worktree cleanup)
-delete_issue() {
-    local id=$1
-    local repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
-    local wt_dir="$VIBAN_DATA_DIR/worktrees/$id"
-
-    local branch="issue-$id"
-    local _ext_id=$(get_ext_id "$id")
-    if [[ -n "$_ext_id" && "$_ext_id" != "null" ]]; then
-        local _issue_num="${_ext_id##*:}"
-        if git -C "$repo_root" rev-parse --verify "issue-${_issue_num}" &>/dev/null 2>&1; then
-            branch="issue-${_issue_num}"
-        fi
-    fi
-
-    if [[ -d "$wt_dir" ]]; then
-        git -C "$repo_root" worktree remove "$wt_dir" --force 2>/dev/null
-        git -C "$repo_root" branch -D "$branch" 2>/dev/null
-    fi
-    jq --argjson id "$id" 'del(.issues[]|select((.id|tonumber)==$id))' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && \
-    mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-}
-
-level1_columns() {
-    IN_TUI=true
-    _start_coproc
-    local col=0 card=0
-
-    # Auto-sync state (120 iterations × 0.5s timeout = ~60s interval)
-    local _sync_counter=0
-    local _SYNC_INTERVAL=120
-    local _sync_pid=""
-
-    # Hide cursor and disable input echo
-    stty -echo 2>/dev/null
-    printf '\033[?25l\033[2J\033[H'
-
-    # Initial cache update
-    update_term_cache
-
-    while true; do
-        # Auto-sync: reap finished background sync
-        if [[ -n "$_sync_pid" ]]; then
-            if ! kill -0 "$_sync_pid" 2>/dev/null; then
-                wait "$_sync_pid" 2>/dev/null
-                _sync_pid=""
-            fi
-        fi
-
-        # Auto-sync: trigger when interval reached and sync configured
-        ((_sync_counter++)) || true
-        if (( _sync_counter >= _SYNC_INTERVAL )) && [[ -z "$_sync_pid" && -f "$VIBAN_DATA_DIR/sync.json" ]]; then
-            _sync_counter=0
-            local _sync_provider
-            _sync_provider=$(jq -r '.provider // ""' "$VIBAN_DATA_DIR/sync.json" 2>/dev/null)
-            if [[ -n "$_sync_provider" && "$_sync_provider" != "null" ]]; then
-                VIBAN_JSON="$VIBAN_JSON" VIBAN_DATA_DIR="$VIBAN_DATA_DIR" \
-                    VIBAN_PROVIDER="$_sync_provider" VIBAN_SCRIPT_DIR="$VIBAN_SCRIPT_DIR" \
-                    bash "$VIBAN_SCRIPT_DIR/scripts/sync.sh" --auto &
-                _sync_pid=$!
-            fi
-        fi
-        # Cache JSON data once per frame
-        local json_data=$(cat "$VIBAN_JSON")
-
-        printf '\033[H\033[0m'
-        draw_header
-        draw_board $col $card "$json_data"
-        draw_footer
-        printf '\033[J'
-
-        # Advance spinner
-        ((SPINNER_IDX++))
-
-        local st="${VIBAN_STATUSES[$((col + 1))]}"
-        # Use cached json_data for count
-        local cnt=$(printf '%s' "$json_data" | jq -r --arg s "$st" '[.issues[]|select(.status==$s)]|length')
-
-        local key=$(read_key)
-        case "$key" in
-            left)
-                local start_col=$col
-                col=$(( (col - 1 + 3) % 3 ))
-                # Skip empty columns (but stop if we return to start)
-                while (( col != start_col )); do
-                    local next_st="${VIBAN_STATUSES[$((col + 1))]}"
-                    local next_cnt=$(printf '%s' "$json_data" | jq -r --arg s "$next_st" '[.issues[]|select(.status==$s)]|length')
-                    (( next_cnt > 0 )) && break
-                    col=$(( (col - 1 + 3) % 3 ))
-                done
-                card=0
-                ;;
-            right)
-                local start_col=$col
-                col=$(( (col + 1) % 3 ))
-                # Skip empty columns (but stop if we return to start)
-                while (( col != start_col )); do
-                    local next_st="${VIBAN_STATUSES[$((col + 1))]}"
-                    local next_cnt=$(printf '%s' "$json_data" | jq -r --arg s "$next_st" '[.issues[]|select(.status==$s)]|length')
-                    (( next_cnt > 0 )) && break
-                    col=$(( (col + 1) % 3 ))
-                done
-                card=0
-                ;;
-            up)
-                (( cnt > 0 )) && card=$(( (card - 1 + cnt) % cnt ))
-                ;;
-            down)
-                (( cnt > 0 )) && card=$(( (card + 1) % cnt ))
-                ;;
-            shift_up)
-                if (( cnt > 0 && card > 0 )); then
-                    local card_id=$(get_issue_id_at_index "$st" "$card" "$json_data")
-                    if move_card_order "$st" $card -1; then
-                        local new_json=$(cat "$VIBAN_JSON")
-                        card=$(get_card_index_by_id "$st" "$card_id" "$new_json")
-                    fi
-                fi
-                ;;
-            shift_down)
-                if (( cnt > 0 && card < cnt - 1 )); then
-                    local card_id=$(get_issue_id_at_index "$st" "$card" "$json_data")
-                    if move_card_order "$st" $card 1; then
-                        local new_json=$(cat "$VIBAN_JSON")
-                        card=$(get_card_index_by_id "$st" "$card_id" "$new_json")
-                    fi
-                fi
-                ;;
-            enter)
-                if (( cnt > 0 )); then
-                    local id=$(get_issue_id_at_index "$st" "$card" "$json_data")
-                    [[ -n "$id" ]] && {
-                        if [[ "$st" == "review" ]]; then
-                            # Open associated PR in browser
-                            local _branch="issue-${id}"
-                            local _ext_id=$(get_ext_id "$id")
-                            if [[ -n "$_ext_id" && "$_ext_id" != "null" ]]; then
-                                local _num="${_ext_id##*:}"
-                                gh pr view "$_num" --web 2>/dev/null || \
-                                    gh pr list --head "$_branch" --web 2>/dev/null
-                            else
-                                gh pr list --head "$_branch" --web 2>/dev/null
-                            fi
-                        else
-                            printf '\033[?25h'
-                            stty echo 2>/dev/null
-                            edit_issue "$id"
-                            stty -echo 2>/dev/null
-                            printf '\033[?25l\033[2J\033[H'
-                        fi
-                    }
-                fi
-                ;;
-            shift_left)
-                if (( cnt > 0 && col > 0 )); then
-                    move_card_status "$st" $card -1 && { col=$((col - 1)); card=0; }
-                fi
-                ;;
-            shift_right)
-                if (( cnt > 0 && col < 2 )); then
-                    move_card_status "$st" $card 1 && { col=$((col + 1)); card=0; }
-                fi
-                ;;
-            add)
-                printf '\033[?25h'
-                stty echo 2>/dev/null
-                add_issue
-                stty -echo 2>/dev/null
-                printf '\033[?25l\033[2J\033[H'
-                ;;
-            backspace)
-                if (( cnt > 0 )); then
-                    local id=$(get_issue_id_at_index "$st" "$card" "$json_data")
-                    [[ -n "$id" ]] && {
-                        # Move cursor to footer line and run gum there
-                        printf '\033[?25h'
-                        stty echo 2>/dev/null
-                        # Clear footer line and show confirm
-                        printf '\033[%d;1H\033[K' "$CACHED_TERM_H"
-                        if gum confirm "Delete $(display_id "$id" "$(get_ext_id "$id")")?" --affirmative "Yes" --negative "No" \
-                            --selected.foreground="#000000" --selected.background "${C[accent]}"; then
-                            delete_issue "$id"
-                            (( card > 0 )) && card=$((card - 1))
-                        fi
-                        stty -echo 2>/dev/null
-                        printf '\033[?25l'
-                        # Redraw footer only (cursor back to footer)
-                        printf '\033[%d;1H\033[K' "$((CACHED_TERM_H - 1))"
-                        draw_footer
-                    }
-                fi
-                ;;
-            quit)
-                printf '\033[?25h\033[0m'
-                stty echo 2>/dev/null
-                clear
-                exit 0
-                ;;
-        esac
-    done
-}
-
-# Edit issue in editor (title + description + priority + type)
-edit_issue() {
-    local id=$1
-    local issue=$(jq --argjson id "$id" '.issues[]|select((.id|tonumber)==$id)' "$VIBAN_JSON")
-    [[ -z "$issue" ]] && return 1
-
-    local title=$(printf '%s' "$issue" | jq -r '.title')
-    local desc=$(printf '%s' "$issue" | jq -r '.description // ""')
-    local ist=$(printf '%s' "$issue" | jq -r '.status')
-    local created=$(printf '%s' "$issue" | jq -r '.created_at')
-    local priority=$(printf '%s' "$issue" | jq -r '.priority // "P3"')
-    local issue_type=$(printf '%s' "$issue" | jq -r '.type // ""')
-    local ext_id=$(printf '%s' "$issue" | jq -r '.external_id // ""')
-    local did; did=$(display_id "$id" "$ext_id")
-
-    local tmpfile=$(mktemp)
-    local editor="${EDITOR:-${VISUAL:-vim}}"
-
-    cat > "$tmpfile" <<TEMPLATE
-# ─────────────────────────────────────────────
-# VIBAN Issue $did
-# ─────────────────────────────────────────────
-# Status: ${STATUS_LABEL[$ist]}
-# Created: ${created:0:10}
-# ─────────────────────────────────────────────
-
-# ▼ Priority (P0=CRITICAL, P1=HIGH, P2=MEDIUM, P3=LOW)
-$priority
-
-# ▼ Type (bug, feat, chore, refactor) - leave empty for none
-$issue_type
-
-# ▼ Title (single line)
-$title
-
-# ▼ Description (multiple lines allowed)
-$desc
-TEMPLATE
-
-    $editor "$tmpfile"
-
-    # Parse: priority -> type -> title -> description
-    local new_priority="" new_type="" new_title="" new_desc="" parse_stage=0
-    while IFS= read -r line; do
-        [[ "$line" =~ ^#.*$ ]] && continue
-        case $parse_stage in
-            0)  # Looking for priority
-                [[ -z "$line" ]] && continue
-                # Validate priority format (P0-P3)
-                if [[ "$line" =~ ^P[0-3]$ ]]; then
-                    new_priority="$line"
-                else
-                    new_priority="P3"  # Default if invalid
-                fi
-                parse_stage=1
-                ;;
-            1)  # Looking for type
-                [[ -z "$line" ]] && continue  # Skip empty lines
-                # Validate type format (bug, feat, chore, refactor)
-                if [[ "$line" =~ ^(bug|feat|chore|refactor)$ ]]; then
-                    new_type="$line"
-                fi
-                parse_stage=2  # Move to stage 2 on any non-empty line
-                ;;
-            2)  # Looking for title
-                [[ -z "$line" ]] && continue
-                new_title="$line"
-                parse_stage=3
-                ;;
-            3)  # Collecting description
-                # Skip empty lines right after title
-                if [[ -z "$new_desc" && -z "$line" ]]; then
-                    continue
-                fi
-                new_desc+="$line"$'\n'
-                ;;
-        esac
-    done < "$tmpfile"
-
-    # Trim trailing newlines from description
-    new_desc="${new_desc%$'\n'}"
-
-    rm -f "$tmpfile"
-
-    [[ -z "$new_title" ]] && return 1
-    [[ -z "$new_priority" ]] && new_priority="P3"
-
-    # Update issue
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    local tmpjson=$(mktemp)
-    printf '%s' "$new_desc" > "$tmpjson"
-    jq --argjson id "$id" --arg title "$new_title" --rawfile desc "$tmpjson" --arg priority "$new_priority" --arg issue_type "$new_type" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {title:$title,description:$desc,priority:$priority,type:(if $issue_type == "" then null else $issue_type end),updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-    rm -f "$tmpjson"
-}
-
-# Move card to adjacent column (change status)
-move_card_status() {
-    local st="$1"
-    local card_idx="$2"
-    local dir="$3"  # -1 for left, 1 for right
-
-    local sort_expr=$(get_sort_expr "$st")
-    local id=$(jq -r --arg s "$st" --argjson i "$card_idx" \
-        ".issues | map(select(.status==\$s)) | $sort_expr | .[\$i].id // empty" "$VIBAN_JSON")
-    [[ -z "$id" ]] && return 1
-
-    # Find current status index and calculate new status
-    local cur_idx=0
-    for i in {1..3}; do
-        [[ "${VIBAN_STATUSES[$i]}" == "$st" ]] && { cur_idx=$i; break; }
-    done
-
-    local new_idx=$((cur_idx + dir))
-    (( new_idx < 1 || new_idx > 3 )) && return 1
-
-    local new_st="${VIBAN_STATUSES[$new_idx]}"
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-    jq --argjson id "$id" --arg new_st "$new_st" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {status:$new_st,updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-}
-
-# CLI commands
-cmd_list() {
-    init_json
-    local _done_ids=$(jq '[.issues[]|select(.status=="done")|.id]' "$VIBAN_JSON")
-    local filter_status=""
-    [[ "$1" == "--status" && -n "$2" ]] && filter_status="$2"
-
-    echo ""
-    if [[ -n "$filter_status" ]]; then
-        local count=$(jq -r --arg s "$filter_status" '[.issues[]|select(.status==$s)]|length' "$VIBAN_JSON")
-        echo "● $filter_status ($count)"
-        jq -r --arg s "$filter_status" --argjson done "$_done_ids" '.issues|map(select(.status==$s))|sort_by(.updated_at)|reverse|.[]|"  \(if .external_id then .external_id else "#\(.id)" end) [\(.priority // "P3")]\(if .type then " [\(.type | ascii_upcase)]" else "" end)\(if ((.blocked_by // []) | length > 0 and any(. as $b | $done | index($b) == null)) then " [BLOCKED]" else "" end) \(.title)"' "$VIBAN_JSON"
-        echo ""
-    else
-        for st in $VIBAN_STATUSES; do
-            gum style --foreground "${STATUS_COLOR[$st]}" --bold "● ${STATUS_LABEL[$st]} ($(count_issues_by_status "$st"))"
-            get_issues_by_status "$st" | jq -r '.[]|"  \(if .external_id then .external_id else "#\(.id)" end) [\(.priority // "P3")]\(if .type then " [\(.type | ascii_upcase)]" else "" end) \(.title)"'
-            echo ""
-        done
-    fi
-}
-
-cmd_history() {
-    init_json
-    local count=$(jq '[.issues[]|select(.status=="done")]|length' "$VIBAN_JSON")
-    echo ""
-    echo "● Done ($count)"
-    jq -r '.issues|map(select(.status=="done"))|sort_by(.updated_at)|reverse|.[]|"  \(if .external_id then .external_id else "#\(.id)" end) [\(.priority // "P3")]\(if .type then " [\(.type | ascii_upcase)]" else "" end) \(.title)  (\(.updated_at | split("T")[0]))"' "$VIBAN_JSON"
-    echo ""
-}
-
-cmd_priority() {
-    init_json
-    [[ -z "$1" ]] && { echo "Usage: viban priority <id> <P0|P1|P2|P3>"; exit 1; }
-    local id="$1"
-    local new_priority="${2:-}"
-
-    # Validate priority
-    if [[ ! "$new_priority" =~ ^P[0-3]$ ]]; then
-        echo "Error: Priority must be P0, P1, P2, or P3"
-        exit 1
-    fi
-
-    # Check if issue exists
-    local exists=$(jq --argjson id "$id" '[.issues[]|select((.id|tonumber)==$id)]|length' "$VIBAN_JSON")
-    [[ "$exists" == "0" ]] && { echo "Error: Issue #$id not found"; exit 1; }
-
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson id "$id" --arg priority "$new_priority" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {priority:$priority,updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ $(display_id "$id" "$(get_ext_id "$id")") priority → $new_priority"
-}
-
-cmd_add() {
-    init_json
-    [[ -z "$1" ]] && { echo "Usage: viban add \"title\" [\"description\"] [priority] [type] [attachments...]"; exit 1; }
-
-    # Support both positional and named args (--title, --description, --priority, --type, --ext-id)
-    local title="" desc="" priority="P3" issue_type="" ext_id="" parent_id=""
-    local -a attachments=()
-    local positional=()
-
-    while [[ $# -gt 0 ]]; do
-        case "$1" in
-            --title)     title="$2"; shift 2 ;;
-            --desc|--description) desc="$2"; shift 2 ;;
-            --desc-file) [[ -f "$2" ]] && desc="$(cat "$2")"; shift 2 ;;
-            --priority)  priority="$2"; shift 2 ;;
-            --type)      issue_type="$2"; shift 2 ;;
-            --ext-id|--external-id) ext_id="$2"; shift 2 ;;
-            --parent)    parent_id="$2"; shift 2 ;;
-            --attach|--attachments) shift; while [[ $# -gt 0 && "$1" != --* ]]; do attachments+=("$1"); shift; done ;;
-            --*)         shift 2 2>/dev/null || shift ;; # skip unknown flags
-            *)           positional+=("$1"); shift ;;
-        esac
-    done
-
-    # Fall back to positional args if named args not used
-    [[ -z "$title" ]] && title="${positional[1]:-}"
-    [[ -z "$desc" ]] && desc="${positional[2]:-}"
-    [[ "$priority" == "P3" && -n "${positional[3]:-}" ]] && priority="${positional[3]}"
-    [[ -z "$issue_type" && -n "${positional[4]:-}" ]] && issue_type="${positional[4]}"
-    if [[ ${#attachments[@]} -eq 0 && ${#positional[@]} -gt 4 ]]; then
-        attachments=("${positional[@]:5}")
-    fi
-
-    [[ -z "$title" ]] && { echo "Usage: viban add \"title\" [\"description\"] [priority] [type]"; exit 1; }
-
-    # Duplicate detection: warn on similar titles (word-level Jaccard >= 0.5)
-    local duplicates=$(jq -r --arg title "$title" '
-        def words: ascii_downcase | gsub("[^a-z0-9가-힣\\s]"; " ") | split(" ") | map(select(length > 1)) | unique;
-        ($title | words) as $new_words |
-        if ($new_words | length) == 0 then empty else
-            .issues[] | select(.status != "done") |
-            (.title | words) as $existing_words |
-            ([$new_words[] | select(. as $w | $existing_words | index($w) != null)] | length) as $overlap |
-            ([$new_words[], $existing_words[]] | unique | length) as $union |
-            select($union > 0 and ($overlap / $union) >= 0.5) |
-            "\(.id)\t\(.title)"
-        end
-    ' "$VIBAN_JSON")
-    if [[ -n "$duplicates" ]]; then
-        echo "⚠ Potential duplicate(s):"
-        while IFS=$'\t' read -r dup_id dup_title; do
-            echo "  #$dup_id $dup_title"
-        done <<< "$duplicates"
-    fi
-
-    # Validate parent exists if specified
-    if [[ -n "$parent_id" ]]; then
-        local parent_exists=$(jq -r --argjson id "$parent_id" '.issues[]|select((.id|tonumber)==$id)|.id//empty' "$VIBAN_JSON")
-        [[ -z "$parent_exists" ]] && { echo "Error: Parent issue #$parent_id not found"; exit 1; }
-    fi
-
-    local id=$(get_next_id) now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    # Validate priority
-    [[ ! "$priority" =~ ^P[0-3]$ ]] && priority="P3"
-    # Validate type (bug, feat, chore, refactor)
-    [[ -n "$issue_type" && ! "$issue_type" =~ ^(bug|feat|chore|refactor)$ ]] && issue_type=""
-    # Build attachments JSON array
-    local attachments_json="[]"
-    if [[ ${#attachments[@]} -gt 0 ]]; then
-        attachments_json=$(printf '%s\n' "${attachments[@]}" | jq -R . | jq -s .)
-    fi
-    # New cards don't have order - they follow priority-based sorting
-    # Order is only assigned when manually moved
-    local tmpjson=$(mktemp)
-    printf '%s' "$desc" > "$tmpjson"
-    jq --arg id "$id" --arg title "$title" --rawfile desc "$tmpjson" --arg priority "$priority" --arg issue_type "$issue_type" --arg ext_id "$ext_id" --arg parent "$parent_id" --argjson attachments "$attachments_json" --arg now "$now" '
-        .next_id = ((.next_id // 0) + 1) |
-        .issues += [{
-            id:($id|tonumber),
-            title:$title,
-            description:$desc,
-            status:"backlog",
-            priority:$priority,
-            type:(if $issue_type == "" then null else $issue_type end),
-            external_id:(if $ext_id == "" then null else $ext_id end),
-            parent_id:(if $parent == "" then null else ($parent|tonumber) end),
-            attachments:$attachments,
-            assigned_to:null,
-            created_at:$now,
-            updated_at:$now
-        }]' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-    rm -f "$tmpjson"
-
-    # Auto-create remote issue if sync is configured and no ext_id provided
-    if [[ -z "$ext_id" && -f "$VIBAN_DATA_DIR/sync.json" ]]; then
-        local provider
-        provider=$(jq -r '.provider // ""' "$VIBAN_DATA_DIR/sync.json" 2>/dev/null)
-        if [[ -n "$provider" && "$provider" != "null" ]]; then
-            local created_ext_id
-            created_ext_id=$(VIBAN_JSON="$VIBAN_JSON" VIBAN_DATA_DIR="$VIBAN_DATA_DIR" \
-                VIBAN_PROVIDER="$provider" VIBAN_SCRIPT_DIR="$VIBAN_SCRIPT_DIR" \
-                bash "$VIBAN_SCRIPT_DIR/scripts/sync_create.sh" "$id" 2>/dev/null) || true
-            [[ -n "$created_ext_id" ]] && ext_id="$created_ext_id"
-        fi
-    fi
-
-    local type_info=""
-    [[ -n "$issue_type" ]] && type_info=" [$issue_type]"
-    local attach_info=""
-    [[ ${#attachments[@]} -gt 0 ]] && attach_info=" +${#attachments[@]} files"
-    local parent_info=""
-    [[ -n "$parent_id" ]] && parent_info=" (child of #$parent_id)"
-    echo "✓ $(display_id "$id" "$ext_id") added ($priority)$type_info$attach_info$parent_info"
-}
-
-cmd_assign() {
-    init_json
-    local session="${1:-$(echo $RANDOM | md5 | head -c 8)}"
-    local done_ids=$(jq '[.issues[]|select(.status=="done")|.id]' "$VIBAN_JSON")
-    local issue=$(jq -r --argjson done "$done_ids" '
-        .issues|map(select(.status=="backlog"))|map(select(
-            (.blocked_by // []) | length == 0 or all(. as $b | $done | index($b) != null)
-        ))|sort_by(if .order != null then [0, .order] else [1, ({"P0":0,"P1":1,"P2":2,"P3":3}[.priority // "P3"] // 3), .id] end)|first' "$VIBAN_JSON")
-    [[ "$issue" == "null" || -z "$issue" ]] && { echo "No backlog"; exit 1; }
-    local id=$(printf '%s' "$issue" | jq -r '.id') now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    local ext_id=$(printf '%s' "$issue" | jq -r '.external_id // ""')
-
-    # Update status to in_progress (no worktree - use branch workflow)
-    jq --argjson id "$id" --arg s "$session" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {status:"in_progress",assigned_to:$s,updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    # Set iTerm2 session name to issue display ID
-    local did; did=$(display_id "$id" "$ext_id")
-    printf '\033]1;%s\007' "$did"
-
-    echo "✓ $did assigned"
-    echo "$id"
-}
-
-cmd_review() {
-    init_json
-    local id="${1:-$(jq -r '.issues|map(select(.status=="in_progress"))|first|.id//empty' "$VIBAN_JSON")}"
-    [[ -z "$id" ]] && { echo "None"; exit 1; }
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson id "$id" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {status:"review",assigned_to:null,updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    # Clear iTerm2 session name
-    printf '\033]1;\007'
-
-    echo "✓ $(display_id "$id" "$(get_ext_id "$id")") → review"
-}
-
-cmd_done() {
-    init_json
-    [[ -z "$1" ]] && { echo "Usage: viban done <id> [--purge]"; exit 1; }
-    local id="$1"
-    local remove=false
-    [[ "$2" == "--remove" || "$2" == "--purge" ]] && remove=true
-
-    # Cleanup worktree if exists
-    local repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
-    local wt_dir="$VIBAN_DATA_DIR/worktrees/$id"
-
-    local branch="issue-$id"
-    local _ext_id=$(get_ext_id "$id")
-    if [[ -n "$_ext_id" && "$_ext_id" != "null" ]]; then
-        local _issue_num="${_ext_id##*:}"
-        if git -C "$repo_root" rev-parse --verify "issue-${_issue_num}" &>/dev/null 2>&1; then
-            branch="issue-${_issue_num}"
-        fi
-    fi
-
-    if [[ -d "$wt_dir" ]]; then
-        git -C "$repo_root" worktree remove "$wt_dir" --force 2>/dev/null
-        git -C "$repo_root" branch -D "$branch" 2>/dev/null
-        echo "✓ worktree removed"
-    fi
-
-    if $remove; then
-        # Delete card (old behavior)
-        jq --argjson id "$id" 'del(.issues[]|select((.id|tonumber)==$id))' \
-            "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-        printf '\033]1;\007'
-        echo "✓ $(display_id "$id" "$(get_ext_id "$id")") completed & removed"
-    else
-        # Move to done status (non-destructive default)
-        local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-        jq --argjson id "$id" --arg now "$now" \
-            '(.issues[]|select((.id|tonumber)==$id)) |= . + {status:"done",assigned_to:null,updated_at:$now}' \
-            "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-        printf '\033]1;\007'
-        echo "✓ $(display_id "$id" "$(get_ext_id "$id")") → done"
-    fi
-}
-
-cmd_move() {
-    init_json
-    [[ -z "$1" || -z "$2" ]] && { echo "Usage: viban move <id> <status>"; exit 1; }
-    local id="$1"
-    local new_status="$2"
-
-    # Validate status
-    local valid_statuses="backlog in_progress review done"
-    if [[ ! " $valid_statuses " == *" $new_status "* ]]; then
-        echo "Error: Invalid status '$new_status'. Valid: backlog, in_progress, review, done"
-        exit 1
-    fi
-
-    # Verify issue exists
-    local cur_status=$(jq -r --argjson id "$id" '.issues[]|select((.id|tonumber)==$id)|.status//empty' "$VIBAN_JSON")
-    [[ -z "$cur_status" ]] && { echo "Error: Issue #$id not found"; exit 1; }
-
-    if [[ "$cur_status" == "$new_status" ]]; then
-        echo "Issue #$id is already in $new_status"
-        return 0
-    fi
-
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson id "$id" --arg s "$new_status" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {status:$s,updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ $(display_id "$id" "$(get_ext_id "$id")") → $new_status"
-}
-
-cmd_comment() {
-    init_json
-    [[ -z "$1" || -z "$2" ]] && { echo "Usage: viban comment <id> \"message\""; exit 1; }
-    local id="$1"
-    shift
-    local message="$*"
-
-    # Verify issue exists
-    local exists=$(jq -r --argjson id "$id" '.issues[]|select((.id|tonumber)==$id)|.id//empty' "$VIBAN_JSON")
-    [[ -z "$exists" ]] && { echo "Error: Issue #$id not found"; exit 1; }
-
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson id "$id" --arg msg "$message" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$id)) |= . + {comments:((.comments // []) + [{text:$msg,created_at:$now}]),updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    local count=$(jq -r --argjson id "$id" '.issues[]|select((.id|tonumber)==$id)|.comments|length' "$VIBAN_JSON")
-    echo "✓ comment #$count added to $(display_id "$id" "$(get_ext_id "$id")")"
-}
-
-cmd_get() {
-    init_json
-    local id="$1"
-    # Output issue JSON
-    jq --argjson id "$id" '.issues[]|select((.id|tonumber)==$id)' "$VIBAN_JSON"
-    # Show sub-tasks if any
-    local subtasks=$(jq -r --argjson id "$id" '[.issues[]|select(.parent_id==$id)]|length' "$VIBAN_JSON")
-    if [[ "$subtasks" -gt 0 ]]; then
-        local done_count=$(jq -r --argjson id "$id" '[.issues[]|select(.parent_id==$id and .status=="done")]|length' "$VIBAN_JSON")
-        echo ""
-        echo "Sub-tasks: $done_count/$subtasks done ($((done_count * 100 / subtasks))%)"
-        jq -r --argjson id "$id" '.issues[]|select(.parent_id==$id)|"  #\(.id) [\(.status)] \(.title)"' "$VIBAN_JSON"
-    fi
-}
-
-cmd_attach() {
-    init_json
-    [[ -z "$1" || -z "$2" ]] && { echo "Usage: viban attach <id> <file1> [file2...]"; exit 1; }
-    local id="$1"
-    shift
-    local files=("$@")
-
-    # Check if issue exists
-    local exists=$(jq --argjson id "$id" '[.issues[]|select((.id|tonumber)==$id)]|length' "$VIBAN_JSON")
-    [[ "$exists" == "0" ]] && { echo "Error: Issue #$id not found"; exit 1; }
-
-    # Build new attachments array
-    local new_attachments=$(printf '%s\n' "${files[@]}" | jq -R . | jq -s .)
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-    # Merge with existing attachments
-    jq --argjson id "$id" --argjson new "$new_attachments" --arg now "$now" '
-        (.issues[] | select((.id|tonumber)==$id)) |= . + {
-            attachments: ((.attachments // []) + $new | unique),
-            updated_at: $now
-        }
-    ' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ $(display_id "$id" "$(get_ext_id "$id")"): ${#files[@]} file(s) attached"
-}
-
-cmd_link() {
-    init_json
-    [[ -z "$1" || "$2" != "blocks" || -z "$3" ]] && { echo "Usage: viban link <id> blocks <id>"; exit 1; }
-    local blocker_id="$1" blocked_id="$3"
-
-    # Verify both issues exist
-    local b1=$(jq -r --argjson id "$blocker_id" '.issues[]|select((.id|tonumber)==$id)|.id//empty' "$VIBAN_JSON")
-    local b2=$(jq -r --argjson id "$blocked_id" '.issues[]|select((.id|tonumber)==$id)|.id//empty' "$VIBAN_JSON")
-    [[ -z "$b1" ]] && { echo "Error: Issue #$blocker_id not found"; exit 1; }
-    [[ -z "$b2" ]] && { echo "Error: Issue #$blocked_id not found"; exit 1; }
-    [[ "$blocker_id" == "$blocked_id" ]] && { echo "Error: Cannot block self"; exit 1; }
-
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson bid "$blocked_id" --argjson rid "$blocker_id" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$bid)) |= . + {blocked_by:((.blocked_by // []) | if index($rid) then . else . + [$rid] end),updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ #$blocker_id blocks #$blocked_id"
-}
-
-cmd_unlink() {
-    init_json
-    [[ -z "$1" || "$2" != "blocks" || -z "$3" ]] && { echo "Usage: viban unlink <id> blocks <id>"; exit 1; }
-    local blocker_id="$1" blocked_id="$3"
-
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-    jq --argjson bid "$blocked_id" --argjson rid "$blocker_id" --arg now "$now" \
-        '(.issues[]|select((.id|tonumber)==$bid)) |= . + {blocked_by:((.blocked_by // []) - [$rid]),updated_at:$now}' \
-        "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ #$blocker_id no longer blocks #$blocked_id"
-}
-
-cmd_stats() {
-    init_json
-    local now_epoch=$(date +%s)
-    local week_ago_epoch=$((now_epoch - 604800))
-
-    # Total by status
-    echo ""
-    echo "Board Summary"
-    echo "─────────────"
-    local backlog_n=$(jq '[.issues[]|select(.status=="backlog")]|length' "$VIBAN_JSON")
-    local wip_n=$(jq '[.issues[]|select(.status=="in_progress")]|length' "$VIBAN_JSON")
-    local review_n=$(jq '[.issues[]|select(.status=="review")]|length' "$VIBAN_JSON")
-    local done_n=$(jq '[.issues[]|select(.status=="done")]|length' "$VIBAN_JSON")
-    local total_n=$(jq '.issues|length' "$VIBAN_JSON")
-    echo "  Backlog: $backlog_n  In Progress: $wip_n  Review: $review_n  Done: $done_n  Total: $total_n"
-
-    # P0/P1 open count
-    local p0_n=$(jq '[.issues[]|select(.status!="done" and .priority=="P0")]|length' "$VIBAN_JSON")
-    local p1_n=$(jq '[.issues[]|select(.status!="done" and .priority=="P1")]|length' "$VIBAN_JSON")
-    echo "  Open P0: $p0_n  Open P1: $p1_n"
-
-    # Issues added/closed this week
-    echo ""
-    echo "This Week (last 7 days)"
-    echo "───────────────────────"
-    local week_ago_iso=$(date -u -r $week_ago_epoch +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d "@$week_ago_epoch" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null)
-    local added_week=$(jq -r --arg since "$week_ago_iso" '[.issues[]|select(.created_at >= $since)]|length' "$VIBAN_JSON")
-    local closed_week=$(jq -r --arg since "$week_ago_iso" '[.issues[]|select(.status=="done" and .updated_at >= $since)]|length' "$VIBAN_JSON")
-    echo "  Added: $added_week  Completed: $closed_week"
-
-    # Average cycle time (created_at → updated_at for done issues)
-    echo ""
-    echo "Cycle Time"
-    echo "──────────"
-    local avg_hours=$(jq -r '
-        [.issues[]|select(.status=="done")|
-            ((.updated_at|split("T")[0]|split("-")|map(tonumber)) as [$y2,$m2,$d2] |
-             (.created_at|split("T")[0]|split("-")|map(tonumber)) as [$y1,$m1,$d1] |
-             (($y2-$y1)*365 + ($m2-$m1)*30 + ($d2-$d1)) * 24)
-        ] | if length == 0 then null else (add / length | floor) end
-    ' "$VIBAN_JSON")
-    if [[ "$avg_hours" == "null" || -z "$avg_hours" ]]; then
-        echo "  Average: no completed issues"
-    elif [[ "$avg_hours" -lt 24 ]]; then
-        echo "  Average: <1 day"
-    else
-        echo "  Average: $((avg_hours / 24)) days"
-    fi
-
-    # Oldest open issue
-    echo ""
-    echo "Oldest Open Issue"
-    echo "─────────────────"
-    local oldest=$(jq -r '[.issues[]|select(.status!="done")]|sort_by(.created_at)|first|if . then "#\(.id) [\(.priority)] \(.title) (created \(.created_at|split("T")[0]))" else "none" end' "$VIBAN_JSON")
-    echo "  $oldest"
-    echo ""
-}
-
-cmd_migrate() {
-    init_json
-    echo "Migrating issues..."
-    local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-    # Migration 1: extract [BUG], [FEATURE], [REFACTOR] from title to type field
-    # Also strip [P0-P3] from title if present (already in priority field)
-    echo "  - Extracting type from titles..."
-    jq --arg now "$now" '
-        .issues = [.issues[] |
-            # Extract type from title
-            (if (.title | test("^\\[BUG\\]"; "i")) then "bug"
-             elif (.title | test("^\\[FEATURE\\]"; "i")) then "feat"
-             elif (.title | test("^\\[FEAT\\]"; "i")) then "feat"
-             elif (.title | test("^\\[REFACTOR\\]"; "i")) then "refactor"
-             elif (.title | test("^\\[CHORE\\]"; "i")) then "chore"
-             else .type // null end) as $extracted_type |
-
-            # Clean title: remove [BUG], [FEATURE], [REFACTOR], [CHORE], [P0-P3] prefixes
-            (.title |
-                gsub("^\\[BUG\\]\\s*"; "") |
-                gsub("^\\[FEATURE\\]\\s*"; "") |
-                gsub("^\\[FEAT\\]\\s*"; "") |
-                gsub("^\\[REFACTOR\\]\\s*"; "") |
-                gsub("^\\[CHORE\\]\\s*"; "") |
-                gsub("^\\[P[0-3]\\]\\s*"; "")
-            ) as $clean_title |
-
-            # Update issue
-            . + {
-                title: $clean_title,
-                type: (if $extracted_type then $extracted_type else .type end),
-                updated_at: $now
-            }
-        ]
-    ' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    # Migration 2: Remove order field from all issues
-    # New behavior: order is only set when manually moved, otherwise follows priority
-    echo "  - Removing order field (reset to priority-based sorting)..."
-    jq --arg now "$now" '
-        .issues = [.issues[] | del(.order) | . + {updated_at: $now}]
-    ' "$VIBAN_JSON" > "$VIBAN_JSON.tmp" && mv "$VIBAN_JSON.tmp" "$VIBAN_JSON"
-
-    echo "✓ Migration complete"
-    echo ""
-    echo "Summary:"
-    jq -r '
-        [.issues[] | select(.type != null)] | group_by(.type) |
-        .[] | "  \(.[0].type): \(length) issues"
-    ' "$VIBAN_JSON"
-    echo "  (no type): $(jq '[.issues[] | select(.type == null)] | length' "$VIBAN_JSON") issues"
-    echo ""
-    echo "Issues by priority:"
-    jq -r '
-        [.issues[] | select(.status != "done")] |
-        group_by(.priority // "P3") | sort_by(.[0].priority) |
-        .[] | "  \(.[0].priority // "P3"): \(length) issues"
-    ' "$VIBAN_JSON"
-}
-
-cmd_sync() {
-    local provider="${VIBAN_SYNC_PROVIDER:-}"
-    # Auto-detect provider from existing sync.json or default to github
-    if [[ -z "$provider" && -f "$VIBAN_DATA_DIR/sync.json" ]]; then
-        provider=$(jq -r '.provider // "github"' "$VIBAN_DATA_DIR/sync.json")
-    fi
-    provider="${provider:-github}"
-
-    local provider_script="$VIBAN_SCRIPT_DIR/scripts/providers/${provider}.sh"
-    if [[ ! -f "$provider_script" ]]; then
-        echo "Error: Unknown sync provider '$provider'"
-        echo "Available: $(ls "$VIBAN_SCRIPT_DIR/scripts/providers/" 2>/dev/null | sed 's/\.sh$//' | tr '\n' ' ')"
-        exit 1
-    fi
-
-    VIBAN_JSON="$VIBAN_JSON" VIBAN_DATA_DIR="$VIBAN_DATA_DIR" \
-    VIBAN_PROVIDER="$provider" VIBAN_SCRIPT_DIR="$VIBAN_SCRIPT_DIR" \
-        bash "$VIBAN_SCRIPT_DIR/scripts/sync.sh" "$@"
-}
+# ============================================================
+# Source library modules
+# ============================================================
+source "$VIBAN_SCRIPT_DIR/lib/config.zsh"
+source "$VIBAN_SCRIPT_DIR/lib/helpers.zsh"
+source "$VIBAN_SCRIPT_DIR/lib/tui.zsh"
+source "$VIBAN_SCRIPT_DIR/lib/commands.zsh"
 
+# ============================================================
+# Main dispatch
+# ============================================================
 main() {
     check_deps
     init_json
@@ -1907,15 +216,19 @@ main() {
         attach) shift; cmd_attach "$@";;
         assign) cmd_assign "$2";;
         review) cmd_review "$2";;
-        done)   cmd_done "$2" "$3";;
+        done)   shift; cmd_done "$@";;
         move)   cmd_move "$2" "$3";;
         get)    cmd_get "$2";;
         comment) shift; cmd_comment "$@";;
         link)   cmd_link "$2" "$3" "$4";;
-        unlink) cmd_unlink "$2" "$3" "$4";;
+        unlink) shift; cmd_unlink "$@";;
         edit)   [[ -z "$2" ]] && { echo "Usage: viban edit <id>"; exit 1; }; edit_issue "$2";;
         priority) cmd_priority "$2" "$3";;
         stats)   cmd_stats;;
+        backup)  cmd_backup;;
+        restore) shift; cmd_restore "$@";;
+        changelog) cmd_changelog "$2";;
+        export)  cmd_export "$2";;
         migrate) cmd_migrate;;
         sync)   shift; cmd_sync "$@";;
         --version|-v)
@@ -1940,7 +253,7 @@ main() {
             echo ""
             echo "  viban             TUI"
             echo "  viban list        Show board"
-            echo "  viban list --status <s>  Filter by status"
+            echo "  viban list [--status <s>] [--priority P0,P1] [--type bug] [--search text]"
             echo "  viban history     Show completed issues"
             echo "  viban add \"title\" [\"desc\"] [P0-P3] [type] [--parent <id>]  Add task"
             echo "  viban attach <id> <file1> [file2...]  Attach files to task"
@@ -1955,6 +268,10 @@ main() {
             echo "  viban edit <id>   Edit task in editor"
             echo "  viban get <id>    Get task details (JSON)"
             echo "  viban stats       Show throughput metrics and statistics"
+            echo "  viban backup      Snapshot viban.json to backups/"
+            echo "  viban restore [f] List or restore a backup"
+            echo "  viban changelog [range]  Generate changelog from commits"
+            echo "  viban export [md|html]   Export board as markdown or HTML"
             echo "  viban migrate     Migrate: extract type from title"
             echo "  viban sync        Sync with external issue tracker (GitHub, etc.)"
             echo "  viban update      Update to latest version (if available)"