Skip to content

feat(spec): extract v0.1.0 spec artifacts#2

Merged
somus merged 4 commits into
mainfrom
somasundaram321/atf-10-atf-11-spec-schema-fixtures
Jun 12, 2026
Merged

feat(spec): extract v0.1.0 spec artifacts#2
somus merged 4 commits into
mainfrom
somasundaram321/atf-10-atf-11-spec-schema-fixtures

Conversation

@somus

@somus somus commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Split frozen v0.1.0 spec prose into section files under spec/v0.1.0/ and mirrored initial draft content under spec/draft/.
  • Added root spec.md compatibility index with legacy anchor aliases pointing at the frozen section files.
  • Published schema artifacts under schema/ and copied the validation fixture corpus under fixtures/validation/.
  • Added non-normative, GitHub-safe Mermaid diagrams and fixture-backed example pointers to the split spec files.
  • Updated the README with the new repository artifact map.

Related Issue

  • ATF-10
  • ATF-11

Public Impact

  • No public contract change
  • Spec or schema change
  • Public package API change
  • CLI behavior change
  • Public URL or docs behavior change

Impact description:

  • Adds extracted spec, schema, and validation fixture artifacts to the spec repository.
  • Adds non-normative explanatory diagrams/examples to both spec/v0.1.0/ and spec/draft/.
  • Does not change schema bytes or fixture contents.

Verification

  • Reassembled spec/v0.1.0 section files and compared them to source spec.md: passed.
  • diff -ru spec/v0.1.0 spec/draft: passed.
  • cmp <source>/schema.json schema/v0.1.0.json: passed.
  • cmp schema/v0.1.0.json schema/draft.json: passed.
  • diff -ru <source>/tests/fixtures/validation fixtures/validation: passed.
  • diff -ru spec/v0.1.0 spec/draft: passed after docs additions.
  • rg -n '^### .*Non-normative|^## .*Non-normative' spec/v0.1.0 spec/draft: no matches.
  • rg -n '```mermaid|```jsonl' spec/v0.1.0 spec/draft: inspected block placement/count.
  • MISE_TRUSTED_CONFIG_PATHS=$PWD mise run check: passed.

Reviewer Notes

  • Persistent schema/AJV/fixture integrity CI is intentionally deferred to ATF-14.
  • Release tarballs and checksums are intentionally deferred to ATF-15.

@coderabbitai

coderabbitai Bot commented Jun 12, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 225 files, which is 75 over the limit of 150.

To get a review, narrow the scope:
• coderabbit review --type committed # exclude uncommitted changes
• coderabbit review --dir # limit to a subdirectory
• coderabbit review --base # compare against a closer base

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 50452e42-ac66-4163-8c97-5d612eb1a47e

📥 Commits

Reviewing files that changed from the base of the PR and between 30b9b51 and 42d960b.

