forge-workflow 0.0.4 → 0.0.6

package/scripts/forge-team/tests/claim.test.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Setup temp dir for test isolation ────────────────────────────────────
+TEST_TMP="$(mktemp -d)"
+trap 'rm -rf "$TEST_TMP"' EXIT
+
+# Override TEAM_MAP_ROOT so tests don't touch real .beads/
+export TEAM_MAP_ROOT="$TEST_TMP"
+
+# ── Create mock gh ───────────────────────────────────────────────────────
+mock_dir="$(mktemp -d)"
+
+cat > "$mock_dir/gh" << 'MOCK'
+#!/usr/bin/env bash
+case "$1 $2" in
+  "issue view")
+    # Determine issue number from args
+    issue_num=""
+    for arg in "$@"; do
+      if [[ "$arg" =~ ^[0-9]+$ ]]; then
+        issue_num="$arg"
+        break
+      fi
+    done
+    if echo "$*" | grep -q "assignees"; then
+      case "$issue_num" in
+        42) echo "otherdev" ;;
+        43) echo "" ;;
+        44) echo "testuser" ;;
+        *) echo "" ;;
+      esac
+    fi
+    ;;
+  "issue edit")
+    echo "edited"
+    ;;
+  "api user")
+    echo "testuser"
+    ;;
+esac
+MOCK
+chmod +x "$mock_dir/gh"
+
+# Mock gh that fails (not authenticated)
+cat > "$mock_dir/gh-fail" << 'MOCK'
+#!/usr/bin/env bash
+echo "not logged in" >&2
+exit 1
+MOCK
+chmod +x "$mock_dir/gh-fail"
+
+# ── Create mock bd ───────────────────────────────────────────────────────
+cat > "$mock_dir/bd" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  show)
+    case "$2" in
+      forge-assigned) echo "forge-assigned  Assigned Issue [github_issue:42]" ;;
+      forge-unassigned) echo "forge-unassigned  Unassigned Issue [github_issue:43]" ;;
+      forge-mine) echo "forge-mine  My Issue [github_issue:44]" ;;
+      forge-nogithub) echo "forge-nogithub  No GitHub Issue" ;;
+      *) echo "unknown issue" ;;
+    esac ;;
+  update) echo "Updated" ;;
+  comments) echo "Comment added" ;;
+esac
+MOCK
+chmod +x "$mock_dir/bd"
+
+export GH_CMD="$mock_dir/gh"
+export BD_CMD="$mock_dir/bd"
+
+# Source the library under test
+source "$SCRIPT_DIR/lib/claim.sh"
+
+PASS=0
+FAIL=0
+
+assert_eq() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected '$expected', got '$actual')"
+  fi
+}
+
+assert_contains() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == *"$expected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected to contain '$expected', got '$actual')"
+  fi
+}
+
+assert_exit() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" -eq "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected exit $expected, got $actual)"
+  fi
+}
+
+# ── Test 1: Pre-claim on unassigned issue → returns 0 ───────────────────
+echo "── Test 1: Pre-claim on unassigned issue ──"
+unset _GITHUB_USER_CACHE
+mkdir -p "$TEST_TMP/.beads"
+rc=0
+pre_claim_check "forge-unassigned" 2>/dev/null || rc=$?
+assert_exit "unassigned issue returns 0" 0 "$rc"
+
+# ── Test 2: Pre-claim on issue assigned to someone else → returns 1 ─────
+echo ""
+echo "── Test 2: Pre-claim on issue assigned to someone else ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(pre_claim_check "forge-assigned" 2>&1)" || rc=$?
+assert_exit "assigned to other returns 1" 1 "$rc"
+assert_contains "output mentions claimed" "claimed by" "$output"
+assert_contains "output mentions PROMPT prefix" "FORGE_AGENT_7f3a:PROMPT:" "$output"
+
+# ── Test 3: Pre-claim on issue assigned to current user → returns 0 ─────
+echo ""
+echo "── Test 3: Pre-claim on issue assigned to current user ──"
+unset _GITHUB_USER_CACHE
+rc=0
+pre_claim_check "forge-mine" 2>/dev/null || rc=$?
+assert_exit "assigned to self returns 0" 0 "$rc"
+
+# ── Test 4: --force overrides pre-claim check, logs override ────────────
+echo ""
+echo "── Test 4: --force overrides pre-claim check ──"
+unset _GITHUB_USER_CACHE
+mkdir -p "$TEST_TMP/.beads"
+rc=0
+output="$(forge_team_claim "forge-assigned" "--force" 2>&1)" || rc=$?
+assert_exit "force claim succeeds" 0 "$rc"
+assert_contains "confirmation output" "claimed" "$output"
+
+# ── Test 5: Claim with lock succeeds → bd update --claim AND gh issue edit both called ──
+echo ""
+echo "── Test 5: Claim with lock succeeds ──"
+unset _GITHUB_USER_CACHE
+mkdir -p "$TEST_TMP/.beads"
+# Use the unassigned issue so pre-claim passes
+rc=0
+output="$(forge_team_claim "forge-unassigned" 2>&1)" || rc=$?
+assert_exit "claim succeeds" 0 "$rc"
+assert_contains "confirmation output" "claimed" "$output"
+
+# ── Test 6: Missing GitHub issue number → error ─────────────────────────
+echo ""
+echo "── Test 6: Missing GitHub issue number ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(pre_claim_check "forge-nogithub" 2>&1)" || rc=$?
+assert_exit "missing issue number returns 1" 1 "$rc"
+assert_contains "error about missing issue" "github_issue" "$output"
+
+# ── Test 7: gh not authenticated → error ─────────────────────────────────
+echo ""
+echo "── Test 7: gh not authenticated ──"
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh-fail"
+rc=0
+output="$(pre_claim_check "forge-unassigned" 2>&1)" || rc=$?
+assert_exit "unauthenticated returns 1" 1 "$rc"
+# Restore working mock
+export GH_CMD="$mock_dir/gh"
+
+# ── Results ──────────────────────────────────────────────────────────────
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

