github-weekly-reporter 0.1.0

package/dist/renderer/themes.js

@@ -0,0 +1,180 @@
+// Theme CSS definitions for report rendering
+const THEMES = {
+    default: {
+        bg: "#ffffff",
+        bgCard: "#f6f8fa",
+        text: "#1f2328",
+        textSecondary: "#656d76",
+        border: "#d0d7de",
+        accent: "#0969da",
+        heatmapEmpty: "#ebedf0",
+        heatmapL1: "#9be9a8",
+        heatmapL2: "#40c463",
+        heatmapL3: "#30a14e",
+        heatmapL4: "#216e39",
+    },
+    dark: {
+        bg: "#0d1117",
+        bgCard: "#161b22",
+        text: "#e6edf3",
+        textSecondary: "#8b949e",
+        border: "#30363d",
+        accent: "#58a6ff",
+        heatmapEmpty: "#161b22",
+        heatmapL1: "#0e4429",
+        heatmapL2: "#006d32",
+        heatmapL3: "#26a641",
+        heatmapL4: "#39d353",
+    },
+};
+export const getThemeColors = (theme) => THEMES[theme] ?? THEMES.default;
+export const buildCSS = (theme) => {
+    const c = getThemeColors(theme);
+    return `
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      background: ${c.bg};
+      color: ${c.text};
+      line-height: 1.6;
+      padding: 2rem 1rem;
+    }
+    .container { max-width: 860px; margin: 0 auto; }
+
+    /* Header */
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 1rem;
+      margin-bottom: 2rem;
+      padding-bottom: 1.5rem;
+      border-bottom: 1px solid ${c.border};
+    }
+    .avatar {
+      width: 64px;
+      height: 64px;
+      border-radius: 50%;
+      border: 2px solid ${c.border};
+    }
+    .header-text h1 { font-size: 1.5rem; font-weight: 600; }
+    .header-text .date-range { color: ${c.textSecondary}; font-size: 0.875rem; }
+
+    /* Stats cards */
+    .stats {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+      gap: 0.75rem;
+      margin-bottom: 2rem;
+    }
+    .stat-card {
+      background: ${c.bgCard};
+      border: 1px solid ${c.border};
+      border-radius: 8px;
+      padding: 1rem;
+      text-align: center;
+    }
+    .stat-card .value { font-size: 1.75rem; font-weight: 700; color: ${c.accent}; }
+    .stat-card .label { font-size: 0.75rem; color: ${c.textSecondary}; text-transform: uppercase; letter-spacing: 0.05em; }
+
+    /* Section */
+    .section { margin-bottom: 2rem; }
+    .section h2 {
+      font-size: 1.125rem;
+      font-weight: 600;
+      margin-bottom: 0.75rem;
+      padding-bottom: 0.5rem;
+      border-bottom: 1px solid ${c.border};
+    }
+
+    /* Heatmap */
+    .heatmap {
+      display: flex;
+      gap: 4px;
+      justify-content: center;
+    }
+    .heatmap-day {
+      width: 36px;
+      height: 36px;
+      border-radius: 4px;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      font-size: 0.625rem;
+      color: ${c.textSecondary};
+    }
+    .heatmap-day .count { font-weight: 700; font-size: 0.75rem; color: ${c.text}; }
+    .heatmap-level-0 { background: ${c.heatmapEmpty}; }
+    .heatmap-level-1 { background: ${c.heatmapL1}; }
+    .heatmap-level-2 { background: ${c.heatmapL2}; }
+    .heatmap-level-3 { background: ${c.heatmapL3}; }
+    .heatmap-level-4 { background: ${c.heatmapL4}; }
+
+    /* Language bar */
+    .lang-bar {
+      display: flex;
+      height: 10px;
+      border-radius: 5px;
+      overflow: hidden;
+      margin-bottom: 0.75rem;
+    }
+    .lang-bar-segment { height: 100%; }
+    .lang-list {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 0.75rem;
+      list-style: none;
+      font-size: 0.8125rem;
+    }
+    .lang-list li { display: flex; align-items: center; gap: 0.35rem; }
+    .lang-dot { width: 10px; height: 10px; border-radius: 50%; display: inline-block; }
+    .lang-pct { color: ${c.textSecondary}; }
+
+    /* Repos table */
+    .repo-table { width: 100%; border-collapse: collapse; font-size: 0.875rem; }
+    .repo-table th, .repo-table td {
+      padding: 0.5rem 0.75rem;
+      text-align: left;
+      border-bottom: 1px solid ${c.border};
+    }
+    .repo-table th {
+      font-weight: 600;
+      color: ${c.textSecondary};
+      font-size: 0.75rem;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+    }
+    .repo-table a { color: ${c.accent}; text-decoration: none; }
+    .repo-table a:hover { text-decoration: underline; }
+
+    /* AI narrative */
+    .narrative {
+      background: ${c.bgCard};
+      border: 1px solid ${c.border};
+      border-radius: 8px;
+      padding: 1.25rem;
+      font-size: 0.9375rem;
+      line-height: 1.75;
+    }
+
+    /* Footer */
+    .footer {
+      margin-top: 3rem;
+      padding-top: 1.5rem;
+      border-top: 1px solid ${c.border};
+      text-align: center;
+      font-size: 0.8125rem;
+      color: ${c.textSecondary};
+    }
+    .footer a { color: ${c.accent}; text-decoration: none; }
+    .footer a:hover { text-decoration: underline; }
+
+    /* Responsive */
+    @media (max-width: 600px) {
+      .stats { grid-template-columns: repeat(2, 1fr); }
+      .header { flex-direction: column; text-align: center; }
+      .heatmap-day { width: 28px; height: 28px; }
+    }
+  `;
+};
+//# sourceMappingURL=themes.js.map

