Add CLI and improve documentation

.claude/commands/pm/epic-refresh.md

@@ -42,16 +42,19 @@ if [ ! -z "$epic_issue" ]; then
   gh issue view $epic_issue --json body -q .body > /tmp/epic-body.md
 
   # For each task, check its status and update checkbox
+  # Source cross-platform utilities
+  source .claude/scripts/utils.sh
+
   for task_file in .claude/epics/$ARGUMENTS/[0-9]*.md; do
     task_issue=$(grep 'github:' $task_file | grep -oE '[0-9]+$')
     task_status=$(grep 'status:' $task_file | cut -d: -f2 | tr -d ' ')
 
     if [ "$task_status" = "closed" ]; then
-      # Mark as checked
-      sed -i "s/- \[ \] #$task_issue/- [x] #$task_issue/" /tmp/epic-body.md
+      # Mark as checked - cross-platform approach
+      cross_platform_sed "s/- \[ \] #$task_issue/- [x] #$task_issue/" /tmp/epic-body.md
     else
-      # Ensure unchecked (in case manually checked)
-      sed -i "s/- \[x\] #$task_issue/- [ ] #$task_issue/" /tmp/epic-body.md
+      # Ensure unchecked (in case manually checked) - cross-platform approach
+      cross_platform_sed "s/- \[x\] #$task_issue/- [ ] #$task_issue/" /tmp/epic-body.md
     fi
   done
 

.claude/commands/pm/epic-sync.md

@@ -106,6 +106,11 @@ else
   epic_type="feature"
 fi
 
