Skip to content

milestone: v1.0.0 — MCP server, docs, release packaging - #13

Merged
SuperElectron merged 3 commits into
mainfrom
staging
Aug 27, 2026
Merged

milestone: v1.0.0 — MCP server, docs, release packaging#13
SuperElectron merged 3 commits into
mainfrom
staging

Conversation

@SuperElectron

Copy link
Copy Markdown
Owner

Staging → main for v1.0.0: MCP server (tools/resources/prompts, sandboxed run_example, BM25 search), README rewrite with generated catalog table + CI drift check, docs pages, wheel that ships the catalog (clean-room verified).

🤖 Generated with Claude Code

SuperElectron and others added 3 commits August 26, 2026 17:37
src/design_patterns_mcp/: MCPServer (mcp 2.x SDK) exposing
- tools: list_patterns, get_pattern, search_patterns, run_example
  (sandboxed), recommend_pattern (caveats + prefer-alternative notes)
- resources: catalog://index, pattern://<group>/<slug>[/<variant>]
- prompts: refactor_toward, explain_pattern, choose_pattern

search.py: pure-stdlib BM25 over frontmatter+prose with field weights.
sandbox.py: catalog-resolved paths only, python -I subprocess, scrubbed
env, temp cwd, 10s timeout, 64KB output caps.

Console script python-design-patterns-mcp (stdio default, --http for
Streamable HTTP). docs/mcp.md documents connection and the sandbox
contract. 228 tests incl. in-memory MCP client integration and sandbox
refusal tests; both transports probed live with initialize round-trips.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
README: minimal and WHY-first for someone scanning the repo on
GitHub — what it is, how to read one unit, one MCP command, then the
catalog table generated from frontmatter (make readme). CI fails if
the table drifts.

docs/: how-to-read-this-repo, verdicts, contributing, index; mcp.md
landed with the server.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
- version 1.0.0
- wheel now packages patterns/ (docs + examples + tests) so the MCP
  server works from an installed distribution, not only a checkout
- find_patterns_root falls back to the installed patterns package
- verified clean-room: fresh venv + wheel -> server answers initialize,
  catalog loads 32 units

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
@SuperElectron
SuperElectron merged commit d105664 into main Aug 27, 2026
6 checks passed
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