family.py add: #574's spelling remedy gives a generic <new name> after git mv members Members, git rm --cached for a pulled Members/README, and a git mv --sparse that needs git 2.34 or later #685

Goal: every command an add refusal prints can be typed as printed, with the arguments it needs, in the state it describes, on the git the estate supports.

Filed by lane openRepoShape-5 on Brett Heap's word of 2026-10-16T12:17:02Z ("#459's family lines (~38)"), from lane 5's #574 lines on #459 (comment 6192725913). L2-70 (comment 6206387194), the remedies that name bump without --family-root, is a known limit by Brett Heap's word of 2026-10-16T12:14:51Z on lane 2's triage (#473 comment), so it is not here.

Lands after: lane 5's #646 (fix/646-…), which rewrites _spellings_refusal (scripts/family.py:2917) and the REMEDY_ORDER rules for the case where a variant is another member's own gitlink. The three #574 lines below are in the same function.

Lines (line numbers at d4a7fab)

• family.py: add refuses, before the member is read and on every disk, any path under another spelling of members/, in its index, in HEAD or on disk, and names a remedy per entry that never moves the members' checkouts (#362, #363, #364) #574: after git mv members Members, staged or committed, add names the member's gitlink Members/<M> with the generic git mv -- Members/<M> <new name>. Probed on main: git mv members Members, then add --dry-run gives git mv -- Members/IRRS <new name> and git mv -- Members/IRSS <new name>, and the right target, members/<M>, fails as typed until mkdir members. The holder's validator already refuses that state. Direction: where every variant sits under a spelling of members/ that no members/ entry holds, print the rename of the directory itself back (git mv -- Members members), or say the target is members/<M> and mkdir members comes first. Decide with family.py add: where another member's own gitlink sits at a case variant (Members/<P> for its row members/<P>), the refusal's remedy prints git rm -r --cached or git mv, which takes that member's gitlink away from its row #646's treatment of the same function.
• family.py: add refuses, before the member is read and on every disk, any path under another spelling of members/, in its index, in HEAD or on disk, and names a remedy per entry that never moves the members' checkouts (#362, #363, #364) #574: a macOS or Windows holder that pulled a commit adding Members/README is told git rm -r --cached, not a committed git mv. On such a disk the file is on disk as members/README, the other spelling's own directory, but _spellings_refusal offers UNSTAGE for "what has nothing on disk in that spelling" (scripts/family.py:2569-2571, :2976-2978); the file stays untracked at members/README. Benign (committing it afterwards still gives family ok). Reasoned, not run: this host is case-sensitive. Direction: word the remedy for the case-folding disk, or verify on one and close.
• family.py: add refuses, before the member is read and on every disk, any path under another spelling of members/, in its index, in HEAD or on disk, and names a remedy per entry that never moves the members' checkouts (#362, #363, #364) #574: git mv --sparse, the remedy for a skip-worktree entry, needs git 2.34 or later. RENAME_SPARSE = "git mv --sparse" (scripts/family.py:2567, the sentence at :2970-2974). The estate states no minimum git (no git 2. in README.md, AGENTS.md, install.sh or pyproject.toml), and scripts/shape_materialize.py supports git older than 2.32 (commit --trailer, :1951). On such a git the printed line fails unknown option and nothing is damaged. Direction: say "git 2.34 or later" in the sentence, or name the older way (clear the skip-worktree bit, git update-index --no-skip-worktree, then git mv) after probing it.

Overlaps: lane 5's #646 (_spellings_refusal, which holds all three lines, so this lands after it) and #639 (family.py remove functions only). No open PR edits _checked_add_target or _checked_member_id.

Mark the three lines → this issue on #459, and tick them there when this closes.

🤖 Generated with Claude Code