error-handler

## Purpose

Handle failures gracefully:
- Post clear error messages to issues
- Provide troubleshooting steps
- Preserve partial progress
- Never fail silently

## Usage

Include this file when handling errors:

```
Use lib/error-handler to handle [error type] gracefully
```

## Error Response Templates

### 1. Issue Validation Failed

**When:** Issue missing trigger label, closed, or not found

**Template:**
\`\`\`markdown
⚠️ **Cannot Process Issue**

This issue needs the \`claude:auto-fix\` label to be processed automatically.

**To enable automatic handling:**
\`\`\`bash
gh issue edit <issue-number> --add-label "claude:auto-fix"
\`\`\`

Then run: \`/handle-issue <issue-number>\`
\`\`\`

**Post to:** Issue comment
**Exit:** Gracefully (not a failure)

### 2. Code Exploration Found Nothing

**When:** Targeted search and deep analysis return no results

**Template:**
\`\`\`markdown
🔍 **Analysis Incomplete**

I searched the codebase but couldn't confidently locate code related to this issue.

**What I searched for:**
- Keywords: \`<keyword1>\`, \`<keyword2>\`, \`<keyword3>\`
- File patterns: \`**/*<pattern>*.{ts,js}\`
- Error traces: <extracted errors>

**Possible reasons:**
- Issue description may need more technical details (file names, function names, error messages)
- Code may be in a different location than expected
- Issue may require domain knowledge I don't have

**Next steps:**
- Add more technical details to the issue description
- Mention specific files or functions involved
- Run \`/handle-issue <issue-number>\` again after updating

Alternatively, this may require manual investigation.
\`\`\`

**Post to:** Issue comment
**Exit:** Gracefully (partial success)

### 3. Approval Check Failed

**When:** Can't access GitHub API, can't parse comments

**Template:**
\`\`\`markdown
⚠️ **Approval Check Failed**

I couldn't verify approval due to an error:
\`\`\`
<error message>
\`\`\`

**Manual verification:**
1. Ensure you've approved the plan (👍 or 'approve' c