proj-track 1.0.0

package/dist/utils/shell-installer.js

@@ -0,0 +1,232 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const START_MARKER = '# --- proj-track hook start ---';
+const END_MARKER = '# --- proj-track hook end ---';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the path to the hooks directory (works in both dev and installed contexts).
+ */
+function getHooksDir() {
+    const packageRoot = path.resolve(__dirname, '..', '..');
+    const srcHooks = path.join(packageRoot, 'src', 'hooks');
+    if (fs.existsSync(srcHooks)) {
+        return srcHooks;
+    }
+    return path.join(packageRoot, 'hooks');
+}
+/**
+ * Detect which shell config files exist.
+ */
+function getShellConfigs() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const configs = [];
+    const bashrc = path.join(home, '.bashrc');
+    const zshrc = path.join(home, '.zshrc');
+    if (fs.existsSync(bashrc))
+        configs.push(bashrc);
+    if (fs.existsSync(zshrc))
+        configs.push(zshrc);
+    if (configs.length === 0) {
+        configs.push(bashrc);
+    }
+    return configs;
+}
+/**
+ * Read the appropriate shell hook file content.
+ */
+function getHookContent(shell) {
+    const hooksDir = getHooksDir();
+    const hookFile = path.join(hooksDir, `${shell}-hook.sh`);
+    if (fs.existsSync(hookFile)) {
+        return fs.readFileSync(hookFile, 'utf-8');
+    }
+    return shell === 'zsh' ? getInlineZshHook() : getInlineBashHook();
+}
+function getInlineBashHook() {
+    return `${START_MARKER}
+# AUTO-CAPTURE via PROMPT_COMMAND (NOT DEBUG trap - doesn't break arrow keys)
+
+# Cleanup any previous installation from shell memory first
+if declare -f __proj_track_capture >/dev/null 2>&1; then
+  PROMPT_COMMAND="\${PROMPT_COMMAND//__proj_track_capture;/}"
+  PROMPT_COMMAND="\${PROMPT_COMMAND//__proj_track_capture/}"
+  unset -f __proj_track_capture 2>/dev/null
+fi
+
+__proj_track_old_prompt="\${PROMPT_COMMAND:-}"
+
+__proj_track_capture() {
+  if ! command -v proj-track-logger >/dev/null 2>&1; then
+    return
+  fi
+
+  local last_cmd
+  last_cmd=$(HISTTIMEFORMAT='' builtin history 1 | sed 's/^[ ]*[0-9]*[ ]*//')
+
+  [ -z "$last_cmd" ] && return
+
+  [[ "$last_cmd" =~ ^proj-track ]] && return
+  [[ "$last_cmd" =~ ^__vsc ]] && return
+  [[ "$last_cmd" =~ ^__proj ]] && return
+  [[ "$last_cmd" =~ ^__git ]] && return
+
+  if [ -d ".git" ] || [ -f "package.json" ] || [ -f ".proj-track.json" ]; then
+    [ -f ".proj-track-disabled" ] && return
+    [ -f ".proj-track.json.paused" ] && return
+    (proj-track-logger "$last_cmd" >/dev/null 2>&1 &)
+    disown -a 2>/dev/null
+  fi
+}
+
+if [ -n "$__proj_track_old_prompt" ]; then
+  PROMPT_COMMAND="__proj_track_capture; \${__proj_track_old_prompt}"
+else
+  PROMPT_COMMAND='__proj_track_capture'
+fi
+
+alias thistory='proj-track list 2>/dev/null'
+alias trun='proj-track run'
+alias tclear='proj-track clear'
+alias tinit='proj-track init'
+alias tremove='proj-track remove'
+alias tpause='proj-track pause'
+alias tresume='proj-track resume'
+${END_MARKER}`;
+}
+function getInlineZshHook() {
+    return `${START_MARKER}
+# AUTO-CAPTURE via preexec hook (Zsh native, no DEBUG trap)
+
+if typeset -f __proj_track_preexec >/dev/null 2>&1; then
+  add-zsh-hook -d preexec __proj_track_preexec 2>/dev/null
+  unfunction __proj_track_preexec 2>/dev/null
+fi
+
+__proj_track_preexec() {
+  local cmd="$1"
+
+  if ! command -v proj-track-logger >/dev/null 2>&1; then
+    return
+  fi
+
+  [ -z "$cmd" ] && return
+
+  [[ "$cmd" =~ ^proj-track ]] && return
+  [[ "$cmd" =~ ^__vsc ]] && return
+  [[ "$cmd" =~ ^__proj ]] && return
+  [[ "$cmd" =~ ^__git ]] && return
+
+  if [ -d ".git" ] || [ -f "package.json" ] || [ -f ".proj-track.json" ]; then
+    [ -f ".proj-track-disabled" ] && return
+    [ -f ".proj-track.json.paused" ] && return
+    (proj-track-logger "$cmd" >/dev/null 2>&1 &)
+    disown 2>/dev/null
+  fi
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __proj_track_preexec
+
+alias thistory='proj-track list 2>/dev/null'
+alias trun='proj-track run'
+alias tclear='proj-track clear'
+alias tinit='proj-track init'
+alias tremove='proj-track remove'
+alias tpause='proj-track pause'
+alias tresume='proj-track resume'
+${END_MARKER}`;
+}
+/**
+ * Check if the hook is already installed in a config file.
+ */
+function isInstalled(configPath) {
+    if (!fs.existsSync(configPath))
+        return false;
+    const content = fs.readFileSync(configPath, 'utf-8');
+    return content.includes(START_MARKER);
+}
+/**
+ * Remove ALL proj-track related content from a config file.
+ * Uses line-by-line filtering to cleanly remove everything between
+ * start/end markers, including any orphaned partial blocks.
+ */
+function cleanConfig(configPath) {
+    if (!fs.existsSync(configPath))
+        return;
+    const content = fs.readFileSync(configPath, 'utf-8');
+    // Nothing to clean
+    if (!content.includes('proj-track'))
+        return;
+    const lines = content.split('\n');
+    const cleaned = [];
+    let insideBlock = false;
+    for (const line of lines) {
+        // Detect start of any proj-track block
+        if (line.includes('# --- proj-track') && line.includes('start ---')) {
+            insideBlock = true;
+            continue;
+        }
+        // Detect end of any proj-track block
+        if (line.includes('# --- proj-track') && line.includes('end ---')) {
+            insideBlock = false;
+            continue;
+        }
+        // Skip lines inside a block
+        if (insideBlock)
+            continue;
+        cleaned.push(line);
+    }
+    // Remove trailing blank lines that were left behind
+    while (cleaned.length > 0 && cleaned[cleaned.length - 1].trim() === '') {
+        cleaned.pop();
+    }
+    // Ensure file ends with a newline
+    const newContent = cleaned.join('\n') + '\n';
+    fs.writeFileSync(configPath, newContent, 'utf-8');
+}
+/**
+ * Install the shell hook into .bashrc/.zshrc.
+ * Returns the list of files that were modified.
+ */
+export function installShellFunction() {
+    const configs = getShellConfigs();
+    const modified = [];
+    for (const configPath of configs) {
+        // Clean any existing proj-track content first
+        cleanConfig(configPath);
+        const shell = configPath.endsWith('.zshrc') ? 'zsh' : 'bash';
+        const hookContent = getHookContent(shell);
+        fs.appendFileSync(configPath, `\n${hookContent}\n`, 'utf-8');
+        modified.push(configPath);
+    }
+    return modified;
+}
+/**
+ * Uninstall the shell hook from all config files.
+ * Cleanly removes ALL proj-track content — no leftovers.
+ * Returns the list of files that were modified.
+ */
+export function uninstallShellFunction() {
+    const configs = getShellConfigs();
+    const modified = [];
+    for (const configPath of configs) {
+        if (!fs.existsSync(configPath))
+            continue;
+        const content = fs.readFileSync(configPath, 'utf-8');
+        if (!content.includes('proj-track'))
+            continue;
+        cleanConfig(configPath);
+        modified.push(configPath);
+    }
+    return modified;
+}
+/**
+ * Check if the shell hook is installed in any config file.
+ */
+export function isShellFunctionInstalled() {
+    const configs = getShellConfigs();
+    return configs.some(c => isInstalled(c));
+}
+//# sourceMappingURL=shell-installer.js.map

