@howlil/ez-agents 3.5.0 → 4.0.0

package/bin/update.js

@@ -1,214 +1,217 @@
-#!/usr/bin/env node
-
-/**
- * EZ Agents Update — Check and install updates
- *
- * Usage:
- *   ez-agents-update              # Check for updates
- *   ez-agents-update --check      # Check only
- *   ez-agents-update --force      # Force reinstall
- *   ez-agents-update --changelog  # Show changelog
- */
-
-const { execSync } = require('child_process');
-const path = require('path');
-
-const PACKAGE_NAME = 'ez-agents';
-const REPO_URL = 'https://github.com/howlil/ez-agents.git';
-
-// Colors for output
-const colors = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  red: '\x1b[31m',
-  bold: '\x1b[1m'
-};
-
-function log(message, color = 'reset') {
-  console.log(`${colors[color]}${message}${colors.reset}`);
-}
-
-/**
- * Get current installed version
- */
-function getCurrentVersion() {
-  try {
-    const pkg = require('./package.json');
-    return pkg.version;
-  } catch {
-    return 'unknown';
-  }
-}
-
-/**
- * Get latest version from npm
- */
-function getLatestVersion() {
-  try {
-    const output = execSync(`npm view ${PACKAGE_NAME} version`, {
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'ignore']
-    });
-    return output.trim();
-  } catch {
-    // Fallback: check GitHub repo
-    try {
-      const output = execSync(`npm view git+${REPO_URL} version`, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'ignore']
-      });
-      return output.trim();
-    } catch {
-      return null;
-    }
-  }
-}
-
-/**
- * Check if update is available
- */
-function checkUpdate() {
-  const current = getCurrentVersion();
-  const latest = getLatestVersion();
-  
-  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
-  log(' EZ Agents Update Check', 'bold');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
-  
-  log(`Current version: ${colors.bold}v${current}${colors.reset}`);
-  
-  if (!latest) {
-    log('Unable to check for updates (no network or repo unavailable)', 'yellow');
-    return;
-  }
-  
-  log(`Latest version:  ${colors.bold}v${latest}${colors.reset}\n`);
-  
-  if (current === latest) {
-    log('✓ You are on the latest version!\n', 'green');
-    return false;
-  }
-  
-  log(`⚡ Update available: v${current} → v${latest}\n`, 'yellow');
-  log('To update, run:\n', 'blue');
-  log(`  npm install -g ${PACKAGE_NAME}@latest\n`, 'green');
-  log('Or force reinstall:\n', 'blue');
-  log(`  ez-agents-update --force\n`, 'green');
-  
-  return true;
-}
-
-/**
- * Install update
- */
-function installUpdate(force = false) {
-  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
-  log(' EZ Agents Update', 'bold');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
-  
-  const current = getCurrentVersion();
-  const latest = getLatestVersion();
-  
-  if (!latest) {
-    log('Unable to check for updates', 'red');
-    process.exit(1);
-  }
-  
-  if (current === latest && !force) {
-    log('Already on latest version', 'green');
-    return;
-  }
-  
-  log(`Updating: v${current} → v${latest}...\n`, 'blue');
-  
-  try {
-    execSync(`npm install -g ${PACKAGE_NAME}@latest`, {
-      stdio: 'inherit'
-    });
-    
-    log('\n✓ Update complete!\n', 'green');
-    log('Restart your terminal or run:\n', 'blue');
-    log(`  ez-agents --version\n`, 'green');
-  } catch (err) {
-    log('\n✗ Update failed\n', 'red');
-    log('Try manual install:\n', 'yellow');
-    log(`  npm install -g ${PACKAGE_NAME}@latest\n`, 'blue');
-    process.exit(1);
-  }
-}
-
-/**
- * Show changelog
- */
-function showChangelog() {
-  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
-  log(' EZ Agents Changelog', 'bold');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
-  
-  try {
-    const fs = require('fs');
-    const changelogPath = path.join(__dirname, 'CHANGELOG.md');
-    
-    if (fs.existsSync(changelogPath)) {
-      const content = fs.readFileSync(changelogPath, 'utf-8');
-      // Show first 50 lines
-      const lines = content.split('\n').slice(0, 50);
-      log(lines.join('\n'));
-    } else {
-      log('CHANGELOG.md not found', 'yellow');
-      log(`\nView online: ${REPO_URL}/blob/main/CHANGELOG.md\n`, 'blue');
-    }
-  } catch (err) {
-    log('Unable to read changelog', 'red');
-  }
-}
-
-/**
- * Show help
- */
-function showHelp() {
-  log(`
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- EZ Agents Update — Check and Install Updates
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Usage:
-  ez-agents-update [options]
-
-Options:
-  --check      Check for updates (don't install)
-  --force      Force reinstall even if up-to-date
-  --changelog  Show changelog
-  --help       Show this help message
-
-Examples:
-  ez-agents-update              # Check and prompt to update
-  ez-agents-update --check      # Check only
-  ez-agents-update --force      # Force reinstall
-  ez-agents-update --changelog  # View changelog
-
-Manual Update:
-  npm install -g ez-agents@latest
-`);
-}
-
-// Main
-const args = process.argv.slice(2);
-
-if (args.includes('--help') || args.includes('-h')) {
-  showHelp();
-} else if (args.includes('--changelog')) {
-  showChangelog();
-} else if (args.includes('--check')) {
-  checkUpdate();
-} else if (args.includes('--force')) {
-  installUpdate(true);
-} else {
-  const hasUpdate = checkUpdate();
-  if (hasUpdate) {
-    // Auto-prompt (simple version)
-    log('Run "ez-agents-update --force" to update now\n');
-  }
-}
+#!/usr/bin/env node
+
+/**
+ * EZ Agents Update — Check and install updates
+ *
+ * Usage:
+ *   ez-agents-update              # Check for updates
+ *   ez-agents-update --check      # Check only
+ *   ez-agents-update --force      # Force reinstall
+ *   ez-agents-update --changelog  # Show changelog
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const PACKAGE_NAME = 'ez-agents';
+const REPO_URL = 'https://github.com/howlil/ez-agents.git';
+
+// Colors for output
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+  bold: '\x1b[1m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+/**
+ * Get current installed version
+ */
+function getCurrentVersion() {
+  try {
+    const pkg = require('./package.json');
+    return pkg.version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+/**
+ * Get latest version from npm
+ */
+function getLatestVersion() {
+  try {
+    const output = execSync(`npm view ${PACKAGE_NAME} version`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 10000 // 10 second timeout
+    });
+    return output.trim();
+  } catch {
+    // Fallback: check GitHub repo
+    try {
+      const output = execSync(`npm view git+${REPO_URL} version`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'ignore'],
+        timeout: 10000 // 10 second timeout
+      });
+      return output.trim();
+    } catch {
+      return null;
+    }
+  }
+}
+
+/**
+ * Check if update is available
+ */
+function checkUpdate() {
+  const current = getCurrentVersion();
+  const latest = getLatestVersion();
+  
+  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
+  log(' EZ Agents Update Check', 'bold');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
+  
+  log(`Current version: ${colors.bold}v${current}${colors.reset}`);
+  
+  if (!latest) {
+    log('Unable to check for updates (no network or repo unavailable)', 'yellow');
+    return;
+  }
+  
+  log(`Latest version:  ${colors.bold}v${latest}${colors.reset}\n`);
+  
+  if (current === latest) {
+    log('✓ You are on the latest version!\n', 'green');
+    return false;
+  }
+  
+  log(`⚡ Update available: v${current} → v${latest}\n`, 'yellow');
+  log('To update, run:\n', 'blue');
+  log(`  npm install -g ${PACKAGE_NAME}@latest\n`, 'green');
+  log('Or force reinstall:\n', 'blue');
+  log(`  ez-agents-update --force\n`, 'green');
+  
+  return true;
+}
+
+/**
+ * Install update
+ */
+function installUpdate(force = false) {
+  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
+  log(' EZ Agents Update', 'bold');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
+  
+  const current = getCurrentVersion();
+  const latest = getLatestVersion();
+  
+  if (!latest) {
+    log('Unable to check for updates', 'red');
+    process.exit(1);
+  }
+  
+  if (current === latest && !force) {
+    log('Already on latest version', 'green');
+    return;
+  }
+  
+  log(`Updating: v${current} → v${latest}...\n`, 'blue');
+
+  try {
+    execSync(`npm install -g ${PACKAGE_NAME}@latest`, {
+      stdio: 'inherit',
+      timeout: 120000 // 2 minute timeout for npm install
+    });
+
+    log('\n✓ Update complete!\n', 'green');
+    log('Restart your terminal or run:\n', 'blue');
+    log(`  ez-agents --version\n`, 'green');
+  } catch (err) {
+    log('\n✗ Update failed\n', 'red');
+    log('Try manual install:\n', 'yellow');
+    log(`  npm install -g ${PACKAGE_NAME}@latest\n`, 'blue');
+    process.exit(1);
+  }
+}
+
+/**
+ * Show changelog
+ */
+function showChangelog() {
+  log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'blue');
+  log(' EZ Agents Changelog', 'bold');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n', 'blue');
+  
+  try {
+    const fs = require('fs');
+    const changelogPath = path.join(__dirname, 'CHANGELOG.md');
+    
+    if (fs.existsSync(changelogPath)) {
+      const content = fs.readFileSync(changelogPath, 'utf-8');
+      // Show first 50 lines
+      const lines = content.split('\n').slice(0, 50);
+      log(lines.join('\n'));
+    } else {
+      log('CHANGELOG.md not found', 'yellow');
+      log(`\nView online: ${REPO_URL}/blob/main/CHANGELOG.md\n`, 'blue');
+    }
+  } catch (err) {
+    log('Unable to read changelog', 'red');
+  }
+}
+
+/**
+ * Show help
+ */
+function showHelp() {
+  log(`
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ EZ Agents Update — Check and Install Updates
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Usage:
+  ez-agents-update [options]
+
+Options:
+  --check      Check for updates (don't install)
+  --force      Force reinstall even if up-to-date
+  --changelog  Show changelog
+  --help       Show this help message
+
+Examples:
+  ez-agents-update              # Check and prompt to update
+  ez-agents-update --check      # Check only
+  ez-agents-update --force      # Force reinstall
+  ez-agents-update --changelog  # View changelog
+
+Manual Update:
+  npm install -g ez-agents@latest
+`);
+}
+
+// Main
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  showHelp();
+} else if (args.includes('--changelog')) {
+  showChangelog();
+} else if (args.includes('--check')) {
+  checkUpdate();
+} else if (args.includes('--force')) {
+  installUpdate(true);
+} else {
+  const hasUpdate = checkUpdate();
+  if (hasUpdate) {
+    // Auto-prompt (simple version)
+    log('Run "ez-agents-update --force" to update now\n');
+  }
+}

