ghscout 0.1.0

package/dist/github/cache.js

@@ -0,0 +1,51 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/** Repo metadata TTL: 24 hours */
+export const REPO_TTL = 24 * 60 * 60 * 1000;
+/** Issue data TTL: 1 hour */
+export const ISSUE_TTL = 60 * 60 * 1000;
+function getCacheDir() {
+    const xdg = process.env.XDG_CACHE_HOME;
+    const base = xdg || join(homedir(), ".cache");
+    return join(base, "ghscout");
+}
+/**
+ * Generate a cache key from a URL and optional params.
+ * Returns the first 16 chars of a sha256 hex digest.
+ */
+export function getCacheKey(url, params) {
+    const input = params
+        ? url + JSON.stringify(params, Object.keys(params).sort())
+        : url;
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/**
+ * Read a cached value. Returns null if missing or expired.
+ */
+export async function getCached(key, ttlMs) {
+    try {
+        const filePath = join(getCacheDir(), `${key}.json`);
+        const raw = await readFile(filePath, "utf-8");
+        const entry = JSON.parse(raw);
+        if (Date.now() - entry.timestamp > ttlMs) {
+            return null;
+        }
+        return entry.data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a value to the cache.
+ */
+export async function setCache(key, data) {
+    const dir = getCacheDir();
+    await mkdir(dir, { recursive: true });
+    const filePath = join(dir, `${key}.json`);
+    const entry = { data, timestamp: Date.now() };
+    await writeFile(filePath, JSON.stringify(entry), "utf-8");
+}
+//# sourceMappingURL=cache.js.map

package/dist/github/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/github/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,kCAAkC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAOxC,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACvC,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,MAA+B;IAE/B,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,CAAC,CAAC,GAAG,CAAC;IACR,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAe,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,IAAa;IAEb,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAe,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC1D,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC"}

package/dist/github/client.d.ts

@@ -0,0 +1,24 @@
+export declare class RateLimitError extends Error {
+    resetAt: number;
+    constructor(resetAt: number);
+}
+export declare class GitHubClient {
+    private token;
+    private rateLimit;
+    private rateLimitRemaining;
+    private searchRateLimit;
+    private searchRateLimitRemaining;
+    private searchRateLimitReset;
+    private lastSearchTime;
+    /** Minimum delay between consecutive search requests (ms) */
+    private static SEARCH_DELAY_MS;
+    constructor(token: string | null);
+    private isSearchUrl;
+    private applySearchThrottle;
+    private trackSearchRateLimit;
+    get<T>(url: string, params?: Record<string, string>): Promise<T>;
+    getPaginated<T>(url: string, params?: Record<string, string>, maxPages?: number): Promise<T[]>;
+    private trackRateLimit;
+    private parseNextLink;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAe,SAAQ,KAAK;IACpB,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAInC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,wBAAwB,CAAuB;IACvD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,cAAc,CAAa;IAEnC,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAC,eAAe,CAAQ;gBAE1B,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,WAAW;YAIL,mBAAmB;IA+BjC,OAAO,CAAC,oBAAoB;IAkBtB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA8BhE,YAAY,CAAC,CAAC,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,GAAE,MAAiB,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAkCf,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,aAAa;CAMtB"}

package/dist/github/client.js

@@ -0,0 +1,140 @@
+import { buildHeaders } from "./auth.js";
+export class RateLimitError extends Error {
+    resetAt;
+    constructor(resetAt) {
+        super(`GitHub API rate limit exhausted. Resets at ${new Date(resetAt * 1000).toISOString()}`);
+        this.resetAt = resetAt;
+        this.name = "RateLimitError";
+    }
+}
+export class GitHubClient {
+    token;
+    rateLimit = null;
+    rateLimitRemaining = null;
+    searchRateLimit = null;
+    searchRateLimitRemaining = null;
+    searchRateLimitReset = null;
+    lastSearchTime = 0;
+    /** Minimum delay between consecutive search requests (ms) */
+    static SEARCH_DELAY_MS = 2000;
+    constructor(token) {
+        this.token = token;
+    }
+    isSearchUrl(url) {
+        return url.includes("/search/");
+    }
+    async applySearchThrottle() {
+        // If search rate limit is exhausted, wait for reset
+        if (this.searchRateLimitRemaining !== null && this.searchRateLimitRemaining === 0 && this.searchRateLimitReset !== null) {
+            const waitMs = Math.max(0, this.searchRateLimitReset * 1000 - Date.now());
+            if (waitMs > 0) {
+                process.stderr.write(`Search rate limit exhausted. Waiting ${Math.ceil(waitMs / 1000)}s for reset...\n`);
+                await new Promise((resolve) => setTimeout(resolve, waitMs));
+            }
+        }
+        // Warn when search rate limit is low
+        if (this.searchRateLimit !== null &&
+            this.searchRateLimitRemaining !== null &&
+            this.searchRateLimitRemaining > 0 &&
+            this.searchRateLimitRemaining < 5) {
+            process.stderr.write(`Search rate limit low (${this.searchRateLimitRemaining}/${this.searchRateLimit} remaining). Slowing down...\n`);
+        }
+        // Enforce minimum delay between search requests
+        const elapsed = Date.now() - this.lastSearchTime;
+        if (this.lastSearchTime > 0 && elapsed < GitHubClient.SEARCH_DELAY_MS) {
+            await new Promise((resolve) => setTimeout(resolve, GitHubClient.SEARCH_DELAY_MS - elapsed));
+        }
+    }
+    trackSearchRateLimit(response) {
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        const limit = response.headers.get("x-ratelimit-limit");
+        const reset = response.headers.get("x-ratelimit-reset");
+        if (limit !== null) {
+            this.searchRateLimit = parseInt(limit, 10);
+        }
+        if (remaining !== null) {
+            this.searchRateLimitRemaining = parseInt(remaining, 10);
+        }
+        if (reset !== null) {
+            this.searchRateLimitReset = parseInt(reset, 10);
+        }
+        this.lastSearchTime = Date.now();
+    }
+    async get(url, params) {
+        const isSearch = this.isSearchUrl(url);
+        if (isSearch) {
+            await this.applySearchThrottle();
+        }
+        const fullUrl = new URL(url);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                fullUrl.searchParams.set(key, value);
+            }
+        }
+        const headers = buildHeaders(this.token);
+        const response = await fetch(fullUrl.toString(), { headers });
+        if (isSearch) {
+            this.trackSearchRateLimit(response);
+        }
+        else {
+            this.trackRateLimit(response);
+        }
+        if (!response.ok) {
+            throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async getPaginated(url, params, maxPages = Infinity) {
+        let results = [];
+        let nextUrl = url;
+        let page = 0;
+        // Build initial URL with params
+        if (params && nextUrl) {
+            const fullUrl = new URL(nextUrl);
+            for (const [key, value] of Object.entries(params)) {
+                fullUrl.searchParams.set(key, value);
+            }
+            nextUrl = fullUrl.toString();
+        }
+        while (nextUrl && page < maxPages) {
+            const headers = buildHeaders(this.token);
+            const response = await fetch(nextUrl, { headers });
+            this.trackRateLimit(response);
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            results = results.concat(data);
+            page++;
+            nextUrl = this.parseNextLink(response.headers.get("link"));
+        }
+        return results;
+    }
+    trackRateLimit(response) {
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        const limit = response.headers.get("x-ratelimit-limit");
+        const reset = response.headers.get("x-ratelimit-reset");
+        if (limit !== null) {
+            this.rateLimit = parseInt(limit, 10);
+        }
+        if (remaining !== null) {
+            this.rateLimitRemaining = parseInt(remaining, 10);
+        }
+        if (this.rateLimitRemaining !== null && this.rateLimitRemaining === 0) {
+            const resetAt = reset ? parseInt(reset, 10) : 0;
+            throw new RateLimitError(resetAt);
+        }
+        if (this.rateLimit !== null &&
+            this.rateLimitRemaining !== null &&
+            this.rateLimitRemaining / this.rateLimit <= 0.2) {
+            process.stderr.write(`Warning: GitHub API rate limit low — ${this.rateLimitRemaining}/${this.rateLimit} requests remaining\n`);
+        }
+    }
+    parseNextLink(linkHeader) {
+        if (!linkHeader)
+            return null;
+        const match = linkHeader.match(/<([^>]+)>;\s*rel="next"/);
+        return match ? match[1] : null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

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

package/dist/github/fetchers.d.ts

@@ -0,0 +1,13 @@
+import { GitHubClient } from "./client.js";
+import type { RepoMeta, Issue, Pull, FetchOptions } from "./types.js";
+/**
+ * Parse a period string like "30d" into an ISO 8601 date string
+ * representing that many days before now.
+ */
+export declare function parsePeriod(period: string): string;
+export declare function fetchRepoMeta(client: GitHubClient, fullName: string): Promise<RepoMeta>;
+export declare function fetchIssues(client: GitHubClient, fullName: string, opts?: FetchOptions): Promise<Issue[]>;
+export declare function fetchPulls(client: GitHubClient, fullName: string, opts?: FetchOptions): Promise<Pull[]>;
+export declare function fetchOrgRepos(client: GitHubClient, org: string, minStars?: number): Promise<RepoMeta[]>;
+export declare function searchReposByTopic(client: GitHubClient, topic: string, lang?: string, minStars?: number): Promise<RepoMeta[]>;
+//# sourceMappingURL=fetchers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchers.d.ts","sourceRoot":"","sources":["../../src/github/fetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAItE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASlD;AAUD,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,KAAK,EAAE,CAAC,CA8BlB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,IAAI,EAAE,CAAC,CAkBjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CASrB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAerB"}

package/dist/github/fetchers.js

@@ -0,0 +1,142 @@
+const BASE = "https://api.github.com";
+/**
+ * Parse a period string like "30d" into an ISO 8601 date string
+ * representing that many days before now.
+ */
+export function parsePeriod(period) {
+    const match = period.match(/^(\d+)d$/);
+    if (!match) {
+        throw new Error(`Invalid period format: "${period}". Expected format like "30d".`);
+    }
+    const days = parseInt(match[1], 10);
+    const date = new Date();
+    date.setDate(date.getDate() - days);
+    return date.toISOString();
+}
+function splitFullName(fullName) {
+    const [owner, repo] = fullName.split("/");
+    if (!owner || !repo) {
+        throw new Error(`Invalid repo format: "${fullName}". Expected "owner/repo".`);
+    }
+    return { owner, repo };
+}
+export async function fetchRepoMeta(client, fullName) {
+    const { owner, repo } = splitFullName(fullName);
+    const data = await client.get(`${BASE}/repos/${owner}/${repo}`);
+    return {
+        owner,
+        repo,
+        fullName: data.full_name ?? fullName,
+        stars: data.stargazers_count ?? 0,
+        pushedAt: data.pushed_at ?? "",
+        topics: data.topics ?? [],
+        language: data.language ?? null,
+        description: data.description ?? "",
+    };
+}
+export async function fetchIssues(client, fullName, opts = {}) {
+    const { owner, repo } = splitFullName(fullName);
+    const limit = opts.limit ?? 200;
+    const perPage = Math.min(limit, 100);
+    const maxPages = Math.ceil(limit / perPage);
+    const params = {
+        state: opts.state ?? "open",
+        per_page: String(perPage),
+        sort: "reactions-+1",
+        direction: "desc",
+    };
+    // Only apply period filter if explicitly requested
+    if (opts.period) {
+        params.since = parsePeriod(opts.period);
+    }
+    const data = await client.getPaginated(`${BASE}/repos/${owner}/${repo}/issues`, params, maxPages);
+    // Filter out pull requests (GitHub issues API includes PRs)
+    const issues = data.filter((item) => !item.pull_request);
+    return issues.slice(0, limit).map(mapIssue);
+}
+export async function fetchPulls(client, fullName, opts = {}) {
+    const { owner, repo } = splitFullName(fullName);
+    const limit = opts.limit ?? 100;
+    const perPage = Math.min(limit, 100);
+    const params = {
+        state: opts.state ?? "closed",
+        per_page: String(perPage),
+        sort: "created",
+        direction: "desc",
+    };
+    const data = await client.get(`${BASE}/repos/${owner}/${repo}/pulls`, params);
+    return data.slice(0, limit).map(mapPull);
+}
+export async function fetchOrgRepos(client, org, minStars = 0) {
+    const data = await client.get(`${BASE}/orgs/${org}/repos`, { sort: "stars", per_page: "100", direction: "desc" });
+    return data
+        .filter((r) => (r.stargazers_count ?? 0) >= minStars)
+        .map(mapRepoMeta);
+}
+export async function searchReposByTopic(client, topic, lang, minStars) {
+    let q = `topic:${topic}`;
+    if (lang) {
+        q += ` language:${lang}`;
+    }
+    if (minStars !== undefined && minStars > 0) {
+        q += ` stars:>=${minStars}`;
+    }
+    const data = await client.get(`${BASE}/search/repositories`, { q, sort: "stars" });
+    return (data.items ?? []).map(mapRepoMeta);
+}
+// --- mapping helpers ---
+function mapRepoMeta(data) {
+    const fullName = data.full_name;
+    const [owner, repo] = fullName.split("/");
+    return {
+        owner,
+        repo,
+        fullName,
+        stars: data.stargazers_count ?? 0,
+        pushedAt: data.pushed_at ?? "",
+        topics: data.topics ?? [],
+        language: data.language ?? null,
+        description: data.description ?? "",
+    };
+}
+function mapIssue(data) {
+    const reactions = data.reactions;
+    const labels = data.labels ?? [];
+    const user = data.user;
+    return {
+        number: data.number,
+        title: data.title,
+        body: data.body ?? "",
+        labels: labels.map((l) => (typeof l === "string" ? l : l.name)),
+        reactions: {
+            thumbsUp: reactions?.["+1"] ?? 0,
+            thumbsDown: reactions?.["-1"] ?? 0,
+            total: reactions?.total_count ?? 0,
+        },
+        commentsCount: data.comments ?? 0,
+        createdAt: data.created_at,
+        htmlUrl: data.html_url,
+        user: user?.login ?? "",
+        state: data.state,
+    };
+}
+function mapPull(data) {
+    const reactions = data.reactions;
+    const user = data.user;
+    const mergedAt = data.merged_at ?? null;
+    return {
+        number: data.number,
+        title: data.title,
+        merged: mergedAt !== null,
+        mergedAt,
+        reactions: {
+            thumbsUp: reactions?.["+1"] ?? 0,
+            thumbsDown: reactions?.["-1"] ?? 0,
+            total: reactions?.total_count ?? 0,
+        },
+        htmlUrl: data.html_url,
+        user: user?.login ?? "",
+        createdAt: data.created_at,
+    };
+}
+//# sourceMappingURL=fetchers.js.map

package/dist/github/fetchers.js.map

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

package/dist/github/types.d.ts

@@ -0,0 +1,46 @@
+export interface RepoMeta {
+    owner: string;
+    repo: string;
+    fullName: string;
+    stars: number;
+    pushedAt: string;
+    topics: string[];
+    language: string | null;
+    description: string;
+}
+export interface Issue {
+    number: number;
+    title: string;
+    body: string;
+    labels: string[];
+    reactions: {
+        thumbsUp: number;
+        thumbsDown: number;
+        total: number;
+    };
+    commentsCount: number;
+    createdAt: string;
+    htmlUrl: string;
+    user: string;
+    state: string;
+}
+export interface Pull {
+    number: number;
+    title: string;
+    merged: boolean;
+    mergedAt: string | null;
+    reactions: {
+        thumbsUp: number;
+        thumbsDown: number;
+        total: number;
+    };
+    htmlUrl: string;
+    user: string;
+    createdAt: string;
+}
+export interface FetchOptions {
+    limit?: number;
+    period?: string;
+    state?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/github/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/github/types.js

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

package/dist/github/types.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { runScan, runTopicScan } from './commands/scan.js';
+import { runOrgScan } from './commands/scan-org.js';
+import { runEvidence } from './commands/evidence.js';
+import { runTrending } from './commands/trending.js';
+const program = new Command();
+program
+    .name('ghscout')
+    .description('Evidence engine for product discovery from GitHub issues')
+    .version('0.1.0');
+// scan command
+program
+    .command('scan')
+    .description('Scan a repo, org, or topic for opportunity clusters')
+    .argument('[repo]', 'Repository in owner/repo format (e.g., vercel/next.js)')
+    .option('--org <org>', 'Scan top repos of a GitHub organization')
+    .option('--topic <topic>', 'Scan trending repos in a GitHub topic')
+    .option('--lang <language>', 'Filter repos by programming language (used with --topic)')
+    .option('--output <format>', 'Output format: json | table | pretty', 'pretty')
+    .option('--limit <n>', 'Max issues to fetch per repo', '200')
+    .option('--period <duration>', 'Time window: 7d, 30d, 90d (default: all open)')
+    .option('--min-stars <n>', 'Min repo stars to include', '100')
+    .option('--verbose', 'Show API calls and rate limit status', false)
+    .option('--no-cache', 'Skip cache, fetch fresh data')
+    .option('--top <n>', 'Show only top N clusters', '0')
+    .option('--min-reactions <n>', 'Minimum total reactions per cluster', '0')
+    .option('--json', 'Shorthand for --output json', false)
+    .option('--ai-score', 'Score opportunities using AI via Claude Code CLI', false)
+    .action(async (repo, cmdOpts) => {
+    const scanOpts = {
+        output: cmdOpts.json === true ? 'json' : cmdOpts.output,
+        limit: parseInt(cmdOpts.limit, 10),
+        period: cmdOpts.period || "",
+        minStars: parseInt(cmdOpts.minStars, 10),
+        verbose: cmdOpts.verbose === true,
+        noCache: cmdOpts.cache === false,
+        top: parseInt(cmdOpts.top, 10) || 0,
+        minReactions: parseInt(cmdOpts.minReactions, 10) || 0,
+        aiScore: cmdOpts.aiScore === true,
+    };
+    const org = cmdOpts.org;
+    const topic = cmdOpts.topic;
+    const lang = cmdOpts.lang;
+    // Validate conflicting flags
+    const modes = [repo, org, topic].filter(Boolean);
+    if (modes.length > 1) {
+        console.error('Error: Cannot combine repo, --org, and --topic. Use only one.');
+        process.exit(1);
+    }
+    if (lang && !topic) {
+        console.error('Error: --lang can only be used with --topic.');
+        process.exit(1);
+    }
+    if (topic) {
+        await runTopicScan({
+            topic,
+            lang,
+            ...scanOpts,
+        });
+    }
+    else if (org) {
+        await runOrgScan(org, scanOpts);
+    }
+    else if (repo) {
+        await runScan(repo, scanOpts);
+    }
+    else {
+        console.error('Error: Provide a repo (owner/repo), --org <org>, or --topic <topic>.');
+        process.exit(1);
+    }
+});
+// evidence command
+program
+    .command('evidence')
+    .description('Deep-dive on a specific pain topic with hard numbers')
+    .argument('<repo>', 'Repository in owner/repo format (e.g., vercel/next.js)')
+    .argument('<query>', 'Search query (e.g., "auth middleware")')
+    .option('--output <format>', 'Output format: json | table | pretty', 'pretty')
+    .option('--sort <sort>', 'Sort by: reactions | recent | comments', 'reactions')
+    .option('--limit <n>', 'Max issues to return', '20')
+    .option('--verbose', 'Show API calls and rate limit status', false)
+    .option('--no-cache', 'Skip cache, fetch fresh data')
+    .option('--json', 'Shorthand for --output json', false)
+    .action(async (repo, query, cmdOpts) => {
+    await runEvidence(repo, query, {
+        output: cmdOpts.json === true ? 'json' : cmdOpts.output,
+        sort: cmdOpts.sort,
+        limit: parseInt(cmdOpts.limit, 10),
+        verbose: cmdOpts.verbose === true,
+        noCache: cmdOpts.cache === false,
+    });
+});
+// trending command
+program
+    .command('trending')
+    .description('Top pain clusters across GitHub right now')
+    .option('--output <format>', 'Output format: json | table | pretty', 'pretty')
+    .option('--top <n>', 'Show only top N clusters', '10')
+    .option('--topic <topic>', 'Filter by GitHub topic')
+    .option('--lang <language>', 'Filter by programming language')
+    .option('--verbose', 'Show API calls and rate limit status', false)
+    .option('--no-cache', 'Skip cache, fetch fresh data')
+    .option('--json', 'Shorthand for --output json', false)
+    .action(async (cmdOpts) => {
+    await runTrending({
+        output: cmdOpts.json === true ? 'json' : cmdOpts.output,
+        top: parseInt(cmdOpts.top, 10) || 10,
+        topic: cmdOpts.topic,
+        lang: cmdOpts.lang,
+        verbose: cmdOpts.verbose === true,
+        noCache: cmdOpts.cache === false,
+    });
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output/formatters.d.ts

@@ -0,0 +1,35 @@
+export interface ScoredCluster {
+    name: string;
+    issues: Array<{
+        number: number;
+        title: string;
+        htmlUrl: string;
+        reactions: {
+            total: number;
+        };
+        createdAt: string;
+    }>;
+    issueCount: number;
+    totalReactions: number;
+    labels: string[];
+    score: number;
+    breakdown: {
+        demand: number;
+        frequency: number;
+        frustration: number;
+        marketSize: number;
+        gap: number;
+    };
+}
+export interface OutputOptions {
+    format: "json" | "table" | "pretty";
+    top?: number;
+}
+export declare function formatScanResult(clusters: ScoredCluster[], opts: OutputOptions): string;
+export interface AIScoredCluster extends ScoredCluster {
+    aiScore: number;
+    verdict: "BUILD" | "SKIP" | "WATCH";
+    rationale: string;
+}
+export declare function formatAIScanResult(clusters: AIScoredCluster[], opts: OutputOptions): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/output/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/output/formatters.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgJD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,EAAE,aAAa,GAClB,MAAM,CASR;AAID,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AA4DD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EAAE,EAC3B,IAAI,EAAE,aAAa,GAClB,MAAM,CAoCR"}