agileflow 3.4.3 → 4.0.0-alpha.2

package/scripts/check-sessions.js

@@ -1,116 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * check-sessions.js - Top-level entry point for monitoring tmux audit sessions
- *
- * Thin wrapper around lib/tmux-audit-monitor.js for easy discovery and calling.
- *
- * Subcommands:
- *   list                                 - List all active audit traces
- *   status  <trace_id>                   - Check progress of a specific audit trace
- *   wait    <trace_id> [--timeout=1800]  - Block until audit trace completes
- *   collect <trace_id>                   - Collect findings from completed analyzers
- *   retry   <trace_id> [--analyzer=key]  - Retry stalled analyzers
- *   kill    <trace_id> [--keep-files]    - Clean shutdown
- *
- * All output is JSON to stdout. Progress goes to stderr.
- *
- * Usage:
- *   node .agileflow/scripts/check-sessions.js list
- *   node .agileflow/scripts/check-sessions.js status abc123ef
- *   node .agileflow/scripts/check-sessions.js wait abc123ef --timeout=600
- */
-
-const USAGE = `Usage: check-sessions.js <subcommand> [trace_id] [options]
-
-Subcommands:
-  list                              List all active audit traces
-  status  <trace_id>                Check progress of a specific audit trace
-  wait    <trace_id> [--timeout=N]  Block until audit trace completes (default: 1800s)
-  collect <trace_id>                Collect findings from completed analyzers
-  retry   <trace_id> [--analyzer=X] Retry stalled analyzers
-  kill    <trace_id> [--keep-files] Clean shutdown of audit sessions
-
-Options:
-  --timeout=N       Seconds to wait before timeout (default: 1800)
-  --poll=N          Seconds between status checks (default: 5)
-  --analyzer=KEY    Retry specific analyzer only
-  --model=MODEL     Model override for retry
-  --keep-files      Don't remove sentinel files on kill
-  --help            Show this help message`;
-
-function jsonOut(obj) {
-  console.log(JSON.stringify(obj));
-}
-
-if (require.main === module) {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.error(USAGE);
-    process.exit(args.length === 0 ? 1 : 0);
-  }
-
-  // Delegate to tmux-audit-monitor.js
-  let monitor;
-  try {
-    monitor = require('./lib/tmux-audit-monitor');
-  } catch (err) {
-    jsonOut({ ok: false, error: `Failed to load tmux-audit-monitor: ${err.message}` });
-    process.exit(1);
-  }
-
-  const subcommand = args[0];
-  const traceId = args[1];
-  const restArgs = args.slice(2);
-  const rootDir = process.cwd();
-  const opts = monitor.parseSubcommandArgs(restArgs);
-
-  // Validate traceId for commands that require it
-  const needsTraceId = ['status', 'wait', 'collect', 'retry', 'kill'];
-  if (needsTraceId.includes(subcommand) && !traceId) {
-    jsonOut({ ok: false, error: 'trace_id required' });
-    process.exit(1);
-  }
-
-  try {
-    switch (subcommand) {
-      case 'status':
-        monitor.cmdStatus(rootDir, traceId);
-        break;
-
-      case 'wait':
-        // Not awaited — event loop stays alive via sleep() timer inside cmdWait
-        monitor.cmdWait(rootDir, traceId, opts.timeout, opts.poll).catch(err => {
-          jsonOut({ ok: false, error: err.message });
-          process.exit(1);
-        });
-        break;
-
-      case 'collect':
-        monitor.cmdCollect(rootDir, traceId);
-        break;
-
-      case 'retry':
-        monitor.cmdRetry(rootDir, traceId, opts.analyzer, opts.model);
-        break;
-
-      case 'kill':
-        monitor.cmdKill(rootDir, traceId, opts.keepFiles);
-        break;
-
-      case 'list':
-        monitor.cmdList(rootDir);
-        break;
-
-      default:
-        jsonOut({ ok: false, error: `Unknown subcommand: ${subcommand}` });
-        process.exit(1);
-    }
-  } catch (err) {
-    jsonOut({ ok: false, error: err.message });
-    process.exit(1);
-  }
-}
-
-module.exports = { USAGE };

