@howlil/ez-agents 2.0.0

package/get-shit-done/bin/lib/git-utils.cjs

@@ -0,0 +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;

package/get-shit-done/bin/lib/health-check.cjs

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+
+/**
+ * GSD Health Check — Health monitoring for GSD workflow
+ * 
+ * Validates GSD environment and configuration
+ * Used by workflows to detect failures and use fallback functions
+ * 
+ * Usage:
+ *   const HealthCheck = require('./health-check.cjs');
+ *   const health = new HealthCheck();
+ *   const result = health.runAll();
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+class HealthCheck {
+  /**
+   * Create a HealthCheck instance
+   */
+  constructor() {
+    this.issues = [];
+    this.warnings = [];
+  }
+
+  /**
+   * Check Node.js version (must be >= 16)
+   * @returns {boolean} - True if version is acceptable
+   */
+  checkNodeVersion() {
+    try {
+      const version = process.version;
+      const major = parseInt(version.slice(1).split('.')[0]);
+      if (major < 16) {
+        this.issues.push(`Node.js version ${version} is below required 16.x`);
+        return false;
+      }
+      return true;
+    } catch (err) {
+      this.issues.push('Cannot determine Node.js version');
+      return false;
+    }
+  }
+
+  /**
+   * Check if .planning directory exists
+   * @returns {boolean} - True if exists
+   */
+  checkPlanningDirectory() {
+    const planningDir = '.planning';
+    if (!fs.existsSync(planningDir)) {
+      this.warnings.push('.planning directory does not exist');
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Check if config.json exists and is valid JSON
+   * @returns {boolean} - True if exists and valid
+   */
+  checkConfigFile() {
+    const configPath = '.planning/config.json';
+    if (!fs.existsSync(configPath)) {
+      this.warnings.push('config.json not found');
+      return false;
+    }
+    try {
+      JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      return true;
+    } catch (err) {
+      this.issues.push('config.json is invalid JSON');
+      return false;
+    }
+  }
+
+  /**
+   * Check if STATE.md exists
+   * @returns {boolean} - True if exists
+   */
+  checkStateFile() {
+    const statePath = '.planning/STATE.md';
+    if (!fs.existsSync(statePath)) {
+      this.warnings.push('STATE.md not found');
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Check if ROADMAP.md exists
+   * @returns {boolean} - True if exists
+   */
+  checkRoadmapFile() {
+    const roadmapPath = '.planning/ROADMAP.md';
+    if (!fs.existsSync(roadmapPath)) {
+      this.warnings.push('ROADMAP.md not found');
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Check if PROJECT.md exists
+   * @returns {boolean} - True if exists
+   */
+  checkProjectFile() {
+    const projectPath = '.planning/PROJECT.md';
+    if (!fs.existsSync(projectPath)) {
+      this.warnings.push('PROJECT.md not found');
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Check if REQUIREMENTS.md exists
+   * @returns {boolean} - True if exists
+   */
+  checkRequirementsFile() {
+    const reqPath = '.planning/REQUIREMENTS.md';
+    if (!fs.existsSync(reqPath)) {
+      this.warnings.push('REQUIREMENTS.md not found');
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Run all health checks
+   * @returns {Object} - Health status object
+   */
+  runAll() {
+    const results = {
+      status: 'healthy',
+      timestamp: new Date().toISOString(),
+      node_version: process.version,
+      checks: {
+        node_version: this.checkNodeVersion(),
+        planning_dir: this.checkPlanningDirectory(),
+        config_file: this.checkConfigFile(),
+        state_file: this.checkStateFile(),
+        roadmap_file: this.checkRoadmapFile(),
+        project_file: this.checkProjectFile(),
+        requirements_file: this.checkRequirementsFile()
+      },
+      issues: this.issues,
+      warnings: this.warnings
+    };
+
+    if (this.issues.length > 0) {
+      results.status = 'unhealthy';
+    } else if (this.warnings.length > 0) {
+      results.status = 'degraded';
+    }
+
+    return results;
+  }
+}
+
+module.exports = HealthCheck;

package/get-shit-done/bin/lib/index.cjs

@@ -0,0 +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'
+      }
+    };
+  }
+};