From 2d740a2b80badbc2dac70911915c67db53e4a28f Mon Sep 17 00:00:00 2001 From: dreevelle <123705989+dreevelle@users.noreply.github.com> Date: Sun, 9 Aug 2026 14:32:53 +0100 Subject: [PATCH] docs: warn that ComfyUI-Manager deletes through a symlinked dev copy The working tree was symlinked into custom_nodes for pre-publish testing. Manager's remove/replace path runs shutil.rmtree on the resolved path, so it deleted the target's contents rather than unlinking the symlink -- wiping this tree, .git included. Recovered by re-cloning; nothing was lost because everything was pushed. Updates the local-environment section to describe the post-publish arrangement (Manager install under the lowercase registry id) and to require tearing down any dev symlink before touching Manager. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01CdgKVDqEbD14EJ4RC3GPmg --- CLAUDE.md | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index f33e59b..94aadd0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,18 +18,25 @@ Registered through ComfyUI's **V3 schema API**, not the legacy - ComfyUI checkout: `/home/dreevelle/comfy/ComfyUI` - Python venv: `/home/dreevelle/comfy-env/bin/python` -- `ComfyUI/custom_nodes/ComfyUI-ResolutionTools` is a **symlink to this working - tree**, so edits are live on the next server restart: +- The package is published, and `ComfyUI/custom_nodes/comfyui-resolution-tools` + (lowercase, the registry id) is a **ComfyUI-Manager install** that tracks + registry releases. This working tree is not wired into ComfyUI. - ```bash - ln -sfn /home/dreevelle/Projects/ComfyUI-ResolutionTools \ - /home/dreevelle/comfy/ComfyUI/custom_nodes/ComfyUI-ResolutionTools - ``` +To test a change before releasing it, symlink this tree in under its CamelCase +name so it doesn't collide with the Manager install: - This is the pre-publish testing setup. Once the package is on the registry, - swap the symlink for an independent clone of the GitHub remote (the - FastImageSequence arrangement) so the installed copy tracks releases rather - than the working tree. +```bash +ln -sfn /home/dreevelle/Projects/ComfyUI-ResolutionTools \ + /home/dreevelle/comfy/ComfyUI/custom_nodes/ComfyUI-ResolutionTools +``` + +**Remove that symlink before doing anything in ComfyUI-Manager for this +package.** Manager's remove/replace path does `shutil.rmtree` on the *resolved* +path, so it deletes the symlink target's contents instead of unlinking — on +2026-08-09 that wiped this working tree, `.git` included, and it had to be +restored by re-cloning. Commit and push before any Manager operation, and never +leave a symlinked dev copy in place while installing or updating the published +version. ## Verifying changes