github-lang-stats 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smallstack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# github-lang-stats
+
+CLI that computes **per-author** GitHub language statistics by inspecting the files changed in every commit authored by a given user.
+
+Unlike `GET /repos/{owner}/{repo}/languages` (which returns repo-wide bytes regardless of who wrote them), this tool only counts lines in files **you personally changed**.
+
+## How it works
+
+| Phase | API | Cost |
+|---|---|---|
+| 1. Discover repos | GraphQL `contributionsCollection` | ~20 calls (one per year) |
+| 2. Collect commit SHAs per repo | GraphQL `history(author: ...)` | ~1 call per 100 commits |
+| 3. Fetch per-commit file details | REST `GET /repos/:owner/:repo/commits/:sha` | 1 call per commit |
+
+Progress is cached in `.github-lang-stats-cache/<user>.json` so **interrupted runs resume from where they left off**.
+
+## Metric: `lines_changed`
+
+For each file in each commit we count `additions + deletions`. This is a proxy for "language activity" — it's not as precise as bytes stored, but it correctly reflects only work you did.
+
+## Installation & usage
+
+### npx (no install)
+
+```sh
+npx github-lang-stats --user=<github-username> --token=<pat> --output=stats.json
+```
+
+
+### Global install
+
+```sh
+npm i -g github-lang-stats
+gls --user=<github-username> --token=<pat>
+# or the long form:
+github-lang-stats --user=<github-username> --token=<pat>
+```
+
+
+### Programmatic API
+
+```sh
+npm i github-lang-stats
+```
+
+```ts
+import { getGithubLangStats } from "github-lang-stats";
+
+const stats = await getGithubLangStats({
+  user: "octocat",
+  token: process.env.GITHUB_TOKEN,
+  fromYear: 2020,              // optional, defaults to 10 years ago
+  excludeLanguages: ["JSON"],  // optional
+  onProgress: (e) => console.log(e),
+});
+
+console.log(stats.totals); // { TypeScript: 412000, … }
+```
+
+### Local development
+
+```sh
+npm install
+npm run build
+node dist/index.js --user=<github-username> --token=<pat> --output=stats.json
+```
+
+## Token scopes required
+
+| Scope | Why |
+|---|---|
+| `repo` | Read access to private repositories |
+| `read:user` | Fetch verified email addresses for commit matching |
+
+## Options
+
+```
+Usage: gls|github-lang-stats [options]
+
+Options:
+  -u, --user <username>      GitHub username (required)
+  -t, --token <pat>          GitHub PAT (required)
+  -o, --output <path>        Write JSON to file (default: stdout)
+  --cache <path>             Override cache file path
+  --no-cache                 Disable caching (start fresh each run)
+  --concurrency <n>          Concurrent REST requests (default: 5)
+  --from-year <year>         Earliest year to include (default: 10 years ago)
+  --exclude-langs <langs>    Comma-separated languages to exclude (e.g. HCL,JSON)
+  --select-repos             Interactively pick repos to analyse after commit counts are known
+  --stats-only               Re-aggregate from cache without fetching new data
+  --reset                    Delete cache and start fresh
+  -V, --version              Print version
+  -h, --help                 Print help
+```
+
+### `--select-repos` interactive picker
+
+When passed, after all commit SHAs have been collected the tool shows a full-screen
+checkbox list sorted by **number of commits** (highest first). All repos are pre-selected:
+
+```
+? Choose repos (42 total, sorted by commit count)
+❯◉ myorg/monorepo                                       1 248 commits
+ ◉ myorg/frontend                                         832 commits
+ ◉ octocat/personal-site                                  201 commits
+ ...
+```
+
+| Key | Action |
+|-----|--------|
+| `space` | Toggle selected repo |
+| `a` | Toggle **all** (select all / deselect all) |
+| `i` | Invert selection |
+| `enter` | Confirm and continue |
+
+## Output format
+
+```json
+{
+  "totals": {
+    "TypeScript": 412000,
+    "JavaScript": 88000,
+    "Svelte": 43000
+  },
+  "byRepo": {
+    "myorg/myrepo": {
+      "TypeScript": 200000,
+      "CSS": 5000
+    }
+  },
+  "meta": {
+    "user": "maxfriedmann",
+    "generatedAt": "2026-02-20T10:00:00.000Z",
+    "totalCommitsProcessed": 12450,
+    "totalRepos": 47,
+    "unit": "lines_changed"
+  }
+}
+```
+
+### Using the output in the CV widget
+
+The `totals` field maps directly to the `githubLanguageTotals` field in the CV widget schema — just copy it in.
+
+## Tips
+
+- **First run is slow** — at 5k req/hr with 30k commits it can take hours. Let it run overnight; it saves progress every 50 commits.
+- **Subsequent runs are fast** — only new commits since the last run are fetched.
+- **Exclude infrastructure languages** with `--exclude-langs HCL,Dockerfile` if teammates committed those to repos you also touched.
+- **Adjust concurrency** carefully — GitHub's [secondary rate limits](https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api) may trigger at high concurrency even if your primary limit is not exhausted. `5` is a safe default.

