prjct-cli 0.25.0 → 0.25.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.25.1] - 2026-01-01
+
+### Bug Fix: npm install symlink resolution
+
+**Fixed:** CLI fails when invoked via npm symlink (`node_modules/.bin/prjct`)
+
+**Root Cause:**
+The shell wrapper script `bin/prjct` used `dirname "$0"` to find `prjct.ts`, which returns the symlink's directory (`.bin/`) instead of the actual script location (`prjct-cli/bin/`).
+
+**Solution:**
+Added `resolve_symlink()` function that properly resolves symlinks before determining paths. Works on both Linux (`readlink -f`) and macOS (manual resolution fallback).
+
+**Files Changed:**
+- `bin/prjct` - Added symlink resolution (v1.0.0 → v1.1.0)
+
 ## [0.25.0] - 2025-12-30
 
 ### Maintenance Release

package/bin/prjct

@@ -5,10 +5,40 @@
 # Detects available runtime (bun preferred, node fallback)
 # and executes the appropriate entry point.
 #
-# @version 1.0.0
+# @version 1.1.0
 
-# Get the directory where this script is located
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+# Resolve symlinks to get the actual script location
+resolve_symlink() {
+  TARGET="$1"
+
+  # Try readlink -f (Linux, newer macOS)
+  if command -v readlink >/dev/null 2>&1; then
+    RESOLVED="$(readlink -f "$TARGET" 2>/dev/null)"
+    if [ -n "$RESOLVED" ]; then
+      echo "$RESOLVED"
+      return
+    fi
+  fi
+
+  # Fallback: manual symlink resolution
+  while [ -L "$TARGET" ]; do
+    DIR="$(dirname "$TARGET")"
+    TARGET="$(readlink "$TARGET")"
+    # Handle relative symlinks
+    case "$TARGET" in
+      /*) ;;
+      *) TARGET="$DIR/$TARGET" ;;
+    esac
+  done
+
+  # Get absolute path
+  DIR="$(cd "$(dirname "$TARGET")" && pwd)"
+  echo "$DIR/$(basename "$TARGET")"
+}
+
+# Get the actual script location (resolving symlinks)
+SCRIPT_PATH="$(resolve_symlink "$0")"
+SCRIPT_DIR="$(dirname "$SCRIPT_PATH")"
 ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # Check if bun is available

package/core/infrastructure/setup.ts

@@ -117,6 +117,9 @@ export async function run(): Promise<SetupResults> {
   // Step 5: Save version in editors-config
   await editorsConfig.saveConfig(VERSION, installer.getInstallPath())
 
+  // Step 6: Migrate existing projects to add cliVersion
+  await migrateProjectsCliVersion()
+
   // Show results
   showResults(results)
 
@@ -126,6 +129,54 @@ export async function run(): Promise<SetupResults> {
 // Default export for CommonJS require
 export default { run }
 
+/**
+ * Migrate existing projects to add cliVersion field
+ * This clears the status line warning after npm update
+ */
+async function migrateProjectsCliVersion(): Promise<void> {
+  try {
+    const projectsDir = path.join(os.homedir(), '.prjct-cli', 'projects')
+
+    if (!fs.existsSync(projectsDir)) {
+      return
+    }
+
+    const projectDirs = fs.readdirSync(projectsDir, { withFileTypes: true })
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name)
+
+    let migrated = 0
+
+    for (const projectId of projectDirs) {
+      const projectJsonPath = path.join(projectsDir, projectId, 'project.json')
+
+      if (!fs.existsSync(projectJsonPath)) {
+        continue
+      }
+
+      try {
+        const content = fs.readFileSync(projectJsonPath, 'utf8')
+        const project = JSON.parse(content)
+
+        // Only update if cliVersion is missing or different
+        if (project.cliVersion !== VERSION) {
+          project.cliVersion = VERSION
+          fs.writeFileSync(projectJsonPath, JSON.stringify(project, null, 2))
+          migrated++
+        }
+      } catch {
+        // Skip invalid project.json files
+      }
+    }
+
+    if (migrated > 0) {
+      console.log(`   ${GREEN}✓${NC} Updated ${migrated} project(s) to v${VERSION}`)
+    }
+  } catch {
+    // Silently fail - migration is optional
+  }
+}
+
 /**
  * Install status line script with version check
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.ts",
   "bin": {

package/templates/commands/sync.md

@@ -383,20 +383,25 @@ WRITE: `{globalPath}/context/CLAUDE.md`
 
 ---
 
-## Step 6: Update project.json
+## Step 6: Update project.json (CRITICAL: cliVersion)
 
-READ existing: `{globalPath}/project.json` (preserve createdAt)
+READ existing: `{globalPath}/project.json` (preserve createdAt, integrations)
 
-GET CLI version:
+GET CLI version (REQUIRED - this clears the status line warning):
 ```bash
 bun -e "console.log(require('./package.json').version)" 2>/dev/null || node -e "console.log(require('./package.json').version)"
 ```
-SET: `{cliVersion}` = result (e.g., "0.24.0")
+SET: `{cliVersion}` = result (e.g., "0.25.1")
 
 CHECK: `{previousCliVersion}` = existing.cliVersion (if any)
-SET: `{isVersionUpgrade}` = previousCliVersion != cliVersion
+SET: `{isVersionUpgrade}` = previousCliVersion != cliVersion OR previousCliVersion is missing
 
-WRITE: `{globalPath}/project.json`
+**CRITICAL**: The `cliVersion` field MUST be written to project.json. This field:
+- Clears the "⚠️ prjct v{version} available!" status line warning
+- Indicates which CLI version last synced this project
+- If missing, the warning will persist even after sync
+
+WRITE: `{globalPath}/project.json` (merge with existing, but ALWAYS update these fields):
 
 ```json
 {
@@ -404,7 +409,7 @@ WRITE: `{globalPath}/project.json`
   "repoPath": "{cwd}",
   "name": "{projectName}",
   "version": "{version}",
-  "cliVersion": "{cliVersion}",
+  "cliVersion": "{cliVersion}",  // ← REQUIRED: Must match CLI version to clear warning
   "techStack": {techStack},
   "fileCount": {fileCount},
   "commitCount": {commitCount},
@@ -412,7 +417,8 @@ WRITE: `{globalPath}/project.json`
   "currentBranch": "{currentBranch}",
   "hasUncommittedChanges": {hasUncommittedChanges},
   "createdAt": "{existingCreatedAt || GetTimestamp()}",
-  "lastSync": "{GetTimestamp()}"
+  "lastSync": "{GetTimestamp()}",
+  "integrations": "{existing.integrations || {}}"  // ← Preserve integrations
 }
 ```