docs(migrating-hermes): note partial-apply guard introduced by 8bdfa58cbb

Trace to 8bdfa58cbb (fix(migrations): avoid partial Hermes config apply after
conflict). Hermes apply now marks remaining dependent config items as
"blocked by earlier apply conflict" when a conflict surfaces mid-apply,
instead of writing them partially. Document the user-visible reason string
and where to find blocked items in the migration report.
This commit is contained in:
Vincent Koc
2026-04-27 01:38:37 -07:00
parent f97cc58760
commit 231eb7b52a

View File

@@ -130,6 +130,8 @@ Rerun with `--overwrite` only when replacing the existing target is intentional.
For a fresh OpenClaw install, conflicts are unusual. They typically appear when you re-run the import on a setup that already has user edits.
If a conflict surfaces mid-apply (for example, an unexpected race on a config file), Hermes marks remaining dependent config items as `skipped` with reason `blocked by earlier apply conflict` instead of writing them partially. The migration report records each blocked item so you can resolve the original conflict and rerun the import.
## Secrets
Secrets are never imported by default.