git-glance 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deepankar Rawat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# git-glance
+
+> Beautiful git repository summaries, statistics, and changelogs
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+# From npm (coming soon)
+npm install -g git-glance
+
+# From GitHub
+npm install -g github:dprrwt/git-glance
+```
+
+## Usage
+
+Run `git-glance` in any git repository:
+
+### Summary (default)
+
+```bash
+git-glance
+# or
+git-glance summary
+```
+
+Shows:
+- Repository info (branch, status, remote)
+- Commit statistics
+- Top contributors with progress bars
+- Recent commits
+
+### Statistics
+
+```bash
+git-glance stats
+git-glance stats --limit 100  # Analyze last 100 commits only
+```
+
+Shows detailed commit statistics:
+- Total commits
+- All contributors with commit counts
+- Project age
+- Commits per day
+
+### Changelog
+
+```bash
+git-glance changelog
+git-glance log                        # Alias
+git-glance log --since "1 week ago"   # Since specific date
+git-glance log --count 50             # Last 50 commits
+git-glance log --markdown             # Output as markdown
+```
+
+Generates a formatted changelog grouped by date.
+
+## Examples
+
+### Repository Summary
+
+```
+═══ 📊 my-project ═══
+
+  Branch:   main
+  Status:   ✓ Clean
+  Remote:   git@github.com:user/my-project.git
+
+═══ 📈 Statistics ═══
+
+  Total Commits:  142
+  Contributors:   3
+  First Commit:   Jan 15, 2024
+  Last Commit:    Feb 3, 2024
+  Commits/Day:    7.5
+
+═══ 👥 Top Contributors ═══
+
+  ███████████████░░░░░ John Doe (95 commits, 67%)
+  ████████░░░░░░░░░░░░ Jane Smith (35 commits, 25%)
+  ██░░░░░░░░░░░░░░░░░░ Bob Wilson (12 commits, 8%)
+```
+
+### Markdown Changelog
+
+```bash
+git-glance log --since "last week" --markdown > CHANGELOG.md
+```
+
+## License
+
+MIT © [Deepankar Rawat](https://github.com/dprrwt)

package/dist/commands/changelog.d.ts

@@ -0,0 +1,8 @@
+interface ChangelogOptions {
+    since?: string;
+    count?: number;
+    markdown?: boolean;
+}
+export declare function changelog(options?: ChangelogOptions): Promise<void>;
+export {};
+//# sourceMappingURL=changelog.d.ts.map

package/dist/commands/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/commands/changelog.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7E"}

package/dist/commands/changelog.js

@@ -0,0 +1,95 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changelog = changelog;
+const git_1 = require("../utils/git");
+const fmt = __importStar(require("../utils/format"));
+async function changelog(options = {}) {
+    if (!(await (0, git_1.isGitRepo)())) {
+        console.log(fmt.error('Error: Not a git repository'));
+        process.exit(1);
+    }
+    const repo = await (0, git_1.getRepoInfo)();
+    const commits = options.since
+        ? await (0, git_1.getCommitsSince)(options.since)
+        : await (0, git_1.getRecentCommits)(options.count || 20);
+    if (commits.length === 0) {
+        console.log(fmt.warning('No commits found for the specified period.'));
+        return;
+    }
+    if (options.markdown) {
+        outputMarkdown(repo.name, commits, options.since);
+    }
+    else {
+        outputPretty(commits, options.since);
+    }
+}
+function outputPretty(commits, since) {
+    const title = since ? `Changes since ${since}` : 'Recent Changes';
+    console.log(fmt.header(`📋 ${title}`));
+    // Group by date
+    const byDate = new Map();
+    for (const commit of commits) {
+        const existing = byDate.get(commit.date) || [];
+        existing.push(commit);
+        byDate.set(commit.date, existing);
+    }
+    for (const [date, dateCommits] of byDate) {
+        console.log(`\n  ${fmt.highlight(date)}`);
+        for (const commit of dateCommits) {
+            console.log(`    ${fmt.dim('•')} ${fmt.value(commit.message)}`);
+            console.log(`      ${fmt.dim(`${commit.hash} by ${commit.author}`)}`);
+        }
+    }
+    console.log('');
+}
+function outputMarkdown(repoName, commits, since) {
+    const title = since ? `Changes since ${since}` : 'Changelog';
+    console.log(`# ${repoName} - ${title}\n`);
+    // Group by date
+    const byDate = new Map();
+    for (const commit of commits) {
+        const existing = byDate.get(commit.date) || [];
+        existing.push(commit);
+        byDate.set(commit.date, existing);
+    }
+    for (const [date, dateCommits] of byDate) {
+        console.log(`## ${date}\n`);
+        for (const commit of dateCommits) {
+            console.log(`- ${commit.message} (\`${commit.hash}\` by ${commit.author})`);
+        }
+        console.log('');
+    }
+}

