Skip to content

docs: record clean PyPI quickstart reproduction - #13

Merged
mrcha033 merged 2 commits into
mainfrom
mrcha033/reproduce-the-pypi-quickstart-on-a-clean-platfor
Jul 29, 2026
Merged

docs: record clean PyPI quickstart reproduction#13
mrcha033 merged 2 commits into
mainfrom
mrcha033/reproduce-the-pypi-quickstart-on-a-clean-platfor

Conversation

@mrcha033

Copy link
Copy Markdown
Owner

Summary

  • document a clean-platform reproduction of the published hw-codesign[mcp]==0.1.4 quickstart
  • record the Debian, architecture, Python, pip, and container-image details
  • include the exact Docker command and passing create-project / validate-spec output
  • link the evidence report from the README quickstart

Why

Issue #11 asks for independent, cross-platform evidence that the published package installs and activates a typed rp2040_usb_device project. This report preserves that evidence without expanding the result into a fabrication-readiness claim.

Result

The run used a fresh Debian 13 x86-64 container with CPython 3.11.15 and no repository checkout or host mount. Installation succeeded, project creation returned generated, and validate-spec returned pass with zero errors and warnings. No Linux-specific packaging friction was observed.

Validation

  • disposable Docker reproduction from PyPI: passed
  • uv run --extra dev pytest tests/test_release_metadata.py: 7 passed
  • documentation link and required-field sanity check: passed
  • git diff --check: passed
  • broader regression run: 97 passed with no failures before the long-running suite was manually stopped

Closes #11

mrcha033 and others added 2 commits July 29, 2026 17:04
The wheel smoke test installs the built wheel unlocked, so `mcp>=1.0`
resolved to mcp 2.0.0, which dropped the bundled `mcp.server.fastmcp`
module that `create_server()` imports. `hw-mcp` then exited with the
"Install the MCP extra" RuntimeError before answering `initialize`.

Cap the extra at the 1.x line. The locked resolution is unchanged
(mcp 1.27.2); only the recorded requirement moves.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mrcha033
mrcha033 marked this pull request as ready for review July 29, 2026 08:51
@mrcha033
mrcha033 merged commit 31f95b3 into main Jul 29, 2026
12 checks passed
@mrcha033
mrcha033 deleted the mrcha033/reproduce-the-pypi-quickstart-on-a-clean-platfor branch July 29, 2026 08:51
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.

Reproduce the PyPI quickstart on a clean platform

1 participant