@scheduler-systems/gal-cli 0.1.13-beta.2-alpha.pr30 → 0.1.13-beta.2-alpha.pr74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scheduler-systems/gal-cli",
-  "version": "0.1.13-beta.2-alpha.pr30",
+  "version": "0.1.13-beta.2-alpha.pr74",
   "description": "GAL CLI - Command-line tool for managing AI agent configurations across your organization",
   "license": "UNLICENSED",
   "private": false,
@@ -12,11 +12,13 @@
   "files": [
     "dist/index.cjs",
     "scripts/postinstall.cjs",
+    "scripts/preuninstall.cjs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "postinstall": "node scripts/postinstall.cjs",
+    "preuninstall": "node scripts/preuninstall.cjs",
     "dev": "tsx watch src/index.ts",
     "build": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.cjs --format=cjs --define:__CLI_VERSION__=\\\"$(node -p \"require('./package.json').version\")\\\" --define:__DEFAULT_API_URL__=\\\"http://localhost:3000\\\" && chmod +x dist/index.cjs",
     "build:publish": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --target=node18 --minify --outfile=dist/index.cjs --format=cjs --define:__CLI_VERSION__=\\\"$(node -p \"require('./package.json').version\")\\\" --define:__DEFAULT_API_URL__=\\\"${DEFAULT_API_URL:-https://gal-api-s3pvf4isfa-uc.a.run.app}\\\" && sed -i '' '1s/^#!.*$//' dist/index.cjs && printf '%s\\n' '#!/usr/bin/env node' | cat - dist/index.cjs > dist/temp.cjs && mv dist/temp.cjs dist/index.cjs && chmod +x dist/index.cjs",

package/scripts/postinstall.cjs

@@ -5,6 +5,7 @@
  * Automatically installs Claude Code integrations when GAL CLI is installed:
  * 1. SessionStart hook → ~/.claude/hooks/gal-sync-reminder.js
  * 2. Status line script → ~/.claude/status_lines/gal-sync-status.py
+ * 3. GAL CLI rules → ~/.claude/rules/gal-cli.md
  *
  * These are CLI-level configs (not org-specific).
  * Org-specific configs are handled by `gal sync --pull`.
@@ -25,8 +26,33 @@ const cliPackageJson = require('../package.json');
 const CLI_VERSION = cliPackageJson.version;
 
 // Version markers for idempotency
-const HOOK_VERSION = '2.0.0'; // SessionStart version (was 1.x for UserPromptSubmit)
+const HOOK_VERSION = '2.1.0'; // SessionStart version (2.1.0: Added telemetry tracking)
 const STATUS_LINE_VERSION = '1.0.0';
+const RULES_VERSION = '1.0.0';
+
+// =============================================================================
+// GAL CLI Rules Content
+// =============================================================================
+// This is injected into ~/.claude/rules/gal-cli.md
+// Provides persistent GAL CLI awareness without running on every prompt
+// =============================================================================
+
+const GAL_CLI_RULES_CONTENT = `# GAL CLI
+
+<!-- GAL_RULES_VERSION = "${RULES_VERSION}" -->
+
+The \`gal\` CLI is available for managing org-approved AI agent configurations.
+
+## Available Commands
+- \`gal sync --pull\` - Download latest approved config from your organization
+- \`gal auth login\` - Authenticate with GitHub
+- \`gal --help\` - See all available commands
+
+## Behavior Rules
+- **Confirmation Required**: Always ask the user before running any \`gal\` command
+- **Self-Discovery**: If unsure about syntax, run \`gal --help\` or \`gal <command> --help\` first
+- **Sync Notifications**: When you see a GAL sync notification, ask: "Do you want me to sync gal now?"
+`;
 
 // =============================================================================
 // SessionStart Hook Content
@@ -61,11 +87,54 @@ const GAL_DIR = '.gal';
 const SYNC_STATE_FILE = 'sync-state.json';
 const GAL_CONFIG_FILE = path.join(os.homedir(), '.gal', 'config.json');
 
-function showMessage(message) {
+function showMessage(message, status) {
+  // Queue telemetry event before showing message
+  queueTelemetryEvent(status);
   console.log(JSON.stringify({ systemMessage: message }));
   process.exit(0);
 }
 
+// =============================================================================
+// Telemetry: Queue events for CLI to send on next run (GAL-114)
+// =============================================================================
+
+function queueTelemetryEvent(status) {
+  const pendingEventsPath = path.join(os.homedir(), '.gal', 'telemetry-pending-events.json');
+  const galDir = path.join(os.homedir(), '.gal');
+
+  let pending = [];
+  try {
+    if (fs.existsSync(pendingEventsPath)) {
+      pending = JSON.parse(fs.readFileSync(pendingEventsPath, 'utf-8'));
+    }
+  } catch {}
+
+  // Add session start hook event
+  pending.push({
+    id: require('crypto').randomUUID(),
+    eventType: 'hook_triggered',
+    timestamp: new Date().toISOString(),
+    payload: {
+      notificationType: 'session_start',
+      hookVersion: '${HOOK_VERSION}',
+      status: status,
+      cwd: process.cwd(),
+      platform: process.platform,
+      nodeVersion: process.version,
+    },
+    queuedAt: Date.now(),
+  });
+
+  try {
+    if (!fs.existsSync(galDir)) {
+      fs.mkdirSync(galDir, { recursive: true });
+    }
+    fs.writeFileSync(pendingEventsPath, JSON.stringify(pending), 'utf-8');
+  } catch {
+    // Ignore errors - telemetry is optional
+  }
+}
+
 // =============================================================================
 // Self-cleaning: Remove hook if GAL CLI is uninstalled
 // =============================================================================
@@ -81,11 +150,16 @@ function isGalInstalled() {
 
 function selfClean() {
   const hookPath = __filename;
-  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const settingsPath = path.join(claudeDir, 'settings.json');
+  const rulesPath = path.join(claudeDir, 'rules', 'gal-cli.md');
 
   // Remove hook file
   try { fs.unlinkSync(hookPath); } catch {}
 
+  // Remove rules file
+  try { fs.unlinkSync(rulesPath); } catch {}
+
   // Remove hook entries from settings.json
   try {
     if (fs.existsSync(settingsPath)) {
@@ -138,7 +212,7 @@ const galConfig = readGalConfig();
 
 // Check 1: Not authenticated
 if (!galConfig || !galConfig.authToken) {
-  showMessage("🔐 GAL: Authentication required.\\nRun: gal auth login");
+  showMessage("🔐 GAL: Authentication required.\\nRun: gal auth login", 'auth_required');
 }
 
 // Check 2: Token expired
@@ -146,7 +220,7 @@ const tokenPayload = decodeJwt(galConfig.authToken);
 if (tokenPayload && tokenPayload.exp) {
   const expiresAt = tokenPayload.exp * 1000;
   if (Date.now() > expiresAt) {
-    showMessage("🔐 GAL: Session expired.\\nRun: gal auth login");
+    showMessage("🔐 GAL: Session expired.\\nRun: gal auth login", 'token_expired');
   }
 }
 
@@ -163,13 +237,13 @@ const state = readSyncState();
 
 if (!state) {
   const orgName = galConfig.defaultOrg || 'your organization';
-  showMessage(\`📥 GAL: Not synced with \${orgName}'s approved config.\\nRun: gal sync --pull\`);
+  showMessage(\`📥 GAL: Not synced with \${orgName}'s approved config.\\nRun: gal sync --pull\`, 'not_synced');
 }
 
 // Check 4: Config outdated
 if (state.lastSyncHash !== state.approvedConfigHash) {
   const days = Math.floor((Date.now() - new Date(state.lastSyncTimestamp).getTime()) / (24 * 60 * 60 * 1000));
-  showMessage(\`⚠️ GAL: Config is \${days} day(s) behind \${state.organization}'s approved version.\\nRun: gal sync --pull\`);
+  showMessage(\`⚠️ GAL: Config is \${days} day(s) behind \${state.organization}'s approved version.\\nRun: gal sync --pull\`, 'config_outdated');
 }
 
 // Check 5: Missing synced files
@@ -180,12 +254,12 @@ if (state.syncedFiles && state.syncedFiles.length > 0) {
   });
 
   if (missingFiles.length > 0) {
-    showMessage(\`⚠️ GAL: Missing synced file(s): \${missingFiles.join(', ')}.\\nRun: gal sync --pull\`);
+    showMessage(\`⚠️ GAL: Missing synced file(s): \${missingFiles.join(', ')}.\\nRun: gal sync --pull\`, 'missing_files');
   }
 }
 
 // All good - show synced status
-showMessage(\`✅ GAL: Synced with \${state.organization}'s approved config (v\${state.version || 'latest'})\`);
+showMessage(\`✅ GAL: Synced with \${state.organization}'s approved config (v\${state.version || 'latest'})\`, 'synced');
 `;
 
 // =============================================================================
@@ -441,6 +515,48 @@ function installHook() {
   }
 }
 
+/**
+ * Install GAL CLI rules to ~/.claude/rules/
+ *
+ * Key behaviors:
+ * - Idempotent: Checks version before writing
+ * - Provides persistent GAL CLI awareness
+ * - No longer runs on every prompt (unlike hooks)
+ */
+function installRules() {
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const rulesDir = path.join(claudeDir, 'rules');
+  const rulesPath = path.join(rulesDir, 'gal-cli.md');
+
+  try {
+    // Create rules directory if needed
+    if (!fs.existsSync(rulesDir)) {
+      fs.mkdirSync(rulesDir, { recursive: true });
+    }
+
+    // Check if rules file already exists with current version
+    let needsUpdate = true;
+    if (fs.existsSync(rulesPath)) {
+      const existingContent = fs.readFileSync(rulesPath, 'utf-8');
+      const versionMatch = existingContent.match(/GAL_RULES_VERSION = "([^"]+)"/);
+      if (versionMatch && versionMatch[1] === RULES_VERSION) {
+        needsUpdate = false;
+      }
+    }
+
+    // Write the rules file if needed
+    if (needsUpdate) {
+      fs.writeFileSync(rulesPath, GAL_CLI_RULES_CONTENT, 'utf-8');
+      console.log('✓ GAL CLI rules installed');
+    }
+
+    return true;
+  } catch (error) {
+    // Silent fail - rules are optional enhancement
+    return false;
+  }
+}
+
 /**
  * Queue a telemetry event for the next CLI run (GAL-114)
  * Since postinstall is CommonJS and telemetry module is ESM,
@@ -558,14 +674,15 @@ function installStatusLine() {
 
 function main() {
   const hookInstalled = installHook();
+  const rulesInstalled = installRules();
   const statusLineInstalled = installStatusLine();
 
   // Queue telemetry event (GAL-114)
   queueTelemetryEvent();
 
-  if (hookInstalled || statusLineInstalled) {
+  if (hookInstalled || rulesInstalled || statusLineInstalled) {
     console.log('');
-    console.log('Restart Claude Code for changes to take effect.');
+    console.log('Restart Claude Code/Cursor for changes to take effect.');
     console.log('');
     console.log('Next steps:');
     console.log('  1. gal auth login     - Authenticate with GitHub');

package/scripts/preuninstall.cjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * GAL CLI Preuninstall Script
+ * Automatically cleans up GAL files when the CLI is uninstalled via npm
+ * This runs before the package is removed
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+/**
+ * Remove GAL hook entries from settings.json without deleting the file
+ */
+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
+    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 {
+    return false;
+  }
+}
+
+/**
+ * Clean up GAL-installed files from user's home directory
+ */
+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;
+}
+
+/**
+ * Clean up GAL config from user's home directory
+ */
+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 function
+ */
+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: npm install -g @scheduler-systems/gal-cli\n');
+}
+
+// Run cleanup
+try {
+  cleanup();
+} catch (error) {
+  // Silent fail - don't prevent uninstall
+  console.error('GAL cleanup encountered an error, but uninstall will proceed.');
+}