Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -53,14 +53,14 @@ jobs:
uses: actions/checkout@v6.0.3
with:
repository: Automattic/docs-agent
ref: a39d9db230eb9e0b72ed84465f4d61bd8dda1bab
ref: d1bf324154b4604099ae3209f64519386caf1f48
path: .docs-agent-producer

- name: Checkout WP Codebox producer schema
uses: actions/checkout@v6.0.3
with:
repository: Automattic/wp-codebox
ref: 12a5bb19a97b89d0a78b502fc71adede5b122359
ref: 0227ca7551d8cd98f14242b31e142b50f78dff13
path: .wp-codebox-producer

- name: Set up PHP
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/docs-agent.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ concurrency:
jobs:
docs-agent:
name: Maintain Technical Documentation
uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@a39d9db230eb9e0b72ed84465f4d61bd8dda1bab
uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@d1bf324154b4604099ae3209f64519386caf1f48
with:
audience: technical
run_kind: maintenance
Expand Down
10 changes: 5 additions & 5 deletions docs/docs-agent-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Agents API publishes its canonical documentation updates through the repository-
The consumer workflow is named **Docs Agent** and dispatches the reusable Docs Agent workflow from Automattic/docs-agent at the exact pinned revision:

```text
Automattic/docs-agent/.github/workflows/maintain-docs.yml@a39d9db230eb9e0b72ed84465f4d61bd8dda1bab
Automattic/docs-agent/.github/workflows/maintain-docs.yml@d1bf324154b4604099ae3209f64519386caf1f48
```

The workflow contract is intentionally narrow:
Expand All @@ -33,21 +33,21 @@ DOCS_AGENT_DIR=/path/to/docs-agent WP_CODEBOX_DIR=/path/to/wp-codebox php tests/

The required producer checkouts are:

- Docs Agent revision `a39d9db230eb9e0b72ed84465f4d61bd8dda1bab`.
- WP Codebox reusable-workflow producer revision `12a5bb19a97b89d0a78b502fc71adede5b122359`; packaged runtime release `v0.12.29` resolves to `bc982947ec33c78160125026e16d357b7ece3ea1`.
- Docs Agent revision `d1bf324154b4604099ae3209f64519386caf1f48`.
- WP Codebox reusable-workflow producer revision `0227ca7551d8cd98f14242b31e142b50f78dff13`; packaged runtime release `v0.12.29` resolves to `bc982947ec33c78160125026e16d357b7ece3ea1`.

At that Docs Agent revision, the `technical:maintenance` lane maps to the native package:

```text
bundles/technical-docs-agent/native/technical-docs-maintenance-agent.agent.json
```

with agent slug `technical-docs-maintenance-agent`, package-source revision `85f0d162a7d499fdc1286891371342727d084c88`, package digest `sha256-bytes-v1:975c7b0a0a7aff52897c52be5ac903a7fb110ea3c33e16227f8694c74c932519`, and `lane_requires_pr=false`.
with agent slug `technical-docs-maintenance-agent`, package-source revision `a39d9db230eb9e0b72ed84465f4d61bd8dda1bab`, package digest `sha256-bytes-v1:975c7b0a0a7aff52897c52be5ac903a7fb110ea3c33e16227f8694c74c932519`, and `lane_requires_pr=false`.

Docs Agent then calls WP Codebox's reusable workflow:

```text
Automattic/wp-codebox/.github/workflows/run-agent-task.yml@12a5bb19a97b89d0a78b502fc71adede5b122359
Automattic/wp-codebox/.github/workflows/run-agent-task.yml@0227ca7551d8cd98f14242b31e142b50f78dff13
```

The contract test verifies that this WP Codebox producer exposes the `wp-codebox/reusable-workflow-interface/v1` schema and preserves the release, external-package, runtime-source, target repository, writable path, verification, drift-check, publication, access-repository, and allowed-repository chain. The completion contract requires one evidence-backed report item for the `workflow-run-awaiter` source delta and rejects a no-change disposition until that known drift is documented. WP Codebox returns the reviewer-safe result projection and stages the validated completion report as a declared command artifact.
Expand Down
4 changes: 2 additions & 2 deletions tests/docs-agent-native-workflow-contract.php
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@

declare( strict_types=1 );

const AGENTS_API_DOCS_AGENT_REVISION = 'a39d9db230eb9e0b72ed84465f4d61bd8dda1bab';
const AGENTS_API_DOCS_AGENT_REVISION = 'd1bf324154b4604099ae3209f64519386caf1f48';
const AGENTS_API_WP_CODEBOX_RELEASE_REF = 'v0.12.29';
const AGENTS_API_WP_CODEBOX_PRODUCER_REVISION = '12a5bb19a97b89d0a78b502fc71adede5b122359';
const AGENTS_API_WP_CODEBOX_PRODUCER_REVISION = '0227ca7551d8cd98f14242b31e142b50f78dff13';

$root = dirname( __DIR__ );
$failures = array();
Expand Down