prjct-cli 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -7,6 +7,103 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.2] - 2025-10-05
+
+### Changed
+
+- **BREAKING: npm-only installation** - Simplified installation to npm-only
+  - ✅ Single command: `npm install -g prjct-cli`
+  - ✅ Automatic setup via postinstall hook
+  - ✅ Auto-migration of legacy projects
+  - ✅ Beautiful ASCII art on installation
+  - ⚠️ `curl -fsSL https://prjct.app/install.sh` now deprecated (shows migration message)
+
+### Added
+
+- **Automatic Post-Install Setup** (`scripts/postinstall.js`)
+  - Runs automatically after `npm install -g prjct-cli`
+  - Detects global vs local installation
+  - Installs/syncs commands to `~/.claude/commands/p/`
+  - Migrates legacy projects automatically
+  - Shows beautiful ASCII art with quick start guide
+
+- **Intelligent Command Sync** (`syncCommands()` in `command-installer.js`)
+  - Detects new commands and installs them
+  - Detects updated commands and refreshes them
+  - **Detects orphaned commands and removes them** (e.g., context.md, stuck.md)
+  - Reports: "✓ 2 nuevos, 5 actualizados, 2 eliminados"
+
+- **Beautiful ASCII Art** (`showAsciiArt()` in `commands.js`)
+  - Displays after `prjct setup` completion
+  - Shows prjct logo with colors
+  - Includes quick start guide
+  - Links to documentation
+
+- **Global Configuration** (`~/.claude/CLAUDE.md`)
+  - Automatically installs/updates global configuration for Claude Code
+  - Provides context for ALL `/p:*` commands across any prjct project
+  - Intelligent merge: preserves user content, updates only prjct section
+  - Includes path resolution rules, file structure, commit format, validation patterns
+  - Installed during `npm install -g prjct-cli` and `prjct setup`
+  - Single source of truth - no need to repeat in 25 command templates
+
+### Fixed
+
+- **Orphaned Commands Cleanup** - Removed deprecated commands
+  - Deleted `context.md` (replaced by context tracking in core)
+  - Deleted `stuck.md` (functionality merged into /p:ask)
+  - Total commands: 27 → 25 (cleaned up)
+
+- **Context Preservation** - All projects now use global storage
+  - Legacy projects in `.prjct/` automatically migrated to `~/.prjct-cli/projects/{id}/`
+  - Only `prjct.config.json` (2KB) remains in project directory
+  - Prevents context loss on updates
+
+### Documentation
+
+- Updated README.md with new installation flow
+- Added "Auto-Setup (NEW in v0.8.2)" section
+- Simplified installation instructions
+- Deprecated manual installation methods
+
+## [0.8.1] - 2025-10-05
+
+### Fixed
+
+- **Critical Installation Bug** - Fixed incorrect path in `install.sh` line 315
+  - Changed `./core/command-installer` → `./core/infrastructure/command-installer`
+  - Resolves "Cannot find module" error during installation
+
+- **Missing Method Error** - Added `installToAll()` method to command-installer
+  - Implements method called by install.sh line 316
+  - Acts as alias for `installCommands()` for backward compatibility
+
+- **Commands Not Auto-Updating** - Implemented automatic command synchronization
+  - After `git pull`, commands in `~/.claude/commands/p/` now update automatically
+  - Added visual confirmation: "Commands synchronized ✓"
+
+- **Missing Visual Confirmation** - Added ASCII confirmation in setup.sh
+  - Displays "✨ Setup Complete! ✨" after successful npm install
+  - Clear feedback that installation succeeded
+
+### Added
+
+- **Update Script** - New `scripts/update.sh` for easy updates
+  - Single command to update prjct-cli: `npm run update`
+  - Handles: git pull → npm install → command updates
+  - Visual progress indicators and confirmation
+
+- **Enhanced Logging** - Improved updateCommands() with visual feedback
+  - Shows "🔄 Updating commands with latest templates..."
+  - Displays "✅ Updated X commands" on success
+
+### Changed
+
+- **Installation Flow** - Simplified and more reliable
+  - Auto-updates commands after git pull (no manual reinstall needed)
+  - Single npm install (eliminated duplication)
+  - Clear visual feedback at each step
+
 ## [0.8.0] - 2025-10-05
 
 ### Added

