Support HelperProfiles slots A–T

[SimGamerJen]

Alpha scope

Extends HelperPayroll worker-slot, identity and management handling from A–J to A–T, matching the twenty-helper HelperProfiles roster.

Changes

• Raises the managed HelperProfiles slot target to 20.
• Uses generic slot/index conversion rather than assuming A–J only.
• Accepts canonical identities helper01 through helper20 and legacy A–J/slot:X identities.
• Uses the HelperProfiles API roster when available, then the game helper manager, with ten slots retained as the standalone compatibility fallback.
• Extends role mappings, worker overrides, job-slot detection and the Workers management screen to A–T.
• Adds default role mappings for K–T.
• Publishes expanded slot information through the HelperPayroll integration API.
• Retains the job-start assignment snapshot for ledger and billing calculations.

UI ownership

• HelperPayroll remains the sole owner of payroll roles, rates, compensation overrides and worker management.
• HelperProfiles consumes role information only for its read-only roster overlay.
• The HelperProfiles appearance-binding screen does not edit payroll data.

Version

• 0.4.2.0 Alpha 2

Compatibility

• Existing A–J worker and role mappings remain accepted.
• HelperPayroll continues to operate without HelperProfiles through its existing fallback behaviour.

Validation completed

Static and simulated

• XML parsing.
• Lua syntax parsing.
• Twenty-slot conversion and normalisation simulation.
• Expanded HelperProfiles API mapping simulation.
• Worker-role and job-slot mapping simulation.
• ZIP structure, archive and exact per-file source-hash verification.

In Farming Simulator 25 using Alpha 1

• The HelperPayroll Workers screen displayed all A–T slots.
• Roles could be assigned to expanded slots.
• Assignments and slot mappings persisted after save and reload.
• Jobs started with K and T were captured under the correct helper slots.
• The ledger retained the role selected when each job started.
• Changing a worker role while the job was active did not retroactively alter the active assignment.
• Rebinding the corresponding HelperProfiles appearance while active did not change the already captured ledger identity or role.
• HelperProfiles and HelperPayroll reported the expanded API as available.

Alpha 2 metadata

• Promotes the release channel from alpha1 to alpha2.
• Records the completed A–T integration and job-start snapshot testing in the mod description.
• Does not change the validated Alpha 1 payroll calculation or snapshot logic.

Remaining coordinated Alpha 2 smoke test

• Confirm A–T remain visible in the Workers screen.
• Confirm K/T role changes save and reload.
• Start and finish a K/T job and confirm the ledger records the expected slot, canonical identity, job-start role and compensation policy.
• Confirm the new HelperProfiles active-slot appearance lock does not disturb HelperPayroll role assignment or ledger capture.

This PR remains draft and must not be merged until the coordinated Alpha 2 smoke test is approved.