daily-contributions

Track daily code contributions across all your git repos. Indexes LOC, commits, file churn, repo metadata, and ticket progress into a SQLite database and generates a single-page text report.

Setup

# 1. Configure author email(s)
echo "you@example.com" > config/emails.txt

# 2. Set the start date for indexing
echo "2025-01-01" > config/start-date.txt

# 3. Discover git repos under a folder
uv run tools/find_repos.py ~/code

Usage

# Generate the full report (indexes + prints)
make

# Or run steps individually:
make repos ROOT_DIR=~/code   # discover repos → config/repos.txt
make index                   # index all repos into SQLite
make report                  # index + generate report

make clean                   # delete the database
make backup                  # snapshot the database

The report is saved to reports/YYYY-MM-DD.txt.

Cleanup utilities

make node-modules ROOT_DIR=~/code      # report node_modules folders + sizes
make image-sequences ROOT_DIR=~/code   # detect image-sequence folders
make worktrees ROOT_DIR=~/code/repo    # classify git worktrees (dry-run)

make worktrees is dry-run by default and only prints what it would do. Pass --apply (via the underlying uv run tools/clean_worktrees.py ... --apply) to actually remove worktrees.

What the report includes

Section	Description
Daily contributions	Per-day additions, deletions, net LOC, files touched, and churn
Per-repo summary	Each repo's URL, creation date, commits, additions, deletions, net (author-filtered)
Totals	Aggregate commits, additions, deletions, net across all repos
Non-zero day averages	Average additions, deletions, net, commits, files touched, churn, and churn ratio
Module Growth Timeline	Chronological list of repos with creation date, URL, and activity status (active/stale/inactive/dormant)
Cumulative Module Count	Monthly cumulative count of repos
Repo Activity Summary	Count of repos by activity status
MuonTickets Summary	Per-repo archived vs total ticket counts
Ticket Completion	Overall completion percentage across all repos using MuonTickets
Unarchived Tickets	Table of every open ticket: repo, ID, status, title

Project structure

src/daily_contributions/
  constants.py         # Shared config file paths
  git_utils.py         # Git command wrappers
  discovery.py         # Walk a directory tree to discover git repos
  indexer.py           # Index daily LOC and repo metadata into SQLite
  report.py            # Generate the full text report from the database
tools/
  find_repos.py        # CLI: discover git repos
  index.py             # CLI: index LOC into SQLite
  report.py            # CLI: print the report
tests/                 # Unit tests for parsers and classifiers
Makefile               # Build pipeline
pyproject.toml         # Hatchling-built editable package
config/                # emails.txt, repos.txt, start-date.txt
data/                  # contributions.db (SQLite)
reports/               # Generated daily reports