feat(github-stars): centralize GitHub stars data management with automated updates

Introduces a new architecture for managing GitHub stars data:
- Creates centralized github-stars.json to store all star counts
- Adds GitHub Actions workflow for daily automated updates via cron
- Refactors fetch-github-stars.mjs to populate centralized storage
- Generates TypeScript helper functions for accessing star data by category and ID

This separation allows GitHub stars to be updated independently from product manifests,
enabling automated daily updates without modifying individual manifest files.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ericyangpan

.github/workflows/update-github-stars.yml

@@ -0,0 +1,62 @@
+name: Update GitHub Stars
+
+on:
+  schedule:
+    # Run daily at midnight UTC
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+    # Allow manual triggering
+
+jobs:
+  update-stars:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Fetch GitHub stars
+        run: npm run fetch:github-stars
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Generate TypeScript files
+        run: npm run generate:manifests
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --exit-code manifests/github-stars.json src/lib/generated/github-stars.ts || echo "changes=true" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.changes == 'true'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          commit-message: 'chore: update GitHub stars data'
+          title: 'chore: update GitHub stars data'
+          body: |
+            ## Summary
+            Automated daily update of GitHub stars data.
+
+            ### Changes
+            - Updated `manifests/github-stars.json` with latest star counts
+            - Regenerated `src/lib/generated/github-stars.ts`
+
+            ### Source
+            This PR was automatically generated by the `update-github-stars` workflow.
+          branch: auto-update-github-stars
+          delete-branch: true
+          labels: |
+            automated
+            dependencies

manifests/github-stars.json

@@ -0,0 +1,46 @@
+{
+  "extensions": {
+    "amp": null,
+    "augment-code": null,
+    "claude-code": 42,
+    "cline": 52.3,
+    "continue": 29.8,
+    "github-copilot": null,
+    "jetbrains-junie": null,
+    "kilo-code": 12.2,
+    "roo-code": 20.7,
+    "tabnine": 10.8
+  },
+  "clis": {
+    "amazon-q-developer-cli": 1.8,
+    "amp-cli": null,
+    "augment-code-cli": 0.1,
+    "claude-code": 42,
+    "cline-cli": null,
+    "codebuddy-cli": null,
+    "codex": 50.2,
+    "continue-cli": 29.8,
+    "droid-cli": null,
+    "gemini-cli": 82.1,
+    "github-copilot-cli": 5,
+    "kimi-cli": 2.6,
+    "kilocode-cli": 12.2,
+    "kode": 3.4,
+    "neovate-code": 1,
+    "opencode": 32.4,
+    "qoder-cli": null
+  },
+  "ides": {
+    "codebuddy": null,
+    "codeflicker": null,
+    "cursor": 31.6,
+    "droid": null,
+    "intellij-idea": 19.1,
+    "kiro": 2.2,
+    "qoder": null,
+    "trae": null,
+    "vscode": 178.4,
+    "windsurf": null,
+    "zed": 69.5
+  }
+}