package/dist/renderer/themes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.js","sourceRoot":"","sources":["../../src/renderer/themes.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAkB7C,MAAM,MAAM,GAA+B;IACzC,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,SAAS;QACxB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,SAAS;QACvB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,SAAS;QACxB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,SAAS;QACvB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAY,EAAe,EAAE,CAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;AAElC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAU,EAAE;IAC/C,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEhC,OAAO;;;;oBAIW,CAAC,CAAC,EAAE;eACT,CAAC,CAAC,IAAI;;;;;;;;;;;;;iCAaY,CAAC,CAAC,MAAM;;;;;;0BAMf,CAAC,CAAC,MAAM;;;wCAGM,CAAC,CAAC,aAAa;;;;;;;;;;oBAUnC,CAAC,CAAC,MAAM;0BACF,CAAC,CAAC,MAAM;;;;;uEAKqC,CAAC,CAAC,MAAM;qDAC1B,CAAC,CAAC,aAAa;;;;;;;;;iCASnC,CAAC,CAAC,MAAM;;;;;;;;;;;;;;;;;;eAkB1B,CAAC,CAAC,aAAa;;yEAE2C,CAAC,CAAC,IAAI;qCAC1C,CAAC,CAAC,YAAY;qCACd,CAAC,CAAC,SAAS;qCACX,CAAC,CAAC,SAAS;qCACX,CAAC,CAAC,SAAS;qCACX,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;yBAoBvB,CAAC,CAAC,aAAa;;;;;;;iCAOP,CAAC,CAAC,MAAM;;;;eAI1B,CAAC,CAAC,aAAa;;;;;6BAKD,CAAC,CAAC,MAAM;;;;;oBAKjB,CAAC,CAAC,MAAM;0BACF,CAAC,CAAC,MAAM;;;;;;;;;;;8BAWJ,CAAC,CAAC,MAAM;;;eAGvB,CAAC,CAAC,aAAa;;yBAEL,CAAC,CAAC,MAAM;;;;;;;;;GAS9B,CAAC;AACJ,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export type DailyCommitCount = {
+    date: string;
+    count: number;
+};
+export type RepositoryActivity = {
+    name: string;
+    commits: number;
+    prsOpened: number;
+    prsMerged: number;
+    issuesOpened: number;
+    issuesClosed: number;
+    url: string;
+};
+export type LanguageBreakdown = {
+    language: string;
+    bytes: number;
+    percentage: number;
+    color: string;
+};
+export type PullRequest = {
+    title: string;
+    url: string;
+    repository: string;
+    state: "open" | "merged" | "closed";
+    createdAt: string;
+    mergedAt: string | null;
+};
+export type Issue = {
+    title: string;
+    url: string;
+    repository: string;
+    state: "open" | "closed";
+    createdAt: string;
+    closedAt: string | null;
+};
+export type WeeklyStats = {
+    totalCommits: number;
+    prsOpened: number;
+    prsMerged: number;
+    prsReviewed: number;
+    issuesOpened: number;
+    issuesClosed: number;
+};
+export type WeeklyReportData = {
+    username: string;
+    avatarUrl: string;
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    stats: WeeklyStats;
+    dailyCommits: DailyCommitCount[];
+    repositories: RepositoryActivity[];
+    languages: LanguageBreakdown[];
+    pullRequests: PullRequest[];
+    issues: Issue[];
+    aiNarrative: string | null;
+};
+export type LLMProvider = "openai" | "anthropic" | "gemini";
+export type Theme = "default" | "dark";
+export type ReportConfig = {
+    githubToken: string;
+    llmProvider: LLMProvider | null;
+    llmApiKey: string | null;
+    llmModel: string | null;
+    theme: Theme;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Weekly report data types
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "github-weekly-reporter",
+  "version": "0.1.0",
+  "description": "Generate beautiful weekly GitHub activity reports with optional AI narratives",
+  "type": "module",
+  "bin": {
+    "github-weekly-reporter": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "src/renderer/templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "github",
+    "weekly-report",
+    "activity",
+    "github-action",
+    "developer-tools"
+  ],
+  "author": "deariary",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deariary/github-weekly-reporter.git"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.82.0",
+    "@google/generative-ai": "^0.24.1",
+    "@octokit/graphql": "^8.2.1",
+    "commander": "^14.0.3",
+    "handlebars": "^4.7.9",
+    "openai": "^6.33.0",
+    "smol-toml": "^1.6.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/node": "^22.14.1",
+    "eslint": "^9.24.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.29.1",
+    "vitest": "^3.1.1"
+  }
+}

