pulse

Forge: Pulse

Generate a development health report — not a build command, a state observation tool. Think DORA metrics but qualitative, tailored to a repo using the Forge workflow.

Process

Run the following data collection steps, then generate an HTML report.

1. Git Velocity (last 30 days)

# Commits per week
git log --since="30 days ago" --pretty=format:"%ad" --date=format:"%Y-W%V" | sort | uniq -c

# Feat/fix/chore ratio
git log --since="30 days ago" --pretty=format:"%s" | awk '{print $1}' | sort | uniq -c | sort -rn

# Active days
git log --since="30 days ago" --pretty=format:"%ad" --date=short | sort -u | wc -l

# Commits per active day
echo "total_commits / active_days"

2. DORA-ish Metrics (qualitative)

Calculate these from git history:

Deployment Frequency:

# Count releases/deploys (release tags + deploy-marker commits)
git log --since="30 days ago" --oneline --grep="release:" --grep="deploy:" | wc -l
git tag --sort=-creatordate | head -10

Lead Time to Merge:

# For each merged branch in last 30 days:
# Time from first commit on branch → merge to main
# Use: git log --merges --since="30 days ago" then for each, find the branch's first commit date

Change Failure Rate:

# Reverts and hotfixes as % of total
git log --since="30 days ago" --oneline --grep="Revert" --grep="hotfix" --grep="revert" -i | wc -l

Time to Restore:

# Time between a revert commit and the fix commit (manual assessment from git log)

3. Branch Health

# All local branches with last commit date
git for-each-ref --sort=-committerdate refs/heads/ --format='%(committerdate:short) %(refname:short)'

# Worktrees
git worktree list

# Merged vs unmerged (against the project's default branch — main, master, develop, etc.)
git branch --merged | wc -l
git branch --no-merged | wc -l

# Stale remote branches (>30 days, no open PR)
git for-each-ref --sort=committerdate refs/remotes/origin/ --format='%(committerdate:short) %(refname:short)' | head -20