@felix-ayush/openhearth 2.0.0

package/dist/cli.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import { APP_NAME, auditToCsv, auditToJson, fullAuditToCsv, fullAuditToJson, parseMonth, runAudit, runFullAudit, setAuthToken, } from "@felix-ayush/openhearth-core";
+import { printAuditSection, printBanner, printError, printFullReport, printInsights, printProgress, } from "./format.js";
+function usage() {
+    return `
+${APP_NAME} — audit GitHub contributions the activity feed hides
+
+Usage:
+  openhearth audit <username> [options]
+  openhearth hidden <username> [options]
+
+Commands:
+  audit     Full PR + issue + review audit (default)
+  hidden    Quick report: repos hidden from the activity sidebar
+
+Options:
+  --month YYYY-MM     Audit a calendar month (e.g. 2026-07)
+  --from YYYY-MM-DD   Custom range start
+  --to YYYY-MM-DD     Custom range end
+  --kind pr|issue|review|all   Default: all
+  --token TOKEN       GitHub PAT (or set GITHUB_TOKEN)
+  --json [file]       Export JSON (stdout if no file)
+  --csv [file]        Export CSV (stdout if no file)
+  --quiet             Minimal output
+  -h, --help          Show help
+
+Examples:
+  npx @felix-ayush/openhearth audit Ayush7614 --month 2026-07
+  npx @felix-ayush/openhearth hidden Ayush7614 --month 2026-07
+  npx @felix-ayush/openhearth audit torvalds --from 2026-01-01 --to 2026-01-31 --json report.json
+
+Unique features:
+  · Finds ALL repos via Search API (not truncated like github.com activity)
+  · Reports how many repos the profile sidebar likely hides
+  · Auto-splits date ranges past GitHub's 1000-result search cap
+  · Full audit: PRs + issues + reviews in one run
+`;
+}
+function parseArgs(argv) {
+    const opts = {
+        command: "audit",
+        username: "",
+        kind: "all",
+        quiet: false,
+        hidden: false,
+        help: false,
+    };
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "-h" || arg === "--help") {
+            opts.help = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            opts.quiet = true;
+            continue;
+        }
+        if (arg === "--month" && argv[i + 1]) {
+            opts.month = argv[++i];
+            continue;
+        }
+        if (arg === "--from" && argv[i + 1]) {
+            opts.from = argv[++i];
+            continue;
+        }
+        if (arg === "--to" && argv[i + 1]) {
+            opts.to = argv[++i];
+            continue;
+        }
+        if (arg === "--token" && argv[i + 1]) {
+            opts.token = argv[++i];
+            continue;
+        }
+        if (arg === "--kind" && argv[i + 1]) {
+            opts.kind = argv[++i];
+            continue;
+        }
+        if (arg === "--json") {
+            opts.json = argv[i + 1] && !argv[i + 1].startsWith("-") ? argv[++i] : "-";
+            continue;
+        }
+        if (arg === "--csv") {
+            opts.csv = argv[i + 1] && !argv[i + 1].startsWith("-") ? argv[++i] : "-";
+            continue;
+        }
+        if (!arg.startsWith("-")) {
+            positional.push(arg);
+        }
+    }
+    if (positional[0] === "audit" || positional[0] === "hidden") {
+        opts.command = positional[0];
+        opts.username = (positional[1] ?? "").replace(/^@/, "");
+        if (opts.command === "hidden")
+            opts.hidden = true;
+    }
+    else {
+        opts.username = (positional[0] ?? "").replace(/^@/, "");
+    }
+    return opts;
+}
+function resolveRange(opts) {
+    if (opts.month) {
+        return parseMonth(opts.month);
+    }
+    if (opts.from && opts.to) {
+        return { from: opts.from, to: opts.to };
+    }
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = now.getMonth() + 1;
+    return parseMonth(`${year}-${String(month).padStart(2, "0")}`);
+}
+function rangeLabel(range, month) {
+    if (month)
+        return month;
+    return `${range.from} → ${range.to}`;
+}
+function writeOutput(content, path) {
+    if (!path || path === "-") {
+        console.log(content);
+        return;
+    }
+    writeFileSync(path, content, "utf8");
+    console.error(`  Wrote ${path}`);
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.help || !opts.username) {
+        console.log(usage());
+        process.exit(opts.help ? 0 : 1);
+    }
+    if (opts.token)
+        setAuthToken(opts.token);
+    const range = resolveRange(opts);
+    const label = rangeLabel(range, opts.month);
+    const onProgress = opts.quiet ? undefined : printProgress;
+    if (!opts.quiet)
+        printBanner();
+    try {
+        if (opts.hidden || opts.command === "hidden") {
+            const full = await runFullAudit(opts.username, range, runAudit, onProgress);
+            if (!opts.quiet) {
+                printInsights(full.insights, `@${opts.username} · ${label}`);
+                console.log(`  ${full.insights.feedTruncationNote}\n`);
+            }
+            if (opts.json)
+                writeOutput(fullAuditToJson(full), opts.json);
+            return;
+        }
+        if (opts.kind === "all") {
+            const full = await runFullAudit(opts.username, range, runAudit, onProgress);
+            if (opts.json)
+                writeOutput(fullAuditToJson(full), opts.json);
+            if (opts.csv)
+                writeOutput(fullAuditToCsv(full), opts.csv);
+            if (!opts.quiet && !opts.json && !opts.csv) {
+                printFullReport(full, label);
+            }
+            return;
+        }
+        const result = await runAudit(opts.username, opts.kind, range, onProgress);
+        if (opts.json)
+            writeOutput(auditToJson(result), opts.json);
+        if (opts.csv)
+            writeOutput(auditToCsv(result), opts.csv);
+        if (!opts.quiet && !opts.json && !opts.csv) {
+            printAuditSection(opts.kind === "pr" ? "Pull requests" : opts.kind === "issue" ? "Issues" : "Reviews", result);
+        }
+    }
+    catch (err) {
+        printError(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+main();

package/dist/format.js

@@ -0,0 +1,69 @@
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const amber = (s) => `\x1b[33m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+export function printBanner() {
+    console.log("");
+    console.log(bold("  OpenHearth") + dim(" · contribution audit"));
+    console.log("");
+}
+export function printInsights(insights, rangeLabel) {
+    console.log(bold("  Summary") + dim(` · ${rangeLabel}`));
+    console.log("");
+    console.log(`  Total contributions   ${bold(String(insights.totalContributions))}`);
+    console.log(`  Unique repositories   ${bold(String(insights.uniqueRepos))}`);
+    console.log(`  PR merge rate         ${bold(`${insights.mergeRate}%`)}`);
+    console.log(`  By kind               PRs ${insights.byKind.pr} · Issues ${insights.byKind.issue} · Reviews ${insights.byKind.review}`);
+    if (insights.busiestDay) {
+        console.log(`  Busiest day           ${insights.busiestDay}`);
+    }
+    console.log("");
+    if (insights.reposHiddenByFeed > 0) {
+        console.log(amber("  ⚠ Hidden by activity feed"));
+        console.log(dim(`  Feed shows ~${insights.reposVisibleOnFeed} repos; Search API found ${insights.uniqueRepos}.`));
+        console.log(dim(`  ~${insights.reposHiddenByFeed} repositories may not appear on your profile sidebar.`));
+        console.log("");
+    }
+    if (insights.topRepos.length > 0) {
+        console.log(bold("  Top repositories"));
+        for (const { repo, count } of insights.topRepos.slice(0, 8)) {
+            console.log(`  ${dim("·")} ${repo} ${dim(String(count))}`);
+        }
+        console.log("");
+    }
+}
+export function printAuditSection(title, result) {
+    console.log(bold(`  ${title}`) + dim(` · ${result.total} across ${result.repos.length} repos`));
+    if (result.repos.length === 0) {
+        console.log(dim("  (none)"));
+        console.log("");
+        return;
+    }
+    for (const repo of result.repos.slice(0, 6)) {
+        const parts = [
+            repo.merged ? green(`${repo.merged} merged`) : "",
+            repo.open ? `${repo.open} open` : "",
+            repo.closed ? dim(`${repo.closed} closed`) : "",
+        ].filter(Boolean);
+        console.log(`  ${dim("▸")} ${repo.repo} ${dim(parts.join(" · "))}`);
+    }
+    if (result.repos.length > 6) {
+        console.log(dim(`  … and ${result.repos.length - 6} more repositories`));
+    }
+    console.log("");
+}
+export function printFullReport(result, rangeLabel) {
+    printInsights(result.insights, `@${result.username} · ${rangeLabel}`);
+    printAuditSection("Pull requests", result.pullRequests);
+    printAuditSection("Issues", result.issues);
+    printAuditSection("Reviews", result.reviews);
+    console.log(dim(`  ${result.insights.feedTruncationNote}`));
+    console.log("");
+}
+export function printError(message) {
+    console.error(red(`\n  Error: ${message}\n`));
+}
+export function printProgress(message) {
+    console.error(dim(`  ${message}`));
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@felix-ayush/openhearth",
+  "version": "2.0.0",
+  "description": "CLI to audit every GitHub PR, issue, and review — including what the activity feed hides",
+  "type": "module",
+  "bin": {
+    "openhearth": "./dist/cli.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "github",
+    "contributions",
+    "pull-requests",
+    "open-source",
+    "audit",
+    "cli"
+  ],
+  "license": "MIT",
+  "author": "Ayush Kumar",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ayush7614/OpenHearth.git"
+  },
+  "homepage": "https://ayush7614.github.io/OpenHearth/",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/Ayush7614/OpenHearth/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@felix-ayush/openhearth-core": "2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  }
+}