@howlil/ez-agents 2.0.0 → 3.0.0

package/{get-shit-done → ez-agents}/bin/lib/git-utils.cjs

@@ -1,203 +1,203 @@
-#!/usr/bin/env node
-
-/**
- * GSD Git Utils — Safe git operations with atomic commits
- * 
- * Provides:
- * - Atomic commits with validation
- * - Branch creation and management
- * - Safe git operations using execFile
- * - Error handling with recovery suggestions
- * 
- * Usage:
- *   const GitUtils = require('./git-utils.cjs');
- *   const git = new GitUtils(process.cwd());
- *   await git.commitAtomic('feat: add feature', ['file1.js']);
- */
-
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-const execFileAsync = promisify(execFile);
-const Logger = require('./logger.cjs');
-const logger = new Logger();
-
-class GitUtils {
-  constructor(cwd) {
-    this.cwd = cwd || process.cwd();
-  }
-
-  /**
-   * Execute git command safely
-   */
-  async exec(args, options = {}) {
-    const { timeout = 30000 } = options;
-    
-    try {
-      const { stdout, stderr } = await execFileAsync('git', args, {
-        cwd: this.cwd,
-        encoding: 'utf-8',
-        timeout,
-        maxBuffer: 10 * 1024 * 1024
-      });
-      
-      logger.debug('Git command executed', { args, stdout_length: stdout?.length });
-      
-      return { stdout: stdout?.trim(), stderr: stderr?.trim() };
-    } catch (err) {
-      logger.error('Git command failed', { args, error: err.message });
-      throw err;
-    }
-  }
-
-  /**
-   * Check if directory is a git repo
-   */
-  async isGitRepo() {
-    try {
-      await this.exec(['rev-parse', '--git-dir']);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Get current branch name
-   */
-  async getCurrentBranch() {
-    const { stdout } = await this.exec(['rev-parse', '--abbrev-ref', 'HEAD']);
-    return stdout;
-  }
-
-  /**
-   * Get git status (porcelain format)
-   */
-  async getStatus() {
-    const { stdout } = await this.exec(['status', '--porcelain']);
-    return stdout.split('\n').filter(line => line.trim());
-  }
-
-  /**
-   * Check if there are uncommitted changes
-   */
-  async hasChanges() {
-    const status = await this.getStatus();
-    return status.length > 0;
-  }
-
-  /**
-   * Stage files for commit
-   */
-  async add(files) {
-    if (!Array.isArray(files)) files = [files];
-    await this.exec(['add', ...files]);
-    logger.info('Files staged', { files });
-  }
-
-  /**
-   * Add all changes
-   */
-  async addAll() {
-    await this.exec(['add', '-A']);
-    logger.info('All files staged');
-  }
-
-  /**
-   * Create atomic commit with validation
-   */
-  async commitAtomic(message, files = []) {
-    // Stage files if provided
-    if (files.length > 0) {
-      await this.add(files);
-    }
-    
-    // Validate commit message format (conventional commits)
-    const conventionalPattern = /^(feat|fix|docs|chore|test|refactor|style|perf)(\([^)]+\))?:\s.+/;
-    if (!conventionalPattern.test(message)) {
-      logger.warn('Commit message may not follow conventional commits', { message });
-    }
-    
-    // Create commit
-    await this.exec(['commit', '-m', message]);
-    
-    // Get commit hash
-    const { stdout } = await this.exec(['rev-parse', '--short', 'HEAD']);
-    
-    logger.info('Commit created', { hash: stdout, message });
-    
-    return stdout;
-  }
-
-  /**
-   * Create new branch
-   */
-  async createBranch(name, from = 'HEAD') {
-    await this.exec(['checkout', '-b', name, from]);
-    logger.info('Branch created', { name, from });
-    return name;
-  }
-
-  /**
-   * Switch to branch
-   */
-  async checkout(branch) {
-    await this.exec(['checkout', branch]);
-    logger.info('Checked out branch', { branch });
-  }
-
-  /**
-   * Merge branch
-   */
-  async mergeBranch(branch, squash = false) {
-    const args = squash ? ['merge', '--squash', branch] : ['merge', branch];
-    await this.exec(args);
-    logger.info('Branch merged', { branch, squash });
-  }
-
-  /**
-   * Create tag
-   */
-  async tagRelease(version, message = '') {
-    const args = ['-a', version, '-m', message || `Release ${version}`];
-    await this.exec(['tag', ...args]);
-    logger.info('Tag created', { version });
-  }
-
-  /**
-   * Push to remote
-   */
-  async push(remote = 'origin', branch = null) {
-    const args = ['push', remote];
-    if (branch) args.push(branch);
-    await this.exec(args);
-    logger.info('Pushed to remote', { remote, branch });
-  }
-
-  /**
-   * Pull from remote
-   */
-  async pull(remote = 'origin', branch = null) {
-    const args = ['pull', remote];
-    if (branch) args.push(branch);
-    await this.exec(args);
-    logger.info('Pulled from remote', { remote, branch });
-  }
-
-  /**
-   * Get recent commits
-   */
-  async getCommits(count = 5) {
-    const { stdout } = await this.exec(['log', `-n${count}`, '--oneline']);
-    return stdout.split('\n');
-  }
-
-  /**
-   * Get diff between commits/branches
-   */
-  async getDiff(from, to = 'HEAD') {
-    const { stdout } = await this.exec(['diff', `${from}..${to}`, '--stat']);
-    return stdout;
-  }
-}
-
-module.exports = GitUtils;
+#!/usr/bin/env node
+
+/**
+ * GSD Git Utils — Safe git operations with atomic commits
+ * 
+ * Provides:
+ * - Atomic commits with validation
+ * - Branch creation and management
+ * - Safe git operations using execFile
+ * - Error handling with recovery suggestions
+ * 
+ * Usage:
+ *   const GitUtils = require('./git-utils.cjs');
+ *   const git = new GitUtils(process.cwd());
+ *   await git.commitAtomic('feat: add feature', ['file1.js']);
+ */
+
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+const execFileAsync = promisify(execFile);
+const Logger = require('./logger.cjs');
+const logger = new Logger();
+
+class GitUtils {
+  constructor(cwd) {
+    this.cwd = cwd || process.cwd();
+  }
+
+  /**
+   * Execute git command safely
+   */
+  async exec(args, options = {}) {
+    const { timeout = 30000 } = options;
+    
+    try {
+      const { stdout, stderr } = await execFileAsync('git', args, {
+        cwd: this.cwd,
+        encoding: 'utf-8',
+        timeout,
+        maxBuffer: 10 * 1024 * 1024
+      });
+      
+      logger.debug('Git command executed', { args, stdout_length: stdout?.length });
+      
+      return { stdout: stdout?.trim(), stderr: stderr?.trim() };
+    } catch (err) {
+      logger.error('Git command failed', { args, error: err.message });
+      throw err;
+    }
+  }
+
+  /**
+   * Check if directory is a git repo
+   */
+  async isGitRepo() {
+    try {
+      await this.exec(['rev-parse', '--git-dir']);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Get current branch name
+   */
+  async getCurrentBranch() {
+    const { stdout } = await this.exec(['rev-parse', '--abbrev-ref', 'HEAD']);
+    return stdout;
+  }
+
+  /**
+   * Get git status (porcelain format)
+   */
+  async getStatus() {
+    const { stdout } = await this.exec(['status', '--porcelain']);
+    return stdout.split('\n').filter(line => line.trim());
+  }
+
+  /**
+   * Check if there are uncommitted changes
+   */
+  async hasChanges() {
+    const status = await this.getStatus();
+    return status.length > 0;
+  }
+
+  /**
+   * Stage files for commit
+   */
+  async add(files) {
+    if (!Array.isArray(files)) files = [files];
+    await this.exec(['add', ...files]);
+    logger.info('Files staged', { files });
+  }
+
+  /**
+   * Add all changes
+   */
+  async addAll() {
+    await this.exec(['add', '-A']);
+    logger.info('All files staged');
+  }
+
+  /**
+   * Create atomic commit with validation
+   */
+  async commitAtomic(message, files = []) {
+    // Stage files if provided
+    if (files.length > 0) {
+      await this.add(files);
+    }
+    
+    // Validate commit message format (conventional commits)
+    const conventionalPattern = /^(feat|fix|docs|chore|test|refactor|style|perf)(\([^)]+\))?:\s.+/;
+    if (!conventionalPattern.test(message)) {
+      logger.warn('Commit message may not follow conventional commits', { message });
+    }
+    
+    // Create commit
+    await this.exec(['commit', '-m', message]);
+    
+    // Get commit hash
+    const { stdout } = await this.exec(['rev-parse', '--short', 'HEAD']);
+    
+    logger.info('Commit created', { hash: stdout, message });
+    
+    return stdout;
+  }
+
+  /**
+   * Create new branch
+   */
+  async createBranch(name, from = 'HEAD') {
+    await this.exec(['checkout', '-b', name, from]);
+    logger.info('Branch created', { name, from });
+    return name;
+  }
+
+  /**
+   * Switch to branch
+   */
+  async checkout(branch) {
+    await this.exec(['checkout', branch]);
+    logger.info('Checked out branch', { branch });
+  }
+
+  /**
+   * Merge branch
+   */
+  async mergeBranch(branch, squash = false) {
+    const args = squash ? ['merge', '--squash', branch] : ['merge', branch];
+    await this.exec(args);
+    logger.info('Branch merged', { branch, squash });
+  }
+
+  /**
+   * Create tag
+   */
+  async tagRelease(version, message = '') {
+    const args = ['-a', version, '-m', message || `Release ${version}`];
+    await this.exec(['tag', ...args]);
+    logger.info('Tag created', { version });
+  }
+
+  /**
+   * Push to remote
+   */
+  async push(remote = 'origin', branch = null) {
+    const args = ['push', remote];
+    if (branch) args.push(branch);
+    await this.exec(args);
+    logger.info('Pushed to remote', { remote, branch });
+  }
+
+  /**
+   * Pull from remote
+   */
+  async pull(remote = 'origin', branch = null) {
+    const args = ['pull', remote];
+    if (branch) args.push(branch);
+    await this.exec(args);
+    logger.info('Pulled from remote', { remote, branch });
+  }
+
+  /**
+   * Get recent commits
+   */
+  async getCommits(count = 5) {
+    const { stdout } = await this.exec(['log', `-n${count}`, '--oneline']);
+    return stdout.split('\n');
+  }
+
+  /**
+   * Get diff between commits/branches
+   */
+  async getDiff(from, to = 'HEAD') {
+    const { stdout } = await this.exec(['diff', `${from}..${to}`, '--stat']);
+    return stdout;
+  }
+}
+
+module.exports = GitUtils;