Allow agent bundle runs to return final engine data

[chubes4]

Summary

• Add an opt-in wait_for_completion / wait mode to datamachine/run-agent-bundle.
• Drain the created bundle job through the existing datamachine/drain-job ability and return job_status, wait_result, and final engine_data.
• Document and test the CLI run-bundle --wait contract so sandbox callers do not need Data Machine internals.

Testing

• php tests/agent-bundle-runner-contract-smoke.php
• php -l inc/Engine/Bundle/AgentBundleRunner.php && php -l inc/Abilities/AgentAbilities.php && php -l inc/Cli/Commands/AgentBundleCommand.php
• git diff --check

AI assistance

• AI assistance: Yes
• Tool(s): OpenCode (openai/gpt-5.5)
• Used for: Investigated the wp-site-generator Site Generation Loop failure, implemented the public Data Machine final-result contract, updated docs/tests, and ran targeted verification. Chris remains responsible for review and merge.

[homeboy-ci]

Homeboy Results — data-machine

Lint

✅ lint — passed

ℹ️ Full options: homeboy docs commands/lint
Deep dive: homeboy lint data-machine --changed-since adf1394

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-lint-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-lint-quality-Linux-node24 contains exported Homeboy run history for deeper queries.
• Drill-down: download the observation artifact, then run homeboy runs import <dir>, homeboy runs list, and homeboy runs findings <run-id>.
• Artifacts are attached to the workflow run: https://github.com/Extra-Chill/data-machine/actions/runs/26967448938

Test

✅ test — passed

• 883 passed
• 4 skipped

ℹ️ Auto-fix lint issues: homeboy refactor data-machine --from lint --write
ℹ️ Collect coverage: homeboy test data-machine --coverage
ℹ️ Save test baseline: homeboy test data-machine --baseline
ℹ️ Pass args to test runner: homeboy test -- [args]
ℹ️ Full options: homeboy docs commands/test
Deep dive: homeboy test data-machine --changed-since adf1394

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-test-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-test-quality-Linux-node24 contains exported Homeboy run history for deeper queries.
• Drill-down: download the observation artifact, then run homeboy runs import <dir>, homeboy runs list, and homeboy runs findings <run-id>.
• Artifacts are attached to the workflow run: https://github.com/Extra-Chill/data-machine/actions/runs/26967448938

Audit

✅ audit — passed

• audit — 43 finding(s)
• Total: 43 finding(s)

Deep dive: homeboy audit data-machine --changed-since adf1394

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-audit-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-audit-quality-Linux-node24 contains exported Homeboy run history for deeper queries.
• Drill-down: download the observation artifact, then run homeboy runs import <dir>, homeboy runs list, and homeboy runs findings <run-id>.
• Artifacts are attached to the workflow run: https://github.com/Extra-Chill/data-machine/actions/runs/26967448938

Tooling versions

• Homeboy CLI: homeboy 0.220.3+8b34d413
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: ca22ec16
• Action: unknown@unknown