prjct-cli 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -15,6 +15,60 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cross-platform file operations
   - Windows Terminal integration
 
+## [0.4.4] - 2025-10-02
+
+### Added
+- **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
+  - New `core/editors-config.js` tracks which editors user has installed commands to
+  - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
+  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
+  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
+  - No manual reinstallation needed - updates happen automatically
+  - Respects user's original editor choices from initial setup
+
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
+- **Automatic Data Migration** - Seamless upgrade from v0.1.0 to v0.4.4
+  - Post-install hook automatically detects legacy `.prjct/` projects
+  - Migrates data from local structure to new global architecture (`~/.prjct-cli/projects/{id}/`)
+  - Scans common project directories (Projects, Documents, Developer, Code, etc.)
+  - Preserves all project data during migration (now, next, shipped, ideas, memory)
+  - Cleans up legacy directories while keeping config for compatibility
+  - No user intervention required - migration happens automatically on update
+  - Uses existing battle-tested `core/migrator.js` system
+
+### Changed
+- **Improved Command Tracking** - Always track editor installations for better update management
+  - Modified `installToSelected()` to always save editor config (removed `!forceUpdate` restriction)
+  - Ensures tracking happens even during force updates
+  - Enables reliable auto-updates across all configured editors
+
+### Technical Details
+- **Post-Install Hook**: Runs after `npm install -g prjct-cli` or `npm update -g prjct-cli`
+  - First install: Auto-detects editors and installs commands
+  - Updates: Checks version change and auto-updates commands in tracked editors
+  - **Migration**: Automatically detects and migrates legacy projects from v0.1.0
+  - Silent operation with debug mode via `DEBUG=1` environment variable
+- **Pre-Uninstall Hook**: Runs before `npm uninstall -g prjct-cli`
+  - Reads tracking config to find all installed editors
+  - Removes command directories from each editor
+  - Cleans up tracking configuration
+  - Fails gracefully to not block uninstall
+- **Migration System**: Automatic upgrade path from v0.1.0 to v0.4.4
+  - Scans common project directories (fast, non-intrusive)
+  - Migrates local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
+  - Preserves all data: core, progress, planning, analysis, memory layers
+  - Cleans legacy directories while keeping compatibility config
+  - Zero data loss, seamless upgrade experience
+
 ## [0.4.3] - 2025-10-02
 
 ### Added
@@ -22,10 +76,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - New `core/editors-config.js` tracks which editors user has installed commands to
   - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
   - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
   - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
   - No manual reinstallation needed - updates happen automatically
   - Respects user's original editor choices from initial setup
 
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
 - **GitHub Packages Support** - Dual registry publication for better reliability
   - Package now published to both npm and GitHub Packages automatically
   - GitHub Actions workflow updated to publish to both registries in parallel
@@ -40,9 +104,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Alternative: GitHub Packages (for advanced users or npm fallback)
   - Clear instructions for both installation methods
 
+- **Command Installer Improvements**
+  - `installToSelected()` now always saves editor config (removed force-update restriction)
+  - Better tracking ensures updates work correctly even for force updates
+  - Improved error handling and reporting
+
 ### Technical Details
-- **Editor Tracking**: Configuration saved after successful command installation
-- **Post-Install Hook**: Runs only for global installations, skips for local/dev installs
+- **Editor Tracking**: Configuration saved after all successful command installations
+- **Post-Install Hook**:
+  - Runs only for global installations, skips for local/dev installs
+  - Auto-detects and installs to all AI editors on first install
+  - Auto-updates commands when version changes
+- **Pre-Uninstall Hook**:
+  - Runs only for global uninstallations
+  - Removes slash commands from `~/.claude/`, `~/.cursor/`, `~/.windsurf/`
+  - Removes AGENTS.md from `~/.codex/` if present
+  - Deletes tracking configuration
 - **Version Detection**: Compares current version with last installed version
 - **Force Update**: Automatically updates commands when version changes
 - **Parallel Publication**: npm and GitHub Packages jobs run simultaneously for faster releases

package/core/command-installer.js

@@ -444,8 +444,8 @@ For detailed implementation, see prjct-cli documentation.
     const totalUpdated = Object.values(results)
       .reduce((sum, r) => sum + (r.updated || 0), 0)
 
-    // Save editor selections to config (only on successful new installations, not updates)
-    if (!forceUpdate && successfulEditors.length > 0) {
+    // Always save editor selections to config for tracking updates
+    if (successfulEditors.length > 0) {
       await this.saveEditorConfig(successfulEditors)
     }
 
@@ -807,6 +807,119 @@ This command uses the global prjct architecture:
 
     return results
   }
