@herodevs/cli 2.0.0-beta.13 → 2.0.0-beta.14

package/README.md

@@ -43,11 +43,11 @@ npm install -g @herodevs/cli@beta
 HeroDevs CLI is available as a binary installation, without requiring `npm`. To do that, you may either download and run the script manually, or use the following cURL or Wget command:
 
 ```sh
-curl -o- https://raw.githubusercontent.com/herodevs/cli/v2.0.0-beta.13/scripts/install.sh | bash
+curl -o- https://raw.githubusercontent.com/herodevs/cli/v2.0.0-beta.14/scripts/install.sh | bash
 ```
 
 ```sh
-wget -qO- https://raw.githubusercontent.com/herodevs/cli/v2.0.0-beta.13/scripts/install.sh | bash
+wget -qO- https://raw.githubusercontent.com/herodevs/cli/v2.0.0-beta.14/scripts/install.sh | bash
 ```
 
 ## Scanning Behavior
@@ -72,7 +72,7 @@ $ npm install -g @herodevs/cli@beta
 $ hd COMMAND
 running command...
 $ hd (--version)
-@herodevs/cli/2.0.0-beta.12 darwin-arm64 node-v24.10.0
+@herodevs/cli/2.0.0-beta.14 darwin-arm64 node-v24.10.0
 $ hd --help [COMMAND]
 USAGE
   $ hd COMMAND
