Repository navigation
docs: align with AIOS v0.6.1 provenance records and conformance suite - #35
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
🟡 Changes recommended
A moderate finding remains: links in docs/aios-0.6.1.md, README.md, and ROADMAP.md point to the nonexistent v0.6.1 tag of ai-operations-spec (404), so merging before that tag is published would ship dead links.
1 open issue
What changed in this PR
This PR updates the documentation to match AIOS v0.6.1 (the AI Operations Specification). It adds a compatibility page for the new 0.6-draft provenance records, the portable conformance suite, and the naming conventions. It also adds short pointers to that page in the README and ROADMAP. Exports and contracts stay at 0.4-draft, and no dependency or package release is involved.
Changes:
- Adds
docs/aios-0.6.1.md, which explains the v0.6.1 drafts, what stays unchanged, and how Evals relates to provenance records. - Adds an "AIOS v0.6.1 provenance and conformance suite" section to the README and ROADMAP that links to the new page.
| File | Description |
|---|---|
| ROADMAP.md | Adds a section that links to the new AIOS v0.6.1 compatibility page. |
| README.md | Adds a matching section that links to the new AIOS v0.6.1 compatibility page. |
| docs/aios-0.6.1.md | New compatibility page describing the v0.6.1 drafts, the unchanged v0.4 contracts, and the Evals position. |
Review effort: Lite
| - [provenance records](https://github.com/DeepAgentLabs/ai-operations-spec/blob/v0.6.1/specification/v0.6/provenance.md): a | ||
| `spec_version: "0.6-draft"`, `artifact_type: "provenance"` companion artifact | ||
| with subjects, source references, derived findings and evidence lineage; | ||
| - a [portable conformance suite](https://github.com/DeepAgentLabs/ai-operations-spec/tree/v0.6.1/specification/v0.6/conformance-suite) | ||
| with expected outcomes and rule citations; | ||
| - [naming conventions](https://github.com/DeepAgentLabs/ai-operations-spec/blob/v0.6.1/specification/v0.6/naming-conventions.md). |
There was a problem hiding this comment.
The v0.6.1 tag is now published (https://github.com/DeepAgentLabs/ai-operations-spec/releases/tag/v0.6.1) and this PR is merged only after it, so the links resolve. No change needed.
Documentation-only alignment with DeepAgentLabs/ai-operations-spec#36 (AIOS repository v0.6.1):
0.6-draftprovenance records, the portable conformance suite and naming conventions.0.4-draft/native; no dependency change or release.v0.6.1tag, which is created when the spec PR merges.