@howlil/ez-agents 3.1.0 → 3.4.2

package/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
+
+/**
+ * EZ 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;

package/ez-agents/bin/lib/health-check.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 /**
- * GSD Health Check — Health monitoring for GSD workflow
+ * EZ Health Check — Health monitoring for EZ workflow
  * 
- * Validates GSD environment and configuration
+ * Validates EZ environment and configuration
  * Used by workflows to detect failures and use fallback functions
  * 
  * Usage:
@@ -14,7 +14,6 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
 
 class HealthCheck {
   /**

package/ez-agents/bin/lib/index.cjs

@@ -1,113 +1,113 @@
-#!/usr/bin/env node
-
-/**
- * GSD Lib Index — Central export for all GSD libraries
- * 
- * Provides single import point for all utility modules.
- * 
- * Usage:
- *   const lib = require('./index.cjs');
- *   const logger = new lib.Logger();
- *   const git = new lib.GitUtils(process.cwd());
- */
-
-const path = require('path');
-const fs = require('fs');
-
-// Core utilities
-const Logger = require('./logger.cjs');
-const LoggerInstance = new Logger();
-
-// File system
-const fsUtils = require('./fs-utils.cjs');
-
-// Security
-const safeExec = require('./safe-exec.cjs');
-const safePath = require('./safe-path.cjs');
-const auth = require('./auth.cjs');
-const auditExec = require('./audit-exec.cjs');
-
-// Git
-const GitUtils = require('./git-utils.cjs');
-
-// Reliability
-const retry = require('./retry.cjs');
-const CircuitBreaker = require('./circuit-breaker.cjs');
-
-// Concurrency
-const fileLock = require('./file-lock.cjs');
-const tempFile = require('./temp-file.cjs');
-
-// Health & Testing
-const healthCheck = require('./health-check.cjs');
-const timeoutExec = require('./timeout-exec.cjs');
-
-// Multi-model
-const modelProvider = require('./model-provider.cjs');
-
-// Adapters
-const assistantAdapter = require('./assistant-adapter.cjs');
-
-module.exports = {
-  // Core
-  Logger,
-  logger: LoggerInstance,
-  
-  // File system
-  ...fsUtils,
-  
-  // Security
-  ...safeExec,
-  ...safePath,
-  ...auth,
-  ...auditExec,
-  
-  // Git
-  GitUtils,
-  
-  // Reliability
-  ...retry,
-  CircuitBreaker,
-  
-  // Concurrency
-  ...fileLock,
-  ...tempFile,
-  
-  // Health & Testing
-  ...healthCheck,
-  ...timeoutExec,
-  
-  // Multi-model
-  ...modelProvider,
-  
-  // Adapters
-  ...assistantAdapter,
-  
-  // Version info
-  version: '2.0.0',
-  
-  /**
-   * Get health status of all modules
-   */
-  getHealthStatus() {
-    return {
-      version: this.version,
-      nodeVersion: process.version,
-      platform: process.platform,
-      modules: {
-        logger: 'ok',
-        fsUtils: 'ok',
-        safeExec: 'ok',
-        safePath: 'ok',
-        auth: auth.isKeychainAvailable() ? 'keychain' : 'fallback',
-        gitUtils: 'ok',
-        retry: 'ok',
-        circuitBreaker: 'ok',
-        fileLock: 'ok',
-        tempFile: 'ok',
-        modelProvider: 'ok',
-        assistantAdapter: 'ok'
-      }
-    };
-  }
-};
+#!/usr/bin/env node
+
+/**
+ * EZ Lib Index — Central export for all EZ libraries
+ * 
+ * Provides single import point for all utility modules.
+ * 
+ * Usage:
+ *   const lib = require('./index.cjs');
+ *   const logger = new lib.Logger();
+ *   const git = new lib.GitUtils(process.cwd());
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// Core utilities
+const Logger = require('./logger.cjs');
+const LoggerInstance = new Logger();
+
+// File system
+const fsUtils = require('./fs-utils.cjs');
+
+// Security
+const safeExec = require('./safe-exec.cjs');
+const safePath = require('./safe-path.cjs');
+const auth = require('./auth.cjs');
+const auditExec = require('./audit-exec.cjs');
+
+// Git
+const GitUtils = require('./git-utils.cjs');
+
+// Reliability
+const retry = require('./retry.cjs');
+const CircuitBreaker = require('./circuit-breaker.cjs');
+
+// Concurrency
+const fileLock = require('./file-lock.cjs');
+const tempFile = require('./temp-file.cjs');
+
+// Health & Testing
+const healthCheck = require('./health-check.cjs');
+const timeoutExec = require('./timeout-exec.cjs');
+
+// Multi-model
+const modelProvider = require('./model-provider.cjs');
+
+// Adapters
+const assistantAdapter = require('./assistant-adapter.cjs');
+
+module.exports = {
+  // Core
+  Logger,
+  logger: LoggerInstance,
+  
+  // File system
+  ...fsUtils,
+  
+  // Security
+  ...safeExec,
+  ...safePath,
+  ...auth,
+  ...auditExec,
+  
+  // Git
+  GitUtils,
+  
+  // Reliability
+  ...retry,
+  CircuitBreaker,
+  
+  // Concurrency
+  ...fileLock,
+  ...tempFile,
+  
+  // Health & Testing
+  ...healthCheck,
+  ...timeoutExec,
+  
+  // Multi-model
+  ...modelProvider,
+  
+  // Adapters
+  ...assistantAdapter,
+  
+  // Version info
+  version: '2.0.0',
+  
+  /**
+   * Get health status of all modules
+   */
+  getHealthStatus() {
+    return {
+      version: this.version,
+      nodeVersion: process.version,
+      platform: process.platform,
+      modules: {
+        logger: 'ok',
+        fsUtils: 'ok',
+        safeExec: 'ok',
+        safePath: 'ok',
+        auth: auth.isKeychainAvailable() ? 'keychain' : 'fallback',
+        gitUtils: 'ok',
+        retry: 'ok',
+        circuitBreaker: 'ok',
+        fileLock: 'ok',
+        tempFile: 'ok',
+        modelProvider: 'ok',
+        assistantAdapter: 'ok'
+      }
+    };
+  }
+};