@artemiskit/cli 0.1.6 → 0.1.8

package/src/commands/init.ts

@@ -3,11 +3,12 @@
  */
 
 import { existsSync } from 'node:fs';
-import { mkdir, readFile, writeFile, appendFile } from 'node:fs/promises';
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
 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');
@@ -180,7 +217,7 @@ async function appendEnvKeys(cwd: string): Promise<{ added: string[]; skipped: s
     // Add newline before our content if file exists and doesn't end with newline
     const prefix =
       existingContent && !existingContent.endsWith('\n') ? '\n\n' : existingContent ? '\n' : '';
-    await appendFile(envPath, prefix + linesToAdd.join('\n') + '\n');
+    await appendFile(envPath, `${prefix + linesToAdd.join('\n')}\n`);
   }
 
   return { added, skipped };
@@ -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/commands/redteam.ts

@@ -35,13 +35,13 @@ import { nanoid } from 'nanoid';
 import { loadConfig } from '../config/loader.js';
 import {
   createSpinner,
-  renderRedteamSummaryPanel,
+  getProviderErrorContext,
+  icons,
+  isTTY,
   renderError,
   renderInfoBox,
   renderProgressBar,
-  getProviderErrorContext,
-  isTTY,
-  icons,
+  renderRedteamSummaryPanel,
 } from '../ui/index.js';
 import {
   buildAdapterConfig,
@@ -213,7 +213,7 @@ export function redteamCommand(): Command {
 
               // Clear progress line
               if (isTTY) {
-                process.stdout.write('\r' + ' '.repeat(60) + '\r');
+                process.stdout.write(`\r${' '.repeat(60)}\r`);
               }
 
               // Display status with appropriate icon
@@ -267,7 +267,7 @@ export function redteamCommand(): Command {
 
               // Clear progress line
               if (isTTY) {
-                process.stdout.write('\r' + ' '.repeat(60) + '\r');
+                process.stdout.write(`\r${' '.repeat(60)}\r`);
               }
 
               // Apply redaction to prompt even for errors/blocked

package/src/commands/report.ts

@@ -13,7 +13,7 @@ import {
 } from '@artemiskit/reports';
 import { Command } from 'commander';
 import { loadConfig } from '../config/loader.js';
-import { createSpinner, renderError, renderInfoBox, icons } from '../ui/index.js';
+import { createSpinner, icons, renderError, renderInfoBox } from '../ui/index.js';
 import { createStorage } from '../utils/storage.js';
 
 interface ReportOptions {
@@ -96,7 +96,7 @@ export function reportCommand(): Command {
           const htmlPath = join(outputDir, `${runId}.html`);
           await writeFile(htmlPath, html);
           generatedFiles.push(htmlPath);
-          spinner.succeed(`Generated HTML report`);
+          spinner.succeed('Generated HTML report');
         }
 
         if (format === 'json' || format === 'both') {
@@ -105,7 +105,7 @@ export function reportCommand(): Command {
           const jsonPath = join(outputDir, `${runId}.json`);
           await writeFile(jsonPath, json);
           generatedFiles.push(jsonPath);
-          spinner.succeed(`Generated JSON report`);
+          spinner.succeed('Generated JSON report');
         }
 
         // Show success panel

package/src/commands/run.ts

@@ -13,14 +13,14 @@ import { Command } from 'commander';
 import { loadConfig } from '../config/loader.js';
 import {
   createSpinner,
+  formatDuration,
+  getProviderErrorContext,
   icons,
+  isTTY,
+  padText,
   renderError,
   renderProgressBar,
   renderSummaryPanel,
-  getProviderErrorContext,
-  formatDuration,
-  padText,
-  isTTY,
 } from '../ui/index.js';
 import {
   buildAdapterConfig,

package/src/commands/stress.ts

@@ -21,14 +21,14 @@ import { Command } from 'commander';
 import { nanoid } from 'nanoid';
 import { loadConfig } from '../config/loader.js';
 import {
+  colors,
   createSpinner,
-  renderStressSummaryPanel,
+  getProviderErrorContext,
+  isTTY,
   renderError,
   renderInfoBox,
   renderProgressBar,
-  getProviderErrorContext,
-  isTTY,
-  colors,
+  renderStressSummaryPanel,
 } from '../ui/index.js';
 import {
   buildAdapterConfig,

package/src/ui/errors.ts

@@ -148,7 +148,7 @@ export function renderWarning(title: string, message: string, suggestions?: stri
       currentLine += (currentLine.length > 2 ? ' ' : '') + word;
     } else {
       lines.push(chalk.yellow('│') + padText(currentLine, width - 2) + chalk.yellow('│'));
-      currentLine = '  ' + word;
+      currentLine = `  ${word}`;
     }
   }
   if (currentLine.length > 2) {

package/src/ui/live-status.ts

@@ -4,9 +4,9 @@
 
 import chalk from 'chalk';
 import ora, { type Ora } from 'ora';
-import { isTTY } from './utils.js';
 import { icons } from './colors.js';
 import { renderProgressBar } from './progress.js';
+import { isTTY } from './utils.js';
 
 export type TestStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
 

package/src/ui/panels.ts

@@ -4,7 +4,7 @@
 
 import chalk from 'chalk';
 import { formatPercentage, icons } from './colors.js';
-import { isTTY, centerText, padText, formatDuration } from './utils.js';
+import { centerText, formatDuration, isTTY, padText } from './utils.js';
 
 export interface SummaryData {
   passed: number;
@@ -180,7 +180,7 @@ export function renderRedteamSummaryPanel(data: RedteamSummaryData): string {
       chalk.magenta('║'),
     chalk.magenta(`╠${border}╣`),
     chalk.magenta('║') +
-      padText(`  Defense Rate: ${defenseColor(data.defenseRate.toFixed(1) + '%')}`, width - 2) +
+      padText(`  Defense Rate: ${defenseColor(`${data.defenseRate.toFixed(1)}%`)}`, width - 2) +
       chalk.magenta('║'),
     chalk.magenta(`╚${border}╝`),
   ];

package/src/ui/progress.ts

@@ -108,7 +108,7 @@ export class ProgressBar {
     if (isTTY) {
       // Clear previous line and write new output
       const clearLength = stripAnsi(this.lastOutput).length;
-      process.stdout.write('\r' + ' '.repeat(clearLength) + '\r');
+      process.stdout.write(`\r${' '.repeat(clearLength)}\r`);
       process.stdout.write(output);
       this.lastOutput = output;
     }

package/src/ui/utils.ts

@@ -46,7 +46,8 @@ export function padText(
 
   if (align === 'center') {
     return centerText(text, width);
-  } else if (align === 'right') {
+  }
+  if (align === 'right') {
     return ' '.repeat(paddingNeeded) + text;
   }
   return text + ' '.repeat(paddingNeeded);
@@ -56,7 +57,7 @@ export function padText(
  * Strip ANSI escape codes from string (for length calculations)
  */
 export function stripAnsi(str: string): string {
-  // eslint-disable-next-line no-control-regex
+  // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape codes require control characters
   return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
 }
 
@@ -66,7 +67,7 @@ export function stripAnsi(str: string): string {
 export function truncate(text: string, maxWidth: number): string {
   const visibleLength = stripAnsi(text).length;
   if (visibleLength <= maxWidth) return text;
-  return text.slice(0, maxWidth - 1) + '…';
+  return `${text.slice(0, maxWidth - 1)}…`;
 }
 
 /**

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
+    });
+}