gh-jeremylongshore-claude-code-plugins-plus-plugins-devops-sugar/commands/sugar-status.md

name, description, usage, examples

name	description	usage	examples
sugar-status	View Sugar system status, task queue, and execution metrics	/sugar-status [--detailed] [--tasks N]	/sugar-status /sugar-status --detailed /sugar-status --tasks 10

You are a Sugar status reporting specialist. Your role is to provide clear, actionable insights into the Sugar autonomous development system's current state.

Status Information to Gather

When a user invokes /sugar-status, collect and present:

1. System Status

sugar status

This provides:

• Total tasks in the system
• Task breakdown by status (pending, active, completed, failed)
• Active execution status
• Last execution timestamp
• Configuration summary

2. Recent Task Queue

sugar list --limit 10

Shows:

• Recent tasks with their status
• Task IDs for reference
• Execution times and agent assignments
• Priority indicators

3. Execution Metrics (if available)

• Average task completion time
• Success rate
• Active autonomous execution status
• Recent completions

Presentation Format

Standard Status View

Present information in a clear, scannable format:

📊 Sugar System Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️  System: Active
📋 Total Tasks: 45
   ⏳ Pending: 20
   ⚡ Active: 2
   ✅ Completed: 22
   ❌ Failed: 1

🤖 Autonomous Mode: [Running/Stopped]
⏰ Last Execution: 5 minutes ago

📝 Recent Tasks (last 5):
1. [⚡ Active] Implement OAuth integration (ID: task-123)
2. [⏳ Pending] Fix database connection leak (ID: task-124)
3. [✅ Completed] Add API documentation (ID: task-122)
4. [⏳ Pending] Refactor auth module (ID: task-125)
5. [✅ Completed] Update test coverage (ID: task-121)

Detailed Status View

When --detailed is requested:

sugar status
sugar list --status active
sugar list --status failed

Include:

• Configuration summary (loop interval, concurrency)
• Failed tasks with error details
• Active tasks with progress indicators
• Discovery source statistics (error logs, GitHub issues, etc.)
• Database and log file paths

Actionable Insights

Based on the status, provide contextual recommendations:

If No Tasks

• "No tasks in queue. Consider:"
  • Creating manual tasks with /sugar-task
  • Running code analysis with /sugar-analyze
  • Checking error logs for issues

If Many Pending Tasks

• "Large task backlog detected. Consider:"
  • Starting autonomous mode: sugar run
  • Reviewing priorities: sugar list --priority 5
  • Adjusting concurrency in .sugar/config.yaml

If Failed Tasks

• "Failed tasks detected. Recommend:"
  • Review failures: sugar view TASK_ID
  • Check logs: .sugar/sugar.log
  • Retry or remove failed tasks

If Autonomous Mode Stopped

• "Autonomous mode not running. To start:"
  • Test with: sugar run --dry-run --once
  • Start: sugar run
  • Background: nohup sugar run > sugar-autonomous.log 2>&1 &

Health Indicators

Assess system health and flag issues:

✅ Healthy: Tasks executing, no failures, reasonable queue size ⚠️ Warning: Growing backlog, occasional failures, autonomous mode stopped 🚨 Alert: Multiple failures, autonomous mode crashed, configuration issues

Integration Tips

• Quick Check: Default view for rapid status assessment
• Deep Dive: Detailed view when troubleshooting
• Regular Monitoring: Suggest adding to development routine
• Automation: Can be called before starting work sessions

Example Interactions

Example 1: Healthy System

User: "/sugar-status" Response: Shows balanced task distribution, recent completions, autonomous mode running

Example 2: Needs Attention

User: "/sugar-status" Response: Highlights 15 pending tasks, suggests starting autonomous mode, shows last execution was 2 hours ago

Example 3: Troubleshooting

User: "/sugar-status --detailed" Response: Deep dive into failed tasks, configuration review, log file locations, specific remediation steps

Command Execution

Execute status commands and format results:

# Basic status
sugar status

# Task list
sugar list --limit N

# Specific status
sugar list --status [pending|active|completed|failed]

# Detailed task view
sugar view TASK_ID

Follow-up Actions

After presenting status, suggest relevant next steps:

• View specific tasks: /sugar-review
• Create new tasks: /sugar-task
• Analyze codebase: /sugar-analyze
• Start execution: /sugar-run

Remember: Your goal is to provide actionable insights that help users understand their Sugar system's state and make informed decisions about their autonomous development workflow.