prjct-cli 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -7,6 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.1] - 2025-10-01
+
+### Added
+- **Automatic Update Detection** - Built-in update checker that notifies users of new versions
+  - Checks npm registry every 24 hours for new versions
+  - Non-blocking background check during command execution
+  - Formatted notification with update command
+  - Shows only once per session to avoid notification spam
+  - Respects 24-hour cache to minimize npm registry requests
+
+- **Automated npm Publication** - GitHub Actions workflow for automatic npm publishing
+  - Triggered on version tags (v*)
+  - Automatic version verification against package.json
+  - Provenance publishing with npm attestation
+  - Post-publication verification
+  - Publication summary in GitHub Actions
+
+### Changed
+- **Installation Method** - npm is now the primary and recommended installation method
+  - Simplified to single installation method: `npm install -g prjct-cli`
+  - Removed Homebrew and Bun installation scripts
+  - Cleaner package with optimized file inclusion
+  - Reduced package size: 104.6 KB (71 files)
+
+### Fixed
+- **Package Structure** - Improved npm package configuration
+  - Added `files` field to control package contents
+  - Created `.npmignore` for development file exclusion
+  - Proper global data directory separation (`~/.prjct-cli/` for data only)
+  - Fixed CI/CD tests to verify CLI functionality instead of individual modules
+
+### Technical Details
+- **Update Checker**: `core/update-checker.js` with semantic version comparison
+- **Cache Management**: Update checks cached for 24 hours in `~/.prjct-cli/config/update-cache.json`
+- **Architecture**: Clean separation between npm installation (`/opt/homebrew/lib/node_modules/prjct-cli/`) and user data (`~/.prjct-cli/`)
+- **GitHub Actions**: `.github/workflows/publish-npm.yml` for automated npm publication
+
 ## [0.4.0] - 2025-10-01
 
 ### Added

package/README.md

@@ -46,41 +46,28 @@ Each agent gets optimized output:
 
 ## ⚡ Installation
 
-Choose the installation method that works best for you:
-
-### npm/Node.js
+Install prjct-cli globally using npm:
 
 ```bash
-npm install -g @prjct/cli
+npm install -g prjct-cli
 ```
 
-**Benefits**: Standard npm ecosystem, works everywhere Node.js runs.
-
-### Quick Install Script (Cross-platform)
+**Alternative package managers**:
 
 ```bash
-curl -fsSL https://prjct.app/install.sh | bash
-```
+# Using yarn
+yarn global add prjct-cli
 
-**Benefits**: Works on any Unix-like system, automatic platform detection.
+# Using pnpm
+pnpm add -g prjct-cli
 
-#### Installation Options
-
-```bash
-# Force reinstall (even if up to date)
-curl -fsSL https://prjct.app/install.sh | bash -s -- --force
-
-# Auto-accept all prompts (unattended installation)
-curl -fsSL https://prjct.app/install.sh | bash -s -- -y
-
-# Install from development branch
-curl -fsSL https://prjct.app/install.sh | bash -s -- --dev
-
-# Show help
-curl -fsSL https://prjct.app/install.sh | bash -s -- --help
+# Using bun
+bun install -g prjct-cli
 ```
 
-> **Note**: For detailed installation instructions, troubleshooting, and platform-specific guidance, see [INSTALL.md](docs/INSTALL.md).
+**Requirements**: Node.js 18 or higher
+
+> **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
 

package/core/commands.js

@@ -11,6 +11,7 @@ const migrator = require('./migrator')
 const commandInstaller = require('./command-installer')
 const sessionManager = require('./session-manager')
 const analyzer = require('./analyzer')
+const UpdateChecker = require('./update-checker')
 const { VERSION } = require('./version')
 
 let animations
