@girardmedia/bootspring 2.0.21 → 2.0.23

package/src/cli/github-cmd.ts

@@ -0,0 +1,566 @@
+/**
+ * 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
+ */
+
+// Type interfaces for JS modules
+interface Colors {
+  reset: string;
+  bold: string;
+  dim: string;
+  cyan: string;
+  green: string;
+  yellow: string;
+  red: string;
+  magenta: string;
+}
+
+interface PrintModule {
+  error(msg: string): void;
+  dim(msg: string): void;
+  warning(msg: string): void;
+  success(msg: string): void;
+}
+
+interface Spinner {
+  start(): Spinner;
+  stop(): void;
+  succeed(text: string): void;
+  fail(text: string): void;
+}
+
+interface ParsedArgs {
+  _: string[];
+  url?: string | undefined;
+  json?: boolean | undefined;
+  limit?: string | undefined;
+}
+
+interface UtilsModule {
+  COLORS: Colors;
+  print: PrintModule;
+  createSpinner(text: string): Spinner;
+  parseArgs(args: string[]): ParsedArgs;
+  formatRelativeTime(date: Date): string;
+}
+
+interface ConfigModule {
+  load(): LoadedConfig;
+}
+
+interface LoadedConfig {
+  _projectRoot: string;
+}
+
+interface GitHubStats {
+  totalCommits: number | string;
+  openPRs: number;
+  closedPRs?: number | undefined;
+  contributors: number | string;
+  lastCommit?: string | undefined;
+  lastCommitSha?: string | undefined;
+  lastCommitMessage?: string | undefined;
+}
+
+interface ConnectResult {
+  success: boolean;
+  error?: string | undefined;
+  owner?: string | undefined;
+  repo?: string | undefined;
+  url?: string | undefined;
+  defaultBranch?: string | undefined;
+  isPrivate?: boolean | undefined;
+  description?: string | undefined;
+  stats?: GitHubStats | undefined;
+}
+
+interface SyncResult {
+  success: boolean;
+  error?: string | undefined;
+  stats: GitHubStats;
+}
+
+interface DisconnectResult {
+  success: boolean;
+  error?: string | undefined;
+}
+
+interface DetectedRepo {
+  owner: string;
+  repo: string;
+}
+
+interface GitHubStatus {
+  ghInstalled: boolean;
+  ghAuthenticated: boolean;
+  connected: boolean;
+  owner?: string | undefined;
+  repo?: string | undefined;
+  repositoryUrl?: string | undefined;
+  defaultBranch?: string | undefined;
+  lastSync?: string | undefined;
+  stats?: GitHubStats | undefined;
+  detected?: DetectedRepo | undefined;
+}
+
+interface ActivityItem {
+  type: 'commit' | 'pr';
+  date: string;
+  sha?: string | undefined;
+  message?: string | undefined;
+  author?: string | undefined;
+  number?: number | undefined;
+  title?: string | undefined;
+  state?: string | undefined;
+}
+
+interface GitHubSyncModule {
+  isGhInstalled(): boolean;
+  isGhAuthenticated(): boolean;
+  connectRepository(projectRoot: string, options: { url?: string | null | undefined }): ConnectResult;
+  syncGitHubData(projectRoot: string): SyncResult;
+  getStatus(projectRoot: string): GitHubStatus;
+  disconnectRepository(projectRoot: string): DisconnectResult;
+  getRecentActivity(owner: string, repo: string, limit: number): ActivityItem[];
+}
+
+interface TelemetryModule {
+  emitEvent(event: string, data: Record<string, unknown>, options: { projectRoot: string }): void;
+}
+
+const config = require('../core/config') as ConfigModule;
+const utils = require('../core/utils') as UtilsModule;
+const githubSync = require('../core/github-sync') as GitHubSyncModule;
+const telemetry = require('../core/telemetry') as TelemetryModule;
+
+// ============================================================================
+// Command Handlers
+// ============================================================================
+
+interface ConnectOptions {
+  url?: string | null | undefined;
+}
+
+/**
+ * Connect to a GitHub repository
+ */
+function handleConnect(projectRoot: string, options: ConnectOptions = {}): void {
+  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 });
+}
+
+interface SyncOptions {
+  json?: boolean | undefined;
+}
+
+/**
+ * Sync GitHub data
+ */
+function handleSync(projectRoot: string, options: SyncOptions = {}): void {
+  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 });
+}
+
+interface StatusOptions {
+  json?: boolean | undefined;
+}
+
+/**
+ * Show GitHub status
+ */
+function handleStatus(projectRoot: string, options: StatusOptions = {}): void {
+  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
+ */
+function handleDisconnect(projectRoot: string): void {
+  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}`);
+  }
+}
+
+interface ActivityOptions {
+  limit?: number | undefined;
+  json?: boolean | undefined;
+}
+
+/**
+ * Show recent activity
+ */
+function handleActivity(projectRoot: string, options: ActivityOptions = {}): void {
+  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 owner = status.owner || '';
+  const repo = status.repo || '';
+  const activity = githubSync.getRecentActivity(owner, 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(): void {
+  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
+ */
+export async function run(args: string[]): Promise<void> {
+  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', 10) || 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
+// ============================================================================
+
+export {
+  handleConnect,
+  handleSync,
+  handleStatus,
+  handleDisconnect,
+  handleActivity
+};