@jaguilar87/gaia-ops 2.5.3 → 2.5.5

package/bin/gaia-cleanup.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+/**
+ * @jaguilar87/gaia-ops - Cleanup script
+ *
+ * Runs automatically on npm uninstall (preuninstall hook)
+ *
+ * Purpose:
+ * - Remove CLAUDE.md
+ * - Remove settings.json
+ * - Remove all symlinks (agents, tools, hooks, commands, config, templates, speckit, CHANGELOG.md)
+ * - Preserve project-specific data (logs, tests, project-context, session, metrics)
+ *
+ * Usage: Automatic (npm preuninstall hook)
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+import chalk from 'chalk';
+import ora from 'ora';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const CWD = process.env.INIT_CWD || process.cwd();
+
+/**
+ * Remove CLAUDE.md if it exists
+ */
+async function removeClaudeMd() {
+  const spinner = ora('Removing CLAUDE.md...').start();
+
+  try {
+    const claudeMdPath = join(CWD, 'CLAUDE.md');
+
+    if (!existsSync(claudeMdPath)) {
+      spinner.info('CLAUDE.md not found, skipping');
+      return false;
+    }
+
+    await fs.unlink(claudeMdPath);
+    spinner.succeed('CLAUDE.md removed');
+    return true;
+  } catch (error) {
+    spinner.fail(`Failed to remove CLAUDE.md: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Remove settings.json if it exists
+ */
+async function removeSettingsJson() {
+  const spinner = ora('Removing settings.json...').start();
+
+  try {
+    const settingsPath = join(CWD, '.claude', 'settings.json');
+
+    if (!existsSync(settingsPath)) {
+      spinner.info('settings.json not found, skipping');
+      return false;
+    }
+
+    await fs.unlink(settingsPath);
+    spinner.succeed('settings.json removed');
+    return true;
+  } catch (error) {
+    spinner.fail(`Failed to remove settings.json: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Remove all symlinks in .claude/ directory
+ */
+async function removeSymlinks() {
+  const spinner = ora('Removing symlinks...').start();
+
+  try {
+    const claudeDir = join(CWD, '.claude');
+
+    if (!existsSync(claudeDir)) {
+      spinner.info('.claude/ directory not found, skipping');
+      return false;
+    }
+
+    // Define all symlinks that should be removed
+    const symlinks = [
+      join(claudeDir, 'agents'),
+      join(claudeDir, 'tools'),
+      join(claudeDir, 'hooks'),
+      join(claudeDir, 'commands'),
+      join(claudeDir, 'templates'),
+      join(claudeDir, 'config'),
+      join(claudeDir, 'speckit'),
+      join(claudeDir, 'CHANGELOG.md'),
+      join(claudeDir, 'README.en.md'),
+      join(claudeDir, 'README.md')
+    ];
+
+    let removed = 0;
+    for (const symlinkPath of symlinks) {
+      if (existsSync(symlinkPath)) {
+        try {
+          await fs.unlink(symlinkPath);
+          removed++;
+        } catch (error) {
+          // Ignore errors
+        }
+      }
+    }
+
+    if (removed > 0) {
+      spinner.succeed(`Removed ${removed} symlink(s)`);
+      return true;
+    } else {
+      spinner.info('No symlinks found to remove');
+      return false;
+    }
+  } catch (error) {
+    spinner.fail(`Failed to remove symlinks: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Main function
+ */
+async function main() {
+  console.log(chalk.cyan('\n🧹 @jaguilar87/gaia-ops cleanup\n'));
+
+  try {
+    const claudeRemoved = await removeClaudeMd();
+    const settingsRemoved = await removeSettingsJson();
+    const symlinksRemoved = await removeSymlinks();
+
+    if (claudeRemoved || settingsRemoved || symlinksRemoved) {
+      console.log(chalk.green('\n✅ Cleanup completed\n'));
+      console.log(chalk.gray('Preserved data:'));
+      console.log(chalk.gray('  • .claude/logs/'));
+      console.log(chalk.gray('  • .claude/tests/'));
+      console.log(chalk.gray('  • .claude/project-context/'));
+      console.log(chalk.gray('  • .claude/session/'));
+      console.log(chalk.gray('  • .claude/metrics/\n'));
+    } else {
+      console.log(chalk.gray('\n✓ Nothing to clean up\n'));
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Cleanup failed: ${error.message}\n`));
+    // Don't fail npm uninstall, just warn
+    process.exit(0);
+  }
+}
+
+main();

package/bin/gaia-update.js

@@ -29,11 +29,11 @@ const __dirname = dirname(__filename);
 const CWD = process.env.INIT_CWD || process.cwd();
 
 /**
- * Check if CLAUDE.md exists (to determine if this is first-time install)
+ * Check if .claude/ directory exists (to determine if this is first-time install)
  */
-async function claudeMdExists() {
-  const claudeMdPath = join(CWD, 'CLAUDE.md');
-  return existsSync(claudeMdPath);
+async function isExistingInstallation() {
+  const claudeDir = join(CWD, '.claude');
+  return existsSync(claudeDir);
 }
 
 /**
@@ -52,22 +52,25 @@ async function updateClaudeMd() {
     }
 
     const claudeMdPath = join(CWD, 'CLAUDE.md');
+    const claudeDir = join(CWD, '.claude');
 
-    // Check if this is first-time install
-    if (!existsSync(claudeMdPath)) {
-      // First time install - don't auto-generate, gaia-init handles it
+    // Check if .claude/ exists (indicates this is NOT first-time install)
+    if (!existsSync(claudeDir)) {
+      // True first-time install - skip, let gaia-init handle it
       spinner.info('First-time installation detected - skipping auto-update');
       return false;
     }
 
-    // Read template and copy it directly (no placeholder replacement)
-    // The template will be copied as-is with placeholders intact
+    // .claude/ exists, so this is an existing installation
+    // Regenerate CLAUDE.md (whether it exists or not)
+    const fileExistedBefore = existsSync(claudeMdPath);
     const template = await fs.readFile(templatePath, 'utf-8');
 
-    // Write updated CLAUDE.md (OVERWRITES existing file)
+    // Write/overwrite CLAUDE.md
     await fs.writeFile(claudeMdPath, template, 'utf-8');
 
-    spinner.succeed('CLAUDE.md updated successfully (existing file overwritten)');
+    const action = fileExistedBefore ? 'updated successfully (existing file overwritten)' : 'created successfully';
+    spinner.succeed(`CLAUDE.md ${action}`);
     return true;
   } catch (error) {
     spinner.fail(`Failed to update CLAUDE.md: ${error.message}`);
@@ -110,6 +113,74 @@ async function updateSettingsJson() {
   }
 }
 
+/**
+ * Recreate missing symlinks in .claude/ directory
+ */
+async function recreateSymlinks() {
+  const spinner = ora('Checking symlinks...').start();
+
+  try {
+    const claudeDir = join(CWD, '.claude');
+
+    // Skip if .claude/ doesn't exist (first-time install)
+    if (!existsSync(claudeDir)) {
+      spinner.info('First-time installation detected - skipping symlink check');
+      return false;
+    }
+
+    // Calculate relative path from .claude/ to node_modules/@jaguilar87/gaia-ops
+    const packagePath = join(CWD, 'node_modules', '@jaguilar87', 'gaia-ops');
+
+    // Verify package exists
+    if (!existsSync(packagePath)) {
+      spinner.fail('Package not found in node_modules');
+      return false;
+    }
+
+    const { relative } = await import('path');
+    const relativePath = relative(claudeDir, packagePath);
+
+    // Define all symlinks that should exist
+    const symlinks = [
+      { target: join(relativePath, 'agents'), link: join(claudeDir, 'agents'), name: 'agents' },
+      { target: join(relativePath, 'tools'), link: join(claudeDir, 'tools'), name: 'tools' },
+      { target: join(relativePath, 'hooks'), link: join(claudeDir, 'hooks'), name: 'hooks' },
+      { target: join(relativePath, 'commands'), link: join(claudeDir, 'commands'), name: 'commands' },
+      { target: join(relativePath, 'templates'), link: join(claudeDir, 'templates'), name: 'templates' },
+      { target: join(relativePath, 'config'), link: join(claudeDir, 'config'), name: 'config' },
+      { target: join(relativePath, 'speckit'), link: join(claudeDir, 'speckit'), name: 'speckit' },
+      { target: join(relativePath, 'CHANGELOG.md'), link: join(claudeDir, 'CHANGELOG.md'), name: 'CHANGELOG.md' }
+    ];
+
+    let recreated = 0;
+    for (const { target, link, name } of symlinks) {
+      // Check if symlink exists and is valid
+      if (existsSync(link)) {
+        continue; // Symlink exists, skip
+      }
+
+      // Symlink missing, recreate it
+      try {
+        await fs.symlink(target, link);
+        recreated++;
+      } catch (error) {
+        // Ignore errors, might be permissions or already exists
+      }
+    }
+
+    if (recreated > 0) {
+      spinner.succeed(`Recreated ${recreated} missing symlink(s)`);
+      return true;
+    } else {
+      spinner.succeed('All symlinks are valid');
+      return false;
+    }
+  } catch (error) {
+    spinner.fail(`Failed to check symlinks: ${error.message}`);
+    return false;
+  }
+}
+
 /**
  * Main function
  */
@@ -118,7 +189,7 @@ async function main() {
 
   try {
     // Check if this is an update (not first-time install)
-    const isUpdate = await claudeMdExists();
+    const isUpdate = await isExistingInstallation();
 
     if (isUpdate) {
       // Show warning before overwriting files
@@ -130,8 +201,9 @@ async function main() {
 
     const claudeUpdated = await updateClaudeMd();
     const settingsUpdated = await updateSettingsJson();
+    const symlinksRecreated = await recreateSymlinks();
 
-    if (claudeUpdated || settingsUpdated) {
+    if (claudeUpdated || settingsUpdated || symlinksRecreated) {
       console.log(chalk.green('\n✅ Auto-update completed\n'));
       console.log(chalk.yellow('⚠️  IMPORTANT: Files have been overwritten from templates'));
       console.log(chalk.gray('\nNext steps:'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaguilar87/gaia-ops",
-  "version": "2.5.3",
+  "version": "2.5.5",
   "description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
   "main": "index.js",
   "type": "module",
@@ -56,7 +56,8 @@
     "pre-publish:dry": "node bin/pre-publish-validate.js --dry-run",
     "pre-publish:validate": "node bin/pre-publish-validate.js --validate-only",
     "prepublishOnly": "npm run clean",
-    "postinstall": "node bin/gaia-update.js"
+    "postinstall": "node bin/gaia-update.js",
+    "preuninstall": "node bin/gaia-cleanup.js"
   },
   "_postinstall_note": "⚠️ postinstall hook overwrites CLAUDE.md and settings.json from templates on every npm install/update",
   "dependencies": {