@traisetech/autopilot 0.1.4 → 0.1.7

package/CHANGELOG.md

@@ -1,62 +1,67 @@
-## v0.1.1 – Package Hygiene
+# Changelog
 
-### Fixed
-- Resolved npm publish warnings by adding `files` whitelist
-- Renamed package to scoped `@praisetechzw/autopilot`
-- Excluded unnecessary development files from distribution
+All notable changes to this project will be documented in this file.
+This project follows [Semantic Versioning](https://semver.org).
 
-## v0.1.0 – Initial Release
+## [0.1.7] - 2026-02-01
 
 ### Added
-- Intelligent auto commit & push
-- Branch protection (main/master blocked)
-- Remote-ahead safety checks
-- Smart conventional commit messages
-- Per-repo config and ignore rules
+- **CLI Update Notifier**:
+  - Automatically checks for new versions on npm registry (once every 24 hours).
+  - Zero-dependency implementation using native Node.js `https`.
+  - Non-intrusive visual notification box on startup when updates are available.
+- **Documentation**:
+  - Added live NPM download statistics to landing page and documentation sidebar.
+  - Enhanced install command widget with one-click copy.
 
-Built by Praise Masunga (PraiseTechzw).
-# Changelog
+## [0.1.6] - 2026-02-01
 
-All notable changes to this project will be documented in this file.
-This project follows Semantic Versioning (https://semver.org).
+### Added
+- **Smart Commit Generator 2.0**:
+  - Offline diff parsing using `git diff` (no external APIs).
+  - Conventional Commits compliance (`feat`, `fix`, `docs`, `style`, `test`).
+  - Intelligent scope detection for UI, Theme, Search, and Docs.
+  - Golden Test Suite with 10 fixtures for guaranteed message quality.
+- **Developer Experience**:
+  - Added `npm run verify` script for pre-release checks.
+  - Improved Windows path normalization for reliable cross-platform usage.
 
----
+### Changed
+- **Performance**: Switched from file-based status checks to staged diff analysis for commit messages.
+- **Logic**: Reordered commit type priority (Style > Src > Test > Docs) to prevent misclassification of mixed changes.
+- **Fix**: Resolved issue where new files were incorrectly flagged as `fix` instead of `feat`.
 
-## [0.1.4] – 2026-02-01
+## [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.
+- **Windows Compatibility**: Fixed critical issue where absolute paths on Windows caused ignore rules to fail.
+- **Watcher Noise**: Fixed infinite commit loops caused by `.vscode/time-analytics.json` and self-logging.
+- **CLI Crash**: Resolved `autopilot start` failure due to miswired Commander action handlers.
 
 ### 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.
+- **Release Gates**: Added `npm run verify` and `prepublishOnly` hooks to prevent broken releases.
+- **Integration Tests**: Added full end-to-end test suite using `node:test`.
+- **Smart Init**: `autopilot init` now automatically adds `autopilot.log` to `.gitignore`.
+- **Diagnostics**: Added `autopilot doctor` for environment health checks.
 
-### 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**: First stable release on npm as `@traisetech/autopilot`.
+- **Core Features**:
+  - Intelligent auto commit & push.
+  - Background watcher with debouncing.
+  - Branch protection (blocks commits to `main`/`master` by default).
+  - Remote-ahead safety checks.
+  - Per-project configuration via `.autopilotrc.json`.
 
-## [0.1.3] – 2026-01-31
+## [0.1.1]
 
-### 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`.
+### Changed
+- **Package Hygiene**: Renamed package scope.
+- **Distribution**: Added `files` whitelist to `package.json` to reduce install size.
 
----
+## [0.1.0]
 
-## [0.1.0] – Initial Development
-- Core architecture and foundational CLI commands.
+### Added
+- **Prototype**: Initial development release with core architecture.

package/bin/autopilot.js

@@ -8,6 +8,7 @@ const statusWatcher = require('../src/commands/status');
 const doctor = require('../src/commands/doctor');
 const pkg = require('../package.json');
 const logger = require('../src/utils/logger');
+const { checkForUpdate } = require('../src/utils/update-check');
 
 // Validate command handlers
 const commands = {
@@ -65,4 +66,7 @@ program
   .addHelpCommand(true, 'Show help for command')
   .showHelpAfterError('(add --help for command information)');
 
-program.parse(process.argv);
+(async () => {
+  await checkForUpdate();
+  program.parse(process.argv);
+})();

package/docs/TROUBLESHOOTING.md

@@ -1,40 +1,21 @@
-# Troubleshooting
-
-**Built by Praise Masunga (PraiseTechzw)**
-
----
-
-## Autopilot won’t start
-
-- Ensure you are inside a git repository
-- Run `autopilot doctor`
-- Remove stale PID if needed: delete `.autopilot.pid`
-
----
-
-## It won’t commit
-
-Common reasons:
-- You are on a blocked branch (`blockBranches`)
-- Remote is ahead (pull first)
-- `requireChecks` is enabled and a check failed
-- No changes detected by git
-
----
-
-## It won’t push
-
-- Verify `autoPush` is true
-- Check your `origin` remote and authentication
-- Ensure you have access to the remote
-
----
-
-## Logs
-
-- `autopilot.log` is created in the repo root
-- `autopilot status` shows the last log line
-
----
-
-**Built by Praise Masunga (PraiseTechzw)**
+# TROUBLESHOOTING
+
+## Common Issues
+
+### Watcher Loop / High CPU Usage (Windows)
+If Autopilot seems to be constantly triggering or consuming high CPU on Windows, it is likely due to "noisy" files that change frequently but should be ignored.
+
+**Common Culprits:**
+- `.vscode/time-analytics.json`: Some VS Code extensions write to this file constantly.
+- `autopilot.log`: If the watcher logs to a file that it is also watching, it creates a feedback loop.
+
+**Solution:**
+Autopilot v0.1.4+ includes enhanced Windows path handling to automatically ignore these files. If you still see issues:
+1. Ensure `.vscode/` and `*.log` are in your `.autopilotignore` file.
+2. Run `autopilot doctor` to verify your configuration.
+
+### "git.status is not a function"
+This was a known issue in older versions. Please upgrade to the latest version.
+
+### Permissions Errors
+Ensure you have write access to the repository and that no other process has locked the files (common on Windows with anti-virus software).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traisetech/autopilot",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -34,7 +34,7 @@
     "dev": "node bin/autopilot.js",
     "test": "node --test",
     "lint": "node -c bin/autopilot.js && node -c src/index.js",
-    "verify": "npm run test && npm run lint && node bin/autopilot.js --help",
+    "verify": "node --test && 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\""
   },

package/src/commands/init.js

@@ -4,6 +4,7 @@
  */
 
 const fs = require('fs-extra');
+const path = require('path');
 const logger = require('../utils/logger');
 const { getConfigPath, getIgnorePath, getGitPath } = require('../utils/paths');
 const { DEFAULT_CONFIG, DEFAULT_IGNORE_PATTERNS } = require('../config/defaults');
@@ -54,6 +55,41 @@ async function createConfigFile(repoPath) {
   return true;
 }
 
+/**
+ * Update .gitignore with Autopilot specific files
+ * @param {string} repoPath 
+ */
+async function updateGitIgnore(repoPath) {
+  const gitIgnorePath = path.join(repoPath, '.gitignore');
+  const toIgnore = ['autopilot.log', '.autopilot.pid', '.vscode/'];
+  let content = '';
+  
+  try {
+    if (await fs.pathExists(gitIgnorePath)) {
+      content = await fs.readFile(gitIgnorePath, 'utf-8');
+    }
+    
+    const lines = content.split('\n').map(l => l.trim());
+    const newLines = [];
+    let added = false;
+
+    for (const item of toIgnore) {
+      if (!lines.includes(item)) {
+        newLines.push(item);
+        added = true;
+      }
+    }
+
+    if (added) {
+      const newContent = content + (content && !content.endsWith('\n') ? '\n' : '') + newLines.join('\n') + '\n';
+      await fs.writeFile(gitIgnorePath, newContent);
+      logger.success('Updated .gitignore');
+    }
+  } catch (error) {
+    logger.warn(`Could not update .gitignore: ${error.message}`);
+  }
+}
+
 /**
  * Initialize Autopilot in current repository
  */
@@ -76,6 +112,7 @@ async function initRepo() {
     // Create files
     await createIgnoreFile(repoPath);
     await createConfigFile(repoPath);
+    await updateGitIgnore(repoPath);
 
     logger.section('✨ Initialization Complete');
     logger.info('Next steps:');

package/src/config/defaults.js

@@ -22,6 +22,8 @@ const DEFAULT_IGNORE_PATTERNS = [
   '.env.*',
   'coverage/',
   '*.log',
+  'autopilot.log',
+  '.autopilot.pid',
   '.DS_Store',
   '.git/',
   '.idea/',

package/src/config/ignore.js

@@ -1,37 +1,136 @@
-const fs = require('fs-extra');
-const path = require('path');
-const logger = require('../utils/logger');
-
-const readIgnoreFile = async (repoPath) => {
-  const ignorePath = path.join(repoPath, '.autopilot-ignore');
-  try {
-    if (await fs.pathExists(ignorePath)) {
-      const content = await fs.readFile(ignorePath, 'utf-8');
-      return content
-        .split('\n')
-        .map((line) => line.trim())
-        .filter((line) => line && !line.startsWith('#'));
-    }
-  } catch (error) {
-    logger.debug(`Error reading ignore file: ${error.message}`);
-  }
-  return [];
-};
-
-const createIgnoreFile = async (repoPath, patterns = []) => {
-  const ignorePath = path.join(repoPath, '.autopilot-ignore');
-  try {
-    const content =
-      `# Autopilot Ignore File\n# Add patterns to exclude from autopilot watching\n\n` +
-      patterns.join('\n');
-    await fs.writeFile(ignorePath, content);
-    logger.success('Created .autopilot-ignore file');
-  } catch (error) {
-    logger.error(`Failed to create ignore file: ${error.message}`);
-  }
-};
-
-module.exports = {
-  readIgnoreFile,
-  createIgnoreFile,
-};
+const fs = require('fs-extra');
+const path = require('path');
+const logger = require('../utils/logger');
+const { getIgnorePath } = require('../utils/paths');
+
+/**
+ * Standardize path to use forward slashes
+ * @param {string} p - Path to normalize
+ * @returns {string} Normalized path
+ */
+const normalizePath = (p) => p.replace(/\\/g, '/');
+
+/**
+ * Read ignore file patterns
+ * @param {string} repoPath 
+ * @returns {Promise<string[]>} Array of ignore patterns
+ */
+const readIgnoreFile = async (repoPath) => {
+  const ignorePath = getIgnorePath(repoPath);
+  try {
+    if (await fs.pathExists(ignorePath)) {
+      const content = await fs.readFile(ignorePath, 'utf-8');
+      return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'));
+    }
+  } catch (error) {
+    logger.debug(`Error reading ignore file: ${error.message}`);
+  }
+  return [];
+};
+
+/**
+ * Create ignore file
+ */
+const createIgnoreFile = async (repoPath, patterns = []) => {
+  const ignorePath = getIgnorePath(repoPath);
+  try {
+    const content =
+      `# Autopilot Ignore File\n# Add patterns to exclude from autopilot watching\n\n` +
+      patterns.join('\n');
+    await fs.writeFile(ignorePath, content);
+    logger.success('Created .autopilotignore file');
+  } catch (error) {
+    logger.error(`Failed to create ignore file: ${error.message}`);
+  }
+};
+
+/**
+ * Create a filter function for Chokidar
+ * @param {string} repoPath - Root of the repository
+ * @param {string[]} userPatterns - Custom ignore patterns
+ * @returns {function} Filter function (path => boolean)
+ */
+const createIgnoredFilter = (repoPath, userPatterns = []) => {
+  const normalizedRepoPath = normalizePath(repoPath);
+
+  // Always ignore these critical paths to prevent loops and noise
+  const criticalIgnores = [
+    '.git',
+    'node_modules',
+    '.vscode',
+    '.idea',
+    'dist',
+    'build',
+    'coverage',
+    '.next'
+  ];
+
+  const criticalFiles = [
+    'autopilot.log',
+    '.autopilot.pid',
+    '.DS_Store'
+  ];
+
+  return (absolutePath) => {
+    // 1. Normalize paths
+    const normalizedAbs = normalizePath(absolutePath);
+    
+    // 2. Get relative path
+    let relativePath = normalizedAbs;
+    if (normalizedAbs.startsWith(normalizedRepoPath)) {
+      relativePath = normalizedAbs.slice(normalizedRepoPath.length);
+      if (relativePath.startsWith('/')) {
+        relativePath = relativePath.slice(1);
+      }
+    }
+
+    // Handle root path case
+    if (!relativePath) return false;
+
+    // 3. Check critical directory prefixes
+    // We check if any path segment matches a critical ignore
+    const parts = relativePath.split('/');
+    for (const part of parts) {
+      if (criticalIgnores.includes(part)) return true;
+    }
+
+    // 4. Check file extensions and exact matches
+    if (relativePath.endsWith('.log')) return true;
+    if (criticalFiles.some(f => relativePath.endsWith(f))) return true;
+
+    // 5. Check user patterns (simple prefix/suffix matching for now)
+    // For robust glob support without adding dependencies, we rely on basic checks
+    // Most users use simple dir/ or *.ext patterns
+    for (const pattern of userPatterns) {
+      // Remove leading/trailing slashes for comparison
+      const cleanPattern = pattern.replace(/^\/+|\/+$/g, '');
+      
+      // Directory match (e.g., "temp/")
+      if (pattern.endsWith('/') && (relativePath === cleanPattern || relativePath.startsWith(cleanPattern + '/'))) {
+        return true;
+      }
+      
+      // Extension match (e.g., "*.tmp")
+      if (pattern.startsWith('*.') && relativePath.endsWith(pattern.slice(1))) {
+        return true;
+      }
+
+      // Exact match
+      if (relativePath === cleanPattern) {
+        return true;
+      }
+    }
+
+    return false;
+  };
+};
+
+module.exports = {
+  readIgnoreFile,
+  createIgnoreFile,
+  createIgnoredFilter,
+  normalizePath
+};