Fix RAG CLI plugin marketplace cache error

[ItMeDiaTech]

Resolves EPERM permission denied errors during marketplace cache finalization on Windows by preventing file handle locks from lifecycle hooks.

Root Cause:

• Lifecycle hooks imported modules that initialized PathResolver singleton
• PathResolver checked marketplace cache directory and held file references
• Python kept file handles open after hook completed
• Windows prevented marketplace directory rename due to open handles

Changes:

1. Skip marketplace during lifecycle hooks (path_resolver.py, path_utils.py)

   • Added CLAUDE_LIFECYCLE_HOOK environment variable check
   • Skip marketplace directory when variable is "true"
   • Prevents PathResolver from locking marketplace cache

2. Set environment variable in lifecycle config (lifecycle.json)

   • All hooks (post_install, pre_update, post_update) set CLAUDE_LIFECYCLE_HOOK=true
   • Signals to path resolution to avoid marketplace cache

3. Remove module imports from verification (installer.py)

   • Removed imports that triggered PathResolver initialization
   • Verification now only checks directory structure
   • Module imports verified at runtime instead of install time

4. Explicit resource cleanup (installer.py, updater.py)

   • Added cleanup_resources() function to both modules
   • Forces garbage collection to release file handles
   • Clears PathResolver singleton instances
   • Runs in finally block to ensure execution

5. Added CLAUDE_PLUGIN_ROOT support (path_resolver.py)

   • PathResolver now checks CLAUDE_PLUGIN_ROOT environment variable
   • Ensures hooks use installation directory, not marketplace cache

Impact:

• Marketplace installation now completes without permission errors
• No warnings about "Failed to finalize marketplace cache"
• All functionality preserved

Files Modified:

• .claude-plugin/lifecycle.json
• src/rag_cli_plugin/lifecycle/installer.py
• src/rag_cli_plugin/lifecycle/updater.py
• src/rag_cli/core/path_resolver.py
• src/rag_cli_plugin/hooks/path_utils.py
• KNOWN_ISSUES.md (comprehensive documentation)

Tested on: Windows path handling scenarios
Platform: Primarily affects Windows (stricter file locking)