package/commands/deploy.cjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+/**
+ * Deploy Command (Phase 19 Placeholder)
+ *
+ * This is a placeholder script for Phase 19 (Deployment & Operations).
+ * It simulates deployment behavior for CI/CD pipeline testing.
+ *
+ * In Phase 19, this will be implemented with real deployment logic:
+ * - Platform detection (Vercel, Netlify, AWS, Docker)
+ * - Configuration generation
+ * - One-command deployment workflow
+ * - Environment variable management
+ */
+
+const path = require('path');
+const { defaultLogger: logger } = require('../bin/lib/logger.cjs');
+
+// Get environment from arguments or default to 'staging'
+const environment = process.argv[2] || 'staging';
+
+logger.info(`Starting deployment to environment: ${environment}`);
+logger.info('Placeholder mode - simulating deployment');
+
+// Simulate deployment steps
+const steps = [
+  'Detecting deployment platform...',
+  'Validating configuration...',
+  'Installing dependencies...',
+  'Building application...',
+  'Uploading artifacts...',
+  'Activating new version...',
+  'Running post-deployment checks...'
+];
+
+steps.forEach((step, index) => {
+  logger.info(`[${index + 1}/${steps.length}] ${step}`);
+});
+
+logger.info('Deployment completed successfully!');
+logger.info('Environment: ' + environment);
+
+try {
+  const pkg = require('../package.json');
+  logger.info('Version: ' + pkg.version);
+} catch (err) {
+  logger.debug('Could not read package version', { error: err.message });
+}
+
+logger.info('Timestamp: ' + new Date().toISOString());
+
+// Exit with success code
+process.exit(0);