package/scripts/check-update.js

@@ -1,282 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * check-update.js - Check for AgileFlow updates
- *
- * Simple update checker:
- * - Always checks npm registry for latest version
- * - Auto-updates if update is available (enabled by default)
- * - Fast npm metadata lookup (~100-500ms)
- *
- * Usage:
- *   node check-update.js [--json]
- *
- * Environment:
- *   DEBUG_UPDATE=1  Enable debug logging
- */
-
-const fs = require('fs');
-const path = require('path');
-const https = require('https');
-
-// Shared utilities
-const { getProjectRoot } = require('../lib/paths');
-const { safeReadJSON, safeWriteJSON } = require('../lib/errors');
-
-// Debug mode
-const DEBUG = process.env.DEBUG_UPDATE === '1';
-
-function debugLog(message, data = null) {
-  if (DEBUG) {
-    console.error(`[check-update] ${message}`, data ? JSON.stringify(data) : '');
-  }
-}
-
-// Get installed AgileFlow version
-function getInstalledVersion(rootDir) {
-  // First check .agileflow/config.yaml (installed version)
-  try {
-    const configPath = path.join(rootDir, '.agileflow', 'config.yaml');
-    if (fs.existsSync(configPath)) {
-      const content = fs.readFileSync(configPath, 'utf8');
-      const versionMatch = content.match(/^version:\s*['"]?([0-9.]+)/m);
-      if (versionMatch) {
-        return versionMatch[1];
-      }
-    }
-  } catch (err) {
-    debugLog('Error reading .agileflow/config.yaml', err.message);
-  }
-
-  // Fallback: check if this is the AgileFlow dev repo
-  const cliPkg = path.join(rootDir, 'packages/cli/package.json');
-  const cliResult = safeReadJSON(cliPkg);
-  if (cliResult.ok && cliResult.data?.name === 'agileflow' && cliResult.data?.version) {
-    return cliResult.data.version;
-  }
-
-  return null;
-}
-
-// Get update configuration from metadata
-function getUpdateConfig(rootDir) {
-  const defaults = {
-    autoUpdate: true, // Auto-update enabled by default
-    showChangelog: true,
-    lastSeenVersion: null,
-  };
-
-  const metadataPath = path.join(rootDir, 'docs/00-meta/agileflow-metadata.json');
-  const result = safeReadJSON(metadataPath, { defaultValue: {} });
-
-  if (!result.ok) {
-    debugLog('Error reading update config', result.error);
-    return defaults;
-  }
-
-  if (result.data?.updates) {
-    return { ...defaults, ...result.data.updates };
-  }
-
-  return defaults;
-}
-
-// Save update configuration
-function saveUpdateConfig(rootDir, config) {
-  const metadataPath = path.join(rootDir, 'docs/00-meta/agileflow-metadata.json');
-
-  // Read existing metadata
-  const readResult = safeReadJSON(metadataPath, { defaultValue: {} });
-  const metadata = readResult.ok ? readResult.data : {};
-
-  // Update and write
-  metadata.updates = config;
-  const writeResult = safeWriteJSON(metadataPath, metadata, { createDir: true });
-
-  if (!writeResult.ok) {
-    debugLog('Error saving update config', writeResult.error);
-    return false;
-  }
-
-  return true;
-}
-
-// Fetch latest version from npm
-async function fetchLatestVersion() {
-  return new Promise(resolve => {
-    const options = {
-      hostname: 'registry.npmjs.org',
-      port: 443,
-      path: '/agileflow/latest',
-      method: 'GET',
-      headers: {
-        'User-Agent': 'agileflow-cli',
-      },
-      // Security: Explicitly enable TLS certificate validation
-      // Prevents MITM attacks on npm registry requests
-      rejectUnauthorized: true,
-    };
-
-    debugLog('Fetching from npm registry');
-
-    const req = https.request(options, res => {
-      let data = '';
-
-      res.on('data', chunk => {
-        data += chunk;
-      });
-
-      res.on('end', () => {
-        if (res.statusCode !== 200) {
-          debugLog('Non-200 status', { statusCode: res.statusCode });
-          return resolve(null);
-        }
-
-        try {
-          const json = JSON.parse(data);
-          debugLog('Version found', { version: json.version });
-          resolve(json.version || null);
-        } catch (err) {
-          debugLog('JSON parse error', err.message);
-          resolve(null);
-        }
-      });
-    });
-
-    req.on('error', err => {
-      // Enhanced error logging with retry guidance
-      const errorInfo = {
-        error: err.message,
-        code: err.code,
-        suggestion: 'Check network connection. If error persists, try: npm cache clean --force',
-      };
-      if (err.code === 'CERT_HAS_EXPIRED' || err.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE') {
-        errorInfo.suggestion =
-          'TLS certificate error - check system time or update CA certificates';
-      }
-      debugLog('Network error', errorInfo);
-      resolve(null);
-    });
-
-    // 10 second timeout for registry requests
-    req.setTimeout(10000, () => {
-      debugLog('Request timeout (10s)', { suggestion: 'npm registry may be slow. Retry later.' });
-      req.destroy();
-      resolve(null);
-    });
-
-    req.end();
-  });
-}
-
-// Compare semantic versions: returns -1 if a < b, 0 if equal, 1 if a > b
-function compareVersions(a, b) {
-  if (!a || !b) return 0;
-  const partsA = a.split('.').map(Number);
-  const partsB = b.split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    const numA = partsA[i] || 0;
-    const numB = partsB[i] || 0;
-    if (numA < numB) return -1;
-    if (numA > numB) return 1;
-  }
-  return 0;
-}
-
-// Main check function - always checks npm
-async function checkForUpdates() {
-  const rootDir = getProjectRoot();
-  const installedVersion = getInstalledVersion(rootDir);
-  const config = getUpdateConfig(rootDir);
-
-  const result = {
-    installed: installedVersion,
-    latest: null,
-    updateAvailable: false,
-    autoUpdate: config.autoUpdate,
-    justUpdated: false,
-    previousVersion: config.lastSeenVersion,
-    error: null,
-  };
-
-  // No installed version found
-  if (!installedVersion) {
-    result.error = 'Could not determine installed version';
-    return result;
-  }
-
-  // Check if we just updated (lastSeenVersion < installed)
-  if (config.lastSeenVersion && compareVersions(config.lastSeenVersion, installedVersion) < 0) {
-    result.justUpdated = true;
-    result.previousVersion = config.lastSeenVersion;
-  }
-
-  // Always fetch from npm
-  result.latest = await fetchLatestVersion();
-
-  // Compare versions
-  if (result.latest && compareVersions(installedVersion, result.latest) < 0) {
-    result.updateAvailable = true;
-  }
-
-  return result;
-}
-
-// Mark version as seen (after update or dismissal)
-function markVersionSeen(version) {
-  const rootDir = getProjectRoot();
-  const config = getUpdateConfig(rootDir);
-  config.lastSeenVersion = version;
-  saveUpdateConfig(rootDir, config);
-}
-
-// CLI interface
-async function main() {
-  const args = process.argv.slice(2);
-  const jsonOutput = args.includes('--json');
-  const markSeen = args.includes('--mark-seen');
-
-  if (markSeen) {
-    const version = args[args.indexOf('--mark-seen') + 1];
-    if (version) {
-      markVersionSeen(version);
-      if (jsonOutput) {
-        console.log(JSON.stringify({ success: true, version }));
-      } else {
-        console.log(`Marked version ${version} as seen`);
-      }
-    }
-    return;
-  }
-
-  const result = await checkForUpdates();
-
-  if (jsonOutput) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    if (result.error) {
-      console.log(`Error: ${result.error}`);
-    } else if (result.justUpdated) {
-      console.log(`Updated from v${result.previousVersion} to v${result.installed}`);
-    } else if (result.updateAvailable) {
-      console.log(`Update available: v${result.installed} -> v${result.latest}`);
-      console.log(`Run: npx agileflow update`);
-    } else {
-      console.log(`AgileFlow v${result.installed} is up to date`);
-    }
-  }
-}
-
-// Export for use as module
-module.exports = {
-  checkForUpdates,
-  markVersionSeen,
-  getUpdateConfig,
-  saveUpdateConfig,
-  compareVersions,
-};
-
-// Run CLI if executed directly
-if (require.main === module) {
-  main().catch(console.error);
-}

