github-discover 0.1.0 → 0.1.1

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const popular_1 = require("./commands/popular");
+const trending_1 = require("./commands/trending");
+const topic_1 = require("./commands/topic");
+const program = new commander_1.Command();
+program
+    .name("github-discover")
+    .description("Discover newly created popular GitHub repositories and trending topics (daily/weekly/monthly/yearly).")
+    .version("0.1.0");
+program
+    .command("trending")
+    .description("List trending repositories based on lifetime stars per day, adjusted by repository age.")
+    .option("-p, --period <period>", "time period for repository creation window: daily | weekly | monthly | yearly", "daily")
+    .option("-n, --limit <number>", "maximum number of repositories to return (1-100)", "50")
+    .option("-l, --language <language>", "optional programming language filter, e.g. TypeScript")
+    .option("-s, --min-stars <number>", "minimum star count threshold (defaults: daily 60, weekly 500, monthly 4000, yearly 10000)")
+    .option("--json", "output JSON instead of a table", false)
+    .action(async (options) => {
+    try {
+        await (0, trending_1.runTrendingCommand)(options);
+    }
+    catch (err) {
+        const error = err;
+        console.error("Error:", error.message);
+        process.exitCode = 1;
+    }
+});
+program
+    .command("popular")
+    .description("List newly created popular repositories for a given period.")
+    .option("-p, --period <period>", "time period: daily | weekly | monthly | yearly", "daily")
+    .option("-n, --limit <number>", "maximum number of repositories to return (1-100)", "50")
+    .option("-l, --language <language>", "optional programming language filter, e.g. TypeScript")
+    .option("-s, --min-stars <number>", "minimum star count threshold (defaults: daily 60, weekly 500, monthly 4000, yearly 10000)")
+    .option("--json", "output JSON instead of a table", false)
+    .action(async (options) => {
+    try {
+        await (0, popular_1.runPopularCommand)(options);
+    }
+    catch (err) {
+        const error = err;
+        console.error("Error:", error.message);
+        process.exitCode = 1;
+    }
+});
+program
+    .command("topic")
+    .description("List trending repository topics for a given period based on frequency and stars.")
+    .option("-p, --period <period>", "time period: daily | weekly | monthly | yearly", "daily")
+    .option("-n, --limit <number>", "maximum number of topics to return (1-100)", "30")
+    .option("-l, --language <language>", "optional programming language filter, e.g. TypeScript")
+    .option("-s, --min-stars <number>", "minimum star count threshold (defaults: daily 60, weekly 500, monthly 4000, yearly 10000)")
+    .option("--json", "output JSON instead of a table", false)
+    .action(async (options) => {
+    try {
+        await (0, topic_1.runTopicCommand)(options);
+    }
+    catch (err) {
+        const error = err;
+        console.error("Error:", error.message);
+        process.exitCode = 1;
+    }
+});
+program.parseAsync(process.argv).catch((err) => {
+    const error = err;
+    console.error("Error:", error.message);
+    process.exit(1);
+});

package/dist/commands/popular.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPopularCommand = runPopularCommand;
+const client_1 = require("../github/client");
+const repoSearch_1 = require("../github/repoSearch");
+const dateRange_1 = require("../utils/dateRange");
+const output_1 = require("../utils/output");
+async function runPopularCommand(options) {
+    const periodInput = (options.period ?? "daily").toLowerCase();
+    const validPeriods = ["daily", "weekly", "monthly", "yearly"];
+    const defaultMinStarsByPeriod = {
+        daily: 60,
+        weekly: 500,
+        monthly: 4000,
+        yearly: 10000,
+    };
+    if (!validPeriods.includes(periodInput)) {
+        throw new Error(`Invalid period "${options.period}". Expected one of: daily, weekly, monthly, yearly.`);
+    }
+    const period = periodInput;
+    const limit = clampToInt(options.limit ?? "50", 1, 100, "limit");
+    const minStars = clampToInt(options.minStars ?? String(defaultMinStarsByPeriod[period]), 1, Number.MAX_SAFE_INTEGER, "min-stars");
+    const startDate = (0, dateRange_1.getStartDate)(period);
+    const client = new client_1.GitHubClient();
+    const repos = await (0, repoSearch_1.searchNewPopularRepositories)(client, {
+        startDate,
+        minStars,
+        language: options.language,
+        limit,
+    });
+    (0, output_1.printRepositories)(repos, { json: Boolean(options.json) });
+}
+function clampToInt(valueStr, min, max, label) {
+    const value = Number.parseInt(valueStr, 10);
+    if (Number.isNaN(value)) {
+        throw new Error(`Invalid number for ${label}: "${valueStr}".`);
+    }
+    const clamped = Math.min(Math.max(value, min), max);
+    return clamped;
+}

