@adithya-naik/cmd-tracker 1.0.2 → 1.0.3

package/.github/workflows/ci.yml

@@ -11,6 +11,24 @@ permissions:
   contents: read
 
 jobs:
+  lint:
+    name: Lint Code
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+        with:
+          persist-credentials: false
+      - name: Setup Node.js
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af
+        with:
+          node-version: "20"
+          cache: "npm"
+      - name: Install dependencies
+        run: npm ci
+      - name: Run ESLint
+        run: npm run lint
+
   validate:
     name: Validate Code
     runs-on: ubuntu-latest
@@ -74,4 +92,4 @@ jobs:
       - name: Test CLI loads
         run: |
           node bin/tracker.js --version
-          echo "✅ CLI loads successfully!"
+          echo "✅ CLI loads successfully!"

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/bin/tracker.js

@@ -19,12 +19,12 @@
 
 // Import commander - this package helps us build CLI commands easily
 // Like "list", "stats", "search" etc.
-const { program } = require("commander");
+const { program } = require('commander');
 
 // Import package.json to read our version number
 // __dirname = current folder path (bin/)
 // ../ = go one level up (to root of project)
-const packageJson = require("../package.json");
+const packageJson = require('../package.json');
 
 /*
  * Import our init command function
@@ -34,34 +34,34 @@ const packageJson = require("../package.json");
  * bin/ → go up one level → ../
  * then into src/commands/init.js
  */
-const { initCommand } = require("../src/commands/init");
+const { initCommand } = require('../src/commands/init');
 
 /*
  * Import our save command function
  * This runs automatically via shell hook every time
  * user types a command in terminal
  */
-const { saveCommandAction } = require("../src/commands/save");
+const { saveCommandAction } = require('../src/commands/save');
 // Import list command function
-const { listCommand } = require("../src/commands/list");
+const { listCommand } = require('../src/commands/list');
 // Import search command function
-const { searchCommand } = require("../src/commands/search");
-const { statsCommand } = require("../src/commands/stats");
-const { clearCommand } = require("../src/commands/clear");
-const { exportCommand } = require("../src/commands/export");
-const { hookCommand, unhookCommand } = require("../src/commands/hook");
-const { favoriteCommand, favoritesCommand } = require("../src/commands/favorite");
+const { searchCommand } = require('../src/commands/search');
+const { statsCommand } = require('../src/commands/stats');
+const { clearCommand } = require('../src/commands/clear');
+const { exportCommand } = require('../src/commands/export');
+const { hookCommand, unhookCommand } = require('../src/commands/hook');
+const { favoriteCommand, favoritesCommand } = require('../src/commands/favorite');
 /*
  * .name() → sets the name of our CLI tool
  * This shows up when user types: tracker --help
  */
-program.name("tracker");
+program.name('tracker');
 
 /*
  * .description() → explains what our tool does
  * This also shows up in: tracker --help
  */
-program.description("📟 A developer tool that auto-captures, categorizes and saves terminal commands per project for easy revision");
+program.description('📟 A developer tool that auto-captures, categorizes and saves terminal commands per project for easy revision');
 
 /*
  * .version() → sets the version of our CLI tool
@@ -79,21 +79,21 @@ program.version(packageJson.version);
  * So user runs: tracker hello
  */
 program
-  .command("hello")
+  .command('hello')
 
   /*
    * .description() → explains what this command does
    * Shows up when user types: tracker --help
    */
-  .description("A test command to check if CLI is working")
+  .description('A test command to check if CLI is working')
 
   /*
    * .action() → this function runs when user types: tracker hello
    * Whatever code you write inside here — runs when command is called
    */
   .action(() => {
-    console.log("👋 Hey! tracker CLI is working perfectly!");
-    console.log("🚀 Let's start tracking your commands!");
+    console.log('👋 Hey! tracker CLI is working perfectly!');
+    console.log('🚀 Let\'s start tracking your commands!');
   });
 
 
@@ -109,8 +109,8 @@ program
 * This keeps bin/tracker.js clean and simple
 */
 program
-  .command("init")
-  .description("Initialize cmd-tracker in your current project")
+  .command('init')
+  .description('Initialize cmd-tracker in your current project')
   .action(() => {
     initCommand();
   });
@@ -132,9 +132,9 @@ program
 * "[command]" → square brackets mean OPTIONAL
 */
 program
-  .command("save")
-  .description("Save a command to tracker (called automatically by shell hook)")
-  .argument("<command>", "the terminal command to save")
+  .command('save')
+  .description('Save a command to tracker (called automatically by shell hook)')
+  .argument('<command>', 'the terminal command to save')
   .action((command) => {
     saveCommandAction(command);
   });
