@girardmedia/bootspring 1.2.0 → 2.0.3

package/cli/github-cmd.js

@@ -0,0 +1,435 @@
+/**
+ * Bootspring GitHub Command
+ * Manage GitHub integration
+ *
+ * Commands:
+ *   connect [--url]     Connect to a GitHub repository
+ *   sync                Sync latest commits, PRs, and stats
+ *   status              Show connection status and recent activity
+ *   disconnect          Remove GitHub connection
+ *   activity            Show recent repository activity
+ *
+ * @package bootspring
+ * @command github
+ */
+
+const config = require('../core/config');
+const utils = require('../core/utils');
+const githubSync = require('../core/github-sync');
+const projectState = require('../core/project-state');
+const telemetry = require('../core/telemetry');
+
+// ============================================================================
+// Command Handlers
+// ============================================================================
+
+/**
+ * Connect to a GitHub repository
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ */
+function handleConnect(projectRoot, options = {}) {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ GitHub Connection${utils.COLORS.reset}
+`);
+
+  // Check gh CLI
+  if (!githubSync.isGhInstalled()) {
+    utils.print.error('GitHub CLI (gh) is not installed.');
+    console.log(`
+${utils.COLORS.bold}To install gh CLI:${utils.COLORS.reset}
+  macOS:   brew install gh
+  Windows: winget install GitHub.cli
+  Linux:   See https://cli.github.com/
+
+${utils.COLORS.dim}Or visit: https://cli.github.com/${utils.COLORS.reset}
+`);
+    return;
+  }
+
+  if (!githubSync.isGhAuthenticated()) {
+    utils.print.error('GitHub CLI is not authenticated.');
+    console.log(`
+${utils.COLORS.bold}To authenticate:${utils.COLORS.reset}
+  gh auth login
+
+${utils.COLORS.dim}Follow the prompts to authenticate with GitHub.${utils.COLORS.reset}
+`);
+    return;
+  }
+
+  // Try to connect
+  const spinner = utils.createSpinner('Connecting to GitHub...');
+  spinner.start();
+
+  const result = githubSync.connectRepository(projectRoot, {
+    url: options.url
+  });
+
+  if (!result.success) {
+    spinner.fail(`Connection failed: ${result.error}`);
+    return;
+  }
+
+  spinner.succeed('Connected to GitHub!');
+
+  console.log(`
+${utils.COLORS.bold}Repository:${utils.COLORS.reset} ${result.owner}/${result.repo}
+${utils.COLORS.bold}URL:${utils.COLORS.reset} ${result.url}
+${utils.COLORS.bold}Branch:${utils.COLORS.reset} ${result.defaultBranch}
+${result.isPrivate ? `${utils.COLORS.dim}(Private repository)${utils.COLORS.reset}` : ''}
+${result.description ? `${utils.COLORS.dim}${result.description}${utils.COLORS.reset}` : ''}
+`);
+
+  if (result.stats) {
+    console.log(`${utils.COLORS.bold}Statistics:${utils.COLORS.reset}`);
+    console.log(`  Commits: ${result.stats.totalCommits || 'N/A'}`);
+    console.log(`  Open PRs: ${result.stats.openPRs || 0}`);
+    console.log(`  Contributors: ${result.stats.contributors || 'N/A'}`);
+
+    if (result.stats.lastCommitMessage) {
+      console.log(`\n${utils.COLORS.bold}Latest Commit:${utils.COLORS.reset}`);
+      console.log(`  ${utils.COLORS.dim}${result.stats.lastCommitSha}${utils.COLORS.reset} ${result.stats.lastCommitMessage}`);
+    }
+  }
+
+  console.log();
+
+  // Emit telemetry
+  telemetry.emitEvent('github:connect', {
+    owner: result.owner,
+    repo: result.repo,
+    isPrivate: result.isPrivate
+  }, { projectRoot });
+}
+
+/**
+ * Sync GitHub data
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ */
+function handleSync(projectRoot, options = {}) {
+  const status = githubSync.getStatus(projectRoot);
+
+  if (!status.connected) {
+    utils.print.error('GitHub not connected.');
+    utils.print.dim('Run: bootspring github connect');
+    return;
+  }
+
+  const spinner = utils.createSpinner(`Syncing ${status.owner}/${status.repo}...`);
+  spinner.start();
+
+  const result = githubSync.syncGitHubData(projectRoot);
+
+  if (!result.success) {
+    spinner.fail(`Sync failed: ${result.error}`);
+    return;
+  }
+
+  spinner.succeed('Synced GitHub data!');
+
+  if (options.json) {
+    console.log(JSON.stringify(result.stats, null, 2));
+    return;
+  }
+
+  console.log(`
+${utils.COLORS.bold}Statistics:${utils.COLORS.reset}
+  Commits: ${result.stats.totalCommits}
+  Open PRs: ${result.stats.openPRs}
+  Closed PRs: ${result.stats.closedPRs}
+  Contributors: ${result.stats.contributors}
+`);
+
+  if (result.stats.lastCommitMessage) {
+    console.log(`${utils.COLORS.bold}Latest Commit:${utils.COLORS.reset}`);
+    console.log(`  ${utils.COLORS.dim}${result.stats.lastCommitSha}${utils.COLORS.reset} ${result.stats.lastCommitMessage}`);
+    if (result.stats.lastCommit) {
+      const date = new Date(result.stats.lastCommit);
+      console.log(`  ${utils.COLORS.dim}${utils.formatRelativeTime(date)}${utils.COLORS.reset}`);
+    }
+    console.log();
+  }
+
+  // Emit telemetry
+  telemetry.emitEvent('github:sync', {
+    owner: status.owner,
+    repo: status.repo,
+    stats: result.stats
+  }, { projectRoot });
+}
+
+/**
+ * Show GitHub status
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ */
+function handleStatus(projectRoot, options = {}) {
+  const status = githubSync.getStatus(projectRoot);
+
+  // JSON output
+  if (options.json) {
+    console.log(JSON.stringify(status, null, 2));
+    return;
+  }
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ GitHub Status${utils.COLORS.reset}
+`);
+
+  // CLI status
+  console.log(`${utils.COLORS.bold}GitHub CLI:${utils.COLORS.reset}`);
+  console.log(`  ${status.ghInstalled ? `${utils.COLORS.green}✓${utils.COLORS.reset}` : `${utils.COLORS.red}✗${utils.COLORS.reset}`} Installed`);
+  console.log(`  ${status.ghAuthenticated ? `${utils.COLORS.green}✓${utils.COLORS.reset}` : `${utils.COLORS.red}✗${utils.COLORS.reset}`} Authenticated`);
+  console.log();
+
+  if (!status.connected) {
+    console.log(`${utils.COLORS.bold}Connection:${utils.COLORS.reset} ${utils.COLORS.dim}Not connected${utils.COLORS.reset}`);
+
+    if (status.detected) {
+      console.log(`\n${utils.COLORS.bold}Detected Repository:${utils.COLORS.reset}`);
+      console.log(`  ${status.detected.owner}/${status.detected.repo}`);
+      console.log(`\n${utils.COLORS.bold}To connect:${utils.COLORS.reset}`);
+      console.log('  bootspring github connect');
+    } else {
+      console.log(`\n${utils.COLORS.bold}To connect:${utils.COLORS.reset}`);
+      console.log('  bootspring github connect --url https://github.com/owner/repo');
+    }
+    console.log();
+    return;
+  }
+
+  // Connected status
+  console.log(`${utils.COLORS.bold}Connection:${utils.COLORS.reset} ${utils.COLORS.green}✓ Connected${utils.COLORS.reset}`);
+  console.log(`${utils.COLORS.bold}Repository:${utils.COLORS.reset} ${status.owner}/${status.repo}`);
+  console.log(`${utils.COLORS.bold}URL:${utils.COLORS.reset} ${status.repositoryUrl}`);
+  console.log(`${utils.COLORS.bold}Branch:${utils.COLORS.reset} ${status.defaultBranch}`);
+
+  if (status.lastSync) {
+    const syncDate = new Date(status.lastSync);
+    console.log(`${utils.COLORS.bold}Last Sync:${utils.COLORS.reset} ${utils.formatRelativeTime(syncDate)}`);
+  }
+
+  console.log();
+
+  // Statistics
+  if (status.stats) {
+    console.log(`${utils.COLORS.bold}Statistics:${utils.COLORS.reset}`);
+    console.log(`  Commits: ${status.stats.totalCommits}`);
+    console.log(`  Open PRs: ${status.stats.openPRs}`);
+    console.log(`  Closed PRs: ${status.stats.closedPRs}`);
+    console.log(`  Contributors: ${status.stats.contributors}`);
+    console.log();
+
+    if (status.stats.lastCommitMessage) {
+      console.log(`${utils.COLORS.bold}Latest Commit:${utils.COLORS.reset}`);
+      console.log(`  ${utils.COLORS.dim}${status.stats.lastCommitSha}${utils.COLORS.reset} ${status.stats.lastCommitMessage}`);
+      if (status.stats.lastCommit) {
+        const date = new Date(status.stats.lastCommit);
+        console.log(`  ${utils.COLORS.dim}${utils.formatRelativeTime(date)}${utils.COLORS.reset}`);
+      }
+      console.log();
+    }
+  }
+
+  console.log(`${utils.COLORS.bold}Commands:${utils.COLORS.reset}`);
+  console.log('  bootspring github sync       Refresh data');
+  console.log('  bootspring github activity   View recent activity');
+  console.log('  bootspring github disconnect Remove connection');
+  console.log();
+}
+
+/**
+ * Disconnect from GitHub
+ * @param {string} projectRoot - Project root directory
+ */
+function handleDisconnect(projectRoot) {
+  const status = githubSync.getStatus(projectRoot);
+
+  if (!status.connected) {
+    utils.print.warning('GitHub is not connected.');
+    return;
+  }
+
+  const result = githubSync.disconnectRepository(projectRoot);
+
+  if (result.success) {
+    utils.print.success(`Disconnected from ${status.owner}/${status.repo}`);
+
+    // Emit telemetry
+    telemetry.emitEvent('github:disconnect', {
+      owner: status.owner,
+      repo: status.repo
+    }, { projectRoot });
+  } else {
+    utils.print.error(`Failed to disconnect: ${result.error}`);
+  }
+}
+
+/**
+ * Show recent activity
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ */
+function handleActivity(projectRoot, options = {}) {
+  const status = githubSync.getStatus(projectRoot);
+
+  if (!status.connected) {
+    utils.print.error('GitHub not connected.');
+    utils.print.dim('Run: bootspring github connect');
+    return;
+  }
+
+  const limit = options.limit || 10;
+
+  const spinner = utils.createSpinner('Fetching recent activity...');
+  spinner.start();
+
+  const activity = githubSync.getRecentActivity(status.owner, status.repo, limit);
+
+  spinner.stop();
+
+  if (!activity || activity.length === 0) {
+    utils.print.warning('No recent activity found.');
+    return;
+  }
+
+  // JSON output
+  if (options.json) {
+    console.log(JSON.stringify(activity, null, 2));
+    return;
+  }
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Recent Activity${utils.COLORS.reset}
+${utils.COLORS.dim}${status.owner}/${status.repo}${utils.COLORS.reset}
+`);
+
+  for (const item of activity) {
+    const date = new Date(item.date);
+    const relativeTime = utils.formatRelativeTime(date);
+
+    if (item.type === 'commit') {
+      console.log(`  ${utils.COLORS.cyan}●${utils.COLORS.reset} ${utils.COLORS.dim}${item.sha}${utils.COLORS.reset} ${item.message}`);
+      console.log(`    ${utils.COLORS.dim}${item.author} · ${relativeTime}${utils.COLORS.reset}`);
+    } else if (item.type === 'pr') {
+      const stateIcon = item.state === 'open'
+        ? `${utils.COLORS.green}○${utils.COLORS.reset}`
+        : `${utils.COLORS.magenta}●${utils.COLORS.reset}`;
+      console.log(`  ${stateIcon} PR #${item.number}: ${item.title}`);
+      console.log(`    ${utils.COLORS.dim}${item.author} · ${item.state} · ${relativeTime}${utils.COLORS.reset}`);
+    }
+    console.log();
+  }
+}
+
+/**
+ * Show help
+ */
+function showHelp() {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring GitHub${utils.COLORS.reset}
+${utils.COLORS.dim}Manage GitHub integration${utils.COLORS.reset}
+
+${utils.COLORS.bold}Usage:${utils.COLORS.reset}
+  bootspring github [command] [options]
+
+${utils.COLORS.bold}Commands:${utils.COLORS.reset}
+  connect              Connect to a GitHub repository
+  sync                 Sync latest commits, PRs, and stats
+  status               Show connection status (default)
+  activity             Show recent repository activity
+  disconnect           Remove GitHub connection
+
+${utils.COLORS.bold}Options:${utils.COLORS.reset}
+  --url=<url>          Specify repository URL for connect
+  --json               Output as JSON
+  --limit=<n>          Limit results for activity
+
+${utils.COLORS.bold}Examples:${utils.COLORS.reset}
+  bootspring github connect                              # Auto-detect from git
+  bootspring github connect --url https://github.com/user/repo
+  bootspring github sync                                 # Refresh data
+  bootspring github activity --limit=5                   # Recent activity
+
+${utils.COLORS.bold}Requirements:${utils.COLORS.reset}
+  - GitHub CLI (gh) must be installed: https://cli.github.com/
+  - Must be authenticated: gh auth login
+`);
+}
+
+// ============================================================================
+// Main Runner
+// ============================================================================
+
+/**
+ * Run github command
+ * @param {Array} args - Command arguments
+ */
+async function run(args) {
+  const cfg = config.load();
+  const projectRoot = cfg._projectRoot;
+
+  // Parse arguments
+  const parsed = utils.parseArgs(args);
+  const subcommand = parsed._[0] || 'status';
+  const options = {
+    url: parsed.url || null,
+    json: parsed.json || false,
+    limit: parseInt(parsed.limit) || 10
+  };
+
+  switch (subcommand) {
+    case 'connect':
+    case 'c':
+      handleConnect(projectRoot, options);
+      break;
+
+    case 'sync':
+    case 's':
+      handleSync(projectRoot, options);
+      break;
+
+    case 'status':
+    case 'st':
+      handleStatus(projectRoot, options);
+      break;
+
+    case 'disconnect':
+    case 'd':
+    case 'remove':
+      handleDisconnect(projectRoot);
+      break;
+
+    case 'activity':
+    case 'log':
+    case 'a':
+      handleActivity(projectRoot, options);
+      break;
+
+    case 'help':
+    case '-h':
+    case '--help':
+      showHelp();
+      break;
+
+    default:
+      utils.print.error(`Unknown subcommand: ${subcommand}`);
+      showHelp();
+  }
+}
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+module.exports = {
+  run,
+  // Utility exports
+  handleConnect,
+  handleSync,
+  handleStatus,
+  handleDisconnect,
+  handleActivity
+};