package/README.md

@@ -73,23 +73,27 @@ For easier installation from GitHub Packages, see [GitHub Packages Setup](docs/G
 
 > **Note**: The CLI automatically detects updates and notifies you when a new version is available. Simply run `npm update -g prjct-cli` to upgrade.
 
-### Editor Command Installation
+### Auto-Setup (NEW in v0.8.2)
 
-After initial installation, `prjct` automatically installs slash commands to Claude:
+After `npm install -g prjct-cli`, setup runs automatically:
 
-```bash
-# Interactive installation (recommended)
-prjct install
+- ✅ Installs `/p:*` commands to `~/.claude`
+- ✅ Migrates legacy projects to global storage
+- ✅ Syncs commands (removes orphans, adds new ones)
+- ✅ Shows beautiful ASCII art with quick start
 
-# Force update existing commands
-prjct install --force
-```
+**That's it!** No manual setup required.
+
+If you need to reconfigure later:
 
-**Installation Location:**
+```bash
+prjct setup          # Reconfigure and sync commands
+prjct setup --force  # Force reinstall all commands
+```
 
-- **Claude Code & Claude Desktop**: `~/.claude/commands/p/`
+**Installation Location**: `~/.claude/commands/p/`
 
-All 18 slash commands (`/p:*`) are automatically installed to Claude Code and Claude Desktop.
+All 25+ slash commands (`/p:*`) are automatically installed to Claude Code and Claude Desktop.
 
 ### Version Management
 

package/core/commands.js

@@ -2593,7 +2593,26 @@ Agent: ${agent}
       result.errors.forEach((e) => console.log(`   - ${e.file}: ${e.error}`))
     }
 
-    console.log('\n🎉 Setup complete!')
+    // Install global configuration
+    console.log('\n📝 Installing global configuration...')
+    const configResult = await commandInstaller.installGlobalConfig()
+
+    if (configResult.success) {
+      if (configResult.action === 'created') {
+        console.log('✅ Created ~/.claude/CLAUDE.md')
+      } else if (configResult.action === 'updated') {
+        console.log('✅ Updated ~/.claude/CLAUDE.md')
+      } else if (configResult.action === 'appended') {
+        console.log('✅ Added prjct config to ~/.claude/CLAUDE.md')
+      }
+    } else {
+      console.log(`⚠️  ${configResult.error}`)
+    }
+
+    console.log('\n🎉 Setup complete!\n')
+
+    // Show beautiful ASCII art
+    this.showAsciiArt()
 
     return {
       success: true,
@@ -2601,6 +2620,50 @@ Agent: ${agent}
     }
   }
 
