@rulemetric/skills-registry 0.1.1 → 0.2.0

package/dist/discover-sources.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=discover-sources.d.ts.map

package/dist/discover-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-sources.d.ts","sourceRoot":"","sources":["../src/discover-sources.ts"],"names":[],"mappings":""}

package/dist/discover-sources.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env tsx
+/**
+ * Discover new skill repositories on GitHub by searching for relevant topics and keywords.
+ * Outputs candidate RegistrySource entries that can be added to sources.ts.
+ *
+ * Usage:
+ *   GITHUB_TOKEN=ghp_xxx pnpm --filter @rulemetric/skills-registry discover
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { TIER_1_SOURCES, TIER_2_SOURCES } from './sources.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const GITHUB_API = 'https://api.github.com';
+/** Topics and keywords to search for. */
+const SEARCH_QUERIES = [
+    // Topic-based searches
+    'topic:claude-code-skills',
+    'topic:cursorrules',
+    'topic:agents-md',
+    'topic:ai-coding-rules',
+    'topic:claude-code',
+    'topic:copilot-instructions',
+    'topic:ai-prompts',
+    'topic:soul-md',
+    'topic:openclaw',
+    // Keyword-based searches (in repo name or description)
+    'claude-code skills in:name,description',
+    'cursorrules in:name',
+    'agents.md rules in:name,description',
+    'copilot-instructions in:name',
+    'ai coding rules in:name,description',
+    'claude skills in:name',
+    'windsurf rules in:name,description',
+];
+/** Minimum quality thresholds. */
+const MIN_STARS = 5;
+const MIN_SIZE_KB = 1; // Skip near-empty repos
+async function searchGitHub(query) {
+    const token = process.env.GITHUB_TOKEN;
+    const headers = {
+        'Accept': 'application/vnd.github.v3+json',
+        'User-Agent': 'rulemetric-skills-registry',
+    };
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
+    const url = `${GITHUB_API}/search/repositories?q=${encodeURIComponent(query)}&sort=stars&order=desc&per_page=30`;
+    try {
+        const resp = await fetch(url, { headers, signal: AbortSignal.timeout(15000) });
+        if (!resp.ok) {
+            console.error(`  Search failed (${resp.status}): ${query}`);
+            return [];
+        }
+        const data = await resp.json();
+        return data.items ?? [];
+    }
+    catch (err) {
+        console.error(`  Search error: ${query}`, err);
+        return [];
+    }
+}
+/** Infer the default tool from repo name, topics, and description. */
+function inferTool(repo) {
+    const text = `${repo.full_name} ${repo.description ?? ''} ${repo.topics.join(' ')}`.toLowerCase();
+    if (text.includes('claude-code') || text.includes('claude_code') || text.includes('claude-skills'))
+        return 'claude_code';
+    if (text.includes('cursor') || text.includes('cursorrules') || text.includes('.mdc'))
+        return 'cursor';
+    if (text.includes('copilot'))
+        return 'copilot';
+    if (text.includes('windsurf'))
+        return 'windsurf';
+    if (text.includes('cline'))
+        return 'cline';
+    if (text.includes('aider'))
+        return 'aider';
+    if (text.includes('openclaw') || text.includes('soul.md'))
+        return 'openclaw';
+    return 'universal';
+}
+/** Infer the default category. */
+function inferCategory(repo) {
+    const text = `${repo.full_name} ${repo.description ?? ''} ${repo.topics.join(' ')}`.toLowerCase();
+    if (text.includes('security') || text.includes('owasp'))
+        return 'security';
+    if (text.includes('test') || text.includes('tdd'))
+        return 'testing';
+    if (text.includes('react') || text.includes('django') || text.includes('rails') || text.includes('flutter'))
+        return 'framework';
+    if (text.includes('typescript') || text.includes('python') || text.includes('rust') || text.includes('swift'))
+        return 'language';
+    if (text.includes('devops') || text.includes('docker') || text.includes('deploy'))
+        return 'devops';
+    if (text.includes('architect'))
+        return 'architecture';
+    return 'workflow';
+}
+/** Infer glob patterns for skill files. */
+function inferPatterns(repo) {
+    const text = `${repo.full_name} ${repo.description ?? ''}`.toLowerCase();
+    const patterns = [];
+    if (text.includes('cursorrules') || text.includes('.mdc')) {
+        patterns.push('**/*.cursorrules', '**/*.mdc');
+    }
+    if (text.includes('skills')) {
+        patterns.push('skills/**/*.md');
+    }
+    if (text.includes('agents') || text.includes('agents.md')) {
+        patterns.push('agents/**/*.md', '**/AGENTS.md');
+    }
+    if (text.includes('rules') || text.includes('instructions') || text.includes('prompts')) {
+        patterns.push('**/*.md');
+    }
+    // Fallback: scan all markdown
+    if (patterns.length === 0) {
+        patterns.push('**/*.md');
+    }
+    return [...new Set(patterns)];
+}
+async function main() {
+    // Build set of already-known repos
+    const knownRepos = new Set();
+    for (const s of [...TIER_1_SOURCES, ...TIER_2_SOURCES]) {
+        knownRepos.add(s.repo.toLowerCase());
+    }
+    console.log(`Known repos: ${knownRepos.size}`);
+    console.log(`Running ${SEARCH_QUERIES.length} search queries...\n`);
+    const candidates = new Map();
+    for (const query of SEARCH_QUERIES) {
+        // Rate limit: 10 searches/min for authenticated, 5/min unauthenticated
+        await new Promise(r => setTimeout(r, 2000));
+        const results = await searchGitHub(query);
+        let newCount = 0;
+        for (const repo of results) {
+            const key = repo.full_name.toLowerCase();
+            if (knownRepos.has(key))
+                continue;
+            if (repo.stargazers_count < MIN_STARS)
+                continue;
+            if (repo.size < MIN_SIZE_KB)
+                continue;
+            if (!candidates.has(key)) {
+                candidates.set(key, repo);
+                newCount++;
+            }
+        }
+        console.log(`  "${query}" → ${results.length} results, ${newCount} new candidates`);
+    }
+    console.log(`\nDiscovered ${candidates.size} candidate repos:\n`);
+    // Sort by stars descending
+    const sorted = [...candidates.values()].sort((a, b) => b.stargazers_count - a.stargazers_count);
+    // Generate RegistrySource entries
+    const discovered = [];
+    for (const repo of sorted) {
+        const tool = inferTool(repo);
+        const category = inferCategory(repo);
+        const patterns = inferPatterns(repo);
+        const license = repo.license?.spdx_id;
+        const source = {
+            repo: repo.full_name,
+            patterns,
+            defaultTool: tool,
+            defaultCategory: category,
+            ...(license ? { license } : {}),
+        };
+        discovered.push(source);
+        const stale = (Date.now() - new Date(repo.updated_at).getTime()) > 180 * 86400000;
+        console.log(`  ${stale ? '⚠' : '✓'} ${repo.full_name} (${repo.stargazers_count}★)` +
+            ` [${tool}/${category}]` +
+            (repo.description ? ` — ${repo.description.slice(0, 80)}` : '') +
+            (stale ? ' (stale >6mo)' : ''));
+    }
+    // Write discovered sources to a file
+    const outputPath = path.resolve(__dirname, '..', 'discovered-sources.json');
+    fs.writeFileSync(outputPath, JSON.stringify(discovered, null, 2));
+    console.log(`\nWrote ${discovered.length} candidates to ${outputPath}`);
+    console.log('Review and add promising ones to sources.ts');
+}
+main().catch(err => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=discover-sources.js.map

package/dist/discover-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-sources.js","sourceRoot":"","sources":["../src/discover-sources.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C,yCAAyC;AACzC,MAAM,cAAc,GAAG;IACrB,uBAAuB;IACvB,0BAA0B;IAC1B,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,mBAAmB;IACnB,4BAA4B;IAC5B,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,uDAAuD;IACvD,wCAAwC;IACxC,qBAAqB;IACrB,qCAAqC;IACrC,8BAA8B;IAC9B,qCAAqC;IACrC,uBAAuB;IACvB,oCAAoC;CACrC,CAAC;AAEF,kCAAkC;AAClC,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,WAAW,GAAG,CAAC,CAAC,CAAE,wBAAwB;AAgBhD,KAAK,UAAU,YAAY,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACvC,MAAM,OAAO,GAA2B;QACtC,QAAQ,EAAE,gCAAgC;QAC1C,YAAY,EAAE,4BAA4B;KAC3C,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IAExD,MAAM,GAAG,GAAG,GAAG,UAAU,0BAA0B,kBAAkB,CAAC,KAAK,CAAC,oCAAoC,CAAC;IACjH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAwB,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mBAAmB,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,SAAS,SAAS,CAAC,IAAyE;IAC1F,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,aAAa,CAAC;IACzH,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IAC7E,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,kCAAkC;AAClC,SAAS,aAAa,CAAC,IAAyE;IAC9F,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3E,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,WAAW,CAAC;IAChI,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC;IACjI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnG,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,cAAc,CAAC;IACtD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2CAA2C;AAC3C,SAAS,aAAa,CAAC,IAAyE;IAC9F,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxF,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,8BAA8B;IAC9B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,mCAAmC;IACnC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC;QACvD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,WAAW,cAAc,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0C,CAAC;IAErE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,uEAAuE;QACvE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,IAAI,IAAI,CAAC,gBAAgB,GAAG,SAAS;gBAAE,SAAS;YAChD,IAAI,IAAI,CAAC,IAAI,GAAG,WAAW;gBAAE,SAAS;YACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC1B,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,OAAO,OAAO,CAAC,MAAM,aAAa,QAAQ,iBAAiB,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,UAAU,CAAC,IAAI,qBAAqB,CAAC,CAAC;IAElE,2BAA2B;IAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAEhG,kCAAkC;IAClC,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;QAEtC,MAAM,MAAM,GAAmB;YAC7B,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,QAAQ;YACR,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,QAAQ;YACzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;QAEF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC;QAClF,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,gBAAgB,IAAI;YACtE,KAAK,IAAI,IAAI,QAAQ,GAAG;YACxB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,yBAAyB,CAAC,CAAC;IAC5E,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,CAAC,MAAM,kBAAkB,UAAU,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/discovered.d.ts

@@ -0,0 +1,12 @@
+import type { RegistrySource } from './types.js';
+/**
+ * Load the build-time-discovered registry sources from
+ * `packages/skills-registry/discovered-sources.json`. Returns [] if the file
+ * is missing (e.g. running against a stripped install). Used by
+ * `cron_refresh_skills` so the cron's coverage matches the bundled registry.
+ *
+ * Path resolution: dist/discovered.js sits at packages/skills-registry/dist/,
+ * the JSON sits at packages/skills-registry/. So we walk up one level.
+ */
+export declare function loadDiscoveredSources(): RegistrySource[];
+//# sourceMappingURL=discovered.d.ts.map

package/dist/discovered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovered.d.ts","sourceRoot":"","sources":["../src/discovered.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAcxD"}

package/dist/discovered.js

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Load the build-time-discovered registry sources from
+ * `packages/skills-registry/discovered-sources.json`. Returns [] if the file
+ * is missing (e.g. running against a stripped install). Used by
+ * `cron_refresh_skills` so the cron's coverage matches the bundled registry.
+ *
+ * Path resolution: dist/discovered.js sits at packages/skills-registry/dist/,
+ * the JSON sits at packages/skills-registry/. So we walk up one level.
+ */
+export function loadDiscoveredSources() {
+    const candidates = [
+        path.resolve(__dirname, '..', 'discovered-sources.json'),
+        path.resolve(__dirname, '..', '..', 'discovered-sources.json'),
+    ];
+    for (const p of candidates) {
+        try {
+            const raw = readFileSync(p, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=discovered.js.map

package/dist/discovered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovered.js","sourceRoot":"","sources":["../src/discovered.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB;IACjC,MAAM,UAAU,GAAG;QACf,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,yBAAyB,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,yBAAyB,CAAC;KACjE,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACzB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC"}

package/dist/fetch-registry.js

@@ -12,14 +12,115 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { fetchAllSources } from './github-fetcher.js';
-import { TIER_1_SOURCES } from './sources.js';
+import { computeQualityScore } from './scoring.js';
+import { TIER_1_SOURCES, TIER_2_SOURCES } from './sources.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const OUTPUT_PATH = path.resolve(__dirname, '..', 'registry.json');
+const DISCOVERED_PATH = path.resolve(__dirname, '..', 'discovered-sources.json');
+const COMMUNITY_PATH = path.resolve(__dirname, '..', 'community-skills.json');
+const TREE_SHAS_PATH = path.resolve(__dirname, '..', 'tree-shas.json');
+function loadPreviousShas() {
+    if (!fs.existsSync(TREE_SHAS_PATH))
+        return new Map();
+    try {
+        const obj = JSON.parse(fs.readFileSync(TREE_SHAS_PATH, 'utf-8'));
+        return new Map(Object.entries(obj));
+    }
+    catch {
+        return new Map();
+    }
+}
+function loadPreviousEntriesByRepo() {
+    if (!fs.existsSync(OUTPUT_PATH))
+        return new Map();
+    try {
+        const reg = JSON.parse(fs.readFileSync(OUTPUT_PATH, 'utf-8'));
+        const byRepo = new Map();
+        for (const s of reg.skills) {
+            const list = byRepo.get(s.source.repo) ?? [];
+            list.push(s);
+            byRepo.set(s.source.repo, list);
+        }
+        return byRepo;
+    }
+    catch {
+        return new Map();
+    }
+}
 async function main() {
-    console.log(`Fetching skills from ${TIER_1_SOURCES.length} Tier 1 sources...\n`);
-    const entries = await fetchAllSources(TIER_1_SOURCES, (source, count) => {
-        console.log(`  ${source}: ${count} skills`);
+    const includeAll = process.argv.includes('--all');
+    const includeDiscovered = process.argv.includes('--discovered');
+    let sources = includeAll
+        ? [...TIER_1_SOURCES, ...TIER_2_SOURCES]
+        : TIER_1_SOURCES;
+    // Optionally include discovered sources from the last discovery run
+    if (includeDiscovered && fs.existsSync(DISCOVERED_PATH)) {
+        try {
+            const discovered = JSON.parse(fs.readFileSync(DISCOVERED_PATH, 'utf-8'));
+            console.log(`Including ${discovered.length} discovered sources\n`);
+            sources = [...sources, ...discovered];
+        }
+        catch {
+            console.warn('Warning: could not parse discovered-sources.json, skipping');
+        }
+    }
+    console.log(`Fetching skills from ${sources.length} sources${includeAll ? ' (Tier 1 + 2)' : ' (Tier 1)'}...\n`);
+    const previousShas = loadPreviousShas();
+    const previousEntriesByRepo = loadPreviousEntriesByRepo();
+    const { entries: freshEntries, treeShas } = await fetchAllSources(sources, {
+        previousShas,
+        onProgress: (source, count, skipped) => {
+            if (skipped) {
+                const prior = previousEntriesByRepo.get(source)?.length ?? 0;
+                console.log(`  ${source}: skipped (unchanged, ${prior} cached)`);
+            }
+            else {
+                console.log(`  ${source}: ${count} skills`);
+            }
+        },
     });
+    // Carry forward entries from sources that were skipped (tree SHA unchanged).
+    const entries = [...freshEntries];
+    const seenIds = new Set(entries.map(e => e.id));
+    for (const source of sources) {
+        const newSha = treeShas.get(source.repo);
+        const oldSha = previousShas.get(source.repo);
+        if (newSha && newSha === oldSha) {
+            for (const cached of previousEntriesByRepo.get(source.repo) ?? []) {
+                if (!seenIds.has(cached.id)) {
+                    entries.push(cached);
+                    seenIds.add(cached.id);
+                }
+            }
+        }
+    }
+    // Merge approved community submissions if the file exists
+    if (fs.existsSync(COMMUNITY_PATH)) {
+        try {
+            const community = JSON.parse(fs.readFileSync(COMMUNITY_PATH, 'utf-8'));
+            let merged = 0;
+            for (const skill of community) {
+                if (!seenIds.has(skill.id)) {
+                    entries.push(skill);
+                    seenIds.add(skill.id);
+                    merged++;
+                }
+            }
+            if (merged > 0)
+                console.log(`\nMerged ${merged} community-submitted skills`);
+        }
+        catch {
+            console.warn('Warning: could not parse community-skills.json, skipping');
+        }
+    }
+    // Persist tree SHAs for next run's incremental skip.
+    fs.writeFileSync(TREE_SHAS_PATH, JSON.stringify(Object.fromEntries(treeShas), null, 2));
+    // Precompute quality scores once, with full content. Listing endpoints strip
+    // content but keep this score, so the badge in the listing matches the badge
+    // in the modal — and clients don't have to recompute on every render.
+    for (const entry of entries) {
+        entry.qualityScore = computeQualityScore(entry);
+    }
     const registry = {
         version: '1.0.0',
         generatedAt: new Date().toISOString(),

package/dist/fetch-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-registry.js","sourceRoot":"","sources":["../src/fetch-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-registry.js","sourceRoot":"","sources":["../src/fetch-registry.ts"],"names":[],"mappings":"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"}

package/dist/github-fetcher.d.ts

@@ -1,11 +1,48 @@
 import type { RegistrySource, SkillEntry } from './types.js';
 /**
- * Fetch all skills from a single registry source.
- * Returns parsed SkillEntry objects.
+ * Decide whether Octokit's primary-rate-limit retry is worth waiting for.
+ *
+ * Exported for unit testing — the function is pure (no I/O), so the test
+ * can assert the boundary cases without running the full crawl.
+ */
+export declare function shouldRetryRateLimit(retryAfterSeconds: number, retryCount: number): boolean;
+/**
+ * Decide whether Octokit's secondary-rate-limit retry is worth waiting for.
+ * Secondary limits are GitHub's abuse-detection cooldowns (multi-minute,
+ * sometimes longer). Same 5-min cap as primary.
  */
-export declare function fetchSource(source: RegistrySource): Promise<SkillEntry[]>;
+export declare function shouldRetrySecondaryRateLimit(retryAfterSeconds: number): boolean;
 /**
- * Fetch skills from multiple sources and deduplicate.
+ * Reset the cached Octokit instance. Test-only hook so a test that mutates
+ * `process.env.GITHUB_TOKEN` can force a fresh client on the next call —
+ * otherwise the singleton above pins the auth value from first use.
+ */
+export declare function _resetOctokitForTests(): void;
+export interface FetchSourceResult {
+    entries: SkillEntry[];
+    treeSha: string | null;
+    skipped: boolean;
+}
+/**
+ * Fetch all skills from a single registry source.
+ *
+ * `previousTreeSha` is an optimization: if the repo's current tree SHA matches,
+ * the function returns early with `skipped: true` and no entries. The caller is
+ * expected to keep its existing entries for that source. Pass `undefined` to
+ * always fetch.
  */
-export declare function fetchAllSources(sources: RegistrySource[], onProgress?: (source: string, count: number) => void): Promise<SkillEntry[]>;
+export declare function fetchSource(source: RegistrySource, previousTreeSha?: string): Promise<FetchSourceResult>;
+export interface FetchAllOptions {
+    /** Map of repo → previous tree SHA. Sources with matching SHA are skipped. */
+    previousShas?: Map<string, string>;
+    /** Called after each source completes (successful or not). */
+    onProgress?: (source: string, count: number, skipped: boolean) => void;
+}
+export interface FetchAllResult {
+    entries: SkillEntry[];
+    /** Map of repo → current tree SHA, for caching across runs. */
+    treeShas: Map<string, string>;
+}
+/** Fetch skills from multiple sources, in parallel, deduplicating by id. */
+export declare function fetchAllSources(sources: RegistrySource[], options?: FetchAllOptions): Promise<FetchAllResult>;
 //# sourceMappingURL=github-fetcher.d.ts.map

package/dist/github-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-fetcher.d.ts","sourceRoot":"","sources":["../src/github-fetcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAC;AAiNpF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiE/E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACnD,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvB"}
+{"version":3,"file":"github-fetcher.d.ts","sourceRoot":"","sources":["../src/github-fetcher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAqC5E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAEhF;AA8BD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAyMD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA4D5B;AAID,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA4BzB"}