unhappychoice unhappychoice · 2026-03-29 - 2026-04-04

Building github-weekly-reporter from zero to npm package

Shipped a complete GitHub activity reporting tool with AI narratives, i18n support, and automated deployment in one intensive week

This week was all about building github-weekly-reporter from the ground up - a tool that generates beautiful weekly development reports from GitHub activity data. What started as a simple idea turned into a full-featured package with AI integration, internationalization, and automated deployment capabilities.

The development followed a clear progression: core data collection and rendering, then AI narrative generation, followed by deployment automation and GitHub Actions integration. Tuesday and Friday were the heaviest coding days with 161 and 153 commits respectively, showing the sprint-like intensity of getting this project to a shippable state.

By week's end, I had a complete npm package published under the @deariary scope, with comprehensive CI/CD pipelines and ready-to-use GitHub Actions for automated weekly report generation. The tool now supports multiple LLM providers, 10 languages, and generates SEO-optimized static sites with social sharing capabilities.

Summary

4 sections
repo-summary
Laser focus on github-weekly-reporter
The deariary/github-weekly-reporter repository dominated this week with 19 of the 20 total PRs. This was pure greenfield development, building everything from the initial TypeScript scaffold to a production-ready npm package. The remaining activity was just maintenance across my other projects - a dependency bump in cycle-flyer and some review work.
deariary/github-weekly-reporter 20 PRs
bitflyer-tools/cycle-flyer 2 PRs
unhappychoice/gitlogue 1 PRs
unhappychoice/cycle-pusher 1 PRs
unhappychoice/mdts 1 PRs
deariary/github-weekly-reporter 19 PRs other repos 1 PR reviews given 48
architecture
Full-stack developer tooling architecture
Built a complete pipeline from GitHub API data collection through AI narrative generation to static site deployment. The architecture includes GraphQL and REST API integration, multi-provider LLM abstraction (OpenAI, Anthropic, Gemini), timezone-aware date handling, and automated GitHub Pages deployment. Added comprehensive SEO features including OG image generation, JSON-LD structured data, and sitemap generation.
API integrations GraphQL + REST LLM providers 3 supported languages 10 i18n
activity-pattern
Sprint-style development with two peak days
Tuesday and Friday were the heavy lifting days with 161 and 153 commits each, showing intense focused development sessions. The middle of the week had more moderate activity around 30-90 commits per day, likely spent on refinement and testing. This pattern suggests I was tackling the core architecture challenges on the peak days and polishing features during the quieter periods.
26
Sun
102
Mon
29
Tue
161
Wed
88
Thu
58
Fri
153
Sat
peak day Tue 161 second peak Fri 153 total commits 476
devops
Production-ready CI/CD and npm publishing
Set up complete automation for a professional open-source project. Added GitHub Actions for CI (lint, build, test) and automated npm publishing with provenance on releases. The package is now available as @deariary/github-weekly-reporter with proper scoping and access controls. Also built the GitHub Action integration so users can automate their weekly reports with a simple workflow file.
CI workflow Node 24 npm scope @deariary GitHub Action ready

Highlights

5 items
pr
deariary/github-weekly-reporter · merged Mar 29 · +3903 -0 · 16 files
The foundation PR that started everything - set up the TypeScript project structure and implemented the core GitHub API integration using GraphQL for efficient data collection.
pr
deariary/github-weekly-reporter · merged Apr 1 · +313 -2 · 11 files
Added the AI narrative feature with multi-provider support and graceful degradation. This turned the tool from a simple data collector into an intelligent report generator.
pr
deariary/github-weekly-reporter · merged Apr 2 · +1734 -133 · 35 files
Major internationalization effort that fixed timezone handling and added support for 10 languages. The date range calculation now works correctly for developers in any timezone.
pr
deariary/github-weekly-reporter · merged Apr 3 · +1166 -15 · 17 files
Comprehensive SEO implementation that makes the generated reports social-media ready with proper OG images and structured data for search engines.
pr
deariary/github-weekly-reporter · merged Apr 4 · +103 -1 · 3 files
The final piece that made this a professional open-source project - automated testing and publishing workflows that ensure quality and streamline releases.
Share 𝕏 in 🦋