package/dist/aggregator.d.ts

@@ -0,0 +1,3 @@
+import type { AggregatedStats, CommitDetail } from "./types.js";
+export declare function aggregate(user: string, commitsByRepo: Record<string, string[]>, commitDetails: Record<string, CommitDetail | null>, excludeLanguages?: string[]): AggregatedStats;
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../src/aggregator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGhE,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,EAClD,gBAAgB,GAAE,MAAM,EAAO,GAC7B,eAAe,CA0DjB"}

package/dist/aggregator.js

@@ -0,0 +1,52 @@
+import { detectLanguage, isExcludedLanguage } from "./language-detector.js";
+// We accept the cache data object directly for aggregation
+export function aggregate(user, commitsByRepo, commitDetails, excludeLanguages = []) {
+    const totals = {};
+    const byRepo = {};
+    let totalCommitsProcessed = 0;
+    for (const [repoKey, shas] of Object.entries(commitsByRepo)) {
+        const repoLangs = {};
+        for (const sha of shas) {
+            const detail = commitDetails[sha];
+            if (!detail)
+                continue; // not yet fetched or errored
+            totalCommitsProcessed++;
+            for (const file of detail.files) {
+                const lang = detectLanguage(file.filename);
+                if (!lang)
+                    continue;
+                if (isExcludedLanguage(lang))
+                    continue;
+                if (excludeLanguages.includes(lang))
+                    continue;
+                const lines = file.additions + file.deletions;
+                repoLangs[lang] = (repoLangs[lang] ?? 0) + lines;
+                totals[lang] = (totals[lang] ?? 0) + lines;
+            }
+        }
+        if (Object.keys(repoLangs).length > 0) {
+            byRepo[repoKey] = repoLangs;
+        }
+    }
+    // Sort totals descending
+    const sortedTotals = Object.fromEntries(Object.entries(totals).sort(([, a], [, b]) => b - a));
+    // Sort byRepo entries descending within each repo
+    const sortedByRepo = Object.fromEntries(Object.entries(byRepo)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([repo, langs]) => [
+        repo,
+        Object.fromEntries(Object.entries(langs).sort(([, a], [, b]) => b - a))
+    ]));
+    return {
+        totals: sortedTotals,
+        byRepo: sortedByRepo,
+        meta: {
+            user,
+            generatedAt: new Date().toISOString(),
+            totalCommitsProcessed,
+            totalRepos: Object.keys(byRepo).length,
+            unit: "lines_changed"
+        }
+    };
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/aggregator.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,32 @@
+import type { CommitDetail, Repo } from "./types.js";
+export declare class CacheStore {
+    private path;
+    private data;
+    constructor(cachePath: string);
+    private load;
+    save(): void;
+    get repos(): Repo[];
+    set repos(repos: Repo[]);
+    get completedRepos(): string[];
+    isRepoComplete(owner: string, repo: string): boolean;
+    markRepoComplete(owner: string, repo: string): void;
+    getCommits(owner: string, repo: string): string[];
+    addCommits(owner: string, repo: string, shas: string[]): void;
+    hasCommitDetail(sha: string): boolean;
+    getCommitDetail(sha: string): CommitDetail | null | undefined;
+    setCommitDetail(sha: string, detail: CommitDetail | null): void;
+    /** How many commit details we still need to fetch */
+    pendingCommitCount(): number;
+    totalCommitShas(): number;
+    /** Returns cache file path */
+    get filePath(): string;
+    /** Returns a snapshot of the raw data needed for aggregation */
+    getAggregationData(): {
+        commitsByRepo: Record<string, string[]>;
+        commitDetails: Record<string, CommitDetail | null>;
+    };
+    /** Clear all cached data */
+    reset(): void;
+}
+export declare function defaultCachePath(user: string): string;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAS,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAc5D,qBAAa,UAAU;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAQ;gBAER,SAAS,EAAE,MAAM;IAK7B,OAAO,CAAC,IAAI;IAkBZ,IAAI,IAAI,IAAI;IAMZ,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAEtB;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,CAE7B;IAED,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOnD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS;IAI7D,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAI/D,qDAAqD;IACrD,kBAAkB,IAAI,MAAM;IAU5B,eAAe,IAAI,MAAM;IAQzB,8BAA8B;IAC9B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gEAAgE;IAChE,kBAAkB,IAAI;QACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;KACnD;IAOD,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAGb;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/cache.js

