debug-issue

Debug Issue

Please help me debug this issue: $ISSUE_DESCRIPTION

Error/symptom: $ERROR_MESSAGE Component/area (if known): ${COMPONENT:-unknown} When it started: ${TIMEFRAME:-recently} GitHub issue: ${ISSUE_NUMBER:-none} PR causing issue: ${PR_NUMBER:-unknown}

Systematic Debugging Workflow

1. Search for error patterns:

   # Search for the exact error
   chs find-code "$ERROR_MESSAGE"
   
   # Search for related terms
   chs find-code "${RELATED_TERMS:-error exception fail}"
   

2. Check recent changes:

   # Get recent commit context
   ch ctx prepare-migration "debug $ISSUE_DESCRIPTION"
   
   # Show recent modifications
   chg log --oneline -20
   

3. Trace the problem area:

   # Focus on suspected area
   ch ctx focus "${COMPONENT:-src}" 3
   
   # Find related files
   chs find-file "*${COMPONENT}*"
   

4. Analyze code flow:

   • Trace imports: ch cr imports-of "$SUSPECTED_FILE"
   • Find dependencies: ch cr imported-by "$SUSPECTED_FILE"
   • Check for circular dependencies: ch cr circular

5. Check test coverage:

   # Find related tests
   chs find-file "*.test.*" | xargs grep -l "$COMPONENT"
   
   # Look for test failures
   ch ts test | grep -i "fail"
   

6. Look for code quality issues:

   # Check for TODOs and debug code
   ch cq todos --with-context | grep -C3 "$COMPONENT"
   ch cq console-logs
   

7. Check related GitHub items:

   # If issue number provided, get details
   if [ -n "$ISSUE_NUMBER" ]; then
     gh issue view "$ISSUE_NUMBER"
   fi
   
   # If PR number provided, check changes
   if [ -n "$PR_NUMBER" ]; then
     gh pr diff "$PR_NUMBER" | grep -C5 "$COMPONENT"
   fi
   
   # Search for related issues
   gh issue list --search "$ERROR_MESSAGE" --limit 5
   

8. Generate debugging report:

   • Summarize findings
   • Identify root cause
   • Propose fix
   • Note any side effects
   • Link to issue/PR if applicable