@scheduler-systems/gal-run 0.0.197

package/scripts/preuninstall.cjs

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * GAL CLI Preuninstall Script
+ *
+ * Automatically cleans up GAL-installed files when the CLI is uninstalled via pnpm.
+ * This script runs as a package lifecycle hook before package removal.
+ *
+ * What it cleans:
+ * 1. Hook files → ~/.claude/hooks/gal-*.js
+ * 2. Status line script → ~/.claude/status_lines/gal-sync-status.py
+ * 3. Rules file → ~/.claude/rules/gal-cli.md
+ * 4. Hook entries in ~/.claude/settings.json (preserves file and other hooks)
+ * 5. GAL config directory → ~/.gal/ (auth tokens, sync state, telemetry queue)
+ *
+ * Cleanup scope:
+ * - User-level files only (not project-level .gal directories)
+ * - GAL-specific entries only (preserves user's other Claude configs)
+ * - Silent fail strategy (won't prevent uninstall on errors)
+ *
+ * When it runs:
+ * - Automatically during `pnpm rm -g @scheduler-systems/gal-run`
+ * - Before package files are removed from node_modules
+ * - Can be manually triggered via `pnpm run preuninstall` in the CLI package directory
+ *
+ * Prerequisites:
+ * - Node.js 18+ (CommonJS module)
+ * - Runs with user's file system permissions
+ *
+ * Related files:
+ * - apps/cli/scripts/postinstall.cjs - Installation script
+ * - apps/cli/package.json - package lifecycle hooks configuration
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// =============================================================================
+// Cleanup Functions - settings.json
+// =============================================================================
+
+/**
+ * Remove GAL hook entries from settings.json without deleting the file.
+ *
+ * This function surgically removes only GAL-specific hook entries while
+ * preserving the user's other hooks and settings. It handles:
+ * - Filtering GAL hooks from UserPromptSubmit array
+ * - Filtering GAL hooks from SessionStart array (v2.x)
+ * - Removing empty hook arrays after filtering
+ * - Preserving the settings.json file structure
+ *
+ * @param {string} settingsPath - Full path to ~/.claude/settings.json
+ * @returns {boolean} True if any GAL entries were removed, false otherwise
+ */
+function removeGalHookEntries(settingsPath) {
+  try {
+    if (!fs.existsSync(settingsPath)) {
+      return false;
+    }
+
+    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+
+    if (!settings.hooks?.UserPromptSubmit) {
+      return false;
+    }
+
+    // Filter out GAL hooks while preserving user's other hooks
+    const originalLength = settings.hooks.UserPromptSubmit.length;
+    settings.hooks.UserPromptSubmit = settings.hooks.UserPromptSubmit.filter((entry) => {
+      if (!entry.hooks) return true;
+      // Keep entry only if it has non-GAL hooks
+      entry.hooks = entry.hooks.filter((hook) =>
+        !hook.command?.includes('gal-') && !hook.command?.includes('/gal/')
+      );
+      return entry.hooks.length > 0;
+    });
+
+    // Remove empty hooks array
+    if (settings.hooks.UserPromptSubmit.length === 0) {
+      delete settings.hooks.UserPromptSubmit;
+    }
+
+    // Remove empty hooks object
+    if (Object.keys(settings.hooks).length === 0) {
+      delete settings.hooks;
+    }
+
+    if (settings.hooks?.UserPromptSubmit?.length !== originalLength) {
+      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+      return true;
+    }
+
+    return false;
+  } catch {
+    // Silent fail - don't prevent uninstall if settings.json is corrupted
+    return false;
+  }
+}
+
+// =============================================================================
+// Cleanup Functions - User-Level Files
+// =============================================================================
+
+/**
+ * Clean up GAL-installed files from user's home directory.
+ *
+ * Removes:
+ * - Hook files: ~/.claude/hooks/gal-*.js
+ * - Status line script: ~/.claude/status_lines/gal-sync-status.py
+ * - Rules file: ~/.claude/rules/gal-cli.md
+ * - Hook entries from settings.json
+ *
+ * Uses silent fail strategy - logs removed files but doesn't throw errors.
+ * This ensures uninstall proceeds even if individual files are missing or
+ * have permission issues.
+ *
+ * @returns {string[]} Array of paths to files that were successfully removed
+ */
+function cleanupUserLevel() {
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const hooksDir = path.join(claudeDir, 'hooks');
+  const settingsPath = path.join(claudeDir, 'settings.json');
+
+  let removed = [];
+
+  // Remove GAL hook files
+  if (fs.existsSync(hooksDir)) {
+    try {
+      const files = fs.readdirSync(hooksDir);
+      for (const file of files) {
+        if (file.startsWith('gal-')) {
+          const hookPath = path.join(hooksDir, file);
+          try {
+            fs.unlinkSync(hookPath);
+            removed.push(hookPath);
+          } catch (err) {
+            // Silent fail
+          }
+        }
+      }
+    } catch (err) {
+      // Silent fail
+    }
+  }
+
+  // Remove GAL hook entries from settings.json
+  if (removeGalHookEntries(settingsPath)) {
+    removed.push(`${settingsPath} (GAL hooks removed)`);
+  }
+
+  return removed;
+}
+
+// =============================================================================
+// Cleanup Functions - GAL Config Directory
+// =============================================================================
+
+/**
+ * Clean up GAL config directory from user's home directory.
+ *
+ * Removes entire ~/.gal directory, including:
+ * - config.json (auth token, default org)
+ * - telemetry-pending-events.json (queued telemetry events)
+ * - Any other GAL-specific cache or state files
+ *
+ * Note: Does NOT remove project-level .gal directories (those belong to repos)
+ *
+ * Uses silent fail strategy to ensure uninstall proceeds even if directory
+ * is missing or has permission issues.
+ *
+ * @returns {string[]} Array containing the removed directory path, or empty array
+ */
+function cleanupGalConfig() {
+  const galConfigDir = path.join(os.homedir(), '.gal');
+
+  if (fs.existsSync(galConfigDir)) {
+    try {
+      fs.rmSync(galConfigDir, { recursive: true, force: true });
+      return [galConfigDir];
+    } catch (err) {
+      // Silent fail
+      return [];
+    }
+  }
+
+  return [];
+}
+
+// =============================================================================
+// Main Cleanup Orchestration
+// =============================================================================
+
+/**
+ * Main cleanup orchestration function.
+ *
+ * Coordinates all cleanup operations and provides user feedback.
+ * Runs both user-level and config directory cleanups, then reports results.
+ *
+ * @returns {void}
+ */
+function cleanup() {
+  console.log('\n═══════════════════════════════════════════════════');
+  console.log('  GAL CLI Uninstall Cleanup');
+  console.log('═══════════════════════════════════════════════════\n');
+
+  const userLevelFiles = cleanupUserLevel();
+  const galConfigFiles = cleanupGalConfig();
+  const allRemoved = [...userLevelFiles, ...galConfigFiles];
+
+  if (allRemoved.length > 0) {
+    console.log('✓ Cleaned up GAL files:');
+    for (const file of allRemoved) {
+      console.log(`  - ${file}`);
+    }
+  } else {
+    console.log('No GAL files found to clean up.');
+  }
+
+  console.log('\n═══════════════════════════════════════════════════');
+  console.log('  GAL CLI has been uninstalled');
+  console.log('═══════════════════════════════════════════════════\n');
+  console.log('To reinstall: pnpm add -g @scheduler-systems/gal-run\n');
+}
+
+// =============================================================================
+// Entry Point
+// =============================================================================
+
+// Run cleanup with silent fail strategy
+// Even if cleanup fails, we don't prevent npm uninstall from proceeding
+try {
+  cleanup();
+} catch (error) {
+  // Log error but allow uninstall to continue
+  console.error('GAL cleanup encountered an error, but uninstall will proceed.');
+  // Note: We don't process.exit(1) here - uninstall should always succeed
+}