feat: Add intelligent auto-router and enhanced integrations
- Add intelligent-router.sh hook for automatic agent routing - Add AUTO-TRIGGER-SUMMARY.md documentation - Add FINAL-INTEGRATION-SUMMARY.md documentation - Complete Prometheus integration (6 commands + 4 tools) - Complete Dexto integration (12 commands + 5 tools) - Enhanced Ralph with access to all agents - Fix /clawd command (removed disable-model-invocation) - Update hooks.json to v5 with intelligent routing - 291 total skills now available - All 21 commands with automatic routing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
admin
226
dexto/agents/triage-demo/docs/technical-documentation.md
Normal file
226
dexto/agents/triage-demo/docs/technical-documentation.md
Normal file
@@ -0,0 +1,226 @@
|
||||
# TeamFlow Technical Documentation
|
||||
|
||||
## System Requirements
|
||||
|
||||
### Web Application
|
||||
- **Supported Browsers**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
|
||||
- **Minimum Screen Resolution**: 1024x768
|
||||
- **Internet Connection**: Broadband (1 Mbps minimum, 5 Mbps recommended)
|
||||
- **JavaScript**: Must be enabled
|
||||
|
||||
### Mobile Applications
|
||||
|
||||
#### iOS App
|
||||
- **Minimum Version**: iOS 13.0 or later
|
||||
- **Compatible Devices**: iPhone 6s and newer, iPad Air 2 and newer
|
||||
- **Storage**: 150MB free space required
|
||||
- **Network**: 3G/4G/5G or Wi-Fi connection
|
||||
|
||||
#### Android App
|
||||
- **Minimum Version**: Android 8.0 (API level 26)
|
||||
- **RAM**: 2GB minimum, 4GB recommended
|
||||
- **Storage**: 200MB free space required
|
||||
- **Network**: 3G/4G/5G or Wi-Fi connection
|
||||
|
||||
## API Documentation
|
||||
|
||||
### Authentication
|
||||
```
|
||||
Authorization: Bearer <your_api_token>
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
### Base URL
|
||||
- **Production**: `https://api.teamflow.com/v1`
|
||||
- **Sandbox**: `https://sandbox-api.teamflow.com/v1`
|
||||
|
||||
### Rate Limits
|
||||
- **Basic Plan**: 1,000 requests/hour
|
||||
- **Pro Plan**: 10,000 requests/hour
|
||||
- **Enterprise Plan**: Unlimited
|
||||
- **Rate Limit Headers**:
|
||||
- `X-RateLimit-Limit`: Total requests allowed
|
||||
- `X-RateLimit-Remaining`: Requests remaining in current window
|
||||
- `X-RateLimit-Reset`: Unix timestamp when window resets
|
||||
|
||||
### Common Error Codes
|
||||
- **400**: Bad Request - Invalid parameters or request format
|
||||
- **401**: Unauthorized - Invalid or missing API token
|
||||
- **403**: Forbidden - Insufficient permissions
|
||||
- **404**: Not Found - Resource doesn't exist
|
||||
- **422**: Unprocessable Entity - Validation errors
|
||||
- **429**: Too Many Requests - Rate limit exceeded
|
||||
- **500**: Internal Server Error - Contact support
|
||||
- **502/503**: Service Unavailable - Temporary outage
|
||||
|
||||
## Common Technical Issues & Solutions
|
||||
|
||||
### 1. Login and Authentication Issues
|
||||
|
||||
#### "Invalid credentials" error
|
||||
**Symptoms**: User cannot log in, receives "Invalid email or password" message
|
||||
**Common Causes**:
|
||||
- Incorrect email/password combination
|
||||
- Account locked due to multiple failed attempts
|
||||
- Browser caching old session data
|
||||
|
||||
**Solutions**:
|
||||
1. Verify email address (check for typos, extra spaces)
|
||||
2. Try password reset flow
|
||||
3. Clear browser cookies and cache
|
||||
4. Try incognito/private browsing mode
|
||||
5. Check if account is locked (wait 15 minutes or contact support)
|
||||
|
||||
#### Two-Factor Authentication (2FA) issues
|
||||
**Symptoms**: 2FA code not working or not received
|
||||
**Solutions**:
|
||||
1. Ensure device clock is synchronized
|
||||
2. Try generating a new code (codes expire every 30 seconds)
|
||||
3. Check authenticator app is configured correctly
|
||||
4. Use backup codes if available
|
||||
5. Contact support to reset 2FA if backup codes exhausted
|
||||
|
||||
### 2. Performance Issues
|
||||
|
||||
#### Slow loading pages
|
||||
**Symptoms**: Pages take >10 seconds to load, timeouts
|
||||
**Troubleshooting Steps**:
|
||||
1. Check internet connection speed (minimum 1 Mbps required)
|
||||
2. Test on different networks (mobile data vs. Wi-Fi)
|
||||
3. Clear browser cache and cookies
|
||||
4. Disable browser extensions temporarily
|
||||
5. Try different browser
|
||||
6. Check TeamFlow status page: status.teamflow.com
|
||||
|
||||
#### Mobile app crashes
|
||||
**Symptoms**: App closes unexpectedly, freezes during use
|
||||
**Solutions**:
|
||||
1. Force close and restart the app
|
||||
2. Restart device
|
||||
3. Update app to latest version
|
||||
4. Clear app cache (Android) or offload/reinstall app (iOS)
|
||||
5. Check available storage space (minimum 500MB recommended)
|
||||
6. Report crash with device logs
|
||||
|
||||
### 3. API Integration Issues
|
||||
|
||||
#### 401 Unauthorized errors
|
||||
**Diagnostic Steps**:
|
||||
1. Verify API token is correct and not expired
|
||||
2. Check token has required permissions
|
||||
3. Ensure proper Authorization header format
|
||||
4. Test with different API endpoints
|
||||
|
||||
#### 429 Rate limit exceeded
|
||||
**Solutions**:
|
||||
1. Implement exponential backoff in API calls
|
||||
2. Check current rate limit status in response headers
|
||||
3. Consider upgrading plan for higher limits
|
||||
4. Cache responses when possible to reduce API calls
|
||||
|
||||
#### Webhook delivery failures
|
||||
**Common Issues**:
|
||||
- Endpoint URL not accessible from internet
|
||||
- SSL certificate issues
|
||||
- Timeout (webhook endpoint must respond within 10 seconds)
|
||||
- Incorrect response status (must return 2xx status code)
|
||||
|
||||
### 4. File Upload Issues
|
||||
|
||||
#### "File too large" errors
|
||||
**File Size Limits**:
|
||||
- Basic Plan: 25MB per file
|
||||
- Pro Plan: 100MB per file
|
||||
- Enterprise Plan: 500MB per file
|
||||
|
||||
**Solutions**:
|
||||
1. Compress files using zip/rar
|
||||
2. Use cloud storage links for large files
|
||||
3. Split large files into smaller chunks
|
||||
4. Consider plan upgrade for larger limits
|
||||
|
||||
#### Unsupported file formats
|
||||
**Supported Formats**:
|
||||
- Images: JPG, PNG, GIF, SVG, WebP
|
||||
- Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
|
||||
- Archives: ZIP, RAR, 7Z
|
||||
- Text: TXT, CSV, MD
|
||||
- Code: JS, HTML, CSS, JSON, XML
|
||||
|
||||
### 5. Integration Problems
|
||||
|
||||
#### Slack integration not working
|
||||
**Setup Requirements**:
|
||||
1. Slack workspace admin permissions
|
||||
2. TeamFlow Pro or Enterprise plan
|
||||
3. Proper webhook configuration
|
||||
|
||||
**Troubleshooting**:
|
||||
1. Verify Slack workspace URL is correct
|
||||
2. Check webhook permissions in Slack admin
|
||||
3. Test with simple message first
|
||||
4. Ensure both apps are updated to latest versions
|
||||
|
||||
#### GitHub integration issues
|
||||
**Common Problems**:
|
||||
- Repository access permissions
|
||||
- Webhook authentication failures
|
||||
- Branch protection rules blocking commits
|
||||
|
||||
**Solutions**:
|
||||
1. Verify GitHub personal access token has correct scopes
|
||||
2. Check repository permissions for TeamFlow app
|
||||
3. Review webhook logs in GitHub settings
|
||||
4. Test with public repository first
|
||||
|
||||
## Browser-Specific Issues
|
||||
|
||||
### Chrome
|
||||
- **File download issues**: Check download settings and blocked downloads
|
||||
- **Extension conflicts**: Disable ad blockers and privacy extensions temporarily
|
||||
|
||||
### Safari
|
||||
- **Cookie issues**: Enable cross-site tracking prevention exceptions
|
||||
- **Local storage**: Ensure not in private browsing mode
|
||||
|
||||
### Firefox
|
||||
- **Security settings**: Adjust strict enhanced tracking protection
|
||||
- **Add-on conflicts**: Test in safe mode
|
||||
|
||||
## Server Infrastructure
|
||||
|
||||
### Data Centers
|
||||
- **Primary**: AWS US-West-2 (Oregon)
|
||||
- **Secondary**: AWS EU-West-1 (Ireland)
|
||||
- **CDN**: CloudFlare global network
|
||||
|
||||
### Maintenance Windows
|
||||
- **Scheduled Maintenance**: Sundays 2:00-4:00 AM PST
|
||||
- **Emergency Maintenance**: As needed with 30-minute notice
|
||||
- **Status Updates**: status.teamflow.com and @TeamFlowStatus on Twitter
|
||||
|
||||
## Escalation Criteria
|
||||
|
||||
Escalate to Level 2 Support when:
|
||||
- Data loss or corruption suspected
|
||||
- Security breach indicators
|
||||
- API downtime affecting multiple customers
|
||||
- Integration partner (Slack, GitHub, etc.) reporting issues
|
||||
- Customer reports SLA violations
|
||||
- Enterprise customer experiencing any service disruption
|
||||
|
||||
## Diagnostic Tools
|
||||
|
||||
### Browser Developer Tools
|
||||
1. **Console Errors**: Check for JavaScript errors (F12 → Console)
|
||||
2. **Network Tab**: Monitor failed requests and response times
|
||||
3. **Application Tab**: Check local storage and cookies
|
||||
|
||||
### API Testing
|
||||
- Use Postman or curl to test API endpoints
|
||||
- Check response headers for rate limit information
|
||||
- Verify request format matches API documentation
|
||||
|
||||
### Mobile Debugging
|
||||
- iOS: Connect device to Xcode for detailed crash logs
|
||||
- Android: Enable developer options and use ADB logcat
|
||||
Reference in New Issue
Block a user