@scheduler-systems/gal-cli 0.1.3 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scheduler-systems/gal-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "GAL CLI - Command-line tool for managing AI agent configurations across your organization",
   "license": "UNLICENSED",
   "private": false,
@@ -11,13 +11,15 @@
   },
   "files": [
     "dist/index.cjs",
+    "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.cjs",
     "dev": "tsx watch src/index.ts",
-    "build": "tsc && chmod +x dist/index.js",
-    "build:publish": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --target=node18 --minify --outfile=dist/index.cjs --format=cjs && 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",
+    "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__=\\\"https://api.gal.run\\\" && 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",
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",

package/scripts/postinstall.cjs

@@ -0,0 +1,269 @@
+#!/usr/bin/env node
+/**
+ * GAL CLI Postinstall Script
+ * Installs the sync reminder hook to ~/.claude/hooks/
+ * This runs automatically when the CLI is installed via npm
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const HOOK_CONTENT = `#!/usr/bin/env node
+/**
+ * GAL Config Sync Hook for Claude Code (UserPromptSubmit)
+ * Reminds developers to authenticate and sync with org-approved configs.
+ * Self-cleaning: removes itself if GAL CLI is uninstalled.
+ *
+ * Uses Claude Code hook protocol:
+ * - systemMessage: shown to user as notification
+ * - continue: true = non-blocking
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const os = require('os');
+
+const GAL_DIR = '.gal';
+const SYNC_STATE_FILE = 'sync-state.json';
+const GAL_CONFIG_FILE = path.join(os.homedir(), '.gal', 'config.json');
+const SESSION_FILE = path.join(os.tmpdir(), 'gal-hook-session.json');
+
+// Output a notification to the user (non-blocking)
+function notify(message) {
+  // Output JSON to stdout - Claude Code will parse this
+  process.stdout.write(JSON.stringify({
+    systemMessage: message
+  }));
+  process.exit(0);
+}
+
+// Track reminders per session to avoid spamming
+function shouldRemind(key) {
+  const now = Date.now();
+  let session = {};
+
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
+    }
+  } catch {}
+
+  // Remind every 10 minutes per issue type
+  const lastRemind = session[key] || 0;
+  const tenMinutes = 10 * 60 * 1000;
+
+  if (now - lastRemind > tenMinutes) {
+    session[key] = now;
+    try {
+      fs.writeFileSync(SESSION_FILE, JSON.stringify(session));
+    } catch {}
+    return true;
+  }
+  return false;
+}
+
+// Self-cleaning: Check if GAL CLI is still installed
+function isGalInstalled() {
+  try {
+    execSync('which gal', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Remove this hook and clean up settings.json
+function selfClean() {
+  const hookPath = __filename;
+  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+
+  // Remove hook file
+  try { fs.unlinkSync(hookPath); } catch {}
+
+  // Remove hook entry from settings.json
+  try {
+    if (fs.existsSync(settingsPath)) {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+      if (settings.hooks?.UserPromptSubmit) {
+        settings.hooks.UserPromptSubmit = settings.hooks.UserPromptSubmit.filter(entry => {
+          if (!entry.hooks) return true;
+          entry.hooks = entry.hooks.filter(h => !h.command?.includes('gal-'));
+          return entry.hooks.length > 0;
+        });
+        if (settings.hooks.UserPromptSubmit.length === 0) delete settings.hooks.UserPromptSubmit;
+        if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+      }
+    }
+  } catch {}
+
+  // Clean up session file
+  try { fs.unlinkSync(SESSION_FILE); } catch {}
+}
+
+// Check if GAL is installed, self-clean if not
+if (!isGalInstalled()) {
+  selfClean();
+  process.exit(0);
+}
+
+// Read GAL CLI config (auth token, default org)
+function readGalConfig() {
+  if (!fs.existsSync(GAL_CONFIG_FILE)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(GAL_CONFIG_FILE, 'utf-8'));
+  } catch { return null; }
+}
+
+// Decode JWT without verification (just to check expiration)
+function decodeJwt(token) {
+  try {
+    const parts = token.split('.');
+    if (parts.length !== 3) return null;
+    const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString('utf-8'));
+    return payload;
+  } catch { return null; }
+}
+
+// Check authentication status
+const galConfig = readGalConfig();
+
+// Step 1: Check if authenticated
+if (!galConfig || !galConfig.authToken) {
+  if (shouldRemind('auth-required')) {
+    notify('🔐 GAL: Authentication required. Run: gal auth login');
+  }
+  process.exit(0);
+}
+
+// Step 2: Check if token is expired
+const tokenPayload = decodeJwt(galConfig.authToken);
+if (tokenPayload && tokenPayload.exp) {
+  const expiresAt = tokenPayload.exp * 1000;
+  const now = Date.now();
+
+  if (now > expiresAt) {
+    if (shouldRemind('auth-expired')) {
+      notify('🔐 GAL: Session expired. Run: gal auth login');
+    }
+    process.exit(0);
+  }
+
+  // Warn if expiring soon (within 24 hours)
+  const hoursUntilExpiry = (expiresAt - now) / (1000 * 60 * 60);
+  if (hoursUntilExpiry < 24) {
+    if (shouldRemind('auth-expiring')) {
+      notify(\`⏰ GAL: Session expires in \${Math.round(hoursUntilExpiry)} hours. Run: gal auth login\`);
+    }
+    // Don't exit - continue to check sync state
+  }
+}
+
+// Step 3: Check sync state
+function readSyncState() {
+  const statePath = path.join(process.cwd(), GAL_DIR, SYNC_STATE_FILE);
+  if (!fs.existsSync(statePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+  } catch { return null; }
+}
+
+const state = readSyncState();
+
+// No sync state = project not synced yet
+if (!state) {
+  const orgName = galConfig.defaultOrg || 'your organization';
+  if (shouldRemind('sync-required')) {
+    notify(\`📥 GAL: Project not synced with \${orgName}. Run: gal sync --pull\`);
+  }
+  process.exit(0);
+}
+
+// Step 4: Compare hashes - check if config is outdated
+if (state.lastSyncHash !== state.approvedConfigHash) {
+  const days = Math.floor((Date.now() - new Date(state.lastSyncTimestamp).getTime()) / (24 * 60 * 60 * 1000));
+  if (shouldRemind('sync-outdated')) {
+    notify(\`⚠️ GAL: Config \${days} day(s) behind \${state.organization}. Run: gal sync --pull\`);
+  }
+  process.exit(0);
+}
+
+// Step 5: Check if synced files still exist
+if (state.syncedFiles && state.syncedFiles.length > 0) {
+  const missingFiles = state.syncedFiles.filter(f => {
+    const fullPath = path.join(process.cwd(), f);
+    return !fs.existsSync(fullPath);
+  });
+
+  if (missingFiles.length > 0) {
+    if (shouldRemind('sync-missing')) {
+      notify('⚠️ GAL: Missing config files. Run: gal sync --pull');
+    }
+    process.exit(0);
+  }
+}
+
+// All good - config is up-to-date and complete
+process.exit(0);
+`;
+
+function installHook() {
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const hooksDir = path.join(claudeDir, 'hooks');
+  const hookPath = path.join(hooksDir, 'gal-sync-reminder.js');
+  const settingsPath = path.join(claudeDir, 'settings.json');
+
+  try {
+    // Create directories if needed
+    if (!fs.existsSync(hooksDir)) {
+      fs.mkdirSync(hooksDir, { recursive: true });
+    }
+
+    // Write the hook file
+    fs.writeFileSync(hookPath, HOOK_CONTENT, 'utf-8');
+    fs.chmodSync(hookPath, '755');
+
+    // Register hook in settings.json
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+      } catch {
+        settings = {};
+      }
+    }
+
+    // Check if hook is already registered
+    const hookCommand = `node ${hookPath}`;
+    const existingHooks = settings.hooks?.UserPromptSubmit || [];
+    const alreadyRegistered = existingHooks.some(entry =>
+      entry.hooks?.some(h => h.command?.includes('gal-sync-reminder'))
+    );
+
+    if (!alreadyRegistered) {
+      // Add hook registration
+      if (!settings.hooks) settings.hooks = {};
+      if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
+
+      settings.hooks.UserPromptSubmit.push({
+        matcher: "",
+        hooks: [{
+          type: "command",
+          command: hookCommand
+        }]
+      });
+
+      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    }
+
+    console.log('✓ GAL sync reminder hook installed');
+    console.log('  Restart Claude Code for the hook to take effect.');
+  } catch (error) {
+    // Silent fail - hook is optional enhancement
+    // console.error('Could not install hook:', error.message);
+  }
+}
+
+installHook();