@adithya-naik/cmd-tracker 1.0.0

package/src/commands/export.js

@@ -0,0 +1,92 @@
+/*
+ * export.js
+ * Now with proper error handling using validator.js
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { readCommands } = require("../utils/storage");
+const { isInitialized, showInitError } = require("../utils/validator");
+
+function exportCommand(options) {
+
+  /*
+   * Check initialization first
+   */
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  try {
+    const data = readCommands();
+
+    const total = Object.values(data).reduce(
+      (sum, commands) => sum + commands.length, 0
+    );
+
+    if (total === 0) {
+      console.log("\n📭 No commands to export yet!");
+      console.log("💡 Use: tracker save \"your command\"\n");
+      return;
+    }
+
+    if (options.csv) {
+      exportAsCSV(data, total);
+    } else {
+      exportAsJSON(data, total);
+    }
+
+  } catch (error) {
+    console.log("\n❌ Error exporting commands");
+    console.log("💡 Try running tracker init again\n");
+  }
+}
+
+function exportAsJSON(data, total) {
+
+  try {
+    const exportData = {
+      exportedAt: new Date().toISOString(),
+      totalCommands: total,
+      commands: data
+    };
+
+    const filePath = path.join(process.cwd(), "tracker-export.json");
+    fs.writeFileSync(filePath, JSON.stringify(exportData, null, 2));
+
+    console.log(`\n✅ Exported ${total} commands to tracker-export.json`);
+    console.log(`📁 Location: ${filePath}\n`);
+
+  } catch (error) {
+    console.log("\n❌ Error creating JSON file");
+    console.log("💡 Check if you have write permissions in this folder\n");
+  }
+}
+
+function exportAsCSV(data, total) {
+
+  try {
+    let csvContent = "category,command,date\n";
+
+    for (const [category, commands] of Object.entries(data)) {
+      for (const item of commands) {
+        const date = new Date(item.time).toLocaleDateString();
+        csvContent += `${category},"${item.command}",${date}\n`;
+      }
+    }
+
+    const filePath = path.join(process.cwd(), "tracker-export.csv");
+    fs.writeFileSync(filePath, csvContent);
+
+    console.log(`\n✅ Exported ${total} commands to tracker-export.csv`);
+    console.log(`📁 Location: ${filePath}`);
+    console.log(`💡 Open in Excel or Google Sheets for easy revision!\n`);
+
+  } catch (error) {
+    console.log("\n❌ Error creating CSV file");
+    console.log("💡 Check if you have write permissions in this folder\n");
+  }
+}
+
+module.exports = { exportCommand };

package/src/commands/favorite.js

@@ -0,0 +1,95 @@
+/*
+ * favorite.js
+ *
+ * Handles two commands:
+ * tracker favorite "git status" → toggles favorite on that command
+ * tracker favorites             → lists all favorited commands
+ *
+ * Favorites are stored as { favorite: true } on each command object
+ * in commands.json
+ */
+
+const { toggleFavorite, getFavorites } = require("../utils/storage");
+const { isInitialized, showInitError } = require("../utils/validator");
+
+/*
+ * favoriteCommand() — toggles favorite on a specific command
+ *
+ * @param {string} command — command to favorite/unfavorite
+ */
+function favoriteCommand(command) {
+
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  if (!command || !command.trim()) {
+    console.log("\n❌ Please provide a command to favorite");
+    console.log("💡 Usage: tracker favorite \"git status\"\n");
+    return;
+  }
+
+  try {
+    const result = toggleFavorite(command.trim());
+
+    if (!result.success) {
+      if (result.reason === "command not found") {
+        console.log(`\n❌ Command not found: "${command}"`);
+        console.log("💡 Run tracker list to see saved commands\n");
+        return;
+      }
+      console.log("\n❌ Failed to update favorite\n");
+      return;
+    }
+
+    if (result.action === "added") {
+      console.log(`\n⭐ Added to favorites: ${command}`);
+      console.log(`📁 Category: ${result.category}\n`);
+    } else {
+      console.log(`\n✅ Removed from favorites: ${command}\n`);
+    }
+
+  } catch (error) {
+    console.log("\n❌ Error updating favorite");
+    console.log("💡 Try running tracker init again\n");
+  }
+}
+
+/*
+ * favoritesCommand() — lists all favorited commands
+ */
+function favoritesCommand() {
+
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  try {
+    const favorites = getFavorites();
+
+    if (favorites.length === 0) {
+      console.log("\n⭐ No favorites yet!");
+      console.log("💡 Usage: tracker favorite \"git status\"\n");
+      return;
+    }
+
+    console.log("\n⭐ CMD-TRACKER — Your Favorites\n");
+    console.log("─".repeat(50));
+
+    favorites.forEach((item, index) => {
+      const date = new Date(item.time).toLocaleDateString();
+      console.log(`\n  ${index + 1}. ${item.command}`);
+      console.log(`     📁 ${item.category}  📅 ${date}`);
+    });
+
+    console.log("\n" + "─".repeat(50));
+    console.log(`⭐ Total favorites: ${favorites.length}\n`);
+
+  } catch (error) {
+    console.log("\n❌ Error reading favorites\n");
+  }
+}
+
+module.exports = { favoriteCommand, favoritesCommand };