@@ -148,9 +148,9 @@ program
 * [category] → square brackets = OPTIONAL argument
 */
 program
-  .command("list")
-  .description("List all saved commands or filter by category")
-  .argument("[category]", "optional category filter (git/npm/docker/linux/node/angular/python/others)")
+  .command('list')
+  .description('List all saved commands or filter by category')
+  .argument('[category]', 'optional category filter (git/npm/docker/linux/node/angular/python/others)')
   .action((category) => {
     listCommand(category);
   });
@@ -164,9 +164,9 @@ program
 * <query> → required argument
 */
 program
-  .command("search")
-  .description("Search through all saved commands")
-  .argument("<query>", "search term to look for in saved commands")
+  .command('search')
+  .description('Search through all saved commands')
+  .argument('<query>', 'search term to look for in saved commands')
   .action((query) => {
     searchCommand(query);
   });
@@ -176,8 +176,8 @@ program
 * tracker stats → shows category breakdown with percentages
 */
 program
-  .command("stats")
-  .description("Show statistics of saved commands by category")
+  .command('stats')
+  .description('Show statistics of saved commands by category')
   .action(() => {
     statsCommand();
   });
@@ -190,9 +190,9 @@ program
  * [category] → optional argument
  */
 program
-  .command("clear")
-  .description("Clear all saved commands or a specific category")
-  .argument("[category]", "optional category to clear")
+  .command('clear')
+  .description('Clear all saved commands or a specific category')
+  .argument('[category]', 'optional category to clear')
   .action((category) => {
     clearCommand(category);
   });
@@ -206,9 +206,9 @@ program
  * "--csv" → user types --csv to trigger CSV export
  */
 program
-  .command("export")
-  .description("Export saved commands as JSON or CSV file")
-  .option("--csv", "export as CSV instead of JSON")
+  .command('export')
+  .description('Export saved commands as JSON or CSV file')
+  .option('--csv', 'export as CSV instead of JSON')
   .action((options) => {
     exportCommand(options);
   });
@@ -218,8 +218,8 @@ program
 * tracker hook → installs shell hook for auto capture
 */
 program
-  .command("hook")
-  .description("Enable automatic command capture via shell hook")
+  .command('hook')
+  .description('Enable automatic command capture via shell hook')
   .action(() => {
     hookCommand();
   });
@@ -229,8 +229,8 @@ program
  * tracker unhook → removes shell hook
  */
 program
-  .command("unhook")
-  .description("Disable automatic command capture")
+  .command('unhook')
+  .description('Disable automatic command capture')
   .action(() => {
     unhookCommand();
   });
@@ -241,9 +241,9 @@ program
 * tracker favorite "git status" → toggles favorite
 */
 program
-  .command("favorite")
-  .description("Toggle a command as favorite")
-  .argument("<command>", "command to mark as favorite")
+  .command('favorite')
+  .description('Toggle a command as favorite')
+  .argument('<command>', 'command to mark as favorite')
   .action((command) => {
     favoriteCommand(command);
   });
@@ -253,8 +253,8 @@ program
  * tracker favorites → lists all favorites
  */
 program
-  .command("favorites")
-  .description("List all favorited commands")
+  .command('favorites')
+  .description('List all favorited commands')
   .action(() => {
     favoritesCommand();
   });

package/eslint.config.js

@@ -0,0 +1,30 @@
+const js = require('@eslint/js');
+const globals = require('globals');
+
+module.exports = [
+  js.configs.recommended,
+  {
+    files: ['**/*.js'],
+    languageOptions: {
+      ecmaVersion: 2021,
+      sourceType: 'commonjs',
+      globals: {
+        ...globals.node,
+        ...globals.es2021,
+      },
+    },
+    rules: {
+      'no-unused-vars': ['error', { 
+        argsIgnorePattern: '^_', 
+        caughtErrors: 'none' 
+      }],
+      'no-console': 'off',
+      'quotes': ['error', 'single'],
+      'semi': ['error', 'always'],
+      'indent': ['error', 2],
+    },
+  },
+  {
+    ignores: ['node_modules/', '.tracker/', '*.json'],
+  },
+];

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@adithya-naik/cmd-tracker",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "📟 A developer tool that auto-captures, categorizes and saves terminal commands per project for easy revision",
   "main": "src/index.js",
   "bin": {
     "tracker": "./bin/tracker.js"
   },
   "scripts": {
-    "test": "echo \"No tests yet\""
+    "test": "echo \"No tests yet\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepare": "husky install"
   },
   "repository": {
     "type": "git",
@@ -35,7 +38,19 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
-    "commander": "^11.0.0",
-    "chalk": "^4.1.2"
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0"
+  },
+  "lint-staged": {
+    "*.js": [
+      "eslint --fix"
+    ]
   }
 }

