Skip to content

Commit 579132c

Browse files
jpheinclaude
andcommitted
docs: add RELEASING.md with mempalace-mcp pre-release check
Fulfills the "Optional: release-checklist addition" proposal at the bottom of MemPalace#1093 (the v3.3.2 release defect where plugin.json referenced a mempalace-mcp binary that pyproject.toml never declared, so fresh `pip install` was broken for everyone until messelink's MemPalace#340 was re-cut as v3.3.3). New file at docs/RELEASING.md (no existing doc at that path) with a single pre-release grep: grep -rn mempalace-mcp pyproject.toml .claude-plugin .codex-plugin The original MemPalace#1093 proposal specified `pyproject.toml .claude-plugin/plugin.json` (2 files). This expands via -rn directory recursion to also cover `.claude-plugin/.mcp.json` and `.codex-plugin/plugin.json`, which reference `mempalace-mcp` by name too — same class of regression through a different surface. Happy to trim to the narrower 2-file form if preferred; one-line edit. Shows the concrete expected output so a maintainer running this under release pressure can eyeball "pass" without mental translation, and points at MemPalace#340 as the historical fix anchor so "investigate why the entry is missing" has a diagnostic starting point rather than a dead end. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 7a75791 commit 579132c

1 file changed

Lines changed: 31 additions & 0 deletions

File tree

docs/RELEASING.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Releasing MemPalace
2+
3+
## Pre-release checklist
4+
5+
Run from the repo root before cutting a release tag.
6+
7+
### Verify `mempalace-mcp` entry point alignment
8+
9+
The plugin configs reference `mempalace-mcp` as the MCP server command, which
10+
resolves to a `console_script` entry point declared in `pyproject.toml`. If
11+
these disagree, `pip install mempalace` ships a plugin config pointing at a
12+
binary that was never installed — exactly what broke v3.3.2
13+
([#1093](https://github.com/MemPalace/mempalace/issues/1093)).
14+
15+
```bash
16+
grep -rn mempalace-mcp pyproject.toml .claude-plugin .codex-plugin
17+
```
18+
19+
Expected on a healthy `develop` (post-[#340](https://github.com/MemPalace/mempalace/pull/340)):
20+
21+
```
22+
pyproject.toml:41:mempalace-mcp = "mempalace.mcp_server:main"
23+
.claude-plugin/plugin.json:12: "command": "mempalace-mcp"
24+
.codex-plugin/plugin.json:24: "command": "mempalace-mcp"
25+
.claude-plugin/.mcp.json:3: "command": "mempalace-mcp"
26+
```
27+
28+
If `pyproject.toml` has no match, **stop** — the entry point is missing and
29+
any fresh `pip install` will ship a broken plugin config. Investigate whether
30+
the release branch was cut before
31+
[#340](https://github.com/MemPalace/mempalace/pull/340) landed on `develop`.

0 commit comments

Comments
 (0)