docs(cache): producer half of the depended-upon names contract (#11)

Co-authored-by: Claude <claude@gitdan.com> Co-committed-by: Claude <claude@gitdan.com>
2026-08-24 23:03:29 +00:00
parent a9e9190e5a
commit df6f1b91fb
3 changed files with 51 additions and 0 deletions
@@ -165,6 +165,14 @@ runs:
    # touched unconditionally every run: a run that hits the cache for every
    # crate may write nothing at all inside the tree, which would make a
    # just-used directory look stale to the eviction pass.
+    #
+    # `.cache-last-used` IS A CROSS-REPO CONTRACT NAME with daniel/gitdan's
+    # `scripts/ci-cache-reclaim.sh`, which reads this exact marker for its own
+    # LRU ordering and to recognise a directory as a cache dir at all. Rename
+    # it here without a matching change there and that script silently falls
+    # back to directory mtime for both — see README.md's "Scratch names in a
+    # cache root" section and the `DEPENDED-UPON NAMES CONTRACT` block in
+    # gitdan's script.
    - shell: bash
      run: |
        set -euo pipefail