Add hints process directive for executor-specific scheduling hints

[pditommaso]

Summary

• Introduce a new map-type hints process directive for executor-specific hints
• Shape: Map<String, String> where keys are either name or executor/name
• Unprefixed keys apply to any executor that recognizes them; prefixed keys restrict to that executor. When both are present, the prefixed form wins for its executor
• Core only validates the map shape (non-empty keys, at most one /, string values) — executors validate the keys they recognize
• AWS Batch: consumableResources hint → Batch ConsumableResourceProperties on the job definition; unknown awsbatch/* keys trigger a log.warn1
• Seqera executor: 11 machineRequirement.* fields overlay the config-scope seqera.executor.machineRequirement. Known keys are derived from MachineRequirementOpts via @ConfigOption reflection — adding a field there is automatically picked up. Unknown seqera/-prefixed keys throw.

Context

Follows the refined ADR proposal from #6960 (comment). Replaces fragile clusterOptions and overloaded ext/resourceLabels workarounds.

Ref: #5917, #6960

Example

process hello {
    // applies to any executor that supports it
    hints consumableResources: 'my-license=1'

    // restricted to AWS Batch
    hints 'awsbatch/consumableResources': 'my-license=1'

    // overrides the seqera.executor.machineRequirement.provisioning config value
    hints 'seqera/machineRequirement.provisioning': 'spotFirst'
}

Test plan

• HintDefsTest — shape validation: string values only, null allowed, non-empty keys, at most one /
• ProcessBuilderTest — hints DSL accumulation, duplicate-key overwrite, non-string rejection
• TaskConfigTest — getHints() retrieval, empty-map default, config override replaces the entire map
• AwsBatchTaskHandlerTest — real ProcessBuilder → TaskConfig → makeJobDefRequest integration; awsbatch/-prefixed precedence over unprefixed; malformed name=qty inputs fail with clear errors; whitespace tolerance
• HintHelperTest — prefixed + unprefixed resolution with precedence; all machineRequirement.* fields overlay; KNOWN_KEYS stays in sync with declared fields; unknown seqera/* throws
• SeqeraTaskHandlerTest — end-to-end submit() wiring: hint overrides config-scope machineRequirement, foreign-namespaced hint is ignored, unknown seqera/* fails submission
• Docs: process.md hints directive, executor.md Seqera supported-hints table

🤖 Generated with Claude Code

[netlify]

✅ Deploy Preview for nextflow-docs-staging ready!

Name	Link
🔨 Latest commit	43d69fc
🔍 Latest deploy log	https://app.netlify.com/projects/nextflow-docs-staging/deploys/69ebadfc828c3d00080fbd61
😎 Deploy Preview	https://deploy-preview-7034--nextflow-docs-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[pditommaso]

@bentsherman this should be ready to go