+# Ensure labels exist
+gh label create "epic" --force 2>/dev/null || true
+gh label create "epic:$ARGUMENTS" --force 2>/dev/null || true  
+gh label create "$epic_type" --force 2>/dev/null || true
+
 # Create epic issue with labels
 epic_number=$(gh issue create \
   --title "Epic: $ARGUMENTS" \
@@ -147,6 +152,10 @@ if [ "$task_count" -lt 5 ]; then
     # Strip frontmatter from task content
     sed '1,/^---$/d; 1,/^---$/d' "$task_file" > /tmp/task-body.md
 
+    # Ensure labels exist
+    gh label create "task" --force 2>/dev/null || true
+    gh label create "epic:$ARGUMENTS" --force 2>/dev/null || true
+
     # Create sub-issue with labels
     if [ "$use_subissues" = true ]; then
       task_number=$(gh sub-issue create \
@@ -208,9 +217,13 @@ Task:
     2. Strip frontmatter using: sed '1,/^---$/d; 1,/^---$/d'
     3. Create sub-issue using:
        - If gh-sub-issue available:
+         gh label create "task" --force 2>/dev/null || true
+         gh label create "epic:$ARGUMENTS" --force 2>/dev/null || true
          gh sub-issue create --parent $epic_number --title "$task_name" \
            --body-file /tmp/task-body.md --label "task,epic:$ARGUMENTS"
        - Otherwise:
+         gh label create "task" --force 2>/dev/null || true
+         gh label create "epic:$ARGUMENTS" --force 2>/dev/null || true
          gh issue create --title "$task_name" --body-file /tmp/task-body.md \
            --label "task,epic:$ARGUMENTS"
     4. Record: task_file:issue_number
@@ -272,11 +285,13 @@ while IFS=: read -r task_file task_number; do
 
   # Update frontmatter with GitHub URL and current timestamp
   current_date=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Use cross-platform sed to update the github and updated fields
+  source .claude/scripts/utils.sh
+  cross_platform_sed_backup "/^github:/c\github: $github_url" "$new_name"
+  cross_platform_sed_backup "/^updated:/c\updated: $current_date" "$new_name"
+  # Backup files are automatically managed by cross_platform_sed_backup
 
-  # Use sed to update the github and updated fields
-  sed -i.bak "/^github:/c\github: $github_url" "$new_name"
-  sed -i.bak "/^updated:/c\updated: $current_date" "$new_name"
-  rm "${new_name}.bak"
 done < /tmp/task-mapping.txt
 ```
 
@@ -316,10 +331,11 @@ repo=$(gh repo view --json nameWithOwner -q .nameWithOwner)
 epic_url="https://github.com/$repo/issues/$epic_number"
 current_date=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
-# Update epic frontmatter
-sed -i.bak "/^github:/c\github: $epic_url" .claude/epics/$ARGUMENTS/epic.md
-sed -i.bak "/^updated:/c\updated: $current_date" .claude/epics/$ARGUMENTS/epic.md
-rm .claude/epics/$ARGUMENTS/epic.md.bak
+# Update epic frontmatter - cross-platform approach
+source .claude/scripts/utils.sh
+cross_platform_sed_backup "/^github:/c\github: $epic_url" .claude/epics/$ARGUMENTS/epic.md
+cross_platform_sed_backup "/^updated:/c\updated: $current_date" .claude/epics/$ARGUMENTS/epic.md
+# Backup files are automatically managed by cross_platform_sed_backup
 ```
 
 #### 5b. Update Tasks Created Section

.claude/commands/pm/issue-close.md

@@ -67,8 +67,9 @@ if [ ! -z "$epic_issue" ]; then
   # Get current epic body
   gh issue view $epic_issue --json body -q .body > /tmp/epic-body.md
 
-  # Check off this task
-  sed -i "s/- \[ \] #$ARGUMENTS/- [x] #$ARGUMENTS/" /tmp/epic-body.md
+  # Check off this task - use cross-platform approach
+  source .claude/scripts/utils.sh
+  cross_platform_sed "s/- \[ \] #$ARGUMENTS/- [x] #$ARGUMENTS/" /tmp/epic-body.md
 
   # Update epic issue
   gh issue edit $epic_issue --body-file /tmp/epic-body.md

.claude/commands/pm/issue-edit.md

@@ -55,6 +55,10 @@ gh issue edit $ARGUMENTS --body-file {updated_task_file}
 
 If labels changed:
 ```bash
+# Ensure labels exist
+for label in {new_labels}; do
+  gh label create "$label" --force 2>/dev/null || true
+done
 gh issue edit $ARGUMENTS --add-label "{new_labels}"
 gh issue edit $ARGUMENTS --remove-label "{removed_labels}"
 ```

.claude/commands/pm/issue-start.md

@@ -127,6 +127,8 @@ Task:
 
 ```bash
 # Assign to self and mark in-progress
+# Ensure label exists
+gh label create "in-progress" --force 2>/dev/null || true
 gh issue edit $ARGUMENTS --add-assignee @me --add-label "in-progress"
 ```
 

.claude/rules/github-operations.md

@@ -55,12 +55,18 @@ gh issue view {number} --json state,title,labels,body
 ### Create Issue
 ```bash
 # ALWAYS check remote origin first!
+# Ensure labels exist (force create if needed)
+for label in {labels}; do
+  gh label create "$label" --force 2>/dev/null || true
+done
 gh issue create --title "{title}" --body-file {file} --label "{labels}"
 ```
 
 ### Update Issue
 ```bash
 # ALWAYS check remote origin first!
+# Ensure label exists (force create if needed)
+gh label create "{label}" --force 2>/dev/null || true
 gh issue edit {number} --add-label "{label}" --add-assignee @me
 ```
 

.claude/scripts/pm/blocked.sh

@@ -1,9 +1,10 @@
 #!/bin/bash
+set -euo pipefail
 echo "Getting tasks..."
 echo ""
 echo ""
 
-echo "🚫 Blocked Tasks"
+echo "[BLOCKED] Blocked Tasks"
 echo "================"
 echo ""
 
@@ -27,7 +28,7 @@ for epic_dir in .claude/epics/*/; do
       task_name=$(grep "^name:" "$task_file" | head -1 | sed 's/^name: *//')
       task_num=$(basename "$task_file" .md)
 
-      echo "⏸️ Task #$task_num - $task_name"
+      echo "[PAUSED] Task #$task_num - $task_name"
       echo "   Epic: $epic_name"
       echo "   Blocked by: [$deps]"
 
@@ -43,17 +44,17 @@ for epic_dir in .claude/epics/*/; do
 
       [ -n "$open_deps" ] && echo "   Waiting for:$open_deps"
       echo ""
-      ((found++))
+      found=$((found + 1))
     fi
   done
 done
 
 if [ $found -eq 0 ]; then
   echo "No blocked tasks found!"
   echo ""
-  echo "💡 All tasks with dependencies are either completed or in progress."
+  echo "TIP All tasks with dependencies are either completed or in progress."
 else
-  echo "📊 Total blocked: $found tasks"
+  echo "STATUS Total blocked: $found tasks"
 fi
 
 exit 0

.claude/scripts/pm/epic-list.sh

@@ -1,12 +1,13 @@
 #!/bin/bash
+set -euo pipefail
 echo "Getting epics..."
 echo ""
 echo ""
 
-[ ! -d ".claude/epics" ] && echo "📁 No epics directory found. Create your first epic with: /pm:prd-parse <feature-name>" && exit 0
-[ -z "$(ls -d .claude/epics/*/ 2>/dev/null)" ] && echo "📁 No epics found. Create your first epic with: /pm:prd-parse <feature-name>" && exit 0
+[ ! -d ".claude/epics" ] && echo "No epics directory found. Create your first epic with: /pm:prd-parse <feature-name>" && exit 0
+[ -z "$(ls -d .claude/epics/*/ 2>/dev/null)" ] && echo "No epics found. Create your first epic with: /pm:prd-parse <feature-name>" && exit 0
 
-echo "📚 Project Epics"
+echo "EPIC Project Epics"
 echo "================"
 echo ""
 
@@ -21,24 +22,24 @@ for dir in .claude/epics/*/; do
   [ -f "$dir/epic.md" ] || continue
 
   # Extract metadata
-  n=$(grep "^name:" "$dir/epic.md" | head -1 | sed 's/^name: *//')
-  s=$(grep "^status:" "$dir/epic.md" | head -1 | sed 's/^status: *//' | tr '[:upper:]' '[:lower:]')
-  p=$(grep "^progress:" "$dir/epic.md" | head -1 | sed 's/^progress: *//')
-  g=$(grep "^github:" "$dir/epic.md" | head -1 | sed 's/^github: *//')
+  n=$(grep "^name:" "$dir/epic.md" | head -1 | sed 's/^name: *//' || true)
+  s=$(grep "^status:" "$dir/epic.md" | head -1 | sed 's/^status: *//' | tr '[:upper:]' '[:lower:]' || true)
+  p=$(grep "^progress:" "$dir/epic.md" | head -1 | sed 's/^progress: *//' || true)
+  g=$(grep "^github:" "$dir/epic.md" | head -1 | sed 's/^github: *//' || true)
 
   # Defaults
   [ -z "$n" ] && n=$(basename "$dir")
   [ -z "$p" ] && p="0%"
 
   # Count tasks
-  t=$(ls "$dir"[0-9]*.md 2>/dev/null | wc -l)
+  t=$(ls "$dir"[0-9]*.md 2>/dev/null | wc -l || echo "0")
 
   # Format output with GitHub issue number if available
   if [ -n "$g" ]; then
-    i=$(echo "$g" | grep -o '/[0-9]*$' | tr -d '/')
-    entry="   📋 ${dir}epic.md (#$i) - $p complete ($t tasks)"
+    i=$(echo "$g" | grep -o '/[0-9]*$' | tr -d '/' || true)
+    entry="   TASK ${dir}epic.md (#$i) - $p complete ($t tasks)"
   else
-    entry="   📋 ${dir}epic.md - $p complete ($t tasks)"
+    entry="   TASK ${dir}epic.md - $p complete ($t tasks)"
   fi
 
   # Categorize by status (handle various status values)
@@ -60,23 +61,23 @@ for dir in .claude/epics/*/; do
 done
 
 # Display categorized epics
-echo "📝 Planning:"
+echo "NOTE Planning:"
 if [ -n "$planning_epics" ]; then
   echo -e "$planning_epics" | sed '/^$/d'
 else
   echo "   (none)"
 fi
 
 echo ""
-echo "🚀 In Progress:"
+echo "LAUNCH In Progress:"
 if [ -n "$in_progress_epics" ]; then
   echo -e "$in_progress_epics" | sed '/^$/d'
 else
   echo "   (none)"
 fi
 
 echo ""
-echo "✅ Completed:"
+echo "OK Completed:"
 if [ -n "$completed_epics" ]; then
   echo -e "$completed_epics" | sed '/^$/d'
 else
@@ -85,9 +86,9 @@ fi
 
 # Summary
 echo ""
-echo "📊 Summary"
-total=$(ls -d .claude/epics/*/ 2>/dev/null | wc -l)
-tasks=$(find .claude/epics -name "[0-9]*.md" 2>/dev/null | wc -l)
+echo "STATUS Summary"
+total=$(ls -d .claude/epics/*/ 2>/dev/null | wc -l || echo "0")
+tasks=$(find .claude/epics -name "[0-9]*.md" 2>/dev/null | wc -l || echo "0")
 echo "   Total epics: $total"
 echo "   Total tasks: $tasks"
 

.claude/scripts/pm/epic-show.sh

@@ -1,9 +1,10 @@
 #!/bin/bash
+set -euo pipefail
 
-epic_name="$1"
+epic_name="${1:-}"
 
 if [ -z "$epic_name" ]; then
-  echo "❌ Please provide an epic name"
+  echo "ERROR Please provide an epic name"
   echo "Usage: /pm:epic-show <epic-name>"
   exit 1
 fi
@@ -16,17 +17,17 @@ epic_dir=".claude/epics/$epic_name"
 epic_file="$epic_dir/epic.md"
 
 if [ ! -f "$epic_file" ]; then
-  echo "❌ Epic not found: $epic_name"
+  echo "ERROR Epic not found: $epic_name"
   echo ""
   echo "Available epics:"
   for dir in .claude/epics/*/; do
-    [ -d "$dir" ] && echo "  • $(basename "$dir")"
+    [ -d "$dir" ] && echo "  * $(basename "$dir")"
   done
   exit 1
 fi
 
 # Display epic details
-echo "📚 Epic: $epic_name"
+echo "EPIC Epic: $epic_name"
 echo "================================"
 echo ""
 
@@ -36,15 +37,15 @@ progress=$(grep "^progress:" "$epic_file" | head -1 | sed 's/^progress: *//')
 github=$(grep "^github:" "$epic_file" | head -1 | sed 's/^github: *//')
 created=$(grep "^created:" "$epic_file" | head -1 | sed 's/^created: *//')
 
-echo "📊 Metadata:"
+echo "STATUS Metadata:"
 echo "  Status: ${status:-planning}"
 echo "  Progress: ${progress:-0%}"
 [ -n "$github" ] && echo "  GitHub: $github"
 echo "  Created: ${created:-unknown}"
 echo ""
 
 # Show tasks
-echo "📝 Tasks:"
+echo "NOTE Tasks:"
 task_count=0
 open_count=0
 closed_count=0
@@ -58,15 +59,17 @@ for task_file in "$epic_dir"/[0-9]*.md; do
   parallel=$(grep "^parallel:" "$task_file" | head -1 | sed 's/^parallel: *//')
 
   if [ "$task_status" = "closed" ] || [ "$task_status" = "completed" ]; then
-    echo "  ✅ #$task_num - $task_name"
-    ((closed_count++))
+    echo "  OK #$task_num - $task_name"
+    closed_count=$((closed_count + 1))
   else
-    echo "  ⬜ #$task_num - $task_name"
-    [ "$parallel" = "true" ] && echo -n " (parallel)"
-    ((open_count++))
+    # Construct full output string to avoid dangling output
+    output_line="  OPEN #$task_num - $task_name"
+    [ "$parallel" = "true" ] && output_line="$output_line (parallel)"
+    echo "$output_line"
+    open_count=$((open_count + 1))
   fi
 
-  ((task_count++))
+  task_count=$((task_count + 1))
 done
 
 if [ $task_count -eq 0 ]; then
@@ -75,17 +78,17 @@ if [ $task_count -eq 0 ]; then
 fi
 
 echo ""
-echo "📈 Statistics:"
+echo "STATISTICS:"
 echo "  Total tasks: $task_count"
 echo "  Open: $open_count"
 echo "  Closed: $closed_count"
 [ $task_count -gt 0 ] && echo "  Completion: $((closed_count * 100 / task_count))%"
 
 # Next actions
 echo ""
-echo "💡 Actions:"
-[ $task_count -eq 0 ] && echo "  • Decompose into tasks: /pm:epic-decompose $epic_name"
-[ -z "$github" ] && [ $task_count -gt 0 ] && echo "  • Sync to GitHub: /pm:epic-sync $epic_name"
-[ -n "$github" ] && [ "$status" != "completed" ] && echo "  • Start work: /pm:epic-start $epic_name"
+echo "TIP Actions:"
+[ $task_count -eq 0 ] && echo "  * Decompose into tasks: /pm:epic-decompose $epic_name"
+[ -z "$github" ] && [ $task_count -gt 0 ] && echo "  * Sync to GitHub: /pm:epic-sync $epic_name"
+[ -n "$github" ] && [ "$status" != "completed" ] && echo "  * Start work: /pm:epic-start $epic_name"
 
 exit 0