package/scripts/forge-team/tests/dashboard.test.sh

@@ -0,0 +1,170 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Setup temp dir for test isolation ────────────────────────────────────
+TEST_TMP="$(mktemp -d)"
+trap 'rm -rf "$TEST_TMP"' EXIT
+
+# ── Create mock bd ───────────────────────────────────────────────────────
+mock_dir="$(mktemp -d)"
+
+cat > "$mock_dir/bd" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  list)
+    if echo "$*" | grep -q -- "--status=open,in_progress"; then
+      if [[ -n "${BD_MOCK_EMPTY:-}" ]]; then
+        # No output for empty test
+        :
+      elif [[ -n "${BD_MOCK_SINGLE:-}" ]]; then
+        echo "◐ forge-aaa · Feature A"
+      else
+        echo "◐ forge-aaa · Feature A"
+        echo "○ forge-bbb · Feature B"
+        echo "◐ forge-ccc · Feature C"
+      fi
+    fi
+    ;;
+  show)
+    case "$2" in
+      forge-aaa)
+        echo "◐ forge-aaa · Feature A [● P2 · IN_PROGRESS]"
+        echo "Owner: devone"
+        echo "Updated: 2026-03-27T10:00:00Z"
+        ;;
+      forge-bbb)
+        echo "○ forge-bbb · Feature B [● P2 · OPEN]"
+        echo "Owner: devtwo"
+        echo "Updated: 2026-03-24T10:00:00Z"
+        ;;
+      forge-ccc)
+        echo "◐ forge-ccc · Feature C [● P1 · IN_PROGRESS]"
+        echo "Owner: devone"
+        echo "Updated: 2026-03-27T09:00:00Z"
+        echo ""
+        echo "DEPENDS ON"
+        echo "  → ◐ forge-aaa: Feature A"
+        ;;
+    esac
+    ;;
+esac
+MOCK
+chmod +x "$mock_dir/bd"
+
+export BD_CMD="$mock_dir/bd"
+
+# Source the library under test
+source "$SCRIPT_DIR/lib/dashboard.sh"
+
+PASS=0
+FAIL=0
+
+assert_eq() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected '$expected', got '$actual')"
+  fi
+}
+
+assert_contains() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == *"$expected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected to contain '$expected', got '$actual')"
+  fi
+}
+
+assert_not_contains() {
+  local label="$1" unexpected="$2" actual="$3"
+  if [[ "$actual" != *"$unexpected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected NOT to contain '$unexpected')"
+  fi
+}
+
+assert_exit() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" -eq "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected exit $expected, got $actual)"
+  fi
+}
+
+# ── Test 1: Full dashboard with multiple developers ──────────────────────
+echo "── Test 1: Full dashboard with multiple developers ──"
+
+# Override _now to a fixed time: 2026-03-27T12:00:00Z = 1774836000
+export FORGE_NOW=1774836000
+
+rc=0
+output="$(cmd_dashboard 2>&1)" || rc=$?
+assert_exit "dashboard exits 0" 0 "$rc"
+assert_contains "shows Team Dashboard header" "Team Dashboard" "$output"
+assert_contains "shows devone stats" "devone" "$output"
+assert_contains "shows devtwo stats" "devtwo" "$output"
+assert_contains "shows total summary" "Total:" "$output"
+
+# ── Test 2: Stale issue flagged (forge-bbb >48h old) ────────────────────
+echo ""
+echo "── Test 2: Stale issue flagged ──"
+
+# forge-bbb updated 2026-03-24T10:00:00Z, now is 2026-03-27T12:00:00Z => ~74h
+assert_contains "stale section shown" "Stale assignments" "$output"
+assert_contains "forge-bbb flagged as stale" "forge-bbb" "$output"
+assert_contains "stale issue shows devtwo" "devtwo" "$output"
+
+# ── Test 3: Blocked issue detected (forge-ccc depends on forge-aaa) ─────
+echo ""
+echo "── Test 3: Blocked issue detected ──"
+
+assert_contains "blocked section shown" "Blocked issues" "$output"
+assert_contains "forge-ccc flagged as blocked" "forge-ccc" "$output"
+assert_contains "blocked shows dependency" "forge-aaa" "$output"
+
+# ── Test 4: No issues → "No active issues" ──────────────────────────────
+echo ""
+echo "── Test 4: No issues → clear message ──"
+
+export BD_MOCK_EMPTY=1
+rc=0
+output_empty="$(cmd_dashboard 2>&1)" || rc=$?
+assert_exit "empty dashboard exits 0" 0 "$rc"
+assert_contains "shows no active issues" "No active issues" "$output_empty"
+unset BD_MOCK_EMPTY
+
+# ── Test 5: Single developer → works correctly ──────────────────────────
+echo ""
+echo "── Test 5: Single developer ──"
+
+export BD_MOCK_SINGLE=1
+rc=0
+output_single="$(cmd_dashboard 2>&1)" || rc=$?
+assert_exit "single dev dashboard exits 0" 0 "$rc"
+assert_contains "shows devone" "devone" "$output_single"
+assert_not_contains "no devtwo in single mode" "devtwo" "$output_single"
+unset BD_MOCK_SINGLE
+
+# ── Test 6: --format=json → valid JSON ──────────────────────────────────
+echo ""
+echo "── Test 6: --format=json → valid JSON ──"
+
+rc=0
+output_json="$(cmd_dashboard --format=json 2>&1)" || rc=$?
+assert_exit "json format exits 0" 0 "$rc"
+# Check it starts with { and contains expected keys
+assert_contains "json has developers key" "developers" "$output_json"
+assert_contains "json has total key" "total" "$output_json"
+assert_contains "json has stale key" "stale" "$output_json"
+assert_contains "json has blocked key" "blocked" "$output_json"
+
+# ── Results ──────────────────────────────────────────────────────────────
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

