prjct-cli 0.8.2 → 0.8.4

package/core/command-registry.js

@@ -460,12 +460,12 @@ const COMMANDS = [
     category: 'setup',
     description: 'Reconfigure editor installations',
     usage: {
-      claude: null,
+      claude: '/p:setup',
       terminal: 'prjct setup [--force] [--editor <name>]',
     },
     params: '[--force] [--editor <name>]',
     implemented: true,
-    hasTemplate: false,
+    hasTemplate: true,
     icon: 'Settings',
     requiresInit: false,
     blockingRules: null,
@@ -475,12 +475,12 @@ const COMMANDS = [
     category: 'setup',
     description: 'Migrate all legacy projects',
     usage: {
-      claude: null,
+      claude: '/p:migrate-all',
       terminal: 'prjct migrate-all [--deep-scan] [--remove-legacy] [--dry-run]',
     },
     params: '[--deep-scan] [--remove-legacy] [--dry-run]',
     implemented: true,
-    hasTemplate: false,
+    hasTemplate: true,
     icon: 'Database',
     requiresInit: false,
     blockingRules: null,

package/core/infrastructure/command-installer.js

@@ -210,10 +210,9 @@ class CommandInstaller {
 
   /**
    * Install to all detected editors (alias for installCommands)
-   * @param {boolean} interactive - Whether to show interactive prompts
    * @returns {Promise<Object>} Installation results
    */
-  async installToAll(interactive = false) {
+  async installToAll() {
     return await this.installCommands()
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
@@ -12,6 +12,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
+    "update-commands": "node -e \"const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))\"",
     "install-global": "./scripts/install.sh",
     "update": "./scripts/update.sh",
     "test": "vitest run --workspace=vitest.workspace.js",

package/scripts/postinstall.js

@@ -6,16 +6,19 @@
  * Runs automatically after npm install -g prjct-cli
  *
  * 1. Detects if global install
- * 2. Installs/syncs commands to ~/.claude/commands/p/
- * 3. Installs/updates global config to ~/.claude/CLAUDE.md
- * 4. Migrates legacy projects automatically
- * 5. Shows beautiful ASCII art
+ * 2. Installs Claude Code CLI if not found (automatic)
+ * 3. Installs/syncs commands to ~/.claude/commands/p/
+ * 4. Installs/updates global config to ~/.claude/CLAUDE.md
+ * 5. Migrates all legacy projects automatically
+ * 6. Shows success message with results
  *
- * @version 0.8.2
+ * ZERO MANUAL STEPS - Everything is automatic
+ *
+ * @version 0.8.4
  */
 
-const fs = require('fs')
 const path = require('path')
+const { execSync } = require('child_process')
 const installer = require('../core/infrastructure/command-installer')
 const migrator = require('../core/infrastructure/migrator')
 const { VERSION } = require('../core/utils/version')
@@ -43,83 +46,65 @@ async function main() {
 
     console.log('')
     console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-    console.log(`${BOLD}${CYAN}🚀 Setting up prjct-cli...${NC}`)
+    console.log(`${BOLD}${CYAN}🚀 Setting up prjct-cli v${VERSION}${NC}`)
     console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
     console.log('')
 
-    // Step 1: Detect Claude Code
-    console.log(`${BOLD}[1/5]${NC} Detecting Claude Code...`)
+    const results = {
+      claudeInstalled: false,
+      commandsAdded: 0,
+      commandsUpdated: 0,
+      configAction: null,
+      projectsMigrated: 0
+    }
+
+    // Step 1: Ensure Claude Code CLI is installed
+    const hasClaude = await hasClaudeCodeCLI()
+
+    if (!hasClaude) {
+      const installed = await installClaudeCode()
+      if (installed) {
+        results.claudeInstalled = true
+      } else {
+        // Cannot continue without Claude Code
+        showFailureMessage()
+        return
+      }
+    }
+
+    // Step 2: Detect Claude directory (for commands)
     const claudeDetected = await installer.detectClaude()
 
-    if (!claudeDetected) {
-      console.log(`${YELLOW}⚠️  Claude Code not detected${NC}`)
-      console.log(`${DIM}Install Claude Code from: https://claude.ai/code${NC}`)
-      console.log(`${DIM}Then run: prjct setup${NC}`)
-      console.log('')
-    } else {
-      console.log(`${GREEN}✓${NC} Claude Code found`)
-      console.log('')
-
-      // Step 2: Install/sync commands
-      console.log(`${BOLD}[2/5]${NC} Installing commands to ~/.claude...`)
+    if (claudeDetected) {
+      // Step 3: Sync commands
       const syncResult = await installer.syncCommands()
 
       if (syncResult.success) {
-        const { added, updated, removed } = syncResult
-        const changes = []
-        if (added > 0) changes.push(`${added} nuevos`)
-        if (updated > 0) changes.push(`${updated} actualizados`)
-        if (removed > 0) changes.push(`${removed} eliminados`)
-
-        if (changes.length > 0) {
-          console.log(`${GREEN}✓${NC} ${changes.join(', ')}`)
-        } else {
-          console.log(`${GREEN}✓${NC} All commands up to date`)
-        }
-      } else {
-        console.log(`${YELLOW}⚠️  ${syncResult.error}${NC}`)
+        results.commandsAdded = syncResult.added
+        results.commandsUpdated = syncResult.updated
       }
-      console.log('')
 
-      // Step 3: Install global configuration
-      console.log(`${BOLD}[3/5]${NC} Installing global configuration...`)
+      // Step 4: Install global configuration
       const configResult = await installer.installGlobalConfig()
 
       if (configResult.success) {
-        if (configResult.action === 'created') {
-          console.log(`${GREEN}✓${NC} Created ~/.claude/CLAUDE.md`)
-        } else if (configResult.action === 'updated') {
-          console.log(`${GREEN}✓${NC} Updated ~/.claude/CLAUDE.md`)
-        } else if (configResult.action === 'appended') {
-          console.log(`${GREEN}✓${NC} Added prjct config to ~/.claude/CLAUDE.md`)
-        }
-      } else {
-        console.log(`${YELLOW}⚠️  ${configResult.error}${NC}`)
+        results.configAction = configResult.action
       }
-      console.log('')
-    }
 
-    // Step 4: Migrate legacy projects
-    console.log(`${BOLD}[4/5]${NC} Checking for legacy projects...`)
-    const migrationResult = await migrator.migrateAll({
-      deepScan: false,      // Only search common directories
-      cleanupLegacy: true,  // Remove legacy directories, keep config
-      dryRun: false
-    })
-
-    if (migrationResult.successfullyMigrated > 0) {
-      console.log(`${GREEN}✓${NC} ${migrationResult.successfullyMigrated} projects migrated to global storage`)
-    } else if (migrationResult.totalFound === 0) {
-      console.log(`${DIM}No legacy projects found${NC}`)
-    } else {
-      console.log(`${DIM}All projects already migrated${NC}`)
+      // Step 5: Migrate legacy projects automatically
+      const migrationResult = await migrator.migrateAll({
+        deepScan: false,
+        cleanupLegacy: true,
+        dryRun: false
+      })
+
+      if (migrationResult.successfullyMigrated > 0) {
+        results.projectsMigrated = migrationResult.successfullyMigrated
+      }
     }
-    console.log('')
 
-    // Step 5: Show ASCII art and quick start
-    console.log(`${BOLD}[5/5]${NC} Installation complete!`)
-    console.log('')
-    showAsciiArt()
+    // Show final success message
+    showSuccessMessage(results)
 
   } catch (error) {
     console.error(`${YELLOW}⚠️  Post-install error: ${error.message}${NC}`)
@@ -153,9 +138,42 @@ async function detectGlobalInstall() {
 }
 
 /**
- * Show beautiful ASCII art with quick start
+ * Check if Claude Code CLI is installed
+ */
+async function hasClaudeCodeCLI() {
+  try {
+    execSync('which claude', { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Install Claude Code CLI
+ */
+async function installClaudeCode() {
+  try {
+    console.log(`${YELLOW}📦 Claude Code not found. Installing...${NC}`)
+    console.log('')
+    execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' })
+    console.log('')
+    console.log(`${GREEN}✓${NC} Claude Code installed successfully`)
+    console.log('')
+    return true
+  } catch (error) {
+    console.log(`${YELLOW}⚠️  Failed to install Claude Code: ${error.message}${NC}`)
+    console.log(`${DIM}Please install manually: npm install -g @anthropic-ai/claude-code${NC}`)
+    console.log('')
+    return false
+  }
+}
+
+/**
+ * Show success message with results
  */
-function showAsciiArt() {
+function showSuccessMessage(results) {
+  console.log('')
   console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
   console.log('')
   console.log(`   ${BOLD}${CYAN}██████╗ ██████╗      ██╗ ██████╗████████╗${NC}`)
@@ -165,32 +183,69 @@ function showAsciiArt() {
   console.log(`   ${BOLD}${CYAN}██║     ██║  ██║╚█████╔╝╚██████╗   ██║${NC}`)
   console.log(`   ${BOLD}${CYAN}╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝${NC}`)
   console.log('')
-  console.log(`   ${BOLD}${CYAN}prjct${NC}${MAGENTA}/${NC}${GREEN}cli${NC}  ${DIM}${WHITE}v${VERSION} installed${NC}`)
+  console.log(`        ${BOLD}${GREEN}v${VERSION} READY!${NC}`)
   console.log('')
-  console.log(`   ${YELLOW}⚡${NC} Ship faster with zero friction`)
-  console.log(`   ${GREEN}📝${NC} From idea to technical tasks in minutes`)
-  console.log(`   ${CYAN}🤖${NC} Perfect context for AI agents`)
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+  console.log('')
+
+  // Show what was done
+  if (results.claudeInstalled) {
+    console.log(`   ${GREEN}✓${NC} Claude Code CLI installed`)
+  } else {
+    console.log(`   ${GREEN}✓${NC} Claude Code CLI found`)
+  }
+
+  const totalCommands = results.commandsAdded + results.commandsUpdated
+  if (totalCommands > 0) {
+    const parts = []
+    if (results.commandsAdded > 0) parts.push(`${results.commandsAdded} new`)
+    if (results.commandsUpdated > 0) parts.push(`${results.commandsUpdated} updated`)
+    console.log(`   ${GREEN}✓${NC} Commands synced (${parts.join(', ')})`)
+  } else {
+    console.log(`   ${GREEN}✓${NC} Commands up to date`)
+  }
+
+  if (results.configAction === 'created') {
+    console.log(`   ${GREEN}✓${NC} Global config created`)
+  } else if (results.configAction === 'updated') {
+    console.log(`   ${GREEN}✓${NC} Global config updated`)
+  } else if (results.configAction === 'appended') {
+    console.log(`   ${GREEN}✓${NC} Global config merged`)
+  }
+
+  if (results.projectsMigrated > 0) {
+    console.log(`   ${GREEN}✓${NC} ${results.projectsMigrated} projects migrated to global storage`)
+  }
+
   console.log('')
   console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
   console.log('')
-  console.log(`${BOLD}${CYAN}🚀 Quick Start${NC}`)
-  console.log(`${DIM}─────────────────────────────────────────────────${NC}`)
+  console.log(`${BOLD}Next steps:${NC}`)
+  console.log(`  ${DIM}cd your-project${NC}`)
+  console.log(`  ${GREEN}/p:init${NC}`)
+  console.log('')
+  console.log(`${BOLD}${MAGENTA}Happy shipping! 🚀${NC}`)
+  console.log('')
+}
+
+/**
+ * Show failure message
+ */
+function showFailureMessage() {
   console.log('')
-  console.log(`  ${BOLD}1.${NC} Initialize your project:`)
-  console.log(`     ${GREEN}cd your-project && prjct init${NC}`)
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
   console.log('')
-  console.log(`  ${BOLD}2.${NC} Set your current focus:`)
-  console.log(`     ${GREEN}prjct now "build auth"${NC}`)
+  console.log(`${YELLOW}⚠️  Setup incomplete${NC}`)
   console.log('')
-  console.log(`  ${BOLD}3.${NC} Ship & celebrate:`)
-  console.log(`     ${GREEN}prjct ship "user login"${NC}`)
+  console.log(`Claude Code is required for prjct-cli.`)
   console.log('')
-  console.log(`${DIM}─────────────────────────────────────────────────${NC}`)
+  console.log(`Please install manually:`)
+  console.log(`  ${GREEN}npm install -g @anthropic-ai/claude-code${NC}`)
   console.log('')
-  console.log(`  ${DIM}Documentation:${NC} ${CYAN}https://prjct.app${NC}`)
-  console.log(`  ${DIM}Report issues:${NC} ${CYAN}https://github.com/jlopezlira/prjct-cli/issues${NC}`)
+  console.log(`Then run:`)
+  console.log(`  ${GREEN}prjct setup${NC}`)
   console.log('')
-  console.log(`${BOLD}${MAGENTA}Happy shipping! 🚀${NC}`)
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
   console.log('')
 }
 

package/templates/commands/migrate-all.md

@@ -0,0 +1,120 @@
+# /p:migrate-all - Migrate All Legacy Projects
+
+Migrates all legacy prjct projects to the new global storage architecture.
+
+## Usage
+
+```
+/p:migrate-all [--deep-scan] [--remove-legacy] [--dry-run]
+```
+
+## What This Command Does
+
+1. **Scans Global Storage**
+   - Reads all project IDs from `~/.prjct-cli/projects/`
+   - Retrieves project paths from `project.json` files
+
+2. **Detects Legacy Structure**
+   - Checks each project for old `.prjct/` directory structure
+   - Identifies projects that need migration
+
+3. **Migrates Each Project**
+   - Moves data from local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
+   - Creates new minimal local config (`.prjct/prjct.config.json`)
+   - Preserves all project data and history
+
+4. **Cleanup (Optional)**
+   - Removes legacy `.prjct/` directories (with `--remove-legacy`)
+   - Keeps only the new minimal config file
+
+5. **Reports Summary**
+   - Shows migrated, skipped, and failed projects
+   - Lists detailed errors for any failures
+
+## Options
+
+- `--deep-scan`: Scan entire file system (slow but thorough)
+- `--remove-legacy`: Delete old `.prjct/` directories after successful migration
+- `--dry-run`: Show what would be migrated without making changes
+
+## When to Use
+
+- **After major version updates**: When architecture changes
+- **Upgrading from v0.7.x to v0.8.x**: New global storage system
+- **Consolidating projects**: Moving all projects to global storage
+- **Troubleshooting**: If projects aren't working after update
+
+## Migration Process
+
+### Before (Legacy Structure)
+```
+your-project/
+  .prjct/
+    core/
+    planning/
+    progress/
+    memory/
+    analysis/
+    prjct.config.json  # Full config
+```
+
+### After (Global Storage)
+```
+your-project/
+  .prjct/
+    prjct.config.json  # Minimal (projectId + dataPath only)
+
+~/.prjct-cli/projects/3a5667a5dedb/
+  core/
+  planning/
+  progress/
+  memory/
+  analysis/
+  agents/
+  project.json  # System config (authors, version, etc.)
+```
+
+## Output Example
+
+```
+🔄 Scanning for legacy prjct projects...
+
+📁 Found 3 projects in global storage
+
+🔄 Migrating: /Users/jj/Apps/my-app
+   ✅ Migrated successfully
+
+🔄 Migrating: /Users/jj/Apps/other-project
+   ⏭️  Already migrated
+
+📊 Migration Summary:
+   ✅ Migrated: 1
+   ⏭️  Skipped: 1
+   ❌ Failed: 0
+```
+
+## Error Handling
+
+- **No global storage**: Creates directory structure
+- **Missing project paths**: Skips projects with invalid paths
+- **Permission errors**: Reports which projects couldn't be migrated
+- **Already migrated**: Safely skips without changes
+
+## Safety
+
+- **Idempotent**: Safe to run multiple times
+- **Non-destructive**: Original files only removed with `--remove-legacy`
+- **Dry run available**: Test migration with `--dry-run` first
+- **Automatic backup**: Legacy data preserved until explicitly removed
+
+## Requirements
+
+- Write permissions to `~/.prjct-cli/` and project directories
+- Projects must have valid global config in `project.json`
+
+## Notes
+
+- This command does NOT require an initialized prjct project
+- Migration is automatic on install (but manual execution is safer)
+- Always test with `--dry-run` first for large migrations
+- Can be safely interrupted and resumed

package/templates/commands/setup.md

@@ -0,0 +1,74 @@
+# /p:setup - Reconfigure prjct-cli Installation
+
+Reconfigures prjct-cli installation for Claude Code and Claude Desktop.
+
+## Usage
+
+```
+/p:setup [--force]
+```
+
+## What This Command Does
+
+1. **Detects Claude Installation**
+   - Checks if `~/.claude/` directory exists
+   - Verifies Claude Code or Claude Desktop is installed
+
+2. **Syncs Commands to Claude**
+   - Updates all `/p:*` commands in `~/.claude/commands/p/`
+   - Adds new commands from latest version
+   - Updates existing commands with latest templates
+   - Removes orphaned/deprecated commands
+
+3. **Installs/Updates Global Configuration**
+   - Creates or updates `~/.claude/CLAUDE.md`
+   - Adds prjct-specific instructions for Claude
+   - Preserves existing user configuration
+
+4. **Reports Results**
+   - Shows commands added, updated, removed
+   - Displays any errors encountered
+   - Confirms successful installation
+
+## Options
+
+- `--force`: Remove existing installation and reinstall from scratch
+
+## When to Use
+
+- **After updating prjct-cli**: `npm update -g prjct-cli && /p:setup`
+- **Commands not working**: If `/p:*` commands aren't recognized
+- **Fresh installation**: After installing on a new machine
+- **Troubleshooting**: When encountering command-related issues
+
+## Requirements
+
+- Claude Code or Claude Desktop must be installed
+- Write permissions to `~/.claude/` directory
+
+## Output Example
+
+```
+🔧 Reconfiguring prjct...
+
+📦 Installing /p:* commands...
+✓ 3 nuevos, 12 actualizados, 1 eliminado
+
+📝 Installing global configuration...
+✓ Updated ~/.claude/CLAUDE.md
+
+✅ Setup complete!
+```
+
+## Error Handling
+
+- **Claude not detected**: Shows installation URLs for Claude Code/Desktop
+- **Permission errors**: Reports which files couldn't be written
+- **Template errors**: Lists which commands failed to install
+
+## Notes
+
+- This command does NOT migrate projects (use `/p:migrate-all` for that)
+- This command does NOT require an initialized prjct project
+- Safe to run multiple times (idempotent)
+- Will not overwrite user customizations in `~/.claude/CLAUDE.md`