From 784e3c17548560419b89c9f92ef2c38bad43f093 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Wed, 7 Oct 2026 19:21:33 +0200 Subject: docs(agents): a branch switch can drop a component until restart Seen merging the island: the shell reloaded while desktop/island/ did not exist, and stayed without it after the fast-forward restored the files. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index a6fb434..2d7c950 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -387,6 +387,13 @@ correct and a fresh `qs` process rendered it. Force the rescan by changing a file that imports the directory (`desktop/shell.qml`), or restart the shell. Touch alone does not reload: the content must change. +Switching git branches under a running shell can drop a component until a +restart. Merging the island branch meant a moment on master without +`desktop/island/`; the shell hot-reloaded then, logged `Ignoring unresolvable +import ".../desktop/island"`, and kept running without the island after the +files came back, because a reappearing directory is not re-indexed. Restart +the affected component after any checkout that adds or removes a directory. + Hot reload does **not** follow a symlink either. Editing `shared/Notify.qml` left both running shells on the old `sanitize`, while an edit to `notifications/NotificationBalloon.qml` in the same pass did reload, so the -- cgit v1.2.3