package/commands/ez/add-tests.md

@@ -1,41 +1,41 @@
----
-name: ez:add-tests
-description: Generate tests for a completed phase based on UAT criteria and implementation
-argument-hint: "<phase> [additional instructions]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - AskUserQuestion
-argument-instructions: |
-  Parse the argument as a phase number (integer, decimal, or letter-suffix), plus optional free-text instructions.
-  Example: /ez:add-tests 12
-  Example: /ez:add-tests 12 focus on edge cases in the pricing module
----
-<objective>
-Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
-
-Analyzes implementation files, classifies them into TDD (unit), E2E (browser), or Skip categories, presents a test plan for user approval, then generates tests following RED-GREEN conventions.
-
-Output: Test files committed with message `test(phase-{N}): add unit and E2E tests from add-tests command`
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/add-tests.md
-</execution_context>
-
-<context>
-Phase: $ARGUMENTS
-
-@.planning/STATE.md
-@.planning/ROADMAP.md
-</context>
-
-<process>
-Execute the add-tests workflow from @~/.claude/ez-agents/workflows/add-tests.md end-to-end.
-Preserve all workflow gates (classification approval, test plan approval, RED-GREEN verification, gap reporting).
-</process>
+---
+name: ez:add-tests
+description: Generate tests for a completed phase based on UAT criteria and implementation
+argument-hint: "<phase> [additional instructions]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+argument-instructions: |
+  Parse the argument as a phase number (integer, decimal, or letter-suffix), plus optional free-text instructions.
+  Example: /ez:add-tests 12
+  Example: /ez:add-tests 12 focus on edge cases in the pricing module
+---
+<objective>
+Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
+
+Analyzes implementation files, classifies them into TDD (unit), E2E (browser), or Skip categories, presents a test plan for user approval, then generates tests following RED-GREEN conventions.
+
+Output: Test files committed with message `test(phase-{N}): add unit and E2E tests from add-tests command`
+</objective>
+
+<execution_context>
+@~/.claude/ez-agents/workflows/add-tests.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS
+
+@.planning/STATE.md
+@.planning/ROADMAP.md
+</context>
+
+<process>
+Execute the add-tests workflow from @~/.claude/ez-agents/workflows/add-tests.md end-to-end.
+Preserve all workflow gates (classification approval, test plan approval, RED-GREEN verification, gap reporting).
+</process>

