prjct-cli 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -15,6 +15,59 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cross-platform file operations
   - Windows Terminal integration
 
+## [0.4.6] - 2025-10-02
+
+### Added
+- **`prjct start` Command** - First-time setup with interactive editor selection
+  - Beautiful ASCII art welcome message
+  - Auto-detects installed AI editors (Claude Code, Cursor, Windsurf)
+  - Interactive prompt to choose which editors to install commands to
+  - Replaces confusing `prjct install` command with clearer naming
+  - Only runs once (blocks if already configured, suggests `prjct setup` to reconfigure)
+
+- **Auto-Initialization** - Commands auto-run `prjct init` when needed
+  - All core commands (now, done, ship, next, idea, recap, stuck, context) check initialization
+  - Shows warning and runs init automatically if project not configured
+  - Zero friction - users don't need to remember to run init first
+  - Seamless workflow: `cd project/ && prjct now "task"` just works
+
+### Changed
+- **Simplified Installation Flow**
+  - `npm install -g prjct-cli` → Shows welcome message, tells user to run `prjct start`
+  - `prjct start` → Interactive setup (first-time only)
+  - `prjct init` → Initialize project (links to global data)
+  - `prjct setup` → Reconfigure editors (replaces old `prjct install`)
+  - `npm update -g prjct-cli` → Auto-updates commands in tracked editors
+
+- **Post-Install Behavior**
+  - Removed auto-installation on npm install (was non-interactive and confusing)
+  - First install shows: `Run: prjct start to get started`
+  - Updates auto-update commands in previously selected editors
+  - Cleaner, more predictable behavior
+
+### Fixed
+- **Critical Bug Fixes** - All commands now enforce global architecture correctly
+  - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
+  - `/p:cleanup` now operates on global project data instead of local `.prjct/`
+  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
+  - All commands verify project is initialized before execution
+  - Prevents creation of invalid local `.prjct/` structures
+  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
+  - **Added 'Apps' directory** to migration scanner for better project detection
+
+### Technical Details
+- **New Commands**:
+  - `start()` - First-time setup with ASCII art and interactive editor selection
+  - `setup()` - Renamed from `install()` for clarity
+  - `ensureProjectInit()` - Helper function for auto-initialization
+- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
+  - design(), cleanup(), getDaysSinceLastShip() fully migrated
+  - Prevents LOCAL .prjct/ creation
+  - Requires project initialization before command execution
+- **Auto-Init Integration**: now(), done(), ship(), next(), idea(), recap(), stuck(), context() all auto-initialize
+- **Migration Enhancement**: Added ~/Apps to common directories scan
+- **Post-Install Fix**: currentVersion variable properly declared at function start
+
 ## [0.4.4] - 2025-10-02
 
 ### Added
@@ -39,7 +92,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **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.)
+  - Scans common project directories (Projects, Documents, Developer, Code, **Apps**)
   - 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
@@ -51,23 +104,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Ensures tracking happens even during force updates
   - Enables reliable auto-updates across all configured editors
 
+### Fixed
+- **Global Architecture Enforcement** - All commands now enforce global architecture correctly
+  - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
+  - `/p:cleanup` now operates on global project data instead of local `.prjct/`
+  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
+  - All commands verify project is initialized before execution
+  - Prevents creation of invalid local `.prjct/` structures
+  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
+  - **Added 'Apps' directory** to migration scanner for better project detection
+
 ### 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
+  - **Fixed**: currentVersion variable now properly declared at function start
+  - **Enhanced**: Better error handling with debug logging
 - **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)