+  /**
+   * Show beautiful ASCII art with quick start
+   */
+  showAsciiArt() {
+    const chalk = require('chalk')
+
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+    console.log('')
+    console.log(chalk.bold.cyan('   ██████╗ ██████╗      ██╗ ██████╗████████╗'))
+    console.log(chalk.bold.cyan('   ██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝'))
+    console.log(chalk.bold.cyan('   ██████╔╝██████╔╝     ██║██║        ██║'))
+    console.log(chalk.bold.cyan('   ██╔═══╝ ██╔══██╗██   ██║██║        ██║'))
+    console.log(chalk.bold.cyan('   ██║     ██║  ██║╚█████╔╝╚██████╗   ██║'))
+    console.log(chalk.bold.cyan('   ╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝'))
+    console.log('')
+    console.log(`   ${chalk.bold.cyan('prjct')}${chalk.magenta('/')}${chalk.green('cli')}  ${chalk.dim.white('v' + VERSION + ' installed')}`)
+    console.log('')
+    console.log(`   ${chalk.yellow('⚡')} Ship faster with zero friction`)
+    console.log(`   ${chalk.green('📝')} From idea to technical tasks in minutes`)
+    console.log(`   ${chalk.cyan('🤖')} Perfect context for AI agents`)
+    console.log('')
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+    console.log('')
+    console.log(chalk.bold.cyan('🚀 Quick Start'))
+    console.log(chalk.dim('─────────────────────────────────────────────────'))
+    console.log('')
+    console.log(`  ${chalk.bold('1.')} Initialize your project:`)
+    console.log(`     ${chalk.green('cd your-project && prjct init')}`)
+    console.log('')
+    console.log(`  ${chalk.bold('2.')} Set your current focus:`)
+    console.log(`     ${chalk.green('prjct now "build auth"')}`)
+    console.log('')
+    console.log(`  ${chalk.bold('3.')} Ship & celebrate:`)
+    console.log(`     ${chalk.green('prjct ship "user login"')}`)
+    console.log('')
+    console.log(chalk.dim('─────────────────────────────────────────────────'))
+    console.log('')
+    console.log(`  ${chalk.dim('Documentation:')} ${chalk.cyan('https://prjct.app')}`)
+    console.log(`  ${chalk.dim('Report issues:')} ${chalk.cyan('https://github.com/jlopezlira/prjct-cli/issues')}`)
+    console.log('')
+    console.log(chalk.bold.magenta('Happy shipping! 🚀'))
+    console.log('')
+  }
+
   /**
    * Migrate all legacy projects
    */

package/core/infrastructure/command-installer.js