📒 Files selected for processing (225)
  • README.md
  • fixtures/validation/README.md
  • fixtures/validation/hash-mismatch/content-hash-invalid-hex.trail.jsonl
  • fixtures/validation/hash-mismatch/content-hash-mismatch.trail.jsonl
  • fixtures/validation/hash-mismatch/trail-envelope-content-hash-mismatch.trail.jsonl
  • fixtures/validation/hash-vectors/absent-content-hash.trail.jsonl
  • fixtures/validation/hash-vectors/envelope-two-tier.trail.jsonl
  • fixtures/validation/hash-vectors/jcs-stress.trail.jsonl
  • fixtures/validation/hash-vectors/minimal-pending-roundtrip.trail.jsonl
  • fixtures/validation/hash-vectors/multi-session-slice.trail.jsonl
  • fixtures/validation/hash-vectors/replacement-char.trail.jsonl
  • fixtures/validation/hash-vectors/segment-chain-seq1.trail.jsonl
  • fixtures/validation/hash-vectors/segment-chain-seq2.trail.jsonl
  • fixtures/validation/invalid-graph/ambiguous-sequential-pairing-with-session-end.trail.jsonl
  • fixtures/validation/invalid-graph/ambiguous-sequential-pairing.trail.jsonl
  • fixtures/validation/invalid-graph/branch-point-unknown-from-id.trail.jsonl
  • fixtures/validation/invalid-graph/branch-summary-unknown-abandoned-branch-id.trail.jsonl
  • fixtures/validation/invalid-graph/duplicate-id.trail.jsonl
  • fixtures/validation/invalid-graph/duplicate-option-labels-mixed-ids.trail.jsonl
  • fixtures/validation/invalid-graph/duplicate-option-labels.trail.jsonl
  • fixtures/validation/invalid-graph/duplicate-segment-seq.trail.jsonl
  • fixtures/validation/invalid-graph/duplicate-tool-result-for-id.trail.jsonl
  • fixtures/validation/invalid-graph/envelope-not-at-line-1.trail.jsonl
  • fixtures/validation/invalid-graph/envelope-sessions-manifest-empty.trail.jsonl
  • fixtures/validation/invalid-graph/envelope-sessions-manifest-multiple.trail.jsonl
  • fixtures/validation/invalid-graph/envelope-without-session-header.trail.jsonl
  • fixtures/validation/invalid-graph/header-has-parent-id.trail.jsonl
  • fixtures/validation/invalid-graph/multi-session-cross-group-parent.trail.jsonl
  • fixtures/validation/invalid-graph/multi-session-orphan-prelude.trail.jsonl
  • fixtures/validation/invalid-graph/multiple-envelopes.trail.jsonl
  • fixtures/validation/invalid-graph/non-interoperable-number.trail.jsonl
  • fixtures/validation/invalid-graph/non-monotonic-event-ts.trail.jsonl
  • fixtures/validation/invalid-graph/out-of-order-segment-seq.trail.jsonl
  • fixtures/validation/invalid-graph/parent-cycle.trail.jsonl
  • fixtures/validation/invalid-graph/parse-fidelity-drift.trail.jsonl
  • fixtures/validation/invalid-graph/sequential-pairing-stays-in-branch.trail.jsonl
  • fixtures/validation/invalid-graph/sequential-pairing-stays-in-sibling-branch.trail.jsonl
  • fixtures/validation/invalid-graph/sequential-pairing-stays-in-subagent-sibling-branch.trail.jsonl
  • fixtures/validation/invalid-graph/session-end-forward-final-message-id.trail.jsonl
  • fixtures/validation/invalid-graph/session-end-unknown-final-message-id.trail.jsonl
  • fixtures/validation/invalid-graph/stream-open-with-content-hash.trail.jsonl
  • fixtures/validation/invalid-graph/tool-args-unredacted-secret.trail.jsonl
  • fixtures/validation/invalid-graph/tool-call-aborted-turn-scope-does-not-close-call.trail.jsonl
  • fixtures/validation/invalid-graph/tool-result-for-id-wins-over-semantic-conflict.trail.jsonl
  • fixtures/validation/invalid-graph/unknown-parent-id.trail.jsonl
  • fixtures/validation/invalid-graph/unmatched-tool-call-at-eof.trail.jsonl
  • fixtures/validation/invalid-graph/unmatched-tool-call-partial-suppression.trail.jsonl
  • fixtures/validation/invalid-graph/unmatched-tool-call-session-terminated-without-open-call-ids.trail.jsonl
  • fixtures/validation/invalid-graph/user-query-response-unknown-for-id.trail.jsonl
  • fixtures/validation/invalid-schema/agent-message-attachment-bad-uri.trail.jsonl
  • fixtures/validation/invalid-schema/agent-message-usage-extra-field.trail.jsonl
  • fixtures/validation/invalid-schema/agent-message-usage-missing-output.trail.jsonl
  • fixtures/validation/invalid-schema/agent-message-usage-missing-required.trail.jsonl
  • fixtures/validation/invalid-schema/agent-message-usage-zero-context-window.trail.jsonl
  • fixtures/validation/invalid-schema/agent-thinking-usage-missing-output.trail.jsonl
  • fixtures/validation/invalid-schema/capability-change-bad-reason.trail.jsonl
  • fixtures/validation/invalid-schema/capability-change-bad-scope.trail.jsonl
  • fixtures/validation/invalid-schema/capability-change-empty.trail.jsonl
  • fixtures/validation/invalid-schema/command-invoke-bad-kind.trail.jsonl
  • fixtures/validation/invalid-schema/command-invoke-bad-result-action.trail.jsonl
  • fixtures/validation/invalid-schema/command-invoke-missing-kind.trail.jsonl
  • fixtures/validation/invalid-schema/command-invoke-missing-name.trail.jsonl
  • fixtures/validation/invalid-schema/envelope-missing-producer.trail.jsonl
  • fixtures/validation/invalid-schema/header-wrong-schema-version.trail.jsonl
  • fixtures/validation/invalid-schema/redaction-count-non-integer.trail.jsonl
  • fixtures/validation/invalid-schema/segment-seq-1-with-prev-hash.trail.jsonl
  • fixtures/validation/invalid-schema/segment-seq-2-without-prev-hash.trail.jsonl
  • fixtures/validation/invalid-schema/segment-seq-2-without-session-uid.trail.jsonl
  • fixtures/validation/invalid-schema/segment-seq-zero.trail.jsonl
  • fixtures/validation/invalid-schema/session-end-final-message-id-null.trail.jsonl
  • fixtures/validation/invalid-schema/session-metadata-update-bad-field-cwd.trail.jsonl
  • fixtures/validation/invalid-schema/session-metadata-update-bad-reason.trail.jsonl
  • fixtures/validation/invalid-schema/session-metadata-update-bad-tags-value.trail.jsonl
  • fixtures/validation/invalid-schema/session-metadata-update-bad-worktree.trail.jsonl
  • fixtures/validation/invalid-schema/session-uid-not-ulid-or-uuid.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-aborted-bad-reason.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-aborted-tool-scope-missing-for-id.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-aborted-turn-scope-with-for-id.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-file-list-missing-path.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-file-patch-empty-files.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-file-patch-file-missing-diff.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-missing-args-path.trail.jsonl
  • fixtures/validation/invalid-schema/tool-call-usage-missing-output.trail.jsonl
  • fixtures/validation/invalid-schema/tool-result-attachment-extra-field.trail.jsonl
  • fixtures/validation/invalid-schema/tool-result-meta-file-read-range-wrong-length.trail.jsonl
  • fixtures/validation/invalid-schema/tool-result-meta-mcp-call-block-missing-type.trail.jsonl
  • fixtures/validation/invalid-schema/tool-result-meta-shell-command-extra-field.trail.jsonl
  • fixtures/validation/invalid-schema/tool-result-truncated-missing-output-size.trail.jsonl
  • fixtures/validation/invalid-schema/user-message-missing-text.trail.jsonl
  • fixtures/validation/invalid-schema/user-message-non-string-text.trail.jsonl
  • fixtures/validation/invalid-schema/vcs-null-revision-with-empty-branch.trail.jsonl
  • fixtures/validation/invalid-schema/vcs-null-revision-with-head-commit.trail.jsonl
  • fixtures/validation/invalid-schema/vcs-null-revision-without-branch.trail.jsonl
  • fixtures/validation/manifest.json
  • fixtures/validation/manifest.schema.json
  • fixtures/validation/reader-tolerant/capability-change-unknown-payload-field.trail.jsonl
  • fixtures/validation/reader-tolerant/ill-formed-string.trail.jsonl
  • fixtures/validation/reader-tolerant/nested-unknown-payload-field.trail.jsonl
  • fixtures/validation/reader-tolerant/patch-compatible-schema-version.trail.jsonl
  • fixtures/validation/reader-tolerant/reserved-future-event-type.trail.jsonl
  • fixtures/validation/reader-tolerant/tool-result-meta-registered-extra-field.trail.jsonl
  • fixtures/validation/reader-tolerant/unknown-event-type.trail.jsonl
  • fixtures/validation/reader-tolerant/unknown-payload-field.trail.jsonl
  • fixtures/validation/valid/agent-message-attachments-multiple.trail.jsonl
  • fixtures/validation/valid/agent-message-attachments.trail.jsonl
  • fixtures/validation/valid/agent-message-usage.trail.jsonl
  • fixtures/validation/valid/agent-thinking-usage.trail.jsonl
  • fixtures/validation/valid/capability-change-initial-snapshot.trail.jsonl
  • fixtures/validation/valid/capability-change.trail.jsonl
  • fixtures/validation/valid/command-invoke-extension-kind.trail.jsonl
  • fixtures/validation/valid/command-invoke-full.trail.jsonl
  • fixtures/validation/valid/command-invoke-minimal.trail.jsonl
  • fixtures/validation/valid/command-invoke-plugin.trail.jsonl
  • fixtures/validation/valid/command-invoke-result-action-ext.trail.jsonl
  • fixtures/validation/valid/command-invoke-slash.trail.jsonl
  • fixtures/validation/valid/context-compact-provenance-only-ids.trail.jsonl
  • fixtures/validation/valid/context-compact-replaced-message-ids.trail.jsonl
  • fixtures/validation/valid/linear-with-parent-ids.trail.jsonl
  • fixtures/validation/valid/minimal-linear.trail.jsonl
  • fixtures/validation/valid/minimal-with-content-hash.trail.jsonl
  • fixtures/validation/valid/multi-segment-seg1.trail.jsonl
  • fixtures/validation/valid/multi-segment-seg2.trail.jsonl
  • fixtures/validation/valid/multi-session-fork-from-chain.trail.jsonl
  • fixtures/validation/valid/multi-session-two-no-envelope.trail.jsonl
  • fixtures/validation/valid/multi-session-with-envelope.trail.jsonl
  • fixtures/validation/valid/multiple-session-end-events.trail.jsonl
  • fixtures/validation/valid/redaction-count-meta.trail.jsonl
  • fixtures/validation/valid/session-end-final-message-id-references-header.trail.jsonl
  • fixtures/validation/valid/session-end-with-final-message-id.trail.jsonl
  • fixtures/validation/valid/session-header-metadata-base.trail.jsonl
  • fixtures/validation/valid/session-metadata-update-agent-model-default.trail.jsonl
  • fixtures/validation/valid/session-metadata-update-name.trail.jsonl
  • fixtures/validation/valid/session-metadata-update-tags.trail.jsonl
  • fixtures/validation/valid/session-metadata-update-vcs-branch.trail.jsonl
  • fixtures/validation/valid/session-metadata-update-vendor.trail.jsonl
  • fixtures/validation/valid/spec-example-incomplete-session.trail.jsonl
  • fixtures/validation/valid/spec-example-mcp-call.trail.jsonl
  • fixtures/validation/valid/spec-example-synthesized-event.trail.jsonl
  • fixtures/validation/valid/spec-example-tool-call-semantic-pairing.trail.jsonl
  • fixtures/validation/valid/spec-example-tool-result-fallback-pairing.trail.jsonl
  • fixtures/validation/valid/spec-example-tree-abandoned-branch.trail.jsonl
  • fixtures/validation/valid/streaming-finalized-clean.trail.jsonl
  • fixtures/validation/valid/streaming-open.trail.jsonl
  • fixtures/validation/valid/system-event-vcs-commit.trail.jsonl
  • fixtures/validation/valid/tool-call-aborted-closes-call.trail.jsonl
  • fixtures/validation/valid/tool-call-aborted-extension-scope-reason.trail.jsonl
  • fixtures/validation/valid/tool-call-aborted-turn-scope.trail.jsonl
  • fixtures/validation/valid/tool-call-file-list.trail.jsonl
  • fixtures/validation/valid/tool-call-file-patch.trail.jsonl
  • fixtures/validation/valid/tool-call-matched-by-for-id.trail.jsonl
  • fixtures/validation/valid/tool-call-matched-by-semantic-call-id.trail.jsonl
  • fixtures/validation/valid/tool-call-matched-same-parent-siblings.trail.jsonl
  • fixtures/validation/valid/tool-call-matched-sequentially.trail.jsonl
  • fixtures/validation/valid/tool-call-usage.trail.jsonl
  • fixtures/validation/valid/tool-result-attachments-with-mcp-meta.trail.jsonl
  • fixtures/validation/valid/tool-result-attachments.trail.jsonl
  • fixtures/validation/valid/tool-result-for-id-targets-header-falls-through.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-file-read.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-mcp-call.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-shell-command.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-toplevel-vendor-kind.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-unregistered-kind.trail.jsonl
  • fixtures/validation/valid/tool-result-meta-vendor-extension.trail.jsonl
  • fixtures/validation/valid/tool-result-output-size-truncated.trail.jsonl
  • fixtures/validation/valid/unmatched-tool-call-suppressed-by-session-end.trail.jsonl
  • fixtures/validation/valid/unmatched-tool-call-suppressed-by-session-terminated.trail.jsonl
  • fixtures/validation/valid/user-message-origin-injected.trail.jsonl
  • fixtures/validation/valid/user-query-duplicate-labels-with-ids.trail.jsonl
  • fixtures/validation/valid/vcs-unborn-head.trail.jsonl
  • fixtures/validation/valid/with-trail-envelope-all-fields.trail.jsonl
  • fixtures/validation/valid/with-trail-envelope-and-hash.trail.jsonl
  • fixtures/validation/valid/with-trail-envelope.trail.jsonl
  • schema/draft.json
  • schema/v0.1.0.json
  • spec.md
  • spec/draft/01-motivation.md
  • spec/draft/02-goals-and-non-goals.md
  • spec/draft/03-at-a-glance.md
  • spec/draft/04-terminology.md
  • spec/draft/05-file-format.md
  • spec/draft/06-versioning.md
  • spec/draft/07-identity-artifacts-and-content-addressing.md
  • spec/draft/08-the-trail-envelope.md
  • spec/draft/09-the-session-header.md
  • spec/draft/10-events.md
  • spec/draft/11-canonical-tool-taxonomy.md
  • spec/draft/12-vendor-extensions.md
  • spec/draft/13-tree-and-branching.md
  • spec/draft/14-canonical-agent-registry.md
  • spec/draft/15-truncation-overflow-and-raw-source-size.md
  • spec/draft/16-redaction.md
  • spec/draft/17-security-considerations.md
  • spec/draft/18-validation.md
  • spec/draft/19-formal-schema.md
  • spec/draft/20-examples.md
  • spec/draft/README.md
  • spec/draft/appendix-a-minimal-valid-record.md
  • spec/draft/appendix-b-content-hash-worked-example.md
  • spec/draft/changelog.md
  • spec/draft/license.md
  • spec/v0.1.0/01-motivation.md
  • spec/v0.1.0/02-goals-and-non-goals.md
  • spec/v0.1.0/03-at-a-glance.md
  • spec/v0.1.0/04-terminology.md
  • spec/v0.1.0/05-file-format.md
  • spec/v0.1.0/06-versioning.md
  • spec/v0.1.0/07-identity-artifacts-and-content-addressing.md
  • spec/v0.1.0/08-the-trail-envelope.md
  • spec/v0.1.0/09-the-session-header.md
  • spec/v0.1.0/10-events.md
  • spec/v0.1.0/11-canonical-tool-taxonomy.md
  • spec/v0.1.0/12-vendor-extensions.md
  • spec/v0.1.0/13-tree-and-branching.md
  • spec/v0.1.0/14-canonical-agent-registry.md
  • spec/v0.1.0/15-truncation-overflow-and-raw-source-size.md
  • spec/v0.1.0/16-redaction.md
  • spec/v0.1.0/17-security-considerations.md
  • spec/v0.1.0/18-validation.md
  • spec/v0.1.0/19-formal-schema.md
  • spec/v0.1.0/20-examples.md
  • spec/v0.1.0/README.md
  • spec/v0.1.0/appendix-a-minimal-valid-record.md
  • spec/v0.1.0/appendix-b-content-hash-worked-example.md
  • spec/v0.1.0/changelog.md
  • spec/v0.1.0/license.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch somasundaram321/atf-10-atf-11-spec-schema-fixtures

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@stage-review

stage-review Bot commented Jun 12, 2026

Copy link
Copy Markdown

Ready to review this PR? Stage has broken it down into 5 individual chapters for you:

Title
1 Update repository map and publish schemas
2 Extract frozen v0.1.0 specification content
3 Initialize draft specification content
4 Add legacy link compatibility index
5 Add validation fixture corpus
Open in Stage

Chapters generated by Stage for commit 42d960b on Jun 12, 2026 5:32pm UTC.

@somus somus merged commit 137862b into main Jun 12, 2026
2 checks passed
@somus somus deleted the somasundaram321/atf-10-atf-11-spec-schema-fixtures branch June 13, 2026 10:04
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.

1 participant