@girardmedia/bootspring 2.0.21 → 2.0.22

package/src/core/github-sync.ts

@@ -0,0 +1,720 @@
+/**
+ * Bootspring GitHub Sync
+ * Fetch GitHub repository data using gh CLI
+ *
+ * @package bootspring
+ * @module core/github-sync
+ */
+
+import { execSync, exec } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as utils from './utils';
+import * as projectState from './project-state';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface RepositoryInfo {
+  owner: string;
+  repo: string;
+  url: string;
+}
+
+export interface RepositoryMetadata {
+  name: string;
+  description?: string | undefined;
+  defaultBranchRef?: { name: string } | undefined;
+  url: string;
+  createdAt?: string | undefined;
+  updatedAt?: string | undefined;
+  stargazerCount?: number | undefined;
+  forkCount?: number | undefined;
+  isPrivate?: boolean | undefined;
+}
+
+export interface CommitStats {
+  totalCommits: number;
+  lastCommit: string | null;
+  lastCommitMessage: string | null;
+  lastCommitAuthor: string | null;
+  lastCommitSha?: string | null | undefined;
+}
+
+export interface PrStats {
+  openPRs: number;
+  closedPRs: number;
+}
+
+export interface ActivityItem {
+  type: 'commit' | 'pr';
+  message?: string | undefined;
+  author?: string | undefined;
+  date?: string | undefined;
+  sha?: string | undefined;
+  number?: number | undefined;
+  title?: string | undefined;
+  state?: string | undefined;
+}
+
+export interface GhCommandOptions {
+  cwd?: string | undefined;
+  timeout?: number | undefined;
+  parseJson?: boolean | undefined;
+}
+
+export interface SyncResult {
+  success: boolean;
+  stats?: GitHubStats | undefined;
+  error?: string | undefined;
+}
+
+export interface GitHubStats {
+  totalCommits: number;
+  openPRs: number;
+  closedPRs: number;
+  contributors: number;
+  lastCommit: string | null;
+  lastCommitMessage: string | null;
+  lastCommitSha?: string | null | undefined;
+}
+
+export interface ConnectResult {
+  success: boolean;
+  owner?: string | undefined;
+  repo?: string | undefined;
+  url?: string | undefined;
+  defaultBranch?: string | undefined;
+  description?: string | undefined;
+  isPrivate?: boolean | undefined;
+  stats?: GitHubStats | undefined;
+  error?: string | undefined;
+}
+
+export interface DisconnectResult {
+  success: boolean;
+  error?: string | undefined;
+}
+
+export interface ConnectOptions {
+  url?: string | undefined;
+}
+
+export interface SyncOptions {
+  spinner?: { start: () => void; stop: () => void } | undefined;
+}
+
+export interface SyncMetadata {
+  lastSync: string;
+  commitStats: CommitStats;
+  prStats: PrStats;
+  contributors: number;
+}
+
+export interface GitHubStatus {
+  connected: boolean;
+  ghInstalled?: boolean | undefined;
+  ghAuthenticated?: boolean | undefined;
+  detected?: RepositoryInfo | null | undefined;
+  repositoryUrl?: string | undefined;
+  owner?: string | undefined;
+  repo?: string | undefined;
+  defaultBranch?: string | undefined;
+  lastSync?: string | undefined;
+  stats?: GitHubStats | undefined;
+  syncMetadata?: SyncMetadata | null | undefined;
+}
+
+// ============================================================================
+// gh CLI Utilities
+// ============================================================================
+
+/**
+ * Check if gh CLI is installed
+ */
+export function isGhInstalled(): boolean {
+  try {
+    execSync('gh --version', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if gh CLI is authenticated
+ */
+export function isGhAuthenticated(): boolean {
+  try {
+    const result = execSync('gh auth status', { stdio: 'pipe', encoding: 'utf-8' });
+    return !result.includes('not logged');
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Execute gh command and return parsed JSON
+ */
+export function ghCommand<T = unknown>(command: string, options: GhCommandOptions = {}): T | null {
+  try {
+    const result = execSync(`gh ${command}`, {
+      cwd: options.cwd || process.cwd(),
+      encoding: 'utf-8',
+      timeout: options.timeout || 30000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return options.parseJson !== false ? JSON.parse(result) as T : result.trim() as unknown as T;
+  } catch (error) {
+    const err = error as Error;
+    utils.print.debug(`gh command failed: ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Execute gh command asynchronously
+ */
+export function ghCommandAsync<T = unknown>(command: string, options: GhCommandOptions = {}): Promise<T | null> {
+  return new Promise((resolve) => {
+    exec(`gh ${command}`, {
+      cwd: options.cwd || process.cwd(),
+      timeout: options.timeout || 30000
+    }, (error, stdout) => {
+      if (error) {
+        utils.print.debug(`gh command failed: ${error.message}`);
+        resolve(null);
+        return;
+      }
+      try {
+        resolve(options.parseJson !== false ? JSON.parse(stdout) as T : stdout.trim() as unknown as T);
+      } catch {
+        resolve(null);
+      }
+    });
+  });
+}
+
+// ============================================================================
+// Repository Detection
+// ============================================================================
+
+/**
+ * Detect GitHub repository from git remote
+ */
+export function detectRepository(projectRoot: string): RepositoryInfo | null {
+  try {
+    const result = execSync('git remote get-url origin', {
+      cwd: projectRoot,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim();
+
+    // Parse GitHub URL (SSH or HTTPS)
+    // HTTPS: https://github.com/owner/repo.git
+    // SSH: git@github.com:owner/repo.git
+    let match: RegExpMatchArray | null = null;
+
+    if (result.startsWith('https://')) {
+      match = result.match(/github\.com\/([^/]+)\/([^/.]+)/);
+    } else if (result.includes('github.com')) {
+      match = result.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
+    }
+
+    if (match && match[1] && match[2]) {
+      const owner = match[1];
+      const repo = match[2].replace('.git', '');
+      return {
+        owner,
+        repo,
+        url: `https://github.com/${owner}/${repo}`
+      };
+    }
+  } catch {
+    // Not a git repo or no remote
+  }
+
+  return null;
+}
+
+/**
+ * Get default branch name
+ */
+export function getDefaultBranch(projectRoot: string): string {
+  try {
+    // Try to get from remote
+    const result = execSync('git remote show origin | grep "HEAD branch"', {
+      cwd: projectRoot,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    const match = result.match(/HEAD branch:\s*(\S+)/);
+    if (match && match[1]) {
+      return match[1];
+    }
+  } catch {
+    // Fall back to checking common branch names
+  }
+
+  // Check if main or master exists
+  try {
+    execSync('git rev-parse --verify main', { cwd: projectRoot, stdio: 'pipe' });
+    return 'main';
+  } catch {
+    try {
+      execSync('git rev-parse --verify master', { cwd: projectRoot, stdio: 'pipe' });
+      return 'master';
+    } catch {
+      return 'main';
+    }
+  }
+}
+
+// ============================================================================
+// Repository Data Fetching
+// ============================================================================
+
+/**
+ * Get repository metadata
+ */
+export function getRepositoryInfo(owner: string, repo: string): RepositoryMetadata | null {
+  return ghCommand<RepositoryMetadata>(
+    `repo view ${owner}/${repo} --json name,description,defaultBranchRef,url,createdAt,updatedAt,stargazerCount,forkCount,isPrivate`
+  );
+}
+
+/**
+ * Get commit statistics
+ */
+export function getCommitStats(owner: string, repo: string, options: { limit?: number } = {}): CommitStats {
+  const limit = options.limit || 100;
+
+  // Get recent commits
+  interface CommitData {
+    sha?: string;
+    commit?: {
+      committer?: { date?: string };
+      message?: string;
+      author?: { name?: string };
+    };
+  }
+  const commits = ghCommand<CommitData[]>(`api repos/${owner}/${repo}/commits?per_page=${limit}`, { parseJson: true });
+
+  if (!commits) {
+    return {
+      totalCommits: 0,
+      lastCommit: null,
+      lastCommitMessage: null,
+      lastCommitAuthor: null
+    };
+  }
+
+  const latest = commits[0];
+
+  return {
+    totalCommits: commits.length, // Note: This is limited to what we fetch
+    lastCommit: latest?.commit?.committer?.date || null,
+    lastCommitMessage: latest?.commit?.message?.split('\n')[0] || null,
+    lastCommitAuthor: latest?.commit?.author?.name || null,
+    lastCommitSha: latest?.sha?.substring(0, 7) || null
+  };
+}
+
+/**
+ * Get pull request statistics
+ */
+export function getPRStats(owner: string, repo: string): PrStats {
+  // Get open PRs
+  interface PrData {
+    number: number;
+  }
+  const openPRs = ghCommand<PrData[]>(`pr list --repo ${owner}/${repo} --state open --json number`, { parseJson: true });
+
+  // Get recently closed PRs
+  const closedPRs = ghCommand<PrData[]>(`pr list --repo ${owner}/${repo} --state closed --limit 50 --json number`, { parseJson: true });
+
+  return {
+    openPRs: openPRs?.length || 0,
+    closedPRs: closedPRs?.length || 0
+  };
+}
+
+/**
+ * Get contributor count
+ */
+export function getContributorCount(owner: string, repo: string): number {
+  interface ContributorData {
+    login: string;
+  }
+  const contributors = ghCommand<ContributorData[]>(`api repos/${owner}/${repo}/contributors?per_page=100`, { parseJson: true });
+  return contributors?.length || 0;
+}
+
+/**
+ * Get recent activity (commits + PRs)
+ */
+export function getRecentActivity(owner: string, repo: string, limit: number = 10): ActivityItem[] {
+  const activity: ActivityItem[] = [];
+
+  // Get recent commits
+  interface CommitData {
+    sha?: string;
+    commit?: {
+      committer?: { date?: string };
+      message?: string;
+      author?: { name?: string };
+    };
+  }
+  const commits = ghCommand<CommitData[]>(`api repos/${owner}/${repo}/commits?per_page=${limit}`, { parseJson: true });
+  if (commits) {
+    for (const commit of commits.slice(0, 5)) {
+      activity.push({
+        type: 'commit',
+        message: commit.commit?.message?.split('\n')[0],
+        author: commit.commit?.author?.name,
+        date: commit.commit?.committer?.date,
+        sha: commit.sha?.substring(0, 7)
+      });
+    }
+  }
+
+  // Get recent PRs
+  interface PrData {
+    number: number;
+    title: string;
+    author?: { login: string };
+    state: string;
+    createdAt: string;
+  }
+  const prs = ghCommand<PrData[]>(`pr list --repo ${owner}/${repo} --state all --limit 5 --json number,title,author,state,createdAt`, { parseJson: true });
+  if (prs) {
+    for (const pr of prs) {
+      activity.push({
+        type: 'pr',
+        number: pr.number,
+        title: pr.title,
+        author: pr.author?.login,
+        state: pr.state,
+        date: pr.createdAt
+      });
+    }
+  }
+
+  // Sort by date
+  activity.sort((a, b) => new Date(b.date || 0).getTime() - new Date(a.date || 0).getTime());
+
+  return activity.slice(0, limit);
+}
+
+// ============================================================================
+// Sync Functions
+// ============================================================================
+
+/**
+ * Full sync of GitHub data to project state
+ */
+export function syncGitHubData(projectRoot: string, options: SyncOptions = {}): SyncResult {
+  const state = projectState.loadState(projectRoot);
+
+  interface GitHubStateData {
+    connected?: boolean;
+    owner?: string;
+    repo?: string;
+    repositoryUrl?: string;
+    defaultBranch?: string;
+    lastSync?: string;
+    stats?: GitHubStats;
+  }
+  const githubState = (state as { github?: GitHubStateData } | null)?.github;
+
+  if (!githubState?.connected) {
+    return {
+      success: false,
+      error: 'GitHub not connected'
+    };
+  }
+
+  const { owner, repo } = githubState;
+
+  if (!owner || !repo) {
+    return {
+      success: false,
+      error: 'GitHub owner/repo not set'
+    };
+  }
+
+  // Check gh CLI
+  if (!isGhInstalled()) {
+    return {
+      success: false,
+      error: 'gh CLI not installed'
+    };
+  }
+
+  if (!isGhAuthenticated()) {
+    return {
+      success: false,
+      error: 'gh CLI not authenticated'
+    };
+  }
+
+  // Fetch data
+  const spinner = options.spinner;
+  if (spinner) spinner.start();
+
+  try {
+    // Get commit stats
+    const commitStats = getCommitStats(owner, repo);
+
+    // Get PR stats
+    const prStats = getPRStats(owner, repo);
+
+    // Get contributor count
+    const contributors = getContributorCount(owner, repo);
+
+    // Update state
+    const updatedState = projectState.updateGitHubState(projectRoot, {
+      connected: true,
+      repositoryUrl: githubState.repositoryUrl ?? null,
+      owner,
+      repo,
+      defaultBranch: githubState.defaultBranch ?? null,
+      stats: {
+        totalCommits: commitStats.totalCommits,
+        openPRs: prStats.openPRs,
+        closedPRs: prStats.closedPRs,
+        contributors,
+        lastCommit: commitStats.lastCommit,
+        lastCommitMessage: commitStats.lastCommitMessage,
+        lastCommitSha: commitStats.lastCommitSha
+      }
+    });
+
+    // Save sync metadata
+    saveGitHubSyncMetadata(projectRoot, {
+      lastSync: new Date().toISOString(),
+      commitStats,
+      prStats,
+      contributors
+    });
+
+    const updatedGithub = (updatedState as { github?: GitHubStateData } | null)?.github;
+
+    return {
+      success: true,
+      stats: updatedGithub?.stats
+    };
+  } catch (error) {
+    const err = error as Error;
+    return {
+      success: false,
+      error: err.message
+    };
+  }
+}
+
+/**
+ * Connect to a GitHub repository
+ */
+export function connectRepository(projectRoot: string, options: ConnectOptions = {}): ConnectResult {
+  // Check gh CLI
+  if (!isGhInstalled()) {
+    return {
+      success: false,
+      error: 'gh CLI not installed. Install from https://cli.github.com/'
+    };
+  }
+
+  if (!isGhAuthenticated()) {
+    return {
+      success: false,
+      error: 'gh CLI not authenticated. Run: gh auth login'
+    };
+  }
+
+  // Get repository info
+  let owner: string;
+  let repo: string;
+  let url: string;
+
+  if (options.url) {
+    // Parse provided URL
+    const match = options.url.match(/github\.com\/([^/]+)\/([^/]+)/);
+    if (!match || !match[1] || !match[2]) {
+      return {
+        success: false,
+        error: 'Invalid GitHub URL'
+      };
+    }
+    owner = match[1];
+    repo = match[2].replace('.git', '').replace(/\/$/, '');
+    url = `https://github.com/${owner}/${repo}`;
+  } else {
+    // Auto-detect from git remote
+    const detected = detectRepository(projectRoot);
+    if (!detected) {
+      return {
+        success: false,
+        error: 'Could not detect GitHub repository. Use --url to specify manually.'
+      };
+    }
+    owner = detected.owner;
+    repo = detected.repo;
+    url = detected.url;
+  }
+
+  // Verify repository access
+  const repoInfo = getRepositoryInfo(owner, repo);
+  if (!repoInfo) {
+    return {
+      success: false,
+      error: `Could not access repository: ${owner}/${repo}`
+    };
+  }
+
+  // Get default branch
+  const defaultBranch = repoInfo.defaultBranchRef?.name || getDefaultBranch(projectRoot);
+
+  // Update project state
+  projectState.getOrCreateState(projectRoot);
+
+  projectState.updateGitHubState(projectRoot, {
+    connected: true,
+    repositoryUrl: url,
+    owner,
+    repo,
+    defaultBranch,
+    stats: {
+      totalCommits: 0,
+      openPRs: 0,
+      closedPRs: 0,
+      contributors: 0,
+      lastCommit: null,
+      lastCommitMessage: null
+    }
+  });
+
+  // Initial sync
+  const syncResult = syncGitHubData(projectRoot);
+
+  return {
+    success: true,
+    owner,
+    repo,
+    url,
+    defaultBranch,
+    description: repoInfo.description,
+    isPrivate: repoInfo.isPrivate,
+    stats: syncResult.stats
+  };
+}
+
+/**
+ * Disconnect from GitHub repository
+ */
+export function disconnectRepository(projectRoot: string): DisconnectResult {
+  const state = projectState.loadState(projectRoot);
+
+  interface GitHubStateData {
+    connected?: boolean;
+  }
+  const githubState = (state as { github?: GitHubStateData } | null)?.github;
+
+  if (!githubState?.connected) {
+    return {
+      success: false,
+      error: 'GitHub not connected'
+    };
+  }
+
+  projectState.clearGitHubState(projectRoot);
+
+  return {
+    success: true
+  };
+}
+
+// ============================================================================
+// Sync Metadata
+// ============================================================================
+
+/**
+ * Save GitHub sync metadata
+ */
+export function saveGitHubSyncMetadata(projectRoot: string, metadata: SyncMetadata): void {
+  const syncFile = projectState.getGitHubSyncFilePath(projectRoot);
+  const planningDir = projectState.getPlanningDir(projectRoot);
+
+  try {
+    if (!fs.existsSync(planningDir)) {
+      fs.mkdirSync(planningDir, { recursive: true });
+    }
+
+    fs.writeFileSync(syncFile, JSON.stringify(metadata, null, 2), 'utf-8');
+  } catch (error) {
+    const err = error as Error;
+    utils.print.debug(`Error saving sync metadata: ${err.message}`);
+  }
+}
+
+/**
+ * Load GitHub sync metadata
+ */
+export function loadGitHubSyncMetadata(projectRoot: string): SyncMetadata | null {
+  const syncFile = projectState.getGitHubSyncFilePath(projectRoot);
+
+  if (!fs.existsSync(syncFile)) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(fs.readFileSync(syncFile, 'utf-8')) as SyncMetadata;
+  } catch {
+    return null;
+  }
+}
+
+// ============================================================================
+// Status Functions
+// ============================================================================
+
+/**
+ * Get GitHub connection status
+ */
+export function getStatus(projectRoot: string): GitHubStatus {
+  const state = projectState.loadState(projectRoot);
+
+  interface GitHubStateData {
+    connected?: boolean;
+    repositoryUrl?: string;
+    owner?: string;
+    repo?: string;
+    defaultBranch?: string;
+    lastSync?: string;
+    stats?: GitHubStats;
+  }
+  const githubState = (state as { github?: GitHubStateData } | null)?.github;
+
+  if (!githubState?.connected) {
+    return {
+      connected: false,
+      ghInstalled: isGhInstalled(),
+      ghAuthenticated: isGhInstalled() && isGhAuthenticated(),
+      detected: detectRepository(projectRoot)
+    };
+  }
+
+  const syncMetadata = loadGitHubSyncMetadata(projectRoot);
+
+  return {
+    connected: true,
+    repositoryUrl: githubState.repositoryUrl,
+    owner: githubState.owner,
+    repo: githubState.repo,
+    defaultBranch: githubState.defaultBranch,
+    lastSync: githubState.lastSync,
+    stats: githubState.stats,
+    syncMetadata
+  };
+}