package/dist/commands/topic.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTopicCommand = runTopicCommand;
+const client_1 = require("../github/client");
+const repoSearch_1 = require("../github/repoSearch");
+const topicStats_1 = require("../github/topicStats");
+const dateRange_1 = require("../utils/dateRange");
+const output_1 = require("../utils/output");
+async function runTopicCommand(options) {
+    const periodInput = (options.period ?? "daily").toLowerCase();
+    const validPeriods = ["daily", "weekly", "monthly", "yearly"];
+    const defaultMinStarsByPeriod = {
+        daily: 60,
+        weekly: 500,
+        monthly: 4000,
+        yearly: 10000,
+    };
+    if (!validPeriods.includes(periodInput)) {
+        throw new Error(`Invalid period "${options.period}". Expected one of: daily, weekly, monthly, yearly.`);
+    }
+    const period = periodInput;
+    const limit = clampToInt(options.limit ?? "30", 1, 100, "limit");
+    const minStars = clampToInt(options.minStars ?? String(defaultMinStarsByPeriod[period]), 1, Number.MAX_SAFE_INTEGER, "min-stars");
+    const startDate = (0, dateRange_1.getStartDate)(period);
+    const client = new client_1.GitHubClient();
+    const searchOptions = {
+        startDate,
+        minStars,
+        language: options.language,
+        limit,
+    };
+    const { totalCount, repos } = await (0, repoSearch_1.searchRepositoriesForTopics)(client, searchOptions);
+    const stats = (0, topicStats_1.aggregateTopicStats)(repos, limit);
+    if (stats.length === 0) {
+        return;
+    }
+    (0, output_1.printTopicStats)(stats, { json: Boolean(options.json) });
+}
+function clampToInt(valueStr, min, max, label) {
+    const value = Number.parseInt(valueStr, 10);
+    if (Number.isNaN(value)) {
+        throw new Error(`Invalid number for ${label}: "${valueStr}".`);
+    }
+    const clamped = Math.min(Math.max(value, min), max);
+    return clamped;
+}

package/dist/commands/trending.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTrendingCommand = runTrendingCommand;
+const client_1 = require("../github/client");
+const repoSearch_1 = require("../github/repoSearch");
+const output_1 = require("../utils/output");
+async function runTrendingCommand(options) {
+    const periodInput = (options.period ?? "daily").toLowerCase();
+    const validPeriods = ["daily", "weekly", "monthly", "yearly"];
+    const windowDaysByPeriod = {
+        daily: 7,
+        weekly: 28,
+        monthly: 90,
+        yearly: 730,
+    };
+    const defaultMinStarsByPeriod = {
+        daily: 60,
+        weekly: 500,
+        monthly: 4000,
+        yearly: 10000,
+    };
+    if (!validPeriods.includes(periodInput)) {
+        throw new Error(`Invalid period "${options.period}". Expected one of: daily, weekly, monthly, yearly.`);
+    }
+    const period = periodInput;
+    const limit = clampToInt(options.limit ?? "50", 1, 100, "limit");
+    const minStars = clampToInt(options.minStars ?? String(defaultMinStarsByPeriod[period]), 1, Number.MAX_SAFE_INTEGER, "min-stars");
+    const windowDays = windowDaysByPeriod[period];
+    const client = new client_1.GitHubClient();
+    const repos = await (0, repoSearch_1.searchLifetimeFastGrowingRepositories)(client, {
+        windowDays,
+        minStars,
+        language: options.language,
+        limit,
+    });
+    (0, output_1.printRepositories)(repos, { json: Boolean(options.json) });
+}
+function clampToInt(valueStr, min, max, label) {
+    const value = Number.parseInt(valueStr, 10);
+    if (Number.isNaN(value)) {
+        throw new Error(`Invalid number for ${label}: "${valueStr}".`);
+    }
+    const clamped = Math.min(Math.max(value, min), max);
+    return clamped;
+}

package/dist/config.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGitHubToken = getGitHubToken;
+exports.getUserAgent = getUserAgent;
+function getGitHubToken() {
+    return process.env.GITHUB_TOKEN;
+}
+function getUserAgent() {
+    return "github-discover-cli/0.1.0";
+}