package/src/commands/hook.js

@@ -0,0 +1,89 @@
+/*
+ * hook.js (command)
+ *
+ * Handles "tracker hook" and "tracker unhook" commands
+ *
+ * tracker hook   → installs shell hook for auto capture
+ * tracker unhook → removes shell hook
+ */
+
+const {
+  installHook,
+  removeHook,
+  isHookInstalled,
+  detectShell
+} = require("../utils/hook");
+
+const { isInitialized, showInitError } = require("../utils/validator");
+
+/*
+ * hookCommand() — runs when user types: tracker hook
+ * Installs the shell hook for automatic command capture
+ */
+function hookCommand() {
+
+  /*
+   * Must run tracker init before tracker hook
+   */
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  console.log("\n🪄 Setting up automatic command capture...\n");
+
+  /*
+   * Show which shell was detected
+   */
+  const shell = detectShell();
+  console.log(`🔍 Detected shell: ${shell}`);
+
+  /*
+   * Check if already installed
+   */
+  if (isHookInstalled()) {
+    console.log("\n⚠️  Shell hook is already installed!");
+    console.log("💡 Your commands are already being captured automatically");
+    console.log("💡 Run: tracker unhook to disable\n");
+    return;
+  }
+
+  /*
+   * Install the hook
+   */
+  const result = installHook();
+  console.log("\n" + result.message);
+
+  if (result.success) {
+    console.log("\n🎯 Almost done! Run this command to activate:");
+    /*
+     * Always show Unix style path for source command
+     * Even on Windows — Git Bash uses Unix paths
+     * ~/.bashrc works on all systems
+     */
+    const sourceCmd = result.shell === "zsh" ? "~/.zshrc" : "~/.bashrc";
+    console.log(`\n   source ${sourceCmd}\n`);
+    console.log("After that — every command you type will be saved automatically! 🚀\n");
+  }
+}
+
+/*
+ * unhookCommand() — runs when user types: tracker unhook
+ * Removes the shell hook
+ */
+function unhookCommand() {
+
+  console.log("\n🔌 Removing automatic command capture...\n");
+
+  const result = removeHook();
+  console.log(result.message);
+
+  if (result.success) {
+    console.log("\n🎯 Almost done! Run this to apply changes:");
+    const sourceCmd = result.shell === "zsh" ? "~/.zshrc" : "~/.bashrc";
+    console.log(`\n   source ${sourceCmd}\n`);
+    console.log("After that — automatic capture will be disabled\n");
+  }
+}
+
+module.exports = { hookCommand, unhookCommand };

package/src/commands/init.js

