@herodevs/cli 2.0.0-beta.12 → 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.12/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.12/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.10 darwin-arm64 node-v22.18.0
+@herodevs/cli/2.0.0-beta.14 darwin-arm64 node-v24.10.0
 $ hd --help [COMMAND]
 USAGE
   $ hd COMMAND
@@ -82,7 +82,9 @@ USAGE
 ## Commands
 <!-- commands -->
 * [`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.
 
@@ -95,7 +97,7 @@ USAGE
   $ hd help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMAND...  Command to show help for.
+  [COMMAND...]  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -104,7 +106,43 @@ DESCRIPTION
   Display help for hd.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.33/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.34/src/commands/help.ts)_
+
+## `hd report committers`
+
+Generate report of committers to a git repository
+
+```
+USAGE
+  $ hd report committers [--json] [-x <value>...] [-d <value>] [--monthly] [-m <value> | -s <value> | -e <value> |  | ]
+    [-c] [-s]
+
+FLAGS
+  -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
+
+EXAMPLES
+  $ hd report committers
+
+  $ hd report committers --csv -s
+
+  $ hd report committers --json
+
+  $ hd report committers --csv
+```
+
+_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`
 
@@ -112,18 +150,20 @@ Scan a given SBOM for EOL data
 
 ```
 USAGE
-  $ hd scan eol [--json] [-f <value> | -d <value>] [-s] [-o <value>] [--saveSbom] [--sbomOutput <value>] [--saveTrimmedSbom] [--hideReportUrl] [--version]
+  $ hd scan eol [--json] [-f <value> | -d <value>] [-s] [-o <value>] [--saveSbom] [--sbomOutput <value>]
+    [--saveTrimmedSbom] [--hideReportUrl] [--version]
 
 FLAGS
-  -d, --dir=<value>      [default: <current directory>] The directory to scan in order to scan for EOL
-  -f, --file=<value>     The file path of an existing SBOM to scan for EOL (supports CycloneDX and SPDX 2.3 formats)
-  -s, --save             Save the generated report as herodevs.report.json in the scanned directory
-  -o, --output=<value>   Save the generated report to a custom path (requires --save, defaults to herodevs.report.json when not provided)
-      --hideReportUrl    Hide the generated web report URL for this scan
-      --saveSbom         Save the generated SBOM as herodevs.sbom.json in the scanned directory
-      --sbomOutput=<value>  Save the generated SBOM to a custom path (requires --saveSbom, defaults to herodevs.sbom.json when not provided)
-      --saveTrimmedSbom  Save the trimmed SBOM as herodevs.sbom-trimmed.json in the scanned directory
-      --version          Show CLI version.
+  -d, --dir=<value>         [default: <current directory>] The directory to scan in order to create a cyclonedx SBOM
+  -f, --file=<value>        The file path of an existing SBOM to scan for EOL (supports CycloneDX and SPDX 2.3 formats)
+  -o, --output=<value>      Save the generated report to a custom path (defaults to herodevs.report.json when not
+                            provided)
+  -s, --save                Save the generated report as herodevs.report.json in the scanned directory
+      --hideReportUrl       Hide the generated web report URL for this scan
+      --saveSbom            Save the generated SBOM as herodevs.sbom.json in the scanned directory
+      --saveTrimmedSbom     Save the trimmed SBOM as herodevs.sbom-trimmed.json in the scanned directory
+      --sbomOutput=<value>  Save the generated SBOM to a custom path (defaults to herodevs.sbom.json when not provided)
+      --version             Show CLI version.
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -157,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.10/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]`
 
@@ -197,7 +271,7 @@ EXAMPLES
     $ hd update --available
 ```
 
-_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.7.8/src/commands/update.ts)_
+_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.7.13/src/commands/update.ts)_
 <!-- commandsstop -->
 
 ## CI/CD Usage

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

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+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<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

@@ -0,0 +1,215 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import { Command, Flags } from '@oclif/core';
+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';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --csv -s',
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= 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. Cannot be used along beforeDate and afterDate',
+            default: 12,
+            exclusive: ['beforeDate', 'afterDate', 's', 'e'],
+        }),
+        csv: Flags.boolean({
+            char: 'c',
+            description: 'Output in CSV format',
+            default: false,
+        }),
+        save: Flags.boolean({
+            char: 's',
+            description: `Save the committers report as ${filenamePrefix}.committers.<output>`,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Committers);
+        const { afterDate, beforeDate, exclude, directory: cwd, monthly, months, csv, save } = flags;
+        const isJson = this.jsonEnabled();
+        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 {
+            const entries = this.fetchGitCommitData(afterDateStartOfDay, beforeDateEndOfDay, ignores, cwd);
+            if (entries.length === 0) {
+                return `No commits found between ${afterDate} and ${beforeDate}`;
+            }
+            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,
+                            },
+                        });
+                    }
+                    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,
+                            },
+                        });
+                    }
+                    break;
+            }
+            if (save) {
+                try {
+                    fs.writeFileSync(`${filenamePrefix}.${monthly ? 'monthly' : 'committers'}.${reportFormat}`, finalReport, {
+                        encoding: 'utf-8',
+                    });
+                    this.log(`Report written to ${reportFormat.toUpperCase()}`);
+                }
+                catch (err) {
+                    this.error(`Failed to save ${reportFormat.toUpperCase()} report: ${getErrorMessage(err)}`);
+                }
+            }
+            this.log(finalReport);
+            return finalReport;
+        }
+        catch (error) {
+            this.error(`Failed to generate report: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * 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, beforeDateEndOfDay, ignores, cwd) {
+        const logParameters = [
+            'log',
+            `--since="${sinceDate}"`,
+            `--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') {
+                    this.error('Git command not found. Please ensure git is installed and available in your PATH.');
+                }
+                this.error(`Git command failed: ${getErrorMessage(logProcess.error)}`);
+            }
+            this.error(`Git command failed: ${getErrorMessage(logProcess.error)}`);
+        }
+        if (logProcess.status !== 0) {
+            this.error(`Git command failed with status ${logProcess.status}: ${logProcess.stderr}`);
+        }
+        if (!logProcess.stdout) {
+            return [];
+        }
+        return parseGitLogOutput(logProcess.stdout);
+    }
+}

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

@@ -0,0 +1,58 @@
+export type ReportFormat = 'txt' | 'csv' | 'json';
+export type CommitEntry = {
+    commitHash: string;
+    author: string;
+    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 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
+ * @returns Parsed commit entries
+ */
+export declare function parseGitLogOutput(output: string): CommitEntry[];
+/**
+ * Generates commits author report
+ * @param entries - commit entries from git log
+ * @returns Commits Author Report
+ */
+export declare function generateCommittersReport(entries: CommitEntry[]): AuthorReportRow[];
+/**
+ * Generates commits monthly report
+ * @param entries - commit entries from git log
+ * @returns Monthly Report
+ */
+export declare function generateMonthlyReport(entries: CommitEntry[]): MonthlyReportRow[];

package/dist/service/committers.svc.js

@@ -0,0 +1,78 @@
+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
+ * @returns Parsed commit entries
+ */
+export function parseGitLogOutput(output) {
+    return output
+        .split('\n')
+        .filter(Boolean)
+        .map((line) => {
+        // Remove surrounding double quotes if present (e.g. "March|John Doe" → March|John Doe)
+        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),
+        };
+    });
+}
+/**
+ * Generates commits author report
+ * @param entries - commit entries from git log
+ * @returns Commits Author Report
+ */
+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,
+            });
+        }
+        return acc;
+    }, new Map()))
+        .map(([key, value]) => ({
+        author: key,
+        commits: value.commits,
+        lastCommitOn: value.lastCommitOn,
+    }))
+        .sort((a, b) => b.commits.length - a.commits.length);
+}
+/**
+ * Generates commits monthly report
+ * @param entries - commit entries from git log
+ * @returns Monthly Report
+ */
+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;
+                }, {}),
+            });
+        }
+        return acc;
+    }, new Map()))
+        .map(([key, value]) => ({
+        month: key,
+        ...value,
+    }))
+        .sort((a, b) => new Date(a.end).valueOf() - new Date(b.end).valueOf());
+}

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

@@ -0,0 +1,8 @@
+export declare const isError: (error: unknown) => error is Error;
+export declare const isErrnoException: (error: unknown) => error is NodeJS.ErrnoException;
+export declare const isApolloError: (error: unknown) => error is ApolloError;
+export declare const getErrorMessage: (error: unknown) => string;
+export declare class ApolloError extends Error {
+    readonly originalError?: unknown;
+    constructor(message: string, original?: unknown);
+}

package/dist/service/error.svc.js

@@ -0,0 +1,28 @@
+export const isError = (error) => {
+    return error instanceof Error;
+};
+export const isErrnoException = (error) => {
+    return isError(error) && 'code' in error;
+};
+export const isApolloError = (error) => {
+    return error instanceof ApolloError;
+};
+export const getErrorMessage = (error) => {
+    if (isError(error)) {
+        return error.message;
+    }
+    return 'Unknown error';
+};
+export class ApolloError extends Error {
+    originalError;
+    constructor(message, original) {
+        if (isError(original)) {
+            super(`${message}: ${original.message}`);
+        }
+        else {
+            super(`${message}: ${String(original)}`);
+        }
+        this.name = 'ApolloError';
+        this.originalError = original;
+    }
+}

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.12",
+  "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.20",
-    "@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.11",
-    "@oclif/core": "^4.5.3",
+    "@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.2.2",
+    "@biomejs/biome": "^2.3.4",
     "@oclif/test": "^4.1.13",
     "@types/inquirer": "^9.0.9",
-    "@types/node": "^24.9.2",
+    "@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",