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

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@scheduler-systems/gal-cli",
-  "version": "0.1.13-beta.2-alpha.pr72",
+  "version": "0.1.13",
   "description": "GAL CLI - Command-line tool for managing AI agent configurations across your organization",
   "license": "UNLICENSED",
   "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
   "type": "module",
   "main": "./dist/index.cjs",
   "bin": {
@@ -12,11 +16,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",
@@ -74,4 +80,4 @@
     "typescript": "^5.7.2",
     "vitest": "^1.0.0"
   }
-}
+}

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`.
@@ -27,6 +28,31 @@ const CLI_VERSION = cliPackageJson.version;
 // Version markers for idempotency
 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
@@ -124,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)) {
@@ -484,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,
@@ -601,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.');
+}