package/scripts/ci-summary.js

@@ -1,294 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AgileFlow CLI - CI Summary Script
- *
- * Summarizes CI/CD workflow failures from the past 24 hours.
- * Uses GitHub CLI (gh) to fetch workflow run data.
- *
- * Usage:
- *   node scripts/ci-summary.js [options]
- *
- * Options:
- *   --json         Output results as JSON
- *   --hours=N      Look back N hours (default: 24)
- *   --quiet        Only show failures
- *   --help         Show help
- */
-
-const { execFileSync } = require('child_process');
-const path = require('path');
-
-// ANSI colors
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  cyan: '\x1b[36m',
-};
-
-/**
- * Parse command line arguments
- */
-function parseArgs(args) {
-  const options = {
-    json: false,
-    hours: 24,
-    quiet: false,
-    help: false,
-  };
-
-  for (const arg of args) {
-    if (arg === '--json') options.json = true;
-    else if (arg === '--quiet') options.quiet = true;
-    else if (arg === '--help' || arg === '-h') options.help = true;
-    else if (arg.startsWith('--hours=')) {
-      const hours = parseInt(arg.split('=')[1], 10);
-      if (!isNaN(hours) && hours > 0) {
-        options.hours = hours;
-      }
-    }
-  }
-
-  return options;
-}
-
-/**
- * Show help message
- */
-function showHelp() {
-  console.log(`
-${c.bold}AgileFlow CI Summary${c.reset}
-
-${c.cyan}Usage:${c.reset}
-  node scripts/ci-summary.js [options]
-
-${c.cyan}Options:${c.reset}
-  --json         Output results as JSON
-  --hours=N      Look back N hours (default: 24)
-  --quiet        Only show failures
-  --help, -h     Show this help message
-`);
-}
-
-/**
- * Check if gh CLI is available
- */
-function hasGhCli() {
-  try {
-    execFileSync('gh', ['--version'], { stdio: 'pipe' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Check if we're in a git repo with a GitHub remote
- */
-function hasGitHubRemote() {
-  try {
-    const remote = execFileSync('git', ['remote', 'get-url', 'origin'], {
-      stdio: 'pipe',
-      encoding: 'utf8',
-    }).trim();
-    return remote.includes('github.com');
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Fetch workflow runs from GitHub
- */
-function fetchWorkflowRuns(hours) {
-  try {
-    const output = execFileSync(
-      'gh',
-      [
-        'run',
-        'list',
-        '--limit',
-        '50',
-        '--json',
-        'databaseId,name,status,conclusion,createdAt,headBranch,event,url',
-      ],
-      { stdio: 'pipe', encoding: 'utf8', timeout: 30000 }
-    );
-
-    const runs = JSON.parse(output);
-    const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000);
-
-    return runs.filter(run => new Date(run.createdAt) >= cutoff);
-  } catch (e) {
-    throw new Error(`Failed to fetch workflow runs: ${e.message}`);
-  }
-}
-
-/**
- * Generate summary from runs
- */
-function generateSummary(runs, hours) {
-  const summary = {
-    period_hours: hours,
-    total: runs.length,
-    successful: 0,
-    failed: 0,
-    cancelled: 0,
-    in_progress: 0,
-    failures: [],
-    workflows: {},
-  };
-
-  for (const run of runs) {
-    const workflowName = run.name || 'Unknown';
-
-    if (!summary.workflows[workflowName]) {
-      summary.workflows[workflowName] = { total: 0, passed: 0, failed: 0 };
-    }
-    summary.workflows[workflowName].total++;
-
-    if (run.conclusion === 'success') {
-      summary.successful++;
-      summary.workflows[workflowName].passed++;
-    } else if (run.conclusion === 'failure') {
-      summary.failed++;
-      summary.workflows[workflowName].failed++;
-      summary.failures.push({
-        workflow: workflowName,
-        branch: run.headBranch,
-        event: run.event,
-        created: run.createdAt,
-        url: run.url,
-      });
-    } else if (run.conclusion === 'cancelled') {
-      summary.cancelled++;
-    } else if (run.status === 'in_progress' || run.status === 'queued') {
-      summary.in_progress++;
-    }
-  }
-
-  return summary;
-}
-
-/**
- * Format summary for console output
- */
-function formatSummary(summary, quiet) {
-  const lines = [];
-
-  if (!quiet) {
-    lines.push(`${c.bold}CI Summary (last ${summary.period_hours}h)${c.reset}`);
-    lines.push('');
-  }
-
-  if (summary.total === 0) {
-    lines.push(`${c.dim}No workflow runs in the past ${summary.period_hours} hours.${c.reset}`);
-    return lines.join('\n');
-  }
-
-  if (!quiet) {
-    lines.push(`  Total runs:   ${summary.total}`);
-    lines.push(`  ${c.green}Successful:${c.reset}  ${summary.successful}`);
-    if (summary.failed > 0) {
-      lines.push(`  ${c.red}Failed:${c.reset}      ${summary.failed}`);
-    }
-    if (summary.cancelled > 0) {
-      lines.push(`  ${c.yellow}Cancelled:${c.reset}   ${summary.cancelled}`);
-    }
-    if (summary.in_progress > 0) {
-      lines.push(`  ${c.cyan}In progress:${c.reset} ${summary.in_progress}`);
-    }
-    lines.push('');
-  }
-
-  // Show failures
-  if (summary.failures.length > 0) {
-    lines.push(`${c.red}${c.bold}Failures:${c.reset}`);
-    for (const failure of summary.failures) {
-      lines.push(
-        `  ${c.red}x${c.reset} ${failure.workflow} ${c.dim}(${failure.branch}, ${failure.event})${c.reset}`
-      );
-      if (failure.url) {
-        lines.push(`    ${c.dim}${failure.url}${c.reset}`);
-      }
-    }
-    lines.push('');
-  }
-
-  // Workflow breakdown (non-quiet)
-  if (!quiet) {
-    const workflowNames = Object.keys(summary.workflows);
-    if (workflowNames.length > 0) {
-      lines.push(`${c.bold}Workflows:${c.reset}`);
-      for (const name of workflowNames) {
-        const w = summary.workflows[name];
-        const status = w.failed > 0 ? c.red : c.green;
-        lines.push(`  ${status}${name}${c.reset}: ${w.passed}/${w.total} passed`);
-      }
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Main entry point
- */
-function main() {
-  const options = parseArgs(process.argv.slice(2));
-
-  if (options.help) {
-    showHelp();
-    process.exit(0);
-  }
-
-  // Pre-flight checks
-  if (!hasGhCli()) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: 'GitHub CLI (gh) not installed', runs: [] }));
-    } else {
-      console.log(
-        `${c.dim}CI Summary: GitHub CLI (gh) not available. Install from https://cli.github.com/${c.reset}`
-      );
-    }
-    process.exit(0);
-  }
-
-  if (!hasGitHubRemote()) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: 'No GitHub remote found', runs: [] }));
-    } else {
-      console.log(`${c.dim}CI Summary: No GitHub remote detected. Skipping.${c.reset}`);
-    }
-    process.exit(0);
-  }
-
-  // Fetch and summarize
-  try {
-    const runs = fetchWorkflowRuns(options.hours);
-    const summary = generateSummary(runs, options.hours);
-
-    if (options.json) {
-      console.log(JSON.stringify(summary, null, 2));
-    } else {
-      console.log(formatSummary(summary, options.quiet));
-    }
-
-    // Always exit 0 when summary was generated successfully.
-    // The automation runner treats non-zero as script failure.
-    process.exit(0);
-  } catch (e) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: e.message, runs: [] }));
-    } else {
-      console.error(`${c.red}CI Summary error:${c.reset} ${e.message}`);
-    }
-    process.exit(1);
-  }
-}
-
-main();