@artemiskit/cli 0.1.7 → 0.1.8

package/dist/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,SAAS,IAAI,OAAO,CAmBnC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,SAAS,IAAI,OAAO,CAuCnC"}

package/dist/src/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoLpC,wBAAgB,WAAW,IAAI,OAAO,CAkFrC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyNpC,wBAAgB,WAAW,IAAI,OAAO,CAqFrC"}

package/dist/src/utils/update-checker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Non-blocking update checker for ArtemisKit CLI
+ */
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+}
+/**
+ * Check for updates (non-blocking)
+ * Returns update info or null if check fails
+ */
+export declare function checkForUpdate(): Promise<UpdateInfo | null>;
+/**
+ * Get the current CLI version
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * Format version display string
+ */
+export declare function formatVersionDisplay(version: string): string;
+/**
+ * Format update available message
+ */
+export declare function formatUpdateMessage(current: string, latest: string): string;
+/**
+ * Non-blocking update check that prints message if update available
+ * Use this to fire-and-forget an update check
+ */
+export declare function checkForUpdateAndNotify(): void;
+//# sourceMappingURL=update-checker.d.ts.map

package/dist/src/utils/update-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-checker.d.ts","sourceRoot":"","sources":["../../../src/utils/update-checker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAgDD;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAW9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artemiskit/cli",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Command-line interface for ArtemisKit LLM evaluation toolkit",
   "type": "module",
   "license": "Apache-2.0",
@@ -45,11 +45,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@artemiskit/adapter-openai": "0.1.5",
-    "@artemiskit/adapter-vercel-ai": "0.1.5",
-    "@artemiskit/core": "0.1.5",
-    "@artemiskit/redteam": "0.1.5",
-    "@artemiskit/reports": "0.1.5",
+    "@artemiskit/adapter-openai": "0.1.6",
+    "@artemiskit/adapter-vercel-ai": "0.1.6",
+    "@artemiskit/core": "0.1.6",
+    "@artemiskit/redteam": "0.1.6",
+    "@artemiskit/reports": "0.1.6",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.3",
     "commander": "^12.0.0",

package/src/cli.ts

@@ -11,6 +11,7 @@ import { redteamCommand } from './commands/redteam';
 import { reportCommand } from './commands/report';
 import { runCommand } from './commands/run';
 import { stressCommand } from './commands/stress';
