Skip to content

Clarify v0.4 extension event namespaces and draft governance - #8

Merged
pramodbn27 merged 2 commits into
mainfrom
agent/spec-v04-extension-names
Aug 8, 2026
Merged

Clarify v0.4 extension event namespaces and draft governance#8
pramodbn27 merged 2 commits into
mainfrom
agent/spec-v04-extension-names

Conversation

@pramodbn27

Copy link
Copy Markdown
Contributor

What changed

This PR tightens the v0.4 draft schema and updates the surrounding spec docs to match.

It includes:

  • a dedicated extension_name definition in specification/v0.4/schemas/common.schema.json
  • event_name support for either:
    • canonical aiops.* names, or
    • reverse-domain namespaced extension events
  • an explicit rule that extension names must not collide with the aiops namespace
  • new valid and invalid v0.4 fixtures covering extension-event behavior
  • test updates so the canonical aiops.* catalog remains checked against v0.3 semantic conventions
  • README / ROADMAP / CONTRIBUTING clarifications around:
    • vendor-neutrality still being an intended end state rather than a closed acceptance gate
    • draft snapshot tagging expectations
    • non-normative future work around OTel GenAI bindings

Why it changed

The schema already supported extension objects, but the event-name boundary between canonical AIOS events and third-party extension events was still under-specified.

That left two important ambiguities for implementers:

  • what shape a valid extension event name should have
  • whether a producer could mint custom names that collide with the reserved aiops namespace

This PR makes that boundary explicit and testable.

Impact

Independent producers and consumers now have a clearer rule:

  • canonical reviewed names stay under aiops.*
  • extension events must use reverse-domain namespacing and must not begin with aiops

That improves interoperability without claiming that v0.4 is frozen or stable.

Commit structure

  1. Define extension event namespaces in v0.4 schema
  2. Clarify spec governance and draft tagging

Validation

Ran from the branch tip:

./.venv/bin/pytest

Results:

  • pytest passed (20 tests)

Notes

  • This PR is intentionally framed as a draft-spec clarification, not a package release bump.
  • pyproject.toml remains at 0.1.0, which is consistent with the repository still being a pre-release draft specification rather than a frozen milestone release.
  • Opened as a draft PR to make it easy to review the schema rule and fixture changes before finalizing wording.

@pramodbn27
pramodbn27 marked this pull request as ready for review August 8, 2026 09:26
@pramodbn27
pramodbn27 requested a review from a team as a code owner August 8, 2026 09:26

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: dd1643bbd9

ℹ️ 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".

Comment thread specification/v0.4/schemas/common.schema.json
@pramodbn27
pramodbn27 merged commit d0a3adb into main Aug 8, 2026
5 checks passed
@pramodbn27 pramodbn27 self-assigned this Aug 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants