@traisetech/autopilot 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -15,3 +15,48 @@
 - Per-repo config and ignore rules
 
 Built by Praise Masunga (PraiseTechzw).
+# Changelog
+
+All notable changes to this project will be documented in this file.
+This project follows Semantic Versioning (https://semver.org).
+
+---
+
+## [0.1.4] – 2026-02-01
+
+### Fixed
+- Fixed a critical CLI crash where `autopilot start` failed due to miswired Commander action handlers.
+- Improved command registration to ensure all CLI commands are correctly bound and validated at runtime.
+- Prevented undefined command handlers from causing runtime exceptions.
+
+### Added
+- Pre-publish verification pipeline to block publishing broken builds.
+- CLI smoke tests to ensure core commands (`init`, `start`, `status`, `doctor`) do not crash.
+- Test-only dry-run mode for watcher to allow safe automated testing.
+- Additional configuration and commit logic unit tests.
+
+### Changed
+- Standardized command exports across all CLI commands.
+- Improved error messages for misconfigured or invalid commands.
+- Strengthened release hygiene and stability guarantees.
+
+### Developer Experience
+- Added `prepublishOnly` guard to prevent accidental publishing of failing builds.
+- Improved Windows compatibility during testing and CLI execution.
+
+---
+
+## [0.1.3] – 2026-01-31
+
+### Added
+- Initial public release of Autopilot CLI.
+- Intelligent Git automation with smart commit messages.
+- Background watcher with debouncing and safety rails.
+- Branch protection and remote-ahead detection.
+- `doctor` command for environment diagnostics.
+- Per-project configuration via `.autopilotrc.json`.
+
+---
+
+## [0.1.0] – Initial Development
+- Core architecture and foundational CLI commands.

package/README.md

@@ -1,22 +1,22 @@
-# 🚀 Autopilot CLI
+# 🚀 Autopilot
 
 <div align="center">
 
-![Autopilot Logo](https://img.shields.io/badge/Autopilot-CLI-blue?style=for-the-badge&logo=git&logoColor=white)
+![Autopilot Logo](https://img.shields.io/badge/Autopilot-blue?style=for-the-badge&logo=git&logoColor=white)
 
 **Intelligent Git automation that commits and pushes your code, so you can focus on building.**
 
-[![npm version](https://img.shields.io/npm/v/autopilot-cli?style=flat-square&color=success)](https://www.npmjs.com/package/autopilot-cli)
+[![npm version](https://img.shields.io/npm/v/@traisetech/autopilot?style=flat-square&color=success)](https://www.npmjs.com/package/@traisetech/autopilot)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square)](https://nodejs.org)
-[![Downloads](https://img.shields.io/npm/dm/autopilot-cli?style=flat-square&color=blue)](https://www.npmjs.com/package/autopilot-cli)
-[![GitHub Stars](https://img.shields.io/github/stars/PraiseTechzw/autopilot-cli?style=flat-square&color=gold)](https://github.com/PraiseTechzw/autopilot-cli/stargazers)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/PraiseTechzw/autopilot-cli/ci.yml?style=flat-square)](https://github.com/PraiseTechzw/autopilot-cli/actions)
+[![Downloads](https://img.shields.io/npm/dm/@traisetech/autopilot?style=flat-square&color=blue)](https://www.npmjs.com/package/@traisetech/autopilot)
+[![GitHub Stars](https://img.shields.io/github/stars/PraiseTechzw/autopilot?style=flat-square&color=gold)](https://github.com/PraiseTechzw/autopilot/stargazers)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/PraiseTechzw/autopilot/ci.yml?style=flat-square)](https://github.com/PraiseTechzw/autopilot/actions)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
 
 **Built by [Praise Masunga](https://github.com/PraiseTechzw) (PraiseTechzw)**
 
-[Features](#-features) • [Quick Start](#-quick-start) • [Configuration](#-configuration) • [Commands](#-commands) • [Safety](#-safety-features)
+[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Configuration](#-configuration) • [Commands](#-commands)
 
 </div>
 
@@ -26,8 +26,8 @@
 
 - [Why Autopilot?](#-why-autopilot)
 - [Features](#-features)
-- [Quick Start](#-quick-start)
 - [Installation](#-installation)
+- [Quick Start](#-quick-start)
 - [Commands](#-commands)
 - [Configuration](#-configuration)
 - [Safety Features](#-safety-features)
@@ -39,6 +39,8 @@
 
 ## 🎯 Why Autopilot?
 
+Autopilot is designed for developers who want to stay in the flow. It solves manual Git workflow fatigue by handling the repetitive cycle of staging, committing, and pushing changes, allowing you to focus entirely on writing code.
+
 <table>
 <tr>
 <td width="50%">
@@ -90,29 +92,44 @@ autopilot start
 
 ---
 
-## 🚀 Quick Start
+## ⬇️ Installation
 
-### Installation
+Install Autopilot globally using npm:
 
 ```bash
-# Install globally via npm
-npm install -g autopilot-cli
+npm install -g @traisetech/autopilot
 ```
 
-### Usage
+---
+
+## 🚀 Quick Start
+
+### 1. Initialize
+Navigate to your Git repository and initialize Autopilot:
 
 ```bash
-# 1. Initialize in your project
 cd my-project
 autopilot init
+```
 
-# 2. Start the background watcher
+### 2. Start Watching
+Start the background daemon to begin monitoring your files:
+
+```bash
 autopilot start
+```
+
+### 3. Check Status
+Verify that Autopilot is running:
 
-# 3. Check status
+```bash
 autopilot status
+```
 
-# 4. Stop when done
+### 4. Stop
+When you're done for the day:
+
+```bash
 autopilot stop
 ```
 
@@ -133,7 +150,7 @@ autopilot stop
 
 ## ⚙️ Configuration
 
-Autopilot uses a `.autopilotrc.json` file for configuration.
+Autopilot uses a `.autopilotrc.json` file for configuration. It is created automatically when you run `autopilot init`.
 
 ```json
 {
@@ -206,5 +223,5 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ---
 
 <div align="center">
-  <b>Built with ❤️ by <a href="https://github.com/PraiseTechzw">Praise Masunga (PraiseTechzw)</a></b>
+  <b>Built by <a href="https://github.com/PraiseTechzw">Praise Masunga (PraiseTechzw)</a></b>
 </div>

package/bin/autopilot.js

@@ -1,12 +1,32 @@
 #!/usr/bin/env node
 
 const { Command } = require('commander');
-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 { doctor } = require('../src/commands/doctor');
+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 doctor = require('../src/commands/doctor');
 const pkg = require('../package.json');
+const logger = require('../src/utils/logger');
+
+// Validate command handlers
+const commands = {
+  init: initRepo,
+  start: startWatcher,
+  stop: stopWatcher,
+  status: statusWatcher,
+  doctor: doctor
+};
+
+// Runtime assertion to prevent wiring errors
+Object.entries(commands).forEach(([name, handler]) => {
+  if (typeof handler !== 'function') {
+    console.error(`\n❌ FATAL ERROR: Command handler for '${name}' is not a function.`);
+    console.error(`Received: ${typeof handler}`);
+    console.error('Please report this issue to the maintainer.\n');
+    process.exit(1);
+  }
+});
 
 const program = new Command();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traisetech/autopilot",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "publishConfig": {
     "access": "public"
   },
@@ -32,12 +32,11 @@
   "main": "src/index.js",
   "scripts": {
     "dev": "node bin/autopilot.js",
-    "lint": "echo \"No lint configured\"",
     "test": "node --test",
-    "verify": "node bin/autopilot.js doctor",
-    "release:patch": "npm test && echo \"⚠️  Ensure CHANGELOG.md is updated\" && npm version patch && git push --follow-tags",
-    "release:minor": "npm test && echo \"⚠️  Ensure CHANGELOG.md is updated\" && npm version minor && git push --follow-tags",
-    "release:major": "npm test && echo \"⚠️  Ensure CHANGELOG.md is updated\" && npm version major && git push --follow-tags"
+    "lint": "node -c bin/autopilot.js && node -c src/index.js",
+    "verify": "npm run test && npm run lint && node bin/autopilot.js --help",
+    "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\""
   },
   "engines": {
     "node": ">=18.0.0"

package/src/commands/init.js

@@ -89,4 +89,4 @@ async function initRepo() {
   }
 }
 
-module.exports = { initRepo };
+module.exports = initRepo;

package/src/config/loader.js

@@ -1,47 +1,47 @@
-const fs = require('fs-extra');
-const path = require('path');
-const logger = require('../utils/logger');
-const defaults = require('./defaults');
-const { getConfigPath } = require('../utils/paths');
-
-const loadConfig = async (repoPath) => {
-  const configPath = getConfigPath(repoPath);
-  try {
-    if (await fs.pathExists(configPath)) {
-      const config = await fs.readJson(configPath);
-      logger.debug(`Loaded config from ${configPath}`);
-      return { ...defaults, ...config };
-    }
-  } catch (error) {
-    logger.warn(`Error loading config: ${error.message}`);
-  }
-  return defaults;
-};
-
-const saveConfig = async (repoPath, config) => {
-  const configPath = getConfigPath(repoPath);
-  try {
-    await fs.writeJson(configPath, config, { spaces: 2 });
-    logger.success(`Config saved to ${configPath}`);
-  } catch (error) {
-    logger.error(`Failed to save config: ${error.message}`);
-  }
-};
-
-const createDefaultConfig = async (repoPath) => {
-  const configPath = getConfigPath(repoPath);
-  try {
-    if (!(await fs.pathExists(configPath))) {
-      await fs.writeJson(configPath, defaults, { spaces: 2 });
-      logger.success(`Created default config at ${configPath}`);
-    }
-  } catch (error) {
-    logger.error(`Failed to create config: ${error.message}`);
-  }
-};
-
-module.exports = {
-  loadConfig,
-  saveConfig,
-  createDefaultConfig,
-};
+const fs = require('fs-extra');
+const path = require('path');
+const logger = require('../utils/logger');
+const { DEFAULT_CONFIG } = require('./defaults');
+const { getConfigPath } = require('../utils/paths');
+
+const loadConfig = async (repoPath) => {
+  const configPath = getConfigPath(repoPath);
+  try {
+    if (await fs.pathExists(configPath)) {
+      const config = await fs.readJson(configPath);
+      logger.debug(`Loaded config from ${configPath}`);
+      return { ...DEFAULT_CONFIG, ...config };
+    }
+  } catch (error) {
+    logger.warn(`Error loading config: ${error.message}`);
+  }
+  return { ...DEFAULT_CONFIG };
+};
+
+const saveConfig = async (repoPath, config) => {
+  const configPath = getConfigPath(repoPath);
+  try {
+    await fs.writeJson(configPath, config, { spaces: 2 });
+    logger.success(`Config saved to ${configPath}`);
+  } catch (error) {
+    logger.error(`Failed to save config: ${error.message}`);
+  }
+};
+
+const createDefaultConfig = async (repoPath) => {
+  const configPath = getConfigPath(repoPath);
+  try {
+    if (!(await fs.pathExists(configPath))) {
+      await fs.writeJson(configPath, DEFAULT_CONFIG, { spaces: 2 });
+      logger.success(`Created default config at ${configPath}`);
+    }
+  } catch (error) {
+    logger.error(`Failed to create config: ${error.message}`);
+  }
+};
+
+module.exports = {
+  loadConfig,
+  saveConfig,
+  createDefaultConfig,
+};

package/src/core/watcher.js

@@ -91,6 +91,16 @@ class Watcher {
       logger.success(`Autopilot is watching ${this.repoPath}`);
       logger.info(`Logs: ${this.logFilePath}`);
       
+      // Test Mode Support
+      if (process.env.AUTOPILOT_TEST_MODE) {
+        logger.warn('TEST MODE: Running in dry-run mode for 3 seconds...');
+        setTimeout(async () => {
+          logger.info('TEST MODE: Auto-stopping watcher...');
+          await this.stop();
+          process.exit(0);
+        }, 3000);
+      }
+      
     } catch (error) {
       logger.error(`Failed to start watcher: ${error.message}`);
       this.logVerbose(`Start error: ${error.stack}`);

package/src/utils/logger.js

@@ -12,6 +12,16 @@ const logger = {
     console.log(`ℹ️  ${message}`);
   },
 
+  /**
+   * Log debug message (only visible if DEBUG env var is set)
+   * @param {string} message - Message to log
+   */
+  debug: (message) => {
+    if (process.env.DEBUG) {
+      console.log(`🔍 ${message}`);
+    }
+  },
+
   /**
    * Log success message
    * @param {string} message - Message to log