package/dist/github/client.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubClient = void 0;
+const config_1 = require("../config");
+class GitHubClient {
+    constructor() {
+        this.baseUrl = "https://api.github.com";
+    }
+    async request(path, params = {}) {
+        const url = new URL(this.baseUrl + path);
+        Object.entries(params).forEach(([key, value]) => {
+            if (value === undefined)
+                return;
+            url.searchParams.set(key, String(value));
+        });
+        const headers = {
+            "User-Agent": (0, config_1.getUserAgent)(),
+            Accept: "application/vnd.github+json",
+        };
+        const token = (0, config_1.getGitHubToken)();
+        if (token) {
+            headers.Authorization = `token ${token}`;
+        }
+        if (typeof fetch === "undefined") {
+            throw new Error("Global fetch is not available. Please run this CLI with Node.js 18+ where fetch is built-in.");
+        }
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers,
+        });
+        const text = await response.text();
+        let json;
+        try {
+            json = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            json = undefined;
+        }
+        if (!response.ok) {
+            const status = response.status;
+            const message = (json && json.message) ||
+                `GitHub API request failed with status ${status}`;
+            if (status === 401 || status === 403) {
+                const hint = (0, config_1.getGitHubToken)()
+                    ? "Check that your GITHUB_TOKEN is valid and has sufficient scopes."
+                    : "You may be hitting anonymous rate limits. Set GITHUB_TOKEN to increase limits.";
+                throw new Error(`${message} (${status}). ${hint}`);
+            }
+            if (status === 422) {
+                throw new Error(`${message} (${status}). Please check your search parameters.`);
+            }
+            throw new Error(`${message} (${status}).`);
+        }
+        return json;
+    }
+}
+exports.GitHubClient = GitHubClient;

package/dist/github/repoSearch.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchNewPopularRepositories = searchNewPopularRepositories;
+exports.searchRepositoriesForTopics = searchRepositoriesForTopics;
+exports.searchLifetimeFastGrowingRepositories = searchLifetimeFastGrowingRepositories;
+async function searchNewPopularRepositories(client, options) {
+    const { startDate, minStars, language, limit } = options;
+    const qualifiers = [
+        `created:>=${startDate}`,
+        `stars:>=${minStars}`,
+    ];
+    if (language) {
+        qualifiers.push(`language:${language}`);
+    }
+    const q = qualifiers.join(" ");
+    const perPage = Math.min(Math.max(limit, 1), 100);
+    const data = await client.request("/search/repositories", {
+        q,
+        sort: "stars",
+        order: "desc",
+        per_page: perPage,
+    });
+    return data.items.slice(0, limit);
+}
+async function searchRepositoriesForTopics(client, options) {
+    const { startDate, minStars, language } = options;
+    const qualifiers = [`created:>=${startDate}`, `stars:>=${minStars}`];
+    if (language) {
+        qualifiers.push(`language:${language}`);
+    }
+    const q = qualifiers.join(" ");
+    const data = await client.request("/search/repositories", {
+        q,
+        sort: "stars",
+        order: "desc",
+        per_page: 100,
+    });
+    return {
+        totalCount: data.total_count,
+        repos: data.items,
+    };
+}
+async function searchLifetimeFastGrowingRepositories(client, options) {
+    const { windowDays, minStars, language, limit } = options;
+    const startDate = getDateNDaysAgo(windowDays);
+    const qualifiers = [
+        `created:>=${startDate}`,
+        `stars:>=${minStars}`,
+    ];
+    if (language) {
+        qualifiers.push(`language:${language}`);
+    }
+    const q = qualifiers.join(" ");
+    const data = await client.request("/search/repositories", {
+        q,
+        sort: "stars",
+        order: "desc",
+        per_page: 100,
+    });
+    const items = data.items;
+    const MS_PER_DAY = 1000 * 60 * 60 * 24;
+    const SMOOTHING_DAYS = 30;
+    const now = Date.now();
+    items.sort((a, b) => {
+        const ageDaysARaw = Math.max((now - new Date(a.created_at).getTime()) / MS_PER_DAY, 1);
+        const ageDaysBRaw = Math.max((now - new Date(b.created_at).getTime()) / MS_PER_DAY, 1);
+        const ageDaysAEff = ageDaysARaw + SMOOTHING_DAYS;
+        const ageDaysBEff = ageDaysBRaw + SMOOTHING_DAYS;
+        const growthA = a.stargazers_count / ageDaysAEff;
+        const growthB = b.stargazers_count / ageDaysBEff;
+        return growthB - growthA;
+    });
+    return items.slice(0, limit);
+}
+function getDateNDaysAgo(days) {
+    const now = new Date();
+    const start = new Date(now);
+    start.setDate(now.getDate() - days);
+    const year = start.getFullYear();
+    const month = String(start.getMonth() + 1).padStart(2, "0");
+    const day = String(start.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}

package/dist/github/topicStats.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aggregateTopicStats = aggregateTopicStats;
+function aggregateTopicStats(repos, limit) {
+    const topicMap = new Map();
+    for (const repo of repos) {
+        if (!repo.topics || repo.topics.length === 0)
+            continue;
+        const uniqueTopics = new Set(repo.topics
+            .map((t) => t.trim())
+            .filter((t) => t.length > 0));
+        for (const topic of uniqueTopics) {
+            const current = topicMap.get(topic) ?? { repoCount: 0, starSum: 0 };
+            current.repoCount += 1;
+            current.starSum += repo.stargazers_count;
+            topicMap.set(topic, current);
+        }
+    }
+    const stats = [];
+    for (const [topic, { repoCount, starSum }] of topicMap.entries()) {
+        const score = repoCount * Math.log10(Math.max(starSum + 10, 1)); // 防止 log10(0)
+        stats.push({
+            topic,
+            score,
+            repoCount,
+            starSum,
+        });
+    }
+    stats.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        if (b.repoCount !== a.repoCount)
+            return b.repoCount - a.repoCount;
+        return a.topic.localeCompare(b.topic);
+    });
+    const safeLimit = Math.max(1, Math.min(limit, stats.length));
+    return stats.slice(0, safeLimit);
+}