@@ -200,6 +200,20 @@ class CommandInstaller {
    */
   async updateCommands() {
     // Simply reinstall - will overwrite with latest templates
+    console.log('🔄 Updating commands with latest templates...')
+    const result = await this.installCommands()
+    if (result.success) {
+      console.log(`✅ Updated ${result.installed.length} commands`)
+    }
+    return result
+  }
+
+  /**
+   * 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) {
     return await this.installCommands()
   }
 
@@ -225,6 +239,201 @@ class CommandInstaller {
       return false
     }
   }
+
+  /**
+   * Sync commands - intelligent update that detects and removes orphans
+   * @returns {Promise<Object>} Sync results with added, updated, removed counts
+   */
+  async syncCommands() {
+    const claudeDetected = await this.detectClaude()
+
+    if (!claudeDetected) {
+      return {
+        success: false,
+        error: 'Claude not detected',
+        added: 0,
+        updated: 0,
+        removed: 0,
+      }
+    }
+
+    try {
+      // Ensure commands directory exists
+      await fs.mkdir(this.claudeCommandsPath, { recursive: true })
+
+      // Get current state
+      const templateFiles = await this.getCommandFiles()
+      let installedFiles = []
+
+      try {
+        installedFiles = await fs.readdir(this.claudeCommandsPath)
+        installedFiles = installedFiles.filter((f) => f.endsWith('.md'))
+      } catch {
+        // Directory doesn't exist yet
+        installedFiles = []
+      }
+
+      const results = {
+        success: true,
+        added: 0,
+        updated: 0,
+        removed: 0,
+        errors: [],
+      }
+
+      // Detect new and updated files
+      for (const file of templateFiles) {
+        try {
+          const sourcePath = path.join(this.templatesDir, file)
+          const destPath = path.join(this.claudeCommandsPath, file)
+
+          // Check if file exists in installed location
+          const exists = installedFiles.includes(file)
+
+          if (!exists) {
+            // New file
+            const content = await fs.readFile(sourcePath, 'utf-8')
+            await fs.writeFile(destPath, content, 'utf-8')
+            results.added++
+          } else {
+            // Check if updated (compare modification time or content)
+            const sourceStats = await fs.stat(sourcePath)
+            const destStats = await fs.stat(destPath)
+
+            if (sourceStats.mtime > destStats.mtime) {
+              // Updated file
+              const content = await fs.readFile(sourcePath, 'utf-8')
+              await fs.writeFile(destPath, content, 'utf-8')
+              results.updated++
+            }
+          }
+        } catch (error) {
+          results.errors.push({ file, error: error.message })
+        }
+      }
+
+      // Detect and remove orphaned files
+      const orphans = installedFiles.filter((file) => !templateFiles.includes(file))
+
+      for (const orphan of orphans) {
+        try {
+          const orphanPath = path.join(this.claudeCommandsPath, orphan)
+          await fs.unlink(orphanPath)
+          results.removed++
+        } catch (error) {
+          results.errors.push({ file: orphan, error: error.message })
+        }
+      }
+
+      return results
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message,
+        added: 0,
+        updated: 0,
+        removed: 0,
+      }
+    }
+  }
+
+  /**
+   * Install or update global CLAUDE.md configuration
+   * @returns {Promise<Object>} Result with success status and action taken
+   */
+  async installGlobalConfig() {
+    const claudeDetected = await this.detectClaude()
+
+    if (!claudeDetected) {
+      return {
+        success: false,
+        error: 'Claude not detected',
+        action: 'skipped',
+      }
+    }
+
+    try {
+      // Ensure ~/.claude directory exists
+      const claudeDir = path.join(require('os').homedir(), '.claude')
+      await fs.mkdir(claudeDir, { recursive: true })
+
+      const globalConfigPath = path.join(claudeDir, 'CLAUDE.md')
+      const templatePath = path.join(__dirname, '../../templates/global/CLAUDE.md')
+
+      // Read template content
+      const templateContent = await fs.readFile(templatePath, 'utf-8')
+
+      // Check if global config already exists
+      let existingContent = ''
+      let fileExists = false
+
+      try {
+        existingContent = await fs.readFile(globalConfigPath, 'utf-8')
+        fileExists = true
+      } catch {
+        // File doesn't exist, will create new
+        fileExists = false
+      }
+
+      if (!fileExists) {
+        // Create new file with full template
+        await fs.writeFile(globalConfigPath, templateContent, 'utf-8')
+        return {
+          success: true,
+          action: 'created',
+          path: globalConfigPath,
+        }
+      } else {
+        // File exists - perform intelligent merge
+        const startMarker = '<!-- prjct:start - DO NOT REMOVE THIS MARKER -->'
+        const endMarker = '<!-- prjct:end - DO NOT REMOVE THIS MARKER -->'
+
+        // Check if markers exist in existing file
+        const hasMarkers =
+          existingContent.includes(startMarker) && existingContent.includes(endMarker)
+
+        if (!hasMarkers) {
+          // No markers - append prjct section at the end
+          const updatedContent = existingContent + '\n\n' + templateContent
+          await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
+          return {
+            success: true,
+            action: 'appended',
+            path: globalConfigPath,
+          }
+        } else {
+          // Markers exist - replace content between markers
+          const beforeMarker = existingContent.substring(
+            0,
+            existingContent.indexOf(startMarker)
+          )
+          const afterMarker = existingContent.substring(
+            existingContent.indexOf(endMarker) + endMarker.length
+          )
+
+          // Extract prjct section from template
+          const prjctSection = templateContent.substring(
+            templateContent.indexOf(startMarker),
+            templateContent.indexOf(endMarker) + endMarker.length
+          )
+
+          const updatedContent = beforeMarker + prjctSection + afterMarker
+          await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
+          return {
+            success: true,
+            action: 'updated',
+            path: globalConfigPath,
+          }
+        }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message,
+        action: 'failed',
+      }
+    }
+  }
 }
 
 module.exports = new CommandInstaller()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
@@ -11,7 +11,9 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "install-global": "./scripts/install.sh",
+    "update": "./scripts/update.sh",
     "test": "vitest run --workspace=vitest.workspace.js",
     "test:watch": "vitest --workspace=vitest.workspace.js",
     "test:coverage": "vitest run --coverage --workspace=vitest.workspace.js",
@@ -73,6 +75,7 @@
     "bin/",
     "core/",
     "templates/",