package/scripts/forge-team/tests/dispatcher.test.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# Tests for forge-team CLI dispatcher (index.sh)
+# Exit codes: 0=all pass, 1=any failure
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DISPATCHER="$SCRIPT_DIR/../index.sh"
+
+PASS=0
+FAIL=0
+
+assert_exit() {
+  local desc="$1" expected="$2"
+  shift 2
+  "$@" >/dev/null 2>&1
+  local actual=$?
+  if [[ "$actual" -eq "$expected" ]]; then
+    echo "  PASS: $desc"
+    ((PASS++))
+  else
+    echo "  FAIL: $desc (expected exit=$expected, got exit=$actual)"
+    ((FAIL++))
+  fi
+}
+
+assert_output_contains() {
+  local desc="$1" pattern="$2"
+  shift 2
+  local output
+  output=$("$@" 2>&1) || true
+  if echo "$output" | grep -q "$pattern"; then
+    echo "  PASS: $desc"
+    ((PASS++))
+  else
+    echo "  FAIL: $desc (expected output containing '$pattern')"
+    ((FAIL++))
+  fi
+}
+
+echo "=== forge-team dispatcher tests ==="
+
+# Test 1: help exits 0 and shows usage
+echo ""
+echo "-- help subcommand --"
+assert_exit "help exits 0" 0 bash "$DISPATCHER" help
+assert_output_contains "help shows usage" "Usage: forge team" bash "$DISPATCHER" help
+
+# Test 2: No args exits 1
+echo ""
+echo "-- no args --"
+assert_exit "no args exits 1" 1 bash "$DISPATCHER"
+
+# Test 3: Unknown subcommand exits 1 with error
+echo ""
+echo "-- unknown subcommand --"
+assert_exit "unknown subcommand exits 1" 1 bash "$DISPATCHER" bogus
+assert_output_contains "unknown subcommand shows error" "unknown subcommand" bash "$DISPATCHER" bogus
+
+# Test 4: Each stub subcommand is reachable (exits 0)
+echo ""
+echo "-- stub subcommands reachable --"
+for cmd in workload epic dashboard add verify sync claim; do
+  assert_exit "$cmd exits 0" 0 bash "$DISPATCHER" "$cmd"
+  assert_output_contains "$cmd outputs stub message" "not implemented" bash "$DISPATCHER" "$cmd"
+done
+
+# Test 5: Sources libs without error (script runs successfully)
+echo ""
+echo "-- sources libs gracefully --"
+assert_exit "dispatcher sources libs without error" 0 bash "$DISPATCHER" help
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+
+if [[ "$FAIL" -gt 0 ]]; then
+  exit 1
+fi
+exit 0