package/dist/commands/stats.d.ts

@@ -0,0 +1,6 @@
+interface StatsOptions {
+    limit?: number;
+}
+export declare function stats(options?: StatsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDrE"}

package/dist/commands/stats.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stats = stats;
+const git_1 = require("../utils/git");
+const fmt = __importStar(require("../utils/format"));
+async function stats(options = {}) {
+    if (!(await (0, git_1.isGitRepo)())) {
+        console.log(fmt.error('Error: Not a git repository'));
+        process.exit(1);
+    }
+    const limit = options.limit;
+    const commitStats = await (0, git_1.getCommitStats)(limit);
+    console.log(fmt.header('📈 Commit Statistics'));
+    if (limit) {
+        console.log(fmt.dim(`  (Analyzing last ${limit} commits)\n`));
+    }
+    // Overview
+    console.log(fmt.table([
+        ['Total Commits', String(commitStats.totalCommits)],
+        ['Contributors', String(commitStats.authors.size)],
+        ['First Commit', fmt.formatDate(commitStats.firstCommit)],
+        ['Last Commit', fmt.formatDate(commitStats.lastCommit)],
+        ['Commits/Day', fmt.formatNumber(commitStats.commitsPerDay)],
+    ]));
+    // Calculate project age
+    if (commitStats.firstCommit && commitStats.lastCommit) {
+        const ageMs = commitStats.lastCommit.getTime() - commitStats.firstCommit.getTime();
+        const days = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+        const months = Math.floor(days / 30);
+        const years = Math.floor(days / 365);
+        let ageStr;
+        if (years > 0) {
+            ageStr = `${years} year${years > 1 ? 's' : ''}, ${months % 12} month${months % 12 !== 1 ? 's' : ''}`;
+        }
+        else if (months > 0) {
+            ageStr = `${months} month${months > 1 ? 's' : ''}, ${days % 30} day${days % 30 !== 1 ? 's' : ''}`;
+        }
+        else {
+            ageStr = `${days} day${days !== 1 ? 's' : ''}`;
+        }
+        console.log(`\n  ${fmt.label('Project Age')} ${fmt.value(ageStr)}`);
+    }
+    // All Contributors (sorted)
+    console.log(fmt.header('👥 All Contributors'));
+    const sorted = [...commitStats.authors.entries()].sort((a, b) => b[1] - a[1]);
+    const maxCount = sorted[0]?.[1] || 1;
+    for (const [author, count] of sorted) {
+        const percentage = (count / commitStats.totalCommits) * 100;
+        const bar = fmt.progressBar(count, maxCount, 20);
+        console.log(`  ${bar} ${fmt.value(author.padEnd(25))} ${fmt.highlight(String(count).padStart(5))} ${fmt.dim(`(${percentage.toFixed(1)}%)`)}`);
+    }
+    console.log('');
+}

package/dist/commands/summary.d.ts

@@ -0,0 +1,2 @@
+export declare function summary(): Promise<void>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/commands/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/commands/summary.ts"],"names":[],"mappings":"AAGA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsD7C"}

package/dist/commands/summary.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summary = summary;
+const git_1 = require("../utils/git");
+const fmt = __importStar(require("../utils/format"));
+async function summary() {
+    if (!(await (0, git_1.isGitRepo)())) {
+        console.log(fmt.error('Error: Not a git repository'));
+        process.exit(1);
+    }
+    const [repo, stats, recent] = await Promise.all([
+        (0, git_1.getRepoInfo)(),
+        (0, git_1.getCommitStats)(),
+        (0, git_1.getRecentCommits)(5),
+    ]);
+    // Header
+    console.log(fmt.header(`📊 ${repo.name}`));
+    // Repository Info
+    console.log(fmt.table([
+        ['Branch', repo.branch],
+        ['Status', repo.isClean ? fmt.success('✓ Clean') : fmt.warning(`${repo.uncommittedChanges} changes`)],
+        ['Remote', repo.remoteUrl || fmt.dim('none')],
+    ]));
+    // Statistics
+    console.log(fmt.header('📈 Statistics'));
+    console.log(fmt.table([
+        ['Total Commits', String(stats.totalCommits)],
+        ['Contributors', String(stats.authors.size)],
+        ['First Commit', fmt.formatDate(stats.firstCommit)],
+        ['Last Commit', fmt.formatDate(stats.lastCommit)],
+        ['Commits/Day', fmt.formatNumber(stats.commitsPerDay)],
+    ]));
+    // Top Contributors
+    if (stats.authors.size > 0) {
+        console.log(fmt.header('👥 Top Contributors'));
+        const sorted = [...stats.authors.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
+        for (const [author, count] of sorted) {
+            const percentage = (count / stats.totalCommits) * 100;
+            const bar = fmt.progressBar(count, stats.totalCommits, 15);
+            console.log(`  ${bar} ${fmt.value(author)} ${fmt.dim(`(${count} commits, ${percentage.toFixed(0)}%)`)}`);
+        }
+    }
+    // Recent Commits
+    if (recent.length > 0) {
+        console.log(fmt.header('📝 Recent Commits'));
+        for (const commit of recent) {
+            console.log(`  ${fmt.dim(commit.hash)} ${fmt.value(commit.message)}`);
+            console.log(`         ${fmt.dim(`${commit.author} • ${commit.date}`)}`);
+        }
+    }
+    console.log('');
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const summary_1 = require("./commands/summary");
+const stats_1 = require("./commands/stats");
+const changelog_1 = require("./commands/changelog");
+const program = new commander_1.Command();
+program
+    .name('git-glance')
+    .description('Beautiful git repository summaries, statistics, and changelogs')
+    .version('1.0.0');
+// Default command: summary
+program
+    .command('summary', { isDefault: true })
+    .description('Show repository summary (default)')
+    .action(async () => {
+    await (0, summary_1.summary)();
+});
+// Stats command
+program
+    .command('stats')
+    .description('Show detailed commit statistics')
+    .option('-l, --limit <number>', 'Limit to last N commits', parseInt)
+    .action(async (options) => {
+    await (0, stats_1.stats)(options);
+});
+// Changelog command
+program
+    .command('changelog')
+    .alias('log')
+    .description('Generate changelog from commits')
+    .option('-s, --since <date>', 'Show commits since date (e.g., "1 week ago", "2024-01-01")')
+    .option('-n, --count <number>', 'Number of commits to show', parseInt)
+    .option('-m, --markdown', 'Output in markdown format')
+    .action(async (options) => {
+    await (0, changelog_1.changelog)(options);
+});
+program.parse();

package/dist/utils/format.d.ts

@@ -0,0 +1,13 @@
+export declare function header(text: string): string;
+export declare function label(text: string): string;
+export declare function value(text: string | number): string;
+export declare function highlight(text: string | number): string;
+export declare function success(text: string): string;
+export declare function warning(text: string): string;
+export declare function error(text: string): string;
+export declare function dim(text: string): string;
+export declare function formatDate(date: Date | null): string;
+export declare function formatNumber(num: number, decimals?: number): string;
+export declare function progressBar(current: number, total: number, width?: number): string;
+export declare function table(rows: [string, string][]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAOpD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAGtE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAMtF;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAMtD"}

package/dist/utils/format.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.header = header;
+exports.label = label;
+exports.value = value;
+exports.highlight = highlight;
+exports.success = success;
+exports.warning = warning;
+exports.error = error;
+exports.dim = dim;
+exports.formatDate = formatDate;
+exports.formatNumber = formatNumber;
+exports.progressBar = progressBar;
+exports.table = table;
+const chalk_1 = __importDefault(require("chalk"));
+function header(text) {
+    return chalk_1.default.bold.cyan(`\n═══ ${text} ═══\n`);
+}
+function label(text) {
+    return chalk_1.default.gray(text + ':');
+}
+function value(text) {
+    return chalk_1.default.white(String(text));
+}
+function highlight(text) {
+    return chalk_1.default.yellow(String(text));
+}
+function success(text) {
+    return chalk_1.default.green(text);
+}
+function warning(text) {
+    return chalk_1.default.yellow(text);
+}
+function error(text) {
+    return chalk_1.default.red(text);
+}
+function dim(text) {
+    return chalk_1.default.gray(text);
+}
+function formatDate(date) {
+    if (!date)
+        return 'N/A';
+    return date.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+    });
+}
+function formatNumber(num, decimals = 1) {
+    if (Number.isInteger(num))
+        return String(num);
+    return num.toFixed(decimals);
+}
+function progressBar(current, total, width = 20) {
+    const percentage = Math.min(1, current / total);
+    const filled = Math.round(width * percentage);
+    const empty = width - filled;
+    return chalk_1.default.green('█'.repeat(filled)) + chalk_1.default.gray('░'.repeat(empty));
+}
+function table(rows) {
+    const maxLabel = Math.max(...rows.map(r => r[0].length));
+    return rows
+        .map(([l, v]) => `  ${label(l.padEnd(maxLabel))} ${value(v)}`)
+        .join('\n');
+}

package/dist/utils/git.d.ts

@@ -0,0 +1,26 @@
+export interface RepoInfo {
+    name: string;
+    branch: string;
+    remoteUrl: string | null;
+    isClean: boolean;
+    uncommittedChanges: number;
+}
+export interface CommitStats {
+    totalCommits: number;
+    authors: Map<string, number>;
+    firstCommit: Date | null;
+    lastCommit: Date | null;
+    commitsPerDay: number;
+}
+export interface CommitInfo {
+    hash: string;
+    date: string;
+    message: string;
+    author: string;
+}
+export declare function isGitRepo(): Promise<boolean>;
+export declare function getRepoInfo(): Promise<RepoInfo>;
+export declare function getCommitStats(limit?: number): Promise<CommitStats>;
+export declare function getRecentCommits(count?: number): Promise<CommitInfo[]>;
+export declare function getCommitsSince(since: string): Promise<CommitInfo[]>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAOlD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CA2BrD;AAED,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgCzE;AAED,wBAAsB,gBAAgB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAShF;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAS1E"}

package/dist/utils/git.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGitRepo = isGitRepo;
+exports.getRepoInfo = getRepoInfo;
+exports.getCommitStats = getCommitStats;
+exports.getRecentCommits = getRecentCommits;
+exports.getCommitsSince = getCommitsSince;
+const simple_git_1 = __importDefault(require("simple-git"));
+const git = (0, simple_git_1.default)();
+async function isGitRepo() {
+    try {
+        await git.revparse(['--is-inside-work-tree']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function getRepoInfo() {
+    const status = await git.status();
+    const branch = status.current || 'unknown';
+    let remoteUrl = null;
+    try {
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find(r => r.name === 'origin');
+        remoteUrl = origin?.refs.fetch || null;
+    }
+    catch {
+        // No remotes
+    }
+    // Get repo name from directory or remote
+    let name = process.cwd().split(/[/\\]/).pop() || 'unknown';
+    if (remoteUrl) {
+        const match = remoteUrl.match(/\/([^/]+?)(\.git)?$/);
+        if (match)
+            name = match[1];
+    }
+    return {
+        name,
+        branch,
+        remoteUrl,
+        isClean: status.isClean(),
+        uncommittedChanges: status.files.length,
+    };
+}
+async function getCommitStats(limit) {
+    const log = await git.log(limit ? ['--max-count=' + limit] : []);
+    const authors = new Map();
+    let firstCommit = null;
+    let lastCommit = null;
+    for (const commit of log.all) {
+        // Count by author
+        const author = commit.author_name;
+        authors.set(author, (authors.get(author) || 0) + 1);
+        // Track dates
+        const date = new Date(commit.date);
+        if (!firstCommit || date < firstCommit)
+            firstCommit = date;
+        if (!lastCommit || date > lastCommit)
+            lastCommit = date;
+    }
+    // Calculate commits per day
+    let commitsPerDay = 0;
+    if (firstCommit && lastCommit) {
+        const days = Math.max(1, (lastCommit.getTime() - firstCommit.getTime()) / (1000 * 60 * 60 * 24));
+        commitsPerDay = log.total / days;
+    }
+    return {
+        totalCommits: log.total,
+        authors,
+        firstCommit,
+        lastCommit,
+        commitsPerDay,
+    };
+}
+async function getRecentCommits(count = 10) {
+    const log = await git.log(['--max-count=' + count]);
+    return log.all.map(commit => ({
+        hash: commit.hash.substring(0, 7),
+        date: new Date(commit.date).toLocaleDateString(),
+        message: commit.message.split('\n')[0], // First line only
+        author: commit.author_name,
+    }));
+}
+async function getCommitsSince(since) {
+    const log = await git.log(['--since=' + since]);
+    return log.all.map(commit => ({
+        hash: commit.hash.substring(0, 7),
+        date: new Date(commit.date).toLocaleDateString(),
+        message: commit.message.split('\n')[0],
+        author: commit.author_name,
+    }));
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "git-glance",
+  "version": "1.0.0",
+  "description": "Beautiful git repository summaries, statistics, and changelogs",
+  "main": "dist/index.js",
+  "bin": {
+    "git-glance": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "git",
+    "cli",
+    "summary",
+    "statistics",
+    "changelog",
+    "developer-tools"
+  ],
+  "author": "Deepankar Rawat <dprrwt>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dprrwt/git-glance"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "simple-git": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/commands/changelog.ts

@@ -0,0 +1,83 @@
+import { getCommitsSince, getRecentCommits, isGitRepo, getRepoInfo } from '../utils/git';
+import * as fmt from '../utils/format';
+
+interface ChangelogOptions {
+  since?: string;
+  count?: number;
+  markdown?: boolean;
+}
+
+export async function changelog(options: ChangelogOptions = {}): Promise<void> {
+  if (!(await isGitRepo())) {
+    console.log(fmt.error('Error: Not a git repository'));
+    process.exit(1);
+  }
+
+  const repo = await getRepoInfo();
+  const commits = options.since
+    ? await getCommitsSince(options.since)
+    : await getRecentCommits(options.count || 20);
+
+  if (commits.length === 0) {
+    console.log(fmt.warning('No commits found for the specified period.'));
+    return;
+  }
+
+  if (options.markdown) {
+    outputMarkdown(repo.name, commits, options.since);
+  } else {
+    outputPretty(commits, options.since);
+  }
+}
+
+interface CommitInfo {
+  hash: string;
+  date: string;
+  message: string;
+  author: string;
+}
+
+function outputPretty(commits: CommitInfo[], since?: string): void {
+  const title = since ? `Changes since ${since}` : 'Recent Changes';
+  console.log(fmt.header(`📋 ${title}`));
+
+  // Group by date
+  const byDate = new Map<string, CommitInfo[]>();
+  for (const commit of commits) {
+    const existing = byDate.get(commit.date) || [];
+    existing.push(commit);
+    byDate.set(commit.date, existing);
+  }
+
+  for (const [date, dateCommits] of byDate) {
+    console.log(`\n  ${fmt.highlight(date)}`);
+    for (const commit of dateCommits) {
+      console.log(`    ${fmt.dim('•')} ${fmt.value(commit.message)}`);
+      console.log(`      ${fmt.dim(`${commit.hash} by ${commit.author}`)}`);
+    }
+  }
+
+  console.log('');
+}
+
+function outputMarkdown(repoName: string, commits: CommitInfo[], since?: string): void {
+  const title = since ? `Changes since ${since}` : 'Changelog';
+  
+  console.log(`# ${repoName} - ${title}\n`);
+
+  // Group by date
+  const byDate = new Map<string, CommitInfo[]>();
+  for (const commit of commits) {
+    const existing = byDate.get(commit.date) || [];
+    existing.push(commit);
+    byDate.set(commit.date, existing);
+  }
+
+  for (const [date, dateCommits] of byDate) {
+    console.log(`## ${date}\n`);
+    for (const commit of dateCommits) {
+      console.log(`- ${commit.message} (\`${commit.hash}\` by ${commit.author})`);
+    }
+    console.log('');
+  }
+}

package/src/commands/stats.ts

@@ -0,0 +1,64 @@
+import { getCommitStats, isGitRepo } from '../utils/git';
+import * as fmt from '../utils/format';
+
+interface StatsOptions {
+  limit?: number;
+}
+
+export async function stats(options: StatsOptions = {}): Promise<void> {
+  if (!(await isGitRepo())) {
+    console.log(fmt.error('Error: Not a git repository'));
+    process.exit(1);
+  }
+
+  const limit = options.limit;
+  const commitStats = await getCommitStats(limit);
+
+  console.log(fmt.header('📈 Commit Statistics'));
+  
+  if (limit) {
+    console.log(fmt.dim(`  (Analyzing last ${limit} commits)\n`));
+  }
+
+  // Overview
+  console.log(fmt.table([
+    ['Total Commits', String(commitStats.totalCommits)],
+    ['Contributors', String(commitStats.authors.size)],
+    ['First Commit', fmt.formatDate(commitStats.firstCommit)],
+    ['Last Commit', fmt.formatDate(commitStats.lastCommit)],
+    ['Commits/Day', fmt.formatNumber(commitStats.commitsPerDay)],
+  ]));
+
+  // Calculate project age
+  if (commitStats.firstCommit && commitStats.lastCommit) {
+    const ageMs = commitStats.lastCommit.getTime() - commitStats.firstCommit.getTime();
+    const days = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+    const months = Math.floor(days / 30);
+    const years = Math.floor(days / 365);
+    
+    let ageStr: string;
+    if (years > 0) {
+      ageStr = `${years} year${years > 1 ? 's' : ''}, ${months % 12} month${months % 12 !== 1 ? 's' : ''}`;
+    } else if (months > 0) {
+      ageStr = `${months} month${months > 1 ? 's' : ''}, ${days % 30} day${days % 30 !== 1 ? 's' : ''}`;
+    } else {
+      ageStr = `${days} day${days !== 1 ? 's' : ''}`;
+    }
+    
+    console.log(`\n  ${fmt.label('Project Age')} ${fmt.value(ageStr)}`);
+  }
+
+  // All Contributors (sorted)
+  console.log(fmt.header('👥 All Contributors'));
+  
+  const sorted = [...commitStats.authors.entries()].sort((a, b) => b[1] - a[1]);
+  const maxCount = sorted[0]?.[1] || 1;
+  
+  for (const [author, count] of sorted) {
+    const percentage = (count / commitStats.totalCommits) * 100;
+    const bar = fmt.progressBar(count, maxCount, 20);
+    console.log(`  ${bar} ${fmt.value(author.padEnd(25))} ${fmt.highlight(String(count).padStart(5))} ${fmt.dim(`(${percentage.toFixed(1)}%)`)}`);
+  }
+
+  console.log('');
+}

package/src/commands/summary.ts

@@ -0,0 +1,58 @@
+import { getRepoInfo, getCommitStats, getRecentCommits, isGitRepo } from '../utils/git';
+import * as fmt from '../utils/format';
+
+export async function summary(): Promise<void> {
+  if (!(await isGitRepo())) {
+    console.log(fmt.error('Error: Not a git repository'));
+    process.exit(1);
+  }
+
+  const [repo, stats, recent] = await Promise.all([
+    getRepoInfo(),
+    getCommitStats(),
+    getRecentCommits(5),
+  ]);
+
+  // Header
+  console.log(fmt.header(`📊 ${repo.name}`));
+
+  // Repository Info
+  console.log(fmt.table([
+    ['Branch', repo.branch],
+    ['Status', repo.isClean ? fmt.success('✓ Clean') : fmt.warning(`${repo.uncommittedChanges} changes`)],
+    ['Remote', repo.remoteUrl || fmt.dim('none')],
+  ]));
+
+  // Statistics
+  console.log(fmt.header('📈 Statistics'));
+  console.log(fmt.table([
+    ['Total Commits', String(stats.totalCommits)],
+    ['Contributors', String(stats.authors.size)],
+    ['First Commit', fmt.formatDate(stats.firstCommit)],
+    ['Last Commit', fmt.formatDate(stats.lastCommit)],
+    ['Commits/Day', fmt.formatNumber(stats.commitsPerDay)],
+  ]));
+
+  // Top Contributors
+  if (stats.authors.size > 0) {
+    console.log(fmt.header('👥 Top Contributors'));
+    const sorted = [...stats.authors.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
+    
+    for (const [author, count] of sorted) {
+      const percentage = (count / stats.totalCommits) * 100;
+      const bar = fmt.progressBar(count, stats.totalCommits, 15);
+      console.log(`  ${bar} ${fmt.value(author)} ${fmt.dim(`(${count} commits, ${percentage.toFixed(0)}%)`)}`);
+    }
+  }
+
+  // Recent Commits
+  if (recent.length > 0) {
+    console.log(fmt.header('📝 Recent Commits'));
+    for (const commit of recent) {
+      console.log(`  ${fmt.dim(commit.hash)} ${fmt.value(commit.message)}`);
+      console.log(`         ${fmt.dim(`${commit.author} • ${commit.date}`)}`);
+    }
+  }
+
+  console.log('');
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { summary } from './commands/summary';
+import { stats } from './commands/stats';
+import { changelog } from './commands/changelog';
+
+const program = new Command();
+
+program
+  .name('git-glance')
+  .description('Beautiful git repository summaries, statistics, and changelogs')
+  .version('1.0.0');
+
+// Default command: summary
+program
+  .command('summary', { isDefault: true })
+  .description('Show repository summary (default)')
+  .action(async () => {
+    await summary();
+  });
+
+// Stats command
+program
+  .command('stats')
+  .description('Show detailed commit statistics')
+  .option('-l, --limit <number>', 'Limit to last N commits', parseInt)
+  .action(async (options) => {
+    await stats(options);
+  });
+
+// Changelog command
+program
+  .command('changelog')
+  .alias('log')
+  .description('Generate changelog from commits')
+  .option('-s, --since <date>', 'Show commits since date (e.g., "1 week ago", "2024-01-01")')
+  .option('-n, --count <number>', 'Number of commits to show', parseInt)
+  .option('-m, --markdown', 'Output in markdown format')
+  .action(async (options) => {
+    await changelog(options);
+  });
+
+program.parse();

package/src/utils/format.ts

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+
+export function header(text: string): string {
+  return chalk.bold.cyan(`\n═══ ${text} ═══\n`);
+}
+
+export function label(text: string): string {
+  return chalk.gray(text + ':');
+}
+
+export function value(text: string | number): string {
+  return chalk.white(String(text));
+}
+
+export function highlight(text: string | number): string {
+  return chalk.yellow(String(text));
+}
+
+export function success(text: string): string {
+  return chalk.green(text);
+}
+
+export function warning(text: string): string {
+  return chalk.yellow(text);
+}
+
+export function error(text: string): string {
+  return chalk.red(text);
+}
+
+export function dim(text: string): string {
+  return chalk.gray(text);
+}
+
+export function formatDate(date: Date | null): string {
+  if (!date) return 'N/A';
+  return date.toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+  });
+}
+
+export function formatNumber(num: number, decimals: number = 1): string {
+  if (Number.isInteger(num)) return String(num);
+  return num.toFixed(decimals);
+}
+
+export function progressBar(current: number, total: number, width: number = 20): string {
+  const percentage = Math.min(1, current / total);
+  const filled = Math.round(width * percentage);
+  const empty = width - filled;
+  
+  return chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
+}
+
+export function table(rows: [string, string][]): string {
+  const maxLabel = Math.max(...rows.map(r => r[0].length));
+  
+  return rows
+    .map(([l, v]) => `  ${label(l.padEnd(maxLabel))} ${value(v)}`)
+    .join('\n');
+}

package/src/utils/git.ts

@@ -0,0 +1,120 @@
+import simpleGit, { SimpleGit, LogResult } from 'simple-git';
+
+export interface RepoInfo {
+  name: string;
+  branch: string;
+  remoteUrl: string | null;
+  isClean: boolean;
+  uncommittedChanges: number;
+}
+
+export interface CommitStats {
+  totalCommits: number;
+  authors: Map<string, number>;
+  firstCommit: Date | null;
+  lastCommit: Date | null;
+  commitsPerDay: number;
+}
+
+export interface CommitInfo {
+  hash: string;
+  date: string;
+  message: string;
+  author: string;
+}
+
+const git: SimpleGit = simpleGit();
+
+export async function isGitRepo(): Promise<boolean> {
+  try {
+    await git.revparse(['--is-inside-work-tree']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function getRepoInfo(): Promise<RepoInfo> {
+  const status = await git.status();
+  const branch = status.current || 'unknown';
+  
+  let remoteUrl: string | null = null;
+  try {
+    const remotes = await git.getRemotes(true);
+    const origin = remotes.find(r => r.name === 'origin');
+    remoteUrl = origin?.refs.fetch || null;
+  } catch {
+    // No remotes
+  }
+
+  // Get repo name from directory or remote
+  let name = process.cwd().split(/[/\\]/).pop() || 'unknown';
+  if (remoteUrl) {
+    const match = remoteUrl.match(/\/([^/]+?)(\.git)?$/);
+    if (match) name = match[1];
+  }
+
+  return {
+    name,
+    branch,
+    remoteUrl,
+    isClean: status.isClean(),
+    uncommittedChanges: status.files.length,
+  };
+}
+
+export async function getCommitStats(limit?: number): Promise<CommitStats> {
+  const log: LogResult = await git.log(limit ? ['--max-count=' + limit] : []);
+  
+  const authors = new Map<string, number>();
+  let firstCommit: Date | null = null;
+  let lastCommit: Date | null = null;
+
+  for (const commit of log.all) {
+    // Count by author
+    const author = commit.author_name;
+    authors.set(author, (authors.get(author) || 0) + 1);
+
+    // Track dates
+    const date = new Date(commit.date);
+    if (!firstCommit || date < firstCommit) firstCommit = date;
+    if (!lastCommit || date > lastCommit) lastCommit = date;
+  }
+
+  // Calculate commits per day
+  let commitsPerDay = 0;
+  if (firstCommit && lastCommit) {
+    const days = Math.max(1, (lastCommit.getTime() - firstCommit.getTime()) / (1000 * 60 * 60 * 24));
+    commitsPerDay = log.total / days;
+  }
+
+  return {
+    totalCommits: log.total,
+    authors,
+    firstCommit,
+    lastCommit,
+    commitsPerDay,
+  };
+}
+
+export async function getRecentCommits(count: number = 10): Promise<CommitInfo[]> {
+  const log = await git.log(['--max-count=' + count]);
+  
+  return log.all.map(commit => ({
+    hash: commit.hash.substring(0, 7),
+    date: new Date(commit.date).toLocaleDateString(),
+    message: commit.message.split('\n')[0], // First line only
+    author: commit.author_name,
+  }));
+}
+
+export async function getCommitsSince(since: string): Promise<CommitInfo[]> {
+  const log = await git.log(['--since=' + since]);
+  
+  return log.all.map(commit => ({
+    hash: commit.hash.substring(0, 7),
+    date: new Date(commit.date).toLocaleDateString(),
+    message: commit.message.split('\n')[0],
+    author: commit.author_name,
+  }));
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}