Skip to content

Publish HelperPayroll 0.4.3.0 Alpha 2 - #9

Draft
SimGamerJen wants to merge 13 commits into
mainfrom
agent/helperpayroll-0.4.3.0-alpha2
Draft

Publish HelperPayroll 0.4.3.0 Alpha 2#9
SimGamerJen wants to merge 13 commits into
mainfrom
agent/helperpayroll-0.4.3.0-alpha2

Conversation

@SimGamerJen

@SimGamerJen SimGamerJen commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Scope

Publishes HelperPayroll 0.4.3.0 Alpha 2 on top of the current 0.4.2.0 Alpha 2 main branch.

HelperProfiles roster-aware payroll integration

  • Keeps the permanent A–T identity set for payroll persistence and history.
  • Adds a separate operational roster path driven by HelperProfiles availability.
  • The HelperPayroll Workers tab shows only workers currently ON roster when HelperProfiles supplies availability state.
  • OFF-roster workers retain their role mappings, inherited/custom compensation settings and ledger identity/history.
  • Re-enabling a worker restores the same payroll configuration.
  • Standalone operation continues to expose the normal managed worker slots when HelperProfiles is absent.

External worker sessions / AutoDrive accounting

Alpha 2 now includes a generic external-worker-session boundary for controllers that manage helpers outside g_currentMission.aiSystem.activeJobs.

  • Public API raised to v5.
  • Snapshot schema raised to v3.
  • Adds beginExternalWorkerSession, endExternalWorkerSession, and getExternalWorkerSessions.
  • External sessions snapshot helper identity, role and compensation at logical session start.
  • Session duration is tracked independently of GIANTS active jobs.
  • Completed sessions reuse the existing applyWorkerCharge() pipeline, including hourly/daily compensation, call-outs, minimums, onJobFinish, dailyPayroll, day-rate de-duplication and persistent ledger handling.
  • Active external sessions are exposed in payroll snapshots alongside normal GIANTS AI jobs.
  • The first consumer is the HelperProfiles AutoDrive continuity bridge: AutoDrive's internal release/reacquire cycles remain one payroll session; only a genuine HelperProfiles AutoDrive reservation end finishes the payroll session.

This API is intentionally generic: HelperPayroll does not depend directly on AutoDrive.

Alpha 1 work retained

  • WorkerCosts incompatibility protection and runtime payroll safety block.
  • Modular compatibility, farm-scope, public-API and snapshot boundaries.
  • Live payroll Dashboard.
  • Job-start farm ownership snapshots intended to keep later multiplayer adoption cleaner.

Multiplayer

Multiplayer remains deliberately disabled:

<multiplayer supported="false" />

The state and API boundaries are structured to make a later server-authoritative multiplayer implementation possible without making this release multiplayer-enabled.

Current verification state

The branch is still a test branch and must not be merged/released until an in-game combined AutoDrive + Courseplay test confirms:

  • the Courseplay worker remains a normal GIANTS AI payroll job;
  • the AutoDrive driver creates one external payroll session;
  • pipe-close release/reacquire events do not split or re-bill that session;
  • a genuine AutoDrive stop finishes the external session once;
  • the expected helper identity/role and duration reach the ledger or pending daily payroll row.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant