prjct-cli 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -15,6 +15,96 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cross-platform file operations
   - Windows Terminal integration
 
+## [0.4.5] - 2025-10-02
+
+### Fixed
+- **Critical Bug Fixes** - All commands now enforce global architecture correctly
+  - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
+  - `/p:cleanup` now operates on global project data instead of local `.prjct/`
+  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
+  - All commands verify project is initialized before execution
+  - Prevents creation of invalid local `.prjct/` structures
+  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
+  - **Added 'Apps' directory** to migration scanner for better project detection
+
+### Technical Details
+- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
+  - design(), cleanup(), getDaysSinceLastShip() fully migrated
+  - Prevents LOCAL .prjct/ creation
+  - Requires project initialization before command execution
+- **Migration Enhancement**: Added ~/Apps to common directories scan
+- **Post-Install Fix**: currentVersion variable properly declared at function start
+
+## [0.4.4] - 2025-10-02
+
+### Added
+- **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
+  - New `core/editors-config.js` tracks which editors user has installed commands to
+  - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
+  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
+  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
+  - No manual reinstallation needed - updates happen automatically
+  - Respects user's original editor choices from initial setup
+
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
+- **Automatic Data Migration** - Seamless upgrade from v0.1.0 to v0.4.4
+  - Post-install hook automatically detects legacy `.prjct/` projects
+  - Migrates data from local structure to new global architecture (`~/.prjct-cli/projects/{id}/`)
+  - Scans common project directories (Projects, Documents, Developer, Code, **Apps**)
+  - Preserves all project data during migration (now, next, shipped, ideas, memory)
+  - Cleans up legacy directories while keeping config for compatibility
+  - No user intervention required - migration happens automatically on update
+  - Uses existing battle-tested `core/migrator.js` system
+
+### Changed
+- **Improved Command Tracking** - Always track editor installations for better update management
+  - Modified `installToSelected()` to always save editor config (removed `!forceUpdate` restriction)
+  - Ensures tracking happens even during force updates
+  - Enables reliable auto-updates across all configured editors
+
+### Fixed
+- **Global Architecture Enforcement** - All commands now enforce global architecture correctly
+  - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
+  - `/p:cleanup` now operates on global project data instead of local `.prjct/`
+  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
+  - All commands verify project is initialized before execution
+  - Prevents creation of invalid local `.prjct/` structures
+  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
+  - **Added 'Apps' directory** to migration scanner for better project detection
+
+### Technical Details
+- **Post-Install Hook**: Runs after `npm install -g prjct-cli` or `npm update -g prjct-cli`
+  - First install: Auto-detects editors and installs commands
+  - Updates: Checks version change and auto-updates commands in tracked editors
+  - **Migration**: Automatically detects and migrates legacy projects from v0.1.0
+  - Silent operation with debug mode via `DEBUG=1` environment variable
+  - **Fixed**: currentVersion variable now properly declared at function start
+  - **Enhanced**: Better error handling with debug logging
+- **Pre-Uninstall Hook**: Runs before `npm uninstall -g prjct-cli`
+  - Reads tracking config to find all installed editors
+  - Removes command directories from each editor
+  - Cleans up tracking configuration
+  - Fails gracefully to not block uninstall
+- **Migration System**: Automatic upgrade path from v0.1.0 to v0.4.4
+  - Scans common project directories including **~/Apps** (fast, non-intrusive)
+  - Migrates local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
+  - Preserves all data: core, progress, planning, analysis, memory layers
+  - Cleans legacy directories while keeping compatibility config
+  - Zero data loss, seamless upgrade experience
+- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
+  - design(), cleanup(), getDaysSinceLastShip() fully migrated
+  - Prevents LOCAL .prjct/ creation
+  - Requires project initialization before command execution
+
 ## [0.4.3] - 2025-10-02
 
 ### Added
@@ -22,10 +112,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - New `core/editors-config.js` tracks which editors user has installed commands to
   - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
   - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
   - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
   - No manual reinstallation needed - updates happen automatically
   - Respects user's original editor choices from initial setup
 
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
 - **GitHub Packages Support** - Dual registry publication for better reliability
   - Package now published to both npm and GitHub Packages automatically
   - GitHub Actions workflow updated to publish to both registries in parallel
@@ -40,9 +140,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Alternative: GitHub Packages (for advanced users or npm fallback)
   - Clear instructions for both installation methods
 
+- **Command Installer Improvements**
+  - `installToSelected()` now always saves editor config (removed force-update restriction)
+  - Better tracking ensures updates work correctly even for force updates
+  - Improved error handling and reporting
+
 ### Technical Details
-- **Editor Tracking**: Configuration saved after successful command installation
-- **Post-Install Hook**: Runs only for global installations, skips for local/dev installs
+- **Editor Tracking**: Configuration saved after all successful command installations
+- **Post-Install Hook**:
+  - Runs only for global installations, skips for local/dev installs
+  - Auto-detects and installs to all AI editors on first install
+  - Auto-updates commands when version changes
+- **Pre-Uninstall Hook**:
+  - Runs only for global uninstallations
+  - Removes slash commands from `~/.claude/`, `~/.cursor/`, `~/.windsurf/`
+  - Removes AGENTS.md from `~/.codex/` if present
+  - Deletes tracking configuration
 - **Version Detection**: Compares current version with last installed version
 - **Force Update**: Automatically updates commands when version changes
 - **Parallel Publication**: npm and GitHub Packages jobs run simultaneously for faster releases

package/bin/prjct

@@ -139,6 +139,15 @@ async function main() {
 
             result = await commands.analyze(analyzeOptions);
             break;
+        case '--version':
+        case '-v':
+        case 'version':
+            const packageJson = require('../package.json');
+            result = {
+                success: true,
+                message: `prjct-cli v${packageJson.version}`
+            };
+            break;
         case '--help':
         case '-h':
         case 'help':

package/core/command-installer.js

@@ -444,8 +444,8 @@ For detailed implementation, see prjct-cli documentation.
     const totalUpdated = Object.values(results)
       .reduce((sum, r) => sum + (r.updated || 0), 0)
 
-    // Save editor selections to config (only on successful new installations, not updates)
-    if (!forceUpdate && successfulEditors.length > 0) {
+    // Always save editor selections to config for tracking updates
+    if (successfulEditors.length > 0) {
       await this.saveEditorConfig(successfulEditors)
     }
 
@@ -807,6 +807,119 @@ This command uses the global prjct architecture:
 
     return results
   }
+
+  /**
+   * Uninstall commands from a specific editor
+   * @param {string} editorKey - Editor identifier (claude, cursor, codex, windsurf)
+   * @returns {Promise<Object>} Uninstallation result
+   */
+  async uninstallFromEditor(editorKey) {
+    const editor = this.editors[editorKey]
+
+    if (!editor) {
+      return { success: false, editor: editorKey, message: `Unknown editor: ${editorKey}` }
+    }
+
+    try {
+      switch (editor.format) {
+        case 'slash-commands':
+          // Remove the /p commands directory
+          await fs.rm(editor.commandsPath, { recursive: true, force: true })
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed slash commands from ${editor.name}`,
+          }
+
+        case 'agents-md':
+          // Remove AGENTS.md if it exists
+          const exists = await this.fileExists(editor.commandsPath)
+          if (exists) {
+            await fs.unlink(editor.commandsPath)
+          }
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed AGENTS.md from ${editor.name}`,
+          }
+
+        case 'workflows':
+          // Remove all p_*.md workflow files
+          try {
+            const files = await fs.readdir(editor.commandsPath)
+            const prjctWorkflows = files.filter(f => f.startsWith('p_') && f.endsWith('.md'))
+
+            for (const file of prjctWorkflows) {
+              await fs.unlink(path.join(editor.commandsPath, file))
+            }
+
+            return {
+              success: true,
+              editor: editor.name,
+              path: editor.commandsPath,
+              removed: prjctWorkflows.length,
+              message: `Removed ${prjctWorkflows.length} workflows from ${editor.name}`,
+            }
+          } catch (error) {
+            // Directory might not exist, that's ok
+            return {
+              success: true,
+              editor: editor.name,
+              message: `No workflows found in ${editor.name}`,
+            }
+          }
+
+        default:
+          return {
+            success: false,
+            editor: editor.name,
+            message: `Unknown format: ${editor.format}`,
+          }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        editor: editor.name,
+        message: `Uninstall failed: ${error.message}`,
+      }
+    }
+  }
+
+  /**
+   * Uninstall commands from all tracked editors
+   * @returns {Promise<Object>} Uninstallation results
+   */
+  async uninstallFromAll() {
+    const editorsConfig = require('./editors-config')
+    const trackedEditors = await editorsConfig.getTrackedEditors()
+
+    if (trackedEditors.length === 0) {
+      return {
+        success: true,
+        message: 'No editors tracked, nothing to uninstall',
+        results: {},
+      }
+    }
+
+    const results = {}
+    const successfulEditors = []
+
+    for (const editorKey of trackedEditors) {
+      results[editorKey] = await this.uninstallFromEditor(editorKey)
+      if (results[editorKey].success) {
+        successfulEditors.push(this.editors[editorKey]?.name || editorKey)
+      }
+    }
+
+    return {
+      success: true,
+      editors: successfulEditors,
+      totalRemoved: successfulEditors.length,
+      results,
+    }
+  }
 }
 
 module.exports = new CommandInstaller()

package/core/commands.js

@@ -1236,9 +1236,23 @@ ${dryRun ? '⚠️ DRY RUN - No changes were made' : '✅ All changes applied su
     try {
       await this.initializeAgent()
 
+      // Verify project is initialized
+      if (!await configManager.isConfigured(projectPath)) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            `Project not initialized. Run ${this.agentInfo.config.commandPrefix}init first.`,
+            'warning'
+          ),
+        }
+      }
+
       const type = options.type || 'architecture'
 
-      const designDir = path.join(projectPath, this.prjctDir, 'designs')
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
+      const designDir = path.join(globalPath, 'analysis', 'designs')
       await this.agent.createDirectory(designDir)
 
       let designContent = ''
@@ -1484,7 +1498,11 @@ ${diagram}
   async getDaysSinceLastShip(projectPath) {
     try {
       await this.initializeAgent()
-      const memoryFile = path.join(projectPath, this.prjctDir, 'memory.jsonl')
+
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
+      const memoryFile = path.join(globalPath, 'memory', 'context.jsonl')
       const memory = await this.agent.readFile(memoryFile)
       const lines = memory
         .trim()
@@ -1670,14 +1688,28 @@ ${diagram}
   async cleanup(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
-      const prjctPath = path.join(projectPath, this.prjctDir)
+
+      // Verify project is initialized
+      if (!await configManager.isConfigured(projectPath)) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            `Project not initialized. Run ${this.agentInfo.config.commandPrefix}init first.`,
+            'warning'
+          ),
+        }
+      }
+
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
 
       let totalFreed = 0
       let filesRemoved = 0
       let tasksArchived = 0
 
       try {
-        const tempDir = path.join(prjctPath, 'temp')
+        const tempDir = path.join(globalPath, 'temp')
         const tempFiles = await fs.readdir(tempDir).catch(() => [])
         for (const file of tempFiles) {
           const filePath = path.join(tempDir, file)
@@ -1690,7 +1722,7 @@ ${diagram}
       }
 
       try {
-        const memoryFile = path.join(prjctPath, 'memory.jsonl')
+        const memoryFile = path.join(globalPath, 'memory', 'context.jsonl')
         const content = await this.agent.readFile(memoryFile)
         const lines = content.split('\n').filter(line => line.trim())
         const now = new Date()
@@ -1714,7 +1746,7 @@ ${diagram}
         }
 
         if (archivedLines.length > 0) {
-          const archiveFile = path.join(prjctPath, `memory-archive-${now.toISOString().split('T')[0]}.jsonl`)
+          const archiveFile = path.join(globalPath, 'memory', `archive-${now.toISOString().split('T')[0]}.jsonl`)
           await this.agent.writeFile(archiveFile, archivedLines.join('\n') + '\n')
           await this.agent.writeFile(memoryFile, recentLines.join('\n') + '\n')
           tasksArchived = archivedLines.length
@@ -1722,10 +1754,10 @@ ${diagram}
       } catch (e) {
       }
 
-      const files = await fs.readdir(prjctPath)
+      const files = await fs.readdir(globalPath)
       for (const file of files) {
         if (file.endsWith('.md') || file.endsWith('.txt')) {
-          const filePath = path.join(prjctPath, file)
+          const filePath = path.join(globalPath, file)
           const stats = await fs.stat(filePath)
           if (stats.size === 0) {
             await fs.unlink(filePath)
@@ -1735,7 +1767,7 @@ ${diagram}
       }
 
       try {
-        const shippedFile = path.join(prjctPath, 'shipped.md')
+        const shippedFile = path.join(globalPath, 'progress', 'shipped.md')
         const content = await this.agent.readFile(shippedFile)
         const lines = content.split('\n')
         const now = new Date()

package/core/editors-config.js

@@ -155,6 +155,24 @@ class EditorsConfig {
       return false
     }
   }
+
+  /**
+   * Delete configuration file
+   * Used during uninstallation to clean up tracking data
+   * @returns {Promise<boolean>} Success status
+   */
+  async deleteConfig() {
+    try {
+      const exists = await this.configExists()
+      if (exists) {
+        await fs.unlink(this.configFile)
+      }
+      return true
+    } catch (error) {
+      console.error('[editors-config] Error deleting config:', error.message)
+      return false
+    }
+  }
 }
 
 module.exports = new EditorsConfig()

package/core/migrator.js

@@ -510,7 +510,7 @@ class Migrator {
     if (deepScan) {
       searchPaths = [os.homedir()]
     } else {
-      const commonDirs = ['Projects', 'Documents', 'Developer', 'Code', 'dev', 'workspace', 'repos', 'src']
+      const commonDirs = ['Projects', 'Documents', 'Developer', 'Code', 'dev', 'workspace', 'repos', 'src', 'Apps']
       searchPaths = commonDirs
         .map(dir => path.join(os.homedir(), dir))
         .filter(dirPath => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
   "main": "core/index.js",
   "bin": {
@@ -12,6 +12,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/post-install.js",
+    "preuninstall": "node scripts/preuninstall.js",
     "install-global": "./scripts/install.sh",
     "test": "echo 'No tests configured'",
     "lint": "eslint \"**/*.js\" --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
@@ -69,6 +70,7 @@
     "scripts/install.sh",
     "scripts/verify-installation.sh",
     "scripts/post-install.js",
+    "scripts/preuninstall.js",
     "LICENSE",
     "README.md",
     "CHANGELOG.md",

package/scripts/post-install.js

@@ -12,7 +12,7 @@
  * 3. If config exists and version changed, force-update commands in tracked editors
  * 4. Update version in config
  *
- * @version 0.4.2
+ * @version 0.4.4
  */
 
 const path = require('path')
@@ -21,11 +21,18 @@ const { execSync } = require('child_process')
 
 async function main() {
   try {
+    // Get current package version (needed by multiple code paths)
+    const packageJson = require('../package.json')
+    const currentVersion = packageJson.version
+
     // Check if this is a global installation
     const isGlobal = await checkIfGlobalInstall()
 
     if (!isGlobal) {
       // Skip post-install for local/dev installations
+      if (process.env.DEBUG) {
+        console.log(chalk.gray('[post-install] Skipping - not a global install'))
+      }
       return
     }
 
@@ -34,15 +41,44 @@ async function main() {
     const configExists = await editorsConfig.configExists()
 
     if (!configExists) {
-      // First-time install, no editors tracked yet
-      // User will configure editors during `prjct init` or `prjct install`
+      // First-time install - auto-detect and install to all editors
+      console.log(chalk.cyan('\n🔍 First-time installation detected...\n'))
+
+      // Load command installer
+      const commandInstaller = require('../core/command-installer')
+
+      // Detect available editors
+      const detected = await commandInstaller.detectEditors()
+      const detectedEditors = Object.entries(detected)
+        .filter(([_, info]) => info.detected)
+        .map(([key, _]) => key)
+
+      if (detectedEditors.length === 0) {
+        // No editors detected, user will install manually later
+        console.log(chalk.yellow('ℹ️  No AI editors detected'))
+        console.log(chalk.gray('   Run `prjct install` when you set up Claude Code, Cursor, or Windsurf\n'))
+        return
+      }
+
+      console.log(chalk.cyan(`📦 Installing commands to: ${detectedEditors.map(k => commandInstaller.editors[k]?.name || k).join(', ')}\n`))
+
+      // Install to all detected editors
+      const results = await commandInstaller.installToAll(false)
+
+      if (results.success) {
+        console.log(chalk.green(`✅ Commands installed in: ${results.editors.join(', ')}`))
+        console.log(chalk.gray(`   Commands installed: ${results.totalInstalled}`))
+        console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
+      } else {
+        console.log(chalk.yellow('⚠️  Some editors could not be configured'))
+        if (process.env.DEBUG) {
+          console.log(chalk.gray(`   Error: ${results.message || 'Unknown error'}`))
+        }
+      }
+
       return
     }
 
-    // Get current package version
-    const packageJson = require('../package.json')
-    const currentVersion = packageJson.version
-
     // Check if version has changed
     const versionChanged = await editorsConfig.hasVersionChanged(currentVersion)
 
@@ -78,6 +114,34 @@ async function main() {
     // Update version in config
     await editorsConfig.updateVersion(currentVersion)
 
+    // Auto-migrate legacy projects (v0.1.0 → v0.4.4)
+    try {
+      console.log(chalk.cyan('\n🔍 Checking for legacy projects to migrate...\n'))
+
+      const migrator = require('../core/migrator')
+
+      // Quick scan of common directories (not entire home directory)
+      const summary = await migrator.migrateAll({
+        deepScan: false,        // Only scan common dirs (fast)
+        removeLegacy: false,    // Keep legacy dirs for safety
+        cleanupLegacy: true,    // Remove old dirs but keep config
+        dryRun: false,          // Actually perform migration
+        interactive: false      // No user prompts during npm install
+      })
+
+      if (summary.successfullyMigrated > 0) {
+        console.log(chalk.green(`✅ Migrated ${summary.successfullyMigrated} legacy project(s) to new structure`))
+        console.log(chalk.gray(`   Data location: ~/.prjct-cli/projects/`))
+      } else if (summary.totalFound > 0 && summary.alreadyMigrated === summary.totalFound) {
+        console.log(chalk.gray('ℹ️  All projects already using new structure'))
+      }
+    } catch (migrationError) {
+      // Don't block install if migration fails
+      if (process.env.DEBUG) {
+        console.error(chalk.yellow('[post-install] Migration warning:'), migrationError.message)
+      }
+    }
+
     console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
 
   } catch (error) {

package/scripts/preuninstall.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-Uninstall Script
+ *
+ * Runs automatically BEFORE `npm uninstall -g prjct-cli`.
+ * Cleans up slash commands from all tracked AI editors.
+ *
+ * Flow:
+ * 1. Check if running as global uninstall
+ * 2. Read tracked editors from ~/.prjct-cli/config/installed-editors.json
+ * 3. Remove all prjct commands from tracked editors
+ * 4. Delete tracking configuration
+ * 5. Clean exit (don't block uninstall)
+ *
+ * @version 0.4.4
+ */
+
+const chalk = require('chalk')
+const { execSync } = require('child_process')
+const path = require('path')
+
+async function main() {
+  try {
+    // Check if this is a global uninstallation
+    const isGlobal = await checkIfGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip cleanup for local/dev uninstalls
+      return
+    }
+
+    // Load editors config
+    const editorsConfig = require('../core/editors-config')
+    const configExists = await editorsConfig.configExists()
+
+    if (!configExists) {
+      // No config, nothing to clean up
+      return
+    }
+
+    console.log(chalk.cyan('\n🧹 Cleaning up prjct commands from AI editors...\n'))
+
+    // Load command installer
+    const commandInstaller = require('../core/command-installer')
+
+    // Uninstall from all tracked editors
+    const results = await commandInstaller.uninstallFromAll()
+
+    if (results.success && results.editors.length > 0) {
+      console.log(chalk.green(`✅ Removed from: ${results.editors.join(', ')}`))
+    }
+
+    // Delete tracking config
+    await editorsConfig.deleteConfig()
+
+    console.log(chalk.green('\n✨ prjct-cli uninstalled cleanly\n'))
+
+  } catch (error) {
+    // Silently fail - don't block npm uninstall
+    // Only log if explicitly debugging
+    if (process.env.DEBUG) {
+      console.error(chalk.red('[preuninstall] Error:'), error.message)
+    }
+  }
+}
+
+/**
+ * Check if package is being uninstalled globally
+ * @returns {Promise<boolean>} True if global uninstall
+ */
+async function checkIfGlobalInstall() {
+  try {
+    // Get npm global root directory
+    const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim()
+
+    // Get current package directory
+    const currentDir = path.resolve(__dirname, '..')
+
+    // Check if current directory is under global node_modules
+    return currentDir.startsWith(globalRoot)
+  } catch {
+    return false
+  }
+}
+
+// Run main function
+main().catch(error => {
+  // Silently fail - don't block npm uninstall
+  if (process.env.DEBUG) {
+    console.error('[preuninstall] Fatal error:', error)
+  }
+  process.exit(0) // Exit with success to not block npm uninstall
+})