wogiflow 1.0.18 → 1.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wogiflow",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "AI-powered development workflow management system with multi-model support",
   "main": "lib/index.js",
   "bin": {
@@ -11,7 +11,8 @@
     "flow": "./scripts/flow",
     "test": "node mcp-memory-server/test.js",
     "memory-server": "node mcp-memory-server/index.js",
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
   },
   "files": [
     "bin/",

package/scripts/preuninstall.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+/**
+ * WogiFlow preuninstall script
+ *
+ * Runs before npm uninstall to clean up WogiFlow-created files.
+ *
+ * Removes:
+ * - .workflow/ directory (all WogiFlow state and config)
+ * - .claude/commands/wogi-*.md (WogiFlow slash commands)
+ * - .claude/docs/ (WogiFlow documentation)
+ * - .claude/skills/ (WogiFlow skills - may contain user customizations)
+ * - .claude/hooks/ (WogiFlow hooks)
+ * - .claude/rules/ (WogiFlow rules)
+ * - CLAUDE.md (if contains WogiFlow marker)
+ *
+ * Preserves:
+ * - .claude/ directory structure (user may have other content)
+ * - User's git history
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Get project root (where npm uninstall is run)
+const PROJECT_ROOT = process.env.INIT_CWD || process.cwd();
+
+// Directories to remove completely
+const DIRS_TO_REMOVE = [
+  path.join(PROJECT_ROOT, '.workflow'),
+  path.join(PROJECT_ROOT, '.claude', 'docs'),
+  path.join(PROJECT_ROOT, '.claude', 'skills'),
+  path.join(PROJECT_ROOT, '.claude', 'hooks'),
+  path.join(PROJECT_ROOT, '.claude', 'rules')
+];
+
+// File patterns to remove
+const CLAUDE_COMMANDS_DIR = path.join(PROJECT_ROOT, '.claude', 'commands');
+const CLAUDE_MD_PATH = path.join(PROJECT_ROOT, 'CLAUDE.md');
+
+// WogiFlow marker in CLAUDE.md - more explicit to avoid false positives
+const WOGIFLOW_MARKER = 'WogiFlow methodology';
+
+// Debug logging helper
+function debugLog(message) {
+  if (process.env.DEBUG || process.env.WOGIFLOW_DEBUG) {
+    process.stderr.write(`[preuninstall] ${message}\n`);
+  }
+}
+
+/**
+ * Recursively remove a directory
+ */
+function removeDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    return { removed: false, reason: 'not found' };
+  }
+
+  try {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+    return { removed: true };
+  } catch (err) {
+    return { removed: false, reason: err.message };
+  }
+}
+
+/**
+ * Remove WogiFlow command files (wogi-*.md)
+ */
+function removeWogiCommands() {
+  if (!fs.existsSync(CLAUDE_COMMANDS_DIR)) {
+    return { count: 0, files: [] };
+  }
+
+  const removed = [];
+  const skipped = [];
+  try {
+    const files = fs.readdirSync(CLAUDE_COMMANDS_DIR);
+    for (const file of files) {
+      if (file.startsWith('wogi-') && file.endsWith('.md')) {
+        const filePath = path.join(CLAUDE_COMMANDS_DIR, file);
+        try {
+          fs.unlinkSync(filePath);
+          removed.push(file);
+        } catch (err) {
+          debugLog(`Failed to remove ${file}: ${err.message}`);
+          skipped.push(file);
+        }
+      }
+    }
+  } catch (err) {
+    debugLog(`Failed to read commands directory: ${err.message}`);
+  }
+
+  return { count: removed.length, files: removed, skipped };
+}
+
+/**
+ * Remove CLAUDE.md if it contains WogiFlow marker
+ * Note: Per security-patterns.md Rule #1, we don't use existsSync before readFileSync
+ * as it creates race conditions. The try-catch handles "file not found" gracefully.
+ */
+function removeClaudeMd() {
+  try {
+    const content = fs.readFileSync(CLAUDE_MD_PATH, 'utf-8');
+    if (content.includes(WOGIFLOW_MARKER)) {
+      fs.unlinkSync(CLAUDE_MD_PATH);
+      return { removed: true };
+    }
+    return { removed: false, reason: 'not a WogiFlow file' };
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return { removed: false, reason: 'not found' };
+    }
+    debugLog(`Failed to process CLAUDE.md: ${err.message}`);
+    return { removed: false, reason: err.message };
+  }
+}
+
+/**
+ * Clean up empty .claude directory if nothing left
+ * Returns info about what was preserved (for user visibility)
+ */
+function cleanupClaudeDir() {
+  const claudeDir = path.join(PROJECT_ROOT, '.claude');
+  const result = { removed: false, preserved: [] };
+
+  try {
+    const remaining = fs.readdirSync(claudeDir);
+
+    // Only remove if empty or only contains 'commands' with no files
+    if (remaining.length === 0) {
+      fs.rmdirSync(claudeDir);
+      result.removed = true;
+    } else if (remaining.length === 1 && remaining[0] === 'commands') {
+      const commandsDir = path.join(claudeDir, 'commands');
+      const commandFiles = fs.readdirSync(commandsDir);
+      if (commandFiles.length === 0) {
+        fs.rmdirSync(commandsDir);
+        fs.rmdirSync(claudeDir);
+        result.removed = true;
+      } else {
+        // Log non-WogiFlow files being preserved
+        result.preserved = commandFiles.filter(f => !f.startsWith('wogi-'));
+        if (result.preserved.length > 0) {
+          debugLog(`Preserving non-WogiFlow commands: ${result.preserved.join(', ')}`);
+        }
+      }
+    } else {
+      // Other content in .claude - log what's being preserved
+      result.preserved = remaining;
+      debugLog(`Preserving .claude contents: ${remaining.join(', ')}`);
+    }
+  } catch (err) {
+    if (err.code !== 'ENOENT') {
+      debugLog(`Cleanup error: ${err.message}`);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Check if we should be silent
+ */
+function shouldBeSilent() {
+  return process.env.CI || process.env.WOGIFLOW_SILENT_UNINSTALL;
+}
+
+/**
+ * Main entry point
+ */
+function main() {
+  const silent = shouldBeSilent();
+  const results = {
+    directories: [],
+    commands: null,
+    claudeMd: null
+  };
+
+  // Remove directories
+  for (const dir of DIRS_TO_REMOVE) {
+    const relativePath = path.relative(PROJECT_ROOT, dir);
+    const result = removeDir(dir);
+    results.directories.push({ path: relativePath, ...result });
+  }
+
+  // Remove wogi-*.md commands
+  results.commands = removeWogiCommands();
+
+  // Remove CLAUDE.md if WogiFlow-generated
+  results.claudeMd = removeClaudeMd();
+
+  // Clean up empty .claude directory
+  results.claudeDir = cleanupClaudeDir();
+
+  // Output summary
+  if (!silent) {
+    const removedDirs = results.directories.filter(d => d.removed);
+    const removedCount = removedDirs.length + results.commands.count + (results.claudeMd.removed ? 1 : 0);
+
+    if (removedCount > 0) {
+      process.stderr.write('\n\x1b[36mWogiFlow cleanup:\x1b[0m\n');
+
+      for (const dir of removedDirs) {
+        process.stderr.write(`  \x1b[31m✗\x1b[0m Removed ${dir.path}/\n`);
+      }
+
+      if (results.commands.count > 0) {
+        process.stderr.write(`  \x1b[31m✗\x1b[0m Removed ${results.commands.count} command(s): ${results.commands.files.join(', ')}\n`);
+      }
+
+      if (results.claudeMd.removed) {
+        process.stderr.write(`  \x1b[31m✗\x1b[0m Removed CLAUDE.md\n`);
+      }
+
+      // Show preserved files (user's custom content)
+      if (results.claudeDir && results.claudeDir.preserved && results.claudeDir.preserved.length > 0) {
+        process.stderr.write(`\n\x1b[33mPreserved:\x1b[0m ${results.claudeDir.preserved.join(', ')} (not WogiFlow files)\n`);
+      }
+
+      process.stderr.write('\n\x1b[2mWogiFlow has been uninstalled. Your git history is preserved.\x1b[0m\n\n');
+    } else {
+      process.stderr.write('\x1b[36mWogiFlow:\x1b[0m No files to clean up.\n');
+    }
+  }
+}
+
+// Run
+try {
+  main();
+} catch (err) {
+  // Don't fail npm uninstall on preuninstall errors
+  if (!process.env.CI) {
+    process.stderr.write(`\x1b[33mWogiFlow cleanup warning:\x1b[0m ${err.message}\n`);
+  }
+}