[tests] Structure agent-driven PHPUnit JSON results

[coisa]

Related Issue

Part of #248

Motivation / Context

• Keep --json and --pretty-json parseable across the DevTools command surface while reducing context consumption for agent-driven runs.
• Reuse the packaged PHPUnit agent reporter instead of maintaining a parallel structured-output integration.
• Normalize command orchestration so JSON-capable runs emit one final document instead of mixing intermediary log records into the output stream.

Changes

• register ergebnis/phpunit-agent-reporter in the packaged phpunit.xml
• force the PHPUnit subprocess into the same reporter path during structured tests runs so DevTools captures a stable nested PHPUnit payload
• expose the structured PHPUnit payload under context.output, preserve prelude text as output.raw_output, and append output.coverage when minimum-coverage validation is active
• suppress intermediary Running... records during structured command runs so --json and --pretty-json emit one final JSON document
• normalize orchestrated subprocess payloads so nested JSON output is decoded instead of surfacing as escaped strings
• simplify command logging to go through generic PSR-3 log() calls and align command tests with the new contract
• move trait-level logger and runtime resolution toward ContainerFactory fallbacks and clean up related command/test plumbing
• remove the redundant ServiceProvider\DevToolsServiceProvider alias wrapper and use the container service-provider namespace directly
• replace the improvised anonymous DevTools object in DevToolsCommandProviderTest with a proper test double stored in ContainerFactory
• update lifecycle handling in UsesContainerFactory to use PHPUnit lifecycle attributes instead of legacy setUpBeforeClass / tearDownAfterClass
• refresh README, testing docs, command docs, and changelog copy to match the final structured-output behavior and guide-only repository support

Verification

• composer dev-tools
• Focused command(s):
  • composer dev-tools tests -- --filter='(DevToolsCommandProviderTest|HasJsonOptionTest|TestsCommandTest|ContainerFactoryTest|FundingCommandTest)'
  • composer dev-tools tests -- --filter='(CodeStyleCommandTest|DependenciesCommandTest|DocsCommandTest|FundingCommandTest|GitAttributesCommandTest|GitHooksCommandTest|GitIgnoreCommandTest|LicenseCommandTest|MetricsCommandTest|PhpDocCommandTest|RefactorCommandTest|ReportsCommandTest|StandardsCommandTest|SyncCommandTest|TestsCommandTest|UpdateComposerJsonCommandTest|WikiCommandTest)'
  • composer dev-tools changelog:check -- --file=CHANGELOG.md --against=origin/main
• Manual verification:
  • confirmed tests --json and tests --pretty-json keep the standard DevTools envelope and surface the bundled PHPUnit reporter payload in context.output
  • confirmed reports --pretty-json emits one final structured document with nested subprocess payloads decoded into structured data

Documentation / Generated Output

• README updated
• docs/ updated
• Generated or synchronized output reviewed

Changelog

• Added a notable CHANGELOG.md entry

Reviewer Notes

• This branch started from the PHPUnit slice of Support colored pretty JSON and structured tool result payloads #248 and then absorbed the supporting work needed to make structured output consistent across orchestrated commands, command logging, documentation, and test infrastructure.
• .github/wiki local preview drift was intentionally kept out of all commits.

[github-actions]

🚀 Preview is available for this pull request.

• Docs: https://php-fast-forward.github.io/dev-tools/previews/pr-329/
• Coverage: https://php-fast-forward.github.io/dev-tools/previews/pr-329/coverage/
• Metrics: https://php-fast-forward.github.io/dev-tools/previews/pr-329/metrics/

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 860f47d77a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 37b5ba1f1b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4a228a21bd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a40c792eb6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 28aba82952

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c5181d6141

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 35380c1c4c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".