adopt-project.py and update-shape.py: a pinned copy written through a root-kept symlinked directory (.github -> ci) is named in the line-ending block by its link spelling, so the line governs nothing, the clone can write the copy CRLF, and validate-pins.py reports shape-copy-drift after an adoption that said verified #807

Goal: every line #471's line-ending block writes names the path git tracks. A pinned copy that reaches the tree through a root-kept symlinked directory then checks out LF like every other copy, and validate-pins.py passes after an adoption that execute verified.

Filed by lane openRepoShape-1, on Brett Heap's word of 2026-10-17T10:21:32Z, under lane 3's v1.1.1 rule (#473, issuecomment-6216697223). It comes from #530's first rider on #457 (#457, comment, and L4-51 in issuecomment-6217341693).

• adopt-project.py: check finds, and execute refuses before any leg, a kept nested .gitattributes that outranks the root's line-ending rule for a pinned copy, and a root .gitattributes that git add would re-encode (#530) #619 closed adopt-project.py: a nested .gitattributes setting eol or -text for a pinned copy outranks #471's root LF block, so Windows writes CRLF #530 without it. Lane 1's triage D11 moved it to adopt-project.py check: a kept or moved file other than .gitattributes whose blob git add would re-encode passes, and execute ends adopt-lost or dies mounting the legs after both legs are pushed #654.
• adopt-project.py: check asks this machine's git what the split stores for each file the plan keeps or moves and each pinned copy, so one it would store as other bytes no longer passes check and fails after both legs exist (#654) #743 (adopt-project.py check: a kept or moved file other than .gitattributes whose blob git add would re-encode passes, and execute ends adopt-lost or dies mounting the legs after both legs are pushed #654, 66b230ed) fixed the second rider and left this one open. Its "Not in this PR" says why: the question adopt-project.py: check asks this machine's git what the split stores for each file the plan keeps or moves and each pinned copy, so one it would store as other bytes no longer passes check and fails after both legs exist (#654) #743 asks reads what git add stores, and this is the checkout half of the block's own line.

Milestone: v1.1.1, not a regression. Main 31219459, from before #471's block, reports nine shape-copy-drift findings for the same source. A root-kept symlinked directory is a layout #504 accepts (tests/test_adopt_root_symlinks.py), so a real project can reach it.

Line

• The link spelling. The source keeps .github in the root as a symlink to ci/, and has a rule * text=auto eol=crlf.
  • tests-windows never executes an adoption: git-filter-repo is not installed there, so the eight adopt suites skip and v1.0.0's "adopt works on Windows" is unverified #471's block names the pinned copy by its link spelling: /.github/workflows/validate.yml text eol=lf (eol_line, scripts/shape_materialize.py:722).
  • Git tracks the copy as ci/workflows/validate.yml, so that line governs nothing.
  • check and execute exit 0, the clone writes ci/workflows/validate.yml CRLF, and validate-pins.py exits 1 with shape-copy-drift: .github/workflows/validate.yml.
  • A control without the link exits 0.
  • Lane 1 measured this at 1ce4f456, and adopt-project.py: check asks this machine's git what the split stores for each file the plan keeps or moves and each pinned copy, so one it would store as other bytes no longer passes check and fails after both legs exist (#654) #743's writer reproduced it on a5245427.
  • Where git has core.symlinks=false, execute refuses first (adopt-symlinks-off).

Direction

• Name the path git tracks wherever the block is written or read:
  • eol_block_paths' callers;
  • _append_eol_block (scripts/shape_materialize.py:823);
  • _land_the_eol_block (adopt-project.py:12062);
  • _root_attributes (adopt-project.py:8668);
  • update-shape.py's use of extend_eol_block (scripts/shape_materialize.py:757).
• Resolve each pinned copy's path through the root's kept symlinks, the way adopt-project.py: check follows each symlink the plan keeps where the shape writes its files, and execute refuses one the shape cannot write through, or one it writes beneath that git checks out as a file, before any leg exists, so such a link no longer breaks the run after both legs are pushed or has the shape's files written outside the assembly (#183, #178) #504's walk already resolves them, then write the resolved path.
• scripts/repo_shape.py is a pinned shape copy and does not change.
• A source with no symlinked directory gets the same block, byte for byte.

Tests

• End to end with .github -> ci and * text=auto eol=crlf: execute verifies, the clone's ci/workflows/validate.yml is LF, and validate-pins.py exits 0.
• update-shape.py on such a clone extends the block with the tracked spelling.
• Controls:
  • no symlink, where the block is byte-identical to main's;
  • a symlink chain (.github -> l1 -> ci);
  • core.symlinks=false, which is still refused first.

Overlaps: scripts/shape_materialize.py is shared with the scaffold, and lane 3's #792 and lane 5's #731 (#692) edit it as well.

Lane: openreposhape-1 (openRepoShape-1)

🤖 Generated with Claude Code