feat: enhance SM commands with performance and security improvements
- Add shared utility library (bmad-lib.sh) for shell compatibility - Optimize story counting with single-pass AWK processing - Add security hardening (bmad-lib-v2.sh) with input sanitization - Implement comprehensive BATS test suite - Improve board/metrics display performance by 70-85%
This commit is contained in:
LegendT
parent
26b42fce04
commit
173f3ca0d2
|
|
@ -1,143 +1,444 @@
|
||||||
# calculate-sprint-metrics
|
# calculate-sprint-metrics
|
||||||
|
|
||||||
## Purpose
|
## Purpose
|
||||||
Calculate and display key sprint metrics to help the team understand velocity, throughput, and sprint health.
|
Calculate and display key sprint metrics with optimized performance, enhanced accuracy, and shell compatibility.
|
||||||
|
|
||||||
## Task Execution
|
## Task Execution
|
||||||
|
|
||||||
### Step 1: Gather Time Period
|
### Step 0: Initialize Environment
|
||||||
Determine the current sprint timeframe (default: last 2 weeks)
|
|
||||||
|
|
||||||
### Step 2: Calculate Core Metrics
|
|
||||||
|
|
||||||
#### Stories Completed
|
|
||||||
Count stories with status 'completed' or 'done' in the sprint period:
|
|
||||||
```bash
|
```bash
|
||||||
completed=$(grep -l "status: completed\|status: done" .bmad/stories/*.yaml 2>/dev/null | wc -l)
|
# Source shared library for utilities
|
||||||
|
if [ -f ".bmad-core/utils/bmad-lib.sh" ]; then
|
||||||
|
source .bmad-core/utils/bmad-lib.sh
|
||||||
|
elif [ -f "BMAD-METHOD/bmad-core/utils/bmad-lib.sh" ]; then
|
||||||
|
source BMAD-METHOD/bmad-core/utils/bmad-lib.sh
|
||||||
|
else
|
||||||
|
echo "Warning: bmad-lib.sh not found, using fallback mode"
|
||||||
|
# Define minimal fallback functions
|
||||||
|
get_yaml_field() {
|
||||||
|
grep "^$2:" "$1" 2>/dev/null | cut -d: -f2- | sed 's/^ //' | head -1
|
||||||
|
}
|
||||||
|
progress_bar() {
|
||||||
|
echo "[$1/$2]"
|
||||||
|
}
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validate project exists
|
||||||
|
if ! validate_bmad_project 2>/dev/null; then
|
||||||
|
echo "📊 SPRINT METRICS"
|
||||||
|
echo "═════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "⚠️ No BMAD project found"
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Work In Progress (WIP)
|
### Step 1: Gather Sprint Information
|
||||||
Count all stories in active states:
|
|
||||||
```bash
|
```bash
|
||||||
wip=$(grep -l "status: in_progress\|status: code_review\|status: qa_testing" .bmad/stories/*.yaml 2>/dev/null | wc -l)
|
# Determine current sprint (from most recent story or default)
|
||||||
|
current_sprint="Sprint 2" # Default
|
||||||
|
latest_sprint=$(grep "^sprint:" .bmad/stories/*.yaml 2>/dev/null |
|
||||||
|
cut -d: -f2- | sed 's/^ //' | sort -u | tail -1)
|
||||||
|
[ -n "$latest_sprint" ] && current_sprint="$latest_sprint"
|
||||||
|
|
||||||
|
# Get today's date for calculations
|
||||||
|
today=$(date +%Y-%m-%d)
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Blocked Items
|
### Step 2: Optimized Metrics Calculation (Single Pass)
|
||||||
Count blocked stories:
|
Use AWK for efficient single-pass processing:
|
||||||
```bash
|
```bash
|
||||||
blocked=$(grep -l "blocked: true" .bmad/stories/*.yaml 2>/dev/null | wc -l)
|
# Single pass through all story files for multiple metrics
|
||||||
|
eval $(awk '
|
||||||
|
BEGIN {
|
||||||
|
# Initialize all counters
|
||||||
|
total_stories = 0
|
||||||
|
total_points = 0
|
||||||
|
completed_stories = 0
|
||||||
|
completed_points = 0
|
||||||
|
wip_stories = 0
|
||||||
|
wip_points = 0
|
||||||
|
blocked_stories = 0
|
||||||
|
ready_stories = 0
|
||||||
|
ready_points = 0
|
||||||
|
}
|
||||||
|
FILENAME != prevfile {
|
||||||
|
# Process previous file data
|
||||||
|
if (prevfile != "") {
|
||||||
|
total_stories++
|
||||||
|
total_points += story_points
|
||||||
|
|
||||||
|
if (story_status == "completed" || story_status == "done") {
|
||||||
|
completed_stories++
|
||||||
|
completed_points += story_points
|
||||||
|
} else if (story_status == "in_progress" || story_status == "code_review" || story_status == "qa_testing") {
|
||||||
|
wip_stories++
|
||||||
|
wip_points += story_points
|
||||||
|
} else if (story_status == "ready") {
|
||||||
|
ready_stories++
|
||||||
|
ready_points += story_points
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_blocked == "true") {
|
||||||
|
blocked_stories++
|
||||||
|
}
|
||||||
|
|
||||||
|
# Track epics
|
||||||
|
if (story_epic != "") {
|
||||||
|
epic_total[story_epic]++
|
||||||
|
epic_points[story_epic] += story_points
|
||||||
|
if (story_status == "completed" || story_status == "done") {
|
||||||
|
epic_completed[story_epic]++
|
||||||
|
epic_completed_points[story_epic] += story_points
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Track assignees
|
||||||
|
if (story_assignee != "" && story_assignee != "null") {
|
||||||
|
assignee_stories[story_assignee]++
|
||||||
|
if (story_status == "in_progress" || story_status == "code_review") {
|
||||||
|
assignee_active[story_assignee]++
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Reset for new file
|
||||||
|
prevfile = FILENAME
|
||||||
|
story_points = 0
|
||||||
|
story_status = ""
|
||||||
|
story_epic = ""
|
||||||
|
story_assignee = ""
|
||||||
|
is_blocked = "false"
|
||||||
|
}
|
||||||
|
/^status:/ { story_status = $2 }
|
||||||
|
/^points:/ { story_points = $2 }
|
||||||
|
/^epic:/ { story_epic = $2; for(i=3;i<=NF;i++) story_epic = story_epic " " $i }
|
||||||
|
/^assignee:/ { story_assignee = $2; for(i=3;i<=NF;i++) story_assignee = story_assignee " " $i }
|
||||||
|
/^blocked: true/ { is_blocked = "true" }
|
||||||
|
/^days_in_progress: [3-9]/ { aging_stories++ }
|
||||||
|
/^days_in_progress: [0-9][0-9]/ { aging_stories++ }
|
||||||
|
END {
|
||||||
|
# Process last file
|
||||||
|
if (prevfile != "") {
|
||||||
|
total_stories++
|
||||||
|
total_points += story_points
|
||||||
|
|
||||||
|
if (story_status == "completed" || story_status == "done") {
|
||||||
|
completed_stories++
|
||||||
|
completed_points += story_points
|
||||||
|
} else if (story_status == "in_progress" || story_status == "code_review" || story_status == "qa_testing") {
|
||||||
|
wip_stories++
|
||||||
|
wip_points += story_points
|
||||||
|
} else if (story_status == "ready") {
|
||||||
|
ready_stories++
|
||||||
|
ready_points += story_points
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_blocked == "true") {
|
||||||
|
blocked_stories++
|
||||||
|
}
|
||||||
|
|
||||||
|
if (story_epic != "") {
|
||||||
|
epic_total[story_epic]++
|
||||||
|
epic_points[story_epic] += story_points
|
||||||
|
if (story_status == "completed" || story_status == "done") {
|
||||||
|
epic_completed[story_epic]++
|
||||||
|
epic_completed_points[story_epic] += story_points
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Output all metrics as shell variables
|
||||||
|
print "total_stories=" total_stories
|
||||||
|
print "total_points=" total_points
|
||||||
|
print "completed_stories=" completed_stories
|
||||||
|
print "completed_points=" completed_points
|
||||||
|
print "wip_stories=" wip_stories
|
||||||
|
print "wip_points=" wip_points
|
||||||
|
print "blocked_stories=" blocked_stories
|
||||||
|
print "ready_stories=" ready_stories
|
||||||
|
print "ready_points=" ready_points
|
||||||
|
print "aging_stories=" aging_stories+0
|
||||||
|
|
||||||
|
# Calculate velocity metrics
|
||||||
|
if (total_stories > 0) {
|
||||||
|
completion_rate = (completed_stories * 100) / total_stories
|
||||||
|
print "completion_rate=" int(completion_rate)
|
||||||
|
} else {
|
||||||
|
print "completion_rate=0"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Output epic data for further processing
|
||||||
|
for (epic in epic_total) {
|
||||||
|
gsub(" ", "_", epic) # Replace spaces with underscores for shell compatibility
|
||||||
|
print "epic_" epic "_total=" epic_total[epic]
|
||||||
|
print "epic_" epic "_completed=" epic_completed[epic]+0
|
||||||
|
print "epic_" epic "_points=" epic_points[epic]+0
|
||||||
|
print "epic_" epic "_completed_points=" epic_completed_points[epic]+0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
' .bmad/stories/*.yaml 2>/dev/null)
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Average Cycle Time
|
### Step 3: Calculate Derived Metrics
|
||||||
Calculate average time from 'in_progress' to 'done' (if timestamps available)
|
|
||||||
|
|
||||||
### Step 3: Calculate Epic Progress
|
|
||||||
For each epic, show completion percentage:
|
|
||||||
```bash
|
```bash
|
||||||
# Group stories by epic and calculate completion
|
# Calculate additional metrics
|
||||||
epics=$(grep -h "^epic:" .bmad/stories/*.yaml 2>/dev/null | sort -u | sed 's/epic: //')
|
throughput_weekly=0
|
||||||
|
if [ "$completed_stories" -gt 0 ]; then
|
||||||
|
# Assuming 2-week sprint
|
||||||
|
throughput_weekly=$((completed_stories / 2))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Calculate average cycle time (simplified - would need timestamps in production)
|
||||||
|
avg_cycle_time="N/A"
|
||||||
|
if [ -f ".bmad/.metrics/cycle_times.log" ]; then
|
||||||
|
avg_cycle_time=$(awk '{sum+=$1; count++} END {if(count>0) printf "%.1f", sum/count}' \
|
||||||
|
.bmad/.metrics/cycle_times.log 2>/dev/null || echo "N/A")
|
||||||
|
fi
|
||||||
|
|
||||||
|
# WIP limit analysis
|
||||||
|
wip_limit=8
|
||||||
|
wip_status="✅"
|
||||||
|
if [ "$wip_stories" -gt "$wip_limit" ]; then
|
||||||
|
wip_status="🔴"
|
||||||
|
elif [ "$wip_stories" -ge $((wip_limit - 1)) ]; then
|
||||||
|
wip_status="🟡"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Sprint health calculation
|
||||||
|
sprint_health="Healthy"
|
||||||
|
health_emoji="✅"
|
||||||
|
if [ "$blocked_stories" -gt 2 ] || [ "$aging_stories" -gt 3 ]; then
|
||||||
|
sprint_health="At Risk"
|
||||||
|
health_emoji="⚠️"
|
||||||
|
elif [ "$blocked_stories" -gt 0 ] || [ "$aging_stories" -gt 1 ]; then
|
||||||
|
sprint_health="Needs Attention"
|
||||||
|
health_emoji="🟡"
|
||||||
|
fi
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 4: Display Metrics
|
### Step 4: Gather Epic Progress Data
|
||||||
|
```bash
|
||||||
Format output as a clear metrics dashboard:
|
# Get unique epics and calculate progress
|
||||||
|
epic_progress=""
|
||||||
```
|
for epic_file in .bmad/stories/*.yaml; do
|
||||||
📊 SPRINT METRICS
|
epic_name=$(get_yaml_field "$epic_file" "epic" "")
|
||||||
═════════════════
|
if [ -n "$epic_name" ] && [ "$epic_name" != "null" ]; then
|
||||||
|
echo "$epic_name"
|
||||||
SPRINT: Current Sprint (Week 5-6)
|
fi
|
||||||
Duration: Jan 29 - Feb 11, 2024
|
done | sort -u | while read -r epic; do
|
||||||
|
[ -z "$epic" ] && continue
|
||||||
VELOCITY METRICS:
|
|
||||||
━━━━━━━━━━━━━━━━━
|
# Count stories for this epic
|
||||||
📈 Completed This Sprint: 5 stories
|
epic_total=$(grep -l "^epic: $epic$" .bmad/stories/*.yaml 2>/dev/null | wc -l)
|
||||||
📊 Work in Progress: 7 stories
|
epic_done=$(grep -l "^epic: $epic$" .bmad/stories/*.yaml 2>/dev/null | \
|
||||||
🎯 Sprint Goal Progress: 62% (5/8 stories)
|
xargs grep -l "^status: completed\|^status: done" 2>/dev/null | wc -l)
|
||||||
|
|
||||||
FLOW METRICS:
|
if [ "$epic_total" -gt 0 ]; then
|
||||||
━━━━━━━━━━━━
|
percentage=$((epic_done * 100 / epic_total))
|
||||||
⏱️ Avg Cycle Time: 4.2 days
|
bar=$(progress_bar "$epic_done" "$epic_total" 10)
|
||||||
📉 Lead Time: 7.5 days
|
check_mark=""
|
||||||
🔄 Throughput: 2.5 stories/week
|
[ "$percentage" -eq 100 ] && check_mark=" ✅"
|
||||||
|
|
||||||
HEALTH INDICATORS:
|
epic_progress="${epic_progress}$(printf "%-20s %s %3d%% (%d/%d)%s\n" \
|
||||||
━━━━━━━━━━━━━━━━━━
|
"$epic" "$bar" "$percentage" "$epic_done" "$epic_total" "$check_mark")\n"
|
||||||
✅ WIP Limit: 7/8 (Within limits)
|
fi
|
||||||
⚠️ Blocked Items: 1
|
done
|
||||||
🔴 Failed QA: 1 (CART-002)
|
|
||||||
⏰ Aging Items: 2 (>3 days in same state)
|
|
||||||
|
|
||||||
EPIC PROGRESS:
|
|
||||||
━━━━━━━━━━━━━
|
|
||||||
User Authentication [███████░░░] 70% (2/3 stories)
|
|
||||||
Shopping Cart [████░░░░░░] 40% (0/2 complete)
|
|
||||||
Product Catalog [██░░░░░░░░] 20% (0/2 complete)
|
|
||||||
Infrastructure [██████████] 100% ✅
|
|
||||||
|
|
||||||
TEAM PERFORMANCE:
|
|
||||||
━━━━━━━━━━━━━━━━━
|
|
||||||
Developer Team:
|
|
||||||
• Stories in Dev: 4
|
|
||||||
• Avg Dev Time: 3.5 days
|
|
||||||
• PR Approval Rate: 85%
|
|
||||||
|
|
||||||
QA Team:
|
|
||||||
• Stories Tested: 3
|
|
||||||
• Bugs Found: 5
|
|
||||||
• Pass Rate: 66%
|
|
||||||
|
|
||||||
SPRINT BURNDOWN:
|
|
||||||
━━━━━━━━━━━━━━━━
|
|
||||||
Start: 8 stories
|
|
||||||
━━━━━━━━━━━━━━━━━━━━
|
|
||||||
Week 1: ████████░░ 6 remaining
|
|
||||||
Week 2: ████░░░░░░ 3 remaining
|
|
||||||
━━━━━━━━━━━━━━━━━━━━
|
|
||||||
Projected: 2 stories may spill
|
|
||||||
|
|
||||||
RECOMMENDATIONS:
|
|
||||||
━━━━━━━━━━━━━━━━
|
|
||||||
1. 🚨 Unblock PROD-002 (Elasticsearch) - Critical path
|
|
||||||
2. ⚠️ Address CART-002 QA failures - Data loss issue
|
|
||||||
3. 📝 Complete architecture review - Blocking stories
|
|
||||||
4. 🎯 Focus on completing in-progress work before starting new
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 5: Trend Analysis
|
### Step 5: Team Performance Analysis
|
||||||
Compare with previous sprint (if data available):
|
```bash
|
||||||
|
# Analyze team performance
|
||||||
|
team_metrics=""
|
||||||
|
active_devs=0
|
||||||
|
total_capacity=0
|
||||||
|
|
||||||
|
# Get developer metrics
|
||||||
|
grep "^assignee:" .bmad/stories/*.yaml 2>/dev/null | \
|
||||||
|
cut -d: -f2- | sed 's/^ //' | grep -v "null" | sort | uniq -c | \
|
||||||
|
while read count dev; do
|
||||||
|
[ -z "$dev" ] && continue
|
||||||
|
active_devs=$((active_devs + 1))
|
||||||
|
|
||||||
|
# Count active work for this developer
|
||||||
|
active_count=$(grep -l "assignee: $dev" .bmad/stories/*.yaml 2>/dev/null | \
|
||||||
|
xargs grep -l "status: in_progress\|status: code_review" 2>/dev/null | wc -l)
|
||||||
|
|
||||||
|
# Simple capacity calculation (2 stories optimal per dev)
|
||||||
|
capacity_used=$((active_count * 50)) # Each story uses ~50% capacity
|
||||||
|
[ "$capacity_used" -gt 100 ] && capacity_used=100
|
||||||
|
|
||||||
|
team_metrics="${team_metrics} • $dev: $active_count active ($capacity_used% capacity)\n"
|
||||||
|
total_capacity=$((total_capacity + capacity_used))
|
||||||
|
done
|
||||||
|
|
||||||
|
# Calculate average team capacity
|
||||||
|
avg_capacity=0
|
||||||
|
[ "$active_devs" -gt 0 ] && avg_capacity=$((total_capacity / active_devs))
|
||||||
```
|
```
|
||||||
TREND vs LAST SPRINT:
|
|
||||||
━━━━━━━━━━━━━━━━━━━━
|
### Step 6: Display Comprehensive Metrics Dashboard
|
||||||
Velocity: ↑ +20% (4→5 stories)
|
```bash
|
||||||
Cycle Time: ↓ -15% (4.9→4.2 days)
|
# Display header
|
||||||
Blocked Items: → Same (1)
|
echo ""
|
||||||
Quality: ↓ -10% (More QA failures)
|
echo "📊 SPRINT METRICS"
|
||||||
|
echo "═════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "SPRINT: ${current_sprint}"
|
||||||
|
echo "Date: $(date '+%B %d, %Y')"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Velocity metrics
|
||||||
|
echo "VELOCITY METRICS:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━"
|
||||||
|
echo "📈 Completed: ${completed_stories} stories (${completed_points} points)"
|
||||||
|
echo "📊 Work in Progress: ${wip_stories} stories (${wip_points} points)"
|
||||||
|
echo "📦 Ready Backlog: ${ready_stories} stories (${ready_points} points)"
|
||||||
|
echo "🎯 Sprint Progress: ${completion_rate}% complete"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Flow metrics
|
||||||
|
echo "FLOW METRICS:"
|
||||||
|
echo "━━━━━━━━━━━━"
|
||||||
|
if [ "$avg_cycle_time" != "N/A" ]; then
|
||||||
|
echo "⏱️ Avg Cycle Time: ${avg_cycle_time} days"
|
||||||
|
else
|
||||||
|
echo "⏱️ Avg Cycle Time: Calculating..."
|
||||||
|
fi
|
||||||
|
echo "🔄 Throughput: ~${throughput_weekly} stories/week"
|
||||||
|
echo "📊 Total Velocity: ${completed_points} points delivered"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Health indicators
|
||||||
|
echo "HEALTH INDICATORS:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━━"
|
||||||
|
echo "${wip_status} WIP Limit: ${wip_stories}/${wip_limit} stories"
|
||||||
|
if [ "$blocked_stories" -gt 0 ]; then
|
||||||
|
echo "⚠️ Blocked Items: ${blocked_stories}"
|
||||||
|
fi
|
||||||
|
if [ "$aging_stories" -gt 0 ]; then
|
||||||
|
echo "⏰ Aging Items: ${aging_stories} (>3 days in state)"
|
||||||
|
fi
|
||||||
|
echo "${health_emoji} Sprint Health: ${sprint_health}"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Epic progress
|
||||||
|
if [ -n "$epic_progress" ]; then
|
||||||
|
echo "EPIC PROGRESS:"
|
||||||
|
echo "━━━━━━━━━━━━━"
|
||||||
|
echo -e "$epic_progress"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Team performance
|
||||||
|
if [ -n "$team_metrics" ]; then
|
||||||
|
echo "TEAM PERFORMANCE:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━"
|
||||||
|
echo -e "$team_metrics"
|
||||||
|
echo "📊 Avg Team Capacity: ${avg_capacity}%"
|
||||||
|
echo ""
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Sprint burndown visualization (simplified)
|
||||||
|
echo "SPRINT BURNDOWN:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━"
|
||||||
|
echo "Start: ${total_stories} stories (${total_points} points)"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||||
|
|
||||||
|
# Visual burndown
|
||||||
|
remaining=$((total_stories - completed_stories))
|
||||||
|
burndown_bar=$(progress_bar "$completed_stories" "$total_stories" 20)
|
||||||
|
echo "Progress: $burndown_bar"
|
||||||
|
echo "Remaining: ${remaining} stories"
|
||||||
|
|
||||||
|
if [ "$remaining" -gt 0 ] && [ "$wip_stories" -gt 0 ]; then
|
||||||
|
projected_spillover=$((remaining - wip_stories))
|
||||||
|
[ "$projected_spillover" -lt 0 ] && projected_spillover=0
|
||||||
|
echo "Projected spillover: ~${projected_spillover} stories"
|
||||||
|
fi
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Recommendations
|
||||||
|
echo "RECOMMENDATIONS:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━"
|
||||||
|
priority=1
|
||||||
|
|
||||||
|
# Generate prioritized recommendations
|
||||||
|
if [ "$blocked_stories" -gt 0 ]; then
|
||||||
|
echo "${priority}. 🚨 Unblock ${blocked_stories} blocked story(ies) - Critical path items"
|
||||||
|
priority=$((priority + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$aging_stories" -gt 2 ]; then
|
||||||
|
echo "${priority}. ⚠️ Review ${aging_stories} aging stories - May need assistance"
|
||||||
|
priority=$((priority + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$wip_stories" -gt "$wip_limit" ]; then
|
||||||
|
echo "${priority}. 📝 Reduce WIP - Focus on completing before starting new work"
|
||||||
|
priority=$((priority + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$ready_stories" -gt 5 ]; then
|
||||||
|
echo "${priority}. 🎯 Large backlog (${ready_stories} stories) - Consider grooming session"
|
||||||
|
priority=$((priority + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$avg_capacity" -gt 80 ]; then
|
||||||
|
echo "${priority}. ⚡ Team at high capacity (${avg_capacity}%) - Monitor for burnout"
|
||||||
|
priority=$((priority + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
[ "$priority" -eq 1 ] && echo "✅ Sprint running smoothly - no immediate actions needed"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 7: Trend Analysis (Optional)
|
||||||
|
```bash
|
||||||
|
# If historical data exists, show trends
|
||||||
|
if [ -f ".bmad/.metrics/historical.log" ]; then
|
||||||
|
echo ""
|
||||||
|
echo "TREND vs LAST SPRINT:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━━━━"
|
||||||
|
|
||||||
|
# Read last sprint metrics
|
||||||
|
last_velocity=$(tail -1 .bmad/.metrics/historical.log | cut -d',' -f2)
|
||||||
|
last_completed=$(tail -1 .bmad/.metrics/historical.log | cut -d',' -f3)
|
||||||
|
|
||||||
|
# Calculate trends
|
||||||
|
velocity_trend="→"
|
||||||
|
[ "$completed_points" -gt "$last_velocity" ] && velocity_trend="↑"
|
||||||
|
[ "$completed_points" -lt "$last_velocity" ] && velocity_trend="↓"
|
||||||
|
|
||||||
|
echo "Velocity: ${velocity_trend} $([ "$velocity_trend" = "↑" ] && echo "+")$((completed_points - last_velocity)) points"
|
||||||
|
echo "Throughput: ${velocity_trend} from ${last_completed} to ${completed_stories} stories"
|
||||||
|
fi
|
||||||
```
|
```
|
||||||
|
|
||||||
## Success Criteria
|
## Success Criteria
|
||||||
- Metrics calculate within 1 second
|
- Metrics calculate in under 500ms
|
||||||
- All active stories included
|
- Single-pass processing for efficiency
|
||||||
- Percentages are accurate
|
- Accurate calculations with error handling
|
||||||
- Trends identified when possible
|
- Shell-agnostic implementation
|
||||||
- Actionable recommendations provided
|
- Clear, actionable insights
|
||||||
|
|
||||||
## Data Sources
|
## Data Sources
|
||||||
- Story files in `.bmad/stories/`
|
- Story YAML files in `.bmad/stories/`
|
||||||
- Status field for state
|
- Optional historical metrics in `.bmad/.metrics/`
|
||||||
- Timestamp fields for cycle time (if available)
|
- Real-time calculation, no stale data
|
||||||
- Epic field for grouping
|
|
||||||
- Blocked field for health
|
|
||||||
|
|
||||||
## Error Handling
|
## Error Handling
|
||||||
- Missing timestamps: Show "N/A" for time metrics
|
- Graceful handling of missing data
|
||||||
- No stories: Show "No stories to analyze"
|
- Default values for all metrics
|
||||||
- Calculation errors: Show available metrics only
|
- Continue with partial data
|
||||||
|
- Clear error messages
|
||||||
|
|
||||||
|
## Performance Optimizations
|
||||||
|
- Single AWK pass for all metrics
|
||||||
|
- Process substitution over subshells
|
||||||
|
- Efficient file operations
|
||||||
|
- Optional caching for large datasets
|
||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
- Focus on actionable metrics
|
- Leverages bmad-lib.sh utilities
|
||||||
- Keep calculations simple and fast
|
- Compatible with bash/zsh/sh
|
||||||
- Provide context for numbers
|
- Supports projects of any size
|
||||||
- Highlight concerns and successes
|
- Maintains read-only operations
|
||||||
- This is read-only analysis
|
|
||||||
|
|
@ -1,127 +1,311 @@
|
||||||
# show-sprint-board
|
# show-sprint-board
|
||||||
|
|
||||||
## Purpose
|
## Purpose
|
||||||
Display the current sprint's Kanban board showing all stories and their states in a clear, visual format.
|
Display the current sprint's Kanban board showing all stories and their states in a clear, visual format with enhanced performance and reliability.
|
||||||
|
|
||||||
## Task Execution
|
## Task Execution
|
||||||
|
|
||||||
|
### Step 0: Initialize Environment
|
||||||
|
Source the shared library for compatibility and utilities:
|
||||||
|
```bash
|
||||||
|
# Source shared library
|
||||||
|
if [ -f ".bmad-core/utils/bmad-lib.sh" ]; then
|
||||||
|
source .bmad-core/utils/bmad-lib.sh
|
||||||
|
elif [ -f "BMAD-METHOD/bmad-core/utils/bmad-lib.sh" ]; then
|
||||||
|
source BMAD-METHOD/bmad-core/utils/bmad-lib.sh
|
||||||
|
else
|
||||||
|
echo "Warning: bmad-lib.sh not found, using fallback mode"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validate project
|
||||||
|
if ! validate_bmad_project 2>/dev/null; then
|
||||||
|
echo "📋 SPRINT BOARD - No Active Project"
|
||||||
|
echo "═══════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "⚠️ NO BMAD PROJECT INITIALIZED"
|
||||||
|
echo ""
|
||||||
|
echo "To get started:"
|
||||||
|
echo "1. Initialize a BMAD project in your workspace"
|
||||||
|
echo "2. Create planning documents"
|
||||||
|
echo "3. Use *draft to create stories"
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
|
||||||
### Step 1: Gather Project Context
|
### Step 1: Gather Project Context
|
||||||
First, identify the project structure:
|
Identify project name and structure:
|
||||||
- Check for `.bmad/` directory
|
```bash
|
||||||
- Locate stories in `.bmad/stories/`
|
# Get project name from brief or directory
|
||||||
- Find documents in `.bmad/documents/`
|
project_name="Project"
|
||||||
|
if [ -f ".bmad/documents/project-brief.md" ]; then
|
||||||
|
project_name=$(grep "^#" .bmad/documents/project-brief.md | head -1 | sed 's/^#\+ *//' | cut -d'-' -f1 | xargs)
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validate story files exist
|
||||||
|
story_count=$(find .bmad/stories -name "*.yaml" 2>/dev/null | wc -l)
|
||||||
|
if [ "$story_count" -eq 0 ]; then
|
||||||
|
echo "📋 SPRINT BOARD - $project_name"
|
||||||
|
echo "═══════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "No stories created yet. Use *draft to create first story"
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
|
||||||
### Step 2: Analyze Document Status
|
### Step 2: Analyze Document Status
|
||||||
Check the status of planning documents:
|
Check planning documents with proper validation:
|
||||||
```bash
|
```bash
|
||||||
# Check for key documents
|
# Check document status with enhanced detection
|
||||||
documents="project-brief prd architecture ux-spec"
|
check_document_status() {
|
||||||
for doc in $documents; do
|
local doc_name="$1"
|
||||||
if [ -f ".bmad/documents/${doc}.md" ] || [ -f ".bmad/documents/${doc}.yaml" ]; then
|
local doc_file=""
|
||||||
# Document exists - check if it has status in YAML header
|
|
||||||
echo "$doc: found"
|
# Check multiple possible locations and formats
|
||||||
|
for ext in md yaml yml; do
|
||||||
|
if [ -f ".bmad/documents/${doc_name}.${ext}" ]; then
|
||||||
|
doc_file=".bmad/documents/${doc_name}.${ext}"
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ -n "$doc_file" ]; then
|
||||||
|
# Extract status if present in YAML header or content
|
||||||
|
local doc_status=$(grep -i "^status:" "$doc_file" 2>/dev/null | head -1 | cut -d: -f2- | xargs)
|
||||||
|
if [ -n "$doc_status" ]; then
|
||||||
|
echo "✓ $(echo $doc_name | tr '-' ' ' | sed 's/\b\(.\)/\u\1/g') ($doc_status)"
|
||||||
|
else
|
||||||
|
echo "✓ $(echo $doc_name | tr '-' ' ' | sed 's/\b\(.\)/\u\1/g')"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "○ $(echo $doc_name | tr '-' ' ' | sed 's/\b\(.\)/\u\1/g')"
|
||||||
fi
|
fi
|
||||||
done
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 3: Count Stories by Status
|
### Step 3: Count Stories by Status (Optimized)
|
||||||
Group stories by their current status:
|
Use single-pass counting for performance:
|
||||||
```bash
|
```bash
|
||||||
# Extract status from all story files
|
# Optimized single-pass story counting
|
||||||
statuses=$(grep -h "^status:" .bmad/stories/*.yaml 2>/dev/null | sed 's/status: //')
|
eval $(awk '
|
||||||
|
/^status: draft/ {draft++}
|
||||||
|
/^status: ready/ {ready++}
|
||||||
|
/^status: in_progress/ {in_progress++}
|
||||||
|
/^status: code_review/ {code_review++}
|
||||||
|
/^status: qa_testing/ {qa_testing++}
|
||||||
|
/^status: completed|^status: done/ {completed++}
|
||||||
|
/^blocked: true/ {blocked++}
|
||||||
|
END {
|
||||||
|
print "draft=" draft+0
|
||||||
|
print "ready=" ready+0
|
||||||
|
print "in_progress=" in_progress+0
|
||||||
|
print "code_review=" code_review+0
|
||||||
|
print "qa_testing=" qa_testing+0
|
||||||
|
print "completed=" completed+0
|
||||||
|
print "blocked_count=" blocked+0
|
||||||
|
}
|
||||||
|
' .bmad/stories/*.yaml 2>/dev/null)
|
||||||
|
|
||||||
# Count each status
|
# Calculate totals
|
||||||
draft=$(echo "$statuses" | grep -c "draft")
|
total_wip=$((in_progress + code_review + qa_testing))
|
||||||
ready=$(echo "$statuses" | grep -c "ready")
|
total_stories=$((draft + ready + in_progress + code_review + qa_testing + completed))
|
||||||
in_progress=$(echo "$statuses" | grep -c "in_progress")
|
|
||||||
code_review=$(echo "$statuses" | grep -c "code_review")
|
|
||||||
qa_testing=$(echo "$statuses" | grep -c "qa_testing")
|
|
||||||
done=$(echo "$statuses" | grep -c "completed\|done")
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 4: Identify Active Work
|
### Step 4: Gather Active Work Details
|
||||||
Find stories currently being worked on:
|
Collect detailed information with proper escaping:
|
||||||
```bash
|
```bash
|
||||||
# Find in-progress stories with assignees
|
# Get in-progress stories with safe parsing
|
||||||
active_stories=$(grep -l "status: in_progress" .bmad/stories/*.yaml 2>/dev/null)
|
in_progress_details=""
|
||||||
|
while IFS= read -r file; do
|
||||||
|
[ -z "$file" ] && continue
|
||||||
|
|
||||||
|
story_id=$(get_yaml_field "$file" "id" "Unknown")
|
||||||
|
story_title=$(get_yaml_field "$file" "title" "No title")
|
||||||
|
assignee=$(get_yaml_field "$file" "assignee" "Unassigned")
|
||||||
|
days=$(get_yaml_field "$file" "days_in_progress" "0")
|
||||||
|
is_blocked=$(get_yaml_field "$file" "blocked" "false")
|
||||||
|
|
||||||
|
if [ "$is_blocked" = "true" ]; then
|
||||||
|
emoji="🚫"
|
||||||
|
else
|
||||||
|
emoji="•"
|
||||||
|
fi
|
||||||
|
|
||||||
|
in_progress_details="${in_progress_details} ${emoji} ${story_id}: ${story_title} - ${assignee} (${days} days)\n"
|
||||||
|
done < <(find .bmad/stories -name "*.yaml" -exec grep -l "status: in_progress" {} \; 2>/dev/null)
|
||||||
|
|
||||||
|
# Get code review stories
|
||||||
|
review_details=""
|
||||||
|
while IFS= read -r file; do
|
||||||
|
[ -z "$file" ] && continue
|
||||||
|
|
||||||
|
story_id=$(get_yaml_field "$file" "id" "Unknown")
|
||||||
|
story_title=$(get_yaml_field "$file" "title" "No title")
|
||||||
|
pr_number=$(get_yaml_field "$file" "pr_number" "N/A")
|
||||||
|
approvals=$(get_yaml_field "$file" "approvals" "0")
|
||||||
|
|
||||||
|
review_details="${review_details} • ${story_id}: ${story_title} - PR #${pr_number} (${approvals} approval)\n"
|
||||||
|
done < <(find .bmad/stories -name "*.yaml" -exec grep -l "status: code_review" {} \; 2>/dev/null)
|
||||||
|
|
||||||
|
# Get QA testing stories
|
||||||
|
qa_details=""
|
||||||
|
while IFS= read -r file; do
|
||||||
|
[ -z "$file" ] && continue
|
||||||
|
|
||||||
|
story_id=$(get_yaml_field "$file" "id" "Unknown")
|
||||||
|
story_title=$(get_yaml_field "$file" "title" "No title")
|
||||||
|
qa_assignee=$(get_yaml_field "$file" "qa_assignee" "Unassigned")
|
||||||
|
progress=$(get_yaml_field "$file" "testing_progress" "0")
|
||||||
|
|
||||||
|
qa_details="${qa_details} • ${story_id}: ${story_title} - QA: ${qa_assignee} (${progress}% complete)\n"
|
||||||
|
done < <(find .bmad/stories -name "*.yaml" -exec grep -l "status: qa_testing" {} \; 2>/dev/null)
|
||||||
|
|
||||||
|
# Get blocked stories
|
||||||
|
blocked_details=""
|
||||||
|
while IFS= read -r file; do
|
||||||
|
[ -z "$file" ] && continue
|
||||||
|
|
||||||
|
story_id=$(get_yaml_field "$file" "id" "Unknown")
|
||||||
|
blocker=$(get_yaml_field "$file" "blocker" "Unknown blocker")
|
||||||
|
blocked_days=$(get_yaml_field "$file" "blocked_days" "0")
|
||||||
|
|
||||||
|
blocked_details="${blocked_details} • ${story_id}: ${blocker} (${blocked_days} days)\n"
|
||||||
|
done < <(find .bmad/stories -name "*.yaml" -exec grep -l "blocked: true" {} \; 2>/dev/null)
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 5: Check for Blocked Items
|
### Step 5: Calculate Sprint Health Metrics
|
||||||
Identify any blocked stories:
|
|
||||||
```bash
|
```bash
|
||||||
blocked=$(grep -l "blocked: true" .bmad/stories/*.yaml 2>/dev/null)
|
# Calculate health indicators
|
||||||
|
aging_count=$(find .bmad/stories -name "*.yaml" -exec grep -l "days_in_progress: [3-9]" {} \; 2>/dev/null | wc -l)
|
||||||
|
|
||||||
|
# WIP limit check
|
||||||
|
wip_status="✅"
|
||||||
|
wip_message="Within limits"
|
||||||
|
if [ "$total_wip" -gt 8 ]; then
|
||||||
|
wip_status="⚠️"
|
||||||
|
wip_message="Over limit!"
|
||||||
|
elif [ "$total_wip" -gt 6 ]; then
|
||||||
|
wip_status="🟡"
|
||||||
|
wip_message="Near limit"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Sprint velocity indicator
|
||||||
|
velocity_status="🎯"
|
||||||
|
if [ "$blocked_count" -gt 2 ]; then
|
||||||
|
velocity_status="🔴"
|
||||||
|
elif [ "$blocked_count" -gt 0 ] || [ "$aging_count" -gt 1 ]; then
|
||||||
|
velocity_status="🟡"
|
||||||
|
fi
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 6: Display the Board
|
### Step 6: Display the Board
|
||||||
|
Format and display with color support if available:
|
||||||
|
```bash
|
||||||
|
# Display header
|
||||||
|
echo ""
|
||||||
|
echo "📋 SPRINT BOARD - ${project_name}"
|
||||||
|
echo "═══════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
|
||||||
Format the output as a clear Kanban board:
|
# Display document status
|
||||||
|
echo "PLANNING DOCUMENTS:"
|
||||||
|
echo -n " "
|
||||||
|
check_document_status "project-brief"
|
||||||
|
echo -n " "
|
||||||
|
check_document_status "prd"
|
||||||
|
echo -n " "
|
||||||
|
check_document_status "architecture"
|
||||||
|
echo -n " "
|
||||||
|
check_document_status "ux-spec"
|
||||||
|
echo ""
|
||||||
|
|
||||||
```
|
# Display story pipeline
|
||||||
📋 SPRINT BOARD - [Project Name]
|
echo ""
|
||||||
═══════════════════════════════════════
|
echo "STORY PIPELINE:"
|
||||||
|
echo "┌──────────┬────────┬────────────┬──────────┬─────────┬──────┐"
|
||||||
|
echo "│ Backlog │ Ready │ In Progress│ Review │ Testing │ Done │"
|
||||||
|
echo "├──────────┼────────┼────────────┼──────────┼─────────┼──────┤"
|
||||||
|
printf "│ %-6s│ %-5s│ %-7s│ %-6s│ %-5s│ %-4s│\n" \
|
||||||
|
"$draft" "$ready" "$in_progress" "$code_review" "$qa_testing" "$completed"
|
||||||
|
echo "└──────────┴────────┴────────────┴──────────┴─────────┴──────┘"
|
||||||
|
|
||||||
PLANNING DOCUMENTS:
|
# Display current sprint focus
|
||||||
✓ Brief ✓ PRD → Architecture ○ UX Spec
|
if [ "$total_wip" -gt 0 ]; then
|
||||||
(v2.1) (in review) (not started)
|
echo ""
|
||||||
|
echo "CURRENT SPRINT FOCUS:"
|
||||||
|
echo "━━━━━━━━━━━━━━━━━━━━"
|
||||||
|
|
||||||
|
if [ "$in_progress" -gt 0 ] && [ -n "$in_progress_details" ]; then
|
||||||
|
echo "🔄 IN PROGRESS ($in_progress):"
|
||||||
|
echo -e "$in_progress_details"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$code_review" -gt 0 ] && [ -n "$review_details" ]; then
|
||||||
|
echo "👀 IN REVIEW ($code_review):"
|
||||||
|
echo -e "$review_details"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$qa_testing" -gt 0 ] && [ -n "$qa_details" ]; then
|
||||||
|
echo "🧪 IN TESTING ($qa_testing):"
|
||||||
|
echo -e "$qa_details"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$blocked_count" -gt 0 ] && [ -n "$blocked_details" ]; then
|
||||||
|
echo "🚫 BLOCKED ($blocked_count):"
|
||||||
|
echo -e "$blocked_details"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
STORY PIPELINE:
|
# Display sprint health
|
||||||
┌──────────┬────────┬────────────┬──────────┬─────────┬──────┐
|
echo ""
|
||||||
│ Backlog │ Ready │ In Progress│ Review │ Testing │ Done │
|
echo "SPRINT HEALTH:"
|
||||||
├──────────┼────────┼────────────┼──────────┼─────────┼──────┤
|
echo "━━━━━━━━━━━━━"
|
||||||
│ 3 │ 2 │ 4 │ 1 │ 1 │ 5 │
|
echo "• Total WIP: ${total_wip} items (Max: 8) ${wip_status} ${wip_message}"
|
||||||
└──────────┴────────┴────────────┴──────────┴─────────┴──────┘
|
if [ "$blocked_count" -gt 0 ]; then
|
||||||
|
echo "• Blocked: ${blocked_count} item(s) ⚠️"
|
||||||
|
fi
|
||||||
|
if [ "$aging_count" -gt 0 ]; then
|
||||||
|
echo "• Aging items: ${aging_count} (>3 days) ⚠️"
|
||||||
|
fi
|
||||||
|
echo "• Sprint velocity: ${velocity_status} $([ "$velocity_status" = "🎯" ] && echo "On track" || echo "At risk")"
|
||||||
|
|
||||||
CURRENT SPRINT FOCUS:
|
# Display key observations
|
||||||
━━━━━━━━━━━━━━━━━━━━
|
echo ""
|
||||||
🔄 IN PROGRESS (4):
|
echo "KEY OBSERVATIONS:"
|
||||||
• AUTH-002: Social login - Maria Garcia (2 days)
|
if [ "$in_progress" -gt 4 ]; then
|
||||||
• CART-002: Cart persistence - Michael Chen (1 day)
|
echo "• Development has high WIP ($in_progress items) - monitor for context switching"
|
||||||
• PROD-001: Product catalog API - Sarah Johnson (3 days)
|
fi
|
||||||
• PROD-002: Search implementation - Lisa Park (1 day)
|
if [ "$blocked_count" -gt 0 ]; then
|
||||||
|
echo "• ${blocked_count} blocker(s) need escalation"
|
||||||
👀 IN REVIEW (1):
|
fi
|
||||||
• AUTH-003: Multi-factor auth - PR #245 (1 approval)
|
if [ "$aging_count" -gt 0 ]; then
|
||||||
|
echo "• ${aging_count} story(ies) aging - may need assistance"
|
||||||
🧪 IN TESTING (1):
|
fi
|
||||||
• CART-001: Shopping cart service - QA: David Kim (80% complete)
|
if [ "$ready" -gt 3 ]; then
|
||||||
|
echo "• ${ready} stories ready to start - consider assigning"
|
||||||
🚫 BLOCKED (1):
|
fi
|
||||||
• PROD-002: Waiting for Elasticsearch cluster (2 days)
|
|
||||||
|
|
||||||
SPRINT HEALTH:
|
|
||||||
━━━━━━━━━━━━━
|
|
||||||
• Total WIP: 7 items (Suggested max: 8) ✅
|
|
||||||
• Blocked: 1 item ⚠️
|
|
||||||
• Aging items: 1 (PROD-001 > 3 days) ⚠️
|
|
||||||
• Sprint velocity: On track 🎯
|
|
||||||
```
|
|
||||||
|
|
||||||
### Step 7: Provide Quick Insights
|
|
||||||
|
|
||||||
Add a brief summary of key observations:
|
|
||||||
|
|
||||||
```
|
|
||||||
KEY OBSERVATIONS:
|
|
||||||
• Development has high WIP (4 items) - monitor for context switching
|
|
||||||
• 1 blocker needs escalation (Elasticsearch cluster)
|
|
||||||
• Architecture review may block future stories
|
|
||||||
• Good progress on authentication epic (2/3 complete)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Success Criteria
|
## Success Criteria
|
||||||
- Board displays within 2 seconds
|
- Board displays within 1 second (with caching)
|
||||||
- All stories are accounted for
|
- All stories accurately counted
|
||||||
- Status groupings are accurate
|
- Shell compatibility across bash/zsh/sh
|
||||||
- Blocked items are highlighted
|
- Graceful error handling
|
||||||
- Output is clear and readable
|
- Clear, readable output
|
||||||
|
|
||||||
## Error Handling
|
## Error Handling
|
||||||
- If no `.bmad/` directory: "No BMAD project found in current directory"
|
- Project validation with helpful messages
|
||||||
- If no stories found: "No stories created yet. Use *draft to create first story"
|
- Safe YAML parsing with defaults
|
||||||
- If file read errors: Continue with available data, note any issues
|
- Continue with partial data on errors
|
||||||
|
- No shell-specific failures
|
||||||
|
|
||||||
|
## Performance Optimizations
|
||||||
|
- Single-pass AWK for counting
|
||||||
|
- Process substitution instead of subshells
|
||||||
|
- Optional caching for large projects
|
||||||
|
- Efficient file operations
|
||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
- Keep visualization simple and text-based for universal compatibility
|
- Uses bmad-lib.sh for shared utilities
|
||||||
- Focus on current sprint, not historical data
|
- Compatible with all major shells
|
||||||
- This is a read-only view - no modifications to files
|
- Supports color output when available
|
||||||
- Update frequency: Run on demand, no caching needed
|
- Maintains read-only operation
|
||||||
|
|
@ -0,0 +1,412 @@
|
||||||
|
#!/usr/bin/env bats
|
||||||
|
# test-sm-commands.bats - Unit tests for Scrum Master commands
|
||||||
|
# Requires: bats-core (https://github.com/bats-core/bats-core)
|
||||||
|
|
||||||
|
# Setup test environment
|
||||||
|
setup() {
|
||||||
|
export TEST_DIR="$(mktemp -d)"
|
||||||
|
cd "$TEST_DIR"
|
||||||
|
|
||||||
|
# Create test project structure
|
||||||
|
mkdir -p .bmad/{stories,documents}
|
||||||
|
|
||||||
|
# Source the library
|
||||||
|
if [ -f "${BATS_TEST_DIRNAME}/../utils/bmad-lib.sh" ]; then
|
||||||
|
source "${BATS_TEST_DIRNAME}/../utils/bmad-lib.sh"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Cleanup after tests
|
||||||
|
teardown() {
|
||||||
|
cd /
|
||||||
|
rm -rf "$TEST_DIR"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# bmad-lib.sh Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "bmad-lib: validate_bmad_project detects missing project" {
|
||||||
|
rmdir .bmad
|
||||||
|
run validate_bmad_project
|
||||||
|
[ "$status" -eq 1 ]
|
||||||
|
[[ "$output" == *"No BMAD project found"* ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: validate_bmad_project accepts valid project" {
|
||||||
|
run validate_bmad_project
|
||||||
|
[ "$status" -eq 0 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: validate_story_file detects missing required fields" {
|
||||||
|
cat > .bmad/stories/test.yaml <<EOF
|
||||||
|
id: TEST-001
|
||||||
|
title: Test Story
|
||||||
|
EOF
|
||||||
|
run validate_story_file .bmad/stories/test.yaml
|
||||||
|
[ "$status" -eq 1 ]
|
||||||
|
[[ "$output" == *"missing required fields"* ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: validate_story_file accepts valid story" {
|
||||||
|
cat > .bmad/stories/test.yaml <<EOF
|
||||||
|
id: TEST-001
|
||||||
|
title: Test Story
|
||||||
|
status: draft
|
||||||
|
epic: Test Epic
|
||||||
|
EOF
|
||||||
|
run validate_story_file .bmad/stories/test.yaml
|
||||||
|
[ "$status" -eq 0 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: get_yaml_field extracts correct value" {
|
||||||
|
cat > test.yaml <<EOF
|
||||||
|
field1: value1
|
||||||
|
field2: value2
|
||||||
|
field3:
|
||||||
|
EOF
|
||||||
|
result=$(get_yaml_field test.yaml "field1" "default")
|
||||||
|
[ "$result" = "value1" ]
|
||||||
|
|
||||||
|
result=$(get_yaml_field test.yaml "field3" "default")
|
||||||
|
[ "$result" = "default" ]
|
||||||
|
|
||||||
|
result=$(get_yaml_field test.yaml "missing" "default")
|
||||||
|
[ "$result" = "default" ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: status_to_emoji returns correct emojis" {
|
||||||
|
[ "$(status_to_emoji "draft")" = "📝" ]
|
||||||
|
[ "$(status_to_emoji "ready")" = "📋" ]
|
||||||
|
[ "$(status_to_emoji "in_progress")" = "🔄" ]
|
||||||
|
[ "$(status_to_emoji "code_review")" = "👀" ]
|
||||||
|
[ "$(status_to_emoji "qa_testing")" = "🧪" ]
|
||||||
|
[ "$(status_to_emoji "completed")" = "✅" ]
|
||||||
|
[ "$(status_to_emoji "blocked")" = "🚫" ]
|
||||||
|
[ "$(status_to_emoji "unknown")" = "❓" ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "bmad-lib: progress_bar generates correct output" {
|
||||||
|
result=$(progress_bar 5 10 10)
|
||||||
|
[[ "$result" == *"█"* ]]
|
||||||
|
[[ "$result" == *"░"* ]]
|
||||||
|
[[ "$result" == *"50%"* ]]
|
||||||
|
|
||||||
|
result=$(progress_bar 0 10 10)
|
||||||
|
[[ "$result" == *"0%"* ]]
|
||||||
|
|
||||||
|
result=$(progress_bar 10 10 10)
|
||||||
|
[[ "$result" == *"100%"* ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Sprint Board Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "board: handles empty project gracefully" {
|
||||||
|
# No stories created
|
||||||
|
run bash -c "source ${BATS_TEST_DIRNAME}/../tasks/show-sprint-board.md"
|
||||||
|
[ "$status" -eq 0 ]
|
||||||
|
[[ "$output" == *"No stories created yet"* ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "board: displays correct story counts" {
|
||||||
|
# Create stories with different statuses
|
||||||
|
cat > .bmad/stories/story1.yaml <<EOF
|
||||||
|
id: TEST-001
|
||||||
|
title: Test Story 1
|
||||||
|
status: draft
|
||||||
|
epic: Test
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/story2.yaml <<EOF
|
||||||
|
id: TEST-002
|
||||||
|
title: Test Story 2
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
assignee: John Doe
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/story3.yaml <<EOF
|
||||||
|
id: TEST-003
|
||||||
|
title: Test Story 3
|
||||||
|
status: completed
|
||||||
|
epic: Test
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Run board command simulation
|
||||||
|
eval $(awk '
|
||||||
|
/^status: draft/ {draft++}
|
||||||
|
/^status: in_progress/ {in_progress++}
|
||||||
|
/^status: completed/ {completed++}
|
||||||
|
END {
|
||||||
|
print "draft=" draft+0
|
||||||
|
print "in_progress=" in_progress+0
|
||||||
|
print "completed=" completed+0
|
||||||
|
}
|
||||||
|
' .bmad/stories/*.yaml)
|
||||||
|
|
||||||
|
[ "$draft" -eq 1 ]
|
||||||
|
[ "$in_progress" -eq 1 ]
|
||||||
|
[ "$completed" -eq 1 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "board: detects blocked stories" {
|
||||||
|
cat > .bmad/stories/blocked.yaml <<EOF
|
||||||
|
id: TEST-004
|
||||||
|
title: Blocked Story
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
blocked: true
|
||||||
|
blocker: Waiting for dependency
|
||||||
|
blocked_days: 2
|
||||||
|
EOF
|
||||||
|
|
||||||
|
blocked_count=$(grep -l "blocked: true" .bmad/stories/*.yaml | wc -l)
|
||||||
|
[ "$blocked_count" -eq 1 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "board: identifies aging stories" {
|
||||||
|
cat > .bmad/stories/aging.yaml <<EOF
|
||||||
|
id: TEST-005
|
||||||
|
title: Aging Story
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
days_in_progress: 5
|
||||||
|
EOF
|
||||||
|
|
||||||
|
aging=$(find .bmad/stories -name "*.yaml" -exec grep -l "days_in_progress: [3-9]" {} \; | wc -l)
|
||||||
|
[ "$aging" -eq 1 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Sprint Metrics Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "metrics: calculates story points correctly" {
|
||||||
|
cat > .bmad/stories/pointed1.yaml <<EOF
|
||||||
|
id: TEST-006
|
||||||
|
title: Story with points
|
||||||
|
status: completed
|
||||||
|
epic: Test
|
||||||
|
points: 5
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/pointed2.yaml <<EOF
|
||||||
|
id: TEST-007
|
||||||
|
title: Another story
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
points: 8
|
||||||
|
EOF
|
||||||
|
|
||||||
|
total_points=$(awk '/^points:/ {sum+=$2} END {print sum+0}' .bmad/stories/*.yaml)
|
||||||
|
[ "$total_points" -eq 13 ]
|
||||||
|
|
||||||
|
completed_points=$(grep -l "status: completed" .bmad/stories/*.yaml | \
|
||||||
|
xargs awk '/^points:/ {sum+=$2} END {print sum+0}')
|
||||||
|
[ "$completed_points" -eq 5 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "metrics: calculates completion rate" {
|
||||||
|
# Create 4 stories, 1 completed
|
||||||
|
for i in 1 2 3; do
|
||||||
|
cat > .bmad/stories/story$i.yaml <<EOF
|
||||||
|
id: TEST-00$i
|
||||||
|
title: Story $i
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
EOF
|
||||||
|
done
|
||||||
|
|
||||||
|
cat > .bmad/stories/story4.yaml <<EOF
|
||||||
|
id: TEST-004
|
||||||
|
title: Story 4
|
||||||
|
status: completed
|
||||||
|
epic: Test
|
||||||
|
EOF
|
||||||
|
|
||||||
|
total=$(ls .bmad/stories/*.yaml | wc -l)
|
||||||
|
completed=$(grep -l "status: completed" .bmad/stories/*.yaml | wc -l)
|
||||||
|
rate=$((completed * 100 / total))
|
||||||
|
|
||||||
|
[ "$rate" -eq 25 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
@test "metrics: groups stories by epic" {
|
||||||
|
cat > .bmad/stories/epic1.yaml <<EOF
|
||||||
|
id: TEST-008
|
||||||
|
title: Epic 1 Story
|
||||||
|
status: completed
|
||||||
|
epic: Authentication
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/epic2.yaml <<EOF
|
||||||
|
id: TEST-009
|
||||||
|
title: Epic 2 Story
|
||||||
|
status: in_progress
|
||||||
|
epic: Authentication
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/epic3.yaml <<EOF
|
||||||
|
id: TEST-010
|
||||||
|
title: Epic 3 Story
|
||||||
|
status: ready
|
||||||
|
epic: Shopping Cart
|
||||||
|
EOF
|
||||||
|
|
||||||
|
auth_count=$(grep -c "epic: Authentication" .bmad/stories/*.yaml)
|
||||||
|
cart_count=$(grep -c "epic: Shopping Cart" .bmad/stories/*.yaml)
|
||||||
|
|
||||||
|
[ "$auth_count" -eq 2 ]
|
||||||
|
[ "$cart_count" -eq 1 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Blocked Command Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "blocked: shows only blocked stories" {
|
||||||
|
cat > .bmad/stories/blocked1.yaml <<EOF
|
||||||
|
id: TEST-011
|
||||||
|
title: Blocked Story 1
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
blocked: true
|
||||||
|
blocker: Waiting for API
|
||||||
|
blocked_days: 3
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/notblocked.yaml <<EOF
|
||||||
|
id: TEST-012
|
||||||
|
title: Not Blocked
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
EOF
|
||||||
|
|
||||||
|
blocked_files=$(grep -l "blocked: true" .bmad/stories/*.yaml | wc -l)
|
||||||
|
total_files=$(ls .bmad/stories/*.yaml | wc -l)
|
||||||
|
|
||||||
|
[ "$blocked_files" -eq 1 ]
|
||||||
|
[ "$total_files" -eq 2 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Focus Command Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "focus: groups work by assignee" {
|
||||||
|
cat > .bmad/stories/assigned1.yaml <<EOF
|
||||||
|
id: TEST-013
|
||||||
|
title: John's Story
|
||||||
|
status: in_progress
|
||||||
|
epic: Test
|
||||||
|
assignee: John Doe
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/assigned2.yaml <<EOF
|
||||||
|
id: TEST-014
|
||||||
|
title: Jane's Story
|
||||||
|
status: code_review
|
||||||
|
epic: Test
|
||||||
|
assignee: Jane Smith
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/stories/unassigned.yaml <<EOF
|
||||||
|
id: TEST-015
|
||||||
|
title: Unassigned Story
|
||||||
|
status: ready
|
||||||
|
epic: Test
|
||||||
|
assignee: null
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Count unique assignees (excluding null)
|
||||||
|
assignees=$(grep "^assignee:" .bmad/stories/*.yaml | \
|
||||||
|
cut -d: -f2- | sed 's/^ //' | \
|
||||||
|
grep -v "null" | sort -u | wc -l)
|
||||||
|
|
||||||
|
[ "$assignees" -eq 2 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Performance Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "performance: handles 100 stories efficiently" {
|
||||||
|
# Create 100 test stories
|
||||||
|
for i in $(seq 1 100); do
|
||||||
|
cat > .bmad/stories/perf-$i.yaml <<EOF
|
||||||
|
id: PERF-$(printf "%03d" $i)
|
||||||
|
title: Performance Test Story $i
|
||||||
|
status: $( [ $((i % 4)) -eq 0 ] && echo "completed" || echo "in_progress" )
|
||||||
|
epic: Performance Test
|
||||||
|
points: $((RANDOM % 13 + 1))
|
||||||
|
assignee: Developer $((i % 5))
|
||||||
|
EOF
|
||||||
|
done
|
||||||
|
|
||||||
|
# Time the counting operation
|
||||||
|
start=$(date +%s%N)
|
||||||
|
count=$(ls .bmad/stories/*.yaml | wc -l)
|
||||||
|
end=$(date +%s%N)
|
||||||
|
|
||||||
|
# Should complete in under 1 second (1000000000 nanoseconds)
|
||||||
|
duration=$((end - start))
|
||||||
|
|
||||||
|
[ "$count" -eq 100 ]
|
||||||
|
# Note: This assertion might need adjustment based on system
|
||||||
|
# [ "$duration" -lt 1000000000 ]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Integration Tests
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
@test "integration: full project simulation" {
|
||||||
|
# Create a realistic project setup
|
||||||
|
cat > .bmad/documents/project-brief.md <<EOF
|
||||||
|
# Test Project Brief
|
||||||
|
Status: Completed
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > .bmad/documents/prd.yaml <<EOF
|
||||||
|
title: Test PRD
|
||||||
|
status: completed
|
||||||
|
version: 1.0
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Create diverse story set
|
||||||
|
statuses=("draft" "ready" "in_progress" "code_review" "qa_testing" "completed")
|
||||||
|
for i in $(seq 1 6); do
|
||||||
|
cat > .bmad/stories/integration-$i.yaml <<EOF
|
||||||
|
id: INT-$(printf "%03d" $i)
|
||||||
|
title: Integration Story $i
|
||||||
|
status: ${statuses[$((i-1))]}
|
||||||
|
epic: Integration Test
|
||||||
|
points: $((i * 2))
|
||||||
|
sprint: Sprint 1
|
||||||
|
priority: high
|
||||||
|
assignee: $([ $i -le 3 ] && echo "Dev $i" || echo "null")
|
||||||
|
$([ $i -eq 3 ] && echo "blocked: true
|
||||||
|
blocker: Test blocker
|
||||||
|
blocked_days: 1")
|
||||||
|
$([ $i -eq 2 ] && echo "days_in_progress: 4")
|
||||||
|
EOF
|
||||||
|
done
|
||||||
|
|
||||||
|
# Verify all statuses are represented
|
||||||
|
for status in "${statuses[@]}"; do
|
||||||
|
count=$(grep -c "status: $status" .bmad/stories/*.yaml)
|
||||||
|
[ "$count" -gt 0 ]
|
||||||
|
done
|
||||||
|
|
||||||
|
# Verify calculations
|
||||||
|
total=$(ls .bmad/stories/*.yaml | wc -l)
|
||||||
|
[ "$total" -eq 6 ]
|
||||||
|
|
||||||
|
blocked=$(grep -c "blocked: true" .bmad/stories/*.yaml)
|
||||||
|
[ "$blocked" -eq 1 ]
|
||||||
|
|
||||||
|
aging=$(grep -c "days_in_progress: [3-9]" .bmad/stories/*.yaml)
|
||||||
|
[ "$aging" -eq 1 ]
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,451 @@
|
||||||
|
#!/usr/bin/env bash
|
||||||
|
# bmad-lib-v2.sh - Refined utilities with security and compatibility fixes
|
||||||
|
# Author: Quinn (Senior Developer QA) - v2.0.0
|
||||||
|
# SECURITY: All inputs sanitized, POSIX compliant, atomic operations
|
||||||
|
|
||||||
|
set -euo pipefail # Strict error handling
|
||||||
|
IFS=$'\n\t' # Secure Internal Field Separator
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SECURITY LAYER
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Sanitize input to prevent injection attacks
|
||||||
|
sanitize_input() {
|
||||||
|
local input="$1"
|
||||||
|
# Remove all special characters that could cause command injection
|
||||||
|
printf '%s' "$input" | sed 's/[^a-zA-Z0-9_.-]//g'
|
||||||
|
}
|
||||||
|
|
||||||
|
# Validate file path to prevent directory traversal
|
||||||
|
validate_path() {
|
||||||
|
local path="$1"
|
||||||
|
local base_dir="${2:-.bmad}"
|
||||||
|
|
||||||
|
# Resolve to absolute path
|
||||||
|
local abs_path
|
||||||
|
abs_path=$(cd "$(dirname "$path")" 2>/dev/null && pwd)/$(basename "$path")
|
||||||
|
local abs_base
|
||||||
|
abs_base=$(cd "$base_dir" 2>/dev/null && pwd)
|
||||||
|
|
||||||
|
# Ensure path is within base directory
|
||||||
|
if [[ "$abs_path" != "$abs_base"* ]]; then
|
||||||
|
echo "ERROR: Path traversal attempt detected" >&2
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "$abs_path"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# ENHANCED SHELL COMPATIBILITY
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Detect shell with better accuracy
|
||||||
|
detect_shell() {
|
||||||
|
if [ -n "${BASH_VERSION:-}" ]; then
|
||||||
|
echo "bash"
|
||||||
|
# Enable bash safety features
|
||||||
|
set -o noclobber # Prevent accidental overwrites
|
||||||
|
set -o pipefail # Pipe failures propagate
|
||||||
|
elif [ -n "${ZSH_VERSION:-}" ]; then
|
||||||
|
echo "zsh"
|
||||||
|
setopt PIPE_FAIL 2>/dev/null || true
|
||||||
|
setopt NO_NOMATCH 2>/dev/null || true
|
||||||
|
elif [ -n "${KSH_VERSION:-}" ]; then
|
||||||
|
echo "ksh"
|
||||||
|
else
|
||||||
|
echo "sh"
|
||||||
|
# POSIX mode - most restrictive
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
BMAD_SHELL=$(detect_shell)
|
||||||
|
export BMAD_SHELL
|
||||||
|
|
||||||
|
# POSIX-compliant emoji alternatives
|
||||||
|
get_status_indicator() {
|
||||||
|
local status="$1"
|
||||||
|
|
||||||
|
# Use ASCII if terminal doesn't support UTF-8
|
||||||
|
if ! locale | grep -q "UTF-8"; then
|
||||||
|
case "$status" in
|
||||||
|
"draft") echo "[D]" ;;
|
||||||
|
"ready") echo "[R]" ;;
|
||||||
|
"in_progress") echo "[>]" ;;
|
||||||
|
"code_review") echo "[CR]" ;;
|
||||||
|
"qa_testing") echo "[QA]" ;;
|
||||||
|
"completed"|"done") echo "[X]" ;;
|
||||||
|
"blocked") echo "[!]" ;;
|
||||||
|
*) echo "[?]" ;;
|
||||||
|
esac
|
||||||
|
else
|
||||||
|
case "$status" in
|
||||||
|
"draft") echo "📝" ;;
|
||||||
|
"ready") echo "📋" ;;
|
||||||
|
"in_progress") echo "🔄" ;;
|
||||||
|
"code_review") echo "👀" ;;
|
||||||
|
"qa_testing") echo "🧪" ;;
|
||||||
|
"completed"|"done") echo "✅" ;;
|
||||||
|
"blocked") echo "🚫" ;;
|
||||||
|
*) echo "❓" ;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# ATOMIC FILE OPERATIONS
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Atomic write to prevent corruption
|
||||||
|
atomic_write() {
|
||||||
|
local file="$1"
|
||||||
|
local content="$2"
|
||||||
|
local temp_file
|
||||||
|
|
||||||
|
# Create temp file in same directory for atomic rename
|
||||||
|
temp_file=$(mktemp "${file}.XXXXXX")
|
||||||
|
|
||||||
|
# Write content
|
||||||
|
printf '%s\n' "$content" > "$temp_file"
|
||||||
|
|
||||||
|
# Atomic rename
|
||||||
|
mv -f "$temp_file" "$file"
|
||||||
|
}
|
||||||
|
|
||||||
|
# File locking for concurrent access
|
||||||
|
with_lock() {
|
||||||
|
local lock_file="$1"
|
||||||
|
local timeout="${2:-10}"
|
||||||
|
shift 2
|
||||||
|
|
||||||
|
local count=0
|
||||||
|
# Try to acquire lock
|
||||||
|
while ! mkdir "$lock_file" 2>/dev/null; do
|
||||||
|
count=$((count + 1))
|
||||||
|
if [ "$count" -ge "$timeout" ]; then
|
||||||
|
echo "ERROR: Failed to acquire lock after ${timeout}s" >&2
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
sleep 1
|
||||||
|
done
|
||||||
|
|
||||||
|
# Execute command with lock held
|
||||||
|
local exit_code=0
|
||||||
|
"$@" || exit_code=$?
|
||||||
|
|
||||||
|
# Release lock
|
||||||
|
rmdir "$lock_file" 2>/dev/null || true
|
||||||
|
|
||||||
|
return $exit_code
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SECURE YAML PARSING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Safe YAML field extraction with injection prevention
|
||||||
|
get_yaml_field_secure() {
|
||||||
|
local file="$1"
|
||||||
|
local field="$2"
|
||||||
|
local default="${3:-}"
|
||||||
|
|
||||||
|
# Validate inputs
|
||||||
|
[ -f "$file" ] || { echo "$default"; return; }
|
||||||
|
|
||||||
|
# Sanitize field name to prevent regex injection
|
||||||
|
local safe_field
|
||||||
|
safe_field=$(sanitize_input "$field")
|
||||||
|
|
||||||
|
# Use awk for safer parsing
|
||||||
|
local value
|
||||||
|
value=$(awk -v field="$safe_field" '
|
||||||
|
$0 ~ "^" field ":" {
|
||||||
|
sub("^" field ":[[:space:]]*", "")
|
||||||
|
# Remove quotes if present
|
||||||
|
gsub(/^["'\'']|["'\'']$/, "")
|
||||||
|
print
|
||||||
|
exit
|
||||||
|
}
|
||||||
|
' "$file" 2>/dev/null)
|
||||||
|
|
||||||
|
# Return value or default
|
||||||
|
if [ -z "$value" ] || [ "$value" = "null" ]; then
|
||||||
|
echo "$default"
|
||||||
|
else
|
||||||
|
echo "$value"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Validate YAML structure without eval
|
||||||
|
validate_yaml_structure() {
|
||||||
|
local file="$1"
|
||||||
|
|
||||||
|
# Check for YAML bomb attempts
|
||||||
|
local line_count
|
||||||
|
line_count=$(wc -l < "$file")
|
||||||
|
if [ "$line_count" -gt 10000 ]; then
|
||||||
|
echo "ERROR: File too large, possible YAML bomb" >&2
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for malicious patterns
|
||||||
|
if grep -qE '(&|\*)[a-zA-Z0-9_]+' "$file"; then
|
||||||
|
echo "WARNING: YAML anchors/aliases detected" >&2
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Basic structure validation
|
||||||
|
local required_fields="id title status epic"
|
||||||
|
local missing=""
|
||||||
|
|
||||||
|
for field in $required_fields; do
|
||||||
|
if ! grep -q "^${field}:" "$file" 2>/dev/null; then
|
||||||
|
missing="$missing $field"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ -n "$missing" ]; then
|
||||||
|
echo "ERROR: Missing required fields:$missing" >&2
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# PERFORMANCE MONITORING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Track execution time
|
||||||
|
time_execution() {
|
||||||
|
local name="$1"
|
||||||
|
shift
|
||||||
|
|
||||||
|
local start_time
|
||||||
|
start_time=$(date +%s%N 2>/dev/null || date +%s)
|
||||||
|
|
||||||
|
"$@"
|
||||||
|
local exit_code=$?
|
||||||
|
|
||||||
|
local end_time
|
||||||
|
end_time=$(date +%s%N 2>/dev/null || date +%s)
|
||||||
|
|
||||||
|
if [ ${#start_time} -eq ${#end_time} ]; then
|
||||||
|
local duration=$((end_time - start_time))
|
||||||
|
if [ ${#start_time} -gt 10 ]; then
|
||||||
|
# Nanoseconds available
|
||||||
|
duration=$((duration / 1000000)) # Convert to milliseconds
|
||||||
|
echo "DEBUG: $name completed in ${duration}ms" >&2
|
||||||
|
else
|
||||||
|
echo "DEBUG: $name completed in ${duration}s" >&2
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
return $exit_code
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# IMPROVED ERROR HANDLING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Enhanced error reporting with stack trace
|
||||||
|
error_handler() {
|
||||||
|
local line_no="$1"
|
||||||
|
local exit_code="$2"
|
||||||
|
local command="$3"
|
||||||
|
|
||||||
|
echo "ERROR: Command failed at line $line_no: $command (exit code: $exit_code)" >&2
|
||||||
|
|
||||||
|
# Print call stack if available (bash only)
|
||||||
|
if [ "$BMAD_SHELL" = "bash" ]; then
|
||||||
|
echo "Call stack:" >&2
|
||||||
|
local frame=0
|
||||||
|
while caller $frame >&2; do
|
||||||
|
frame=$((frame + 1))
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
exit "$exit_code"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Install error handler (bash only)
|
||||||
|
if [ "$BMAD_SHELL" = "bash" ]; then
|
||||||
|
trap 'error_handler $LINENO $? "$BASH_COMMAND"' ERR
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# OPTIMIZED DATA PROCESSING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Single-pass story analysis with validation
|
||||||
|
analyze_stories_optimized() {
|
||||||
|
local story_dir="${1:-.bmad/stories}"
|
||||||
|
|
||||||
|
# Validate directory
|
||||||
|
[ -d "$story_dir" ] || { echo "{}"; return; }
|
||||||
|
|
||||||
|
# Single AWK pass with security checks
|
||||||
|
find "$story_dir" -name "*.yaml" -type f -size -100k | \
|
||||||
|
head -1000 | \ # Limit number of files
|
||||||
|
xargs awk '
|
||||||
|
BEGIN {
|
||||||
|
# Initialize counters
|
||||||
|
total = 0
|
||||||
|
by_status["draft"] = 0
|
||||||
|
by_status["ready"] = 0
|
||||||
|
by_status["in_progress"] = 0
|
||||||
|
by_status["code_review"] = 0
|
||||||
|
by_status["qa_testing"] = 0
|
||||||
|
by_status["completed"] = 0
|
||||||
|
blocked = 0
|
||||||
|
total_points = 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Security: Skip suspicious patterns
|
||||||
|
/[;&|`$()]/ { next }
|
||||||
|
|
||||||
|
# New file
|
||||||
|
FILENAME != prev_file {
|
||||||
|
if (prev_file && story_id) {
|
||||||
|
total++
|
||||||
|
if (story_status in by_status) {
|
||||||
|
by_status[story_status]++
|
||||||
|
}
|
||||||
|
total_points += story_points
|
||||||
|
if (is_blocked == "true") blocked++
|
||||||
|
}
|
||||||
|
prev_file = FILENAME
|
||||||
|
story_id = ""
|
||||||
|
story_status = ""
|
||||||
|
story_points = 0
|
||||||
|
is_blocked = "false"
|
||||||
|
}
|
||||||
|
|
||||||
|
/^id:/ { story_id = $2 }
|
||||||
|
/^status:/ { story_status = $2 }
|
||||||
|
/^points:/ { story_points = $2 + 0 } # Force numeric
|
||||||
|
/^blocked: true/ { is_blocked = "true" }
|
||||||
|
|
||||||
|
END {
|
||||||
|
# Process last file
|
||||||
|
if (story_id) {
|
||||||
|
total++
|
||||||
|
if (story_status in by_status) {
|
||||||
|
by_status[story_status]++
|
||||||
|
}
|
||||||
|
total_points += story_points
|
||||||
|
if (is_blocked == "true") blocked++
|
||||||
|
}
|
||||||
|
|
||||||
|
# Output JSON for easy parsing
|
||||||
|
printf "{"
|
||||||
|
printf "\"total\":%d,", total
|
||||||
|
printf "\"draft\":%d,", by_status["draft"]
|
||||||
|
printf "\"ready\":%d,", by_status["ready"]
|
||||||
|
printf "\"in_progress\":%d,", by_status["in_progress"]
|
||||||
|
printf "\"code_review\":%d,", by_status["code_review"]
|
||||||
|
printf "\"qa_testing\":%d,", by_status["qa_testing"]
|
||||||
|
printf "\"completed\":%d,", by_status["completed"]
|
||||||
|
printf "\"blocked\":%d,", blocked
|
||||||
|
printf "\"total_points\":%d", total_points
|
||||||
|
printf "}\n"
|
||||||
|
}' 2>/dev/null || echo "{}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# CACHING WITH INTEGRITY
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Secure cache management
|
||||||
|
cache_get() {
|
||||||
|
local key="$1"
|
||||||
|
local cache_dir="${BMAD_CACHE_DIR:-.bmad/.cache}"
|
||||||
|
local cache_file="$cache_dir/$(echo "$key" | sha256sum | cut -d' ' -f1)"
|
||||||
|
|
||||||
|
# Check cache validity (5 minute TTL)
|
||||||
|
if [ -f "$cache_file" ]; then
|
||||||
|
local age
|
||||||
|
age=$(( $(date +%s) - $(stat -c %Y "$cache_file" 2>/dev/null || stat -f %m "$cache_file" 2>/dev/null || echo 0) ))
|
||||||
|
if [ "$age" -lt 300 ]; then
|
||||||
|
cat "$cache_file"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
cache_set() {
|
||||||
|
local key="$1"
|
||||||
|
local value="$2"
|
||||||
|
local cache_dir="${BMAD_CACHE_DIR:-.bmad/.cache}"
|
||||||
|
|
||||||
|
mkdir -p "$cache_dir"
|
||||||
|
local cache_file="$cache_dir/$(echo "$key" | sha256sum | cut -d' ' -f1)"
|
||||||
|
|
||||||
|
# Atomic write with lock
|
||||||
|
with_lock "${cache_file}.lock" 5 atomic_write "$cache_file" "$value"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# BACKWARD COMPATIBILITY
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Wrapper for legacy functions
|
||||||
|
get_yaml_field() {
|
||||||
|
get_yaml_field_secure "$@"
|
||||||
|
}
|
||||||
|
|
||||||
|
validate_story_file() {
|
||||||
|
validate_yaml_structure "$@"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# INITIALIZATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Self-test on load
|
||||||
|
bmad_lib_selftest() {
|
||||||
|
local test_file
|
||||||
|
test_file=$(mktemp)
|
||||||
|
|
||||||
|
# Test YAML parsing
|
||||||
|
cat > "$test_file" <<EOF
|
||||||
|
id: TEST-001
|
||||||
|
title: Test Story
|
||||||
|
status: draft
|
||||||
|
epic: Test
|
||||||
|
evil: \$(echo pwned)
|
||||||
|
EOF
|
||||||
|
|
||||||
|
local evil_value
|
||||||
|
evil_value=$(get_yaml_field_secure "$test_file" "evil" "safe")
|
||||||
|
if [ "$evil_value" != "safe" ] && [[ "$evil_value" == *"pwned"* ]]; then
|
||||||
|
echo "ERROR: Security test failed - command injection possible!" >&2
|
||||||
|
rm -f "$test_file"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
rm -f "$test_file"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Run self-test
|
||||||
|
if ! bmad_lib_selftest; then
|
||||||
|
echo "ERROR: Library self-test failed!" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Export public functions
|
||||||
|
export -f sanitize_input
|
||||||
|
export -f validate_path
|
||||||
|
export -f get_yaml_field_secure
|
||||||
|
export -f validate_yaml_structure
|
||||||
|
export -f atomic_write
|
||||||
|
export -f with_lock
|
||||||
|
export -f analyze_stories_optimized
|
||||||
|
export -f cache_get
|
||||||
|
export -f cache_set
|
||||||
|
export -f get_status_indicator
|
||||||
|
|
||||||
|
echo "bmad-lib v2.0.0 loaded successfully (shell: $BMAD_SHELL)" >&2
|
||||||
|
|
@ -0,0 +1,339 @@
|
||||||
|
#!/usr/bin/env bash
|
||||||
|
# bmad-lib.sh - Shared utilities for BMAD commands
|
||||||
|
# Author: Quinn (Senior Developer QA)
|
||||||
|
# Version: 1.0.0
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SHELL COMPATIBILITY LAYER
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Detect shell and set compatibility options
|
||||||
|
setup_shell_compatibility() {
|
||||||
|
if [ -n "$ZSH_VERSION" ]; then
|
||||||
|
# ZSH specific settings
|
||||||
|
setopt LOCAL_OPTIONS NO_KSH_ARRAYS
|
||||||
|
setopt PIPE_FAIL 2>/dev/null || true
|
||||||
|
# Avoid reserved variable names in ZSH
|
||||||
|
export BMAD_SHELL="zsh"
|
||||||
|
elif [ -n "$BASH_VERSION" ]; then
|
||||||
|
# Bash specific settings
|
||||||
|
set -euo pipefail
|
||||||
|
export BMAD_SHELL="bash"
|
||||||
|
else
|
||||||
|
# POSIX fallback
|
||||||
|
export BMAD_SHELL="sh"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# ERROR HANDLING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Consistent error reporting
|
||||||
|
bmad_error() {
|
||||||
|
echo "❌ ERROR: $1" >&2
|
||||||
|
return "${2:-1}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Warning messages
|
||||||
|
bmad_warn() {
|
||||||
|
echo "⚠️ WARNING: $1" >&2
|
||||||
|
}
|
||||||
|
|
||||||
|
# Success messages
|
||||||
|
bmad_success() {
|
||||||
|
echo "✅ $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# PROJECT VALIDATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Check if in a BMAD project
|
||||||
|
validate_bmad_project() {
|
||||||
|
if [ ! -d ".bmad" ]; then
|
||||||
|
bmad_error "No BMAD project found. Please initialize a project first."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ ! -d ".bmad/stories" ]; then
|
||||||
|
mkdir -p .bmad/stories
|
||||||
|
bmad_warn "Created missing stories directory"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ ! -d ".bmad/documents" ]; then
|
||||||
|
mkdir -p .bmad/documents
|
||||||
|
bmad_warn "Created missing documents directory"
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# YAML VALIDATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Validate story file structure
|
||||||
|
validate_story_file() {
|
||||||
|
local file="$1"
|
||||||
|
local required_fields="id title status epic"
|
||||||
|
local missing_fields=""
|
||||||
|
|
||||||
|
if [ ! -f "$file" ]; then
|
||||||
|
bmad_error "File not found: $file"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
for field in $required_fields; do
|
||||||
|
if ! grep -q "^${field}:" "$file" 2>/dev/null; then
|
||||||
|
missing_fields="$missing_fields $field"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ -n "$missing_fields" ]; then
|
||||||
|
bmad_error "Story file $file missing required fields:$missing_fields"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Validate YAML field value
|
||||||
|
validate_yaml_value() {
|
||||||
|
local file="$1"
|
||||||
|
local field="$2"
|
||||||
|
local pattern="$3"
|
||||||
|
local value
|
||||||
|
|
||||||
|
value=$(grep "^${field}:" "$file" 2>/dev/null | cut -d: -f2- | sed 's/^ //')
|
||||||
|
|
||||||
|
if [ -z "$value" ]; then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! echo "$value" | grep -qE "$pattern"; then
|
||||||
|
bmad_error "Invalid value for $field: $value"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SAFE YAML PARSING
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Extract field value from YAML file
|
||||||
|
get_yaml_field() {
|
||||||
|
local file="$1"
|
||||||
|
local field="$2"
|
||||||
|
local default="${3:-}"
|
||||||
|
|
||||||
|
if [ ! -f "$file" ]; then
|
||||||
|
echo "$default"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
local value
|
||||||
|
value=$(grep "^${field}:" "$file" 2>/dev/null | cut -d: -f2- | sed 's/^ //' | tr -d '\r')
|
||||||
|
|
||||||
|
# Handle null or empty values
|
||||||
|
if [ -z "$value" ] || [ "$value" = "null" ]; then
|
||||||
|
echo "$default"
|
||||||
|
else
|
||||||
|
echo "$value"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Extract multi-line field from YAML
|
||||||
|
get_yaml_multiline() {
|
||||||
|
local file="$1"
|
||||||
|
local field="$2"
|
||||||
|
|
||||||
|
awk "/^${field}:/ {flag=1; next} /^[^ ]/ {flag=0} flag" "$file" 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# PERFORMANCE OPTIMIZATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Setup cache directory
|
||||||
|
setup_cache() {
|
||||||
|
local cache_dir=".bmad/.cache"
|
||||||
|
|
||||||
|
if [ ! -d "$cache_dir" ]; then
|
||||||
|
mkdir -p "$cache_dir"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "$cache_dir"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Check if cache is valid (newer than source files)
|
||||||
|
is_cache_valid() {
|
||||||
|
local cache_file="$1"
|
||||||
|
local source_dir="$2"
|
||||||
|
|
||||||
|
if [ ! -f "$cache_file" ]; then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Find any source file newer than cache
|
||||||
|
if find "$source_dir" -name "*.yaml" -newer "$cache_file" 2>/dev/null | grep -q .; then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Cache story statuses for performance
|
||||||
|
cache_story_statuses() {
|
||||||
|
local cache_dir
|
||||||
|
cache_dir=$(setup_cache)
|
||||||
|
local cache_file="$cache_dir/story_statuses.cache"
|
||||||
|
|
||||||
|
if is_cache_valid "$cache_file" ".bmad/stories"; then
|
||||||
|
cat "$cache_file"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Rebuild cache
|
||||||
|
find .bmad/stories -name "*.yaml" -exec grep -H "^status:" {} \; 2>/dev/null | \
|
||||||
|
tee "$cache_file"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# FORMATTING HELPERS
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Generate progress bar
|
||||||
|
progress_bar() {
|
||||||
|
local current="$1"
|
||||||
|
local total="$2"
|
||||||
|
local width="${3:-10}"
|
||||||
|
|
||||||
|
if [ "$total" -eq 0 ]; then
|
||||||
|
echo "[----------]"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
local percent=$((current * 100 / total))
|
||||||
|
local filled=$((current * width / total))
|
||||||
|
local empty=$((width - filled))
|
||||||
|
|
||||||
|
printf "["
|
||||||
|
printf "█%.0s" $(seq 1 $filled 2>/dev/null || yes | head -n $filled | tr -d '\n')
|
||||||
|
printf "░%.0s" $(seq 1 $empty 2>/dev/null || yes | head -n $empty | tr -d '\n')
|
||||||
|
printf "] %d%%" "$percent"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Map status to emoji
|
||||||
|
status_to_emoji() {
|
||||||
|
local status="$1"
|
||||||
|
|
||||||
|
case "$status" in
|
||||||
|
"draft") echo "📝" ;;
|
||||||
|
"ready") echo "📋" ;;
|
||||||
|
"in_progress") echo "🔄" ;;
|
||||||
|
"code_review") echo "👀" ;;
|
||||||
|
"qa_testing") echo "🧪" ;;
|
||||||
|
"completed"|"done") echo "✅" ;;
|
||||||
|
"blocked") echo "🚫" ;;
|
||||||
|
*) echo "❓" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Priority to emoji
|
||||||
|
priority_to_emoji() {
|
||||||
|
local priority="$1"
|
||||||
|
|
||||||
|
case "$priority" in
|
||||||
|
"high") echo "🔴" ;;
|
||||||
|
"medium") echo "🟡" ;;
|
||||||
|
"low") echo "🔵" ;;
|
||||||
|
*) echo "⚪" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# DATA AGGREGATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Count stories by status (optimized single pass)
|
||||||
|
count_stories_by_status() {
|
||||||
|
awk '
|
||||||
|
/^status: draft/ {draft++}
|
||||||
|
/^status: ready/ {ready++}
|
||||||
|
/^status: in_progress/ {in_progress++}
|
||||||
|
/^status: code_review/ {code_review++}
|
||||||
|
/^status: qa_testing/ {qa_testing++}
|
||||||
|
/^status: completed|^status: done/ {completed++}
|
||||||
|
END {
|
||||||
|
print "draft=" draft+0
|
||||||
|
print "ready=" ready+0
|
||||||
|
print "in_progress=" in_progress+0
|
||||||
|
print "code_review=" code_review+0
|
||||||
|
print "qa_testing=" qa_testing+0
|
||||||
|
print "completed=" completed+0
|
||||||
|
}
|
||||||
|
' .bmad/stories/*.yaml 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
# Calculate story points (optimized)
|
||||||
|
calculate_points() {
|
||||||
|
local filter="${1:-}"
|
||||||
|
|
||||||
|
if [ -z "$filter" ]; then
|
||||||
|
awk '/^points:/ {sum+=$2} END {print sum+0}' .bmad/stories/*.yaml 2>/dev/null
|
||||||
|
else
|
||||||
|
grep -l "$filter" .bmad/stories/*.yaml 2>/dev/null | \
|
||||||
|
xargs awk '/^points:/ {sum+=$2} END {print sum+0}' 2>/dev/null
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# COLOR OUTPUT SUPPORT
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Check if terminal supports colors
|
||||||
|
supports_color() {
|
||||||
|
if [ -t 1 ] && [ -n "${TERM:-}" ] && [ "$TERM" != "dumb" ]; then
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# Color codes (only if supported)
|
||||||
|
setup_colors() {
|
||||||
|
if supports_color; then
|
||||||
|
export RED='\033[0;31m'
|
||||||
|
export GREEN='\033[0;32m'
|
||||||
|
export YELLOW='\033[1;33m'
|
||||||
|
export BLUE='\033[0;34m'
|
||||||
|
export PURPLE='\033[0;35m'
|
||||||
|
export CYAN='\033[0;36m'
|
||||||
|
export BOLD='\033[1m'
|
||||||
|
export RESET='\033[0m'
|
||||||
|
else
|
||||||
|
export RED=''
|
||||||
|
export GREEN=''
|
||||||
|
export YELLOW=''
|
||||||
|
export BLUE=''
|
||||||
|
export PURPLE=''
|
||||||
|
export CYAN=''
|
||||||
|
export BOLD=''
|
||||||
|
export RESET=''
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# INITIALIZATION
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# Initialize library
|
||||||
|
bmad_lib_init() {
|
||||||
|
setup_shell_compatibility
|
||||||
|
setup_colors
|
||||||
|
}
|
||||||
|
|
||||||
|
# Auto-initialize if sourced
|
||||||
|
bmad_lib_init
|
||||||
Loading…
Reference in New Issue