commitpulse 0.1.0__tar.gz

commitpulse-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.1
+Name: commitpulse
+Version: 0.1.0
+Summary: Premium Git repository analytics and dashboard generator
+Author: Antigravity AI
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# Commit Pulse 🚀
+
+Commit Pulse is a powerful, locally-first CLI tool that generates high-fidelity engineering dashboards for your Git repositories. It analyzes your development ecosystem, visualizes commit intensity heatmaps, and identifies top contributors using real GitHub profiles.
+
+## ✨ Key Features
+- **Zero-PAT Analysis**: Analyzes local `.git` metadata directly. No Personal Access Tokens or cloud APIs required for core stats.
+- **Accurate Project Timelines**: Dynamic contribution grids that span from the repository's inception to the **last official commit**.
+- **GitHub Profile Integration**: Automatically fetches actual contributor avatars via the public GitHub Search API.
+- **Master Scan**: A recursive drive scanner that aggregates stats from every project on your machine into a single interactive dashboard.
+- **Premium Aesthetics**: Glassmorphic UI with dark mode, smooth animations, and official GitHub iconography.
+
+## 📦 Installation
+
+### 1. Local (Developer Mode)
+If you have the source code locally:
+```bash
+pip install -e .
+```
+
+### 2. Direct from GitHub
+Anyone can install your tool directly if the repo is public:
+```bash
+pip install git+https://github.com/YOUR_USERNAME/commitpulse.git
+```
+
+### 3. Global Command
+Once installed, the `commitpulse` command is available everywhere in your terminal.
+
+## 🚀 Usage
+
+### Analyze the current repository
+```bash
+commitpulse
+```
+
+### Analyze all repositories on your computer (Master Scan)
+```bash
+commitpulse --scan
+```
+
+### Specify a target directory
+```bash
+commitpulse /path/to/projects
+```
+
+## 🛠️ Options
+- `--scan`: Crawls subdirectories to find and aggregate all Git repositories.
+- `--no-open`: Generates the dashboard without automatically opening it in the browser.
+
+## 🚀 Deployment & Sharing
+
+Commit Pulse offers two ways to view and share your results:
+
+### 1. Local-First (Default)
+Run the command to generate a self-contained, interactive HTML dashboard on your machine. Perfect for private analysis.
+```bash
+commitpulse --scan
+```
+*Output: `stats_dashboard.html`*
+
+### 2. Commit Pulse Cloud (Global Sharing)
+Ready to show the world? Use the `--publish` flag to host your dashboard on the cloud and get a unique, shareable URL.
+```bash
+commitpulse --publish
+```
+*Output: `https://commitpulse.app/v/your-unique-id`*
+
+---
+
+## 🛠️ Setting up your own Cloud Instance (Optional)
+
+If you are hosting your own version of **Commit Pulse Cloud**:
+
+1.  **Neon DB**:
+    - Go to [Neon.tech](https://neon.tech) and create a free project.
+    - Copy your **Connection String** (e.g., `postgresql://user:pass@ep-cool-beach-123.us-east-2.aws.neon.tech/neondb?sslmode=require`).
+2.  **Environment Setup**:
+    - In the `commitpulse-cloud` directory, rename `.env.example` to `.env`.
+    - Paste your connection string into `DATABASE_URL`.
+3.  **Vercel Deployment**:
+    - Deploy the `commitpulse-cloud` folder to Vercel.
+    - Add the `DATABASE_URL` to your Vercel Environment Variables.
+
+## 🌍 Distribution & PyPI Hosting
+
+To share **Commit Pulse** with the global developer community via PyPI:
+
+### 1. Prepare your Account
+- Register at [pypi.org](https://pypi.org/).
+- Generate an API Token in your account settings.
+
+### 2. Build the Distribution
+Ensure you have the latest build tools:
+```bash
+python -m pip install --upgrade build twine
+```
+Then build the package:
+```bash
+python -m build
+```
+This creates a `dist/` folder with your `.whl` and `.tar.gz` files.
+
+### 3. Upload to PyPI
+Use `twine` to securely upload your package:
+```bash
+python -m twine upload dist/*
+```
+- **Username**: `__token__`
+- **Password**: `[Your API Token]`
+
+Once uploaded, anyone can install it via:
+```bash
+pip install commitpulse
+```
+
+---
+*Built with ❤️ for the development ecosystem.*

commitpulse-0.1.0/README.md

@@ -0,0 +1,117 @@
+# Commit Pulse 🚀
+
+Commit Pulse is a powerful, locally-first CLI tool that generates high-fidelity engineering dashboards for your Git repositories. It analyzes your development ecosystem, visualizes commit intensity heatmaps, and identifies top contributors using real GitHub profiles.
+
+## ✨ Key Features
+- **Zero-PAT Analysis**: Analyzes local `.git` metadata directly. No Personal Access Tokens or cloud APIs required for core stats.
+- **Accurate Project Timelines**: Dynamic contribution grids that span from the repository's inception to the **last official commit**.
+- **GitHub Profile Integration**: Automatically fetches actual contributor avatars via the public GitHub Search API.
+- **Master Scan**: A recursive drive scanner that aggregates stats from every project on your machine into a single interactive dashboard.
+- **Premium Aesthetics**: Glassmorphic UI with dark mode, smooth animations, and official GitHub iconography.
+
+## 📦 Installation
+
+### 1. Local (Developer Mode)
+If you have the source code locally:
+```bash
+pip install -e .
+```
+
+### 2. Direct from GitHub
+Anyone can install your tool directly if the repo is public:
+```bash
+pip install git+https://github.com/YOUR_USERNAME/commitpulse.git
+```
+
+### 3. Global Command
+Once installed, the `commitpulse` command is available everywhere in your terminal.
+
+## 🚀 Usage
+
+### Analyze the current repository
+```bash
+commitpulse
+```
+
+### Analyze all repositories on your computer (Master Scan)
+```bash
+commitpulse --scan
+```
+
+### Specify a target directory
+```bash
+commitpulse /path/to/projects
+```
+
+## 🛠️ Options
+- `--scan`: Crawls subdirectories to find and aggregate all Git repositories.
+- `--no-open`: Generates the dashboard without automatically opening it in the browser.
+
+## 🚀 Deployment & Sharing
+
+Commit Pulse offers two ways to view and share your results:
+
+### 1. Local-First (Default)
+Run the command to generate a self-contained, interactive HTML dashboard on your machine. Perfect for private analysis.
+```bash
+commitpulse --scan
+```
+*Output: `stats_dashboard.html`*
+
+### 2. Commit Pulse Cloud (Global Sharing)
+Ready to show the world? Use the `--publish` flag to host your dashboard on the cloud and get a unique, shareable URL.
+```bash
+commitpulse --publish
+```
+*Output: `https://commitpulse.app/v/your-unique-id`*
+
+---
+
+## 🛠️ Setting up your own Cloud Instance (Optional)
+
+If you are hosting your own version of **Commit Pulse Cloud**:
+
+1.  **Neon DB**:
+    - Go to [Neon.tech](https://neon.tech) and create a free project.
+    - Copy your **Connection String** (e.g., `postgresql://user:pass@ep-cool-beach-123.us-east-2.aws.neon.tech/neondb?sslmode=require`).
+2.  **Environment Setup**:
+    - In the `commitpulse-cloud` directory, rename `.env.example` to `.env`.
+    - Paste your connection string into `DATABASE_URL`.
+3.  **Vercel Deployment**:
+    - Deploy the `commitpulse-cloud` folder to Vercel.
+    - Add the `DATABASE_URL` to your Vercel Environment Variables.
+
+## 🌍 Distribution & PyPI Hosting
+
+To share **Commit Pulse** with the global developer community via PyPI:
+
+### 1. Prepare your Account
+- Register at [pypi.org](https://pypi.org/).
+- Generate an API Token in your account settings.
+
+### 2. Build the Distribution
+Ensure you have the latest build tools:
+```bash
+python -m pip install --upgrade build twine
+```
+Then build the package:
+```bash
+python -m build
+```
+This creates a `dist/` folder with your `.whl` and `.tar.gz` files.
+
+### 3. Upload to PyPI
+Use `twine` to securely upload your package:
+```bash
+python -m twine upload dist/*
+```
+- **Username**: `__token__`
+- **Password**: `[Your API Token]`
+
+Once uploaded, anyone can install it via:
+```bash
+pip install commitpulse
+```
+
+---
+*Built with ❤️ for the development ecosystem.*

commitpulse-0.1.0/commitpulse/__init__.py

@@ -0,0 +1 @@
+# NovaStats Package

commitpulse-0.1.0/commitpulse/analyzer.py

@@ -0,0 +1,162 @@
+import subprocess
+import os
+import hashlib
+import json
+import urllib.request
+import urllib.parse
+from collections import Counter
+from datetime import datetime
+
+class GitAnalyzer:
+    def __init__(self, repo_path):
+        self.repo_path = os.path.abspath(repo_path)
+        self.repo_name = os.path.basename(self.repo_path)
+        self.github_avatar_cache = {}
+
+    def _run_git(self, args):
+        try:
+            result = subprocess.run(
+                ['git'] + args,
+                cwd=self.repo_path,
+                capture_output=True,
+                text=True,
+                check=True,
+                shell=True
+            )
+            return result.stdout.strip()
+        except (subprocess.CalledProcessError, FileNotFoundError):
+            return None
+
+    def is_git_repo(self):
+        return os.path.exists(os.path.join(self.repo_path, '.git'))
+
+    def _get_github_avatar(self, email):
+        if email in self.github_avatar_cache:
+            return self.github_avatar_cache[email]
+        
+        # Default to Gravatar
+        email_hash = hashlib.md5(email.lower().encode('utf-8')).hexdigest()
+        avatar_url = f"https://www.gravatar.com/avatar/{email_hash}?d=identicon&s=150"
+        
+        try:
+            # Try to search for user by email using GitHub's public API
+            search_url = f"https://api.github.com/search/users?q={urllib.parse.quote(email)}"
+            request = urllib.request.Request(search_url)
+            request.add_header('User-Agent', 'CommitPulse-CLI-v0.1')
+            
+            with urllib.request.urlopen(request, timeout=5) as response:
+                data = json.loads(response.read().decode())
+                if data.get('total_count', 0) > 0:
+                    avatar_url = data['items'][0]['avatar_url']
+        except Exception:
+            # Silently fall back to Gravatar on any error (rate limit, network, etc)
+            pass
+            
+        self.github_avatar_cache[email] = avatar_url
+        return avatar_url
+
+    def get_stats(self):
+        if not self.is_git_repo():
+            return None
+
+        print(f"Analyzing {self.repo_name}... (High Precision)")
+
+        # Get all commit dates and times for heatmap and productivity
+        # Use --all to include all branches and --no-merges to match GitHub's default contribution view
+        # or remove --no-merges if we want every single commit. GitHub counts merges if they occurred on GitHub.
+        # We'll stick to --all for full visibility.
+        commit_dates_raw = self._run_git(['log', '--all', '--format=%aI'])
+        
+        heatmap_data = Counter()
+        hourly_distribution = Counter()
+        
+        if commit_dates_raw:
+            dates = commit_dates_raw.split('\n')
+            for d in dates:
+                if not d: continue
+                try:
+                    dt = datetime.fromisoformat(d)
+                    date_str = dt.date().isoformat()
+                    hour = dt.hour
+                    heatmap_data[date_str] += 1
+                    hourly_distribution[hour] += 1
+                except ValueError:
+                    continue
+
+        total_commits = sum(heatmap_data.values())
+
+        # Get first and last commit dates
+        first_date = "N/A"
+        last_date = "N/A"
+        if heatmap_data:
+            sorted_dates = sorted(heatmap_data.keys())
+            first_date = sorted_dates[0]
+            last_date = sorted_dates[-1]
+
+        # Get contributors with high precision
+        # Format: count <tab> name <email>
+        shortlog = self._run_git(['shortlog', '-sne', '--all'])
+        contributors = []
+        if shortlog:
+            for line in shortlog.split('\n'):
+                line = line.strip()
+                if not line: continue
+                parts = line.split('\t')
+                if len(parts) == 2:
+                    count = int(parts[0].strip())
+                    name_email = parts[1].strip()
+                    name = name_email
+                    email = ""
+                    if '<' in name_email:
+                        name = name_email.split('<')[0].strip()
+                        email = name_email.split('<')[1].split('>')[0].strip()
+                    
+                    avatar = self._get_github_avatar(email)
+                    
+                    contributors.append({
+                        "name": name,
+                        "email": email,
+                        "commits": count,
+                        "avatar": avatar
+                    })
+
+        # Calculate most productive hour
+        peak_hour = "N/A"
+        if hourly_distribution:
+            peak_hour = f"{hourly_distribution.most_common(1)[0][0]}:00"
+
+        return {
+            "name": self.repo_name,
+            "path": self.repo_path,
+            "total_commits": total_commits,
+            "first_commit": first_date,
+            "last_commit": last_date,
+            "peak_hour": peak_hour,
+            "heatmap": dict(heatmap_data),
+            "hourly_distribution": dict(hourly_distribution),
+            "contributors": sorted(contributors, key=lambda x: x['commits'], reverse=True)
+        }
+
+    @staticmethod
+    def scan_for_repos(root_dir, max_depth=3):
+        repos = []
+        root_dir = os.path.abspath(root_dir)
+        
+        for dirpath, dirnames, filenames in os.walk(root_dir):
+            if '.git' in dirnames:
+                repos.append(dirpath)
+                dirnames.remove('.git')
+            
+            depth = dirpath.replace(root_dir, '').count(os.sep)
+            if depth >= max_depth:
+                del dirnames[:]
+                
+        return repos
+    @staticmethod
+    def get_git_config_user():
+        try:
+            import subprocess
+            name = subprocess.check_output(["git", "config", "user.name"]).decode().strip()
+            return name
+        except:
+            return None

commitpulse-0.1.0/commitpulse/main.py

@@ -0,0 +1,118 @@
+import argparse
+import os
+import sys
+import webbrowser
+from .analyzer import GitAnalyzer
+from .renderer import DashboardRenderer
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Commit Pulse - Premium Git Repository Analytics Dashboard"
+    )
+    
+    parser.add_argument(
+        'path', 
+        nargs='?', 
+        default='.', 
+        help="Path to the repository (default is current directory)"
+    )
+    
+    parser.add_argument(
+        '--scan', 
+        action='store_true', 
+        help="Scan the current directory (and subdirectories) for all git repositories"
+    )
+    
+    parser.add_argument(
+        '--no-open', 
+        action='store_true', 
+        help="Do not automatically open the dashboard in the browser"
+    )
+    
+    parser.add_argument(
+        '--publish', 
+        action='store_true', 
+        help="Publish your project's pulse to the cloud for sharing"
+    )
+
+    args = parser.parse_args()
+    
+    all_stats = []
+    
+    if args.scan:
+        print(f"Scanning for git repositories in {os.path.abspath(args.path)}...")
+        repo_paths = GitAnalyzer.scan_for_repos(args.path)
+        print(f"Found {len(repo_paths)} repositories.")
+        
+        for p in repo_paths:
+            analyzer = GitAnalyzer(p)
+            stats = analyzer.get_stats()
+            if stats:
+                all_stats.append(stats)
+    else:
+        analyzer = GitAnalyzer(args.path)
+        if not analyzer.is_git_repo():
+            print(f"Error: {os.path.abspath(args.path)} is not a git repository.")
+            sys.exit(1)
+            
+        stats = analyzer.get_stats()
+        if stats:
+            all_stats.append(stats)
+
+    if not all_stats:
+        print("Note: No statistics could be gathered.")
+        sys.exit(0)
+
+    # Render dashboard
+    renderer = DashboardRenderer(all_stats)
+    output_path = renderer.render()
+    
+    print(f"\nDashboard generated successfully!")
+    print(f"Location: {output_path}")
+    
+    # Decide whether to open local HTML
+    # If publishing, we might want to prioritize the cloud link instead of popping up the local file
+    should_open_local = not args.no_open
+    if args.publish and not args.no_open:
+        # If they are publishing, maybe they only want the web link? 
+        # Let's still open local unless it's a server environment, but clarify.
+        pass
+
+    if should_open_local:
+        webbrowser.open(f"file://{output_path}")
+
+    # Cloud Publishing
+    if args.publish:
+        import requests
+        # Get username from git config
+        username = GitAnalyzer.get_git_config_user() or os.getenv("USER") or "Anonymous"
+        
+        print(f"\n🚀 Publishing your Pulse to the cloud as '{username}'...")
+        
+        # In a real scenario, this would be your production URL
+        # For now, we point to the local or configured cloud instance
+        cloud_url = os.getenv("COMMITPULSE_CLOUD_URL", "http://localhost:3000") 
+        api_endpoint = f"{cloud_url}/api/publish"
+        
+        try:
+            # We publish the first repo in scanning mode or the target repo
+            # For simplicity, we publish the main one if multiple found
+            repo_to_publish = all_stats[0]
+            
+            payload = {
+                "username": username,
+                "repoName": repo_to_publish["name"],
+                "stats": all_stats # Send all scanned repos
+            }
+            
+            response = requests.post(api_endpoint, json=payload, timeout=10)
+            if response.status_code == 200:
+                result = response.json()
+                print(f"✨ Successfully published! Share your Pulse at: {result['url']}")
+            else:
+                print(f"❌ Failed to publish: {response.text}")
+        except Exception as e:
+            print(f"⚠️ Cloud sync failed: {str(e)}")
+
+if __name__ == "__main__":
+    main()

commitpulse-0.1.0/commitpulse/renderer.py

@@ -0,0 +1,537 @@
+import json
+import os
+from datetime import datetime, timedelta
+
+class DashboardRenderer:
+    def __init__(self, stats_data):
+        self.stats_data = stats_data
+
+    def render(self, output_path="stats_dashboard.html"):
+        html_template = """
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Commit Pulse | Repository Ecosystem</title>
+    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        :root {
+            --bg-dark: #0d1117;
+            --card-bg: rgba(22, 27, 34, 0.7);
+            --border: rgba(48, 54, 61, 0.8);
+            --text-main: #f0f6fc;
+            --text-dim: #8b949e;
+            --accent: #238636;
+            --accent-glow: rgba(35, 134, 54, 0.3);
+            --github-blue: #58a6ff;
+            --glass-blur: blur(12px);
+            
+            /* Heatmap Colors */
+            --h-0: #161b22;
+            --h-1: #0e4429;
+            --h-2: #006d32;
+            --h-3: #26a641;
+            --h-4: #39d353;
+        }
+
+        * {
+            box-sizing: border-box;
+            transition: all 0.2s ease-in-out;
+        }
+
+        body {
+            font-family: 'Outfit', -apple-system, BlinkMacSystemFont, sans-serif;
+            background-color: var(--bg-dark);
+            background-image: radial-gradient(circle at 50% 10%, rgba(35, 134, 54, 0.05) 0%, transparent 50%);
+            color: var(--text-main);
+            margin: 0;
+            padding: 0;
+            overflow-x: hidden;
+        }
+
+        header {
+            padding: 30px 60px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            position: sticky;
+            top: 0;
+            z-index: 100;
+            background: rgba(13, 17, 23, 0.8);
+            backdrop-filter: var(--glass-blur);
+            border-bottom: 1px solid var(--border);
+        }
+
+        .header-left {
+            display: flex;
+            align-items: center;
+            gap: 15px;
+        }
+
+        .logo-icon {
+            fill: var(--text-main);
+            filter: drop-shadow(0 0 8px rgba(255,255,255,0.2));
+        }
+
+        h1 {
+            font-size: 24px;
+            font-weight: 700;
+            margin: 0;
+            letter-spacing: -0.5px;
+            background: linear-gradient(90deg, #fff, var(--text-dim));
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+        }
+
+        .container {
+            max-width: 1400px;
+            margin: 0 auto;
+            padding: 40px 60px;
+        }
+
+        .stats-grid {
+            display: grid;
+            grid-template-columns: 1fr;
+            gap: 40px;
+        }
+
+        .repo-card {
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 16px;
+            padding: 32px;
+            backdrop-filter: var(--glass-blur);
+            position: relative;
+            overflow: hidden;
+        }
+
+        .repo-card::before {
+            content: '';
+            position: absolute;
+            top: 0; left: 0; width: 4px; height: 100%;
+            background: var(--accent);
+            opacity: 0;
+            transition: 0.3s;
+        }
+
+        .repo-card:hover {
+            border-color: var(--github-blue);
+            transform: translateY(-4px);
+            box-shadow: 0 12px 24px rgba(0,0,0,0.3);
+        }
+
+        .repo-card:hover::before {
+            opacity: 1;
+        }
+
+        .repo-title-row {
+            display: flex;
+            justify-content: space-between;
+            align-items: flex-start;
+            margin-bottom: 24px;
+        }
+
+        .repo-name-group {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+        }
+
+        .repo-name {
+            font-size: 28px;
+            font-weight: 700;
+            color: var(--text-main);
+            text-decoration: none;
+        }
+
+        .repo-meta-badges {
+            display: flex;
+            gap: 12px;
+            margin-bottom: 32px;
+        }
+
+        .badge {
+            background: rgba(48, 54, 61, 0.4);
+            border: 1px solid var(--border);
+            color: var(--text-dim);
+            padding: 4px 12px;
+            border-radius: 20px;
+            font-size: 13px;
+            font-weight: 500;
+            display: flex;
+            align-items: center;
+            gap: 6px;
+        }
+
+        .badge.highlight {
+            border-color: var(--accent);
+            color: var(--accent);
+            background: rgba(35, 134, 54, 0.1);
+        }
+
+        .dashboard-row {
+            display: grid;
+            grid-template-columns: 1fr;
+            gap: 32px;
+        }
+
+        /* HEATMAP STYLES */
+        .heatmap-container {
+            background: rgba(0,0,0,0.2);
+            padding: 32px;
+            border-radius: 12px;
+            border: 1px solid var(--border);
+            width: 100%;
+            overflow: hidden;
+        }
+
+        .heatmap-wrapper {
+            overflow-x: auto;
+            display: flex;
+            gap: 16px;
+            padding-bottom: 12px;
+            scrollbar-width: thin;
+            scrollbar-color: var(--border) transparent;
+        }
+
+        .heatmap-wrapper::-webkit-scrollbar {
+            height: 6px;
+        }
+
+        .heatmap-wrapper::-webkit-scrollbar-track {
+            background: transparent;
+        }
+
+        .heatmap-wrapper::-webkit-scrollbar-thumb {
+            background: var(--border);
+            border-radius: 10px;
+        }
+
+        .heatmap-wrapper::-webkit-scrollbar-thumb:hover {
+            background: var(--text-dim);
+        }
+
+        .section-label {
+            font-size: 14px;
+            font-weight: 600;
+            text-transform: uppercase;
+            color: var(--text-dim);
+            letter-spacing: 1px;
+            margin-bottom: 20px;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+
+        .heatmap-month-group {
+            display: flex;
+            flex-direction: column;
+            gap: 8px;
+            flex-shrink: 0; /* Don't squish month groups */
+        }
+
+        .month-name {
+            font-size: 11px;
+            font-weight: 700;
+            color: var(--github-blue); /* Subtle blue for headers */
+            text-transform: uppercase;
+            letter-spacing: 0.5px;
+        }
+
+        .heatmap-grid {
+            display: flex;
+            flex-flow: column wrap;
+            height: 122px; /* (14px * 7) + (4px * 6) = 122px */
+            gap: 4px;
+            align-content: flex-start;
+        }
+
+        .heatmap-cell {
+            width: 14px;
+            height: 14px;
+            border-radius: 2px;
+            background-color: var(--h-0);
+            cursor: pointer;
+            flex-shrink: 0;
+        }
+
+        .heatmap-cell.empty {
+            background-color: transparent;
+            cursor: default;
+            pointer-events: none;
+        }
+
+        .heatmap-cell:hover {
+            outline: 2px solid var(--text-main);
+            z-index: 10;
+        }
+
+        .intensity-1 { background-color: var(--h-1); }
+        .intensity-2 { background-color: var(--h-2); }
+        .intensity-3 { background-color: var(--h-3); }
+        .intensity-4 { background-color: var(--h-4); }
+
+        .legend {
+            display: flex;
+            align-items: center;
+            gap: 6px;
+            font-size: 12px;
+            color: var(--text-dim);
+        }
+
+        .legend-box {
+            width: 10px;
+            height: 10px;
+            border-radius: 2px;
+        }
+
+        /* CONTRIBUTOR STYLES */
+        .contributor-panel {
+            background: rgba(0,0,0,0.2);
+            padding: 24px;
+            border-radius: 12px;
+            border: 1px solid var(--border);
+            margin-top: 24px;
+        }
+
+        .contributor-list {
+            display: flex;
+            flex-wrap: wrap;
+            gap: 24px;
+        }
+
+        .contributor-item {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            padding: 8px;
+            border-radius: 8px;
+            background: rgba(255,255,255,0.02);
+            min-width: 200px;
+        }
+
+        .contributor-info {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+        }
+
+        .avatar {
+            width: 40px;
+            height: 40px;
+            border-radius: 50%;
+            border: 2px solid var(--border);
+            padding: 2px;
+            background: #0d1117;
+            object-fit: cover;
+        }
+
+        .contributor-name {
+            font-weight: 600;
+            font-size: 15px;
+            color: var(--text-main);
+        }
+
+        .commit-pill {
+            background: var(--accent);
+            color: #fff;
+            padding: 4px 12px;
+            border-radius: 6px;
+            font-weight: 600;
+            font-size: 12px;
+        }
+
+        footer {
+            text-align: center;
+            padding: 60px;
+            color: var(--text-dim);
+            font-size: 14px;
+            opacity: 0.6;
+        }
+
+        @keyframes fadeIn {
+            from { opacity: 0; transform: translateY(20px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+
+        .repo-card {
+            animation: fadeIn 0.8s ease-out forwards;
+        }
+    </style>
+</head>
+<body>
+    <header>
+        <div class="header-left">
+            <svg height="32" viewBox="0 0 16 16" width="32" class="logo-icon"><path d="M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.27-.82 2.15 0 3.07 1.87 3.75 3.65 3.95-.29.25-.54.73-.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 1 0 8c0-4.42 3.58-8 8-8Z"></path></svg>
+            <h1>Commit Pulse</h1>
+        </div>
+        <div class="badge highlight">
+            <span>Repository Ecosystem</span>
+        </div>
+    </header>
+
+        <div class="stats-grid" id="stats-grid"></div>
+
+    <footer>
+        &copy; 2026 Commit Pulse &bull; High-Fidelity Ecosystem Analytics
+    </footer>
+
+    <script>
+        const data = __STATS_DATA__;
+        
+        function getIntensity(count) {
+            if (count === 0) return '';
+            if (count < 3) return 'intensity-1';
+            if (count < 6) return 'intensity-2';
+            if (count < 10) return 'intensity-3';
+            return 'intensity-4';
+        }
+
+        function createHeatmap(repo) {
+            const wrapper = document.createElement('div');
+            wrapper.className = 'heatmap-wrapper';
+            
+            const start = new Date(repo.first_commit);
+            const end = new Date(repo.last_commit);
+            
+            // Start from the first day of the first commit month
+            const current = new Date(start.getFullYear(), start.getMonth(), 1);
+            // End at the last day of the last commit month
+            const lastDay = new Date(end.getFullYear(), end.getMonth() + 1, 0);
+            
+            const months = {};
+            
+            while (current <= lastDay) {
+                const monthKey = `${current.getFullYear()}-${String(current.getMonth() + 1).padStart(2, '0')}`;
+                if (!months[monthKey]) {
+                    months[monthKey] = {
+                        name: current.toLocaleString('default', { month: 'short' }),
+                        year: current.getFullYear(),
+                        days: []
+                    };
+                }
+                
+                const dateKey = current.toISOString().split('T')[0];
+                const count = repo.heatmap[dateKey] || 0;
+                
+                months[monthKey].days.push({
+                    date: dateKey,
+                    readable: current.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' }),
+                    count: count
+                });
+                
+                current.setDate(current.getDate() + 1);
+            }
+            
+            Object.values(months).forEach(m => {
+                const monthGroup = document.createElement('div');
+                monthGroup.className = 'heatmap-month-group';
+                
+                const monthLabel = document.createElement('div');
+                monthLabel.className = 'month-name';
+                monthLabel.innerText = `${m.name} ${m.year}`;
+                monthGroup.appendChild(monthLabel);
+                
+                const grid = document.createElement('div');
+                grid.className = 'heatmap-grid';
+                
+                m.days.forEach(day => {
+                    const cell = document.createElement('div');
+                    cell.className = `heatmap-cell ${getIntensity(day.count)}`;
+                    cell.title = `${day.count} commits on ${day.readable}`;
+                    grid.appendChild(cell);
+                });
+
+                // Pad the end of the month to complete the column (total cells must be multiple of 7)
+                const totalCells = m.days.length;
+                const remaining = (7 - (totalCells % 7)) % 7;
+                for (let i = 0; i < remaining; i++) {
+                    const empty = document.createElement('div');
+                    empty.className = 'heatmap-cell empty';
+                    grid.appendChild(empty);
+                }
+                
+                monthGroup.appendChild(grid);
+                wrapper.appendChild(monthGroup);
+            });
+            
+            return wrapper;
+        }
+
+        function render() {
+            const grid = document.getElementById('stats-grid');
+            data.forEach((repo, index) => {
+                const card = document.createElement('div');
+                card.className = 'repo-card';
+                card.style.animationDelay = `${index * 0.15}s`;
+                
+                card.innerHTML = `
+                    <div class="repo-title-row">
+                        <div class="repo-name-group">
+                            <svg height="24" viewBox="0 0 16 16" width="24" fill="var(--text-dim)"><path d="M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.27-.82 2.15 0 3.07 1.87 3.75 3.65 3.95-.29.25-.54.73-.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 1 0 8c0-4.42 3.58-8 8-8Z"></path></svg>
+                            <span class="repo-name">${repo.name}</span>
+                        </div>
+                        <div class="commit-pill">${repo.total_commits} Total Commits</div>
+                    </div>
+
+                    <div class="repo-meta-badges">
+                        <div class="badge">
+                            <span style="opacity: 0.5">Timeline:</span>
+                            ${repo.first_commit} to ${repo.last_commit}
+                        </div>
+                        <div class="badge highlight">
+                            <span style="opacity: 0.5">Peak Hour:</span>
+                            ${repo.peak_hour}
+                        </div>
+                    </div>
+
+                    <div class="dashboard-row">
+                        <div class="heatmap-container">
+                            <div class="section-label">
+                                <span>Commit Contributions (Full History)</span>
+                                <div class="legend">
+                                    <span>Less</span>
+                                    <div class="legend-box" style="background: var(--h-0)"></div>
+                                    <div class="legend-box intensity-1"></div>
+                                    <div class="legend-box intensity-2"></div>
+                                    <div class="legend-box intensity-3"></div>
+                                    <div class="legend-box intensity-4"></div>
+                                    <span>More</span>
+                                </div>
+                            </div>
+                            <div class="heatmap-wrapper" id="heatmap-${index}"></div>
+                        </div>
+                    </div>
+
+                    <div class="contributor-panel">
+                        <span class="section-label">Top Engineering Impact</span>
+                        <div class="contributor-list">
+                            ${repo.contributors.map(c => `
+                                <div class="contributor-item">
+                                    <div class="contributor-info">
+                                        <img src="${c.avatar}" class="avatar" onerror="this.src='https://www.gravatar.com/avatar/0?d=mp'">
+                                        <span class="contributor-name">${c.name}</span>
+                                    </div>
+                                    <div class="commit-pill" style="background: rgba(255,255,255,0.05); color: var(--text-dim); border: 1px solid var(--border)">
+                                        ${c.commits}
+                                    </div>
+                                </div>
+                            `).join('')}
+                        </div>
+                    </div>
+                `;
+                grid.appendChild(card);
+                document.getElementById(`heatmap-${index}`).appendChild(createHeatmap(repo));
+            });
+        }
+        render();
+    </script>
+</body>
+</html>
+""".replace("__STATS_DATA__", json.dumps(self.stats_data))
+        
+        with open(output_path, "w", encoding="utf-8") as f:
+            f.write(html_template)
+        
+        return os.path.abspath(output_path)

commitpulse-0.1.0/commitpulse.egg-info/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.1
+Name: commitpulse
+Version: 0.1.0
+Summary: Premium Git repository analytics and dashboard generator
+Author: Antigravity AI
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# Commit Pulse 🚀
+
+Commit Pulse is a powerful, locally-first CLI tool that generates high-fidelity engineering dashboards for your Git repositories. It analyzes your development ecosystem, visualizes commit intensity heatmaps, and identifies top contributors using real GitHub profiles.
+
+## ✨ Key Features
+- **Zero-PAT Analysis**: Analyzes local `.git` metadata directly. No Personal Access Tokens or cloud APIs required for core stats.
+- **Accurate Project Timelines**: Dynamic contribution grids that span from the repository's inception to the **last official commit**.
+- **GitHub Profile Integration**: Automatically fetches actual contributor avatars via the public GitHub Search API.
+- **Master Scan**: A recursive drive scanner that aggregates stats from every project on your machine into a single interactive dashboard.
+- **Premium Aesthetics**: Glassmorphic UI with dark mode, smooth animations, and official GitHub iconography.
+
+## 📦 Installation
+
+### 1. Local (Developer Mode)
+If you have the source code locally:
+```bash
+pip install -e .
+```
+
+### 2. Direct from GitHub
+Anyone can install your tool directly if the repo is public:
+```bash
+pip install git+https://github.com/YOUR_USERNAME/commitpulse.git
+```
+
+### 3. Global Command
+Once installed, the `commitpulse` command is available everywhere in your terminal.
+
+## 🚀 Usage
+
+### Analyze the current repository
+```bash
+commitpulse
+```
+
+### Analyze all repositories on your computer (Master Scan)
+```bash
+commitpulse --scan
+```
+
+### Specify a target directory
+```bash
+commitpulse /path/to/projects
+```
+
+## 🛠️ Options
+- `--scan`: Crawls subdirectories to find and aggregate all Git repositories.
+- `--no-open`: Generates the dashboard without automatically opening it in the browser.
+
+## 🚀 Deployment & Sharing
+
+Commit Pulse offers two ways to view and share your results:
+
+### 1. Local-First (Default)
+Run the command to generate a self-contained, interactive HTML dashboard on your machine. Perfect for private analysis.
+```bash
+commitpulse --scan
+```
+*Output: `stats_dashboard.html`*
+
+### 2. Commit Pulse Cloud (Global Sharing)
+Ready to show the world? Use the `--publish` flag to host your dashboard on the cloud and get a unique, shareable URL.
+```bash
+commitpulse --publish
+```
+*Output: `https://commitpulse.app/v/your-unique-id`*
+
+---
+
+## 🛠️ Setting up your own Cloud Instance (Optional)
+
+If you are hosting your own version of **Commit Pulse Cloud**:
+
+1.  **Neon DB**:
+    - Go to [Neon.tech](https://neon.tech) and create a free project.
+    - Copy your **Connection String** (e.g., `postgresql://user:pass@ep-cool-beach-123.us-east-2.aws.neon.tech/neondb?sslmode=require`).
+2.  **Environment Setup**:
+    - In the `commitpulse-cloud` directory, rename `.env.example` to `.env`.
+    - Paste your connection string into `DATABASE_URL`.
+3.  **Vercel Deployment**:
+    - Deploy the `commitpulse-cloud` folder to Vercel.
+    - Add the `DATABASE_URL` to your Vercel Environment Variables.
+
+## 🌍 Distribution & PyPI Hosting
+
+To share **Commit Pulse** with the global developer community via PyPI:
+
+### 1. Prepare your Account
+- Register at [pypi.org](https://pypi.org/).
+- Generate an API Token in your account settings.
+
+### 2. Build the Distribution
+Ensure you have the latest build tools:
+```bash
+python -m pip install --upgrade build twine
+```
+Then build the package:
+```bash
+python -m build
+```
+This creates a `dist/` folder with your `.whl` and `.tar.gz` files.
+
+### 3. Upload to PyPI
+Use `twine` to securely upload your package:
+```bash
+python -m twine upload dist/*
+```
+- **Username**: `__token__`
+- **Password**: `[Your API Token]`
+
+Once uploaded, anyone can install it via:
+```bash
+pip install commitpulse
+```
+
+---
+*Built with ❤️ for the development ecosystem.*

commitpulse-0.1.0/commitpulse.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+commitpulse/__init__.py
+commitpulse/analyzer.py
+commitpulse/main.py
+commitpulse/renderer.py
+commitpulse.egg-info/PKG-INFO
+commitpulse.egg-info/SOURCES.txt
+commitpulse.egg-info/dependency_links.txt
+commitpulse.egg-info/entry_points.txt
+commitpulse.egg-info/requires.txt
+commitpulse.egg-info/top_level.txt

commitpulse-0.1.0/commitpulse.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

commitpulse-0.1.0/commitpulse.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+commitpulse = commitpulse.main:main

commitpulse-0.1.0/commitpulse.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31.0

commitpulse-0.1.0/commitpulse.egg-info/top_level.txt

@@ -0,0 +1 @@
+commitpulse

commitpulse-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "commitpulse"
+version = "0.1.0"
+description = "Premium Git repository analytics and dashboard generator"
+authors = [
+    { name = "Antigravity AI" }
+]
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "requests>=2.31.0"
+]
+
+[project.scripts]
+commitpulse = "commitpulse.main:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["commitpulse*"]

commitpulse-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+