# 2026-07-05

## Ergonomics release chain completed — all three legs shipped

Finished the release topology for the MCP client ergonomics work (#225):

- **Leg 1:** `client/v0.15.0` auto-released from the #225 merge.
- **Leg 2 (#226):** `clientVersion` 0.13.2 → 0.15.0 in
  `tools/demarkus-plugin/internal/provision/provision.go` → auto-released
  `tools/v0.4.1`.
- **Leg 3 (#227):** `TOOLS_VERSION` 0.3.5 → 0.4.1 in all four plugins'
  `bootstrap.sh` (lockstep, shared binary) + patch bumps: demarkus-memory
  0.12.4, demarkus-knowledge 0.5.4, pi-memory 0.12.5, pi-knowledge 0.5.5,
  with CHANGELOG entries for the pi pair. Next session start re-provisions
  demarkus-plugin v0.4.1 → demarkus-mcp v0.15.0; outline mode, #section
  slicing, session dedup, and mark_explore now reach users.

Also fixed in #227: `.claude-plugin/marketplace.json` had been desynced
since #217/#221 (still 0.12.2/0.5.2 while the plugin manifests were at
0.12.3/0.5.3) — the manual repins bumped the manifests but missed the
marketplace. Synced to 0.12.4/0.5.4.

Open observations for later (not blocking):

- The `plugin-pin-bump` workflow's daily runs have reported success since
  07-02 without opening a PR, despite pins being behind released versions
  (client 0.14.0/0.15.0, server 0.19.0, tools 0.4.0/0.4.1 all newer than
  the pins at the time). Either `changed=false` is mis-computed in
  `.github/scripts/bump-plugin-pins.sh` or something in the PR step is
  short-circuiting — worth a debugging pass.
- `serverVersion` pin still 0.18.0 (server/v0.19.0 released 07-02) and
  `fallbackToolsVersion` still 0.3.3 — both deliberately left out of the
  repin PRs to keep them narrow; decide whether to sweep them.

## plugin-pin-bump silent failure: root-caused and fixed

The "workflow succeeds but no PR" mystery from this morning's loose ends:
`gh pr view "$branch"` in the workflow's upsert step resolves closed PRs,
so after #210 was closed unmerged it edited that dead PR daily instead of
creating a new one. Proof: #210 (closed 06-24) carries a title naming
server 0.19.0 (released 07-02) and updatedAt 07-03. Fix on branch
`fix/plugin-pin-bump-closed-pr`: look up an OPEN PR via
`gh pr list --head … --state open` and edit by number, else create.
Verified both paths read-only against the live repo. Gotcha generalized in
/debugging.md.

Once merged, dispatching the workflow will sweep the remaining stale pins
(serverVersion 0.18.0 → 0.19.0, fallbackToolsVersion 0.3.3 → 0.4.1) via a
proper auto PR — closing this morning's second loose end through the
automation instead of another manual repin.