Skip to content

RFC: Align tool.version optionality across docs and schema #21

@jonathansantilli

Description

@jonathansantilli

The current docs and examples imply tool.version may be absent, but the schema currently treats it as required. That mismatch forces some producers to emit guessed or placeholder values.

Problem

Producers can usually identify the tool name reliably, but not always a stable version for every integration layer. Requiring tool.version in all cases can reduce data quality.

Proposal

  1. Make tool.version optional in the schema.
  2. Keep tool.name required when tool is present.
  3. Ensure examples and descriptions stay aligned with schema behavior.

Why This Should Be Added

  1. It removes pressure to publish inaccurate placeholder versions.
  2. It aligns schema and docs, reducing producer confusion.
  3. It is a minimal change that preserves a compact core spec.

Compatibility

Backward-compatible relaxation. Existing records remain valid; consumers can keep treating tool.version as optional metadata.

Scope

This is a schema/docs consistency improvement for attribution metadata. It does not introduce capture protocol, storage, or transport requirements.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions