Summary

• Adds a second blockquote after the install block (stacked on docs(install): add mm --version verify + --refresh hint for PyPI cache lag #393) in all three first-touch docs that surfaces the mm: command not found failure text and points at uv tool update-shell as the fix.
• No code changes. 3 files, 6 lines added (2 per file).

Stacked on #393 — base branch is docs/install-refresh-cache-lag. Merge #393 first, then retarget or rebase this onto main.

Closes #392.

Why

uv tool install writes the mm shim to ~/.local/bin (macOS/Linux default), but that directory isn't on $PATH in a fresh shell profile. uv itself prints a one-line "run uv tool update-shell" hint on the first-ever tool install, but it's easy to scroll past, and the wizard flow the docs lead into (mm init right after install) will fail with mm: command not found before the user connects the dots.

Before this PR, a grep across README.md + packages/memtomem/README.md + docs/ for update-shell, command not found, and not on .+PATH returned 0 hits.

The #393 change added mm --version as the verify step, which is exactly the command that surfaces command not found on a broken PATH — so this blockquote is the natural extension of that verify step for the failure case.

Reproducibility note

On this author's machine, which mm resolves because ~/.local/bin is already on $PATH (prior uv tool install history). Reproducing the command not found path requires a shell profile without ~/.local/bin, which is the default on macOS; I've left a live-repro out of scope for this session. Evidence is the docs gap (0 mentions, verified above) and the well-known uv behavior on fresh profiles.

Test plan

• uv tool update-shell is a documented uv command (uv tool update-shell --help).
• ~/.local/bin is the default XDG_BIN_HOME uv writes to on macOS/Linux.
• The failure text mm: command not found is the exact shell error a user would see, so it's searchable / skimmable.
• No lint/test failures expected — docs-only, no code paths touched.
• Reviewer: render the three pages and check the two blockquotes read well sequentially (cache-lag → PATH).

Scope

Out of scope (separate issues / PRs):

• PyPI cache lag — docs/install: document --refresh for PyPI cache lag affecting first-time installs #390 / docs(install): add mm --version verify + --refresh hint for PyPI cache lag #393 (stacked base).
• [all] extras primary-install choice — docs/install: primary install command omits [all] extras — decide include vs justify #391.

🤖 Generated with Claude Code