claude-plugin-viban 1.3.9 → 1.3.12

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "viban",
-  "version": "1.3.9",
+  "version": "1.3.12",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "author": {
     "name": "happy-nut"

package/README.md

@@ -6,7 +6,7 @@
 [![npm version](https://badge.fury.io/js/claude-plugin-viban.svg)](https://www.npmjs.com/package/claude-plugin-viban)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-![viban screenshot](assets/screenshot.png)
+![viban](assets/viban.png)
 
 ## Why viban?
 
@@ -17,6 +17,8 @@
 
 ## Recommended Workflow
 
+![recommended workflow](assets/screenshot.png)
+
 The most effective way to use viban is with **multiple terminal sessions**:
 
 ```

package/bin/viban

@@ -601,9 +601,10 @@ build_column_lines() {
     # 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 issues_data=$(printf '%s' "$json_data" | jq -r --arg s "$st" "
+    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 // \"\")\"")
+        .[] | \"\\(.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
@@ -639,7 +640,8 @@ build_column_lines() {
     [[ "$st" == "in_progress" ]] && _spinner_w=2
     local _cc _bc _pfx _did
 
-    while IFS=$'\t' read -r _id _title _desc _priority _type _ext_id; do
+    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"
@@ -648,6 +650,7 @@ build_column_lines() {
 
         _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")
@@ -742,10 +745,11 @@ build_column_lines() {
         desc_pad=$((card_inner - ${_desc_cws[$_i]}))
         (( desc_pad < 0 )) && desc_pad=0
 
-        # Priority and type tags
+        # 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}"
@@ -753,6 +757,11 @@ build_column_lines() {
         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"
@@ -769,9 +778,9 @@ build_column_lines() {
         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}%${tags_pad}s${border_color}│${A_RESET} \n" "$priority_tag" "$type_tag" ""
+            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}%${tags_pad}s${border_color}│${A_RESET} \n" "$priority_tag" ""
+            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"
 
@@ -1375,12 +1384,32 @@ move_card_status() {
 # 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 ""
-    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)"'
+    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 ""
-    done
+    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() {
@@ -1412,7 +1441,7 @@ cmd_add() {
     [[ -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=""
+    local title="" desc="" priority="P3" issue_type="" ext_id="" parent_id=""
     local -a attachments=()
     local positional=()
 
@@ -1424,6 +1453,7 @@ cmd_add() {
             --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 ;;
@@ -1441,6 +1471,32 @@ cmd_add() {
 
     [[ -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"
@@ -1455,7 +1511,7 @@ cmd_add() {
     # 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" --argjson attachments "$attachments_json" --arg now "$now" '
+    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),
@@ -1465,6 +1521,7 @@ cmd_add() {
             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,
@@ -1489,13 +1546,19 @@ cmd_add() {
     [[ -n "$issue_type" ]] && type_info=" [$issue_type]"
     local attach_info=""
     [[ ${#attachments[@]} -gt 0 ]] && attach_info=" +${#attachments[@]} files"
-    echo "✓ $(display_id "$id" "$ext_id") added ($priority)$type_info$attach_info"
+    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 issue=$(jq -r '.issues|map(select(.status=="backlog"))|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")
+    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 // ""')
@@ -1530,10 +1593,10 @@ cmd_review() {
 
 cmd_done() {
     init_json
-    [[ -z "$1" ]] && { echo "Usage: viban done <id> [--remove]"; exit 1; }
+    [[ -z "$1" ]] && { echo "Usage: viban done <id> [--purge]"; exit 1; }
     local id="$1"
     local remove=false
-    [[ "$2" == "--remove" ]] && remove=true
+    [[ "$2" == "--remove" || "$2" == "--purge" ]] && remove=true
 
     # Cleanup worktree if exists
     local repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
@@ -1571,7 +1634,70 @@ cmd_done() {
     fi
 }
 
-cmd_get() { init_json; jq --argjson id "$1" '.issues[]|select((.id|tonumber)==$id)' "$VIBAN_JSON"; }
+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
@@ -1599,6 +1725,97 @@ cmd_attach() {
     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..."
@@ -1684,15 +1901,21 @@ main() {
     check_deps
     init_json
     case "${1:-}" in
-        list)   cmd_list;;
+        list)   shift; cmd_list "$@";;
+        history) cmd_history;;
         add)    shift; cmd_add "$@";;
         attach) shift; cmd_attach "$@";;
         assign) cmd_assign "$2";;
         review) cmd_review "$2";;
         done)   cmd_done "$2" "$3";;
+        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";;
         edit)   [[ -z "$2" ]] && { echo "Usage: viban edit <id>"; exit 1; }; edit_issue "$2";;
         priority) cmd_priority "$2" "$3";;
+        stats)   cmd_stats;;
         migrate) cmd_migrate;;
         sync)   shift; cmd_sync "$@";;
         --version|-v)
@@ -1717,14 +1940,21 @@ main() {
             echo ""
             echo "  viban             TUI"
             echo "  viban list        Show board"
-            echo "  viban add \"title\" [\"desc\"] [P0-P3] [type] [files...]  Add task"
+            echo "  viban list --status <s>  Filter by status"
+            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"
             echo "  viban priority <id> <P0-P3>   Set priority"
             echo "  viban assign      Assign first backlog (by priority)"
             echo "  viban review      → Human Review"
-            echo "  viban done <id> [--remove]   Complete (--remove to delete)"
+            echo "  viban move <id> <status>     Move to status (backlog,in_progress,review,done)"
+            echo "  viban done <id> [--purge]    Complete (--purge to permanently delete)"
+            echo "  viban comment <id> \"msg\"  Add comment to task"
+            echo "  viban link <id> blocks <id>  Add dependency"
+            echo "  viban unlink <id> blocks <id>  Remove dependency"
             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 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)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin-viban",
-  "version": "1.3.9",
+  "version": "1.3.12",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "main": "bin/viban",
   "bin": {

package/skills/assign/SKILL.md

@@ -45,33 +45,12 @@ viban get $ISSUE_ID
 
 Display the issue title, description, priority, and type to the user.
 
-## Step 3: Evaluate Clarity
+## Step 3: Evaluate Clarity → Proceed Immediately
 
-Assess whether the issue description provides enough context to start working:
+Assess whether the issue description provides enough context to start working.
 
-- **Clear**: the symptom, affected area, and expected behavior are all understandable
-- **Unclear**: vague description, missing context, ambiguous scope, or multiple possible interpretations
-
-### If Unclear
-
-Interview the user with AskUserQuestion to gather missing context. Ask about:
-- What specifically is the problem? (symptom)
-- Where does it happen? (location/trigger)
-- What is the expected behavior?
-- Any additional constraints or context?
-
-After gathering answers, update the issue description:
-
-```bash
-cat > /tmp/viban-desc-update.md <<'VIBAN_EOF'
-{original description}
-
-## Clarification
-{gathered context from interview}
-VIBAN_EOF
-
-# Re-add the issue with enriched description (edit via TUI or recreate)
-```
+- **Clear** → **proceed directly to Step 4. Do NOT ask the user for confirmation. Do NOT ask "should I start?". Just start.**
+- **Unclear** → interview the user with AskUserQuestion to gather missing context, then proceed to Step 4 immediately.
 
 ## Step 4: Execute Workflow
 
@@ -90,9 +69,7 @@ Follow the workflow from Step 0. If no workflow was found, use this default pipe
 - Run build and tests to confirm the fix works
 - Verify no regressions
 
-### 4.4 Ship (MANDATORY)
-
-Every step below is **required** unless the workflow explicitly says to stop earlier.
+### 4.4 Ship (MANDATORY — execute ALL 4 commands in sequence)
 
 ```bash
 # 1. Commit
@@ -102,7 +79,7 @@ git commit -m "fix: {description} (#$ISSUE_ID)"
 # 2. Push
 git push -u origin issue-$ISSUE_ID
 
-# 3. Create PR (REQUIRED — do NOT skip this)
+# 3. Create PR (REQUIRED — do NOT skip)
 gh pr create --title "fix: {description}" --body "Resolves #$ISSUE_ID
 
 ## Summary
@@ -110,19 +87,18 @@ gh pr create --title "fix: {description}" --body "Resolves #$ISSUE_ID
 
 ## Test plan
 {how it was verified}"
-```
-
-**If `gh pr create` fails**: fix the error and retry. Do NOT skip PR creation.
-
-## Step 5: Move to Review
 
-After PR is created:
-
-```bash
+# 4. Move to review (REQUIRED — do NOT skip)
 viban review $ISSUE_ID
 ```
 
-Report completion with the PR URL:
+**If any command fails**: fix the error and retry. Do NOT skip any step.
+
+### Completion Checklist (ALL must be true before you stop)
+
+- [ ] PR created (you have a PR URL)
+- [ ] `viban review` called (issue status is "review")
+- [ ] Completion message includes PR URL
 
 ```
 Issue #{id} resolved → review
@@ -130,7 +106,7 @@ Issue #{id} resolved → review
   PR: {pr_url}
 ```
 
-**Do NOT report completion without a PR URL.**
+**If you don't have a PR URL or haven't called `viban review`, you are NOT done. Go back and do it.**
 
 ---