llm-checker 3.5.14 → 3.5.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-checker",
-  "version": "3.5.14",
+  "version": "3.5.15",
   "description": "Intelligent CLI tool with AI-powered model selection that analyzes your hardware and recommends optimal LLM models for your system",
   "bin": {
     "llm-checker": "bin/cli.js",

package/src/ui/cli-theme.js

@@ -4,6 +4,7 @@ const chalk = require('chalk');
 const { execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 // Adapted from /Users/pchmirenko/Downloads/ascii-motion-cli.tsx frame model.
 const THEME_DARK = {
@@ -41,6 +42,8 @@ const FRAMES_PER_SECOND = 14;
 // Security: do not auto-load executable-style banner sources from user-writable folders.
 // External banner loading is opt-in via LLM_CHECKER_BANNER_SOURCE and supports JSON only.
 const DEFAULT_BANNER_SOURCE = null;
+// Canonical startup banner asset. Do not edit casually: treat as product identity.
+// Any intentional change should update tests/banner-canonical.test.js in the same commit.
 const BUNDLED_TEXT_BANNER_SOURCE = path.join(__dirname, 'banner-profesional-v2.txt');
 const DEFAULT_TEXT_BANNER_SOURCES = [
     BUNDLED_TEXT_BANNER_SOURCE
@@ -79,7 +82,14 @@ function sleep(ms) {
 }
 
 function clearTerminal() {
-    process.stdout.write('\x1b[2J\x1b[0f');
+    if (!process.stdout.isTTY) return;
+
+    try {
+        readline.cursorTo(process.stdout, 0, 0);
+        readline.clearScreenDown(process.stdout);
+    } catch {
+        process.stdout.write('\x1b[2J\x1b[H');
+    }
 }
 
 function parseDarkBackgroundValue(value) {

package/src/ui/interactive-panel.js

@@ -32,7 +32,14 @@ const REQUIRED_ARG_PROMPTS = {
 };
 
 function clearTerminal() {
-    process.stdout.write('\x1b[2J\x1b[0f');
+    if (!process.stdout.isTTY) return;
+
+    try {
+        readline.cursorTo(process.stdout, 0, 0);
+        readline.clearScreenDown(process.stdout);
+    } catch {
+        process.stdout.write('\x1b[2J\x1b[H');
+    }
 }
 
 function truncateText(text, maxLength) {
@@ -311,6 +318,18 @@ function renderPanel(state, catalog, primaryCommands, options = {}) {
     );
 }
 
+function shouldEnableBannerPulse({
+    isTTY = process.stdout.isTTY,
+    disableAnimation = process.env.LLM_CHECKER_DISABLE_ANIMATION,
+    forcePulse = process.env.LLM_CHECKER_FORCE_PANEL_PULSE,
+    platform = process.platform
+} = {}) {
+    if (!isTTY) return false;
+    if (disableAnimation === '1') return false;
+    if (forcePulse === '1') return true;
+    return platform !== 'win32';
+}
+
 async function collectCommandArgs(commandMeta) {
     const prompts = [];
     const requiredPrompts = REQUIRED_ARG_PROMPTS[commandMeta.name] || [];
@@ -421,9 +440,7 @@ async function launchInteractivePanel(options) {
     readline.emitKeypressEvents(process.stdin);
 
     return new Promise((resolve) => {
-        const shouldPulseBanner =
-            process.stdout.isTTY &&
-            process.env.LLM_CHECKER_DISABLE_ANIMATION !== '1';
+        const shouldPulseBanner = shouldEnableBannerPulse();
         let pulseTimer = null;
 
         const stopBannerPulse = () => {
@@ -578,6 +595,7 @@ module.exports = {
         buildCommandCatalog,
         buildPrimaryCommands,
         getVisibleCommands,
-        truncateText
+        truncateText,
+        shouldEnableBannerPulse
     }
 };