docs(ocsf): sync the ai_tool draft to the head of ocsf-schema#1729 - #554
Merged
Merged
Conversation
The local PR-shaped draft in docs/ocsf-ai-tool-object-draft/ predated the 2026-09-10 review round on ocsf/ocsf-schema#1729, which added two fingerprint-typed attributes to the object: - desc_fingerprint: the model-visible description presented at discovery, by reference, so description poisoning (text changes, schema does not) is detectable. - baseline_fingerprint: the contract fingerprint recorded at approval time, carried as a value so a consumer can diff it against what was presented at invocation. objects/ai_tool.json is now the PR head (efd60d1) verbatim, including the "In the case of 'Other'" sentences on the source and type siblings. dictionary-additions.json carries both new entries. example-event.json shows both. proposal.md gains the two table rows, a justification bullet, and a header note; README.md gains a sync-status line and decision-log item 9; the worked example notes that no shape it uses changed. ocsf-schema.patch was regenerated against upstream main (dictionary.json, profiles/ai_operation.json, objects/ai_tool.json) and verified with git apply --check in a scratch checkout of those files. Docs only, no product impact. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014c1RBLy2Kiinj7QnLCNi7N
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Owner
Author
|
CI on this head: every GitHub Actions check is green (Python Lint and Test, Public repo no confidential material, CodeQL x3, Vercel Preview Comments). The one red mark is the commit status "Vercel - dashboard", and it is not this PR's.
Standing down on that status only. This PR is docs-only and otherwise green; I will keep re-checking it. Generated by Claude Code |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The PR-shaped draft in
docs/ocsf-ai-tool-object-draft/predated the 2026-09-10 review round on ocsf/ocsf-schema#1729, where saputkin proposed and Jeff accepted twofingerprint-typed attributes onai_tool. Commitefd60d1onLevaj2000:issue-1728-v2landed them. This syncs the local copy to that head.objects/ai_tool.json: the PR head verbatim. Addsdesc_fingerprint(the model-visible description presented at discovery, by reference, for description-poisoning detection) andbaseline_fingerprint(the approval-time contract fingerprint, carried as a value so a consumer can diff against what was presented at invocation). Also picks up the "In the case of 'Other'" sentences on thesourceandtypesiblings.dictionary-additions.json: both new entries, from the PR head'sdictionary.json.example-event.json: both fields shown.proposal.md: two table rows, a justification bullet, a header note.README.md: sync-status line and decision-log item 9.worked-example-codex-timeline.md: a note that the head moved and no shape it uses changed.ocsf-schema.patch: regenerated against upstreammain(2026-09-14) for the three touched files.CHANGELOG.md: Unreleased / Changed entry.Standards work: hand-back, not autonomous merge, per AGENTS.md.
Verification
git apply --checkof the regenerated patch against a scratch checkout of upstreammain'sdictionary.jsonandprofiles/ai_operation.json: applies cleanly. The previous patch also still applied; the new one differs only by the two added dictionary entries and the eight added object lines.LC_ALL=C grep '[^[:print:][:space:]]'over the added lines of the diff: no matches). The three markdown files carry pre-existing non-ASCII punctuation that this PR does not touch.ruff check .:All checks passed!ruff format --check .:49 files already formattedpytest -qfrom the repo root:160 passed in 0.64s(after installinghttpx,cryptographyandcffi, which the container lacked and CI installs).Docs only, no product impact.
🤖 Generated with Claude Code
https://claude.ai/code/session_014c1RBLy2Kiinj7QnLCNi7N