package/scripts/forge-team/tests/epic.test.sh

@@ -0,0 +1,176 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Setup temp dir for test isolation ────────────────────────────────────
+TEST_TMP="$(mktemp -d)"
+trap 'rm -rf "$TEST_TMP"' EXIT
+
+# ── Create mock bd ───────────────────────────────────────────────────────
+mock_dir="$(mktemp -d)"
+
+cat > "$mock_dir/bd" << 'MOCK'
+#!/usr/bin/env bash
+case "$1 $2" in
+  "show forge-epic1")
+    cat << 'SHOW'
+◐ forge-epic1 · Test Epic [● P2 · IN_PROGRESS]
+Owner: devone
+
+BLOCKS
+  ← ✓ forge-child1: Child 1 (closed)
+  ← ◐ forge-child2: Child 2 (in_progress)
+  ← ○ forge-child3: Child 3 (open)
+SHOW
+    ;;
+  "show forge-child1")
+    echo "✓ forge-child1 · Child 1 [● P2 · CLOSED]"
+    echo "Owner: devone"
+    ;;
+  "show forge-child2")
+    echo "◐ forge-child2 · Child 2 [● P2 · IN_PROGRESS]"
+    echo "Owner: devtwo"
+    ;;
+  "show forge-child3")
+    echo "○ forge-child3 · Child 3 [● P3 · OPEN]"
+    echo "Owner: devone"
+    ;;
+  "show forge-empty")
+    cat << 'SHOW'
+○ forge-empty · Empty Epic [● P2 · OPEN]
+Owner: devone
+SHOW
+    ;;
+  "show forge-blocked")
+    cat << 'SHOW'
+◐ forge-blocked · Blocked Epic [● P2 · IN_PROGRESS]
+Owner: devone
+
+BLOCKS
+  ← ✓ forge-bchild1: Bchild 1 (closed)
+  ← ◐ forge-bchild2: Bchild 2 (in_progress)
+  ← ○ forge-bchild3: Bchild 3 (open)
+SHOW
+    ;;
+  "show forge-bchild1")
+    echo "✓ forge-bchild1 · Bchild 1 [● P2 · CLOSED]"
+    echo "Owner: devone"
+    ;;
+  "show forge-bchild2")
+    cat << 'SHOW'
+◐ forge-bchild2 · Bchild 2 [● P2 · IN_PROGRESS]
+Owner: devtwo
+
+BLOCKED_BY
+  → forge-bchild1: Bchild 1
+SHOW
+    ;;
+  "show forge-bchild3")
+    echo "○ forge-bchild3 · Bchild 3 [● P3 · OPEN]"
+    echo "Owner: devone"
+    ;;
+esac
+MOCK
+chmod +x "$mock_dir/bd"
+
+export BD_CMD="$mock_dir/bd"
+
+# Source the library under test
+source "$SCRIPT_DIR/lib/epic.sh"
+
+PASS=0
+FAIL=0
+
+assert_eq() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected '$expected', got '$actual')"
+  fi
+}
+
+assert_contains() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == *"$expected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected to contain '$expected', got '$actual')"
+  fi
+}
+
+assert_exit() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" -eq "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected exit $expected, got $actual)"
+  fi
+}
+
+# ── Test 1: Epic with mixed status children → correct progress count ─────
+echo "── Test 1: Epic with mixed status children ──"
+rc=0
+output="$(cmd_epic "forge-epic1" 2>&1)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+assert_contains "shows epic id" "forge-epic1" "$output"
+assert_contains "progress shows 1/3" "1/3" "$output"
+assert_contains "shows closed child marker" "forge-child1" "$output"
+assert_contains "shows in_progress child" "forge-child2" "$output"
+assert_contains "shows open child" "forge-child3" "$output"
+
+# ── Test 2: Per-developer breakdown correct ──────────────────────────────
+echo ""
+echo "── Test 2: Per-developer breakdown correct ──"
+assert_contains "devone breakdown" "devone" "$output"
+assert_contains "devtwo breakdown" "devtwo" "$output"
+
+# ── Test 3: Completion percentage correct ────────────────────────────────
+echo ""
+echo "── Test 3: Completion percentage correct ──"
+assert_contains "shows 33%" "33%" "$output"
+
+# ── Test 4: Empty epic → No child issues ─────────────────────────────────
+echo ""
+echo "── Test 4: Empty epic ──"
+rc=0
+output_empty="$(cmd_epic "forge-empty" 2>&1)" || rc=$?
+assert_exit "exits 0 for empty epic" 0 "$rc"
+assert_contains "shows no child issues" "No child issues" "$output_empty"
+
+# ── Test 5: --format=json → valid JSON with all fields ───────────────────
+echo ""
+echo "── Test 5: --format=json ──"
+rc=0
+output_json="$(cmd_epic "forge-epic1" "--format=json" 2>&1)" || rc=$?
+assert_exit "json exits 0" 0 "$rc"
+# Validate it's actual JSON (check for opening brace and key fields)
+assert_contains "json has epic_id" "epic_id" "$output_json"
+assert_contains "json has total" "total" "$output_json"
+assert_contains "json has done" "done" "$output_json"
+assert_contains "json has percentage" "percentage" "$output_json"
+assert_contains "json has children" "children" "$output_json"
+assert_contains "json has by_developer" "by_developer" "$output_json"
+
+# ── Test 6: Missing issue-id → error ────────────────────────────────────
+echo ""
+echo "── Test 6: Missing issue-id ──"
+rc=0
+output_missing="$(cmd_epic 2>&1)" || rc=$?
+assert_exit "missing id returns 1" 1 "$rc"
+assert_contains "error about usage" "Usage" "$output_missing"
+
+# ── Test 7: Blocked children shown ───────────────────────────────────────
+echo ""
+echo "── Test 7: Blocked children shown ──"
+rc=0
+output_blocked="$(cmd_epic "forge-blocked" 2>&1)" || rc=$?
+assert_exit "blocked epic exits 0" 0 "$rc"
+assert_contains "blocked section present" "Blocked" "$output_blocked"
+assert_contains "blocked child mentioned" "forge-bchild2" "$output_blocked"
+
+# ── Results ──────────────────────────────────────────────────────────────
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1