Complete native Docs Agent package coverage

[chubes4]

Summary

• Add native Agents API runtime packages for User Docs bootstrap and maintenance plus Skills maintenance.
• Correct each native package provenance to the immutable Docs Agent commit that contains it; no package claims the earlier v0.3.0 release.
• Add a real Agents API import compatibility test that imports all five package files through wp_agent_import_runtime_bundles(), verifies native registration and the imported workspace-write gate, and resolves every package through the default native chat handler.
• Add the Docs Agent Tests pull-request and push gate, which runs structural validation, link repair, and the native importer test against a pinned public Agents API commit.
• Keep consumer workflows and legacy bundle files unchanged pending the executable-runner dependency.

Related

• Refs Complete native cutover and remove the legacy Data Machine path #117
• Depends on Make run-agent-task execute the native Agents API contract wp-codebox#1750

How to test

1. Check out this PR branch in Automattic/docs-agent.
2. Run php tests/validate-docs-agent-bundle.php and confirm it reports Docs Agent bundle validation passed.
3. Run php tests/repair-docs-links-smoke.php and confirm it reports Docs link repair smoke test passed.
4. Clone https://github.com/Automattic/agents-api.git, check out 5addf598167ec17821954b0f9aa3a9b160b7e36e, then run AGENTS_API_DIR=/path/to/agents-api php tests/native-agent-import.php. Confirm all 36 Docs Agent native package import assertions pass. The test uses Agents API's maintained pure-PHP harness, invokes the real importer and default chat handler, and intentionally stops before a model turn because provider/model selection belongs to the caller.
5. Open or update the pull request and confirm the Docs Agent Tests check runs these same three commands. The gate checks out Docs Agent at the event SHA and the public Agents API source at 5addf598167ec17821954b0f9aa3a9b160b7e36e; the external checkout uses the workflow's explicitly read-only github.token and read-only workflow permissions.

AI assistance

• AI assistance: Yes
• Tool(s): OpenAI GPT-5.6 Terra via OpenCode; OpenAI GPT-5.6 Sol via OpenCode (earlier package coverage)
• Used for: Implemented and verified the native package coverage, provenance correction, importer integration test, and CI gate under human direction.