fix: installer saves every copy under backups/, switches layout only on first install, README notes

Co-Authored-By: Ovis Fast (Claude) <[email protected]>
This commit is contained in:
FactorandOvis Fast committed 2026-11-19 12:59:44 +01:00
1 parent df4605bac1
commit 48779cb930
2 files changed
+104 -46

No files matched your search

+15 -8
View File
@@ -36,14 +36,21 @@ The installer:
- pulls the repo (`git pull --ff-only`, only when it is a clean clone; a failure is a warning);
- **copies** the mod to `~\.config\herdr-app\mods\herdr-composer` (a mirror) and the
layout to `layouts\herdr-composer.json`, so Herdr loads the new files by itself;
- merges `keys.json` of the package into yours (a backup is kept once as
`keys.json.bak-herdr-composer`; a key you bind to something else is left alone, with a warning);
layout to `layouts\herdr-composer.json`, so Herdr loads the new files by itself (a layout that
is already there and differs is saved first; an identical one is left alone);
- merges `keys.json` of the package into yours. **The installer rewrites `keys.json`**: the
formatting changes (indentation, line breaks), the meaning does not. A copy is saved first, and a
key you bind to something else is left alone, with a warning;
- clears away the earlier version, `ovis-composer` (a junction is unlinked, a directory or
layout is moved to a `.bak-<date>` copy, its key is removed) - your history, favourites,
drafts and queue are kept: the mod reads what the earlier version stored;
- runs `herdr-app check` on the mod and switches to the `herdr-composer` layout
(without `herdr-app` on the PATH these two are warnings, not errors).
layout is moved out, its key is removed) - your history, favourites, drafts and queue are
kept: the mod reads what the earlier version stored;
- runs `herdr-app check` on the mod and switches to the `herdr-composer` layout - on the first
install, or when the earlier `ovis-composer` layout was the shown one; otherwise it only says
how to switch (`ctrl-shift-l`). Without `herdr-app` on the PATH these are warnings, not errors.
Every copy the installer makes (the earlier mod, layouts, `keys.json`) goes to
`~\.config\herdr-app\backups\herdr-composer\<yyyyMMdd-HHmmss>\`, never next to the originals:
Herdr loads whatever it finds in `mods\` and `layouts\`, so a backup left there would be loaded.
Files of this repo are never deleted.
@@ -59,7 +66,7 @@ install.cmd -Uninstall
```
Removes `mods\herdr-composer`, `layouts\herdr-composer.json` and its key from `keys.json`, and
switches to the `main` layout. Only `.bak` copies stay.
switches to the `main` layout. Only the copies in `backups\herdr-composer\` stay.
## Develop