From 1c9dfe96b2f11c20ea3c00314abe9dc694d00050 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Fri, 23 Oct 2026 15:54:20 +0200 Subject: agents: a shell.qml edit can fail on a type it did not touch Twice in one session an edit adding an import to desktop/shell.qml hot-reloaded into "UdtModule is not a type" and then "SunsetModule is not a type", both existing appearance modules a fresh process resolved. Recorded so the next one is met with a restart, not a debugging session. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md index c26ff7d..9626e58 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -499,6 +499,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. +Changing `desktop/shell.qml` can fail on a type it did not touch. Twice in +one session, an edit adding an import to it hot-reloaded into `Failed to +load configuration`, `UdtModule is not a type` and then `SunsetModule is +not a type`, both existing modules in `modules/appearance/` that a fresh +process resolved fine. The old config kept running; `./reload.sh desktop` +loaded the new one cleanly. Expect a restart after any `shell.qml` edit. + 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 -- cgit v1.2.3