@@ -34,6 +35,28 @@ class PrjctCommands {
     this.agentInfo = null
     this.currentAuthor = null
     this.prjctDir = '.prjct'
+    this.updateChecker = new UpdateChecker()
+    this.updateNotificationShown = false
+  }
+
+  /**
+   * Check for updates and show notification (non-blocking)
+   * Only shows once per session
+   */
+  async checkAndNotifyUpdates() {
+    if (this.updateNotificationShown) {
+      return
+    }
+
+    try {
+      const notification = await this.updateChecker.getUpdateNotification()
+      if (notification) {
+        console.log(notification)
+        this.updateNotificationShown = true
+      }
+    } catch (error) {
+      // Fail silently - don't interrupt user workflow
+    }
   }
 
   /**
@@ -171,6 +194,11 @@ class PrjctCommands {
 
     await this.checkAndRunAutoMigration()
 
+    // Check for updates in background (non-blocking)
+    this.checkAndNotifyUpdates().catch(() => {
+      // Fail silently - don't interrupt workflow
+    })
+
     return this.agent
   }
 

package/core/update-checker.js

@@ -0,0 +1,222 @@
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+class UpdateChecker {
+  constructor() {
+    this.packageName = 'prjct-cli';
+    this.cacheDir = path.join(os.homedir(), '.prjct-cli', 'config');
+    this.cacheFile = path.join(this.cacheDir, 'update-cache.json');
+    this.checkInterval = 24 * 60 * 60 * 1000; // 24 hours in milliseconds
+  }
+
+  /**
+   * Get current installed version from package.json
+   */
+  getCurrentVersion() {
+    try {
+      const packageJsonPath = path.join(__dirname, '..', 'package.json');
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+      return packageJson.version;
+    } catch (error) {
+      console.error('Error reading package version:', error.message);
+      return null;
+    }
+  }
+
+  /**
+   * Fetch latest version from npm registry
+   */
+  async getLatestVersion() {
+    return new Promise((resolve, reject) => {
+      const options = {
+        hostname: 'registry.npmjs.org',
+        path: `/${this.packageName}/latest`,
+        method: 'GET',
+        headers: {
+          'User-Agent': 'prjct-cli-update-checker',
+          Accept: 'application/json'
+        }
+      };
+
+      const req = https.request(options, res => {
+        let data = '';
+
+        res.on('data', chunk => {
+          data += chunk;
+        });
+
+        res.on('end', () => {
+          try {
+            if (res.statusCode === 200) {
+              const packageData = JSON.parse(data);
+              resolve(packageData.version);
+            } else {
+              reject(new Error(`npm registry returned status ${res.statusCode}`));
+            }
+          } catch (error) {
+            reject(error);
+          }
+        });
+      });
+
+      req.on('error', error => {
+        reject(error);
+      });
+
+      req.setTimeout(5000, () => {
+        req.destroy();
+        reject(new Error('Request timeout'));
+      });
+
+      req.end();
+    });
+  }
+
+  /**
+   * Compare two semantic versions
+   * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+   */
+  compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+      const part1 = parts1[i] || 0;
+      const part2 = parts2[i] || 0;
+
+      if (part1 > part2) return 1;
+      if (part1 < part2) return -1;
+    }
+
+    return 0;
+  }
+
+  /**
+   * Read cache file
+   */
+  readCache() {
+    try {
+      if (fs.existsSync(this.cacheFile)) {
+        const cache = JSON.parse(fs.readFileSync(this.cacheFile, 'utf8'));
+        return cache;
+      }
+    } catch (error) {
+      // Cache file doesn't exist or is corrupted, ignore
+    }
+    return null;
+  }
+
+  /**
+   * Write cache file
+   */
+  writeCache(data) {
+    try {
+      // Ensure cache directory exists
+      if (!fs.existsSync(this.cacheDir)) {
+        fs.mkdirSync(this.cacheDir, { recursive: true });
+      }
+
+      fs.writeFileSync(this.cacheFile, JSON.stringify(data, null, 2), 'utf8');
+    } catch (error) {
+      // Fail silently - cache is not critical
+    }
+  }
+
+  /**
+   * Check if update is available (respects 24-hour cache)
+   * Returns: { updateAvailable: boolean, currentVersion: string, latestVersion: string } or null
+   */
+  async checkForUpdates() {
+    try {
+      const currentVersion = this.getCurrentVersion();
+      if (!currentVersion) {
+        return null;
+      }
+
+      // Check cache first
+      const cache = this.readCache();
+      const now = Date.now();
+
+      if (cache && cache.lastCheck && now - cache.lastCheck < this.checkInterval) {
+        // Cache is still valid
+        if (cache.latestVersion && this.compareVersions(cache.latestVersion, currentVersion) > 0) {
+          return {
+            updateAvailable: true,
+            currentVersion,
+            latestVersion: cache.latestVersion
+          };
+        }
+        return {
+          updateAvailable: false,
+          currentVersion,
+          latestVersion: currentVersion
+        };
+      }
+
+      // Cache expired or doesn't exist, fetch from npm
+      const latestVersion = await this.getLatestVersion();
+
+      // Update cache
+      this.writeCache({
+        lastCheck: now,
+        latestVersion
+      });
+
+      // Compare versions
+      const updateAvailable = this.compareVersions(latestVersion, currentVersion) > 0;
+
+      return {
+        updateAvailable,
+        currentVersion,
+        latestVersion
+      };
+    } catch (error) {
+      // Network error or other issue - fail silently
+      // Return null to indicate check couldn't be performed
+      return null;
+    }
+  }
+
+  /**
+   * Get formatted update notification message
+   */
+  async getUpdateNotification() {
+    const result = await this.checkForUpdates();
+
+    if (!result || !result.updateAvailable) {
+      return null;
+    }
+
+    const chalk = require('chalk');
+
+    return (
+      '\n' +
+      chalk.yellow('┌───────────────────────────────────────────────────────────┐') +
+      '\n' +
+      chalk.yellow('│') +
+      '  ' +
+      chalk.bold('Update available!') +
+      ' ' +
+      chalk.dim(`${result.currentVersion} → ${result.latestVersion}`) +
+      '  ' +
+      chalk.yellow('│') +
+      '\n' +
+      chalk.yellow('│') +
+      '                                                           ' +
+      chalk.yellow('│') +
+      '\n' +
+      chalk.yellow('│') +
+      '  Run: ' +
+      chalk.cyan('npm update -g prjct-cli') +
+      '                       ' +
+      chalk.yellow('│') +
+      '\n' +
+      chalk.yellow('└───────────────────────────────────────────────────────────┘') +
+      '\n'
+    );
+  }
+}
+
+module.exports = UpdateChecker;

package/package.json

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