+  - Scans common project directories including **~/Apps** (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
+- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
+  - design(), cleanup(), getDaysSinceLastShip() fully migrated
+  - Prevents LOCAL .prjct/ creation
+  - Requires project initialization before command execution
 
 ## [0.4.3] - 2025-10-02
 

package/bin/prjct

@@ -8,6 +8,9 @@ async function main() {
 
     let result;
     switch(command) {
+        case 'start':
+            result = await commands.start();
+            break;
         case 'init':
             result = await commands.init();
             break;
@@ -107,23 +110,23 @@ async function main() {
 
             result = await commands.migrateAll(migrateOptions);
             break;
-        case 'install':
-            const installOptions = {};
-            const installArgs = args.slice(1);
-
-            for (let i = 0; i < installArgs.length; i++) {
-                if (installArgs[i] === '--force') {
-                    installOptions.force = true;
-                } else if (installArgs[i] === '--editor') {
-                    installOptions.editor = installArgs[++i];
-                } else if (installArgs[i] === '--create-templates') {
-                    installOptions.createTemplates = true;
-                } else if (installArgs[i] === '--no-interactive') {
-                    installOptions.interactive = false;
+        case 'setup':
+            const setupOptions = {};
+            const setupArgs = args.slice(1);
+
+            for (let i = 0; i < setupArgs.length; i++) {
+                if (setupArgs[i] === '--force') {
+                    setupOptions.force = true;
+                } else if (setupArgs[i] === '--editor') {
+                    setupOptions.editor = setupArgs[++i];
+                } else if (setupArgs[i] === '--create-templates') {
+                    setupOptions.createTemplates = true;
+                } else if (setupArgs[i] === '--no-interactive') {
+                    setupOptions.interactive = false;
                 }
             }
 
-            result = await commands.install(installOptions);
+            result = await commands.setup(setupOptions);
             break;
         case 'analyze':
             const analyzeOptions = {};
@@ -139,6 +142,15 @@ async function main() {
 
             result = await commands.analyze(analyzeOptions);
             break;
+        case '--version':
+        case '-v':
+        case 'version':
+            const packageJson = require('../package.json');
+            result = {
+                success: true,
+                message: `prjct-cli v${packageJson.version}`
+            };
+            break;
         case '--help':
         case '-h':
         case 'help':
@@ -146,6 +158,10 @@ async function main() {
             result = {
                 success: true,
                 message: `Available commands:
+  Setup:
+    start             First-time setup (install commands to editors)
+    setup             Reconfigure editor installations
+
   Core workflow:
     init              Initialize prjct in current project
     now [task]        Set or show current task
@@ -164,9 +180,8 @@ async function main() {
     design [target]   Design system/architecture
     analyze           Analyze codebase and sync state
     migrate-all       Migrate all legacy projects
-    install           Install commands to AI editors
 
-  Install options:
+  Setup options:
     --force           Force update existing commands
     --editor <name>   Install to specific editor (claude|cursor|codex|windsurf)
     --no-interactive  Skip interactive selection, install to all
@@ -179,6 +194,10 @@ async function main() {
                 message: `Unknown command: ${command}
 
 Available commands:
+  Setup:
+    start             First-time setup (install commands to editors)
+    setup             Reconfigure editor installations
+
   Core workflow:
     init              Initialize prjct in current project
     now [task]        Set or show current task
@@ -197,9 +216,8 @@ Available commands:
     design [target]   Design system/architecture
     analyze           Analyze codebase and sync state
     migrate-all       Migrate all legacy projects
-    install           Install commands to AI editors
 
-  Install options:
+  Setup options:
     --force           Force update existing commands
     --editor <name>   Install to specific editor (claude|cursor|codex|windsurf)
     --no-interactive  Skip interactive selection, install to all

package/core/commands.js

@@ -249,6 +249,31 @@ class PrjctCommands {
     return this.currentAuthor
   }
 
+  /**
+   * Auto-initialize project if not configured
+   * Shows warning and runs init automatically
+   *
+   * @param {string} projectPath - Local project path
+   * @returns {Promise<{success: boolean, message?: string}>} Success or init result
+   */
+  async ensureProjectInit(projectPath) {
+    if (await configManager.isConfigured(projectPath)) {
+      return { success: true }
+    }
+
+    const chalk = require('chalk')
+    console.log(chalk.yellow('⚠️  Project not initialized'))
+    console.log(chalk.cyan('🔧 Running prjct init...\n'))
+
+    const initResult = await this.init(projectPath)
+    if (!initResult.success) {
+      return initResult
+    }
+
+    console.log(chalk.green('✅ Project initialized!\n'))
+    return { success: true }
+  }
+
   /**
    * Get the global project path for a project
    * Ensures migration if needed
@@ -413,6 +438,12 @@ class PrjctCommands {
       await this.initializeAgent()
       await this.ensureAuthor()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFile = await this.getFilePath(projectPath, 'core', 'now.md')
 
       if (!task) {
@@ -494,6 +525,13 @@ class PrjctCommands {
   async done(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
+
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFile = await this.getFilePath(projectPath, 'core', 'now.md')
       const nextFile = await this.getFilePath(projectPath, 'core', 'next.md')
 
@@ -655,6 +693,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!feature) {
         return {
           success: false,
@@ -764,6 +808,13 @@ ${nextStep.agent}
   async next(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
+
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nextFile = await this.getFilePath(projectPath, 'core', 'next.md')
       const content = await this.agent.readFile(nextFile)
 
@@ -806,6 +857,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!text) {
         return {
           success: false,
@@ -862,6 +919,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFilePath = await this.getFilePath(projectPath, 'core', 'now.md')
       const nextFilePath = await this.getFilePath(projectPath, 'core', 'next.md')
       const ideasFilePath = await this.getFilePath(projectPath, 'planning', 'ideas.md')
@@ -1100,6 +1163,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!issue) {
         return {
           success: false,
@@ -1236,9 +1305,23 @@ ${dryRun ? '⚠️ DRY RUN - No changes were made' : '✅ All changes applied su
     try {
       await this.initializeAgent()
 
+      // Verify project is initialized
+      if (!await configManager.isConfigured(projectPath)) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            `Project not initialized. Run ${this.agentInfo.config.commandPrefix}init first.`,
+            'warning'
+          ),
+        }
+      }
+
       const type = options.type || 'architecture'
 
-      const designDir = path.join(projectPath, this.prjctDir, 'designs')
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
+      const designDir = path.join(globalPath, 'analysis', 'designs')
       await this.agent.createDirectory(designDir)
 
       let designContent = ''
@@ -1380,6 +1463,12 @@ ${diagram}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const projectInfo = await this.detectProjectType(projectPath)
 
       const nowFilePath = await this.getFilePath(projectPath, 'core', 'now.md')
@@ -1484,7 +1573,11 @@ ${diagram}
   async getDaysSinceLastShip(projectPath) {
     try {
       await this.initializeAgent()
-      const memoryFile = path.join(projectPath, this.prjctDir, 'memory.jsonl')
+
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
+      const memoryFile = path.join(globalPath, 'memory', 'context.jsonl')
       const memory = await this.agent.readFile(memoryFile)
       const lines = memory
         .trim()
@@ -1670,14 +1763,28 @@ ${diagram}
   async cleanup(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
-      const prjctPath = path.join(projectPath, this.prjctDir)
+
+      // Verify project is initialized
+      if (!await configManager.isConfigured(projectPath)) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            `Project not initialized. Run ${this.agentInfo.config.commandPrefix}init first.`,
+            'warning'
+          ),
+        }
+      }
+
+      // Use global architecture
+      const projectId = await configManager.getProjectId(projectPath)
+      const globalPath = pathManager.getGlobalProjectPath(projectId)
 
       let totalFreed = 0
       let filesRemoved = 0
       let tasksArchived = 0
 
       try {
-        const tempDir = path.join(prjctPath, 'temp')
+        const tempDir = path.join(globalPath, 'temp')
         const tempFiles = await fs.readdir(tempDir).catch(() => [])
         for (const file of tempFiles) {
           const filePath = path.join(tempDir, file)
@@ -1690,7 +1797,7 @@ ${diagram}
       }
 
       try {
-        const memoryFile = path.join(prjctPath, 'memory.jsonl')
+        const memoryFile = path.join(globalPath, 'memory', 'context.jsonl')
         const content = await this.agent.readFile(memoryFile)
         const lines = content.split('\n').filter(line => line.trim())
         const now = new Date()
@@ -1714,7 +1821,7 @@ ${diagram}
         }
 
         if (archivedLines.length > 0) {
-          const archiveFile = path.join(prjctPath, `memory-archive-${now.toISOString().split('T')[0]}.jsonl`)
+          const archiveFile = path.join(globalPath, 'memory', `archive-${now.toISOString().split('T')[0]}.jsonl`)
           await this.agent.writeFile(archiveFile, archivedLines.join('\n') + '\n')
           await this.agent.writeFile(memoryFile, recentLines.join('\n') + '\n')
           tasksArchived = archivedLines.length
@@ -1722,10 +1829,10 @@ ${diagram}
       } catch (e) {
       }
 
-      const files = await fs.readdir(prjctPath)
+      const files = await fs.readdir(globalPath)
       for (const file of files) {
         if (file.endsWith('.md') || file.endsWith('.txt')) {
-          const filePath = path.join(prjctPath, file)
+          const filePath = path.join(globalPath, file)
           const stats = await fs.stat(filePath)
           if (stats.size === 0) {
             await fs.unlink(filePath)
@@ -1735,7 +1842,7 @@ ${diagram}
       }
 
       try {
-        const shippedFile = path.join(prjctPath, 'shipped.md')
+        const shippedFile = path.join(globalPath, 'progress', 'shipped.md')
         const content = await this.agent.readFile(shippedFile)
         const lines = content.split('\n')
         const now = new Date()
@@ -1834,12 +1941,109 @@ ${diagram}
   }
 
   /**
-   * Install commands to AI editors
+   * First-time setup - Install commands to AI editors with ASCII art welcome
+   *
+   * @returns {Promise<Object>} Result object with success flag and message
+   */
+  async start() {
+    try {
+      await this.initializeAgent()
+
+      // Check if already configured
+      const editorsConfig = require('./editors-config')
+      const configExists = await editorsConfig.configExists()
+
+      if (configExists) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            'prjct is already set up!\n\nTo reconfigure editors: prjct setup',
+            'warning'
+          ),
+        }
+      }
+
+      // ASCII Art
+      const chalk = require('chalk')
+      console.log(
+        chalk.cyan(`
+   ___  ____    _ ____ _____
+  / _ \\|  _ \\  | / ___|_   _|
+ | |_| | |_) |_| | |     | |
+ |  __/|  _ <| | | |___  | |
+ | |   | |_) | | |\\____| | |
+ |_|   |____/|_| |       |_|
+    `)
+      )
+
+      console.log(chalk.cyan('\n📦 Welcome to prjct-cli!\n'))
+
+      // Detect editors
+      const commandInstaller = require('./command-installer')
+      const detection = await commandInstaller.detectEditors()
+      const detectedEditors = Object.entries(detection).filter(([_, info]) => info.detected)
+
+      if (detectedEditors.length === 0) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            'No AI editors detected.\n\nSupported: Claude Code, Cursor, Windsurf',
+            'error'
+          ),
+        }
+      }
+
+      console.log(chalk.cyan('🔍 Detected AI editors:'))
+      detectedEditors.forEach(([key, info]) => {
+        console.log(chalk.green(`  [✓] ${info.name} (${info.path})`))
+      })
+      console.log('')
+
+      // Interactive selection
+      const installResult = await commandInstaller.interactiveInstall(false)
+
+      if (!installResult.success) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(installResult.message || 'Setup failed', 'error'),
+        }
+      }
+
+      // Install Context7 MCP
+      const mcpResult = await commandInstaller.installContext7MCP()
+
+      // Success message
+      let message = `✅ Commands installed in: ${installResult.editors.join(', ')}\n`
+
+      if (mcpResult.success && mcpResult.editors.length > 0) {
+        message += `\n🔌 Context7 MCP enabled in: ${mcpResult.editors.join(', ')}`
+      }
+
+      message += '\n\n✨ prjct is ready to use!'
+      message += '\n\nNext steps:'
+      message += '\n  cd your-project/'
+      message += '\n  prjct init'
+
+      return {
+        success: true,
+        message: this.agent.formatResponse(message, 'celebrate'),
+      }
+    } catch (error) {
+      await this.initializeAgent()
+      return {
+        success: false,
+        message: this.agent.formatResponse(`Setup failed: ${error.message}`, 'error'),
+      }
+    }
+  }
+
+  /**
+   * Setup/reconfigure commands in AI editors
    *
    * @param {Object} [options={}] - Installation options
    * @returns {Promise<Object>} Result object with success flag and message
    */
-  async install(options = {}) {
+  async setup(options = {}) {
     try {
       await this.initializeAgent()
 

package/core/migrator.js

@@ -510,7 +510,7 @@ class Migrator {
     if (deepScan) {
       searchPaths = [os.homedir()]
     } else {
-      const commonDirs = ['Projects', 'Documents', 'Developer', 'Code', 'dev', 'workspace', 'repos', 'src']
+      const commonDirs = ['Projects', 'Documents', 'Developer', 'Code', 'dev', 'workspace', 'repos', 'src', 'Apps']
       searchPaths = commonDirs
         .map(dir => path.join(os.homedir(), dir))
         .filter(dirPath => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
   "main": "core/index.js",
   "bin": {

package/scripts/post-install.js

@@ -21,11 +21,18 @@ const { execSync } = require('child_process')
 
 async function main() {
   try {
+    // Get current package version
+    const packageJson = require('../package.json')
+    const currentVersion = packageJson.version
+
     // Check if this is a global installation
     const isGlobal = await checkIfGlobalInstall()
 
     if (!isGlobal) {
       // Skip post-install for local/dev installations
+      if (process.env.DEBUG) {
+        console.log(chalk.gray('[post-install] Skipping - not a global install'))
+      }
       return
     }
 
@@ -34,43 +41,12 @@ async function main() {
     const configExists = await editorsConfig.configExists()
 
     if (!configExists) {
-      // 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`))
-      }
-
+      // First-time install - show welcome message
+      console.log(chalk.cyan('\n✨ prjct-cli installed successfully!\n'))
+      console.log(chalk.gray('Run: ') + chalk.cyan('prjct start') + chalk.gray(' to get started\n'))
       return
     }
 
-    // Get current package version
-    const packageJson = require('../package.json')
-    const currentVersion = packageJson.version
-
     // Check if version has changed
     const versionChanged = await editorsConfig.hasVersionChanged(currentVersion)
 
@@ -79,9 +55,8 @@ async function main() {
       return
     }
 
-    // Get tracked editors and paths
+    // Get tracked editors
     const trackedEditors = await editorsConfig.getTrackedEditors()
-    const editorPaths = await editorsConfig.getEditorPaths()
 
     if (trackedEditors.length === 0) {
       // No editors tracked yet