@@ -0,0 +1,153 @@
+/*
+ * init.js
+ * Now with proper error handling
+ *
+ * Error cases handled:
+ * → Already initialized (runs tracker init twice)
+ * → No write permissions in folder
+ * → Any unexpected file system errors
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { initStorage } = require("../utils/storage");
+const { isInitialized } = require("../utils/validator");
+
+function initCommand() {
+
+  console.log("🚀 Initializing cmd-tracker in your project...\n");
+
+  try {
+
+    /*
+     * Check if already initialized
+     * If user runs tracker init twice — warn them
+     * but still continue in case files are corrupted
+     */
+    if (isInitialized()) {
+      console.log("⚠️  cmd-tracker is already initialized in this project!");
+      console.log("💡 Your existing commands are safe");
+      console.log("💡 Running init again will not delete your saved commands\n");
+    }
+
+    /*
+     * Initialize storage — creates .tracker folder
+     * and commands.json if they don't exist
+     */
+    initStorage();
+
+    /*
+     * Update .gitignore
+     */
+    updateGitignore();
+
+    console.log("\n✅ cmd-tracker initialized successfully!");
+    console.log("📁 Created .tracker/commands.json in your project");
+    console.log("\n🎯 You can now use:");
+    console.log("   tracker list     → see all saved commands");
+    console.log("   tracker stats    → see command statistics");
+    console.log("   tracker search   → search your commands");
+    console.log("   tracker export   → export your commands");
+    console.log("\n💡 Start using your terminal normally");
+    console.log("   Commands will be saved automatically!\n");
+
+  } catch (error) {
+
+    /*
+     * Handle specific error types
+     *
+     * error.code === "EACCES" → permission denied
+     * This happens when user doesn't have write access
+     * to the current folder
+     */
+    if (error.code === "EACCES") {
+      console.error("❌ Permission denied!");
+      console.error("💡 Try running with admin permissions");
+      console.error("💡 Or check folder write permissions\n");
+      return;
+    }
+
+    /*
+     * Handle no space left on disk
+     */
+    if (error.code === "ENOSPC") {
+      console.error("❌ No space left on disk!");
+      console.error("💡 Free up some disk space and try again\n");
+      return;
+    }
+
+    /*
+     * Any other unexpected error
+     */
+    console.error("❌ Failed to initialize cmd-tracker");
+    console.error(`Error: ${error.message}\n`);
+  }
+}
+
+function updateGitignore() {
+
+  const gitignorePath = path.join(process.cwd(), ".gitignore");
+  /*
+   * Added tracker-export files to gitignore too
+   * Users should not push their exported files to GitHub
+   * These are personal revision files — local only
+   */
+  const trackerEntry = "\n# cmd-tracker personal data\n.tracker/\ntracker-export.json\ntracker-export.csv\n";
+
+  try {
+
+    if (fs.existsSync(gitignorePath)) {
+      const gitignoreContent = fs.readFileSync(gitignorePath, "utf-8");
+
+      /*
+       * Check each entry separately
+       * So we can add missing entries without touching existing ones
+       */
+      let entriesToAdd = "";
+
+      if (!gitignoreContent.includes(".tracker/")) {
+        entriesToAdd += ".tracker/\n";
+      }
+
+      if (!gitignoreContent.includes("tracker-export.json")) {
+        entriesToAdd += "tracker-export.json\n";
+      }
+
+      if (!gitignoreContent.includes("tracker-export.csv")) {
+        entriesToAdd += "tracker-export.csv\n";
+      }
+
+      /*
+       * Only write if there's something new to add
+       */
+      if (entriesToAdd === "") {
+        console.log("✅ .gitignore already up to date");
+        return;
+      }
+
+      fs.appendFileSync(
+        gitignorePath,
+        "\n# cmd-tracker personal data\n" + entriesToAdd
+      );
+      console.log("✅ Updated .gitignore with cmd-tracker entries");
+
+      fs.appendFileSync(gitignorePath, trackerEntry);
+      console.log("✅ Added .tracker/ to your .gitignore");
+
+    } else {
+      fs.writeFileSync(gitignorePath, trackerEntry);
+      console.log("✅ Created .gitignore with .tracker/ entry");
+    }
+
+  } catch (error) {
+
+    /*
+     * .gitignore update failed — not critical
+     * tracker still works, just warn the user
+     */
+    console.log("⚠️  Could not update .gitignore automatically");
+    console.log("💡 Manually add .tracker/ to your .gitignore\n");
+  }
+}
+
+module.exports = { initCommand };

package/src/commands/list.js

@@ -0,0 +1,107 @@
+/*
+ * list.js
+ *
+ * Handles "tracker list" and "tracker list <category>" commands
+ * Now with proper error handling using validator.js
+ */
+
+const { readCommands } = require("../utils/storage");
+const {
+  isInitialized,
+  showInitError,
+  isValidCategory,
+  showCategoryError
+} = require("../utils/validator");
+
+function listCommand(category) {
+
+  /*
+   * Check if tracker init was run first
+   * If not — show helpful error and stop
+   */
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  /*
+   * If category provided — validate it
+   */
+  if (category) {
+    if (!isValidCategory(category)) {
+      showCategoryError(category);
+      return;
+    }
+
+    const data = readCommands();
+    const cat = category.toLowerCase();
+    displayCategory(cat, data[cat]);
+    return;
+  }
+
+  /*
+   * No category — show all commands
+   */
+  try {
+    const data = readCommands();
+    let totalCommands = 0;
+
+    console.log("\n📟 CMD-TRACKER — Your Command History\n");
+    console.log("─".repeat(50));
+
+    for (const [cat, commands] of Object.entries(data)) {
+      if (commands.length === 0) continue;
+      displayCategory(cat, commands);
+      totalCommands += commands.length;
+    }
+
+    if (totalCommands === 0) {
+      console.log("\n📭 No commands saved yet!");
+      console.log("💡 Use: tracker save \"your command\"");
+      console.log("💡 Or run commands normally if shell hook is set up\n");
+      return;
+    }
+
+    console.log("─".repeat(50));
+    console.log(`\n✅ Total: ${totalCommands} commands saved\n`);
+
+  } catch (error) {
+    /*
+     * Something went wrong reading the file
+     * Show clear error instead of crashing
+     */
+    console.log("\n❌ Error reading commands");
+    console.log(`💡 Try running tracker init again\n`);
+  }
+}
+
+function displayCategory(categoryName, commands) {
+
+  const icons = {
+    git:     "🔀",
+    npm:     "📦",
+    docker:  "🐳",
+    linux:   "🐧",
+    node:    "🟢",
+    angular: "🔴",
+    python:  "🐍",
+    others:  "📌"
+  };
+
+  const icon = icons[categoryName] || "📌";
+
+  console.log(`\n${icon}  ${categoryName.toUpperCase()} (${commands.length})`);
+  console.log("─".repeat(30));
+
+  if (commands.length === 0) {
+    console.log("  📭 No commands saved yet");
+    return;
+  }
+
+  commands.forEach((item, index) => {
+    const date = new Date(item.time).toLocaleDateString();
+    console.log(`  ${String(index + 1).padStart(2, " ")}. ${item.command}  (${date})`);
+  });
+}
+
+module.exports = { listCommand };

