# TODO: Commission Jobs Improvements

## Completed
- [x] Update script to use new `filter_question` and `summarization_question` API fields
- [x] Add input validation and usage instructions
- [x] Update README with examples and documentation

## Potential Improvements

### Script Enhancements
- [ ] Add support for filtering by users instead of just lists
- [ ] Add option to save results to a file (JSON or markdown format)
- [ ] Add timeout handling for long-running jobs
- [ ] Add retry logic for network failures
- [ ] Add colored output for better readability
- [ ] Add option to specify custom server URL (not hardcoded)

### Configuration
- [ ] Add config file support for default questions and lists
- [ ] Add environment variable support for server URL and API keys
- [ ] Add predefined question templates for common use cases

### Output Improvements
- [ ] Format summary output as markdown
- [ ] Add option to only show passed tweets vs all tweets
- [ ] Add statistics summary (total tweets, passed tweets, percentage)
- [ ] Add option to export results in different formats (CSV, JSON, MD)

### Error Handling
- [ ] Better error messages for common failures
- [ ] Validate list exists before starting job
- [ ] Handle job timeout scenarios gracefully
- [ ] Add option to resume failed jobs

### Advanced Features
- [ ] Batch processing multiple lists
- [ ] Comparison mode (run same questions on different lists)
- [ ] Historical analysis (compare results over time)
- [ ] Integration with other tools (email notifications, Slack, etc.)

## Usage Examples to Test

```bash
# AI developments
./commission-job.sh "Does this tweet discuss AI developments or research?" "What are the key AI breakthroughs and developments mentioned?" "ai-og"

# Economic indicators
./commission-job.sh "Does this tweet mention economic indicators or market trends?" "What are the main economic trends and forecasts discussed?" "forecasting"

# Political developments
./commission-job.sh "Does this tweet discuss political developments or policy changes?" "What are the key political developments and policy changes mentioned?" "whitehouse"
```