Refine Data Machine agent routing guidance

[chubes4]

Summary

Replace exhaustive Data Machine command enumeration in generated AGENTS.md with a bounded ownership, routing, and live-discovery contract.

What changed

• Keep Data Machine at unique composition priority 10.
• Route memory, flows, jobs/workers, content/media, communication/approvals, and agent/system work through canonical command families.
• Keep datamachine --help as the complete live command authority.
• Remove renderer-only reflection helpers and update stale CommandRegistry documentation.
• Verify every advertised routing root remains registered.

Verification

• php -l inc/Cli/CommandRegistry.php
• php -l inc/migrations/agents-md.php
• php tests/agents-md-gated-composition-smoke.php
• vendor/bin/phpcs inc/Cli/CommandRegistry.php inc/migrations/agents-md.php tests/agents-md-gated-composition-smoke.php
• Integrated four-owner composition: 95 lines / 6,822 bytes, down from the current 212-line generated document.

Coordination

• Fixes Replace the exhaustive AGENTS.md CLI map with default routing #2990
• wp-coding-agents: Make generated WordPress and Homeboy guidance routing-oriented wp-coding-agents#298
• Data Machine Code: Clarify DMC routing and remove snapshot inventory from AGENTS.md data-machine-code#949
• Intelligence: Automattic/intelligence#897

Each sibling change uses a unique priority and remains safe to merge independently.

AI assistance

• Tool: OpenCode
• Model: OpenAI GPT-5.6 Sol
• Used for: Audited the generated Data Machine command map, implemented concise routing and command-root validation, composed the integrated candidate, and reviewed the resulting flow with Chris.

[chubes4]

Coordinated AGENTS.md routing set: Extra-Chill/wp-coding-agents#299, #2991, Extra-Chill/data-machine-code#950, and Automattic/intelligence#898. The integrated candidate renders in deterministic priority order as WordPress reference → Abilities → Intelligence → Data Machine → DMC → Homeboy.

[homeboy-ci]

Homeboy Results — data-machine

Lint

✅ review lint — passed

ℹ️ Full options: homeboy self docs commands/lint
Deep dive: homeboy review lint data-machine --changed-since 9fff571

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-review-lint-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-review-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/30094573746

Test

❌ review test — failed

ℹ️ The test runner failed before producing structured results. See raw_output.stderr_tail / raw_output.stdout_tail for the underlying error (bootstrap failure, missing deps, DB connection, etc.).
ℹ️ To run specific tests: homeboy test data-machine -- --filter=TestName
ℹ️ Auto-fix lint issues: homeboy refactor data-machine --from lint --write
ℹ️ Collect coverage: homeboy test data-machine --coverage
ℹ️ Analyze failures: homeboy test data-machine --analyze
ℹ️ Pass args to test runner: homeboy test -- [args]
ℹ️ Full options: homeboy self docs commands/test
Deep dive: homeboy review test data-machine --changed-since 9fff571

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-review-test-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-review-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/30094573746

Audit

✅ review audit — passed

Deep dive: homeboy review audit data-machine --changed-since 9fff571

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-review-audit-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-review-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/30094573746

Refactor

✅ refactor lint — passed

Deep dive: homeboy refactor lint data-machine --changed-since 9fff571

Artifacts and drill-down

• CI results artifact: homeboy-ci-results-data-machine-refactor-lint-quality-Linux-node24 contains immediate command JSON for this action invocation.
• Observation artifact: homeboy-observations-data-machine-refactor-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/30094573746

Tooling versions

• Homeboy CLI: homeboy 0.312.1+60a45c30bc31+5ad0a03e
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: 1cd18d31
• Action: unknown@unknown

[chubes4]

Root cause is independently confirmed and tracked upstream:

• Playground issue: PHP-WASM mysqli_poll does not honor its timeout for a pending async MySQL query WordPress/wordpress-playground#4161
• bounded proof commit: Automattic/wp-codebox@860bff1
• Linux/Docker proof run: https://github.com/Automattic/wp-codebox/actions/runs/30120500876/job/89571652650

The proof removes PHPUnit discovery and the 25-minute Homeboy wrapper. A reachable disposable MySQL service receives a conflicting MYSQLI_ASYNC row-lock query; mysqli_poll(..., 0, 100000) should return 0 after ~100ms but instead remains pending until a 20,001ms outer timeout. The cleanup rejection is secondary and tracked separately in WordPress/wordpress-playground#4160.

This PR remains blocked only on homeboy / Test; its AGENTS.md smoke tests are not the cause.

[chubes4]

Final AGENTS.md scope proof:

• PR diff is limited to inc/Cli/CommandRegistry.php, inc/migrations/agents-md.php, and tests/agents-md-gated-composition-smoke.php.
• tests/Unit/Core/Database/PostIdentityReservations/PostIdentityReservationsTest.php, which contains the independently confirmed mysqli_poll stall, is unchanged from main.
• php tests/agents-md-gated-composition-smoke.php passes all assertions.
• php tests/agents-md-section-ownership-smoke.php passes.
• The coordinated integrated render is 95 lines / 6,822 bytes, down from 212 lines.

The remaining homeboy / Test failure is unrelated baseline/runtime behavior tracked in WordPress/wordpress-playground#4161 and Automattic/wp-codebox#2010; all AGENTS-specific and other Homeboy gates pass.