feat: add PyPI publish workflow, release docs, and project metadata#60
Merged
feat: add PyPI publish workflow, release docs, and project metadata#60
Conversation
There was a problem hiding this comment.
Pull request overview
Adds automated PyPI publishing and release guidance, while updating project metadata to publish under the new weaver-kernel distribution name (issue #37).
Changes:
- Introduces a tag-triggered PyPI publish workflow that gates publishing on the existing CI workflow.
- Adds
RELEASE.mddocumenting the end-to-end release process and Trusted Publisher setup. - Updates
pyproject.toml, README, and changelog to reflect the new PyPI distribution name and additional metadata/extras.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
pyproject.toml |
Renames distribution to weaver-kernel, adds project URLs, and adds mcp/otel optional dependency groups. |
RELEASE.md |
New release process documentation including Trusted Publisher (OIDC) setup steps. |
README.md |
Updates install command to pip install weaver-kernel. |
CHANGELOG.md |
Records unreleased entries for publishing workflow/docs/metadata rename. |
.github/workflows/publish.yml |
New workflow to build and publish on v* tags after CI gating. |
.github/workflows/ci.yml |
Enables reuse via workflow_call so publish workflow can invoke CI as a gate. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
) - Add .github/workflows/publish.yml with Trusted Publisher (OIDC) - Add workflow_call trigger to ci.yml for reuse as publish gate - Add RELEASE.md documenting the full release process - Add [project.urls] to pyproject.toml - Add mcp and otel optional dependency groups - Rename PyPI package to weaver-kernel (Weaver ecosystem alignment) Closes #37
549e5b5 to
eb1ab12
Compare
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
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.
What changed
Implements PyPI publishing automation and release documentation per #37.
New files
.github/workflows/publish.yml— Automated PyPI publish workflow triggered onv*tag push. Usespypa/gh-action-pypi-publishwith OIDC Trusted Publisher (no stored API tokens). Runs the full CI suite as a gate via reusable workflow call before publishing.RELEASE.md— Documents the complete release process: version bump, changelog update, tagging, what CI does, Trusted Publisher one-time setup, and versioning scheme.Modified files
.github/workflows/ci.yml— Addedworkflow_call:trigger sopublish.ymlcan reuse CI as a gate job.pyproject.toml— Renamed PyPI package toweaver-kernel(Weaver ecosystem alignment). Added[project.urls](Homepage, Repository, Documentation, Changelog). Addedmcpandoteloptional dependency groups.README.md— Updatedpip installcommand toweaver-kernel.CHANGELOG.md— Added[Unreleased]entries for all changes.Why
pip installthe package.agent-kernelconflicts with existing PyPI project; renamed toweaver-kernelto align with Weaver ecosystem (weaver-spec,contextweaver,ChainWeaver).How verified
ruff format— 35 files unchangedruff check— only 2 pre-existing UP038 warnings (unrelated to this PR)mypy src/— success, no issues in 20 source filespytest— 201 passed in 1.64s, 96% coverageAcceptance criteria mapping
publish.ymltriggers onv*make cigate prevents publishing broken codeneeds: cireusesci.ymlRELEASE.mddocuments the full release processid-token: write+environment: pypi; manual PyPI-side setup documentedmcpandotelextras addedpip install weaver-kernelworks from PyPINotes
RELEASE.md).git tag v0.2.0 && git push --tagsafter merging.AGENTS.mdreviewed — no updates needed (doesn't reference package name or release workflows).Closes #37