opencode-agora 0.3.0 → 0.4.1

package/dist/hubs/enrichment.js

@@ -0,0 +1,239 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { atomicWriteFile } from '../atomic-write.js';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { FREE_MODELS } from '../cli/commands/chat.js';
+import { extractPostInstallHint } from '../marketplace.js';
+export function enrichmentPath(dataDir) {
+    return join(dataDir, 'hubs-enrichment.json');
+}
+export function readEnrichmentStore(dataDir) {
+    const path = enrichmentPath(dataDir);
+    if (!existsSync(path))
+        return {};
+    try {
+        const raw = readFileSync(path, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export function writeEnrichmentStore(dataDir, store) {
+    atomicWriteFile(enrichmentPath(dataDir), JSON.stringify(store, null, 2));
+}
+export function getEnrichment(store, repoId, commitSha) {
+    return store[`${repoId}@${commitSha}`];
+}
+export function setEnrichment(store, entry) {
+    return { ...store, [`${entry.repoId}@${entry.commitSha}`]: entry };
+}
+export async function fetchRepoMetadata(repoId, opts = {}) {
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const token = opts.token ?? process.env.AGORA_GITHUB_TOKEN;
+    const headers = {
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        'User-Agent': 'agora-cli'
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    try {
+        const commitsUrl = `https://api.github.com/repos/${repoId}/commits?per_page=1`;
+        const commitsRes = await fetcher(commitsUrl, { headers, signal: opts.signal });
+        if (!commitsRes.ok)
+            return null;
+        const commitsJson = (await commitsRes.json());
+        const commitSha = commitsJson[0]?.sha;
+        if (!commitSha)
+            return null;
+        const readmeUrl = `https://api.github.com/repos/${repoId}/readme`;
+        const readmeRes = await fetcher(readmeUrl, { headers, signal: opts.signal });
+        if (!readmeRes.ok)
+            return null;
+        const readmeJson = (await readmeRes.json());
+        if (!readmeJson.content)
+            return null;
+        const readme = Buffer.from(readmeJson.content, 'base64').toString('utf8');
+        return { commitSha, readme };
+    }
+    catch {
+        return null;
+    }
+}
+export async function fetchHfRepoMetadata(repoId, opts = {}) {
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const headers = {
+        Accept: 'application/json',
+        'User-Agent': 'agora-cli'
+    };
+    const cardRes = await fetcher(`https://huggingface.co/api/models/${repoId}`, {
+        headers,
+        signal: opts.signal
+    });
+    if (!cardRes.ok)
+        return null;
+    const card = (await cardRes.json());
+    const version = card.lastModified;
+    if (!version)
+        return null;
+    const endpoints = ['models', 'datasets', 'spaces'];
+    let readme = null;
+    for (const ep of endpoints) {
+        const url = ep === 'models'
+            ? `https://huggingface.co/${repoId}/raw/main/README.md`
+            : `https://huggingface.co/${ep}/${repoId}/raw/main/README.md`;
+        const res = await fetcher(url, { headers, signal: opts.signal });
+        if (res.ok) {
+            readme = await res.text();
+            break;
+        }
+    }
+    if (!readme)
+        return null;
+    const maxChars = 8000;
+    const trimmed = readme.length > maxChars ? readme.slice(0, maxChars) + '\n...(truncated)' : readme;
+    return { version, readme: trimmed };
+}
+async function callOpencode(prompt) {
+    const model = FREE_MODELS[0];
+    const modelArg = model.includes('/') ? model : `opencode/${model}`;
+    return new Promise((resolve) => {
+        const child = spawn('opencode', ['run', '--format', 'json', '--model', modelArg, prompt], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false
+        });
+        let response = '';
+        const timer = setTimeout(() => {
+            child.kill();
+            resolve(null);
+        }, 30000);
+        child.stdout.on('data', (chunk) => {
+            for (const line of chunk.toString().split('\n').filter(Boolean)) {
+                try {
+                    const ev = JSON.parse(line);
+                    if (ev.type === 'text' && ev.part?.text)
+                        response += ev.part.text;
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        });
+        child.on('close', () => {
+            clearTimeout(timer);
+            resolve(response || null);
+        });
+        child.on('error', () => {
+            clearTimeout(timer);
+            resolve(null);
+        });
+    });
+}
+export async function generateDescription(readme, opencodeFn) {
+    const maxChars = 8000;
+    const trimmed = readme.length > maxChars ? readme.slice(0, maxChars) + '\n...(truncated)' : readme;
+    const prompt = `<system>\nYou are summarizing an open-source repository's README. Write ONE sentence (max 20 words) describing what this repo does. Be concrete; no marketing language.\n<user>\n${trimmed}`;
+    const result = await (opencodeFn ?? callOpencode)(prompt);
+    if (!result)
+        return null;
+    const trimmedResult = result.trim();
+    return trimmedResult || null;
+}
+export async function generateInstallHint(readme, opencodeFn) {
+    const maxChars = 8000;
+    const trimmed = readme.length > maxChars ? readme.slice(0, maxChars) + '\n...(truncated)' : readme;
+    const prompt = `<system>\nExtract the single install command or step from this README. Return ONE line, max 100 chars. If unclear, return 'UNKNOWN'. Do not add commentary.\n<user>\n${trimmed}`;
+    const result = await (opencodeFn ?? callOpencode)(prompt);
+    if (!result)
+        return null;
+    const trimmedResult = result.trim();
+    if (!trimmedResult || trimmedResult.toUpperCase() === 'UNKNOWN')
+        return null;
+    return trimmedResult;
+}
+export async function enrichItem(repoId, dataDir, opts = {}) {
+    const store = readEnrichmentStore(dataDir);
+    // Check if we already have a cached entry for this repoId
+    const existingEntry = Object.values(store).find((e) => e.repoId === repoId);
+    // Fetch the latest commit sha (cheap call)
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const token = opts.token ?? process.env.AGORA_GITHUB_TOKEN;
+    const headers = {
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        'User-Agent': 'agora-cli'
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    let latestSha = null;
+    try {
+        const commitsUrl = `https://api.github.com/repos/${repoId}/commits?per_page=1`;
+        const commitsRes = await fetcher(commitsUrl, { headers });
+        if (commitsRes.ok) {
+            const commitsJson = (await commitsRes.json());
+            latestSha = commitsJson[0]?.sha ?? null;
+        }
+    }
+    catch {
+        // If we can't fetch SHA, return cached if available
+        if (existingEntry)
+            return existingEntry;
+        return null;
+    }
+    if (!latestSha) {
+        if (existingEntry)
+            return existingEntry;
+        return null;
+    }
+    // Cache hit: sha matches
+    if (existingEntry && existingEntry.commitSha === latestSha) {
+        return existingEntry;
+    }
+    // Need to fetch full metadata
+    const meta = await fetchRepoMetadata(repoId, { fetcher, token });
+    if (!meta)
+        return null;
+    const [description, aiHint] = await Promise.all([
+        generateDescription(meta.readme, opts.opencode),
+        generateInstallHint(meta.readme, opts.opencode)
+    ]);
+    const installHint = aiHint ?? extractPostInstallHint(meta.readme);
+    const entry = {
+        repoId,
+        commitSha: meta.commitSha,
+        description: description ?? undefined,
+        installHint: installHint ?? undefined,
+        fetchedAt: new Date().toISOString()
+    };
+    const updated = setEnrichment(store, entry);
+    writeEnrichmentStore(dataDir, updated);
+    return entry;
+}
+export async function enrichHfItem(repoId, dataDir, opts = {}) {
+    const storeRepoId = `hf:${repoId}`;
+    const store = readEnrichmentStore(dataDir);
+    const existingEntry = Object.values(store).find((e) => e.repoId === storeRepoId);
+    const meta = await fetchHfRepoMetadata(repoId, { fetcher: opts.fetcher });
+    if (!meta) {
+        return existingEntry ?? null;
+    }
+    if (existingEntry && existingEntry.commitSha === meta.version) {
+        return existingEntry;
+    }
+    const [description, installHint] = await Promise.all([
+        generateDescription(meta.readme, opts.opencode),
+        generateInstallHint(meta.readme, opts.opencode)
+    ]);
+    const entry = {
+        repoId: storeRepoId,
+        commitSha: meta.version,
+        description: description ?? undefined,
+        installHint: installHint ?? undefined,
+        fetchedAt: new Date().toISOString()
+    };
+    const updated = setEnrichment(store, entry);
+    writeEnrichmentStore(dataDir, updated);
+    return entry;
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/hubs/enrichment.js.map

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

package/dist/hubs/github.d.ts

@@ -0,0 +1,12 @@
+import type { HubItem } from './types.js';
+export declare const TOPICS: string[];
+export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface GithubSearchOptions {
+    fetcher?: FetchLike;
+    signal?: AbortSignal;
+    token?: string;
+    topics?: string[];
+    now?: Date;
+}
+export declare function searchGithub(opts?: GithubSearchOptions): Promise<HubItem[]>;
+//# sourceMappingURL=github.d.ts.map

package/dist/hubs/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/hubs/github.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,MAAM,UASlB,CAAC;AAIF,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAwCrF"}

package/dist/hubs/github.js

@@ -0,0 +1,54 @@
+import { passes, toHubItem } from './quality.js';
+export const TOPICS = [
+    'mcp',
+    'model-context-protocol',
+    'claude-skill',
+    'claude-code',
+    'agent-tools',
+    'llm-tools',
+    'langchain',
+    'opencode'
+];
+const PER_TOPIC = 30;
+export async function searchGithub(opts = {}) {
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const topics = opts.topics ?? TOPICS;
+    const now = opts.now ?? new Date();
+    const fetchedAt = now.toISOString();
+    const token = opts.token ?? process.env.AGORA_GITHUB_TOKEN;
+    const headers = {
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        'User-Agent': 'agora-cli'
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    const byId = new Map();
+    for (const topic of topics) {
+        const q = `topic:${topic}+stars:>=10`;
+        const url = `https://api.github.com/search/repositories?q=${q}&sort=stars&order=desc&per_page=${PER_TOPIC}`;
+        try {
+            const res = await fetcher(url, { headers, signal: opts.signal });
+            if (!res.ok)
+                continue;
+            const json = (await res.json());
+            for (const repo of json.items ?? []) {
+                if (!byId.has(repo.id))
+                    byId.set(repo.id, repo);
+            }
+        }
+        catch {
+            continue; // graceful; we have cache fallback
+        }
+    }
+    const items = [];
+    for (const repo of byId.values()) {
+        if (!passes(repo, now))
+            continue;
+        items.push(toHubItem(repo, fetchedAt));
+    }
+    // Sort by stars descending for simplicity
+    items.sort((a, b) => b.stars - a.stars);
+    return items;
+}
+//# sourceMappingURL=github.js.map

package/dist/hubs/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/hubs/github.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAsB,MAAM,cAAc,CAAC;AAErE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK;IACL,wBAAwB;IACxB,cAAc;IACd,aAAa;IACb,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC;AAEF,MAAM,SAAS,GAAG,EAAE,CAAC;AAYrB,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE3D,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,6BAA6B;QACrC,sBAAsB,EAAE,YAAY;QACpC,YAAY,EAAE,WAAW;KAC1B,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;IAErD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,SAAS,KAAK,aAAa,CAAC;QACtC,MAAM,GAAG,GAAG,gDAAgD,CAAC,mCAAmC,SAAS,EAAE,CAAC;QAC5G,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,SAAS;YACtB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgC,CAAC;YAC/D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,mCAAmC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACjC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAExC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/hubs/huggingface.d.ts

@@ -0,0 +1,27 @@
+import type { HubItem } from './types.js';
+export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface HfSearchOptions {
+    fetcher?: FetchLike;
+    signal?: AbortSignal;
+    now?: Date;
+}
+export declare const HF_QUERIES: {
+    endpoint: string;
+    filter: string;
+    limit: number;
+}[];
+export interface RawHfItem {
+    id: string;
+    modelId?: string;
+    author?: string;
+    downloads?: number;
+    likes?: number;
+    tags?: string[];
+    pipeline_tag?: string;
+    library_name?: string;
+    createdAt?: string;
+    lastModified?: string;
+    private?: boolean;
+}
+export declare function searchHuggingFace(opts?: HfSearchOptions): Promise<HubItem[]>;
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/hubs/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../src/hubs/huggingface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,CAAC;CAEZ;AAGD,eAAO,MAAM,UAAU;;;;GAMtB,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAEnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuCtF"}

package/dist/hubs/huggingface.js

@@ -0,0 +1,88 @@
+// Categories we care about, mapped to HF API endpoints
+export const HF_QUERIES = [
+    { endpoint: 'models', filter: 'text-generation', limit: 50 },
+    { endpoint: 'models', filter: 'feature-extraction', limit: 25 },
+    { endpoint: 'models', filter: 'text2text-generation', limit: 25 },
+    { endpoint: 'datasets', filter: 'instruction-tuning', limit: 25 },
+    { endpoint: 'spaces', filter: 'chatbot', limit: 25 }
+];
+export async function searchHuggingFace(opts = {}) {
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const now = opts.now ?? new Date();
+    const fetchedAt = now.toISOString();
+    const headers = {
+        Accept: 'application/json',
+        'User-Agent': 'agora-cli'
+    };
+    const byId = new Map();
+    for (const query of HF_QUERIES) {
+        const url = `https://huggingface.co/api/${query.endpoint}?filter=${query.filter}&sort=downloads&direction=-1&limit=${query.limit}`;
+        try {
+            const res = await fetcher(url, { headers, signal: opts.signal });
+            if (!res.ok)
+                continue;
+            const json = (await res.json());
+            for (const item of json ?? []) {
+                if (!item.id || !item.id.includes('/'))
+                    continue;
+                if (!byId.has(item.id)) {
+                    byId.set(item.id, { raw: item, endpoint: query.endpoint });
+                }
+            }
+        }
+        catch {
+            continue; // graceful; we have cache fallback
+        }
+    }
+    const items = [];
+    for (const { raw, endpoint } of byId.values()) {
+        if (!passesHf(raw, now))
+            continue;
+        items.push(toHubItem(raw, endpoint, fetchedAt));
+    }
+    // Sort by downloads (installs) descending
+    items.sort((a, b) => b.installs - a.installs);
+    return items;
+}
+function passesHf(item, _now) {
+    if (item.private)
+        return false;
+    if (!item.id || !item.author)
+        return false;
+    const downloads = item.downloads ?? 0;
+    const likes = item.likes ?? 0;
+    // Lower threshold than GitHub stars — HF downloads are noisier
+    if (downloads < 100 && likes < 5)
+        return false;
+    return true;
+}
+function toHubItem(raw, endpoint, fetchedAt) {
+    const [author, name] = raw.id.split('/');
+    return {
+        id: `hf:${raw.id}`,
+        source: 'hf',
+        name: name ?? raw.id,
+        description: raw.pipeline_tag
+            ? `${raw.pipeline_tag} ${endpoint.slice(0, -1)}` // 'text-generation model'
+            : endpoint.slice(0, -1), // fallback
+        author: author ?? raw.author ?? 'unknown',
+        version: 'main',
+        category: categorizeHf(endpoint, raw),
+        tags: Array.from(new Set([...(raw.tags ?? []), raw.pipeline_tag, raw.library_name].filter(Boolean))),
+        stars: raw.likes ?? 0,
+        installs: raw.downloads ?? 0,
+        repository: `https://huggingface.co/${raw.id}`,
+        createdAt: raw.createdAt ?? fetchedAt,
+        pricing: { kind: 'free' },
+        fetchedAt,
+        pushedAt: raw.lastModified ?? fetchedAt,
+        license: null, // HF licenses are buried — leave null for v1
+        topics: raw.tags ?? []
+    };
+}
+function categorizeHf(_endpoint, _raw) {
+    // Models/datasets/spaces all map to 'workflow' for v1 — they're not MCP/skills/prompts.
+    // Refine later if needed.
+    return 'workflow';
+}
+//# sourceMappingURL=huggingface.js.map

package/dist/hubs/huggingface.js.map

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

package/dist/hubs/quality.d.ts

@@ -0,0 +1,26 @@
+import type { HubItem } from './types.js';
+export interface RawGithubRepo {
+    id: number;
+    full_name: string;
+    name: string;
+    owner: {
+        login: string;
+    };
+    description: string | null;
+    html_url: string;
+    stargazers_count: number;
+    forks_count: number;
+    pushed_at: string;
+    created_at: string;
+    archived: boolean;
+    license: {
+        spdx_id: string | null;
+    } | null;
+    topics: string[];
+    default_branch: string;
+}
+export declare function passes(repo: RawGithubRepo, now: Date): boolean;
+export declare function score(repo: RawGithubRepo, now: Date): number;
+export declare function categorize(repo: RawGithubRepo): HubItem['category'];
+export declare function toHubItem(repo: RawGithubRepo, fetchedAt: string): HubItem;
+//# sourceMappingURL=quality.d.ts.map

package/dist/hubs/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/hubs/quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAS9D;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAO5D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAWnE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAoBzE"}

package/dist/hubs/quality.js

@@ -0,0 +1,57 @@
+export function passes(repo, now) {
+    if (repo.archived)
+        return false;
+    if (repo.stargazers_count < 10)
+        return false;
+    if (!repo.description || repo.description.trim().length < 10)
+        return false;
+    if (!repo.license || !repo.license.spdx_id)
+        return false;
+    const pushed = new Date(repo.pushed_at).getTime();
+    const ageDays = (now.getTime() - pushed) / (1000 * 60 * 60 * 24);
+    if (ageDays > 365)
+        return false; // not abandoned
+    return true;
+}
+export function score(repo, now) {
+    // Stars (log-scaled) + recency boost. Used for sorting; not a hard gate.
+    const stars = Math.log10(Math.max(1, repo.stargazers_count));
+    const pushed = new Date(repo.pushed_at).getTime();
+    const ageDays = Math.max(1, (now.getTime() - pushed) / (1000 * 60 * 60 * 24));
+    const recency = 1 / Math.log10(ageDays + 10);
+    return stars * 0.7 + recency * 0.3;
+}
+export function categorize(repo) {
+    const topics = repo.topics.map((t) => t.toLowerCase());
+    const desc = (repo.description ?? '').toLowerCase();
+    if (topics.some((t) => t === 'mcp' || t === 'model-context-protocol') ||
+        desc.includes('mcp server'))
+        return 'mcp';
+    if (topics.some((t) => t === 'claude-skill' || t === 'skill'))
+        return 'skill';
+    if (topics.some((t) => t === 'prompt' || t === 'prompts'))
+        return 'prompt';
+    return 'workflow';
+}
+export function toHubItem(repo, fetchedAt) {
+    return {
+        id: `gh:${repo.full_name}`,
+        source: 'github',
+        name: repo.name,
+        description: repo.description ?? '',
+        author: repo.owner.login,
+        version: repo.default_branch,
+        category: categorize(repo),
+        tags: Array.from(new Set([...repo.topics, repo.license?.spdx_id ?? ''].filter(Boolean))),
+        stars: repo.stargazers_count,
+        installs: repo.stargazers_count, // proxy for v1
+        repository: repo.html_url,
+        createdAt: repo.created_at,
+        pricing: { kind: 'free' },
+        fetchedAt,
+        pushedAt: repo.pushed_at,
+        license: repo.license?.spdx_id ?? null,
+        topics: repo.topics
+    };
+}
+//# sourceMappingURL=quality.js.map

package/dist/hubs/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../src/hubs/quality.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,MAAM,CAAC,IAAmB,EAAE,GAAS;IACnD,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,IAAI,CAAC,gBAAgB,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACjE,IAAI,OAAO,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC,CAAC,gBAAgB;IACjD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAmB,EAAE,GAAS;IAClD,yEAAyE;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC7C,OAAO,KAAK,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,IACE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,wBAAwB,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAE3B,OAAO,KAAK,CAAC;IACf,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,SAAiB;IAC9D,OAAO;QACL,EAAE,EAAE,MAAM,IAAI,CAAC,SAAS,EAAE;QAC1B,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;QACxB,OAAO,EAAE,IAAI,CAAC,cAAc;QAC5B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACxF,KAAK,EAAE,IAAI,CAAC,gBAAgB;QAC5B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe;QAChD,UAAU,EAAE,IAAI,CAAC,QAAQ;QACzB,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACzB,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,SAAS;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;QACtC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/hubs/types.d.ts

@@ -0,0 +1,30 @@
+export type Pricing = {
+    kind: 'free';
+} | {
+    kind: 'paid';
+    amountCents: number;
+    currency: string;
+    provider: 'stripe' | 'lemon';
+};
+export type InstallKind = 'git-clone' | 'mcp-config-patch' | 'package-install';
+export interface HubItem {
+    id: string;
+    source: 'github' | 'hf';
+    name: string;
+    description: string;
+    author: string;
+    version: string;
+    category: 'mcp' | 'prompt' | 'workflow' | 'skill';
+    tags: string[];
+    stars: number;
+    installs: number;
+    repository: string;
+    npmPackage?: string;
+    createdAt: string;
+    pricing: Pricing;
+    fetchedAt: string;
+    pushedAt: string;
+    license: string | null;
+    topics: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hubs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hubs/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAE/E,MAAM,WAAW,OAAO;IAGtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/hubs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hubs/types.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAmBlD,eAAO,MAAM,KAAK,EAAE,MAufnB,CAAC;AAEF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAmBlD,eAAO,MAAM,KAAK,EAAE,MAsdnB,CAAC;AAEF,eAAe,KAAK,CAAC"}