docs(standardize-repo): warn that copier update skips renamed files#38
Merged
Merged
Conversation
Two fixes to mode-update.md driven by a real v3.5.0→v3.6.0 update of harmon-infra (every *.yml renamed to *.yaml): - copier update's merge is path-keyed, so it silently leaves renamed templated files untouched while still printing "Updating to version <X>" — the v→v improvements never land. Document the trap and the manual `git diff <old>..<new> -- template/<path>` delta-port, and cross-reference it from the §4 re-diff step. - §3 review command: use `git add -A && git diff HEAD` (not `-A -N`); copier's delete-then-add conflict resolution makes a bare diff render a misleading whole-file rewrite.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Driven by a real-world
copier updateof harmon-infra from harmon-init v3.5.0 → v3.6.0. That repo renamed every*.yml→*.yaml(workflows,Taskfile,lefthook).copier update's three-way merge is keyed on file path, so it left all ~10 renamed files untouched — while still printingUpdating to template version 3.6.0. The v3.6.0 improvements (the verify/ci restructure) silently never landed; only manual delta-porting got them in.Changes to
mode-update.mddiff-template.sh's.yml↔.yamlmapping means such a file shows asDRIFTwhether the gap is a benign extension swap or a missed update, and gives the manual delta-port:git -C ~/git/harmon-init diff <old>..<new> -- template/<path>. harmon-infra called out as the standing example.git add -A && git diff HEAD(notgit add -A -N); copier resolves some conflicts with a delete-then-add (DAin status), which a baregit diffrenders as a misleading whole-file rewrite.Docs-only;
markdownlint-cli2passes on the file.Follow-up
harmon-init carries a vendored copy of this skill — it'll pick this up on the next
chore(skills): re-vendor standardize-reposync.🤖 Generated with Claude Code