dev-summary

Dev Summary — Multi-Repo Development Stats & Timeline

Scans git repositories and produces combined development summaries with commit stats, timelines, and optional detailed reports.

Command Reference

Command	Purpose
/dev-summary quick	Quick summary table — dates + commit counts
/dev-summary detailed	Detailed report — files, contributors, frequency
/dev-summary timeline	HTML timeline dashboard with charts

---

/dev-summary quick

Generate a quick combined summary table for one or more repos.

Steps

1. Get repo paths — ask the user for repo paths if not provided. Accept:

   • Current directory (default)
   • Multiple paths (comma or space separated)
   • Glob patterns (e.g., ~/Projects/2026/*)

2. For each repo, extract:

   # First commit date
   git log --reverse --format="%ai" | head -1
   
   # Latest commit date
   git log --format="%ai" | head -1
   
   # Total commits
   git log --oneline | wc -l
   

3. Present combined table:

   ## Development Summary
   
   | Repo | Mula | Latest | Commits |
   |---|---|---|---|
   | **repo-name** | DD Mon YYYY | DD Mon YYYY | N |
   | **TOTAL** | **earliest** | **latest** | **sum** |
   
   - **Duration**: N days (N weeks)
   - **Average**: ~N commits/day across all repos
   

4. Run all repo scans in parallel — use parallel tool calls for each repo to minimize wait time.

Notes

• Repo name is derived from directory name
• Dates formatted as DD Mon YYYY (e.g., 8 Jan 2026)
• Duration calculated from earliest first commit to latest last commit
• Average commits/day = total commits / duration days

---

/dev-summary detailed

Generate a detailed development report with file counts, contributors, and commit frequency analysis.

Steps

1. Run quick summary first — get base stats from /dev-summary quick

2. For each repo, additionally extract:

   # Source file count (excluding vendor/node_modules/.git)
   find . -not -path './.git/*' -not -path './vendor/*' \
          -not -path './node_modules/*' -not -path './dist/*' \
          -type f | wc -l
   
   # Unique contributors
   git log --format="%aN <%aE>" | sort -u
   
   # Commits per month (last 6 months)
   git log --format="%Y-%m" | sort | uniq -c | tail -6
   
   # Most active day
   git log --format="%ai" | cut -d' ' -f1 | sort | uniq -c | sort -rn | head -1
   
   # Language/stack detection (check for key files)
   # composer.json → PHP/Laravel
   # package.json → Node/JS
   # go.mod → Go
   # Cargo.toml → Rust
   # pyproject.toml → Python