package/src/renderer/templates/partials/footer.hbs

@@ -0,0 +1,3 @@
+<footer class="footer">
+  <p>Generated by <a href="https://deariary.com?utm_source=github-weekly-reporter&utm_medium=footer">deariary</a></p>
+</footer>

package/src/renderer/templates/partials/header.hbs

@@ -0,0 +1,7 @@
+<header class="header">
+  <img class="avatar" src="{{avatarUrl}}" alt="{{username}}" />
+  <div class="header-text">
+    <h1>{{username}}'s Weekly Report</h1>
+    <p class="date-range">{{dateRange.from}} - {{dateRange.to}}</p>
+  </div>
+</header>

package/src/renderer/templates/partials/heatmap.hbs

@@ -0,0 +1,11 @@
+<div class="section">
+  <h2>Contribution Graph</h2>
+  <div class="heatmap">
+    {{#each dailyCommits}}
+    <div class="heatmap-day heatmap-level-{{heatmapLevel this.count}}">
+      <span class="count">{{this.count}}</span>
+      <span>{{weekday this.date}}</span>
+    </div>
+    {{/each}}
+  </div>
+</div>

package/src/renderer/templates/partials/languages.hbs

@@ -0,0 +1,19 @@
+{{#if languages.length}}
+<div class="section">
+  <h2>Languages</h2>
+  <div class="lang-bar">
+    {{#each languages}}
+    <div class="lang-bar-segment" style="width:{{this.percentage}}%;background:{{this.color}}"></div>
+    {{/each}}
+  </div>
+  <ul class="lang-list">
+    {{#each languages}}
+    <li>
+      <span class="lang-dot" style="background:{{this.color}}"></span>
+      <span>{{this.language}}</span>
+      <span class="lang-pct">{{fixed this.percentage 1}}%</span>
+    </li>
+    {{/each}}
+  </ul>
+</div>
+{{/if}}

package/src/renderer/templates/partials/narrative.hbs

@@ -0,0 +1,10 @@
+{{#if aiNarrative}}
+<div class="section">
+  <h2>AI Summary</h2>
+  <div class="narrative">
+    {{#each (paragraphs aiNarrative)}}
+    <p>{{this}}</p>
+    {{/each}}
+  </div>
+</div>
+{{/if}}

package/src/renderer/templates/partials/repositories.hbs

@@ -0,0 +1,25 @@
+{{#if repositories.length}}
+<div class="section">
+  <h2>Active Repositories</h2>
+  <table class="repo-table">
+    <thead>
+      <tr>
+        <th>Repository</th>
+        <th>PRs Opened</th>
+        <th>PRs Merged</th>
+        <th>Issues</th>
+      </tr>
+    </thead>
+    <tbody>
+      {{#each repositories}}
+      <tr>
+        <td><a href="{{this.url}}">{{this.name}}</a></td>
+        <td>{{this.prsOpened}}</td>
+        <td>{{this.prsMerged}}</td>
+        <td>{{this.issuesOpened}}</td>
+      </tr>
+      {{/each}}
+    </tbody>
+  </table>
+</div>
+{{/if}}

package/src/renderer/templates/partials/stats.hbs

@@ -0,0 +1,8 @@
+<div class="stats">
+  {{#each statCards}}
+  <div class="stat-card">
+    <div class="value">{{this.value}}</div>
+    <div class="label">{{this.label}}</div>
+  </div>
+  {{/each}}
+</div>

package/src/renderer/templates/report.hbs

@@ -0,0 +1,27 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <title>{{username}}'s Weekly Report ({{dateRange.from}} - {{dateRange.to}})</title>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="description" content="GitHub activity report: {{stats.totalCommits}} commits, {{stats.prsOpened}} PRs, {{stats.issuesOpened}} issues" />
+  <meta property="og:title" content="{{username}}'s Weekly Report ({{dateRange.from}} - {{dateRange.to}})" />
+  <meta property="og:description" content="GitHub activity report: {{stats.totalCommits}} commits, {{stats.prsOpened}} PRs, {{stats.issuesOpened}} issues" />
+  <meta property="og:image" content="{{avatarUrl}}" />
+  <meta property="og:type" content="website" />
+  <style>{{{css}}}</style>
+</head>
+<body>
+<div class="container">
+
+  {{> header}}
+  {{> stats}}
+  {{> heatmap}}
+  {{> languages}}
+  {{> repositories}}
+  {{> narrative}}
+  {{> footer}}
+
+</div>
+</body>
+</html>