forge-workflow 0.0.4 → 0.0.6

package/scripts/forge-team/lib/epic.sh

@@ -0,0 +1,332 @@
+#!/usr/bin/env bash
+# scripts/forge-team/lib/epic.sh — Epic rollup view
+#
+# Shows epic progress with per-developer breakdown and blocked issue tracking.
+#
+# Functions:
+#   cmd_epic  — Top-level dispatcher entry point
+#
+# Env overrides (for testing):
+#   BD_CMD   — Path to bd binary
+#
+# This file does NOT set errexit/pipefail — callers manage their own shell options.
+
+# Guard against double-sourcing
+if [[ -n "${_EPIC_LIB_LOADED:-}" ]]; then
+  return 0 2>/dev/null || true
+fi
+_EPIC_LIB_LOADED=1
+
+# ── Internal helpers ─────────────────────────────────────────────────────
+
+# _epic_get_bd — Returns the bd command path
+_epic_get_bd() {
+  printf '%s' "${BD_CMD:-bd}"
+}
+
+# _epic_parse_blocks <bd-show-output>
+# Extracts child issue IDs from the BLOCKS section.
+# Each line in BLOCKS looks like: ← ✓ forge-child1: Child 1 (closed)
+# Returns one ID per line.
+_epic_parse_blocks() {
+  local bd_output="$1"
+  local in_blocks=0
+
+  while IFS= read -r line; do
+    if [[ "$line" == "BLOCKS" ]]; then
+      in_blocks=1
+      continue
+    fi
+    # Stop at next section header (non-indented, non-empty line after BLOCKS)
+    if [[ $in_blocks -eq 1 ]]; then
+      if [[ -z "$line" ]]; then
+        continue
+      fi
+      if [[ "$line" =~ ^[A-Z] ]]; then
+        break
+      fi
+      # Extract issue ID: matches forge-XXXX pattern after the arrow+status marker
+      local child_id
+      child_id="$(printf '%s' "$line" | sed -n 's/.*← [^ ]* \([a-z0-9-]*\):.*/\1/p')"
+      if [[ -n "$child_id" ]]; then
+        printf '%s\n' "$child_id"
+      fi
+    fi
+  done <<< "$bd_output"
+}
+
+# _epic_get_child_info <child-id>
+# Returns: id|status|owner|title|blocked_by
+_epic_get_child_info() {
+  local child_id="$1"
+  local bd_cmd
+  bd_cmd="$(_epic_get_bd)"
+
+  local child_output
+  child_output="$("$bd_cmd" show "$child_id" 2>/dev/null)" || return 1
+
+  local first_line
+  first_line="$(printf '%s' "$child_output" | head -1)"
+
+  # Parse status from the first character/marker
+  local status="open"
+  if [[ "$first_line" == *"CLOSED"* ]] || [[ "$first_line" == *"✓"* ]]; then
+    status="closed"
+  elif [[ "$first_line" == *"IN_PROGRESS"* ]] || [[ "$first_line" == *"◐"* ]]; then
+    status="in_progress"
+  fi
+
+  # Parse title — between · and [
+  local title
+  title="$(printf '%s' "$first_line" | sed -n 's/^[^ ]* [^ ]* · \(.*\) \[.*/\1/p')"
+  if [[ -z "$title" ]]; then
+    title="$child_id"
+  fi
+
+  # Parse owner from "Owner: xxx" line
+  local owner=""
+  owner="$(printf '%s' "$child_output" | sed -n 's/^Owner: *//p' | head -1)"
+
+  # Check for BLOCKED_BY section
+  local blocked_by=""
+  blocked_by="$(printf '%s' "$child_output" | sed -n '/^BLOCKED_BY$/,/^[A-Z]/{ /^  /{ s/.*→ \([a-z0-9-]*\):.*/\1/p; }; }')"
+
+  printf '%s|%s|%s|%s|%s' "$child_id" "$status" "$owner" "$title" "$blocked_by"
+}
+
+# _epic_status_icon <status>
+_epic_status_icon() {
+  case "$1" in
+    closed)      printf '%s' "✓" ;;
+    in_progress) printf '%s' "◐" ;;
+    *)           printf '%s' "○" ;;
+  esac
+}
+
+# ── Public API ───────────────────────────────────────────────────────────
+
+# cmd_epic <issue-id> [--format=json]
+cmd_epic() {
+  local issue_id="${1:-}"
+  local format_flag="${2:-}"
+
+  if [[ -z "$issue_id" ]]; then
+    echo "ERROR: Usage: forge team epic <issue-id> [--format=json]" >&2
+    return 1
+  fi
+
+  local bd_cmd
+  bd_cmd="$(_epic_get_bd)"
+
+  # 1. Get epic details
+  local epic_output
+  epic_output="$("$bd_cmd" show "$issue_id" 2>/dev/null)" || {
+    echo "ERROR: Could not fetch epic $issue_id" >&2
+    return 1
+  }
+
+  # Parse epic title from first line
+  local epic_first_line
+  epic_first_line="$(printf '%s' "$epic_output" | head -1)"
+  local epic_title
+  epic_title="$(printf '%s' "$epic_first_line" | sed -n 's/^[^ ]* [^ ]* · \(.*\) \[.*/\1/p')"
+  if [[ -z "$epic_title" ]]; then
+    epic_title="$issue_id"
+  fi
+
+  # 2. Parse BLOCKS section to find child issues
+  local children_ids
+  children_ids="$(_epic_parse_blocks "$epic_output")"
+
+  # Handle empty epic
+  if [[ -z "$children_ids" ]]; then
+    if [[ "$format_flag" == "--format=json" ]]; then
+      cat <<ENDJSON
+{"epic_id":"$issue_id","title":"$epic_title","total":0,"done":0,"in_progress":0,"open_count":0,"percentage":0,"children":[],"by_developer":{},"blocked":[]}
+ENDJSON
+      return 0
+    fi
+    echo "Epic: $issue_id — $epic_title"
+    echo "No child issues"
+    return 0
+  fi
+
+  # 3. For each child: get status, assignee
+  local total=0
+  local done_count=0
+  local in_progress_count=0
+  local open_count=0
+  local blocked_list=""
+
+  # Arrays for child data (using indexed approach for bash 3 compat)
+  local child_lines=""
+  # Developer tracking: accumulate "dev:status" pairs
+  local dev_entries=""
+
+  while IFS= read -r child_id; do
+    [[ -z "$child_id" ]] && continue
+
+    local info
+    info="$(_epic_get_child_info "$child_id")" || continue
+
+    local c_id c_status c_owner c_title c_blocked
+    IFS='|' read -r c_id c_status c_owner c_title c_blocked <<< "$info"
+
+    total=$((total + 1))
+
+    case "$c_status" in
+      closed)      done_count=$((done_count + 1)) ;;
+      in_progress) in_progress_count=$((in_progress_count + 1)) ;;
+      *)           open_count=$((open_count + 1)) ;;
+    esac
+
+    # Track blocked children
+    if [[ -n "$c_blocked" ]]; then
+      if [[ -n "$blocked_list" ]]; then
+        blocked_list="$blocked_list"$'\n'"$c_id blocked by $c_blocked"
+      else
+        blocked_list="$c_id blocked by $c_blocked"
+      fi
+    fi
+
+    # Build child line for display
+    local icon
+    icon="$(_epic_status_icon "$c_status")"
+    local display_owner="${c_owner:-unassigned}"
+    child_lines="${child_lines}  $icon $c_id  [$display_owner]  $c_title ($c_status)"$'\n'
+
+    # Track developer entries
+    if [[ -n "$c_owner" ]]; then
+      dev_entries="${dev_entries}${c_owner}:${c_status}"$'\n'
+    fi
+  done <<< "$children_ids"
+
+  # 4. Calculate completion percentage
+  local percentage=0
+  if [[ $total -gt 0 ]]; then
+    percentage=$(( (done_count * 100) / total ))
+  fi
+
+  # 5. Build per-developer breakdown
+  # Collect unique developers
+  local devs=""
+  while IFS= read -r entry; do
+    [[ -z "$entry" ]] && continue
+    local dev="${entry%%:*}"
+    if [[ -z "$devs" ]] || ! printf '%s' "$devs" | grep -qxF "$dev"; then
+      if [[ -n "$devs" ]]; then
+        devs="$devs"$'\n'"$dev"
+      else
+        devs="$dev"
+      fi
+    fi
+  done <<< "$dev_entries"
+
+  # JSON output
+  if [[ "$format_flag" == "--format=json" ]]; then
+    local children_json="["
+    local first_child=1
+    while IFS= read -r child_id; do
+      [[ -z "$child_id" ]] && continue
+      local info
+      info="$(_epic_get_child_info "$child_id")" || continue
+      local c_id c_status c_owner c_title c_blocked
+      IFS='|' read -r c_id c_status c_owner c_title c_blocked <<< "$info"
+
+      if [[ $first_child -eq 0 ]]; then
+        children_json="$children_json,"
+      fi
+      first_child=0
+      children_json="$children_json{\"id\":\"$c_id\",\"status\":\"$c_status\",\"owner\":\"$c_owner\",\"title\":\"$c_title\",\"blocked_by\":\"$c_blocked\"}"
+    done <<< "$children_ids"
+    children_json="$children_json]"
+
+    local dev_json="{"
+    local first_dev=1
+    while IFS= read -r dev; do
+      [[ -z "$dev" ]] && continue
+      local d_done=0 d_in_progress=0 d_open=0 d_total=0
+      while IFS= read -r entry; do
+        [[ -z "$entry" ]] && continue
+        local e_dev="${entry%%:*}"
+        local e_status="${entry#*:}"
+        if [[ "$e_dev" == "$dev" ]]; then
+          d_total=$((d_total + 1))
+          case "$e_status" in
+            closed)      d_done=$((d_done + 1)) ;;
+            in_progress) d_in_progress=$((d_in_progress + 1)) ;;
+            *)           d_open=$((d_open + 1)) ;;
+          esac
+        fi
+      done <<< "$dev_entries"
+
+      if [[ $first_dev -eq 0 ]]; then
+        dev_json="$dev_json,"
+      fi
+      first_dev=0
+      dev_json="$dev_json\"$dev\":{\"total\":$d_total,\"done\":$d_done,\"in_progress\":$d_in_progress,\"open\":$d_open}"
+    done <<< "$devs"
+    dev_json="$dev_json}"
+
+    local blocked_json="["
+    if [[ -n "$blocked_list" ]]; then
+      local first_blocked=1
+      while IFS= read -r bline; do
+        [[ -z "$bline" ]] && continue
+        if [[ $first_blocked -eq 0 ]]; then
+          blocked_json="$blocked_json,"
+        fi
+        first_blocked=0
+        blocked_json="$blocked_json\"$bline\""
+      done <<< "$blocked_list"
+    fi
+    blocked_json="$blocked_json]"
+
+    printf '{"epic_id":"%s","title":"%s","total":%d,"done":%d,"in_progress":%d,"open_count":%d,"percentage":%d,"children":%s,"by_developer":%s,"blocked":%s}\n' \
+      "$issue_id" "$epic_title" "$total" "$done_count" "$in_progress_count" "$open_count" "$percentage" \
+      "$children_json" "$dev_json" "$blocked_json"
+    return 0
+  fi
+
+  # Text output
+  echo "Epic: $issue_id — $epic_title"
+  echo "Progress: $done_count/$total ($percentage%)"
+  printf '%s' "$child_lines"
+
+  echo ""
+  echo "By developer:"
+  while IFS= read -r dev; do
+    [[ -z "$dev" ]] && continue
+    local d_done=0 d_in_progress=0 d_open=0 d_total=0
+    while IFS= read -r entry; do
+      [[ -z "$entry" ]] && continue
+      local e_dev="${entry%%:*}"
+      local e_status="${entry#*:}"
+      if [[ "$e_dev" == "$dev" ]]; then
+        d_total=$((d_total + 1))
+        case "$e_status" in
+          closed)      d_done=$((d_done + 1)) ;;
+          in_progress) d_in_progress=$((d_in_progress + 1)) ;;
+          *)           d_open=$((d_open + 1)) ;;
+        esac
+      fi
+    done <<< "$dev_entries"
+
+    local dev_parts=""
+    dev_parts="$d_done/$d_total done"
+    [[ $d_in_progress -gt 0 ]] && dev_parts="$dev_parts, $d_in_progress in progress"
+    [[ $d_open -gt 0 ]] && dev_parts="$dev_parts, $d_open open"
+    echo "  $dev: $dev_parts"
+  done <<< "$devs"
+
+  echo ""
+  if [[ -n "$blocked_list" ]]; then
+    echo "Blocked:"
+    while IFS= read -r bline; do
+      [[ -z "$bline" ]] && continue
+      echo "  $bline"
+    done <<< "$blocked_list"
+  else
+    echo "Blocked: none"
+  fi
+}

