docs(cache): write down the producer half of the leftover naming contract #8

Merged
claude merged 4 commits from docs/contract-and-xrefs into main 2026-08-24 19:29:54 +00:00
Showing only changes of commit 1f42064d20 - Show all commits
+3 -2
View File
@@ -29,8 +29,9 @@
# consumer still WALKING the old generation has its entries unlinked out from
# under it, and `cp -al` does not report a subtree that was removed before it
# read the parent's listing. That is a silently truncated clone — the failure
# mode this script's own selftest (scenario 8) reproduces against the
# unguarded version.
# mode seed-target-dir-selftest.sh's scenario 8b reproduces from the consumer's
# side, against the unguarded version. (This script's own selftest also has a
# scenario 8; that one is the abandoned-reader-marker case, not this.)
#
# So the unlink is interlocked with the consume side rather than
# unconditional: after the swap, this script waits for every in-flight reader