fix(#699): move batch state from transient to engine_data

[chubes4]

Summary

• Moves batch fan-out state (data packets, engine snapshot, offset) from a WordPress transient to the parent job's engine_data column
• Batch state now survives deploys, cache flushes, and Redis restarts — the root cause of 22 batch_state_missing failures on 2026-03-07

What changed

fanOut() — stores batch_state key in engine_data alongside existing batch metadata. No more set_transient().

processChunk() — reads batch_state from engine_data, updates offset there between chunks, unset()s the key when all chunks are processed (or on cancellation). No more get_transient()/delete_transient().

Tests — test_fanout_stores_transient → test_fanout_stores_batch_state_in_engine_data, zero-children test seeds engine_data instead of transient, new test_batch_state_cleaned_up_after_all_chunks_processed test.

No backward compat for in-flight transient batches — any batch mid-flight during a deploy was already dead (that's the bug this fixes).

Closes #699

[github-actions]

Homeboy Results — data-machine

Lint

Tooling versions

• Homeboy CLI: homeboy 0.71.0
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: unknown
• Action: Extra-Chill/homeboy-action@v1

ℹ️ PR test scope resolved to full for compatibility with installed Homeboy CLI

✅ lint (changed files only)

• PHPStan: PHPSTAN SUMMARY: 202 errors at level 5

Test

Tooling versions

• Homeboy CLI: homeboy 0.71.0
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: unknown
• Action: Extra-Chill/homeboy-action@v1

⚡ PR test scope resolved to changed

✅ test

• PHPCS: LINT SUMMARY: 0 errors, 5 warnings
• Fixable: 5 | Files with issues: 2 of 362

Top violations

  Generic.Formatting.MultipleStatementAlignment.NotSameWarning     5

- PHPStan: PHPSTAN SUMMARY: 202 errors at level 5 - OK (155 tests, 1244 assertions)

Audit

Tooling versions

• Homeboy CLI: homeboy 0.71.0
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: unknown
• Action: Extra-Chill/homeboy-action@v1

ℹ️ PR test scope resolved to full for compatibility with installed Homeboy CLI

✅ audit (changed files only)

• Actionable audit summary:
• Alignment score: 0.693
• Severity counts: info: 2, unknown: 73, warning: 2
• Drift increased: no
• Outliers in current run: 73
• Parsed outlier entries: 73
• Top actionable findings:
  1. inc/Abilities/Engine/PipelineBatchScheduler.php — naming_mismatch — Helper-like name does not match convention suffix 'Ability': PipelineBatchScheduler
  2. tests/Unit/Engine/PipelineBatchSchedulerTest.php — missing_method — Missing method: tear_down
  3. tests/Unit/Engine/PipelineBatchSchedulerTest.php — missing_interface — Missing interface: WP_UnitTestCase
  4. tests/Unit/Engine/PipelineBatchSchedulerTest.php — unreferenced_export — Public function 'set_up_before_class' is not referenced by any other file
  5. tests/Unit/Abilities/SystemAbilitiesTest.php — outlier — (outlier)

---

Homeboy Action v1