package/src/commands/save.js

@@ -0,0 +1,63 @@
+/*
+ * save.js
+ * Now with proper error handling
+ *
+ * Error cases handled:
+ * → tracker not initialized
+ * → empty command
+ * → file write failures
+ * → any unexpected errors
+ *
+ * Important: ALL errors are silent here
+ * save runs automatically in background
+ * We NEVER want it to interrupt user's workflow
+ */
+
+const { saveCommand } = require("../utils/storage");
+const { isInitialized } = require("../utils/validator");
+
+function saveCommandAction(command) {
+
+  /*
+   * Safety check — empty command
+   * Return silently — no error message needed
+   */
+  if (!command || !command.trim()) {
+    return;
+  }
+
+  /*
+   * Check if tracker is initialized
+   *
+   * Unlike other commands — we fail SILENTLY here
+   * Because save runs automatically via shell hook
+   * Showing errors every time would be very annoying
+   * for users who haven't run tracker init yet
+   */
+  if (!isInitialized()) {
+    return;
+  }
+
+  try {
+
+    const result = saveCommand(command);
+
+    /*
+     * Only show output when command is newly saved
+     * Stay silent for duplicates
+     */
+    if (result.saved) {
+      console.log(`✅ Saved [${result.category}]: ${command}`);
+    }
+
+  } catch (error) {
+
+    /*
+     * Fail completely silently
+     * Never interrupt user's terminal workflow
+     */
+    return;
+  }
+}
+
+module.exports = { saveCommandAction };

package/src/commands/search.js

@@ -0,0 +1,97 @@
+/*
+ * search.js
+ *
+ * Handles "tracker search <query>" command
+ *
+ * tracker search "git"     → finds all commands containing "git"
+ * tracker search "install" → finds all commands containing "install"
+ *
+ * Searches across ALL categories at once
+ * Returns matching commands with their category
+ */
+
+const { readCommands } = require("../utils/storage");
+const {
+  isInitialized,
+  showInitError,
+  isValidQuery
+} = require("../utils/validator");
+
+/*
+ * searchCommand() — main function
+ *
+ * @param {string} query — what user is searching for
+ *                         comes from: tracker search "git status"
+ */
+function searchCommand(query) {
+
+  /*
+   * Check initialization first
+   */
+  if (!isInitialized()) {
+    showInitError();
+    return;
+  }
+
+  /*
+   * Validate query
+   */
+  if (!isValidQuery(query)) {
+    console.log("\n❌ Please provide a search query");
+    console.log("💡 Usage: tracker search \"git\"\n");
+    return;
+  }
+
+  try {
+    const searchTerm = query.trim().toLowerCase();
+    const data = readCommands();
+    const results = [];
+
+    for (const [category, commands] of Object.entries(data)) {
+      for (const item of commands) {
+        if (item.command.toLowerCase().includes(searchTerm)) {
+          results.push({
+            command: item.command,
+            category: category,
+            time: item.time
+          });
+        }
+      }
+    }
+
+    if (results.length === 0) {
+      console.log(`\n🔍 No commands found for: "${query}"\n`);
+      return;
+    }
+
+    console.log(`\n🔍 Search results for: "${query}"`);
+    console.log("─".repeat(50));
+
+  results.forEach((item, index) => {
+
+    const date = new Date(item.time).toLocaleDateString();
+
+    /*
+     * Highlight the search term in results
+     * Replace matched part with uppercase version
+     * So user can easily spot what matched
+     */
+    const highlighted = item.command.replace(
+      new RegExp(searchTerm, "gi"),
+      (match) => `[${match.toUpperCase()}]`
+    );
+
+    console.log(`\n  ${index + 1}. ${highlighted}`);
+    console.log(`     📁 Category: ${item.category}  📅 ${date}`);
+  });
+
+    console.log("\n" + "─".repeat(50));
+    console.log(`✅ Found ${results.length} matching command(s)\n`);
+
+  } catch (error) {
+    console.log("\n❌ Error searching commands");
+    console.log("💡 Try running tracker init again\n");
+  }
+}
+
+module.exports = { searchCommand };