package/dist/utils/shell-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-installer.js","sourceRoot":"","sources":["../../src/utils/shell-installer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "proj-track",
+  "version": "1.0.0",
+  "description": "Auto-capture CLI command history per-project with zero terminal interference.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "proj-track": "dist/index.js",
+    "proj-track-logger": "dist/logger.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "preuninstall": "node scripts/preuninstall.js || true",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "cli",
+    "command-history",
+    "project-tracker",
+    "terminal",
+    "developer-tools",
+    "shell-history",
+    "bash",
+    "zsh",
+    "auto-capture",
+    "prompt-command",
+    "devtools",
+    "command-logger",
+    "project-history",
+    "workflow",
+    "productivity",
+    "shell-hook",
+    "terminal-history",
+    "command-tracking",
+    "nodejs",
+    "typescript"
+  ],
+  "author": {
+    "name": "Ali Raza",
+    "url": "https://github.com/Ali-Raza-Arain"
+  },
+  "homepage": "https://Ali-Raza-Arain.github.io/proj-track/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ali-Raza-Arain/proj-track.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Ali-Raza-Arain/proj-track/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.0.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.6.0",
+    "vitepress": "^1.6.4"
+  },
+  "files": [
+    "dist",
+    "src/hooks",
+    "scripts"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/preuninstall.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-uninstall script for proj-track.
+ * Runs on `npm uninstall -g proj-track` (even with sudo).
+ *
+ * Handles the sudo case: when user runs `sudo npm uninstall -g`,
+ * HOME=/root but the real user's shell config is in /home/<user>.
+ * We use SUDO_USER to find the correct home directory.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+
+/**
+ * Get the real user's home directory, even when running under sudo.
+ */
+function getRealHome() {
+  const sudoUser = process.env.SUDO_USER;
+
+  if (sudoUser) {
+    // Running under sudo — resolve real user's home
+    try {
+      const home = execSync(`eval echo ~${sudoUser}`, { encoding: 'utf-8' }).trim();
+      if (home && fs.existsSync(home)) {
+        return home;
+      }
+    } catch {
+      // Fall through
+    }
+
+    // Fallback: common Linux home path
+    const linuxHome = `/home/${sudoUser}`;
+    if (fs.existsSync(linuxHome)) {
+      return linuxHome;
+    }
+  }
+
+  // Not sudo — use normal HOME
+  return process.env.HOME || process.env.USERPROFILE || '';
+}
+
+/**
+ * Remove all proj-track content from a shell config file.
+ */
+function cleanConfig(configPath) {
+  if (!fs.existsSync(configPath)) return false;
+
+  const content = fs.readFileSync(configPath, 'utf-8');
+  if (!content.includes('proj-track')) return false;
+
+  const lines = content.split('\n');
+  const cleaned = [];
+  let insideBlock = false;
+
+  for (const line of lines) {
+    if (line.includes('# --- proj-track') && line.includes('start ---')) {
+      insideBlock = true;
+      continue;
+    }
+    if (line.includes('# --- proj-track') && line.includes('end ---')) {
+      insideBlock = false;
+      continue;
+    }
+    if (insideBlock) continue;
+    cleaned.push(line);
+  }
+
+  // Remove trailing blank lines
+  while (cleaned.length > 0 && cleaned[cleaned.length - 1].trim() === '') {
+    cleaned.pop();
+  }
+
+  fs.writeFileSync(configPath, cleaned.join('\n') + '\n', 'utf-8');
+  return true;
+}
+
+// --- Main ---
+try {
+  const home = getRealHome();
+  if (!home) process.exit(0);
+
+  const configs = [
+    path.join(home, '.bashrc'),
+    path.join(home, '.zshrc'),
+  ];
+
+  for (const configPath of configs) {
+    if (cleanConfig(configPath)) {
+      console.log(`proj-track: cleaned ${configPath}`);
+    }
+  }
+} catch {
+  // Silent exit — never block npm uninstall
+  process.exit(0);
+}

package/scripts/release.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ============================================================
+# Release Script for proj-track
+# Usage: ./scripts/release.sh [patch|minor|major]
+# Default: patch
+# ============================================================
+
+BUMP="${1:-patch}"
+
+echo "==> Running lint..."
+npm run lint
+
+echo "==> Running tests with coverage..."
+npm test -- --coverage
+echo ""
+
+echo "==> Building package..."
+npm run build
+
+echo "==> Building docs..."
+npm run docs:build
+
+echo "==> Bumping version ($BUMP)..."
+NEW_VERSION=$(npm version "$BUMP" --no-git-tag-version | tr -d 'v')
+echo "    New version: $NEW_VERSION"
+
+echo "==> Publishing to npm..."
+npm publish
+
+echo "==> Staging changes..."
+git add package.json package-lock.json
+
+echo "==> Committing..."
+git commit -m "$NEW_VERSION"
+
+echo "==> Creating annotated tag..."
+git tag -a "v$NEW_VERSION" -m "v$NEW_VERSION"
+
+echo "==> Pushing commit + tag..."
+git push origin main --follow-tags
+
+echo "==> Creating GitHub Release..."
+gh release create "v$NEW_VERSION" \
+  --title "v$NEW_VERSION" \
+  --generate-notes
+
+echo ""
+echo "============================================"
+echo "  Released v$NEW_VERSION successfully!"
+echo "============================================"
+echo ""
+echo "Post-release checklist:"
+echo "  1. Update CHANGELOG.md with release details"
+echo "  2. Verify Codecov badge updated (https://codecov.io/gh/Ali-Raza-Arain/proj-track)"
+echo "  3. Verify docs deployed (https://Ali-Raza-Arain.github.io/proj-track/)"
+echo "  4. Update GitHub repo 'About' description if needed"
+echo ""

package/src/hooks/bash-hook.sh

@@ -0,0 +1,67 @@
+# --- proj-track hook start ---
+# AUTO-CAPTURE via PROMPT_COMMAND (NOT DEBUG trap - doesn't break arrow keys)
+
+# Cleanup any previous installation from shell memory first
+if declare -f __proj_track_capture >/dev/null 2>&1; then
+  # Remove old function from PROMPT_COMMAND
+  PROMPT_COMMAND="${PROMPT_COMMAND//__proj_track_capture;/}"
+  PROMPT_COMMAND="${PROMPT_COMMAND//__proj_track_capture/}"
+  unset -f __proj_track_capture 2>/dev/null
+fi
+
+# Store the original PROMPT_COMMAND so we don't clobber it
+__proj_track_old_prompt="${PROMPT_COMMAND:-}"
+
+__proj_track_capture() {
+  # Guard: if proj-track-logger is not installed, disable self
+  if ! command -v proj-track-logger >/dev/null 2>&1; then
+    return
+  fi
+
+  # Get the last command from bash history (strip leading number + spaces)
+  local last_cmd
+  last_cmd=$(HISTTIMEFORMAT='' builtin history 1 | sed 's/^[ ]*[0-9]*[ ]*//')
+
+  # Skip empty
+  [ -z "$last_cmd" ] && return
+
+  # Skip proj-track's own commands (prevent self-tracking)
+  [[ "$last_cmd" =~ ^proj-track ]] && return
+
+  # Skip VS Code internal commands
+  [[ "$last_cmd" =~ ^__vsc ]] && return
+  [[ "$last_cmd" =~ ^__proj ]] && return
+  [[ "$last_cmd" =~ ^__git ]] && return
+
+  # Check if in a project directory (.git, package.json, or .proj-track.json)
+  if [ -d ".git" ] || [ -f "package.json" ] || [ -f ".proj-track.json" ]; then
+    # Check if permanently disabled (proj-track remove)
+    [ -f ".proj-track-disabled" ] && return
+
+    # Check if paused
+    [ -f ".proj-track.json.paused" ] && return
+
+    # Run logger in SUBSHELL with full suppression (NO job control messages)
+    (proj-track-logger "$last_cmd" >/dev/null 2>&1 &)
+
+    # Disown to prevent "[1]+ Done" messages
+    disown -a 2>/dev/null
+  fi
+}
+
+# Chain with existing PROMPT_COMMAND (don't clobber git prompt, etc.)
+if [ -n "$__proj_track_old_prompt" ]; then
+  PROMPT_COMMAND="__proj_track_capture; ${__proj_track_old_prompt}"
+else
+  PROMPT_COMMAND='__proj_track_capture'
+fi
+
+# Convenience aliases (manual commands still available)
+alias thistory='proj-track list 2>/dev/null'
+alias trun='proj-track run'
+alias tclear='proj-track clear'
+alias tinit='proj-track init'
+alias tremove='proj-track remove'
+alias tpause='proj-track pause'
+alias tresume='proj-track resume'
+# --- proj-track hook end ---

package/src/hooks/zsh-hook.sh

@@ -0,0 +1,54 @@
+# --- proj-track hook start ---
+# AUTO-CAPTURE via preexec hook (Zsh native, no DEBUG trap)
+
+# Cleanup any previous installation from shell memory first
+if typeset -f __proj_track_preexec >/dev/null 2>&1; then
+  add-zsh-hook -d preexec __proj_track_preexec 2>/dev/null
+  unfunction __proj_track_preexec 2>/dev/null
+fi
+
+__proj_track_preexec() {
+  local cmd="$1"
+
+  # Guard: if proj-track-logger is not installed, disable self
+  if ! command -v proj-track-logger >/dev/null 2>&1; then
+    return
+  fi
+
+  # Skip empty
+  [ -z "$cmd" ] && return
+
+  # Skip proj-track's own commands
+  [[ "$cmd" =~ ^proj-track ]] && return
+
+  # Skip VS Code internal commands
+  [[ "$cmd" =~ ^__vsc ]] && return
+  [[ "$cmd" =~ ^__proj ]] && return
+  [[ "$cmd" =~ ^__git ]] && return
+
+  # Check if in a project directory
+  if [ -d ".git" ] || [ -f "package.json" ] || [ -f ".proj-track.json" ]; then
+    # Check if permanently disabled (proj-track remove)
+    [ -f ".proj-track-disabled" ] && return
+
+    # Check if paused
+    [ -f ".proj-track.json.paused" ] && return
+
+    # Silent execution in subshell
+    (proj-track-logger "$cmd" >/dev/null 2>&1 &)
+    disown 2>/dev/null
+  fi
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __proj_track_preexec
+
+# Convenience aliases
+alias thistory='proj-track list 2>/dev/null'
+alias trun='proj-track run'
+alias tclear='proj-track clear'
+alias tinit='proj-track init'
+alias tremove='proj-track remove'
+alias tpause='proj-track pause'
+alias tresume='proj-track resume'
+# --- proj-track hook end ---