refactor: remove package-level caching to support dynamic installation

Remove package-level caching in cnr_utils and node_package modules to enable
proper dynamic custom node installation and version switching without ComfyUI
server restarts.

Key Changes:
- Remove @lru_cache decorators from version-sensitive functions
- Remove cached_property from NodePackage for dynamic state updates
- Add comprehensive test suite with parallel execution support
- Implement version switching tests (CNR ↔ Nightly)
- Add case sensitivity integration tests
- Improve error handling and logging

API Priority Rules (manager_core.py:1801):
- Enabled-Priority: Show only enabled version when both exist
- CNR-Priority: Show only CNR when both CNR and Nightly are disabled
- Prevents duplicate package entries in /v2/customnode/installed API
- Cross-match using cnr_id and aux_id for CNR ↔ Nightly detection

Test Infrastructure:
- 8 test files with 59 comprehensive test cases
- Parallel test execution across 5 isolated environments
- Automated test scripts with environment setup
- Configurable timeout (60 minutes default)
- Support for both master and dr-support-pip-cm branches

Bug Fixes:
- Fix COMFYUI_CUSTOM_NODES_PATH environment variable export
- Resolve test fixture regression with module-level variables
- Fix import timing issues in test configuration
- Register pytest integration marker to eliminate warnings
- Fix POSIX compliance in shell scripts (((var++)) → $((var + 1)))

Documentation:
- CNR_VERSION_MANAGEMENT_DESIGN.md v1.0 → v1.1 with API priority rules
- Add test guides and execution documentation (TESTING_PROMPT.md)
- Add security-enhanced installation guide
- Create CLI migration guides and references
- Document package version management

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

comfyui_manager/data_models/__init__.py

@@ -70,6 +70,7 @@ from .generated_models import (
     InstallType,
     SecurityLevel,
     RiskLevel,
+    NetworkMode
 )
 
 __all__ = [
@@ -134,4 +135,5 @@ __all__ = [
     "InstallType",
     "SecurityLevel",
     "RiskLevel",
+    "NetworkMode",
 ]

comfyui_manager/data_models/generated_models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   timestamp: 2025-07-31T04:52:26+00:00
+#   timestamp: 2025-11-01T04:21:38+00:00
 
 from __future__ import annotations
 
@@ -57,7 +57,12 @@ class ManagerPackInstalled(BaseModel):
         description="The version of the pack that is installed (Git commit hash or semantic version)",
     )
     cnr_id: Optional[str] = Field(
-        None, description="The name of the pack if installed from the registry"
+        None,
+        description="The name of the pack if installed from the registry (normalized lowercase)",
+    )
+    original_name: Optional[str] = Field(
+        None,
+        description="The original case-preserved name of the pack from the registry",
     )
     aux_id: Optional[str] = Field(
         None,
@@ -107,6 +112,12 @@ class SecurityLevel(str, Enum):
     weak = "weak"
 
 
+class NetworkMode(str, Enum):
+    public = "public"
+    private = "private"
+    offline = "offline"
+
+
 class RiskLevel(str, Enum):
     block = "block"
     high_ = "high+"
@@ -155,8 +166,8 @@ class InstallPackParams(ManagerPackInfo):
         description="GitHub repository URL (required if selected_version is nightly)",
     )
     pip: Optional[List[str]] = Field(None, description="PyPi dependency names")
-    mode: ManagerDatabaseSource
-    channel: ManagerChannel
+    mode: Optional[ManagerDatabaseSource] = None
+    channel: Optional[ManagerChannel] = None
     skip_post_install: Optional[bool] = Field(
         None, description="Whether to skip post-installation steps"
     )
@@ -406,9 +417,7 @@ class ComfyUISystemState(BaseModel):
     )
     manager_version: Optional[str] = Field(None, description="ComfyUI Manager version")
     security_level: Optional[SecurityLevel] = None
-    network_mode: Optional[str] = Field(
-        None, description="Network mode (online, offline, private)"
-    )
+    network_mode: Optional[NetworkMode] = None
     cli_args: Optional[Dict[str, Any]] = Field(
         None, description="Selected ComfyUI CLI arguments"
     )
@@ -479,13 +488,13 @@ class QueueTaskItem(BaseModel):
     params: Union[
         InstallPackParams,
         UpdatePackParams,
-        UpdateAllPacksParams,
-        UpdateComfyUIParams,
         FixPackParams,
         UninstallPackParams,
         DisablePackParams,
         EnablePackParams,
         ModelMetadata,
+        UpdateComfyUIParams,
+        UpdateAllPacksParams,
     ]