@@ -84,6 +84,7 @@ USAGE
 * [`hd help [COMMAND]`](#hd-help-command)
 * [`hd report committers`](#hd-report-committers)
 * [`hd scan eol`](#hd-scan-eol)
+* [`hd tracker init`](#hd-tracker-init)
 * [`hd update [CHANNEL]`](#hd-update-channel)
   * **NOTE:** Only applies to [binary installation method](#binary-installation). NPM users should use [`npm install`](#global-npm-installation) to update to the latest version.
 
@@ -113,15 +114,20 @@ Generate report of committers to a git repository
 
 ```
 USAGE
-  $ hd report committers [--json] [-m <value>] [-c] [-s]
+  $ hd report committers [--json] [-x <value>...] [-d <value>] [--monthly] [-m <value> | -s <value> | -e <value> |  | ]
+    [-c] [-s]
 
 FLAGS
-  -c, --csv             Output in CSV format
-  -m, --months=<value>  [default: 12] The number of months of git history to review
-  -s, --save            Save the committers report as herodevs.committers.<output>
-
-GLOBAL FLAGS
-  --json  Format output as json.
+  -c, --csv                 Output in CSV format
+  -d, --directory=<value>   Directory to search
+  -e, --afterDate=<value>   [default: 2024-11-19] Start date (format: yyyy-MM-dd)
+  -m, --months=<value>      [default: 12] The number of months of git history to review. Cannot be used along beforeDate
+                            and afterDate
+  -s, --beforeDate=<value>  [default: 2025-11-19] End date (format: yyyy-MM-dd)
+  -s, --save                Save the committers report as herodevs.committers.<output>
+  -x, --exclude=<value>...  Path Exclusions (eg -x="./src/bin" -x="./dist")
+      --json                Output to JSON format
+      --monthly             Break down by calendar month.
 
 DESCRIPTION
   Generate report of committers to a git repository
@@ -136,7 +142,7 @@ EXAMPLES
   $ hd report committers --csv
 ```
 
-_See code: [src/commands/report/committers.ts](https://github.com/herodevs/cli/blob/v2.0.0-beta.12/src/commands/report/committers.ts)_
+_See code: [src/commands/report/committers.ts](https://github.com/herodevs/cli/blob/v2.0.0-beta.14/src/commands/report/committers.ts)_
 
 ## `hd scan eol`
 
@@ -191,7 +197,41 @@ EXAMPLES
     $ hd scan eol --json
 ```
 
-_See code: [src/commands/scan/eol.ts](https://github.com/herodevs/cli/blob/v2.0.0-beta.12/src/commands/scan/eol.ts)_
+_See code: [src/commands/scan/eol.ts](https://github.com/herodevs/cli/blob/v2.0.0-beta.14/src/commands/scan/eol.ts)_
+
+## `hd tracker init`
+
+Initialize the tracker configuration
+
+```
+USAGE
+  $ hd tracker init [--force -o] [-d <value>] [-f <value>] [-i <value>...]
+
+FLAGS
+  -d, --outputDir=<value>          [default: hd-tracker] Output directory for the tracker configuration file
+  -f, --configFile=<value>         [default: config.json] Filename for the tracker configuration file
+  -i, --ignorePatterns=<value>...  [default: node_modules] Ignore patterns to use for the tracker configuration file
+  -o, --overwrite                  Overwrites the tracker configuration file if it exists
+      --force                      Force tracker configuration file creation. Use with --overwrite flag
+
+DESCRIPTION
+  Initialize the tracker configuration
+
+EXAMPLES
+  $ hd tracker init
+
+  $ hd tracker init -d trackerDir
+
+  $ hd tracker init -d trackerDir -f configFileName
+
+  $ hd tracker init -i node_modules
+
+  $ hd tracker init -i node_modules -i custom_modules
+
+  $ hd tracker init -o
+```
+
+_See code: [src/commands/tracker/init.ts](https://github.com/herodevs/cli/blob/v2.0.0-beta.14/src/commands/tracker/init.ts)_
 
 ## `hd update [CHANNEL]`
 

package/dist/api/gql-operations.js

@@ -1,4 +1,4 @@
-import { gql } from '@apollo/client/core/core.cjs';
+import { gql } from '@apollo/client/core';
 export const createReportMutation = gql `
 mutation createReport($input: CreateEolReportInput) {
   eol {
@@ -20,6 +20,7 @@ query GetEolReport($input: GetEolReportInput) {
       components {
         purl
         metadata
+        dependencySummary
         nesRemediation {
           remediations {
             urls {

package/dist/api/nes.client.d.ts

@@ -1,6 +1,6 @@
-import { ApolloClient } from '@apollo/client/core/index.js';
+import { ApolloClient } from '@apollo/client/core';
 import type { CreateEolReportInput, EolReport } from '@herodevs/eol-shared';
-export declare const createApollo: (uri: string) => ApolloClient<import("@apollo/client/core/index.js").NormalizedCacheObject>;
+export declare const createApollo: (uri: string) => ApolloClient;
 export declare const SbomScanner: (client: ReturnType<typeof createApollo>) => (input: CreateEolReportInput) => Promise<EolReport>;
 export declare class NesClient {
     startScan: ReturnType<typeof SbomScanner>;

package/dist/api/nes.client.js

@@ -1,4 +1,4 @@
-import { ApolloClient, HttpLink, InMemoryCache } from '@apollo/client/core/index.js';
+import { ApolloClient, HttpLink, InMemoryCache } from '@apollo/client/core';
 import { config } from "../config/constants.js";
 import { debugLogger } from "../service/log.svc.js";
 import { stripTypename } from "../utils/strip-typename.js";
@@ -18,12 +18,13 @@ export const createApollo = (uri) => new ApolloClient({
 });
 export const SbomScanner = (client) => {
     return async (input) => {
-        const res = await client.mutate({
+        let res;
+        res = await client.mutate({
             mutation: createReportMutation,
             variables: { input },
         });
-        if (res?.errors?.length) {
-            debugLogger('GraphQL errors in createReport: %o', res.errors);
+        if (res?.error || res?.errors) {
+            debugLogger('Error returned from createReport mutation: %o', res.error || res?.errors);
             throw new Error('Failed to create EOL report');
         }
         const result = res.data?.eol?.createReport;
@@ -47,10 +48,12 @@ export const SbomScanner = (client) => {
         let reportMetadata = null;
         for (let i = 0; i < pages.length; i += config.concurrentPageRequests) {
             const batch = pages.slice(i, i + config.concurrentPageRequests);
-            const batchResponses = await Promise.all(batch);
+            let batchResponses;
+            batchResponses = await Promise.all(batch);
             for (const response of batchResponses) {
-                if (response?.errors?.length) {
-                    debugLogger('GraphQL errors in getReport query: %o', response.errors);
+                const queryErrors = response?.errors;
+                if (response?.error || queryErrors?.length || !response.data?.eol) {
+                    debugLogger('Error in getReport query response: %o', response?.error ?? queryErrors ?? response);
                     throw new Error('Failed to fetch EOL report');
                 }
                 const report = response.data.eol.report;

package/dist/commands/report/committers.d.ts

@@ -1,23 +1,27 @@
 import { Command } from '@oclif/core';
-import { type ReportData } from '../../service/committers.svc.ts';
+import { type CommittersReport } from '../../service/committers.svc.ts';
 export default class Committers extends Command {
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
+        beforeDate: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        afterDate: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        exclude: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        monthly: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         months: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         save: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<ReportData | string>;
-    /**
-     * Generates structured report data
-     * @param entries - parsed git log output for commits
-     */
-    private generateReportData;
+    run(): Promise<CommittersReport | string>;
     /**
      * Fetches git commit data with month and author information
      * @param sinceDate - Date range for git log
+     * @param beforeDateEndOfDay - End date for git log
+     * @param ignores - indicate elements to exclude for git log
+     * @param cwd - directory to use for git log
      */
     private fetchGitCommitData;
 }

package/dist/commands/report/committers.js

@@ -1,9 +1,10 @@
 import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
-import path from 'node:path';
 import { Command, Flags } from '@oclif/core';
-import { filenamePrefix } from "../../config/constants.js";
-import { calculateOverallStats, formatAsCsv, formatAsText, groupCommitsByMonth, parseGitLogOutput, } from "../../service/committers.svc.js";
+import { makeTable } from '@oclif/table';
+import { endOfDay, formatDate, formatISO, parse, subMonths } from 'date-fns';
+import { DEFAULT_DATE_COMMIT_FORMAT, DEFAULT_DATE_FORMAT, filenamePrefix, GIT_OUTPUT_FORMAT, } from "../../config/constants.js";
+import { generateCommittersReport, generateMonthlyReport, parseGitLogOutput, } from "../../service/committers.svc.js";
 import { getErrorMessage, isErrnoException } from "../../service/error.svc.js";
 export default class Committers extends Command {
     static description = 'Generate report of committers to a git repository';
@@ -15,10 +16,39 @@ export default class Committers extends Command {
         '<%= config.bin %> <%= command.id %> --csv',
     ];
     static flags = {
+        beforeDate: Flags.string({
+            char: 's',
+            default: formatDate(new Date(), DEFAULT_DATE_FORMAT),
+            description: `End date (format: ${DEFAULT_DATE_FORMAT})`,
+        }),
+        afterDate: Flags.string({
+            char: 'e',
+            default: formatDate(subMonths(new Date(), 12), DEFAULT_DATE_FORMAT),
+            description: `Start date (format: ${DEFAULT_DATE_FORMAT})`,
+        }),
+        exclude: Flags.string({
+            char: 'x',
+            description: 'Path Exclusions (eg -x="./src/bin" -x="./dist")',
+            multiple: true,
+            multipleNonGreedy: true,
+        }),
+        json: Flags.boolean({
+            description: 'Output to JSON format',
+            default: false,
+        }),
+        directory: Flags.string({
+            char: 'd',
+            description: 'Directory to search',
+        }),
+        monthly: Flags.boolean({
+            description: 'Break down by calendar month.',
+            default: false,
+        }),
         months: Flags.integer({
             char: 'm',
-            description: 'The number of months of git history to review',
+            description: 'The number of months of git history to review. Cannot be used along beforeDate and afterDate',
             default: 12,
+            exclusive: ['beforeDate', 'afterDate', 's', 'e'],
         }),
         csv: Flags.boolean({
             char: 'c',
@@ -33,100 +63,138 @@ export default class Committers extends Command {
     };
     async run() {
         const { flags } = await this.parse(Committers);
-        const { months, csv, save } = flags;
+        const { afterDate, beforeDate, exclude, directory: cwd, monthly, months, csv, save } = flags;
         const isJson = this.jsonEnabled();
-        const sinceDate = `${months} months ago`;
-        this.log('Starting committers report with flags: %O', flags);
+        const reportFormat = isJson ? 'json' : csv ? 'csv' : 'txt';
+        const afterDateStartOfDay = months
+            ? `${subMonths(new Date(), months)}`
+            : `${parse(afterDate, DEFAULT_DATE_FORMAT, new Date())}`;
+        const beforeDateEndOfDay = formatISO(endOfDay(parse(beforeDate, DEFAULT_DATE_FORMAT, new Date())));
+        const ignores = exclude && exclude.length > 0 ? `. "!(${exclude.join('|')})"` : undefined;
         try {
-            // Generate structured report data
-            const entries = this.fetchGitCommitData(sinceDate);
-            this.log('Fetched %d commit entries', entries.length);
-            const reportData = this.generateReportData(entries);
-            // Handle different output scenarios
-            if (isJson) {
-                // JSON mode
-                if (save) {
-                    try {
-                        fs.writeFileSync(path.resolve(`${filenamePrefix}.committers.json`), JSON.stringify(reportData, null, 2));
-                        this.log('Report written to json');
-                    }
-                    catch (error) {
-                        this.error(`Failed to save JSON report: ${getErrorMessage(error)}`);
-                    }
-                }
-                return reportData;
+            const entries = this.fetchGitCommitData(afterDateStartOfDay, beforeDateEndOfDay, ignores, cwd);
+            if (entries.length === 0) {
+                return `No commits found between ${afterDate} and ${beforeDate}`;
             }
-            const textOutput = formatAsText(reportData);
-            if (csv) {
-                // CSV mode
-                const csvOutput = formatAsCsv(reportData);
-                if (save) {
-                    try {
-                        fs.writeFileSync(path.resolve(`${filenamePrefix}.committers.csv`), csvOutput);
-                        this.log('Report written to csv');
+            this.log('\nFetched %d commit entries\n', entries.length);
+            const reportData = monthly ? generateMonthlyReport(entries) : generateCommittersReport(entries);
+            let finalReport;
+            switch (reportFormat) {
+                case 'json':
+                    finalReport = JSON.stringify(reportData.map((row) => 'month' in row
+                        ? {
+                            month: row.month,
+                            start: row.start,
+                            end: row.end,
+                            committers: row.committers,
+                        }
+                        : {
+                            name: row.author,
+                            count: row.commits.length,
+                            lastCommitDate: formatDate(row.lastCommitOn, DEFAULT_DATE_COMMIT_FORMAT),
+                        }), null, 2);
+                    break;
+                case 'csv':
+                    finalReport = reportData
+                        .map((row, index) => 'month' in row
+                        ? `${index},${row.month},${row.start},${row.end},${row.totalCommits}`
+                        : `${index},${row.author},${row.commits.length},${formatDate(row.lastCommitOn, DEFAULT_DATE_COMMIT_FORMAT).replace(',', '')}`)
+                        .join('\n')
+                        .replace(/^/, monthly ? `(index),month,start,end,totalCommits\n` : `(index),Committer,Commits,Last Commit Date\n`);
+                    break;
+                default:
+                    if (monthly) {
+                        finalReport = makeTable({
+                            title: 'Monthly Report',
+                            data: reportData
+                                .filter((row) => 'month' in row)
+                                .map((row, index) => ({
+                                index,
+                                month: row.month,
+                                start: row.start,
+                                end: row.end,
+                                totalCommits: row.totalCommits,
+                            })),
+                            headerOptions: {
+                                color: undefined,
+                                bold: false,
+                            },
+                        });
                     }
-                    catch (error) {
-                        this.error(`Failed to save CSV report: ${getErrorMessage(error)}`);
+                    else {
+                        finalReport = makeTable({
+                            title: 'Committers Report',
+                            data: reportData
+                                .filter((row) => 'author' in row)
+                                .map((row, index) => ({
+                                index,
+                                author: row.author,
+                                commits: row.commits.length,
+                                lastCommitOn: formatDate(row.lastCommitOn, DEFAULT_DATE_COMMIT_FORMAT),
+                            })),
+                            columns: [
+                                {
+                                    key: 'index',
+                                    name: '(index)',
+                                },
+                                {
+                                    key: 'author',
+                                    name: 'Committer',
+                                },
+                                {
+                                    key: 'commits',
+                                    name: 'Commits',
+                                },
+                                {
+                                    key: 'lastCommitOn',
+                                    name: 'Last Commit Date',
+                                },
+                            ],
+                            headerOptions: {
+                                color: undefined,
+                                bold: false,
+                            },
+                        });
                     }
-                }
-                else {
-                    this.log(textOutput);
-                }
-                return csvOutput;
+                    break;
             }
             if (save) {
                 try {
-                    fs.writeFileSync(path.resolve(`${filenamePrefix}.committers.txt`), textOutput);
-                    this.log('Report written to txt');
+                    fs.writeFileSync(`${filenamePrefix}.${monthly ? 'monthly' : 'committers'}.${reportFormat}`, finalReport, {
+                        encoding: 'utf-8',
+                    });
+                    this.log(`Report written to ${reportFormat.toUpperCase()}`);
                 }
-                catch (error) {
-                    this.error(`Failed to save txt report: ${getErrorMessage(error)}`);
+                catch (err) {
+                    this.error(`Failed to save ${reportFormat.toUpperCase()} report: ${getErrorMessage(err)}`);
                 }
             }
-            else {
-                this.log(textOutput);
-            }
-            return textOutput;
+            this.log(finalReport);
+            return finalReport;
         }
         catch (error) {
             this.error(`Failed to generate report: ${getErrorMessage(error)}`);
         }
     }
-    /**
-     * Generates structured report data
-     * @param entries - parsed git log output for commits
-     */
-    generateReportData(entries) {
-        if (entries.length === 0) {
-            return { monthly: {}, overall: { total: 0 } };
-        }
-        const monthlyData = groupCommitsByMonth(entries);
-        const overallStats = calculateOverallStats(entries);
-        const grandTotal = entries.length;
-        // Format into a structured report data object
-        const report = {
-            monthly: {},
-            overall: { ...overallStats, total: grandTotal },
-        };
-        // Add monthly totals
-        for (const [month, authors] of Object.entries(monthlyData)) {
-            const monthTotal = Object.values(authors).reduce((sum, count) => sum + count, 0);
-            report.monthly[month] = { ...authors, total: monthTotal };
-        }
-        return report;
-    }
     /**
      * Fetches git commit data with month and author information
      * @param sinceDate - Date range for git log
+     * @param beforeDateEndOfDay - End date for git log
+     * @param ignores - indicate elements to exclude for git log
+     * @param cwd - directory to use for git log
      */
-    fetchGitCommitData(sinceDate) {
-        const logProcess = spawnSync('git', [
+    fetchGitCommitData(sinceDate, beforeDateEndOfDay, ignores, cwd) {
+        const logParameters = [
             'log',
-            '--all', // Include committers on all branches in the repo
-            '--format="%ad|%an"', // Format: date|author
-            '--date=format:%Y-%m', // Format date as YYYY-MM
             `--since="${sinceDate}"`,
-        ], { encoding: 'utf-8' });
+            `--until="${beforeDateEndOfDay}"`,
+            `--format=${GIT_OUTPUT_FORMAT}`,
+            ...(cwd ? ['--', cwd] : []),
+            ...(ignores ? ['--', ignores] : []),
+        ];
+        const logProcess = spawnSync('git', logParameters, {
+            encoding: 'utf-8',
+        });
         if (logProcess.error) {
             if (isErrnoException(logProcess.error)) {
                 if (logProcess.error.code === 'ENOENT') {

package/dist/commands/tracker/init.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class Init extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        overwrite: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        outputDir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        configFile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        ignorePatterns: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tracker/init.js

@@ -0,0 +1,84 @@
+import { confirm } from '@inquirer/prompts';
+import { Command, Flags } from '@oclif/core';
+import { TRACKER_DEFAULT_CONFIG } from '../../config/tracker.config.js';
+import { createTrackerConfig, getRootDir } from '../../service/tracker.svc.js';
+export default class Init extends Command {
+    static description = 'Initialize the tracker configuration';
+    static enableJsonFlag = false;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> -d trackerDir',
+        '<%= config.bin %> <%= command.id %> -d trackerDir -f configFileName',
+        '<%= config.bin %> <%= command.id %> -i node_modules',
+        '<%= config.bin %> <%= command.id %> -i node_modules -i custom_modules',
+        '<%= config.bin %> <%= command.id %> -o',
+    ];
+    static flags = {
+        overwrite: Flags.boolean({
+            char: 'o',
+            description: 'Overwrites the tracker configuration file if it exists',
+        }),
+        force: Flags.boolean({
+            description: 'Force tracker configuration file creation. Use with --overwrite flag',
+            dependsOn: ['overwrite'],
+        }),
+        outputDir: Flags.string({
+            char: 'd',
+            description: 'Output directory for the tracker configuration file',
+            default: 'hd-tracker',
+        }),
+        configFile: Flags.string({
+            char: 'f',
+            description: 'Filename for the tracker configuration file',
+            default: 'config.json',
+        }),
+        ignorePatterns: Flags.string({
+            char: 'i',
+            description: 'Ignore patterns to use for the tracker configuration file',
+            multiple: true,
+            multipleNonGreedy: true,
+            default: ['node_modules'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Init);
+        const { overwrite, outputDir, configFile, ignorePatterns, force } = flags;
+        this.log('Starting tracker init command');
+        if (overwrite) {
+            if (force) {
+                this.warn(`You're using the --force flag along the --overwrite flag.`);
+            }
+            else {
+                const response = await confirm({
+                    message: `You're using the overwrite flag. If a previous configuration file exists, it will be replaced. Do you want to continue?`,
+                    default: false,
+                });
+                this.log(response ? 'Yes' : 'No');
+                if (!response) {
+                    return;
+                }
+            }
+        }
+        try {
+            const rootDir = getRootDir(global.process.cwd());
+            const outputConfig = {
+                ...TRACKER_DEFAULT_CONFIG,
+                outputDir,
+                configFile,
+                ignorePatterns,
+            };
+            await createTrackerConfig(rootDir, outputConfig, overwrite);
+            this.log(`Tracker init command completed successfully.`);
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                this.error(err, {
+                    message: err.message,
+                });
+            }
+            else {
+                this.error('An unknown error occurred while running the tracker init command');
+            }
+        }
+    }
+}

package/dist/config/constants.d.ts

@@ -4,6 +4,10 @@ export declare const GRAPHQL_PATH = "/graphql";
 export declare const ANALYTICS_URL = "https://apps.herodevs.com/api/eol/track";
 export declare const CONCURRENT_PAGE_REQUESTS = 3;
 export declare const PAGE_SIZE = 500;
+export declare const GIT_OUTPUT_FORMAT: string;
+export declare const DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
+export declare const DEFAULT_DATE_COMMIT_FORMAT = "MM/dd/yyyy, h:mm:ss a";
+export declare const DEFAULT_DATE_COMMIT_MONTH_FORMAT = "MMMM yyyy";
 export declare const config: {
     eolReportUrl: string;
     graphqlHost: string;

package/dist/config/constants.js

@@ -4,6 +4,11 @@ export const GRAPHQL_PATH = '/graphql';
 export const ANALYTICS_URL = 'https://apps.herodevs.com/api/eol/track';
 export const CONCURRENT_PAGE_REQUESTS = 3;
 export const PAGE_SIZE = 500;
+export const GIT_OUTPUT_FORMAT = `"${['%h', '%an', '%ad'].join('|')}"`;
+// Committers Report - Date Constants
+export const DEFAULT_DATE_FORMAT = 'yyyy-MM-dd';
+export const DEFAULT_DATE_COMMIT_FORMAT = 'MM/dd/yyyy, h:mm:ss a';
+export const DEFAULT_DATE_COMMIT_MONTH_FORMAT = 'MMMM yyyy';
 let concurrentPageRequests = CONCURRENT_PAGE_REQUESTS;
 const parsed = Number.parseInt(process.env.CONCURRENT_PAGE_REQUESTS ?? '0', 10);
 if (parsed > 0) {

package/dist/config/tracker.config.d.ts

@@ -0,0 +1,16 @@
+export interface TrackerCategoryDefinition {
+    fileTypes: string[];
+    includes: string[];
+    excludes?: string[];
+    jsTsPairs?: 'js' | 'ts' | 'ignore';
+}
+export type TrackerConfig = {
+    categories: {
+        [key: string]: TrackerCategoryDefinition;
+    };
+    ignorePatterns?: string[];
+    outputDir: string;
+    configFile: string;
+};
+export declare const TRACKER_ROOT_FILE = "package.json";
+export declare const TRACKER_DEFAULT_CONFIG: TrackerConfig;

package/dist/config/tracker.config.js

@@ -0,0 +1,18 @@
+export const TRACKER_ROOT_FILE = 'package.json';
+export const TRACKER_DEFAULT_CONFIG = {
+    categories: {
+        legacy: {
+            fileTypes: ['js', 'ts', 'html', 'css', 'scss', 'less'],
+            includes: ['./legacy'],
+            jsTsPairs: 'js',
+        },
+        modern: {
+            fileTypes: ['ts', 'html', 'css', 'scss', 'less'],
+            includes: ['./modern'],
+            jsTsPairs: 'ts',
+        },
+    },
+    ignorePatterns: ['node_modules'],
+    outputDir: 'hd-tracker',
+    configFile: 'config.json',
+};

package/dist/service/committers.svc.d.ts

@@ -1,25 +1,43 @@
-export interface CommitEntry {
-    month: string;
+export type ReportFormat = 'txt' | 'csv' | 'json';
+export type CommitEntry = {
+    commitHash: string;
     author: string;
-}
-export interface AuthorCommitCounts {
+    date: Date;
+    monthGroup: string;
+};
+export type CommitAuthorData = {
+    commits: CommitEntry[];
+    lastCommitOn: Date;
+};
+export type CommitMonthData = {
+    start: Date | string;
+    end: Date | string;
+    totalCommits: number;
+    committers: AuthorCommitCount;
+};
+export type AuthorCommitCount = {
     [author: string]: number;
-}
-export interface MonthlyData {
-    [month: string]: AuthorCommitCounts;
-}
-export interface ReportData {
-    monthly: {
-        [month: string]: {
-            [author: string]: number;
-            total: number;
-        };
-    };
-    overall: {
-        [author: string]: number;
-        total: number;
-    };
-}
+};
+export type AuthorReportTableRow = {
+    index: number;
+    author: string;
+    commits: number;
+    lastCommitOn: string;
+};
+export type MonthlyReportTableRow = {
+    index: number;
+    month: number;
+    start: string;
+    end: string;
+    totalCommits: number;
+};
+export type MonthlyReportRow = {
+    month: string;
+} & CommitMonthData;
+export type AuthorReportRow = {
+    author: string;
+} & CommitAuthorData;
+export type CommittersReport = AuthorReportRow[] | MonthlyReportRow[];
 /**
  * Parses git log output into structured data
  * @param output - Git log command output
@@ -27,44 +45,14 @@ export interface ReportData {
  */
 export declare function parseGitLogOutput(output: string): CommitEntry[];
 /**
- * Groups commit data by month
- * @param entries - Commit entries
- * @returns Object with months as keys and author commit counts as values
- */
-export declare function groupCommitsByMonth(entries: CommitEntry[]): MonthlyData;
-/**
- * Calculates overall commit statistics by author
- * @param entries - Commit entries
- * @returns Object with authors as keys and total commit counts as values
- */
-export declare function calculateOverallStats(entries: CommitEntry[]): AuthorCommitCounts;
-/**
- * Formats monthly report sections
- * @param monthlyData - Grouped commit data by month
- * @returns Formatted monthly report sections
- */
-export declare function formatMonthlyReport(monthlyData: MonthlyData): string;
-/**
- * Formats overall statistics section
- * @param overallStats - Overall commit counts by author
- * @param grandTotal - Total number of commits
- * @returns Formatted overall statistics section
- */
-export declare function formatOverallStats(overallStats: AuthorCommitCounts, grandTotal: number): string;
-/**
- * Formats the report data as CSV
- * @param data - The structured report data
- */
-export declare function formatAsCsv(data: ReportData): string;
-/**
- * Formats the report data as text
- * @param data - The structured report data
+ * Generates commits author report
+ * @param entries - commit entries from git log
+ * @returns Commits Author Report
  */
-export declare function formatAsText(data: ReportData): string;
+export declare function generateCommittersReport(entries: CommitEntry[]): AuthorReportRow[];
 /**
- * Format output based on user preference
- * @param output
- * @param reportData
- * @returns
+ * Generates commits monthly report
+ * @param entries - commit entries from git log
+ * @returns Monthly Report
  */
-export declare function formatOutputBasedOnFlag(output: string, reportData: ReportData): string;
+export declare function generateMonthlyReport(entries: CommitEntry[]): MonthlyReportRow[];

package/dist/service/committers.svc.js

@@ -1,3 +1,5 @@
+import { endOfMonth, formatDate, parse } from 'date-fns';
+import { DEFAULT_DATE_COMMIT_MONTH_FORMAT, DEFAULT_DATE_FORMAT } from '../config/constants.js';
 /**
  * Parses git log output into structured data
  * @param output - Git log command output
@@ -9,188 +11,68 @@ export function parseGitLogOutput(output) {
         .filter(Boolean)
         .map((line) => {
         // Remove surrounding double quotes if present (e.g. "March|John Doe" → March|John Doe)
-        const [month, author] = line.replace(/^"(.*)"$/, '$1').split('|');
-        return { month, author };
+        const [commitHash, author, date] = line.replace(/^"(.*)"$/, '$1').split('|');
+        return {
+            commitHash,
+            author,
+            date: parse(formatDate(new Date(date), DEFAULT_DATE_FORMAT), DEFAULT_DATE_FORMAT, new Date()),
+            monthGroup: formatDate(new Date(date), DEFAULT_DATE_COMMIT_MONTH_FORMAT),
+        };
     });
 }
 /**
- * Groups commit data by month
- * @param entries - Commit entries
- * @returns Object with months as keys and author commit counts as values
+ * Generates commits author report
+ * @param entries - commit entries from git log
+ * @returns Commits Author Report
  */
-export function groupCommitsByMonth(entries) {
-    const result = {};
-    // Group commits by month
-    const commitsByMonth = entries.reduce((acc, entry) => {
-        const monthKey = entry.month;
-        if (!acc[monthKey]) {
-            acc[monthKey] = [];
+export function generateCommittersReport(entries) {
+    return Array.from(entries
+        .sort((a, b) => b.date.valueOf() - a.date.valueOf())
+        .reduce((acc, curr, _index, array) => {
+        if (!acc.has(curr.author)) {
+            const byAuthor = array.filter((c) => c.author === curr.author);
+            acc.set(curr.author, {
+                commits: byAuthor,
+                lastCommitOn: byAuthor[0].date,
+            });
         }
-        acc[monthKey].push(entry);
         return acc;
-    }, {});
-    // Process each month
-    for (const [month, commits] of Object.entries(commitsByMonth)) {
-        if (!commits) {
-            result[month] = {};
-            continue;
-        }
-        // Count commits per author for this month
-        const commitsByAuthor = commits.reduce((acc, entry) => {
-            const authorKey = entry.author;
-            if (!acc[authorKey]) {
-                acc[authorKey] = [];
-            }
-            acc[authorKey].push(entry);
-            return acc;
-        }, {});
-        const authorCounts = {};
-        for (const [author, authorCommits] of Object.entries(commitsByAuthor)) {
-            authorCounts[author] = authorCommits?.length ?? 0;
-        }
-        result[month] = authorCounts;
-    }
-    return result;
+    }, new Map()))
+        .map(([key, value]) => ({
+        author: key,
+        commits: value.commits,
+        lastCommitOn: value.lastCommitOn,
+    }))
+        .sort((a, b) => b.commits.length - a.commits.length);
 }
 /**
- * Calculates overall commit statistics by author
- * @param entries - Commit entries
- * @returns Object with authors as keys and total commit counts as values
+ * Generates commits monthly report
+ * @param entries - commit entries from git log
+ * @returns Monthly Report
  */
-export function calculateOverallStats(entries) {
-    const commitsByAuthor = entries.reduce((acc, entry) => {
-        const authorKey = entry.author;
-        if (!acc[authorKey]) {
-            acc[authorKey] = [];
+export function generateMonthlyReport(entries) {
+    return Array.from(entries
+        .sort((a, b) => b.date.valueOf() - a.date.valueOf())
+        .reduce((acc, curr, _index, array) => {
+        if (!acc.has(curr.monthGroup)) {
+            const monthlyCommits = array.filter((e) => e.monthGroup === curr.monthGroup);
+            acc.set(curr.monthGroup, {
+                start: formatDate(monthlyCommits[0].date, DEFAULT_DATE_FORMAT),
+                end: formatDate(endOfMonth(monthlyCommits[0].date), DEFAULT_DATE_FORMAT),
+                totalCommits: monthlyCommits.length,
+                committers: monthlyCommits.reduce((acc, curr) => {
+                    if (!acc[curr.author]) {
+                        acc[curr.author] = monthlyCommits.filter((c) => c.author === curr.author).length;
+                    }
+                    return acc;
+                }, {}),
+            });
         }
-        acc[authorKey].push(entry);
         return acc;
-    }, {});
-    const result = {};
-    // Count commits for each author
-    for (const author in commitsByAuthor) {
-        result[author] = commitsByAuthor[author]?.length ?? 0;
-    }
-    return result;
-}
-/**
- * Formats monthly report sections
- * @param monthlyData - Grouped commit data by month
- * @returns Formatted monthly report sections
- */
-export function formatMonthlyReport(monthlyData) {
-    const sortedMonths = Object.keys(monthlyData).sort();
-    let report = '';
-    for (const month of sortedMonths) {
-        report += `\n## ${month}\n`;
-        const authors = Object.entries(monthlyData[month]).sort((a, b) => b[1] - a[1]);
-        for (const [author, count] of authors) {
-            report += `${count.toString().padStart(6)}  ${author}\n`;
-        }
-        const monthTotal = authors.reduce((sum, [_, count]) => sum + count, 0);
-        report += `${monthTotal.toString().padStart(6)}  TOTAL\n`;
-    }
-    return report;
-}
-/**
- * Formats overall statistics section
- * @param overallStats - Overall commit counts by author
- * @param grandTotal - Total number of commits
- * @returns Formatted overall statistics section
- */
-export function formatOverallStats(overallStats, grandTotal) {
-    let report = '\n## Overall Statistics\n';
-    const sortedStats = Object.entries(overallStats).sort((a, b) => b[1] - a[1]);
-    for (const [author, count] of sortedStats) {
-        report += `${count.toString().padStart(6)}  ${author}\n`;
-    }
-    report += `${grandTotal.toString().padStart(6)}  GRAND TOTAL\n`;
-    return report;
-}
-/**
- * Formats the report data as CSV
- * @param data - The structured report data
- */
-export function formatAsCsv(data) {
-    // First prepare all author names (for columns)
-    const allAuthors = new Set();
-    // Collect all unique author names
-    for (const monthData of Object.values(data.monthly)) {
-        for (const author of Object.keys(monthData)) {
-            if (author !== 'total')
-                allAuthors.add(author);
-        }
-    }
-    const authors = Array.from(allAuthors).sort();
-    // Create CSV header
-    let csv = `Month,${authors.join(',')},Total\n`;
-    // Add monthly data rows
-    const sortedMonths = Object.keys(data.monthly).sort();
-    for (const month of sortedMonths) {
-        csv += month;
-        // Add data for each author
-        for (const author of authors) {
-            const count = data.monthly[month][author] || 0;
-            csv += `,${count}`;
-        }
-        // Add monthly total
-        csv += `,${`${data.monthly[month].total}\n`}`;
-    }
-    // Add overall totals row
-    csv += 'Overall';
-    for (const author of authors) {
-        const count = data.overall[author] || 0;
-        csv += `,${count}`;
-    }
-    csv += `,${data.overall.total}\n`;
-    return csv;
-}
-/**
- * Formats the report data as text
- * @param data - The structured report data
- */
-export function formatAsText(data) {
-    let report = 'Monthly Commit Report\n';
-    // Monthly sections
-    const sortedMonths = Object.keys(data.monthly).sort();
-    for (const month of sortedMonths) {
-        report += `\n## ${month}\n`;
-        const authors = Object.entries(data.monthly[month])
-            .filter(([author]) => author !== 'total')
-            .sort((a, b) => b[1] - a[1]);
-        for (const [author, count] of authors) {
-            report += `${count.toString().padStart(6)}  ${author}\n`;
-        }
-        report += `${data.monthly[month].total.toString().padStart(6)}  TOTAL\n`;
-    }
-    // Overall statistics
-    report += '\n## Overall Statistics\n';
-    const sortedEntries = Object.entries(data.overall)
-        .filter(([author]) => author !== 'total')
-        .sort((a, b) => b[1] - a[1]);
-    for (const [author, count] of sortedEntries) {
-        report += `${count.toString().padStart(6)}  ${author}\n`;
-    }
-    report += `${data.overall.total.toString().padStart(6)}  GRAND TOTAL\n`;
-    return report;
-}
-/**
- * Format output based on user preference
- * @param output
- * @param reportData
- * @returns
- */
-export function formatOutputBasedOnFlag(output, reportData) {
-    let formattedOutput;
-    switch (output) {
-        case 'json':
-            formattedOutput = JSON.stringify(reportData, null, 2);
-            break;
-        case 'csv':
-            formattedOutput = formatAsCsv(reportData);
-            break;
-        default:
-            formattedOutput = formatAsText(reportData);
-    }
-    return formattedOutput;
+    }, new Map()))
+        .map(([key, value]) => ({
+        month: key,
+        ...value,
+    }))
+        .sort((a, b) => new Date(a.end).valueOf() - new Date(b.end).valueOf());
 }

package/dist/service/tracker.svc.d.ts

@@ -0,0 +1,3 @@
+import { type TrackerConfig } from '../config/tracker.config.js';
+export declare const getRootDir: (path: string) => string;
+export declare const createTrackerConfig: (rootPath: string, config: TrackerConfig, overwrite?: boolean) => Promise<void>;

package/dist/service/tracker.svc.js

@@ -0,0 +1,26 @@
+import { existsSync, mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { TRACKER_ROOT_FILE } from '../config/tracker.config.js';
+export const getRootDir = (path) => {
+    if (existsSync(join(path, TRACKER_ROOT_FILE))) {
+        return path;
+    }
+    else if (path === join(path, '..')) {
+        throw new Error(`Couldn't find root directory for the project`);
+    }
+    return getRootDir(resolve(join(path, '..')));
+};
+export const createTrackerConfig = async (rootPath, config, overwrite = false) => {
+    const { outputDir } = config;
+    const configDir = join(rootPath, outputDir);
+    const configFile = join(configDir, config.configFile);
+    const doesConfigFileExists = existsSync(configFile);
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir);
+    }
+    if (doesConfigFileExists && !overwrite) {
+        throw new Error(`Configuration file already exists for this repo. If you want to overwrite it, run the command again with the --overwrite flag`);
+    }
+    await writeFile(join(configDir, config.configFile), JSON.stringify(config, null, 2));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herodevs/cli",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.14",
   "author": "HeroDevs, Inc",
   "bin": {
     "hd": "./bin/run.js"
@@ -39,13 +39,16 @@
     "herodevs cli"
   ],
   "dependencies": {
-    "@amplitude/analytics-node": "^1.5.21",
-    "@apollo/client": "^3.13.8",
+    "@amplitude/analytics-node": "^1.5.22",
+    "@apollo/client": "^4.0.9",
     "@cyclonedx/cdxgen": "^11.11.0",
     "@herodevs/eol-shared": "github:herodevs/eol-shared#v0.1.12",
+    "@inquirer/prompts": "^8.0.1",
     "@oclif/core": "^4.8.0",
     "@oclif/plugin-help": "^6.2.32",
-    "@oclif/plugin-update": "^4.7.13",
+    "@oclif/plugin-update": "^4.7.14",
+    "@oclif/table": "^0.5.1",
+    "date-fns": "^4.1.0",
     "node-machine-id": "^1.1.12",
     "ora": "^9.0.0",
     "packageurl-js": "^2.0.1",
@@ -53,14 +56,16 @@
     "update-notifier": "^7.3.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.3",
+    "@biomejs/biome": "^2.3.4",
     "@oclif/test": "^4.1.13",
     "@types/inquirer": "^9.0.9",
+    "@types/mock-fs": "^4.13.4",
     "@types/node": "^24.10.0",
     "@types/sinon": "^17.0.4",
     "@types/update-notifier": "^6.0.8",
     "globstar": "^1.0.0",
-    "oclif": "^4.22.38",
+    "mock-fs": "^5.5.0",
+    "oclif": "^4.22.47",
     "shx": "^0.4.0",
     "sinon": "^21.0.0",
     "ts-node": "^10.9.2",
@@ -110,4 +115,4 @@
     }
   },
   "types": "dist/index.d.ts"
-}
+}