refactor(ux): consolidate BMAD skills, update design system, and clean up Prisma generated client
This commit is contained in:
Sepehr Ramezani
611
.ralph/lib/task_sources.sh
Normal file
611
.ralph/lib/task_sources.sh
Normal file
@@ -0,0 +1,611 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
# task_sources.sh - Task import utilities for Ralph enable
|
||||
# Supports importing tasks from beads, GitHub Issues, and PRD files
|
||||
|
||||
# =============================================================================
|
||||
# BEADS INTEGRATION
|
||||
# =============================================================================
|
||||
|
||||
# check_beads_available - Check if beads (bd) is available and configured
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Beads available
|
||||
# 1 - Beads not available or not configured
|
||||
#
|
||||
check_beads_available() {
|
||||
# Check for .beads directory
|
||||
if [[ ! -d ".beads" ]]; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Check if bd command exists
|
||||
if ! command -v bd &>/dev/null; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# fetch_beads_tasks - Fetch tasks from beads issue tracker
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (filterStatus) - Status filter (optional, default: "open")
|
||||
#
|
||||
# Outputs:
|
||||
# Tasks in markdown checkbox format, one per line
|
||||
# e.g., "- [ ] [issue-001] Fix authentication bug"
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Success (may output empty if no tasks)
|
||||
# 1 - Error fetching tasks
|
||||
#
|
||||
fetch_beads_tasks() {
|
||||
local filterStatus="${1:-open}"
|
||||
local tasks=""
|
||||
|
||||
# Check if beads is available
|
||||
if ! check_beads_available; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Build bd list command arguments
|
||||
local bdArgs=("list" "--json")
|
||||
if [[ "$filterStatus" == "open" ]]; then
|
||||
bdArgs+=("--status" "open")
|
||||
elif [[ "$filterStatus" == "in_progress" ]]; then
|
||||
bdArgs+=("--status" "in_progress")
|
||||
elif [[ "$filterStatus" == "all" ]]; then
|
||||
bdArgs+=("--all")
|
||||
fi
|
||||
|
||||
# Try to get tasks as JSON
|
||||
local json_output
|
||||
if json_output=$(bd "${bdArgs[@]}" 2>/dev/null); then
|
||||
# Parse JSON and format as markdown tasks
|
||||
# Note: Use 'select(.status == "closed") | not' to avoid bash escaping issues with '!='
|
||||
# Also filter out entries with missing id or title fields
|
||||
if command -v jq &>/dev/null; then
|
||||
tasks=$(echo "$json_output" | jq -r '
|
||||
.[] |
|
||||
select(.status == "closed" | not) |
|
||||
select((.id // "") != "" and (.title // "") != "") |
|
||||
"- [ ] [\(.id)] \(.title)"
|
||||
' 2>/dev/null || echo "")
|
||||
fi
|
||||
fi
|
||||
|
||||
# Fallback: try plain text output if JSON failed or produced no results
|
||||
if [[ -z "$tasks" ]]; then
|
||||
# Build fallback args (reuse status logic, but without --json)
|
||||
local fallbackArgs=("list")
|
||||
if [[ "$filterStatus" == "open" ]]; then
|
||||
fallbackArgs+=("--status" "open")
|
||||
elif [[ "$filterStatus" == "in_progress" ]]; then
|
||||
fallbackArgs+=("--status" "in_progress")
|
||||
elif [[ "$filterStatus" == "all" ]]; then
|
||||
fallbackArgs+=("--all")
|
||||
fi
|
||||
tasks=$(bd "${fallbackArgs[@]}" 2>/dev/null | while IFS= read -r line; do
|
||||
# Extract ID and title from bd list output
|
||||
# Format: "○ cnzb-xxx [● P2] [task] - Title here"
|
||||
local id title
|
||||
id=$(echo "$line" | grep -oE '[a-z]+-[a-z0-9]+' | head -1 || echo "")
|
||||
# Extract title after the last " - " separator
|
||||
title=$(echo "$line" | sed 's/.*- //' || echo "$line")
|
||||
if [[ -n "$id" && -n "$title" ]]; then
|
||||
echo "- [ ] [$id] $title"
|
||||
fi
|
||||
done)
|
||||
fi
|
||||
|
||||
if [[ -n "$tasks" ]]; then
|
||||
echo "$tasks"
|
||||
return 0
|
||||
else
|
||||
return 0 # Empty is not an error
|
||||
fi
|
||||
}
|
||||
|
||||
# get_beads_count - Get count of open beads issues
|
||||
#
|
||||
# Returns:
|
||||
# 0 and echoes the count
|
||||
# 1 if beads unavailable
|
||||
#
|
||||
get_beads_count() {
|
||||
if ! check_beads_available; then
|
||||
echo "0"
|
||||
return 1
|
||||
fi
|
||||
|
||||
local count
|
||||
if command -v jq &>/dev/null; then
|
||||
# Note: Use 'select(.status == "closed" | not)' to avoid bash escaping issues with '!='
|
||||
count=$(bd list --json 2>/dev/null | jq '[.[] | select(.status == "closed" | not)] | length' 2>/dev/null || echo "0")
|
||||
else
|
||||
count=$(bd list 2>/dev/null | wc -l | tr -d ' ')
|
||||
fi
|
||||
|
||||
echo "${count:-0}"
|
||||
return 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# GITHUB ISSUES INTEGRATION
|
||||
# =============================================================================
|
||||
|
||||
# check_github_available - Check if GitHub CLI (gh) is available and authenticated
|
||||
#
|
||||
# Returns:
|
||||
# 0 - GitHub available and authenticated
|
||||
# 1 - Not available
|
||||
#
|
||||
check_github_available() {
|
||||
# Check for gh command
|
||||
if ! command -v gh &>/dev/null; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Check if authenticated
|
||||
if ! gh auth status &>/dev/null; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Check if in a git repo with GitHub remote
|
||||
if ! git remote get-url origin 2>/dev/null | grep -q "github.com"; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# fetch_github_tasks - Fetch issues from GitHub
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (label) - Label to filter by (optional, default: "ralph-task")
|
||||
# $2 (limit) - Maximum number of issues (optional, default: 50)
|
||||
#
|
||||
# Outputs:
|
||||
# Tasks in markdown checkbox format
|
||||
# e.g., "- [ ] [#123] Implement user authentication"
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Success
|
||||
# 1 - Error
|
||||
#
|
||||
fetch_github_tasks() {
|
||||
local label="${1:-}"
|
||||
local limit="${2:-50}"
|
||||
local tasks=""
|
||||
|
||||
# Check if GitHub is available
|
||||
if ! check_github_available; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Build gh command
|
||||
local gh_args=("issue" "list" "--state" "open" "--limit" "$limit" "--json" "number,title,labels")
|
||||
if [[ -n "$label" ]]; then
|
||||
gh_args+=("--label" "$label")
|
||||
fi
|
||||
|
||||
# Fetch issues
|
||||
local json_output
|
||||
if ! json_output=$(gh "${gh_args[@]}" 2>/dev/null); then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Parse JSON and format as markdown tasks
|
||||
if command -v jq &>/dev/null; then
|
||||
tasks=$(echo "$json_output" | jq -r '
|
||||
.[] |
|
||||
"- [ ] [#\(.number)] \(.title)"
|
||||
' 2>/dev/null)
|
||||
fi
|
||||
|
||||
if [[ -n "$tasks" ]]; then
|
||||
echo "$tasks"
|
||||
fi
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# get_github_issue_count - Get count of open GitHub issues
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (label) - Label to filter by (optional)
|
||||
#
|
||||
# Returns:
|
||||
# 0 and echoes the count
|
||||
# 1 if GitHub unavailable
|
||||
#
|
||||
get_github_issue_count() {
|
||||
local label="${1:-}"
|
||||
|
||||
if ! check_github_available; then
|
||||
echo "0"
|
||||
return 1
|
||||
fi
|
||||
|
||||
local gh_args=("issue" "list" "--state" "open" "--json" "number")
|
||||
if [[ -n "$label" ]]; then
|
||||
gh_args+=("--label" "$label")
|
||||
fi
|
||||
|
||||
local count
|
||||
if command -v jq &>/dev/null; then
|
||||
count=$(gh "${gh_args[@]}" 2>/dev/null | jq 'length' 2>/dev/null || echo "0")
|
||||
else
|
||||
count=$(gh issue list --state open 2>/dev/null | wc -l | tr -d ' ')
|
||||
fi
|
||||
|
||||
echo "${count:-0}"
|
||||
return 0
|
||||
}
|
||||
|
||||
# get_github_labels - Get available labels from GitHub repo
|
||||
#
|
||||
# Outputs:
|
||||
# Newline-separated list of label names
|
||||
#
|
||||
get_github_labels() {
|
||||
if ! check_github_available; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
gh label list --json name --jq '.[].name' 2>/dev/null
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# PRD CONVERSION
|
||||
# =============================================================================
|
||||
|
||||
# extract_prd_tasks - Extract tasks from a PRD/specification document
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (prd_file) - Path to the PRD file
|
||||
#
|
||||
# Outputs:
|
||||
# Tasks in markdown checkbox format
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Success
|
||||
# 1 - Error
|
||||
#
|
||||
# Note: For full PRD conversion with Claude, use ralph-import
|
||||
# This function does basic extraction without AI assistance
|
||||
#
|
||||
extract_prd_tasks() {
|
||||
local prd_file=$1
|
||||
|
||||
if [[ ! -f "$prd_file" ]]; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
local tasks=""
|
||||
|
||||
# Look for existing checkbox items
|
||||
local checkbox_tasks
|
||||
checkbox_tasks=$(grep -E '^[[:space:]]*[-*][[:space:]]*\[[[:space:]]*[xX ]?[[:space:]]*\]' "$prd_file" 2>/dev/null)
|
||||
if [[ -n "$checkbox_tasks" ]]; then
|
||||
# Normalize to unchecked format
|
||||
tasks=$(echo "$checkbox_tasks" | sed 's/\[x\]/[ ]/gi; s/\[X\]/[ ]/g')
|
||||
fi
|
||||
|
||||
# Look for numbered list items that look like tasks
|
||||
local numbered_tasks
|
||||
numbered_tasks=$(grep -E '^[[:space:]]*[0-9]+\.[[:space:]]+' "$prd_file" 2>/dev/null | head -20)
|
||||
if [[ -n "$numbered_tasks" ]]; then
|
||||
while IFS= read -r line; do
|
||||
# Convert numbered item to checkbox
|
||||
local task_text
|
||||
task_text=$(echo "$line" | sed -E 's/^[[:space:]]*[0-9]*\.[[:space:]]*//')
|
||||
if [[ -n "$task_text" ]]; then
|
||||
tasks="${tasks}
|
||||
- [ ] ${task_text}"
|
||||
fi
|
||||
done <<< "$numbered_tasks"
|
||||
fi
|
||||
|
||||
# Look for headings that might be task sections (with line numbers to handle duplicates)
|
||||
local heading_lines
|
||||
heading_lines=$(grep -nE '^#{1,3}[[:space:]]+(TODO|Tasks|Requirements|Features|Backlog|Sprint)' "$prd_file" 2>/dev/null)
|
||||
if [[ -n "$heading_lines" ]]; then
|
||||
# Extract bullet items beneath each matching heading
|
||||
while IFS= read -r heading_entry; do
|
||||
# Parse line number directly from grep -n output (avoids duplicate heading issue)
|
||||
local heading_line
|
||||
heading_line=$(echo "$heading_entry" | cut -d: -f1)
|
||||
[[ -z "$heading_line" ]] && continue
|
||||
|
||||
# Find the next heading (any level) after this one
|
||||
local next_heading_line
|
||||
next_heading_line=$(tail -n +"$((heading_line + 1))" "$prd_file" | grep -n '^#' | head -1 | cut -d: -f1)
|
||||
|
||||
# Extract the section content
|
||||
local section_content
|
||||
if [[ -n "$next_heading_line" ]]; then
|
||||
local end_line=$((heading_line + next_heading_line - 1))
|
||||
section_content=$(sed -n "$((heading_line + 1)),${end_line}p" "$prd_file")
|
||||
else
|
||||
section_content=$(tail -n +"$((heading_line + 1))" "$prd_file")
|
||||
fi
|
||||
|
||||
# Extract bullet items from section and convert to checkboxes
|
||||
while IFS= read -r line; do
|
||||
local task_text=""
|
||||
# Match "- item" or "* item" (but not checkboxes, already handled above)
|
||||
if [[ "$line" =~ ^[[:space:]]*[-*][[:space:]]+(.+)$ ]]; then
|
||||
task_text="${BASH_REMATCH[1]}"
|
||||
# Skip checkbox lines — they are handled by the earlier extraction
|
||||
if [[ "$line" == *"["*"]"* ]]; then
|
||||
task_text=""
|
||||
fi
|
||||
# Match "N. item" numbered patterns
|
||||
elif [[ "$line" =~ ^[[:space:]]*[0-9]+\.[[:space:]]+(.+)$ ]]; then
|
||||
task_text="${BASH_REMATCH[1]}"
|
||||
fi
|
||||
if [[ -n "$task_text" ]]; then
|
||||
tasks="${tasks}
|
||||
- [ ] ${task_text}"
|
||||
fi
|
||||
done <<< "$section_content"
|
||||
done <<< "$heading_lines"
|
||||
fi
|
||||
|
||||
# Clean up and output
|
||||
if [[ -n "$tasks" ]]; then
|
||||
echo "$tasks" | grep -v '^$' | awk '!seen[$0]++' | head -30 # Deduplicate, limit to 30
|
||||
return 0
|
||||
fi
|
||||
|
||||
return 0 # Empty is not an error
|
||||
}
|
||||
|
||||
# convert_prd_with_claude - Full PRD conversion using Claude (calls ralph-import logic)
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (prd_file) - Path to the PRD file
|
||||
# $2 (output_dir) - Directory to output converted files (optional, defaults to .ralph/)
|
||||
#
|
||||
# Outputs:
|
||||
# Sets CONVERTED_PROMPT_FILE, CONVERTED_FIX_PLAN_FILE, CONVERTED_SPECS_FILE
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Success
|
||||
# 1 - Error
|
||||
#
|
||||
convert_prd_with_claude() {
|
||||
local prd_file=$1
|
||||
local output_dir="${2:-.ralph}"
|
||||
|
||||
# This would call into ralph_import.sh's convert_prd function
|
||||
# For now, we do basic extraction
|
||||
# Full Claude-based conversion requires the import script
|
||||
|
||||
if [[ ! -f "$prd_file" ]]; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Check if ralph-import is available for full conversion
|
||||
if command -v ralph-import &>/dev/null; then
|
||||
# Use ralph-import for full conversion
|
||||
# Note: ralph-import creates a new project, so we need to adapt
|
||||
echo "Full PRD conversion available via: ralph-import $prd_file"
|
||||
return 1 # Return error to indicate basic extraction should be used
|
||||
fi
|
||||
|
||||
# Fall back to basic extraction
|
||||
extract_prd_tasks "$prd_file"
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# TASK NORMALIZATION
|
||||
# =============================================================================
|
||||
|
||||
# normalize_tasks - Normalize tasks to consistent markdown format
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (tasks) - Raw task text (multi-line)
|
||||
# $2 (source) - Source identifier (beads, github, prd)
|
||||
#
|
||||
# Outputs:
|
||||
# Normalized tasks in markdown checkbox format
|
||||
#
|
||||
normalize_tasks() {
|
||||
local tasks=$1
|
||||
local source="${2:-unknown}"
|
||||
|
||||
if [[ -z "$tasks" ]]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Process each line
|
||||
echo "$tasks" | while IFS= read -r line; do
|
||||
# Skip empty lines
|
||||
[[ -z "$line" ]] && continue
|
||||
|
||||
# Already in checkbox format
|
||||
if echo "$line" | grep -qE '^[[:space:]]*-[[:space:]]*\[[[:space:]]*[xX ]?[[:space:]]*\]'; then
|
||||
# Normalize the checkbox
|
||||
echo "$line" | sed 's/\[x\]/[ ]/gi; s/\[X\]/[ ]/g'
|
||||
continue
|
||||
fi
|
||||
|
||||
# Bullet point without checkbox
|
||||
if echo "$line" | grep -qE '^[[:space:]]*[-*][[:space:]]+'; then
|
||||
local text
|
||||
text=$(echo "$line" | sed -E 's/^[[:space:]]*[-*][[:space:]]*//')
|
||||
echo "- [ ] $text"
|
||||
continue
|
||||
fi
|
||||
|
||||
# Numbered item
|
||||
if echo "$line" | grep -qE '^[[:space:]]*[0-9]+\.?[[:space:]]+'; then
|
||||
local text
|
||||
text=$(echo "$line" | sed -E 's/^[[:space:]]*[0-9]*\.?[[:space:]]*//')
|
||||
echo "- [ ] $text"
|
||||
continue
|
||||
fi
|
||||
|
||||
# Plain text line - make it a task
|
||||
echo "- [ ] $line"
|
||||
done
|
||||
}
|
||||
|
||||
# prioritize_tasks - Sort tasks by priority heuristics
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (tasks) - Tasks in markdown format
|
||||
#
|
||||
# Outputs:
|
||||
# Tasks sorted with priority indicators
|
||||
#
|
||||
# Heuristics:
|
||||
# - "critical", "urgent", "blocker" -> High priority
|
||||
# - "important", "should", "must" -> High priority
|
||||
# - "nice to have", "optional", "future" -> Low priority
|
||||
#
|
||||
prioritize_tasks() {
|
||||
local tasks=$1
|
||||
|
||||
if [[ -z "$tasks" ]]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Separate into priority buckets
|
||||
local high_priority=""
|
||||
local medium_priority=""
|
||||
local low_priority=""
|
||||
|
||||
while IFS= read -r line; do
|
||||
[[ -z "$line" ]] && continue
|
||||
|
||||
local lower_line
|
||||
lower_line=$(echo "$line" | tr '[:upper:]' '[:lower:]')
|
||||
|
||||
# Check for priority indicators
|
||||
if echo "$lower_line" | grep -qE '(critical|urgent|blocker|breaking|security|p0|p1)'; then
|
||||
high_priority="${high_priority}${line}
|
||||
"
|
||||
elif echo "$lower_line" | grep -qE '(nice.to.have|optional|future|later|p3|p4|low.priority)'; then
|
||||
low_priority="${low_priority}${line}
|
||||
"
|
||||
elif echo "$lower_line" | grep -qE '(important|should|must|needed|required|p2)'; then
|
||||
high_priority="${high_priority}${line}
|
||||
"
|
||||
else
|
||||
medium_priority="${medium_priority}${line}
|
||||
"
|
||||
fi
|
||||
done <<< "$tasks"
|
||||
|
||||
# Output in priority order
|
||||
echo "## High Priority"
|
||||
[[ -n "$high_priority" ]] && echo "$high_priority"
|
||||
|
||||
echo ""
|
||||
echo "## Medium Priority"
|
||||
[[ -n "$medium_priority" ]] && echo "$medium_priority"
|
||||
|
||||
echo ""
|
||||
echo "## Low Priority"
|
||||
[[ -n "$low_priority" ]] && echo "$low_priority"
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# COMBINED IMPORT
|
||||
# =============================================================================
|
||||
|
||||
# import_tasks_from_sources - Import tasks from multiple sources
|
||||
#
|
||||
# Parameters:
|
||||
# $1 (sources) - Space-separated list of sources: beads, github, prd
|
||||
# $2 (prd_file) - Path to PRD file (required if prd in sources)
|
||||
# $3 (github_label) - GitHub label filter (optional)
|
||||
#
|
||||
# Outputs:
|
||||
# Combined tasks in markdown format
|
||||
#
|
||||
# Returns:
|
||||
# 0 - Success
|
||||
# 1 - No tasks imported
|
||||
#
|
||||
import_tasks_from_sources() {
|
||||
local sources=$1
|
||||
local prd_file="${2:-}"
|
||||
local github_label="${3:-}"
|
||||
|
||||
local all_tasks=""
|
||||
local source_count=0
|
||||
|
||||
# Import from beads
|
||||
if echo "$sources" | grep -qw "beads"; then
|
||||
local beads_tasks
|
||||
if beads_tasks=$(fetch_beads_tasks); then
|
||||
if [[ -n "$beads_tasks" ]]; then
|
||||
all_tasks="${all_tasks}
|
||||
# Tasks from beads
|
||||
${beads_tasks}
|
||||
"
|
||||
((source_count++))
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# Import from GitHub
|
||||
if echo "$sources" | grep -qw "github"; then
|
||||
local github_tasks
|
||||
if github_tasks=$(fetch_github_tasks "$github_label"); then
|
||||
if [[ -n "$github_tasks" ]]; then
|
||||
all_tasks="${all_tasks}
|
||||
# Tasks from GitHub
|
||||
${github_tasks}
|
||||
"
|
||||
((source_count++))
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# Import from PRD
|
||||
if echo "$sources" | grep -qw "prd"; then
|
||||
if [[ -n "$prd_file" && -f "$prd_file" ]]; then
|
||||
local prd_tasks
|
||||
if prd_tasks=$(extract_prd_tasks "$prd_file"); then
|
||||
if [[ -n "$prd_tasks" ]]; then
|
||||
all_tasks="${all_tasks}
|
||||
# Tasks from PRD
|
||||
${prd_tasks}
|
||||
"
|
||||
((source_count++))
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
if [[ -z "$all_tasks" ]]; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Normalize and output
|
||||
normalize_tasks "$all_tasks" "combined"
|
||||
return 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# EXPORTS
|
||||
# =============================================================================
|
||||
|
||||
export -f check_beads_available
|
||||
export -f fetch_beads_tasks
|
||||
export -f get_beads_count
|
||||
export -f check_github_available
|
||||
export -f fetch_github_tasks
|
||||
export -f get_github_issue_count
|
||||
export -f get_github_labels
|
||||
export -f extract_prd_tasks
|
||||
export -f convert_prd_with_claude
|
||||
export -f normalize_tasks
|
||||
export -f prioritize_tasks
|
||||
export -f import_tasks_from_sources
|
||||
Reference in New Issue
Block a user