+    "scripts/postinstall.js",
     "scripts/install.sh",
     "LICENSE",
     "README.md",

package/scripts/install.sh

@@ -1,13 +1,37 @@
 #!/bin/bash
 
-# prjct/cli - Turn ideas into AI-ready roadmaps
-# Usage: curl -fsSL https://prjct.app/install.sh | bash
-# Options:
-#   --force      Force reinstall even if up to date
-#   --dev        Install from development branch
-#   --silent     Silent mode (no interactive prompts)
-#   -y, --yes    Auto-accept all prompts
-#   --help, -h   Show this help message
+# ⚠️ DEPRECATED: This installation method is deprecated
+# Use npm instead: npm install -g prjct-cli
+#
+# This script is kept for backward compatibility only.
+
+# Colors
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+echo ""
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${YELLOW}⚠️  This installation method is DEPRECATED${NC}"
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "Please use npm instead:"
+echo ""
+echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
+echo ""
+echo -e "Benefits of npm installation:"
+echo -e "  • ${CYAN}Automatic setup${NC} - No manual configuration needed"
+echo -e "  • ${CYAN}Auto-migration${NC} - Legacy projects migrated automatically"
+echo -e "  • ${CYAN}Beautiful ASCII art${NC} - See the installation success"
+echo -e "  • ${CYAN}Easy updates${NC} - Just npm update -g prjct-cli"
+echo ""
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+exit 1
+
+# Original install.sh preserved below (not executed)
+# ------------------------------------------------
 
 set -e
 
@@ -105,7 +129,7 @@ echo -e "   ${BOLD}${CYAN}██████╔╝██████╔╝
 echo -e "   ${BOLD}${CYAN}██╔═══╝ ██╔══██╗██   ██║██║        ██║${NC}"
 echo -e "   ${BOLD}${CYAN}██║     ██║  ██║╚█████╔╝╚██████╗   ██║${NC}"
 echo -e "   ${BOLD}${CYAN}╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝${NC}"
-echo -e "   ${BOLD}${CYAN}prjct${NC}${MAGENTA}/${NC}${GREEN}cli${NC}  ${DIM}${WHITE}v0.3.1${NC}"
+echo -e "   ${BOLD}${CYAN}prjct${NC}${MAGENTA}/${NC}${GREEN}cli${NC}  ${DIM}${WHITE}v0.8.1${NC}"
 echo ""
 echo -e "   ${DIM}Turn ideas into AI-ready roadmaps${NC}"
 echo ""
@@ -244,6 +268,18 @@ if [ -d "$INSTALL_DIR" ]; then
     ) &
     spin $!
     echo -e " ${GREEN}${CHECK}${NC} Updated to v${REMOTE_VERSION}"