manifests/schemas/github-stars.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://aicodingstack.io/schemas/github-stars.schema.json",
+  "title": "GitHub Stars Data",
+  "description": "Schema for the centralized GitHub stars data file",
+  "type": "object",
+  "properties": {
+    "extensions": {
+      "type": "object",
+      "description": "GitHub stars for extensions",
+      "patternProperties": {
+        "^[a-z0-9-]+$": {
+          "oneOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "description": "Number of GitHub stars in thousands (e.g., 42 = 42k stars)"
+            },
+            {
+              "type": "null",
+              "description": "No GitHub stars data available"
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "clis": {
+      "type": "object",
+      "description": "GitHub stars for CLI tools",
+      "patternProperties": {
+        "^[a-z0-9-]+$": {
+          "oneOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "description": "Number of GitHub stars in thousands (e.g., 42 = 42k stars)"
+            },
+            {
+              "type": "null",
+              "description": "No GitHub stars data available"
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "ides": {
+      "type": "object",
+      "description": "GitHub stars for IDEs",
+      "patternProperties": {
+        "^[a-z0-9-]+$": {
+          "oneOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "description": "Number of GitHub stars in thousands (e.g., 42 = 42k stars)"
+            },
+            {
+              "type": "null",
+              "description": "No GitHub stars data available"
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["extensions", "clis", "ides"],
+  "additionalProperties": false
+}

scripts/fetch-github-stars.mjs

@@ -12,20 +12,26 @@ const __dirname = dirname(__filename);
 // Set via environment variable: GITHUB_TOKEN=your_token_here node fetch-github-stars.mjs
 const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
 
+// Path to the centralized GitHub stars data file
+const GITHUB_STARS_FILE = path.join(__dirname, '..', 'manifests', 'github-stars.json');
+
 // Directories configuration - now pointing to individual file directories
 const dirsConfig = [
   {
     directory: 'manifests/extensions',
+    category: 'extensions',
     githubUrlField: 'communityUrls.github',
     type: 'nested'
   },
   {
     directory: 'manifests/ides',
+    category: 'ides',
     githubUrlField: 'communityUrls.github',
     type: 'nested'
   },
   {
     directory: 'manifests/clis',
+    category: 'clis',
     githubUrlField: 'communityUrls.github',
     type: 'nested'
   }
@@ -110,79 +116,82 @@ function sleep(ms) {
 }
 
 // Process a single JSON file
-async function processFile(filePath, fileName, type) {
+async function processFile(filePath, fileName, type, starsData) {
   const content = fs.readFileSync(filePath, 'utf8');
   const item = JSON.parse(content);
 
   const githubUrl = getGithubUrl(item, type);
 
   if (!githubUrl) {
     console.log(`  ⏭️  Skipping ${item.name || item.id} (no GitHub URL)`);
-    return { updated: false, skipped: true, error: false };
+    return { updated: false, skipped: true, error: false, id: item.id, stars: null };
   }
 
   const parsed = parseGithubUrl(githubUrl);
   if (!parsed) {
     console.log(`  ❌ Failed to parse GitHub URL for ${item.name || item.id}: ${githubUrl}`);
-    return { updated: false, skipped: false, error: true };
+    return { updated: false, skipped: false, error: true, id: item.id, stars: null };
   }
 
   try {
     console.log(`  🔍 Fetching stars for ${item.name || item.id} (${parsed.owner}/${parsed.repo})...`);
     const stars = await fetchStars(parsed.owner, parsed.repo);
-    item.githubStars = stars;
-
-    // Write back to file
-    fs.writeFileSync(filePath, JSON.stringify(item, null, 2) + '\n', 'utf8');
     console.log(`  ✅ Updated ${item.name || item.id}: ${stars}k stars`);
 
     // Sleep for 1 second to avoid rate limiting
     await sleep(1000);
-    return { updated: true, skipped: false, error: false };
+    return { updated: true, skipped: false, error: false, id: item.id, stars };
   } catch (error) {
     console.log(`  ❌ Error fetching ${item.name || item.id}: ${error.message}`);
-    return { updated: false, skipped: false, error: true };
+    return { updated: false, skipped: false, error: true, id: item.id, stars: null };
   }
 }
 
 // Process all files in a directory
-async function processDirectory(dirConfig) {
+async function processDirectory(dirConfig, starsData) {
   const dirPath = path.join(__dirname, '..', dirConfig.directory);
   console.log(`\n📁 Processing ${dirConfig.directory}...`);
 
   if (!fs.existsSync(dirPath)) {
     console.log(`  ⚠️  Directory not found: ${dirPath}`);
-    return;
+    return { categoryData: {}, stats: { updated: 0, skipped: 0, errors: 0 } };
   }
 
   // Get all JSON files in the directory
   const files = fs.readdirSync(dirPath).filter(file => file.endsWith('.json'));
 
   if (files.length === 0) {
     console.log(`  ⚠️  No JSON files found in ${dirConfig.directory}`);
-    return;
+    return { categoryData: {}, stats: { updated: 0, skipped: 0, errors: 0 } };
   }
 
   let updated = 0;
   let skipped = 0;
   let errors = 0;
+  const categoryData = {};
 
   for (const file of files) {
     const filePath = path.join(dirPath, file);
-    const result = await processFile(filePath, file, dirConfig.type);
+    const result = await processFile(filePath, file, dirConfig.type, starsData);
 
     if (result.updated) updated++;
     if (result.skipped) skipped++;
     if (result.error) errors++;
+
+    // Store the stars data for this item
+    if (result.id) {
+      categoryData[result.id] = result.stars;
+    }
   }
 
   console.log(`\n✨ ${dirConfig.directory} completed: ${updated} updated, ${skipped} skipped, ${errors} errors`);
+  return { categoryData, stats: { updated, skipped, errors } };
 }
 
 // Main function
 async function main() {
   console.log('🚀 Starting GitHub stars fetcher...\n');
-  console.log('📝 Note: Now processing individual JSON files in directories\n');
+  console.log('📝 Note: Updating centralized github-stars.json file\n');
 
   if (!GITHUB_TOKEN) {
     console.log('⚠️  Warning: No GITHUB_TOKEN set. You may hit rate limits (60 requests/hour).');
@@ -191,16 +200,59 @@ async function main() {
     console.log('✅ Using GitHub token for authentication\n');
   }
 
+  // Load existing stars data or create new structure
+  let starsData = { extensions: {}, clis: {}, ides: {} };
+  if (fs.existsSync(GITHUB_STARS_FILE)) {
+    try {
+      const content = fs.readFileSync(GITHUB_STARS_FILE, 'utf8');
+      starsData = JSON.parse(content);
+      console.log('📂 Loaded existing github-stars.json\n');
+    } catch (error) {
+      console.log('⚠️  Failed to parse existing github-stars.json, creating new one\n');
+    }
+  }
+
+  let totalUpdated = 0;
+  let totalSkipped = 0;
+  let totalErrors = 0;
+
+  // Process each directory and collect stars data
   for (const dirConfig of dirsConfig) {
     try {
-      await processDirectory(dirConfig);
+      const { categoryData, stats } = await processDirectory(dirConfig, starsData);
+
+      // Sort the category data by key (alphabetically)
+      const sortedCategoryData = Object.keys(categoryData)
+        .sort()
+        .reduce((acc, key) => {
+          acc[key] = categoryData[key];
+          return acc;
+        }, {});
+
+      // Update the stars data for this category
+      starsData[dirConfig.category] = sortedCategoryData;
+
+      totalUpdated += stats.updated;
+      totalSkipped += stats.skipped;
+      totalErrors += stats.errors;
     } catch (error) {
       console.error(`❌ Failed to process ${dirConfig.directory}:`, error.message);
+      totalErrors++;
     }
   }
 
+  // Write the updated stars data to file
+  try {
+    fs.writeFileSync(GITHUB_STARS_FILE, JSON.stringify(starsData, null, 2) + '\n', 'utf8');
+    console.log('\n📝 Successfully updated manifests/github-stars.json');
+  } catch (error) {
+    console.error('\n❌ Failed to write github-stars.json:', error.message);
+    process.exit(1);
+  }
+
   console.log('\n' + '='.repeat(50));
   console.log('🎉 All directories processed!');
+  console.log(`📊 Total: ${totalUpdated} updated, ${totalSkipped} skipped, ${totalErrors} errors`);
   console.log('='.repeat(50));
 }