+
+  /**
+   * Uninstall commands from a specific editor
+   * @param {string} editorKey - Editor identifier (claude, cursor, codex, windsurf)
+   * @returns {Promise<Object>} Uninstallation result
+   */
+  async uninstallFromEditor(editorKey) {
+    const editor = this.editors[editorKey]
+
+    if (!editor) {
+      return { success: false, editor: editorKey, message: `Unknown editor: ${editorKey}` }
+    }
+
+    try {
+      switch (editor.format) {
+        case 'slash-commands':
+          // Remove the /p commands directory
+          await fs.rm(editor.commandsPath, { recursive: true, force: true })
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed slash commands from ${editor.name}`,
+          }
+
+        case 'agents-md':
+          // Remove AGENTS.md if it exists
+          const exists = await this.fileExists(editor.commandsPath)
+          if (exists) {
+            await fs.unlink(editor.commandsPath)
+          }
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed AGENTS.md from ${editor.name}`,
+          }
+
+        case 'workflows':
+          // Remove all p_*.md workflow files
+          try {
+            const files = await fs.readdir(editor.commandsPath)
+            const prjctWorkflows = files.filter(f => f.startsWith('p_') && f.endsWith('.md'))
+
+            for (const file of prjctWorkflows) {
+              await fs.unlink(path.join(editor.commandsPath, file))
+            }
+
+            return {
+              success: true,
+              editor: editor.name,
+              path: editor.commandsPath,
+              removed: prjctWorkflows.length,
+              message: `Removed ${prjctWorkflows.length} workflows from ${editor.name}`,
+            }
+          } catch (error) {
+            // Directory might not exist, that's ok
+            return {
+              success: true,
+              editor: editor.name,
+              message: `No workflows found in ${editor.name}`,
+            }
+          }
+
+        default:
+          return {
+            success: false,
+            editor: editor.name,
+            message: `Unknown format: ${editor.format}`,
+          }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        editor: editor.name,
+        message: `Uninstall failed: ${error.message}`,
+      }
+    }
+  }
+
+  /**
+   * Uninstall commands from all tracked editors
+   * @returns {Promise<Object>} Uninstallation results
+   */
+  async uninstallFromAll() {
+    const editorsConfig = require('./editors-config')
+    const trackedEditors = await editorsConfig.getTrackedEditors()
+
+    if (trackedEditors.length === 0) {
+      return {
+        success: true,
+        message: 'No editors tracked, nothing to uninstall',
+        results: {},
+      }
+    }
+
+    const results = {}
+    const successfulEditors = []
+
+    for (const editorKey of trackedEditors) {
+      results[editorKey] = await this.uninstallFromEditor(editorKey)
+      if (results[editorKey].success) {
+        successfulEditors.push(this.editors[editorKey]?.name || editorKey)
+      }
+    }
+
+    return {
+      success: true,
+      editors: successfulEditors,
+      totalRemoved: successfulEditors.length,
+      results,
+    }
+  }
 }
 
 module.exports = new CommandInstaller()

package/core/editors-config.js

@@ -155,6 +155,24 @@ class EditorsConfig {
       return false
     }
   }
