@girardmedia/bootspring 1.2.0 → 2.0.3

package/core/github-sync.js

@@ -0,0 +1,610 @@
+/**
+ * Bootspring GitHub Sync
+ * Fetch GitHub repository data using gh CLI
+ *
+ * @package bootspring
+ * @module core/github-sync
+ */
+
+const { execSync, exec } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const utils = require('./utils');
+const projectState = require('./project-state');
+
+// ============================================================================
+// gh CLI Utilities
+// ============================================================================
+
+/**
+ * Check if gh CLI is installed
+ * @returns {boolean} True if gh is available
+ */
+function isGhInstalled() {
+  try {
+    execSync('gh --version', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if gh CLI is authenticated
+ * @returns {boolean} True if authenticated
+ */
+function isGhAuthenticated() {
+  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
+ * @param {string} command - gh command (without 'gh' prefix)
+ * @param {object} options - Options
+ * @returns {object|null} Parsed result or null on error
+ */
+function ghCommand(command, options = {}) {
+  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) : result.trim();
+  } catch (error) {
+    utils.print.debug(`gh command failed: ${error.message}`);
+    return null;
+  }
+}
+
+/**
+ * Execute gh command asynchronously
+ * @param {string} command - gh command
+ * @param {object} options - Options
+ * @returns {Promise<object|null>} Parsed result or null on error
+ */
+function ghCommandAsync(command, options = {}) {
+  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) : stdout.trim());
+      } catch {
+        resolve(null);
+      }
+    });
+  });
+}
+
+// ============================================================================
+// Repository Detection
+// ============================================================================
+
+/**
+ * Detect GitHub repository from git remote
+ * @param {string} projectRoot - Project root directory
+ * @returns {object|null} Repository info { owner, repo, url } or null
+ */
+function detectRepository(projectRoot) {
+  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;
+
+    if (result.startsWith('https://')) {
+      match = result.match(/github\.com\/([^/]+)\/([^/.]+)/);
+    } else if (result.includes('github.com')) {
+      match = result.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
+    }
+
+    if (match) {
+      return {
+        owner: match[1],
+        repo: match[2].replace('.git', ''),
+        url: `https://github.com/${match[1]}/${match[2].replace('.git', '')}`
+      };
+    }
+  } catch {
+    // Not a git repo or no remote
+  }
+
+  return null;
+}
+
+/**
+ * Get default branch name
+ * @param {string} projectRoot - Project root directory
+ * @returns {string} Default branch name
+ */
+function getDefaultBranch(projectRoot) {
+  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) {
+      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
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @returns {object|null} Repository metadata
+ */
+function getRepositoryInfo(owner, repo) {
+  return ghCommand(`repo view ${owner}/${repo} --json name,description,defaultBranchRef,url,createdAt,updatedAt,stargazerCount,forkCount,isPrivate`);
+}
+
+/**
+ * Get commit statistics
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @param {object} options - Options
+ * @returns {object} Commit stats
+ */
+function getCommitStats(owner, repo, options = {}) {
+  const limit = options.limit || 100;
+
+  // Get recent commits
+  const commits = ghCommand(`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
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @returns {object} PR stats
+ */
+function getPRStats(owner, repo) {
+  // Get open PRs
+  const openPRs = ghCommand(`pr list --repo ${owner}/${repo} --state open --json number`, { parseJson: true });
+
+  // Get recently closed PRs
+  const closedPRs = ghCommand(`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
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @returns {number} Contributor count
+ */
+function getContributorCount(owner, repo) {
+  const contributors = ghCommand(`api repos/${owner}/${repo}/contributors?per_page=100`, { parseJson: true });
+  return contributors?.length || 0;
+}
+
+/**
+ * Get recent activity (commits + PRs)
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @param {number} limit - Number of items
+ * @returns {Array} Activity items
+ */
+function getRecentActivity(owner, repo, limit = 10) {
+  const activity = [];
+
+  // Get recent commits
+  const commits = ghCommand(`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
+  const prs = ghCommand(`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) - new Date(a.date));
+
+  return activity.slice(0, limit);
+}
+
+// ============================================================================
+// Sync Functions
+// ============================================================================
+
+/**
+ * Full sync of GitHub data to project state
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ * @returns {object} Sync result
+ */
+function syncGitHubData(projectRoot, options = {}) {
+  const state = projectState.loadState(projectRoot);
+
+  if (!state?.github?.connected) {
+    return {
+      success: false,
+      error: 'GitHub not connected'
+    };
+  }
+
+  const { owner, repo } = state.github;
+
+  // 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: state.github.repositoryUrl,
+      owner,
+      repo,
+      defaultBranch: state.github.defaultBranch,
+      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
+    });
+
+    return {
+      success: true,
+      stats: updatedState.github.stats
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message
+    };
+  }
+}
+
+/**
+ * Connect to a GitHub repository
+ * @param {string} projectRoot - Project root directory
+ * @param {object} options - Options
+ * @returns {object} Connection result
+ */
+function connectRepository(projectRoot, options = {}) {
+  // 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, repo, url;
+
+  if (options.url) {
+    // Parse provided URL
+    const match = options.url.match(/github\.com\/([^/]+)\/([^/]+)/);
+    if (!match) {
+      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
+  const 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
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Disconnection result
+ */
+function disconnectRepository(projectRoot) {
+  const state = projectState.loadState(projectRoot);
+
+  if (!state?.github?.connected) {
+    return {
+      success: false,
+      error: 'GitHub not connected'
+    };
+  }
+
+  projectState.clearGitHubState(projectRoot);
+
+  return {
+    success: true
+  };
+}
+
+// ============================================================================
+// Sync Metadata
+// ============================================================================
+
+/**
+ * Save GitHub sync metadata
+ * @param {string} projectRoot - Project root directory
+ * @param {object} metadata - Metadata to save
+ */
+function saveGitHubSyncMetadata(projectRoot, metadata) {
+  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) {
+    utils.print.debug(`Error saving sync metadata: ${error.message}`);
+  }
+}
+
+/**
+ * Load GitHub sync metadata
+ * @param {string} projectRoot - Project root directory
+ * @returns {object|null} Metadata or null
+ */
+function loadGitHubSyncMetadata(projectRoot) {
+  const syncFile = projectState.getGitHubSyncFilePath(projectRoot);
+
+  if (!fs.existsSync(syncFile)) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(fs.readFileSync(syncFile, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+// ============================================================================
+// Status Functions
+// ============================================================================
+
+/**
+ * Get GitHub connection status
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Status object
+ */
+function getStatus(projectRoot) {
+  const state = projectState.loadState(projectRoot);
+
+  if (!state?.github?.connected) {
+    return {
+      connected: false,
+      ghInstalled: isGhInstalled(),
+      ghAuthenticated: isGhInstalled() && isGhAuthenticated(),
+      detected: detectRepository(projectRoot)
+    };
+  }
+
+  const syncMetadata = loadGitHubSyncMetadata(projectRoot);
+
+  return {
+    connected: true,
+    repositoryUrl: state.github.repositoryUrl,
+    owner: state.github.owner,
+    repo: state.github.repo,
+    defaultBranch: state.github.defaultBranch,
+    lastSync: state.github.lastSync,
+    stats: state.github.stats,
+    syncMetadata
+  };
+}
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+module.exports = {
+  // gh CLI utilities
+  isGhInstalled,
+  isGhAuthenticated,
+  ghCommand,
+  ghCommandAsync,
+
+  // Repository detection
+  detectRepository,
+  getDefaultBranch,
+
+  // Data fetching
+  getRepositoryInfo,
+  getCommitStats,
+  getPRStats,
+  getContributorCount,
+  getRecentActivity,
+
+  // Sync operations
+  syncGitHubData,
+  connectRepository,
+  disconnectRepository,
+
+  // Metadata
+  saveGitHubSyncMetadata,
+  loadGitHubSyncMetadata,
+
+  // Status
+  getStatus
+};

package/core/index.js

@@ -11,6 +11,7 @@ const context = require('./context');
 const utils = require('./utils');
 const policies = require('./policies');
 const entitlements = require('./entitlements');
+const tierEnforcement = require('./tier-enforcement');
 const telemetry = require('./telemetry');
 const auth = require('./auth');
 const api = require('./api-client');
@@ -26,6 +27,7 @@ module.exports = {
   utils,
   policies,
   entitlements,
+  tierEnforcement,
   telemetry,
   auth,
   api,
@@ -37,10 +39,15 @@ module.exports = {
   checkSkillAccess: entitlements.checkSkillAccess,
   checkWorkflowAccess: entitlements.checkWorkflowAccess,
 
+  // Tier enforcement convenience exports
+  getTier: tierEnforcement.getTier,
+  checkAgentAccess: tierEnforcement.checkAgentAccess,
+  hasFeature: tierEnforcement.hasFeature,
+  meetsTierRequirement: tierEnforcement.meetsTierRequirement,
+
   // Auth convenience exports
   isAuthenticated: auth.isAuthenticated,
   getUser: auth.getUser,
-  getTier: auth.getTier,
 
   // Brand info
   BRAND: {