+
+    # Auto-update commands after git pull
+    printf "  ${ARROW} Updating commands"
+    (
+        cd "$INSTALL_DIR"
+        node -e "
+            const installer = require('./core/infrastructure/command-installer');
+            installer.updateCommands();
+        " > /dev/null 2>&1
+    ) &
+    spin $!
+    echo -e " ${GREEN}${CHECK}${NC} Commands synchronized"
 else
     printf "  ${ARROW} Cloning repository"
     (
@@ -312,7 +348,7 @@ else
     printf "  ${ARROW} Auto-installing to all detected editors...\n"
 
     INSTALL_RESULT=$(node -e "
-        const installer = require('./core/command-installer');
+        const installer = require('./core/infrastructure/command-installer');
         installer.installToAll(false).then(result => {
             console.log('__RESULT_START__');
             console.log(JSON.stringify(result));

package/scripts/postinstall.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install hook for prjct-cli
+ *
+ * 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
+ *
+ * @version 0.8.2
+ */
+
+const fs = require('fs')
+const path = require('path')
+const installer = require('../core/infrastructure/command-installer')
+const migrator = require('../core/infrastructure/migrator')
+const { VERSION } = require('../core/utils/version')
+
+// Colors for terminal output
+const CYAN = '\x1b[36m'
+const GREEN = '\x1b[32m'
+const YELLOW = '\x1b[33m'
+const MAGENTA = '\x1b[35m'
+const WHITE = '\x1b[37m'
+const BOLD = '\x1b[1m'
+const DIM = '\x1b[2m'
+const NC = '\x1b[0m' // No Color
+
+async function main() {
+  try {
+    // Detect if this is a global install
+    const isGlobal = await detectGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip postinstall for local development installs
+      console.log(`${DIM}Skipping post-install (local development)${NC}`)
+      return
+    }
+
+    console.log('')
+    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+    console.log(`${BOLD}${CYAN}🚀 Setting up prjct-cli...${NC}`)
+    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+    console.log('')
+
+    // Step 1: Detect Claude Code
+    console.log(`${BOLD}[1/5]${NC} Detecting Claude Code...`)
+    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...`)
+      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}`)
+      }
+      console.log('')
+
+      // Step 3: Install global configuration
+      console.log(`${BOLD}[3/5]${NC} Installing 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}`)
+      }
+      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}`)
+    }
+    console.log('')
+
+    // Step 5: Show ASCII art and quick start
+    console.log(`${BOLD}[5/5]${NC} Installation complete!`)
+    console.log('')
+    showAsciiArt()
+
+  } catch (error) {
+    console.error(`${YELLOW}⚠️  Post-install error: ${error.message}${NC}`)
+    console.error(`${DIM}You can run 'prjct setup' manually later${NC}`)
+    // Don't fail the install if post-install has issues
+    process.exit(0)
+  }
+}
+
+/**
+ * Detect if this is a global npm install
+ */
+async function detectGlobalInstall() {
+  // Check if we're being installed globally
+  const npmConfig = process.env.npm_config_global
+  if (npmConfig === 'true') {
+    return true
+  }
+
+  // Check if install location is in global node_modules
+  const installPath = __dirname
+  const globalPaths = [
+    '/usr/local/lib/node_modules',
+    '/usr/lib/node_modules',
+    path.join(process.env.HOME || '', '.npm-global', 'lib', 'node_modules'),
+    path.join(process.env.HOME || '', '.nvm'),
+    path.join(process.env.APPDATA || '', 'npm', 'node_modules')
+  ]
+
+  return globalPaths.some(globalPath => installPath.includes(globalPath))
+}
+
+/**
+ * Show beautiful ASCII art with quick start
+ */
+function showAsciiArt() {
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+  console.log('')
+  console.log(`   ${BOLD}${CYAN}██████╗ ██████╗      ██╗ ██████╗████████╗${NC}`)
+  console.log(`   ${BOLD}${CYAN}██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝${NC}`)
+  console.log(`   ${BOLD}${CYAN}██████╔╝██████╔╝     ██║██║        ██║${NC}`)
+  console.log(`   ${BOLD}${CYAN}██╔═══╝ ██╔══██╗██   ██║██║        ██║${NC}`)
+  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('')
+  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('')
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+  console.log('')
+  console.log(`${BOLD}${CYAN}🚀 Quick Start${NC}`)
+  console.log(`${DIM}─────────────────────────────────────────────────${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}1.${NC} Initialize your project:`)
+  console.log(`     ${GREEN}cd your-project && prjct init${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}2.${NC} Set your current focus:`)
+  console.log(`     ${GREEN}prjct now "build auth"${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}3.${NC} Ship & celebrate:`)
+  console.log(`     ${GREEN}prjct ship "user login"${NC}`)
+  console.log('')
+  console.log(`${DIM}─────────────────────────────────────────────────${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('')
+  console.log(`${BOLD}${MAGENTA}Happy shipping! 🚀${NC}`)
+  console.log('')
+}
+
+// Run if executed directly
+if (require.main === module) {
+  main().catch(error => {
+    console.error('Fatal error:', error.message)
+    process.exit(0) // Don't fail npm install
+  })
+}
+
+module.exports = main

package/templates/global/CLAUDE.md

@@ -0,0 +1,214 @@
+<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
+# prjct Configuration
+
+This section provides global context for all `/p:*` commands across any prjct project.
+
+**Auto-managed by prjct-cli** - This section is automatically updated when you install or update prjct.
+
+## 🎯 Path Resolution for ALL /p:* Commands
+
+**CRITICAL**: Every `/p:*` command operates on **global storage**, NOT local files.
+
+### Resolution Steps:
+
+1. **Detect prjct project**: Check if `.prjct/prjct.config.json` exists in current working directory
+2. **Read config**: Extract `projectId` from `.prjct/prjct.config.json`
+3. **Construct base path**: `~/.prjct-cli/projects/{projectId}/`
+4. **Resolve all file operations**: All paths in command templates are relative to base path
+
+### Examples:
+
+```
+Template says: "Write: core/now.md"
+Actual path:  ~/.prjct-cli/projects/{projectId}/core/now.md
+
+Template says: "Read: memory/context.jsonl"
+Actual path:  ~/.prjct-cli/projects/{projectId}/memory/context.jsonl
+
+Template says: "Update: progress/shipped.md"
+Actual path:  ~/.prjct-cli/projects/{projectId}/progress/shipped.md
+```
+
+### Validation Rules:
+
+- ❌ **NEVER** write to `.prjct/core/now.md` (local project directory)
+- ❌ **NEVER** write to `./core/now.md` (current working directory)
+- ✅ **ALWAYS** write to `~/.prjct-cli/projects/{projectId}/core/now.md` (global storage)
+
+### When NOT in prjct Project:
+
+If `.prjct/prjct.config.json` doesn't exist in current directory:
+- Respond: "No prjct project detected. Initialize first with `/p:init`"
+- Do NOT execute the command
+- Do NOT create files
+
+## 📁 File Structure
+
+All prjct data lives in global storage with session-based architecture:
+
+```
+~/.prjct-cli/projects/{projectId}/
+├── core/                 # Current focus (always small)
+│   ├── now.md           # Single current task
+│   ├── next.md          # Priority queue (max 100 tasks)
+│   └── context.md       # Project context summary
+├── progress/            # Completed work
+│   ├── shipped.md       # Recent ships (last 30 days)
+│   ├── metrics.md       # Aggregated metrics
+│   ├── sessions/        # Daily session logs (JSONL)
+│   │   └── 2025-10/
+│   │       └── 2025-10-05.jsonl
+│   └── archive/         # Monthly archives
+│       └── shipped-2025-10.md
+├── planning/            # Future planning
+│   ├── ideas.md         # Active ideas (last 30 days)
+│   ├── roadmap.md       # Active roadmap (lightweight)
+│   ├── sessions/        # Daily planning sessions (JSONL)
+│   │   └── 2025-10/
+│   │       └── 2025-10-05.jsonl
+│   └── archive/         # Monthly archives
+│       └── roadmap-2025-10.md
+├── analysis/            # Technical analysis
+│   └── repo-summary.md
+├── memory/              # Decision history
+│   ├── context.jsonl    # Global decisions (append-only)
+│   └── sessions/        # Daily context (structured)
+│       └── 2025-10/
+│           └── 2025-10-05.jsonl
+└── agents/              # Dynamic AI agents
+    ├── coordinator.md
+    ├── ux.md
+    ├── fe.md
+    ├── be.md
+    ├── qa.md
+    └── scribe.md
+```
+
+### Session Format (JSONL):
+
+One JSON object per line, append-only:
+
+```jsonl
+{"ts":"2025-10-05T14:30:00Z","type":"feature_add","name":"auth","tasks":5,"impact":"high","effort":"6h"}
+{"ts":"2025-10-05T15:00:00Z","type":"task_start","task":"JWT middleware","agent":"be","estimate":"2h"}
+{"ts":"2025-10-05T17:15:00Z","type":"task_complete","task":"JWT middleware","duration":"2h15m"}
+{"ts":"2025-10-05T18:00:00Z","type":"feature_ship","name":"auth","tasks_done":5,"total_time":"6h"}
+```
+
+## 🤖 Git Commit Format
+
+**ALL commits made by prjct MUST use this footer:**
+
+```
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+```
+
+**Never use:**
+- ❌ "Generated with Claude Code"
+- ❌ "Co-Authored-By: Claude"
+
+**Always use:**
+- ✅ The prjct footer format above
+
+## 👤 Author Detection
+
+All operations include author information. Detection order:
+
+1. **GitHub CLI**: `gh api user` (preferred)
+   - Provides: name, email, username, avatarUrl
+2. **Git Config**: Fallback if GitHub CLI not available
+   - `git config user.name`
+   - `git config user.email`
+3. **Default**: If both fail
+   - name: "Unknown"
+   - email: "unknown@localhost"
+
+Every log entry in `memory/context.jsonl` includes author field.
+
+## ⚠️ Common Validation Patterns
+
+### Before Executing /p:done:
+```javascript
+// Check if there's an active task
+const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
+if (!nowContent || nowContent.trim() === '') {
+  return "Not working on anything. Use /p:now to start a task."
+}
+```
+
+### Before Executing /p:ship:
+```javascript
+// Check if there's something to ship
+const shippedContent = await Read('~/.prjct-cli/projects/{projectId}/progress/shipped.md')
+const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
+if ((!nowContent || nowContent.trim() === '') &&
+    (!shippedContent || shippedContent.trim() === '')) {
+  return "Nothing to ship yet. Build something first with /p:now."
+}
+```
+
+### Reading Project Config:
+```javascript
+// Always read config first
+const configPath = '.prjct/prjct.config.json'
+const configContent = await Read(configPath)
+const config = JSON.parse(configContent)
+const projectId = config.projectId
+const basePath = `~/.prjct-cli/projects/${projectId}/`
+```
+
+## 🔧 Error Handling
+
+### File Not Found:
+- If `core/now.md` doesn't exist when reading → return empty state
+- If `core/next.md` doesn't exist → return "No tasks in queue"
+- Always check file existence before operations
+
+### Invalid JSON:
+- If config file is corrupted → suggest running `/p:init` again
+- Log error to `memory/context.jsonl` for debugging
+
+### Permission Issues:
+- If can't write to `~/.prjct-cli/` → check directory permissions
+- Suggest: `chmod -R u+w ~/.prjct-cli/`
+
+## 📊 Performance Guidelines
+
+### Archive Rules:
+- Index files (roadmap.md, shipped.md) keep only last 30 days
+- Sessions older than 30 days → automatically moved to archive/
+- When querying across time: read relevant session files from archive/
+- Commands only read current index + today's session for performance
+
+### File Size Limits:
+- `core/now.md`: Single task only (< 1KB)
+- `core/next.md`: Max 100 tasks (< 50KB)
+- `progress/shipped.md`: Last 30 days only (auto-archive older)
+- Session files: One file per day, JSONL format for efficient appending
+
+## 🎯 Command Execution Flow
+
+Standard pattern for all `/p:*` commands:
+
+1. **Validate environment**: Check `.prjct/prjct.config.json` exists
+2. **Read config**: Extract projectId
+3. **Construct paths**: Build all file paths using base path
+4. **Execute operations**: Read/write files in global storage
+5. **Log action**: Append to `memory/context.jsonl` with timestamp and author
+6. **Return response**: Formatted response with next action suggestions
+
+## 📚 Additional Context
+
+- **Website**: https://prjct.app
+- **Documentation**: https://prjct.app/docs
+- **Repository**: Private (proprietary software)
+- **Support**: jlopezlira@gmail.com
+- **Version**: Auto-updated with prjct-cli
+
+---
+
+**Last updated**: Auto-managed by prjct-cli
+**Config version**: 0.8.2
+
+<!-- prjct:end - DO NOT REMOVE THIS MARKER -->