package/dist/utils/dateRange.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStartDate = getStartDate;
+function getStartDate(period) {
+    const now = new Date();
+    const start = new Date(now);
+    switch (period) {
+        case "daily":
+            start.setDate(now.getDate() - 2);
+            break;
+        case "weekly":
+            start.setDate(now.getDate() - 7);
+            break;
+        case "monthly":
+            start.setDate(now.getDate() - 30);
+            break;
+        case "yearly":
+            start.setDate(now.getDate() - 365);
+            break;
+        default:
+            start.setDate(now.getDate() - 2);
+    }
+    const year = start.getFullYear();
+    const month = String(start.getMonth() + 1).padStart(2, "0");
+    const day = String(start.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}

package/dist/utils/output.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printRepositories = printRepositories;
+exports.printTopicStats = printTopicStats;
+function printRepositories(repos, options) {
+    const filteredRepos = repos.filter((r) => {
+        const langRaw = r.language ?? "";
+        const lang = langRaw.trim();
+        if (!lang || lang === "-") {
+            return false;
+        }
+        const lower = lang.toLowerCase();
+        return lower !== "html" && lower !== "shell";
+    });
+    if (options.json) {
+        const minimal = filteredRepos.map((r) => ({
+            name: r.name,
+            full_name: r.full_name,
+            html_url: r.html_url,
+            stars: r.stargazers_count,
+            language: r.language,
+            created_at: r.created_at,
+            description: r.description,
+        }));
+        console.log(JSON.stringify(minimal, null, 2));
+        return;
+    }
+    if (filteredRepos.length === 0) {
+        return;
+    }
+    const truncate = (text, maxLength) => text.length <= maxLength ? text : `${text.slice(0, maxLength - 1)}…`;
+    const rows = filteredRepos.map((r) => {
+        const lang = r.language ?? "-";
+        const created = r.created_at.slice(0, 10);
+        const description = r.description ? truncate(r.description, 150) : "-";
+        return {
+            name: r.full_name,
+            stars: String(r.stargazers_count),
+            lang,
+            created,
+            url: r.html_url,
+            description,
+        };
+    });
+    const headers = ["Name", "Stars", "Lang", "Created", "URL", "Description"];
+    const colWidths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => Object.values(row)[index].length)));
+    const formatRow = (cols) => cols
+        .map((col, i) => col.padEnd(colWidths[i], " "))
+        .join(" | ");
+    console.log(formatRow(headers));
+    console.log(formatRow(headers.map((h, i) => "".padEnd(colWidths[i], "-"))));
+    for (const row of rows) {
+        console.log(formatRow([
+            row.name,
+            row.stars,
+            row.lang,
+            row.created,
+            row.url,
+            row.description,
+        ]));
+    }
+}
+function printTopicStats(stats, options) {
+    if (options.json) {
+        const minimal = stats.map((s) => ({
+            topic: s.topic,
+        }));
+        console.log(JSON.stringify(minimal, null, 2));
+        return;
+    }
+    if (stats.length === 0) {
+        return;
+    }
+    const rows = stats.map((s, index) => ({
+        rank: String(index + 1),
+        topic: s.topic,
+    }));
+    const headers = ["Rank", "Topic"];
+    const colWidths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => Object.values(row)[index].length)));
+    const formatRow = (cols) => cols
+        .map((col, i) => col.padEnd(colWidths[i], " "))
+        .join(" | ");
+    console.log(formatRow(headers));
+    console.log(formatRow(headers.map((h, i) => "".padEnd(colWidths[i], "-"))));
+    for (const row of rows) {
+        console.log(formatRow([row.rank, row.topic]));
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-discover",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A minimal CLI to discover newly created popular GitHub repositories by day/week/month.",
   "bin": {
     "github-discover": "dist/cli.js"