package/commands/ez/audit-milestone.md

@@ -1,36 +1,36 @@
----
-name: ez:audit-milestone
-description: Audit milestone completion against original intent before archiving
-argument-hint: "[version]"
-allowed-tools:
-  - Read
-  - Glob
-  - Grep
-  - Bash
-  - Task
-  - Write
----
-<objective>
-Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
-
-**This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/audit-milestone.md
-</execution_context>
-
-<context>
-Version: $ARGUMENTS (optional — defaults to current milestone)
-
-Core planning files are resolved in-workflow (`init milestone-op`) and loaded only as needed.
-
-**Completed Work:**
-Glob: .planning/phases/*/*-SUMMARY.md
-Glob: .planning/phases/*/*-VERIFICATION.md
-</context>
-
-<process>
-Execute the audit-milestone workflow from @~/.claude/ez-agents/workflows/audit-milestone.md end-to-end.
-Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
-</process>
+---
+name: ez:audit-milestone
+description: Audit milestone completion against original intent before archiving
+argument-hint: "[version]"
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - Write
+---
+<objective>
+Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
+
+**This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
+</objective>
+
+<execution_context>
+@~/.claude/ez-agents/workflows/audit-milestone.md
+</execution_context>
+
+<context>
+Version: $ARGUMENTS (optional — defaults to current milestone)
+
+Core planning files are resolved in-workflow (`init milestone-op`) and loaded only as needed.
+
+**Completed Work:**
+Glob: .planning/phases/*/*-SUMMARY.md
+Glob: .planning/phases/*/*-VERIFICATION.md
+</context>
+
+<process>
+Execute the audit-milestone workflow from @~/.claude/ez-agents/workflows/audit-milestone.md end-to-end.
+Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
+</process>