proj-track 1.0.0

package/README.md

@@ -0,0 +1,253 @@
+<p align="center">
+  <img src="https://img.shields.io/npm/v/proj-track?style=for-the-badge&color=blue&label=proj-track" alt="version" />
+</p>
+
+<h1 align="center">proj-track</h1>
+
+<p align="center">
+  <strong>Silently track every terminal command per project — auto-captured, filtered, and instantly replayable.</strong><br/>
+  Auto-capture CLI command history per-project with zero terminal interference.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="license" />
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="node" />
+  <img src="https://img.shields.io/badge/TypeScript-5.x-blue" alt="typescript" />
+  <img src="https://img.shields.io/badge/tests-passing-green" alt="tests" />
+  <a href="https://codecov.io/gh/Ali-Raza-Arain/proj-track"><img src="https://codecov.io/gh/Ali-Raza-Arain/proj-track/branch/main/graph/badge.svg" alt="codecov" /></a>
+</p>
+
+---
+
+## The Problem
+
+Your shell history is global. It mixes commands from every project into one giant, unsearchable list. When you switch between projects, you can't remember the exact `docker-compose` flags, the migration command, or the deployment script you used last week.
+
+Existing solutions require you to manually type `track "your command"` every time — adding friction to your workflow and guaranteeing you'll forget.
+
+---
+
+## Why proj-track?
+
+- **Zero-config auto-capture** — Commands are captured when you press Enter. No wrapping, no prefixes.
+- **Per-project isolation** — Each project gets its own history in `.proj-track.json`.
+- **Zero terminal interference** — No `[1]+ Done` messages, no broken arrow keys, no Ctrl+C conflicts.
+- **Smart filtering** — Noise commands (cd, ls, clear) and sensitive data (passwords, tokens, API keys) are automatically skipped.
+- **Instant replay** — Re-run any tracked command by its ID.
+- **Bash + Zsh** — Works with both shells out of the box.
+
+---
+
+## Table of Contents
+
+- [How It Works](#how-it-works)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+- [Smart Filtering](#smart-filtering)
+- [Zero Interference Guarantee](#zero-interference-guarantee)
+- [Data Storage](#data-storage)
+- [Comparison with Alternatives](#comparison-with-alternatives)
+- [Running Tests](#running-tests)
+- [Contributing](#contributing)
+- [Security](#security)
+- [Support](#support)
+- [License](#license)
+
+---
+
+## How It Works
+
+```
+┌──────────────┐     ┌─────────────────────┐     ┌───────────────────┐
+│  You type a  │────>│  Shell hook fires   │────>│  Silent logger    │
+│   command    │     │  (PROMPT_COMMAND /  │     │  saves to         │
+│              │     │   preexec)          │     │  .proj-track.json │
+└──────────────┘     └─────────────────────┘     └───────────────────┘
+```
+
+| Shell | Hook | Why |
+| :--- | :--- | :--- |
+| **Bash** | `PROMPT_COMMAND` | Fires AFTER each command, doesn't intercept input |
+| **Zsh** | `preexec` | Native Zsh hook, fires before command execution |
+
+**Why not `DEBUG` trap?** The `DEBUG` trap fires on every keystroke/expansion and breaks arrow keys in VS Code Terminal. `PROMPT_COMMAND` only fires once after the command completes — no interference.
+
+---
+
+## Installation
+
+```bash
+npm install -g proj-track
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Initialize in your project directory
+cd ~/my-project
+proj-track init
+
+# 2. Reload your shell
+source ~/.bashrc   # or source ~/.zshrc
+
+# 3. Just work normally — commands are captured automatically!
+docker-compose up
+npm run build
+git push origin main
+
+# 4. View your history
+proj-track list
+```
+
+That's it. No `track "command"` needed. Everything is captured silently in the background.
+
+---
+
+## Commands
+
+| Command | Alias | Description |
+| :--- | :--- | :--- |
+| `proj-track init` | `tinit` | Initialize tracking in current project |
+| `proj-track list` | `thistory` | Show tracked commands |
+| `proj-track run <id>` | `trun <id>` | Re-run a command by its ID |
+| `proj-track clear` | `tclear` | Clear command history |
+| `proj-track pause` | `tpause` | Pause auto-capture |
+| `proj-track resume` | `tresume` | Resume auto-capture |
+| `proj-track remove` | `tremove` | Remove tracking (saves history as `.txt`) |
+| `proj-track install` | — | Install shell hook to `.bashrc`/`.zshrc` |
+| `proj-track uninstall` | — | Remove shell hook |
+
+### Pause / Resume
+
+```bash
+proj-track pause     # Stops auto-capture, preserves history
+proj-track resume    # Resumes auto-capture
+```
+
+### Remove
+
+```bash
+proj-track remove    # Converts history to .proj-track.txt and disables tracking
+```
+
+---
+
+## Smart Filtering
+
+### Project Detection
+
+| Marker | Example |
+| :--- | :--- |
+| `.git/` directory | Any git repository |
+| `package.json` file | Any Node.js project |
+| `.proj-track.json` file | Created via `proj-track init` |
+
+If none of these exist, proj-track silently does nothing.
+
+### Noise Commands (skipped automatically)
+
+`cd`, `ls`, `clear`, `echo`, `cat`, `pwd`, `exit`, `history`, `which`, `whoami`
+
+### Sensitive Commands (never saved)
+
+- Commands containing `password`, `secret`, `token`, `api_key`, `credential`
+- Inline assignments like `PASSWORD=123 ./run.sh`
+- MySQL password flags (`-p`)
+
+### Internal Commands (filtered)
+
+- VS Code's `__vsc_*` terminal commands
+- Any `__proj_*` or `__git_*` internal commands
+
+### Deduplication
+
+Running the same command consecutively only creates one history entry. Maximum 50 commands per project.
+
+---
+
+## Zero Interference Guarantee
+
+| Concern | How proj-track handles it |
+| :--- | :--- |
+| `[1]+ Done` messages | Background logging uses subshell + `disown` |
+| Arrow keys (up/down/left/right) | Uses `PROMPT_COMMAND`, NOT `DEBUG` trap |
+| Ctrl+C | No signal handlers installed |
+| Ctrl+V | No clipboard interference |
+| Command echoing | Logger suppresses all stdout/stderr |
+| Shell startup time | One function + aliases, minimal overhead |
+| Existing PROMPT_COMMAND | Chains with existing value, doesn't overwrite |
+
+---
+
+## Data Storage
+
+All data is stored locally in `.proj-track.json` in each project directory:
+
+```json
+{
+  "projectName": "my-project",
+  "commands": [
+    {
+      "id": 1710864000000,
+      "command": "docker-compose up -d",
+      "timestamp": "3/19/2026, 8:00:00 PM"
+    }
+  ]
+}
+```
+
+No data leaves your machine. No cloud. No telemetry.
+
+---
+
+## Comparison with Alternatives
+
+| Feature | proj-track | Manual `history \| grep` | Custom bash scripts |
+| :--- | :---: | :---: | :---: |
+| Auto-capture | Yes | No | Varies |
+| Per-project isolation | Yes | No | Manual |
+| Zero terminal interference | Yes | N/A | No |
+| Noise filtering | Yes | No | Manual |
+| Sensitive data filtering | Yes | No | No |
+| Instant replay | Yes | No | No |
+| Bash + Zsh | Yes | Bash only | Varies |
+| No config needed | Yes | N/A | No |
+
+For a detailed comparison, see the [docs](https://Ali-Raza-Arain.github.io/proj-track/guide/comparison).
+
+---
+
+## Running Tests
+
+```bash
+npm test
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) and follow our [Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## Security
+
+To report vulnerabilities, please see our [Security Policy](SECURITY.md).
+
+---
+
+## Support
+
+- [Documentation](https://Ali-Raza-Arain.github.io/proj-track/)
+- [GitHub Issues](https://github.com/Ali-Raza-Arain/proj-track/issues)
+- [Buy Me a Coffee](https://buymeacoffee.com/alirazaarain)
+
+---
+
+## License
+
+[MIT](https://opensource.org/licenses/MIT) — Made by [Ali Raza](https://github.com/Ali-Raza-Arain)

package/dist/commands/clear.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Clear all tracked command history for the current project.
+ */
+export declare function clearCommand(): Promise<void>;
+//# sourceMappingURL=clear.d.ts.map

package/dist/commands/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAQlD"}

package/dist/commands/clear.js

@@ -0,0 +1,15 @@
+import chalk from 'chalk';
+import { clearHistory } from '../utils/file-handler.js';
+import { isProjectDirectory } from '../utils/project-detector.js';
+/**
+ * Clear all tracked command history for the current project.
+ */
+export async function clearCommand() {
+    if (!isProjectDirectory()) {
+        console.log(chalk.yellow('Not a project directory.'));
+        return;
+    }
+    clearHistory();
+    console.log(chalk.green('✓ Command history cleared.'));
+}
+//# sourceMappingURL=clear.js.map

package/dist/commands/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,YAAY,EAAE,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Initialize proj-track in the current project.
+ * Creates .proj-track.json and installs auto-capture hook if needed.
+ */
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqDjD"}

package/dist/commands/init.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { readHistory, writeHistory } from '../utils/file-handler.js';
+import { installShellFunction, isShellFunctionInstalled } from '../utils/shell-installer.js';
+/**
+ * Initialize proj-track in the current project.
+ * Creates .proj-track.json and installs auto-capture hook if needed.
+ */
+export async function initCommand() {
+    const configPath = path.join(process.cwd(), '.proj-track.json');
+    if (fs.existsSync(configPath)) {
+        console.log(chalk.yellow('proj-track is already initialized in this project.'));
+        // Check if hook is missing from shell config
+        if (!isShellFunctionInstalled()) {
+            console.log(chalk.red('  But the shell hook is NOT installed in your .bashrc/.zshrc!'));
+            console.log(chalk.cyan('  Run: ') + chalk.white('proj-track install'));
+        }
+        return;
+    }
+    // Check for paused state
+    const pausedPath = configPath + '.paused';
+    if (fs.existsSync(pausedPath)) {
+        console.log(chalk.yellow('proj-track is paused in this project. Use `proj-track resume` to resume.'));
+        return;
+    }
+    // Remove disabled marker if re-initializing after a remove
+    const disabledPath = path.join(process.cwd(), '.proj-track-disabled');
+    if (fs.existsSync(disabledPath)) {
+        fs.unlinkSync(disabledPath);
+    }
+    // Create initial history file
+    const history = readHistory();
+    writeHistory(history);
+    console.log(chalk.green('✓ proj-track initialized in this project.'));
+    console.log(chalk.dim(`  Created ${configPath}`));
+    // Install shell hook if not already installed
+    if (!isShellFunctionInstalled()) {
+        const modified = installShellFunction();
+        if (modified.length > 0) {
+            console.log(chalk.green('✓ Auto-capture hook installed.'));
+            modified.forEach(f => console.log(chalk.dim(`  Updated ${f}`)));
+            console.log('');
+            console.log(chalk.cyan('Run the following to activate:'));
+            console.log(chalk.white(`  source ${modified[0]}`));
+        }
+    }
+    else {
+        console.log(chalk.dim('  Auto-capture hook already installed.'));
+    }
+    console.log('');
+    console.log(chalk.cyan('Commands are now auto-captured when you press Enter.'));
+    console.log(chalk.dim('  proj-track list') + chalk.dim('    — view history'));
+    console.log(chalk.dim('  proj-track clear') + chalk.dim('   — clear history'));
+    console.log(chalk.dim('  proj-track pause') + chalk.dim('   — pause tracking'));
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * List all tracked commands for the current project.
+ */
+export declare function listCommand(): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgCjD"}

package/dist/commands/list.js

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { readHistory } from '../utils/file-handler.js';
+import { isProjectDirectory, isTrackingPaused } from '../utils/project-detector.js';
+/**
+ * List all tracked commands for the current project.
+ */
+export async function listCommand() {
+    if (!isProjectDirectory()) {
+        console.log(chalk.yellow('Not a project directory. Run `proj-track init` to enable tracking.'));
+        return;
+    }
+    if (isTrackingPaused()) {
+        console.log(chalk.yellow('Tracking is paused. Run `proj-track resume` to resume.'));
+        return;
+    }
+    const history = readHistory();
+    if (history.commands.length === 0) {
+        console.log(chalk.dim('No commands tracked yet.'));
+        console.log(chalk.dim('Commands are auto-captured as you work. Try running some commands!'));
+        return;
+    }
+    console.log('');
+    console.log(chalk.bold(`  Tracked Commands (${history.commands.length})`));
+    console.log(chalk.dim('  ID            Timestamp             Command'));
+    console.log(chalk.dim('  ' + '─'.repeat(60)));
+    for (const entry of history.commands) {
+        const id = chalk.cyan(String(entry.id).padEnd(14));
+        const ts = chalk.dim(entry.timestamp.padEnd(22));
+        const cmd = chalk.white(entry.command);
+        console.log(`  ${id}${ts}${cmd}`);
+    }
+    console.log('');
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEpF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,oEAAoE,CAAC,CAAC,CAAC;QAChG,OAAO;IACT,CAAC;IAED,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC,CAAC;QACpF,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;QAC7F,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/pause.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pause tracking in the current project.
+ * Renames .proj-track.json → .proj-track.json.paused
+ */
+export declare function pauseCommand(): Promise<void>;
+//# sourceMappingURL=pause.d.ts.map

package/dist/commands/pause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause.d.ts","sourceRoot":"","sources":["../../src/commands/pause.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBlD"}

package/dist/commands/pause.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+/**
+ * Pause tracking in the current project.
+ * Renames .proj-track.json → .proj-track.json.paused
+ */
+export async function pauseCommand() {
+    const configPath = path.join(process.cwd(), '.proj-track.json');
+    const pausedPath = configPath + '.paused';
+    if (fs.existsSync(pausedPath)) {
+        console.log(chalk.yellow('Tracking is already paused.'));
+        return;
+    }
+    if (!fs.existsSync(configPath)) {
+        console.log(chalk.yellow('No proj-track history found in this project.'));
+        console.log(chalk.dim('Run `proj-track init` first.'));
+        return;
+    }
+    fs.renameSync(configPath, pausedPath);
+    console.log(chalk.green('✓ Tracking paused.'));
+    console.log(chalk.dim('  Run `proj-track resume` to resume tracking.'));
+}
+//# sourceMappingURL=pause.js.map

package/dist/commands/pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause.js","sourceRoot":"","sources":["../../src/commands/pause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAE1C,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commands/remove.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Remove proj-track from the current project.
+ * Converts .proj-track.json → .proj-track.txt (plain text backup).
+ * Creates .proj-track-disabled marker to stop all future capture.
+ */
+export declare function removeCommand(): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BnD"}

package/dist/commands/remove.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { convertToTxt } from '../utils/file-handler.js';
+/**
+ * Remove proj-track from the current project.
+ * Converts .proj-track.json → .proj-track.txt (plain text backup).
+ * Creates .proj-track-disabled marker to stop all future capture.
+ */
+export async function removeCommand() {
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, '.proj-track.json');
+    const pausedPath = configPath + '.paused';
+    const disabledPath = path.join(cwd, '.proj-track-disabled');
+    // Handle paused state — rename back so convertToTxt can read it
+    if (fs.existsSync(pausedPath)) {
+        fs.renameSync(pausedPath, configPath);
+    }
+    if (!fs.existsSync(configPath)) {
+        // Already removed but maybe they want to ensure it stays disabled
+        if (fs.existsSync(disabledPath)) {
+            console.log(chalk.yellow('proj-track is already removed from this project.'));
+        }
+        else {
+            console.log(chalk.yellow('No proj-track history found in this project.'));
+        }
+        return;
+    }
+    // Convert history to plain text backup
+    convertToTxt();
+    // Create disabled marker to permanently stop capture in this project
+    fs.writeFileSync(disabledPath, `Tracking disabled on ${new Date().toLocaleString()}\nRun "proj-track init" to re-enable.\n`, 'utf-8');
+    console.log(chalk.green('✓ proj-track removed from this project.'));
+    console.log(chalk.dim('  History saved to .proj-track.txt'));
+    console.log(chalk.dim('  Auto-capture stopped. Run `proj-track init` to re-enable.'));
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAE5D,gEAAgE;IAChE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,kEAAkE;QAClE,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,YAAY,EAAE,CAAC;IAEf,qEAAqE;IACrE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,wBAAwB,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,yCAAyC,EAAE,OAAO,CAAC,CAAC;IAEtI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/commands/resume.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resume tracking in the current project.
+ * Renames .proj-track.json.paused → .proj-track.json
+ */
+export declare function resumeCommand(): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBnD"}

package/dist/commands/resume.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+/**
+ * Resume tracking in the current project.
+ * Renames .proj-track.json.paused → .proj-track.json
+ */
+export async function resumeCommand() {
+    const configPath = path.join(process.cwd(), '.proj-track.json');
+    const pausedPath = configPath + '.paused';
+    if (!fs.existsSync(pausedPath)) {
+        if (fs.existsSync(configPath)) {
+            console.log(chalk.yellow('Tracking is not paused.'));
+        }
+        else {
+            console.log(chalk.yellow('No proj-track history found in this project.'));
+            console.log(chalk.dim('Run `proj-track init` first.'));
+        }
+        return;
+    }
+    fs.renameSync(pausedPath, configPath);
+    console.log(chalk.green('✓ Tracking resumed.'));
+}
+//# sourceMappingURL=resume.js.map

package/dist/commands/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAE1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO;IACT,CAAC;IAED,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-run a previously tracked command by its ID.
+ */
+export declare function runCommand(idStr: string): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC7D"}

package/dist/commands/run.js

@@ -0,0 +1,39 @@
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { findCommandById } from '../utils/file-handler.js';
+import { isProjectDirectory } from '../utils/project-detector.js';
+/**
+ * Re-run a previously tracked command by its ID.
+ */
+export async function runCommand(idStr) {
+    if (!isProjectDirectory()) {
+        console.log(chalk.yellow('Not a project directory.'));
+        return;
+    }
+    const id = parseInt(idStr, 10);
+    if (isNaN(id)) {
+        console.log(chalk.red('Invalid command ID. Use `track` to see available commands.'));
+        return;
+    }
+    const entry = findCommandById(id);
+    if (!entry) {
+        console.log(chalk.red(`Command with ID ${id} not found.`));
+        console.log(chalk.dim('Use `track` to see available commands.'));
+        return;
+    }
+    console.log(chalk.cyan(`▶ Running: ${entry.command}`));
+    console.log('');
+    try {
+        execSync(entry.command, {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+        });
+    }
+    catch (error) {
+        const exitCode = error.status ?? 1;
+        console.log('');
+        console.log(chalk.red(`Command exited with code ${exitCode}`));
+        process.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;YACtB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAI,KAA6B,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}