Skip to content

docs(release): explain package provenance - #361

Open
Mr-Neutr0n wants to merge 2 commits into
openai:mainfrom
Mr-Neutr0n:docs/provenance-version-mapping
Open

docs(release): explain package provenance#361
Mr-Neutr0n wants to merge 2 commits into
openai:mainfrom
Mr-Neutr0n:docs/provenance-version-mapping

Conversation

@Mr-Neutr0n

Copy link
Copy Markdown

Summary

  • document the relationship between the npm package tag, bundled plugin manifest, and Codex runtime dependencies
  • use the Git tree object as the immutable bundled-content identifier
  • explain how to verify package gitHead and integrity metadata, and why external catalog versions must come from runtime release metadata

Fixes #234.

Verification

  • verified the tag, commit, tree, package, and manifest commands against the current checkout
  • pnpm run format passes
  • model generation, diff, secret, burst, title, and repository-preflight checks pass

Signed-off-by: Mr-Neutr0n <harikp2002@gmail.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 12, 2026

@mldangelo-oai mldangelo-oai left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks for addressing #234. The tag-to-commit-to-bundled-tree mapping is useful, and the published 0.1.5 bundle matches its tagged source. Before merging, please distinguish signed provenance verification from registry metadata inspection and document the supported historical releases that do not expose gitHead.

Comment thread sdk/typescript/README.md
Comment thread sdk/typescript/README.md Outdated
Signed-off-by: Mr-Neutr0n <harikp2002@gmail.com>
@Mr-Neutr0n

Copy link
Copy Markdown
Author

Addressed the review: clarified that npm registry metadata is inspection-only, documented signed SLSA verification with npm audit signatures, and named 0.1.0/0.1.1 as the only legacy releases that may omit gitHead. Mr-Neutr0n@29e0bed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document npm package, bundled plugin, and runtime version mapping

2 participants