package/src/commands/clear.js

@@ -3,18 +3,18 @@
  * Now with proper error handling using validator.js
  */
 
-const fs = require("fs");
-const path = require("path");
-const readline = require("readline");
-const { readCommands } = require("../utils/storage");
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { readCommands } = require('../utils/storage');
 const {
   isInitialized,
   showInitError,
   isValidCategory,
   showCategoryError
-} = require("../utils/validator");
+} = require('../utils/validator');
 
-const COMMANDS_FILE = path.join(process.cwd(), ".tracker", "commands.json");
+const COMMANDS_FILE = path.join(process.cwd(), '.tracker', 'commands.json');
 
 function ask(question) {
   const rl = readline.createInterface({
@@ -63,8 +63,8 @@ async function clearCommand(category) {
         `\n⚠️  Clear all ${data[cat].length} ${cat} commands? (yes/no): `
       );
 
-      if (answer.toLowerCase() !== "yes") {
-        console.log("❌ Cancelled\n");
+      if (answer.toLowerCase() !== 'yes') {
+        console.log('❌ Cancelled\n');
         return;
       }
 
@@ -79,7 +79,7 @@ async function clearCommand(category) {
     );
 
     if (total === 0) {
-      console.log("\n📭 No commands saved yet\n");
+      console.log('\n📭 No commands saved yet\n');
       return;
     }
 
@@ -87,8 +87,8 @@ async function clearCommand(category) {
       `\n⚠️  Clear ALL ${total} saved commands? This cannot be undone! (yes/no): `
     );
 
-    if (answer.toLowerCase() !== "yes") {
-      console.log("❌ Cancelled\n");
+    if (answer.toLowerCase() !== 'yes') {
+      console.log('❌ Cancelled\n');
       return;
     }
 
@@ -101,8 +101,8 @@ async function clearCommand(category) {
     console.log(`\n✅ Cleared all ${total} saved commands\n`);
 
   } catch (error) {
-    console.log("\n❌ Error clearing commands");
-    console.log("💡 Try running tracker init again\n");
+    console.log('\n❌ Error clearing commands');
+    console.log('💡 Try running tracker init again\n');
   }
 }
 

package/src/commands/export.js

@@ -3,10 +3,10 @@
  * 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");
+const fs = require('fs');
+const path = require('path');
+const { readCommands } = require('../utils/storage');
+const { isInitialized, showInitError } = require('../utils/validator');
 
 function exportCommand(options) {
 
@@ -26,8 +26,8 @@ function exportCommand(options) {
     );
 
     if (total === 0) {
-      console.log("\n📭 No commands to export yet!");
-      console.log("💡 Use: tracker save \"your command\"\n");
+      console.log('\n📭 No commands to export yet!');
+      console.log('💡 Use: tracker save "your command"\n');
       return;
     }
 
@@ -38,8 +38,8 @@ function exportCommand(options) {
     }
 
   } catch (error) {
-    console.log("\n❌ Error exporting commands");
-    console.log("💡 Try running tracker init again\n");
+    console.log('\n❌ Error exporting commands');
+    console.log('💡 Try running tracker init again\n');
   }
 }
 
@@ -52,22 +52,22 @@ function exportAsJSON(data, total) {
       commands: data
     };
 
-    const filePath = path.join(process.cwd(), "tracker-export.json");
+    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");
+    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";
+    let csvContent = 'category,command,date\n';
 
     for (const [category, commands] of Object.entries(data)) {
       for (const item of commands) {
@@ -76,16 +76,16 @@ function exportAsCSV(data, total) {
       }
     }
 
-    const filePath = path.join(process.cwd(), "tracker-export.csv");
+    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`);
+    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");
+    console.log('\n❌ Error creating CSV file');
+    console.log('💡 Check if you have write permissions in this folder\n');
   }
 }
 

package/src/commands/favorite.js

@@ -9,8 +9,8 @@
  * in commands.json
  */
 
-const { toggleFavorite, getFavorites } = require("../utils/storage");
-const { isInitialized, showInitError } = require("../utils/validator");
+const { toggleFavorite, getFavorites } = require('../utils/storage');
+const { isInitialized, showInitError } = require('../utils/validator');
 
 /*
  * favoriteCommand() — toggles favorite on a specific command
@@ -25,8 +25,8 @@ function favoriteCommand(command) {
   }
 
   if (!command || !command.trim()) {
-    console.log("\n❌ Please provide a command to favorite");
-    console.log("💡 Usage: tracker favorite \"git status\"\n");
+    console.log('\n❌ Please provide a command to favorite');
+    console.log('💡 Usage: tracker favorite "git status"\n');
     return;
   }
 
@@ -34,16 +34,16 @@ function favoriteCommand(command) {
     const result = toggleFavorite(command.trim());
 
     if (!result.success) {
-      if (result.reason === "command not found") {
+      if (result.reason === 'command not found') {
         console.log(`\n❌ Command not found: "${command}"`);
-        console.log("💡 Run tracker list to see saved commands\n");
+        console.log('💡 Run tracker list to see saved commands\n');
         return;
       }
-      console.log("\n❌ Failed to update favorite\n");
+      console.log('\n❌ Failed to update favorite\n');
       return;
     }
 
-    if (result.action === "added") {
+    if (result.action === 'added') {
       console.log(`\n⭐ Added to favorites: ${command}`);
       console.log(`📁 Category: ${result.category}\n`);
     } else {
@@ -51,8 +51,8 @@ function favoriteCommand(command) {
     }
 
   } catch (error) {
-    console.log("\n❌ Error updating favorite");
-    console.log("💡 Try running tracker init again\n");
+    console.log('\n❌ Error updating favorite');
+    console.log('💡 Try running tracker init again\n');
   }
 }
 
@@ -70,13 +70,13 @@ function favoritesCommand() {
     const favorites = getFavorites();
 
     if (favorites.length === 0) {
-      console.log("\n⭐ No favorites yet!");
-      console.log("💡 Usage: tracker favorite \"git status\"\n");
+      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));
+    console.log('\n⭐ CMD-TRACKER — Your Favorites\n');
+    console.log('─'.repeat(50));
 
     favorites.forEach((item, index) => {
       const date = new Date(item.time).toLocaleDateString();
@@ -84,11 +84,11 @@ function favoritesCommand() {
       console.log(`     📁 ${item.category}  📅 ${date}`);
     });
 
-    console.log("\n" + "─".repeat(50));
+    console.log('\n' + '─'.repeat(50));
     console.log(`⭐ Total favorites: ${favorites.length}\n`);
 
   } catch (error) {
-    console.log("\n❌ Error reading favorites\n");
+    console.log('\n❌ Error reading favorites\n');
   }
 }
 

package/src/commands/hook.js

@@ -12,9 +12,9 @@ const {
   removeHook,
   isHookInstalled,
   detectShell
-} = require("../utils/hook");
+} = require('../utils/hook');
 
-const { isInitialized, showInitError } = require("../utils/validator");
+const { isInitialized, showInitError } = require('../utils/validator');
 
 /*
  * hookCommand() — runs when user types: tracker hook
@@ -30,7 +30,7 @@ function hookCommand() {
     return;
   }
 
-  console.log("\n🪄 Setting up automatic command capture...\n");
+  console.log('\n🪄 Setting up automatic command capture...\n');
 
   /*
    * Show which shell was detected
@@ -42,9 +42,9 @@ function hookCommand() {
    * 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");
+    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;
   }
 
@@ -52,22 +52,22 @@ function hookCommand() {
    * Install the hook
    */
   const result = installHook();
-  console.log("\n" + result.message);
+  console.log('\n' + result.message);
 
   if (result.success) {
-    console.log("\n🎯 Almost done! Run this command to activate:");
+    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 = {
-        zsh: "~/.zshrc",
-        bash: "~/.bashrc",
-        fish: "~/.config/fish/config.fish",
-        }[result.shell];
+    const sourceCmd = {
+      zsh: '~/.zshrc',
+      bash: '~/.bashrc',
+      fish: '~/.config/fish/config.fish',
+    }[result.shell];
     console.log(`\n   source ${sourceCmd}\n`);
-    console.log("After that — every command you type will be saved automatically! 🚀\n");
+    console.log('After that — every command you type will be saved automatically! 🚀\n');
   }
 }
 
@@ -77,22 +77,22 @@ function hookCommand() {
  */
 function unhookCommand() {
 
-  console.log("\n🔌 Removing automatic command capture...\n");
+  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 shell = result.shell || detectShell();
-        const sourceCmd = {
-            zsh: "~/.zshrc",
-            bash: "~/.bashrc",
-            fish: "~/.config/fish/config.fish",
-        }[shell];
-        console.log(`\n   source ${sourceCmd}\n`);
-        console.log("After that — automatic capture will be disabled\n");
-    }
+  if (result.success) {
+    console.log('\n🎯 Almost done! Run this to apply changes:');
+    const shell = result.shell || detectShell();
+    const sourceCmd = {
+      zsh: '~/.zshrc',
+      bash: '~/.bashrc',
+      fish: '~/.config/fish/config.fish',
+    }[shell];
+    console.log(`\n   source ${sourceCmd}\n`);
+    console.log('After that — automatic capture will be disabled\n');
+  }
 }
 
 module.exports = { hookCommand, unhookCommand };