Skip to content

Run the scaffold's serve command with its extra - #46

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

Found while testing the live 0.5.0 release from PyPI.

A world made by seahaven new has a README.md and an AGENTS.md that say to serve it with uv run seahaven serve. The next steps seahaven new prints say uv sync, which installs no extras, so that command fails:

seahaven serve needs the serve extra: pip install "seahaven[serve]"

Both templates now say uv run --extra serve seahaven serve, which matches the framework README. I ran that command against a live 0.5.0 scaffold, and it serves.

Test

test_the_scaffold_docs_run_each_server_with_its_extra reads every `uv run …` command in the scaffold's README.md and AGENTS.md. It fails if a seahaven serve or seahaven mcp command lacks its --extra. It also fails if it finds no server command at all, so the test can't pass by checking nothing. With the template fix reverted, it fails with 'uv run seahaven serve' lacks --extra serve.

Checks

  • ruff format --check, ruff check, ty check (serve split): clean
  • uv run pytest (serve): 2448 passed, 4 skipped, 4 xfailed
  • tests/test_cli_new.py in the mcp environment: passes

The fix reaches users in the next release, because the templates ship in the wheel.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UkCSvbssGtXeqthAaZsmmt


Generated by Claude Code

A new world's README.md and AGENTS.md said `uv run seahaven serve`. The
next steps `seahaven new` prints say `uv sync`, which installs no extra,
so that command failed with "seahaven serve needs the serve extra". Both
now say `uv run --extra serve seahaven serve`, the form the framework
README already uses.

The new test reads every `uv run` command in the scaffold's docs and
fails on a `seahaven serve` or `seahaven mcp` without its extra.

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