Skip to content

Add the PyPI release checklist - #45

Merged
scosman merged 1 commit into
mainfrom
claude/peaceful-clarke-h21dkc
Oct 6, 2026
Merged

scosman merged 1 commit into
mainfrom
claude/peaceful-clarke-h21dkc

Conversation

@scosman

@scosman scosman commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Adds .github/RELEASING.md, the maintainer's checklist for publishing seahaven to PyPI. These are the steps used for the 0.5.0 release.

  1. Bump the version: pyproject.toml, uv lock, the checks, a PR.
  2. Build from a clean main with uv build --no-sources and twine check.
  3. Test the wheel before publishing. A PyPI version is permanent, so this comes before upload. Scaffold a world from the wheel with --find-links/--no-sync, run its tests and seahaven check, call tools in process, drive seahaven serve with SeahavenClient, and connect seahaven mcp to Claude Code.
  4. Publish with uv publish.
  5. Test the release from PyPI by following the README quickstart.
  6. Tag v<version> and draft the GitHub release.

Also:

  • AGENTS.md points to the new page.
  • tests/test_docs.py adds the page to LINKED_PAGES, so its relative links and anchors are checked like CONTRIBUTING.md's. I broke the AGENTS.md#automated-checks anchor on purpose to confirm the test fails.

The page has only sh fences, so test_docs_examples.py executes nothing from it.

Checks

  • ruff format --check, ruff check, ty check (serve split): clean
  • uv run pytest: 2447 passed, 4 skipped, 4 xfailed

🤖 Generated with Claude Code

https://claude.ai/code/session_01UkCSvbssGtXeqthAaZsmmt


Generated by Claude Code

.github/RELEASING.md walks a maintainer through a release: bump the
version, build, test the wheel locally (scaffold, tests, in-process
calls, the OpenEnv server and MCP) before the permanent upload, publish,
test the published package, and tag. AGENTS.md points to it, and the
relative-link test now covers it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UkCSvbssGtXeqthAaZsmmt
@scosman
scosman merged commit 9e89087 into main Oct 6, 2026
3 checks passed
@scosman
scosman deleted the claude/peaceful-clarke-h21dkc branch October 6, 2026 18:07
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