Improve AWS Batch spot reclamation error messages

[ewels]

Warning

Experimentation - having a play with using Claude Code in the terminal to fix Nextflow issues. I haven't written or read this code. Feel free to bin it if it's junk (very likely).

Summary

• Improve error messages when AWS Batch spot instances are reclaimed
• Add clearer guidance on configuring maxSpotAttempts for automatic retries
• Enhance logging for retry attempts and spot reclamation configuration
• Include helpful links to AWS documentation

Changes Made

• Added isSpotReclamationError() method to detect spot reclamation failures
• Added formatSpotReclamationError() method to provide user-friendly error messages
• Enhanced error handling in checkIfCompleted() to use improved messages
• Added logging for retry attempts and spot reclamation configuration
• Error messages now include actionable guidance about the maxSpotAttempts setting

Fixes

• Closes AWS spot failure - custom error message #5240: AWS spot failure - custom error message
• Closes Spot reclamations: clearer error reason #6225: Spot reclamations: clearer error reason

Test Plan

• Verify that spot reclamation errors now show clearer messages
• Test with maxSpotAttempts = 0 (current default) to ensure guidance is shown
• Test with maxSpotAttempts > 0 to verify retry configuration messages
• Confirm existing functionality is preserved for non-spot errors

🤖 Generated with Claude Code

[netlify]

✅ Deploy Preview for nextflow-docs-staging canceled.

Name	Link
🔨 Latest commit	12f7b22
🔍 Latest deploy log	https://app.netlify.com/projects/nextflow-docs-staging/deploys/6867d8c2fa70c2000884a1fa