prjct-cli 0.8.2 → 0.8.3

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.3",
   "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'); const i = new installer(); i.syncCommands().then(r => console.log('Commands updated:', r))\"",
     "install-global": "./scripts/install.sh",
     "update": "./scripts/update.sh",
     "test": "vitest run --workspace=vitest.workspace.js",

package/scripts/postinstall.js

@@ -8,16 +8,15 @@
  * 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
+ * 4. Shows beautiful ASCII art
+ *
+ * NOTE: Migration is now manual via /p:migrate-all or prjct migrate-all
  *
  * @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
@@ -48,7 +47,7 @@ async function main() {
     console.log('')
 
     // Step 1: Detect Claude Code
-    console.log(`${BOLD}[1/5]${NC} Detecting Claude Code...`)
+    console.log(`${BOLD}[1/3]${NC} Detecting Claude Code...`)
     const claudeDetected = await installer.detectClaude()
 
     if (!claudeDetected) {
@@ -61,7 +60,7 @@ async function main() {
       console.log('')
 
       // Step 2: Install/sync commands
-      console.log(`${BOLD}[2/5]${NC} Installing commands to ~/.claude...`)
+      console.log(`${BOLD}[2/3]${NC} Installing commands to ~/.claude...`)
       const syncResult = await installer.syncCommands()
 
       if (syncResult.success) {
@@ -82,7 +81,7 @@ async function main() {
       console.log('')
 
       // Step 3: Install global configuration
-      console.log(`${BOLD}[3/5]${NC} Installing global configuration...`)
+      console.log(`${BOLD}[3/3]${NC} Installing global configuration...`)
       const configResult = await installer.installGlobalConfig()
 
       if (configResult.success) {
@@ -99,26 +98,7 @@ async function main() {
       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('')
+    // Show ASCII art and quick start
     showAsciiArt()
 
   } catch (error) {

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`