+
+  /**
+   * Delete configuration file
+   * Used during uninstallation to clean up tracking data
+   * @returns {Promise<boolean>} Success status
+   */
+  async deleteConfig() {
+    try {
+      const exists = await this.configExists()
+      if (exists) {
+        await fs.unlink(this.configFile)
+      }
+      return true
+    } catch (error) {
+      console.error('[editors-config] Error deleting config:', error.message)
+      return false
+    }
+  }
 }
 
 module.exports = new EditorsConfig()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
   "main": "core/index.js",
   "bin": {
@@ -12,6 +12,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/post-install.js",
+    "preuninstall": "node scripts/preuninstall.js",
     "install-global": "./scripts/install.sh",
     "test": "echo 'No tests configured'",
     "lint": "eslint \"**/*.js\" --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
@@ -69,6 +70,7 @@
     "scripts/install.sh",
     "scripts/verify-installation.sh",
     "scripts/post-install.js",
+    "scripts/preuninstall.js",
     "LICENSE",
     "README.md",
     "CHANGELOG.md",

package/scripts/post-install.js

@@ -12,7 +12,7 @@
  * 3. If config exists and version changed, force-update commands in tracked editors
  * 4. Update version in config
  *
- * @version 0.4.2
+ * @version 0.4.4
  */
 
 const path = require('path')
@@ -34,8 +34,36 @@ async function main() {
     const configExists = await editorsConfig.configExists()
 
     if (!configExists) {
-      // First-time install, no editors tracked yet
-      // User will configure editors during `prjct init` or `prjct install`
+      // First-time install - auto-detect and install to all editors
+      console.log(chalk.cyan('\n🔍 First-time installation detected...\n'))
+
+      // Load command installer
+      const commandInstaller = require('../core/command-installer')
+
+      // Detect available editors
+      const detected = await commandInstaller.detectEditors()
+      const detectedEditors = Object.entries(detected)
+        .filter(([_, info]) => info.detected)
+        .map(([key, _]) => key)
+
+      if (detectedEditors.length === 0) {
+        // No editors detected, user will install manually later
+        console.log(chalk.yellow('ℹ️  No AI editors detected'))
+        console.log(chalk.gray('   Run `prjct install` when you set up Claude Code, Cursor, or Windsurf\n'))
+        return
+      }
+
+      console.log(chalk.cyan(`📦 Installing commands to: ${detectedEditors.map(k => commandInstaller.editors[k]?.name || k).join(', ')}\n`))
+
+      // Install to all detected editors
+      const results = await commandInstaller.installToAll(false)
+
+      if (results.success) {
+        console.log(chalk.green(`✅ Commands installed in: ${results.editors.join(', ')}`))
+        console.log(chalk.gray(`   Commands installed: ${results.totalInstalled}`))
+        console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
+      }
+
       return
     }
 
@@ -78,6 +106,34 @@ async function main() {
     // Update version in config
     await editorsConfig.updateVersion(currentVersion)
 
+    // Auto-migrate legacy projects (v0.1.0 → v0.4.4)
+    try {
+      console.log(chalk.cyan('\n🔍 Checking for legacy projects to migrate...\n'))
+
+      const migrator = require('../core/migrator')
+
+      // Quick scan of common directories (not entire home directory)
+      const summary = await migrator.migrateAll({
+        deepScan: false,        // Only scan common dirs (fast)
+        removeLegacy: false,    // Keep legacy dirs for safety
+        cleanupLegacy: true,    // Remove old dirs but keep config
+        dryRun: false,          // Actually perform migration
+        interactive: false      // No user prompts during npm install
+      })
+
+      if (summary.successfullyMigrated > 0) {
+        console.log(chalk.green(`✅ Migrated ${summary.successfullyMigrated} legacy project(s) to new structure`))
+        console.log(chalk.gray(`   Data location: ~/.prjct-cli/projects/`))
+      } else if (summary.totalFound > 0 && summary.alreadyMigrated === summary.totalFound) {
+        console.log(chalk.gray('ℹ️  All projects already using new structure'))
+      }
+    } catch (migrationError) {
+      // Don't block install if migration fails
+      if (process.env.DEBUG) {
+        console.error(chalk.yellow('[post-install] Migration warning:'), migrationError.message)
+      }
+    }
+
     console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
 
   } catch (error) {

package/scripts/preuninstall.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-Uninstall Script
+ *
+ * Runs automatically BEFORE `npm uninstall -g prjct-cli`.
+ * Cleans up slash commands from all tracked AI editors.
+ *
+ * Flow:
+ * 1. Check if running as global uninstall
+ * 2. Read tracked editors from ~/.prjct-cli/config/installed-editors.json
+ * 3. Remove all prjct commands from tracked editors
+ * 4. Delete tracking configuration
+ * 5. Clean exit (don't block uninstall)
+ *
+ * @version 0.4.4
+ */
+
+const chalk = require('chalk')
+const { execSync } = require('child_process')
+const path = require('path')
+
+async function main() {
+  try {
+    // Check if this is a global uninstallation
+    const isGlobal = await checkIfGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip cleanup for local/dev uninstalls
+      return
+    }
+
+    // Load editors config
+    const editorsConfig = require('../core/editors-config')
+    const configExists = await editorsConfig.configExists()
+
+    if (!configExists) {
+      // No config, nothing to clean up
+      return
+    }
+
+    console.log(chalk.cyan('\n🧹 Cleaning up prjct commands from AI editors...\n'))
+
+    // Load command installer
+    const commandInstaller = require('../core/command-installer')
+
+    // Uninstall from all tracked editors
+    const results = await commandInstaller.uninstallFromAll()
+
+    if (results.success && results.editors.length > 0) {
+      console.log(chalk.green(`✅ Removed from: ${results.editors.join(', ')}`))
+    }
+
+    // Delete tracking config
+    await editorsConfig.deleteConfig()
+
+    console.log(chalk.green('\n✨ prjct-cli uninstalled cleanly\n'))
+
+  } catch (error) {
+    // Silently fail - don't block npm uninstall
+    // Only log if explicitly debugging
+    if (process.env.DEBUG) {
+      console.error(chalk.red('[preuninstall] Error:'), error.message)
+    }
+  }
+}
+
+/**
+ * Check if package is being uninstalled globally
+ * @returns {Promise<boolean>} True if global uninstall
+ */
+async function checkIfGlobalInstall() {
+  try {
+    // Get npm global root directory
+    const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim()
+
+    // Get current package directory
+    const currentDir = path.resolve(__dirname, '..')
+
+    // Check if current directory is under global node_modules
+    return currentDir.startsWith(globalRoot)
+  } catch {
+    return false
+  }
+}
+
+// Run main function
+main().catch(error => {
+  // Silently fail - don't block npm uninstall
+  if (process.env.DEBUG) {
+    console.error('[preuninstall] Fatal error:', error)
+  }
+  process.exit(0) // Exit with success to not block npm uninstall
+})