@@ -0,0 +1,117 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const CACHE_VERSION = 1;
+function emptyCache() {
+    return {
+        version: CACHE_VERSION,
+        repos: [],
+        completedRepos: [],
+        commitsByRepo: {},
+        commitDetails: {}
+    };
+}
+export class CacheStore {
+    path;
+    data;
+    constructor(cachePath) {
+        this.path = cachePath;
+        this.data = this.load();
+    }
+    load() {
+        if (!existsSync(this.path))
+            return emptyCache();
+        try {
+            const raw = readFileSync(this.path, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.version !== CACHE_VERSION) {
+                console.warn(`Cache version mismatch (got ${parsed.version}, expected ${CACHE_VERSION}). Starting fresh.`);
+                return emptyCache();
+            }
+            return parsed;
+        }
+        catch {
+            console.warn("Failed to read cache, starting fresh.");
+            return emptyCache();
+        }
+    }
+    save() {
+        const dir = dirname(this.path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.path, JSON.stringify(this.data, null, 2), "utf-8");
+    }
+    get repos() {
+        return this.data.repos;
+    }
+    set repos(repos) {
+        this.data.repos = repos;
+    }
+    get completedRepos() {
+        return this.data.completedRepos;
+    }
+    isRepoComplete(owner, repo) {
+        return this.data.completedRepos.includes(`${owner}/${repo}`);
+    }
+    markRepoComplete(owner, repo) {
+        const key = `${owner}/${repo}`;
+        if (!this.data.completedRepos.includes(key)) {
+            this.data.completedRepos.push(key);
+        }
+    }
+    getCommits(owner, repo) {
+        return this.data.commitsByRepo[`${owner}/${repo}`] ?? [];
+    }
+    addCommits(owner, repo, shas) {
+        const key = `${owner}/${repo}`;
+        const existing = this.data.commitsByRepo[key] ?? [];
+        const existingSet = new Set(existing);
+        const newShas = shas.filter((s) => !existingSet.has(s));
+        this.data.commitsByRepo[key] = [...existing, ...newShas];
+    }
+    hasCommitDetail(sha) {
+        return sha in this.data.commitDetails;
+    }
+    getCommitDetail(sha) {
+        return this.data.commitDetails[sha];
+    }
+    setCommitDetail(sha, detail) {
+        this.data.commitDetails[sha] = detail;
+    }
+    /** How many commit details we still need to fetch */
+    pendingCommitCount() {
+        let count = 0;
+        for (const shas of Object.values(this.data.commitsByRepo)) {
+            for (const sha of shas) {
+                if (!this.hasCommitDetail(sha))
+                    count++;
+            }
+        }
+        return count;
+    }
+    totalCommitShas() {
+        let count = 0;
+        for (const shas of Object.values(this.data.commitsByRepo)) {
+            count += shas.length;
+        }
+        return count;
+    }
+    /** Returns cache file path */
+    get filePath() {
+        return this.path;
+    }
+    /** Returns a snapshot of the raw data needed for aggregation */
+    getAggregationData() {
+        return {
+            commitsByRepo: this.data.commitsByRepo,
+            commitDetails: this.data.commitDetails
+        };
+    }
+    /** Clear all cached data */
+    reset() {
+        this.data = emptyCache();
+    }
+}
+export function defaultCachePath(user) {
+    return join(process.cwd(), ".github-lang-stats-cache", `${user}.json`);
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/github-client.d.ts

@@ -0,0 +1,20 @@
+import type { CommitDetail, RateLimitInfo, Repo } from "./types.js";
+export declare class GitHubClient {
+    private token;
+    private rateLimitRemaining;
+    private rateLimitReset;
+    constructor(token: string);
+    private headers;
+    private updateRateLimitFromHeaders;
+    /** Wait if we are close to the rate limit */
+    private throttle;
+    getRateLimitInfo(): RateLimitInfo;
+    graphql<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    discoverReposViaRest(): Promise<Repo[]>;
+    discoverReposViaContributions(user: string, fromYear?: number, onProgress?: (year: number) => void): Promise<Repo[]>;
+    discoverContributedRepos(user: string, fromYear?: number, onProgress?: (year: number) => void): Promise<Repo[]>;
+    getUserNodeId(username: string): Promise<string>;
+    collectCommitShas(owner: string, repo: string, authorId: string, onPage?: (count: number) => void, fromYear?: number): Promise<string[]>;
+    fetchCommitDetail(owner: string, repo: string, sha: string): Promise<CommitDetail | null>;
+}
+//# sourceMappingURL=github-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../src/github-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKpE,qBAAa,YAAY;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,cAAc,CAAK;gBAEf,KAAK,EAAE,MAAM;IAIzB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,0BAA0B;IAOlC,6CAA6C;YAC/B,QAAQ;IAWtB,gBAAgB,IAAI,aAAa;IAY3B,OAAO,CAAC,CAAC,GAAG,OAAO,EACxB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;IA2BP,oBAAoB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAoCvC,6BAA6B,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAO,EACf,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,EAAE,CAAC;IA8DZ,wBAAwB,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAO,EACf,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,EAAE,CAAC;IAsBZ,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhD,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;IAkEd,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CA0C/B"}

package/dist/github-client.js

@@ -0,0 +1,237 @@
+const GH_REST = "https://api.github.com";
+const GH_GRAPHQL = "https://api.github.com/graphql";
+export class GitHubClient {
+    token;
+    rateLimitRemaining = 5000;
+    rateLimitReset = 0;
+    constructor(token) {
+        this.token = token;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.token}`,
+            "Content-Type": "application/json",
+            "User-Agent": "github-lang-stats-cli/1.0",
+            Accept: "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28"
+        };
+    }
+    updateRateLimitFromHeaders(headers) {
+        const remaining = headers.get("x-ratelimit-remaining");
+        const reset = headers.get("x-ratelimit-reset");
+        if (remaining !== null)
+            this.rateLimitRemaining = parseInt(remaining, 10);
+        if (reset !== null)
+            this.rateLimitReset = parseInt(reset, 10);
+    }
+    /** Wait if we are close to the rate limit */
+    async throttle() {
+        if (this.rateLimitRemaining <= 10) {
+            const now = Math.floor(Date.now() / 1000);
+            const waitSeconds = Math.max(this.rateLimitReset - now + 5, 5);
+            process.stderr.write(`\nRate limit nearly exhausted. Waiting ${waitSeconds}s for reset...\n`);
+            await sleep(waitSeconds * 1000);
+        }
+    }
+    getRateLimitInfo() {
+        return {
+            limit: 5000,
+            remaining: this.rateLimitRemaining,
+            reset: this.rateLimitReset
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // GraphQL
+    // ---------------------------------------------------------------------------
+    async graphql(query, variables) {
+        await this.throttle();
+        const res = await fetch(GH_GRAPHQL, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({ query, variables })
+        });
+        this.updateRateLimitFromHeaders(res.headers);
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`GraphQL request failed (${res.status}): ${text}`);
+        }
+        const json = (await res.json());
+        if (json.errors?.length) {
+            // Don't throw on partial errors (e.g. repos with no default branch); just return data
+            if (!json.data)
+                throw new Error(`GraphQL errors: ${JSON.stringify(json.errors)}`);
+        }
+        return json.data;
+    }
+    // ---------------------------------------------------------------------------
+    // Discover repos via REST: all repos the user owns / collaborates on / is org member of
+    // This matches the same endpoint used by the in-app sync (fetchUserRepos) and typically
+    // returns many more repos than contributionsCollection alone.
+    // ---------------------------------------------------------------------------
+    async discoverReposViaRest() {
+        const repos = [];
+        let page = 1;
+        const perPage = 100;
+        while (true) {
+            const res = await fetch(`${GH_REST}/user/repos?affiliation=owner,collaborator,organization_member&per_page=${perPage}&page=${page}`, { headers: this.headers() });
+            this.updateRateLimitFromHeaders(res.headers);
+            if (!res.ok)
+                throw new Error(`Failed to fetch repos (${res.status})`);
+            const apiRepos = (await res.json());
+            if (apiRepos.length === 0)
+                break;
+            for (const r of apiRepos) {
+                repos.push({ owner: r.owner.login, name: r.name });
+            }
+            if (apiRepos.length < perPage)
+                break;
+            page++;
+        }
+        return repos;
+    }
+    // ---------------------------------------------------------------------------
+    // Discover repos via GraphQL contributionsCollection (year-by-year).
+    // Catches public repos the user contributed to via PRs but isn't a collaborator on.
+    // ---------------------------------------------------------------------------
+    async discoverReposViaContributions(user, fromYear = 2008, onProgress) {
+        const repoMap = new Map();
+        const currentYear = new Date().getFullYear();
+        for (let year = fromYear; year <= currentYear; year++) {
+            onProgress?.(year);
+            const from = `${year}-01-01T00:00:00Z`;
+            const to = `${year}-12-31T23:59:59Z`;
+            try {
+                const data = await this.graphql(`
+          query($login: String!, $from: DateTime!, $to: DateTime!) {
+            user(login: $login) {
+              contributionsCollection(from: $from, to: $to) {
+                commitContributionsByRepository(maxRepositories: 100) {
+                  repository {
+                    owner { login }
+                    name
+                  }
+                }
+              }
+            }
+          }
+        `, { login: user, from, to });
+                for (const entry of data.user.contributionsCollection
+                    .commitContributionsByRepository) {
+                    const key = `${entry.repository.owner.login}/${entry.repository.name}`;
+                    if (!repoMap.has(key)) {
+                        repoMap.set(key, {
+                            owner: entry.repository.owner.login,
+                            name: entry.repository.name
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                process.stderr.write(`  Warning: could not fetch contributions for ${year}: ${String(err)}\n`);
+            }
+            await sleep(100);
+        }
+        return [...repoMap.values()];
+    }
+    // ---------------------------------------------------------------------------
+    // Union of both discovery methods
+    // ---------------------------------------------------------------------------
+    async discoverContributedRepos(user, fromYear = 2008, onProgress) {
+        const repoMap = new Map();
+        // Source 1: REST — all repos the user has access to (owner/collaborator/org member)
+        const restRepos = await this.discoverReposViaRest();
+        for (const r of restRepos)
+            repoMap.set(`${r.owner}/${r.name}`, r);
+        // Source 2: GraphQL contributions — catches public repos contributed to via PRs
+        const contribRepos = await this.discoverReposViaContributions(user, fromYear, onProgress);
+        for (const r of contribRepos)
+            repoMap.set(`${r.owner}/${r.name}`, r);
+        return [...repoMap.values()];
+    }
+    // ---------------------------------------------------------------------------
+    // Get GitHub user node ID (for reliable author filtering)
+    // ---------------------------------------------------------------------------
+    async getUserNodeId(username) {
+        const data = await this.graphql(`query($login: String!) { user(login: $login) { id } }`, { login: username });
+        return data.user.id;
+    }
+    // ---------------------------------------------------------------------------
+    // Collect all commit SHAs authored by user in a repo (GraphQL pagination)
+    // ---------------------------------------------------------------------------
+    async collectCommitShas(owner, repo, authorId, onPage, fromYear) {
+        const shas = [];
+        let cursor = null;
+        const since = fromYear ? `${fromYear}-01-01T00:00:00Z` : undefined;
+        while (true) {
+            await this.throttle();
+            try {
+                const data = await this.graphql(`
+          query($owner: String!, $repo: String!, $authorId: ID!, $cursor: String, $since: GitTimestamp) {
+            repository(owner: $owner, name: $repo) {
+              defaultBranchRef {
+                target {
+                  ... on Commit {
+                    history(author: { id: $authorId }, first: 100, after: $cursor, since: $since) {
+                      nodes { oid }
+                      pageInfo { hasNextPage endCursor }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        `, { owner, repo: repo, authorId, cursor, since });
+                const history = data?.repository?.defaultBranchRef?.target?.history;
+                if (!history)
+                    break;
+                for (const node of history.nodes) {
+                    shas.push(node.oid);
+                }
+                onPage?.(shas.length);
+                if (!history.pageInfo.hasNextPage)
+                    break;
+                cursor = history.pageInfo.endCursor;
+            }
+            catch (err) {
+                process.stderr.write(`  Warning: error fetching commits for ${owner}/${repo}: ${String(err)}\n`);
+                break;
+            }
+        }
+        return shas;
+    }
+    // ---------------------------------------------------------------------------
+    // Fetch commit detail (files changed) via REST
+    // ---------------------------------------------------------------------------
+    async fetchCommitDetail(owner, repo, sha) {
+        await this.throttle();
+        const url = `${GH_REST}/repos/${owner}/${repo}/commits/${sha}`;
+        const res = await fetch(url, { headers: this.headers() });
+        this.updateRateLimitFromHeaders(res.headers);
+        if (res.status === 404 || res.status === 422)
+            return null;
+        if (!res.ok) {
+            if (res.status === 429 || res.status === 403) {
+                // Secondary rate limit — wait and retry once
+                const retryAfter = parseInt(res.headers.get("retry-after") ?? "60", 10);
+                process.stderr.write(`\nSecondary rate limit hit. Waiting ${retryAfter}s...\n`);
+                await sleep(retryAfter * 1000);
+                return this.fetchCommitDetail(owner, repo, sha);
+            }
+            throw new Error(`fetchCommitDetail failed (${res.status}) for ${owner}/${repo}@${sha}`);
+        }
+        const json = (await res.json());
+        return {
+            sha: json.sha,
+            files: (json.files ?? []).map((f) => ({
+                filename: f.filename,
+                additions: f.additions,
+                deletions: f.deletions,
+                status: f.status
+            }))
+        };
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=github-client.js.map