+import { checkForUpdate, formatUpdateMessage, formatVersionDisplay } from './utils/update-checker';
 
 export function createCLI(): Command {
   const program = new Command();
@@ -20,7 +21,27 @@ export function createCLI(): Command {
     .description(
       'ArtemisKit - Open-source Agent Reliability Toolkit - Test, validate, audit and evaluate LLMs and LLM-driven agents'
     )
-    .version(version);
+    .version(version, '-v, --version', 'Output the current version')
+    .option('-V, --version-check', 'Output version and check for updates')
+    .action(async () => {
+      // Handle root command with --version-check flag
+      const opts = program.opts();
+      if (opts.versionCheck) {
+        console.log(formatVersionDisplay(version));
+        console.log('\nChecking for updates...');
+        const updateInfo = await checkForUpdate();
+        if (updateInfo?.updateAvailable) {
+          console.log(formatUpdateMessage(updateInfo.currentVersion, updateInfo.latestVersion));
+        } else if (updateInfo) {
+          console.log('You are using the latest version.');
+        } else {
+          console.log('Could not check for updates (network unavailable).');
+        }
+      } else {
+        // No subcommand provided, show help
+        program.help();
+      }
+    });
 
   program.addCommand(initCommand());
   program.addCommand(runCommand());

package/src/commands/init.ts

@@ -8,6 +8,7 @@ import { join } from 'node:path';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import { createSpinner, icons } from '../ui/index.js';
+import { checkForUpdateAndNotify, getCurrentVersion } from '../utils/update-checker.js';
 
 const DEFAULT_CONFIG = `# ArtemisKit Configuration
 project: my-project
@@ -86,18 +87,54 @@ const ENV_KEYS = [
 ];
 
 function renderWelcomeBanner(): string {
+  // Brand color for "KIT" portion: #fb923c (orange)
+  const brandColor = chalk.hex('#fb923c');
+  const version = getCurrentVersion();
+
+  // Randomly color each border character white or brand color
+  const colorBorderChar = (char: string): string => {
+    return Math.random() > 0.5 ? chalk.white(char) : brandColor(char);
+  };
+
+  const colorBorder = (str: string): string => {
+    return str.split('').map(colorBorderChar).join('');
+  };
+
+  // All lines are exactly 52 chars inside the borders for perfect alignment
+  const topBorder = `╭${'─'.repeat(52)}╮`;
+  const bottomBorder = `╰${'─'.repeat(52)}╯`;
+  const sideBorderLeft = '│';
+  const sideBorderRight = '│';
+  const emptyContent = ' '.repeat(52);
+
+  // Version line: "v0.1.7" centered in brand color
+  const versionText = `v${version}`;
+  const versionPadding = Math.floor((52 - versionText.length) / 2);
+  const versionLine =
+    ' '.repeat(versionPadding) +
+    brandColor(versionText) +
+    ' '.repeat(52 - versionPadding - versionText.length);
+
+  // Tagline centered
+  const tagline = 'Open-source testing toolkit for LLM applications';
+  const taglinePadding = Math.floor((52 - tagline.length) / 2);
+  const taglineLine =
+    ' '.repeat(taglinePadding) +
+    chalk.gray(tagline) +
+    ' '.repeat(52 - taglinePadding - tagline.length);
+
   const lines = [
     '',
-    chalk.cyan('  ╔═══════════════════════════════════════════════════════╗'),
-    chalk.cyan('  ║                                                       ║'),
-    chalk.cyan('  ║') +
-      chalk.bold.white('     🎯 Welcome to ArtemisKit                         ') +
-      chalk.cyan('║'),
-    chalk.cyan('  ║') +
-      chalk.gray('     LLM Testing & Evaluation Toolkit                 ') +
-      chalk.cyan('║'),
-    chalk.cyan('  ║                                                       ║'),
-    chalk.cyan('  ╚═══════════════════════════════════════════════════════╝'),
+    `  ${colorBorder(topBorder)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${emptyContent}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}        ${chalk.bold.white('▄▀█ █▀█ ▀█▀ █▀▀ █▀▄▀█ █ █▀ ')}${brandColor.bold('█▄▀ █ ▀█▀')}        ${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}        ${chalk.bold.white('█▀█ █▀▄  █  ██▄ █ ▀ █ █ ▄█ ')}${brandColor.bold('█ █ █  █ ')}        ${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${emptyContent}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${versionLine}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${emptyContent}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${taglineLine}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorderChar(sideBorderLeft)}${emptyContent}${colorBorderChar(sideBorderRight)}`,
+    `  ${colorBorder(bottomBorder)}`,
     '',
   ];
   return lines.join('\n');
@@ -260,6 +297,9 @@ export function initCommand(): Command {
 
         // Show success panel
         console.log(renderSuccessPanel());
+
+        // Non-blocking update check (fire and forget)
+        checkForUpdateAndNotify();
       } catch (error) {
         spinner.fail('Error');
         console.error(chalk.red(`\n${icons.failed} ${(error as Error).message}`));

package/src/utils/update-checker.ts

@@ -0,0 +1,121 @@
+/**
+ * Non-blocking update checker for ArtemisKit CLI
+ */
+
+import chalk from 'chalk';
+import { version as currentVersion } from '../../package.json';
+
+const PACKAGE_NAME = '@artemiskit/cli';
+const NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const FETCH_TIMEOUT_MS = 3000; // 3 second timeout to avoid blocking
+
+// Brand color
+const brandColor = chalk.hex('#fb923c');
+
+export interface UpdateInfo {
+  currentVersion: string;
+  latestVersion: string;
+  updateAvailable: boolean;
+}
+
+/**
+ * Fetches the latest version from npm registry with a timeout
+ */
+async function fetchLatestVersion(): Promise<string | null> {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+
+  try {
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: {
+        Accept: 'application/json',
+      },
+    });
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const data = (await response.json()) as { version?: string };
+    return data.version || null;
+  } catch {
+    // Silently fail - network issues shouldn't block CLI usage
+    return null;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+/**
+ * Compares two semver versions
+ * Returns true if latest > current
+ */
+function isNewerVersion(current: string, latest: string): boolean {
+  const currentParts = current.replace(/^v/, '').split('.').map(Number);
+  const latestParts = latest.replace(/^v/, '').split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const c = currentParts[i] || 0;
+    const l = latestParts[i] || 0;
+    if (l > c) return true;
+    if (l < c) return false;
+  }
+  return false;
+}
+
+/**
+ * Check for updates (non-blocking)
+ * Returns update info or null if check fails
+ */
+export async function checkForUpdate(): Promise<UpdateInfo | null> {
+  const latestVersion = await fetchLatestVersion();
+
+  if (!latestVersion) {
+    return null;
+  }
+
+  return {
+    currentVersion,
+    latestVersion,
+    updateAvailable: isNewerVersion(currentVersion, latestVersion),
+  };
+}
+
+/**
+ * Get the current CLI version
+ */
+export function getCurrentVersion(): string {
+  return currentVersion;
+}
+
+/**
+ * Format version display string
+ */
+export function formatVersionDisplay(version: string): string {
+  return `${chalk.bold('ArtemisKit CLI')} ${brandColor(`v${version}`)}`;
+}
+
+/**
+ * Format update available message
+ */
+export function formatUpdateMessage(current: string, latest: string): string {
+  return `\n${chalk.yellow('╭─────────────────────────────────────────────────────╮')}\n${chalk.yellow('│')}${chalk.yellow('  Update available! ')}${chalk.gray(`${current}`)}${chalk.yellow(' → ')}${brandColor.bold(`${latest}`)}${' '.repeat(24 - current.length - latest.length)}${chalk.yellow('│')}\n${chalk.yellow('│')}${chalk.white('  Run ')}${chalk.cyan('npm install -g @artemiskit/cli')}${chalk.white(' to update  ')}${chalk.yellow('│')}\n${chalk.yellow('╰─────────────────────────────────────────────────────╯')}`;
+}
+
+/**
+ * Non-blocking update check that prints message if update available
+ * Use this to fire-and-forget an update check
+ */
+export function checkForUpdateAndNotify(): void {
+  // Fire and forget - don't await
+  checkForUpdate()
+    .then((info) => {
+      if (info?.updateAvailable) {
+        console.log(formatUpdateMessage(info.currentVersion, info.latestVersion));
+      }
+    })
+    .catch(() => {
+      // Silently ignore errors
+    });
+}