@traisetech/autopilot 0.1.8 → 2.0.0

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 All notable changes to this project will be documented in this file.
 This project follows [Semantic Versioning](https://semver.org).
 
+## [2.0.0] - 2026-02-04
+
+### Added
+- **Safety System (Phase 1)**:
+  - **Undo/Rollback**: `autopilot undo` command to safely revert the last autopilot commit.
+  - **Team Mode**: Enhanced `autopilot init` with team configuration. Implements "Pull-Before-Push" to prevent conflicts.
+  - **Pre-Commit Validation**:
+    - **Secret Detection**: Blocks commits containing AWS, GitHub, or Stripe keys.
+    - **File Size Check**: Prevents committing files larger than 50MB.
+    - **Quality Gates**: Optional linting and test execution before commit.
+  - **Pause/Resume**: `autopilot pause` and `autopilot resume` for manual control of the automation loop.
+- **Visibility & UX (Phase 2)**:
+  - **Real-Time Dashboard**: `autopilot dashboard` providing a live view of file changes, last commit status, and system health.
+  - **Enhanced Insights**: `autopilot insights` with deep analytics:
+    - Commit Quality Score (0-100) based on conventional commit standards.
+    - Productivity metrics (peak hours, streaks).
+    - CSV export capability (`--export csv`).
+- **Intelligence (Phase 3)**:
+  - **AI Commit Messages**: Integration with Google Gemini for context-aware, senior-level commit message generation.
+  - **Workflow Presets**: `autopilot preset` command to quickly switch between workflows:
+    - `safe-team`: Optimized for collaboration (Team Mode + Secret Checks).
+    - `solo-speed`: Optimized for rapid individual development.
+    - `strict-ci`: Enforces testing and linting before every commit.
+### Docs/Website
+- Added Leaderboard page with live simulated rankings.
+- Updated homepage Feature Showcase to demonstrate Insights and Safety & Team features.
+- Added Leaderboard to top navigation.
+- Updated Introduction docs to highlight v2.0 features (AI, Focus Engine, Team Mode, Safety Net).
+
 ## [0.1.8] - 2026-02-04
 
 ### Reliability & Core

package/README.md

@@ -82,14 +82,27 @@ autopilot start
 ---
 
 ## ✨ Features
-
-- **🧠 Smart Commits**: Generates professional conventional commit messages automatically.
+ 
+- **🧠 AI Commit Messages**: Gemini 2.5-powered, context-aware conventional commit messages.
 - **⚡ Watcher Engine**: Real-time file monitoring with smart debouncing using `chokidar`.
 - **🛡️ Safety First**: Blocks commits on protected branches and checks remote status.
 - **🔄 Automated Flow**: Fetches, stages, commits, and pushes (optional) automatically.
+- **👥 Team Mode**: Pull-before-push and conflict abortion with preset workflows.
+- **🖥️ Dashboard**: Real-time terminal dashboard with status and activity feed.
+- **⏮️ Undo System**: Safely rollback the last autopilot commit with one command.
+- **📊 Focus Engine & Insights**: Track active coding time, streaks, peak hours, and commit quality.
 - **⚙️ Zero Config**: Works out of the box, but fully configurable via `.autopilotrc.json`.
 - **🩺 Self-Healing**: Includes a `doctor` command to diagnose and fix issues.
 
+---
+ 
+## 🆕 What's New in v2.0
+ 
+- AI commit generation via Google Gemini (opt-in, with graceful fallback).
+- Team presets (`safe-team`, `solo-speed`, `strict-ci`) for different workflows.
+- Safety net with `autopilot undo`, secret detection, and large-file prevention.
+- Productivity Focus Engine with `autopilot insights` and CSV export.
+
 ---
 
 ## ⬇️ Installation
@@ -100,134 +113,103 @@ Install Autopilot globally using npm:
 npm install -g @traisetech/autopilot
 ```
 
----
-
-## 🚀 Quick Start
-
-### 1. Initialize
-Navigate to your Git repository and initialize Autopilot:
+Or run it directly via npx:
 
 ```bash
-cd my-project
-autopilot init
+npx @traisetech/autopilot start
 ```
 
-### 2. Start Watching
-Start the background daemon to begin monitoring your files:
+---
 
-```bash
-autopilot start
-```
+## 🚀 Quick Start
 
-### 3. Check Status
-Verify that Autopilot is running:
+1. **Navigate to your Git repository:**
+   ```bash
+   cd /path/to/my-project
+   ```
 
-```bash
-autopilot status
-```
+2. **Initialize Autopilot:**
+   ```bash
+   autopilot init
+   ```
+   Follow the interactive prompts to configure settings (or accept defaults).
 
-### 4. Stop
-When you're done for the day:
+3. **Start the watcher:**
+   ```bash
+   autopilot start
+   ```
 
-```bash
-autopilot stop
-```
+   **Autopilot is now running!** It will monitor file changes and automatically commit/push them based on your configuration.
+
+4. **View the Dashboard (New):**
+   Open a new terminal and run:
+   ```bash
+   autopilot dashboard
+   ```
 
 ---
 
-## 💻 Commands
+## 🛠️ Commands
 
 | Command | Description |
 |---------|-------------|
-| `autopilot init` | Initializes configuration and ignore files in the current directory. |
-| `autopilot start` | Starts the background watcher daemon. |
-| `autopilot stop` | Stops the running watcher daemon. |
-| `autopilot status` | Shows the current status of the watcher process. |
-| `autopilot doctor` | Runs diagnostics to verify environment and configuration. |
-| `autopilot --help` | Displays help information. |
+| `autopilot init` | Initialize configuration in the current repo. |
+| `autopilot start` | Start the watcher process (foreground). |
+| `autopilot stop` | Stop the running watcher process. |
+| `autopilot status` | Check if Autopilot is running. |
+| `autopilot dashboard` | View real-time status and activity UI. |
+| `autopilot undo` | Revert the last Autopilot commit. |
+| `autopilot pause [reason]` | Temporarily pause automation. |
+| `autopilot resume` | Resume automation. |
+| `autopilot insights` | View productivity stats and analytics. |
+| `autopilot doctor` | Diagnose configuration and environment issues. |
 
 ---
 
 ## ⚙️ Configuration
 
-Autopilot uses a `.autopilotrc.json` file for configuration. It is created automatically when you run `autopilot init`.
+Autopilot uses an `.autopilotrc.json` file in your project root.
 
 ```json
 {
-  "minInterval": 30,
+  "debounceSeconds": 20,
+  "minSecondsBetweenCommits": 180,
   "autoPush": true,
-  "blockedBranches": ["main", "production"],
-  "requireChecks": false,
-  "ignore": [
-    "*.log",
-    "temp/",
-    "dist/",
-    "node_modules"
-  ]
+  "blockBranches": ["main", "master"],
+  "teamMode": true,
+  "preventSecrets": true,
+  "maxFileSizeMB": 50
 }
 ```
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `minInterval` | number | 30 | Minimum seconds between commits. |
-| `autoPush` | boolean | true | Whether to push changes automatically after commit. |
-| `blockedBranches` | array | `[]` | List of branches to disable auto-commit on. |
-| `requireChecks` | boolean | false | Run custom checks before committing. |
-| `ignore` | array | `[]` | Additional glob patterns to ignore. |
+See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for full details.
 
 ---
 
 ## 🛡️ Safety Features
 
-Autopilot includes several safety mechanisms to prevent accidents:
+Autopilot includes multiple layers of protection:
 
-- **Branch Protection**: Will not run on branches listed in `blockedBranches`.
-- **Remote Sync**: Checks if local branch is behind remote before acting.
-- **Debouncing**: Waits for file changes to settle before committing.
-- **PID Management**: Ensures only one instance runs per repository.
+1. **Branch Protection**: Prevents running on blocked branches (default: `main`, `master`).
+2. **Secret Detection**: Scans for AWS keys, GitHub tokens, and other secrets before committing.
+3. **File Size Limits**: Prevents committing accidental large files (>50MB).
+4. **Team Mode**: Ensures local changes are rebased on top of remote changes to prevent conflicts.
+5. **Undo**: Allows quick recovery from unwanted auto-commits.
 
 ---
 
-## 🔧 Troubleshooting
-
-If you encounter issues, run the `doctor` command:
-
-```bash
-autopilot doctor
-```
-
-This will check for:
-- Git repository status
-- Configuration validity
-- Node.js version
-- Permissions
-- **Common Issue**: If commits aren't triggering, check if you are editing ignored files (e.g. `.vscode`, `node_modules`).
-- **Autopilot detects changes but never commits**: This can happen if files are constantly changing (resetting the debounce timer) or if you are on a blocked branch. Check `autopilot.log` for details.
-
-For more details, visit our [Documentation Site](https://autopilot-cli.vercel.app/docs/troubleshooting).
-
----
-
-## 🧪 Verification (Smoke Test)
-
-To verify that Autopilot is working correctly on your machine or in a CI environment, you can run the built-in verification suite. This runs the linter, the doctor diagnostic tool, and the full test suite.
+## 🤝 Contributing
 
-```bash
-# Run the full verification suite
-npm run verify
-```
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
 
-If everything is green, you are good to go!
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
 
 ---
 
-## 🤝 Contributing
-
-Contributions, issues, and feature requests are welcome!
-Feel free to check the [issues page](https://github.com/PraiseTechzw/autopilot-cli/issues).
-
-Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.
-
-## 📝 License
+## 📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/bin/autopilot.js

@@ -5,7 +5,13 @@ const initRepo = require('../src/commands/init');
 const startWatcher = require('../src/commands/start');
 const stopWatcher = require('../src/commands/stop');
 const statusWatcher = require('../src/commands/status');
+const undoCommand = require('../src/commands/undo');
+const pauseCommand = require('../src/commands/pause');
+const resumeCommand = require('../src/commands/resume');
+const { insights } = require('../src/commands/insights');
+const { leaderboard } = require('../src/commands/leaderboard');
 const doctor = require('../src/commands/doctor');
+const presetCommand = require('../src/commands/preset');
 const pkg = require('../package.json');
 const logger = require('../src/utils/logger');
 const { checkForUpdate } = require('../src/utils/update-check');
@@ -16,7 +22,13 @@ const commands = {
   start: startWatcher,
   stop: stopWatcher,
   status: statusWatcher,
-  doctor: doctor
+  undo: undoCommand,
+  pause: pauseCommand,
+  resume: resumeCommand,
+  insights: insights,
+  leaderboard: leaderboard,
+  doctor: doctor,
+  preset: presetCommand
 };
 
 // Runtime assertion to prevent wiring errors
@@ -56,6 +68,52 @@ program
   .description('Show autopilot watcher status')
   .action(statusWatcher);
 
+program
+  .command('undo')
+  .description('Undo the last Autopilot commit')
+  .option('-c, --count <n>', 'Number of commits to undo', '1')
+  .action(undoCommand);
+
+program
+  .command('pause [reason]')
+  .description('Pause Autopilot watcher')
+  .action(pauseCommand);
+
+program
+  .command('resume')
+  .description('Resume Autopilot watcher')
+  .action(resumeCommand);
+
+program
+  .command('dashboard')
+  .description('View real-time Autopilot dashboard')
+  .action(async () => {
+    try {
+      const { default: runDashboard } = await import('../src/commands/dashboard.mjs');
+      runDashboard();
+    } catch (error) {
+      console.error('Failed to launch dashboard:', error);
+    }
+  });
+
+program
+  .command('insights')
+  .description('View productivity insights and focus analytics')
+  .option('-f, --format <type>', 'Output format (json, text)', 'text')
+  .option('-e, --export <type>', 'Export insights (csv)')
+  .action(insights);
+
+program
+  .command('leaderboard')
+  .description('View or sync with the global leaderboard')
+  .option('--sync', 'Sync your local stats to the leaderboard')
+  .action(leaderboard);
+
+program
+  .command('preset [action] [name]')
+  .description('Manage workflow presets (list, apply)')
+  .action(presetCommand);
+
 program
   .command('doctor')
   .description('Diagnose and validate autopilot setup')

package/docs/CONFIGURATION.md

@@ -1,82 +1,100 @@
-# Configuration Reference - Autopilot CLI
-
-**Built by Praise Masunga (PraiseTechzw)**
-
-This document reflects the current `.autopilotrc.json` options.
-
----
-
-## File Locations
-
-- Config: `.autopilotrc.json` (repo root)
-- Ignore: `.autopilotignore` (repo root)
-
----
-
-## Full Example
-
-```json
-{
-  "debounceSeconds": 20,
-  "minSecondsBetweenCommits": 180,
-  "autoPush": true,
-  "blockBranches": ["main", "master"],
-  "requireChecks": false,
-  "checks": ["npm test"],
-  "commitMessageMode": "smart"
-}
-```
-
----
-
-## Settings
-
-### `debounceSeconds`
-- **Type:** number
-- **Default:** 20
-- **Description:** Wait time after the last file change before checking git status.
-
-### `minSecondsBetweenCommits`
-- **Type:** number
-- **Default:** 180
-- **Description:** Minimum time between commits (anti-spam).
-
-### `autoPush`
-- **Type:** boolean
-- **Default:** true
-- **Description:** Push to `origin/<branch>` after commit.
-
-### `blockBranches`
-- **Type:** string[]
-- **Default:** `["main", "master"]`
-- **Description:** Branches where auto-commit is disabled.
-
-### `requireChecks`
-- **Type:** boolean
-- **Default:** false
-- **Description:** Run checks before commit. If any fail, commit is skipped.
-
-### `checks`
-- **Type:** string[]
-- **Default:** `[]`
-- **Description:** Shell commands executed sequentially when `requireChecks` is true.
-
-### `commitMessageMode`
-- **Type:** `"smart" | "simple"`
-- **Default:** `"smart"`
-- **Description:** Smart uses file-based conventional commit messages; simple uses `chore: update changes`.
-
----
-
-## Ignore File (.autopilotignore)
-
-Gitignore-style patterns. Example:
-
-```
-node_modules/
-dist/
-.env
-*.log
-```
-
-Autopilot also always ignores `.git`, `.autopilot.pid`, and `autopilot.log`.
+# Configuration Reference - Autopilot CLI
+
+**Built by Praise Masunga (PraiseTechzw)**
+
+This document reflects the current `.autopilotrc.json` options.
+
+---
+
+## File Locations
+
+- Config: `.autopilotrc.json` (repo root)
+- Ignore: `.autopilotignore` (repo root)
+
+---
+
+## Full Example
+
+```json
+{
+  "debounceSeconds": 20,
+  "minSecondsBetweenCommits": 180,
+  "autoPush": true,
+  "blockBranches": ["main", "master"],
+  "requireChecks": false,
+  "checks": ["npm test"],
+  "commitMessageMode": "smart",
+  "teamMode": false,
+  "maxFileSizeMB": 50,
+  "preventSecrets": true
+}
+```
+
+---
+
+## Settings
+
+### `debounceSeconds`
+- **Type:** number
+- **Default:** 20
+- **Description:** Wait time after the last file change before checking git status.
+
+### `minSecondsBetweenCommits`
+- **Type:** number
+- **Default:** 180
+- **Description:** Minimum time between commits (anti-spam).
+
+### `autoPush`
+- **Type:** boolean
+- **Default:** true
+- **Description:** Push to `origin/<branch>` after commit.
+
+### `blockBranches`
+- **Type:** string[]
+- **Default:** `["main", "master"]`
+- **Description:** Branches where auto-commit is disabled.
+
+### `requireChecks`
+- **Type:** boolean
+- **Default:** false
+- **Description:** Run checks before commit. If any fail, commit is skipped.
+
+### `checks`
+- **Type:** string[]
+- **Default:** `[]`
+- **Description:** Shell commands executed sequentially when `requireChecks` is true.
+
+### `commitMessageMode`
+- **Type:** `"smart" | "simple"`
+- **Default:** `"smart"`
+- **Description:** Smart uses file-based conventional commit messages; simple uses `chore: update changes`.
+
+### `teamMode`
+- **Type:** boolean
+- **Default:** `false`
+- **Description:** Enables pull-before-push and stricter conflict handling. Recommended for collaborative environments.
+
+### `maxFileSizeMB`
+- **Type:** number
+- **Default:** `50`
+- **Description:** Prevents committing files larger than this size (in MB).
+
+### `preventSecrets`
+- **Type:** boolean
+- **Default:** `true`
+- **Description:** Scans staged files for common secret patterns (AWS keys, GitHub tokens) before committing.
+
+---
+
+## Ignore File (.autopilotignore)
+
+Gitignore-style patterns. Example:
+
+```
+node_modules/
+dist/
+.env
+*.log
+```
+
+Autopilot also always ignores `.git`, `.autopilot.pid`, and `autopilot.log`.

package/docs/TEAM-MODE.md

@@ -0,0 +1,51 @@
+# 👥 Team Mode
+
+Autopilot V2 introduces **Team Mode**, designed to make automated Git workflows safe and efficient for collaborative environments.
+
+## How it Works
+
+When `teamMode` is enabled in your configuration, Autopilot changes its behavior to prioritize synchronization and conflict prevention.
+
+### Key Behaviors
+
+1. **Pull-Before-Push**:
+   Before attempting to push any local commits, Autopilot automatically runs `git pull --rebase`. This ensures your local branch is up-to-date with the remote, minimizing merge conflicts.
+
+2. **Conflict Abortion**:
+   If a pull operation detects conflicts, Autopilot **immediately aborts** the automation loop. It will not attempt to commit or push until you manually resolve the conflicts.
+   - **Status**: The watcher enters a "Stopped" or error state.
+   - **Notification**: You will see an error message in the logs/dashboard.
+
+3. **Remote Status Checks**:
+   Autopilot frequently checks the remote repository status to detect if your local branch has diverged.
+
+## Enabling Team Mode
+
+To enable Team Mode, run:
+
+```bash
+autopilot init
+```
+And select "Yes" when asked "Enable team mode? (pull before push)".
+
+Or manually edit your `.autopilotrc.json`:
+
+```json
+{
+  "teamMode": true
+}
+```
+
+## Best Practices for Teams
+
+- **Short Commit Intervals**: Set `commitInterval` to a lower value (e.g., 5-10 minutes) to reduce the chance of large conflicts.
+- **Feature Branches**: Continue to use feature branches (`feat/my-feature`). Autopilot works best on feature branches, leaving `main` or `develop` protected.
+- **Dashboard Monitoring**: Use `autopilot dashboard` to keep an eye on the automation status and pending changes.
+
+## Troubleshooting
+
+If Autopilot stops due to a conflict:
+1. Run `git status` to see the conflict.
+2. Resolve the conflicts manually.
+3. Run `git add .` and `git rebase --continue`.
+4. Restart Autopilot with `autopilot start`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traisetech/autopilot",
-  "version": "0.1.8",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -36,7 +36,9 @@
     "lint": "node -c bin/autopilot.js && node -c src/index.js",
     "verify": "node bin/autopilot.js --help && node bin/autopilot.js doctor && node --test",
     "prepublishOnly": "npm run verify",
-    "release:patch": "npm run verify && npm version patch && git push --follow-tags && echo \"\n🚀 Ready to publish! Run: npm publish --access public\""
+    "release:patch": "npm run verify && npm version patch && git push --follow-tags && echo \"\n🚀 Release initiated! GitHub Action will publish to NPM.\"",
+    "release:minor": "npm run verify && npm version minor && git push --follow-tags && echo \"\n🚀 Release initiated! GitHub Action will publish to NPM.\"",
+    "release:major": "npm run verify && npm version major && git push --follow-tags && echo \"\n🚀 Release initiated! GitHub Action will publish to NPM.\""
   },
   "engines": {
     "node": ">=18.0.0"
@@ -51,9 +53,17 @@
   "homepage": "https://github.com/PraiseTechzw/autopilot-cli#readme",
   "dependencies": {
     "@traisetech/autopilot": "^0.1.7",
-    "chokidar": "^5.0.0",
+    "chokidar": "^3.6.0",
     "commander": "^14.0.3",
+    "csv-writer": "^1.6.0",
     "execa": "^5.1.1",
-    "fs-extra": "^11.3.3"
+    "fs-extra": "^11.3.3",
+    "ink": "^6.6.0",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^4.0.0",
+    "ink-spinner": "^5.0.0",
+    "open": "^11.0.0",
+    "prop-types": "^15.8.1",
+    "react": "^19.2.4"
   }
 }