@herodevs/cli 1.3.0-beta.1 → 1.5.0-beta.1

package/README.md

@@ -16,7 +16,7 @@ $ npm install -g @herodevs/cli
 $ hd COMMAND
 running command...
 $ hd (--version)
-@herodevs/cli/1.3.0-beta.1 linux-x64 node-v22.14.0
+@herodevs/cli/1.5.0-beta.1 linux-x64 node-v22.14.0
 $ hd --help [COMMAND]
 USAGE
   $ hd COMMAND
@@ -30,6 +30,7 @@ USAGE
 * [`hd report purls`](#hd-report-purls)
 * [`hd scan eol`](#hd-scan-eol)
 * [`hd scan sbom`](#hd-scan-sbom)
+* [`hd update [CHANNEL]`](#hd-update-channel)
 
 ## `hd help [COMMAND]`
 
@@ -80,7 +81,7 @@ EXAMPLES
   $ hd report committers --csv
 ```
 
-_See code: [src/commands/report/committers.ts](https://github.com/herodevs/cli/blob/v1.3.0-beta.1/src/commands/report/committers.ts)_
+_See code: [src/commands/report/committers.ts](https://github.com/herodevs/cli/blob/v1.5.0-beta.1/src/commands/report/committers.ts)_
 
 ## `hd report purls`
 
@@ -114,7 +115,7 @@ EXAMPLES
   $ hd report purls --save --csv
 ```
 
-_See code: [src/commands/report/purls.ts](https://github.com/herodevs/cli/blob/v1.3.0-beta.1/src/commands/report/purls.ts)_
+_See code: [src/commands/report/purls.ts](https://github.com/herodevs/cli/blob/v1.5.0-beta.1/src/commands/report/purls.ts)_
 
 ## `hd scan eol`
 
@@ -122,15 +123,15 @@ Scan a given sbom for EOL data
 
 ```
 USAGE
-  $ hd scan eol [--json] [-f <value>] [-p <value>] [-d <value>] [-s] [-a] [-c]
+  $ hd scan eol [--json] [-f <value>] [-p <value>] [-d <value>] [-s] [-a] [-t]
 
 FLAGS
-  -a, --all                 Show all components (default is EOL and LTS only)
-  -c, --getCustomerSupport  Get Never-Ending Support for End-of-Life components
-  -d, --dir=<value>         The directory to scan in order to create a cyclonedx sbom
-  -f, --file=<value>        The file path of an existing cyclonedx sbom to scan for EOL
-  -p, --purls=<value>       The file path of a list of purls to scan for EOL
-  -s, --save                Save the generated SBOM as nes.sbom.json in the scanned directory
+  -a, --all            Show all components (default is EOL and SUPPORTED only)
+  -d, --dir=<value>    The directory to scan in order to create a cyclonedx sbom
+  -f, --file=<value>   The file path of an existing cyclonedx sbom to scan for EOL
+  -p, --purls=<value>  The file path of a list of purls to scan for EOL
+  -s, --save           Save the generated SBOM as nes.sbom.json in the scanned directory
+  -t, --table          Display the results in a table
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -148,7 +149,7 @@ EXAMPLES
   $ hd scan eol -a --dir=./my-project
 ```
 
-_See code: [src/commands/scan/eol.ts](https://github.com/herodevs/cli/blob/v1.3.0-beta.1/src/commands/scan/eol.ts)_
+_See code: [src/commands/scan/eol.ts](https://github.com/herodevs/cli/blob/v1.5.0-beta.1/src/commands/scan/eol.ts)_
 
 ## `hd scan sbom`
 
@@ -176,5 +177,43 @@ EXAMPLES
   $ hd scan sbom --file=path/to/sbom.json
 ```
 
-_See code: [src/commands/scan/sbom.ts](https://github.com/herodevs/cli/blob/v1.3.0-beta.1/src/commands/scan/sbom.ts)_
+_See code: [src/commands/scan/sbom.ts](https://github.com/herodevs/cli/blob/v1.5.0-beta.1/src/commands/scan/sbom.ts)_
+
+## `hd update [CHANNEL]`
+
+update the hd CLI
+
+```
+USAGE
+  $ hd update [CHANNEL] [--force |  | [-a | -v <value> | -i]] [-b ]
+
+FLAGS
+  -a, --available        See available versions.
+  -b, --verbose          Show more details about the available versions.
+  -i, --interactive      Interactively select version to install. This is ignored if a channel is provided.
+  -v, --version=<value>  Install a specific version.
+      --force            Force a re-download of the requested version.
+
+DESCRIPTION
+  update the hd CLI
+
+EXAMPLES
+  Update to the stable channel:
+
+    $ hd update stable
+
+  Update to a specific version:
+
+    $ hd update --version 1.0.0
+
+  Interactively select version:
+
+    $ hd update --interactive
+
+  See available versions:
+
+    $ hd update --available
+```
+
+_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.6.37/src/commands/update.ts)_
 <!-- commandsstop -->

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

@@ -1,6 +1,6 @@
 import type * as apollo from '@apollo/client/core/index.js';
 import type { InsightsEolScanInput, InsightsEolScanResult } from '../../api/types/nes.types.ts';
-import type { ProcessBatchOptions, ScanInputOptions, ScanResult } from '../types/hd-cli.types.ts';
+import { type ProcessBatchOptions, type ScanInputOptions, type ScanResult } from '../types/hd-cli.types.ts';
 export interface NesClient {
     scan: {
         purls: (purls: string[], options: ScanInputOptions) => Promise<InsightsEolScanResult>;
@@ -15,7 +15,7 @@ export declare class NesApolloClient implements NesClient {
     mutate<T, V extends Record<string, unknown>>(mutation: apollo.DocumentNode, variables?: V): Promise<apollo.FetchResult<T>>;
     query<T, V extends Record<string, unknown> | undefined>(query: apollo.DocumentNode, variables?: V): Promise<apollo.ApolloQueryResult<T>>;
 }
-export declare const batchSubmitPurls: (purls: string[], options: ScanInputOptions, batchSize: number) => Promise<ScanResult>;
+export declare const batchSubmitPurls: (purls: string[], options?: ScanInputOptions, batchSize?: number) => Promise<ScanResult>;
 export declare const createBatches: (items: string[], batchSize: number) => string[][];
 export declare const processBatch: ({ batch, index, totalPages, scanOptions, previousScanId, }: ProcessBatchOptions) => Promise<InsightsEolScanResult>;
 export declare const processBatches: (batches: string[][], scanOptions: ScanInputOptions) => Promise<InsightsEolScanResult[]>;

package/dist/api/nes/nes.client.js

@@ -1,6 +1,7 @@
 import { ApolloClient } from "../../api/client.js";
 import { debugLogger } from "../../service/log.svc.js";
 import { SbomScanner, buildScanResult } from "../../service/nes/nes.svc.js";
+import { DEFAULT_SCAN_BATCH_SIZE, DEFAULT_SCAN_INPUT_OPTIONS, } from "../types/hd-cli.types.js";
 export class NesApolloClient {
     scan = {
         purls: SbomScanner(this),
@@ -27,7 +28,7 @@ function submitScan(purls, options) {
     const client = new NesApolloClient(url);
     return client.scan.purls(purls, options);
 }
-export const batchSubmitPurls = async (purls, options, batchSize) => {
+export const batchSubmitPurls = async (purls, options = DEFAULT_SCAN_INPUT_OPTIONS, batchSize = DEFAULT_SCAN_BATCH_SIZE) => {
     try {
         const batches = createBatches(purls, batchSize);
         debugLogger('Processing %d batches', batches.length);
@@ -61,6 +62,7 @@ export const processBatch = async ({ batch, index, totalPages, scanOptions, prev
         throw new Error('Total pages exceeded');
     }
     debugLogger('Processing batch %d of %d', page, totalPages);
+    debugLogger('ScanID: %s', previousScanId);
     const result = await submitScan(batch, {
         ...scanOptions,
         page,

package/dist/api/queries/nes/sbom.js

@@ -2,9 +2,9 @@ import { gql } from '@apollo/client/core/core.cjs';
 export const M_SCAN = {
     gql: gql `
     mutation EolScan($input: InsightsEolScanInput!) {
-        insights {
-          scan {
-            eol(input: $input) {
+      insights {
+        scan {
+          eol(input: $input) {
             components {
               purl
               info {
@@ -13,8 +13,10 @@ export const M_SCAN = {
                 eolAt
                 daysEol
                 status
+                # TODO: uncomment vulnCount once backend changes are deployed 
+                # vulnCount
               }
-            } 
+            }
             diagnostics
             message
             scanId

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

@@ -36,6 +36,7 @@ export interface InsightsEolScanComponentInfo {
     eolAt: Date | null;
     status: ComponentStatus;
     daysEol: number | null;
+    vulnCount: number | null;
 }
 export interface InsightsEolScanComponent {
     info: InsightsEolScanComponentInfo;
@@ -49,4 +50,4 @@ export interface ScanWarning {
     diagnostics?: Record<string, unknown>;
 }
 export type ComponentStatus = (typeof VALID_STATUSES)[number];
-export declare const VALID_STATUSES: readonly ["UNKNOWN", "OK", "EOL", "LTS"];
+export declare const VALID_STATUSES: readonly ["UNKNOWN", "OK", "EOL", "SUPPORTED"];

package/dist/api/types/nes.types.js

@@ -1 +1 @@
-export const VALID_STATUSES = ['UNKNOWN', 'OK', 'EOL', 'LTS'];
+export const VALID_STATUSES = ['UNKNOWN', 'OK', 'EOL', 'SUPPORTED'];

package/dist/commands/scan/eol.d.ts

@@ -10,7 +10,7 @@ export default class ScanEol extends Command {
         dir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         save: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        getCustomerSupport: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        table: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<{
         components: InsightsEolScanComponent[];
@@ -21,6 +21,8 @@ export default class ScanEol extends Command {
     private getFilteredComponents;
     private saveReport;
     private displayResults;
+    private displayResultsInTable;
+    private displayTable;
     private displayNoComponentsMessage;
     private logLine;
     private displayStatusSection;

package/dist/commands/scan/eol.js

@@ -2,12 +2,10 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { Command, Flags, ux } from '@oclif/core';
 import { batchSubmitPurls } from "../../api/nes/nes.client.js";
-import { DEFAULT_SCAN_BATCH_SIZE, DEFAULT_SCAN_INPUT_OPTIONS } from '../../api/types/hd-cli.types.js';
 import { getErrorMessage, isErrnoException } from "../../service/error.svc.js";
-import { extractPurls } from "../../service/purls.svc.js";
-import { parsePurlsFile } from "../../service/purls.svc.js";
-import { createStatusDisplay } from "../../ui/eol.ui.js";
-import { INDICATORS, STATUS_COLORS } from "../../ui/shared.us.js";
+import { extractPurls, parsePurlsFile } from "../../service/purls.svc.js";
+import { createStatusDisplay, createTableForStatus, groupComponentsByStatus } from "../../ui/eol.ui.js";
+import { INDICATORS, STATUS_COLORS } from "../../ui/shared.ui.js";
 import ScanSbom from "./sbom.js";
 export default class ScanEol extends Command {
     static description = 'Scan a given sbom for EOL data';
@@ -38,46 +36,44 @@ export default class ScanEol extends Command {
         }),
         all: Flags.boolean({
             char: 'a',
-            description: 'Show all components (default is EOL and LTS only)',
+            description: 'Show all components (default is EOL and SUPPORTED only)',
             default: false,
         }),
-        getCustomerSupport: Flags.boolean({
-            char: 'c',
-            description: 'Get Never-Ending Support for End-of-Life components',
+        table: Flags.boolean({
+            char: 't',
+            description: 'Display the results in a table',
             default: false,
         }),
     };
     async run() {
         const { flags } = await this.parse(ScanEol);
-        if (flags.getCustomerSupport) {
-            this.log(ux.colorize('yellow', 'Never-Ending Support is on the way. Please stay tuned for this feature.'));
-        }
         const scan = await this.getScan(flags, this.config);
         ux.action.stop('\nScan completed');
-        const filteredComponents = this.getFilteredComponents(scan, flags.all);
+        const components = this.getFilteredComponents(scan, flags.all);
         if (flags.save) {
-            await this.saveReport(filteredComponents);
+            await this.saveReport(components);
         }
-        if (this.jsonEnabled()) {
-            return { components: filteredComponents };
+        if (!this.jsonEnabled()) {
+            if (flags.table) {
+                this.log(`${scan.components.size} components scanned`);
+                this.displayResultsInTable(scan, flags.all);
+            }
+            else {
+                this.displayResults(scan, flags.all);
+            }
         }
-        await this.displayResults(scan, flags.all);
-        return { components: filteredComponents };
+        return { components };
     }
     async getScan(flags, config) {
         if (flags.purls) {
             ux.action.start(`Scanning purls from ${flags.purls}`);
             const purls = this.getPurlsFromFile(flags.purls);
-            return batchSubmitPurls(purls, DEFAULT_SCAN_INPUT_OPTIONS, DEFAULT_SCAN_BATCH_SIZE);
+            return batchSubmitPurls(purls);
         }
         const sbom = await ScanSbom.loadSbom(flags, config);
-        const scan = this.scanSbom(sbom, flags);
-        return scan;
+        return this.scanSbom(sbom);
     }
     getPurlsFromFile(filePath) {
-        if (typeof filePath !== 'string') {
-            this.error(`Failed to parse file path: ${filePath}`);
-        }
         try {
             const purlsFileString = fs.readFileSync(filePath, 'utf8');
             return parsePurlsFile(purlsFileString);
@@ -86,7 +82,7 @@ export default class ScanEol extends Command {
             this.error(`Failed to read purls file. ${getErrorMessage(error)}`);
         }
     }
-    async scanSbom(sbom, flags) {
+    async scanSbom(sbom) {
         let scan;
         let purls;
         try {
@@ -96,7 +92,7 @@ export default class ScanEol extends Command {
             this.error(`Failed to extract purls from sbom. ${getErrorMessage(error)}`);
         }
         try {
-            scan = await batchSubmitPurls(purls, DEFAULT_SCAN_INPUT_OPTIONS, DEFAULT_SCAN_BATCH_SIZE);
+            scan = await batchSubmitPurls(purls);
         }
         catch (error) {
             this.error(`Failed to submit scan to NES from sbom. ${getErrorMessage(error)}`);
@@ -107,52 +103,67 @@ export default class ScanEol extends Command {
         return scan;
     }
     getFilteredComponents(scan, all) {
-        return Array.from(scan.components.entries())
-            .filter(([_, component]) => all || ['EOL', 'LTS'].includes(component.info.status))
-            .map(([_, component]) => component);
+        return Array.from(scan.components.values()).filter((component) => all || ['EOL', 'SUPPORTED'].includes(component.info.status));
     }
     async saveReport(components) {
+        const { flags } = await this.parse(ScanEol);
+        const reportPath = path.join(flags.dir || process.cwd(), 'nes.eol.json');
         try {
-            const { flags } = await this.parse(ScanEol);
-            const reportPath = path.join(flags.dir || process.cwd(), 'nes.eol.json');
             fs.writeFileSync(reportPath, JSON.stringify({ components }, null, 2));
             this.log('Report saved to nes.eol.json');
         }
         catch (error) {
-            if (isErrnoException(error)) {
-                switch (error.code) {
-                    case 'EACCES':
-                        this.error('Permission denied. Unable to save report to nes.eol.json');
-                        break;
-                    case 'ENOSPC':
-                        this.error('No space left on device. Unable to save report to nes.eol.json');
-                        break;
-                    default:
-                        this.error(`Failed to save report: ${getErrorMessage(error)}`);
-                }
-            }
-            else {
+            if (!isErrnoException(error)) {
                 this.error(`Failed to save report: ${getErrorMessage(error)}`);
             }
+            switch (error.code) {
+                case 'EACCES':
+                    this.error('Permission denied. Unable to save report to nes.eol.json');
+                    break;
+                case 'ENOSPC':
+                    this.error('No space left on device. Unable to save report to nes.eol.json');
+                    break;
+                default:
+                    this.error(`Failed to save report: ${getErrorMessage(error)}`);
+            }
         }
     }
-    async displayResults(scan, all) {
-        const { UNKNOWN, OK, LTS, EOL } = createStatusDisplay(scan.components, all);
-        if (!UNKNOWN.length && !OK.length && !LTS.length && !EOL.length) {
+    displayResults(scan, all) {
+        const { UNKNOWN, OK, SUPPORTED, EOL } = createStatusDisplay(scan.components, all);
+        if (!UNKNOWN.length && !OK.length && !SUPPORTED.length && !EOL.length) {
             this.displayNoComponentsMessage(all);
             return;
         }
         this.log(ux.colorize('bold', 'Here are the results of the scan:'));
         this.logLine();
         // Display sections in order of increasing severity
-        for (const components of [UNKNOWN, OK, LTS, EOL]) {
+        for (const components of [UNKNOWN, OK, SUPPORTED, EOL]) {
             this.displayStatusSection(components);
         }
         this.logLegend();
     }
+    displayResultsInTable(scan, all) {
+        const grouped = groupComponentsByStatus(scan.components);
+        const statuses = ['SUPPORTED', 'EOL'];
+        if (all) {
+            statuses.unshift('UNKNOWN', 'OK');
+        }
+        for (const status of statuses) {
+            const components = grouped[status];
+            if (components.length > 0) {
+                const table = createTableForStatus(grouped, status);
+                this.displayTable(table, components.length, status);
+            }
+        }
+        this.logLegend();
+    }
+    displayTable(table, count, status) {
+        this.log(ux.colorize(STATUS_COLORS[status], `${INDICATORS[status]} ${count} ${status} Component(s):`));
+        this.log(ux.colorize(STATUS_COLORS[status], table));
+    }
     displayNoComponentsMessage(all) {
         if (!all) {
-            this.log(ux.colorize('yellow', 'No End-of-Life or Long Term Support components found in scan.'));
+            this.log(ux.colorize('yellow', 'No End-of-Life or Supported components found in scan.'));
             this.log(ux.colorize('yellow', 'Use --all flag to view all components.'));
         }
         else {
@@ -169,9 +180,9 @@ export default class ScanEol extends Command {
         }
     }
     logLegend() {
-        this.log(ux.colorize(`${STATUS_COLORS.UNKNOWN}`, `${INDICATORS.UNKNOWN} = No Known Issues`));
-        this.log(ux.colorize(`${STATUS_COLORS.OK}`, `${INDICATORS.OK} = OK`));
-        this.log(ux.colorize(`${STATUS_COLORS.LTS}`, `${INDICATORS.LTS}= Long Term Support (LTS)`));
-        this.log(ux.colorize(`${STATUS_COLORS.EOL}`, `${INDICATORS.EOL} = End of Life (EOL)`));
+        this.log(ux.colorize(STATUS_COLORS.UNKNOWN, `${INDICATORS.UNKNOWN} = No Known Issues`));
+        this.log(ux.colorize(STATUS_COLORS.OK, `${INDICATORS.OK} = OK`));
+        this.log(ux.colorize(STATUS_COLORS.SUPPORTED, `${INDICATORS.SUPPORTED}= Supported: End-of-Life (EOL) is scheduled`));
+        this.log(ux.colorize(STATUS_COLORS.EOL, `${INDICATORS.EOL} = End of Life (EOL)`));
     }
 }

package/dist/hooks/npm-update-notifier.d.ts

@@ -0,0 +1,8 @@
+import type { Hook } from '@oclif/core';
+import { type UpdateInfo } from 'update-notifier';
+declare const updateNotifierHook: Hook.Init;
+export default updateNotifierHook;
+export declare function handleUpdate(update: UpdateInfo, currentVersion: string): {
+    message: string;
+    defer: boolean;
+};

package/dist/hooks/npm-update-notifier.js

@@ -0,0 +1,39 @@
+import updateNotifier, {} from 'update-notifier';
+import pkg from '../../package.json' with { type: 'json' };
+const updateNotifierHook = async (options) => {
+    const notifier = updateNotifier({
+        pkg,
+        updateCheckInterval: 1000 * 60 * 60 * 24, // Check once per day
+    });
+    if (notifier.update) {
+        const notification = handleUpdate(notifier.update, pkg.version);
+        if (notification) {
+            notifier.notify(notification);
+        }
+    }
+};
+export default updateNotifierHook;
+export function handleUpdate(update, currentVersion) {
+    const isPreV1 = currentVersion.startsWith('0.');
+    const isBeta = currentVersion.includes('-beta') || update.latest.includes('-beta');
+    const isAlpha = currentVersion.includes('-alpha') || update.latest.includes('-alpha');
+    const isNext = currentVersion.includes('-next') || update.latest.includes('-next');
+    let message = `Update available! v${currentVersion} → v${update.latest}`;
+    /**
+     * Show breaking changes warning for:
+     * - v0.x.x versions (all updates can contain breaking changes per SemVer spec[1][2])
+     * - Prerelease versions (beta/alpha/next)
+     * - Major version updates
+     *
+     * [1]https://semver.org/#spec-item-4
+     * [2]https://antfu.me/posts/epoch-semver#leading-zero-major-versioning
+     */
+    if (isPreV1 || isBeta || isAlpha || isNext || update.type === 'major') {
+        message += '\nThis update may contain breaking changes.';
+    }
+    // For all other updates (minor, patch), they should be non-breaking
+    return {
+        message,
+        defer: false,
+    };
+}

package/dist/service/nes/nes.svc.js

@@ -3,6 +3,12 @@ import { debugLogger } from "../log.svc.js";
 export const buildScanResult = (scan) => {
     const components = new Map();
     for (const c of scan.components) {
+        const { status } = c.info;
+        // TODO: remove this once backend changes are deployed
+        // @ts-expect-error
+        if (status === 'LTS') {
+            c.info.status = 'SUPPORTED';
+        }
         components.set(c.purl, c);
     }
     return {

package/dist/ui/eol.ui.d.ts

@@ -1,5 +1,15 @@
 import type { ScanResultComponentsMap } from '../api/types/hd-cli.types.ts';
-import type { ComponentStatus } from '../api/types/nes.types.ts';
-export declare function truncatePurl(purl: string): string;
+import type { ComponentStatus, InsightsEolScanComponent } from '../api/types/nes.types.ts';
+export declare function truncateString(purl: string, maxLength: number): string;
 export declare function colorizeStatus(status: ComponentStatus): string;
 export declare function createStatusDisplay(components: ScanResultComponentsMap, all: boolean): Record<ComponentStatus, string[]>;
+export declare function createTableForStatus(grouped: Record<ComponentStatus, InsightsEolScanComponent[]>, status: ComponentStatus): string;
+export declare function convertComponentToTableRow(component: InsightsEolScanComponent): {
+    name: string;
+    version: string;
+    eol: string;
+    daysEol: number | null;
+    type: string;
+    vulnCount: number | null;
+};
+export declare function groupComponentsByStatus(components: ScanResultComponentsMap): Record<ComponentStatus, InsightsEolScanComponent[]>;

package/dist/ui/eol.ui.js

@@ -1,36 +1,41 @@
 import { ux } from '@oclif/core';
+import { makeTable } from '@oclif/table';
+import { PackageURL } from 'packageurl-js';
 import { parseMomentToSimpleDate } from "./date.ui.js";
-import { INDICATORS, STATUS_COLORS } from "./shared.us.js";
-export function truncatePurl(purl) {
-    return purl.length > 60 ? `${purl.slice(0, 57)}...` : purl;
+import { INDICATORS, MAX_PURL_LENGTH, MAX_TABLE_COLUMN_WIDTH, STATUS_COLORS } from "./shared.ui.js";
+export function truncateString(purl, maxLength) {
+    const ellipses = '...';
+    return purl.length > maxLength ? `${purl.slice(0, maxLength - ellipses.length)}${ellipses}` : purl;
 }
 export function colorizeStatus(status) {
     return ux.colorize(STATUS_COLORS[status], status);
 }
 function formatSimpleComponent(purl, status) {
     const color = STATUS_COLORS[status];
-    return `  ${INDICATORS[status]} ${ux.colorize(color, truncatePurl(purl))}`;
+    return `  ${INDICATORS[status]} ${ux.colorize(color, truncateString(purl, MAX_PURL_LENGTH))}`;
 }
 function getDaysEolString(daysEol) {
-    // UNKNOWN || OK
     if (daysEol === null) {
         return '';
     }
-    // LTS
     if (daysEol < 0) {
         return `${Math.abs(daysEol)} days from now`;
     }
-    // EOL
     if (daysEol === 0) {
         return 'today';
     }
     return `${daysEol} days ago`;
 }
-function formatDetailedComponent(purl, eolAt, daysEol, status) {
+function formatDetailedComponent(purl, info) {
+    const { status, eolAt, daysEol, vulnCount } = info;
     const simpleComponent = formatSimpleComponent(purl, status);
     const eolAtString = parseMomentToSimpleDate(eolAt);
     const daysEolString = getDaysEolString(daysEol);
-    const output = [`${simpleComponent}`, `    ⮑  EOL Date: ${eolAtString} (${daysEolString})`]
+    const output = [
+        `${simpleComponent}`,
+        `    ⮑  EOL Date: ${eolAtString} (${daysEolString})`,
+        `    ⮑  # of Vulns: ${vulnCount ?? ''}`,
+    ]
         .filter(Boolean)
         .join('\n');
     return output;
@@ -39,20 +44,58 @@ export function createStatusDisplay(components, all) {
     const statusOutput = {
         UNKNOWN: [],
         OK: [],
-        LTS: [],
+        SUPPORTED: [],
         EOL: [],
     };
     // Single loop to separate and format components
     for (const [purl, component] of components.entries()) {
-        const { status, eolAt, daysEol } = component.info;
+        const { status } = component.info;
         if (all) {
             if (status === 'UNKNOWN' || status === 'OK') {
                 statusOutput[status].push(formatSimpleComponent(purl, status));
             }
         }
-        if (status === 'LTS' || status === 'EOL') {
-            statusOutput[status].push(formatDetailedComponent(purl, eolAt, daysEol, status));
+        if (status === 'SUPPORTED' || status === 'EOL') {
+            statusOutput[status].push(formatDetailedComponent(purl, component.info));
         }
     }
     return statusOutput;
 }
+export function createTableForStatus(grouped, status) {
+    const data = grouped[status].map((component) => convertComponentToTableRow(component));
+    return makeTable({
+        data,
+        columns: [
+            { key: 'name', name: 'NAME', width: MAX_TABLE_COLUMN_WIDTH },
+            { key: 'version', name: 'VERSION', width: 10 },
+            { key: 'eol', name: 'EOL', width: 12 },
+            { key: 'daysEol', name: 'DAYS EOL', width: 10 },
+            { key: 'type', name: 'TYPE', width: 12 },
+            { key: 'vulnCount', name: '# OF VULNS', width: 12 },
+        ],
+    });
+}
+export function convertComponentToTableRow(component) {
+    const purlParts = PackageURL.fromString(component.purl);
+    const { eolAt, daysEol, vulnCount } = component.info;
+    return {
+        name: purlParts.name,
+        version: purlParts.version ?? '',
+        eol: parseMomentToSimpleDate(eolAt),
+        daysEol: daysEol,
+        type: purlParts.type,
+        vulnCount: vulnCount,
+    };
+}
+export function groupComponentsByStatus(components) {
+    const grouped = {
+        UNKNOWN: [],
+        OK: [],
+        SUPPORTED: [],
+        EOL: [],
+    };
+    for (const component of components.values()) {
+        grouped[component.info.status].push(component);
+    }
+    return grouped;
+}

package/dist/ui/{shared.us.d.ts → shared.ui.d.ts}

@@ -1,3 +1,5 @@
 import type { ComponentStatus } from '../api/types/nes.types.ts';
 export declare const STATUS_COLORS: Record<ComponentStatus, string>;
 export declare const INDICATORS: Record<ComponentStatus, string>;
+export declare const MAX_PURL_LENGTH = 60;
+export declare const MAX_TABLE_COLUMN_WIDTH = 30;

package/dist/ui/{shared.us.js → shared.ui.js}

@@ -3,11 +3,13 @@ export const STATUS_COLORS = {
     EOL: 'red',
     UNKNOWN: 'default',
     OK: 'green',
-    LTS: 'yellow',
+    SUPPORTED: 'yellow',
 };
 export const INDICATORS = {
     EOL: ux.colorize(STATUS_COLORS.EOL, '✗'),
     UNKNOWN: ux.colorize(STATUS_COLORS.UNKNOWN, '•'),
     OK: ux.colorize(STATUS_COLORS.OK, '✔'),
-    LTS: ux.colorize(STATUS_COLORS.LTS, '⚡'),
+    SUPPORTED: ux.colorize(STATUS_COLORS.SUPPORTED, '⚡'),
 };
+export const MAX_PURL_LENGTH = 60;
+export const MAX_TABLE_COLUMN_WIDTH = 30;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herodevs/cli",
-  "version": "1.3.0-beta.1",
+  "version": "1.5.0-beta.1",
   "author": "HeroDevs, Inc",
   "bin": {
     "hd": "./bin/run.js"
@@ -37,11 +37,15 @@
     "herodevs cli"
   ],
   "dependencies": {
-    "@apollo/client": "^3.13.1",
-    "@cyclonedx/cdxgen": "^11.2.3",
+    "@apollo/client": "^3.13.7",
+    "@cyclonedx/cdxgen": "^11.2.4",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
-    "graphql": "^16.8.1"
+    "@oclif/plugin-update": "^4",
+    "@oclif/table": "^0.4.7",
+    "graphql": "^16.8.1",
+    "packageurl-js": "^2.0.1",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.8.3",
@@ -49,13 +53,14 @@
     "@types/inquirer": "^9.0.7",
     "@types/node": "^22",
     "@types/sinon": "^17.0.4",
+    "@types/update-notifier": "^6.0.8",
     "globstar": "^1.0.0",
     "oclif": "^4",
-    "shx": "^0.3.3",
-    "sinon": "^19.0.2",
+    "shx": "^0.4.0",
+    "sinon": "^20.0.0",
     "ts-node": "^10",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.0"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -73,12 +78,27 @@
     "commands": "./dist/commands",
     "plugins": [
       "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-plugins",
+      "@oclif/plugin-update"
     ],
     "hooks": {
+      "init": "./dist/hooks/npm-update-notifier",
       "prerun": "./dist/hooks/prerun.js"
     },
-    "topicSeparator": " "
+    "topicSeparator": " ",
+    "macos": {
+      "identifier": "com.herodevs.cli"
+    },
+    "win": {
+      "icon": "assets/icon.ico"
+    },
+    "update": {
+      "s3": {
+        "bucket": "end-of-life-dataset-cli-releases",
+        "host": "https://end-of-life-dataset-cli-releases.s3.amazonaws.com",
+        "acl": "bucket-owner-full-control"
+      }
+    }
   },
   "types": "dist/index.d.ts"
 }