package/scripts/forge-team/lib/hooks.sh

@@ -0,0 +1,253 @@
+#!/usr/bin/env bash
+# scripts/forge-team/lib/hooks.sh — Hook-based sync (pre-push + stage transitions)
+#
+# Functions:
+#   forge_team_sync [--quiet]                          — Top-level sync for hooks/manual
+#   forge_team_sync_on_stage <beads-id> <from> <to>    — Stage transition sync
+#   _check_auto_sync_enabled                           — Check config for auto-sync
+#
+# Env overrides (for testing):
+#   GH_CMD      — Path to gh binary (default: gh)
+#   BD_CMD      — Path to bd binary (default: bd)
+#   BEADS_ROOT  — Path to .beads/ parent directory (default: .)
+#
+# This file does NOT set errexit/pipefail — callers manage their own shell options.
+
+# Guard against double-sourcing
+if [[ -n "${_HOOKS_LIB_LOADED:-}" ]]; then
+  return 0 2>/dev/null || true
+fi
+_HOOKS_LIB_LOADED=1
+
+_HOOKS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source dependencies
+if [[ -f "$_HOOKS_DIR/agent-prompt.sh" ]]; then
+  source "$_HOOKS_DIR/agent-prompt.sh"
+fi
+
+if [[ -f "$_HOOKS_DIR/sync-github.sh" ]]; then
+  source "$_HOOKS_DIR/sync-github.sh"
+fi
+
+# ── Internal helpers ─────────────────────────────────────────────────────
+
+# _hooks_error <message>
+_hooks_error() {
+  if declare -f agent_error &>/dev/null; then
+    agent_error "$1"
+  else
+    echo "ERROR: $1" >&2
+  fi
+}
+
+# _hooks_info <message>
+_hooks_info() {
+  if declare -f agent_info &>/dev/null; then
+    agent_info "$1"
+  else
+    echo "INFO: $1" >&2
+  fi
+}
+
+# _hooks_warn <message>
+_hooks_warn() {
+  echo "FORGE_AGENT_7f3a:WARN: $1" >&2
+}
+
+# ── _check_auto_sync_enabled ─────────────────────────────────────────────
+# Reads .beads/config.yaml for team.auto-sync setting.
+# Returns 0 if enabled (default), 1 if disabled.
+_check_auto_sync_enabled() {
+  local beads_root="${BEADS_ROOT:-.}"
+  local config_file="$beads_root/.beads/config.yaml"
+
+  if [[ ! -f "$config_file" ]]; then
+    # Default: enabled
+    return 0
+  fi
+
+  # Parse auto-sync value from YAML (simple grep, no yq dependency)
+  local auto_sync_line
+  auto_sync_line="$(grep -E 'auto-sync:' "$config_file" 2>/dev/null || true)"
+
+  if [[ -z "$auto_sync_line" ]]; then
+    # Not set → default enabled
+    return 0
+  fi
+
+  local value
+  value="$(printf '%s' "$auto_sync_line" | sed -E 's/.*auto-sync:[[:space:]]*//' | tr -d '[:space:]')"
+
+  if [[ "$value" == "false" ]]; then
+    return 1
+  fi
+
+  return 0
+}
+
+# ── Public API ───────────────────────────────────────────────────────────
+
+# forge_team_sync [--quiet]
+# Top-level sync function called by hooks and manual `forge team sync`.
+# 1. Check gh auth status
+# 2. Check auto-sync config
+# 3. Get in_progress issues with github_issue state
+# 4. Sync each to GitHub
+# 5. Report count (unless --quiet)
+# Non-blocking: warns on failure, doesn't prevent push.
+forge_team_sync() {
+  local quiet=false
+
+  # Parse arguments
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --quiet) quiet=true; shift ;;
+      *) shift ;;
+    esac
+  done
+
+  local gh_cmd="${GH_CMD:-gh}"
+  local bd_cmd="${BD_CMD:-bd}"
+
+  # 1. Check gh auth status
+  if ! "$gh_cmd" auth status >/dev/null 2>&1; then
+    _hooks_error "GitHub CLI not authenticated. Run 'gh auth login'."
+    return 1
+  fi
+
+  # 2. Check auto-sync config
+  if ! _check_auto_sync_enabled; then
+    # auto-sync disabled, skip silently
+    return 0
+  fi
+
+  # 3. Get all in_progress issues
+  local list_output
+  list_output="$("$bd_cmd" list --status=in_progress 2>/dev/null)" || {
+    if [[ "$quiet" == "false" ]]; then
+      _hooks_warn "Failed to list issues, sync skipped"
+    fi
+    return 0
+  }
+
+  # Filter empty lines
+  if [[ -z "$list_output" ]] || [[ -z "$(echo "$list_output" | tr -d '[:space:]')" ]]; then
+    if [[ "$quiet" == "false" ]]; then
+      _hooks_info "Nothing to sync"
+    fi
+    return 0
+  fi
+
+  # 4. For each issue, check for github_issue state and sync
+  local synced=0
+  local warnings=0
+
+  while IFS= read -r line; do
+    [[ -z "$line" ]] && continue
+
+    # Extract issue id
+    local issue_id
+    issue_id="$(echo "$line" | grep -oE 'forge-[a-zA-Z0-9]+' | head -1)"
+    [[ -z "$issue_id" ]] && continue
+
+    # Get details to check for github_issue state
+    local show_output
+    show_output="$("$bd_cmd" show "$issue_id" 2>/dev/null)" || continue
+
+    # Check if it has github_issue:N state
+    local gh_issue_num
+    gh_issue_num="$(printf '%s' "$show_output" | grep -oP 'github_issue:\K[0-9]+' | head -1 || true)"
+
+    if [[ -z "$gh_issue_num" ]]; then
+      # No GitHub issue linked, skip but warn
+      warnings=$((warnings + 1))
+      if [[ "$quiet" == "false" ]]; then
+        _hooks_warn "No github_issue for $issue_id, sync skipped"
+      fi
+      continue
+    fi
+
+    # Sync status to in_progress on GitHub
+    if sync_issue_status "$issue_id" "in_progress" 2>/dev/null; then
+      synced=$((synced + 1))
+    else
+      warnings=$((warnings + 1))
+      if [[ "$quiet" == "false" ]]; then
+        _hooks_warn "Failed to sync $issue_id to GitHub"
+      fi
+    fi
+  done <<< "$list_output"
+
+  # 5. Report
+  if [[ "$quiet" == "false" ]]; then
+    if [[ "$synced" -gt 0 ]]; then
+      _hooks_info "Synced $synced issues to GitHub"
+    elif [[ "$warnings" -gt 0 ]]; then
+      _hooks_warn "Sync completed with $warnings warnings"
+    fi
+  fi
+
+  return 0
+}
+
+# forge_team_sync_on_stage <beads-id> <from-stage> <to-stage>
+# Called after stage transitions. Syncs the specific issue.
+# Stages: plan → dev → validate → ship → review → premerge → verify
+forge_team_sync_on_stage() {
+  local beads_id="${1:-}"
+  local from_stage="${2:-}"
+  local to_stage="${3:-}"
+
+  if [[ -z "$beads_id" ]] || [[ -z "$from_stage" ]] || [[ -z "$to_stage" ]]; then
+    _hooks_error "Usage: forge_team_sync_on_stage <beads-id> <from-stage> <to-stage>"
+    return 1
+  fi
+
+  # Check auto-sync
+  if ! _check_auto_sync_enabled; then
+    return 0
+  fi
+
+  local status=""
+  case "$to_stage" in
+    dev)
+      status="in_progress"
+      ;;
+    ship)
+      status="in_progress"
+      ;;
+    verify)
+      # Will be closed by /verify, skip sync
+      _hooks_info "Stage verify: sync skipped (closed by /verify)"
+      return 0
+      ;;
+    *)
+      # Other stages: sync as in_progress if moving forward
+      status="in_progress"
+      ;;
+  esac
+
+  if [[ -n "$status" ]]; then
+    if ! sync_issue_status "$beads_id" "$status" 2>/dev/null; then
+      _hooks_warn "Failed to sync $beads_id status on stage transition $from_stage → $to_stage"
+    fi
+  fi
+
+  return 0
+}
+
+# ── CLI entrypoint (for lefthook) ────────────────────────────────────────
+# When called directly: bash hooks.sh sync [--quiet]
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  case "${1:-}" in
+    sync)
+      shift
+      forge_team_sync "$@"
+      ;;
+    *)
+      echo "Usage: hooks.sh sync [--quiet]" >&2
+      exit 1
+      ;;
+  esac
+fi