vanguard-cli 3.1.14 → 3.1.16

package/README.md

@@ -64,6 +64,18 @@ npm install -g vanguard-cli
 
 ## 🚀 Quick Start
 
+### 🛡️ Enable Invisible Protection
+Integrate Vanguard with your shell (Bash, Zsh, Fish, PowerShell) to automatically scan every `git clone`.
+```bash
+vanguard integrate
+```
+
+### 📊 Check Status
+Verify if the firewall is active or if you are in a protected session.
+```bash
+vanguard status
+```
+
 ### ⚙️ Configuration
 Setup your Gemini API key or local Ollama endpoint:
 ```bash

package/bin/vanguard.js

@@ -9,6 +9,10 @@ import { handlePull, handleClone } from '../lib/commands/scan.js';
 import { showBanner, showFooter } from '../lib/utils/ui.js';
 import config from '../lib/utils/config.js';
 
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
 const program = new Command();
 
 async function handleAction(actionName, logicFn) {
@@ -17,7 +21,7 @@ async function handleAction(actionName, logicFn) {
         (config.get('AI_PROVIDER') === 'ollama');
 
     if (!isConfigured) {
-        showBanner();
+        // showBanner();
         console.log(chalk.yellow(`🛡️ Vanguard V3 is not fully configured. Starting setup...\n`));
         await runConfigWizard();
         // After wizard, check again
@@ -27,7 +31,7 @@ async function handleAction(actionName, logicFn) {
         }
     }
 
-    showBanner();
+    // showBanner();
     const options = program.opts();
     config.set('VERBOSE', !!options.verbose);
 
@@ -52,7 +56,7 @@ async function handleAction(actionName, logicFn) {
 program
     .name('vanguard')
     .description('Enterprise-Grade AI Supply Chain Firewall')
-    .version('3.0.0-enterprise')
+    .version(pkg.version)
     .option('-m, --model <name>', 'Override AI model')
     .option('-v, --verbose', 'Show verbose connection logs')
     .option('--clear-cache', 'Flush local audit cache');
@@ -64,7 +68,7 @@ program
     .command('status')
     .description('Check firewall protection status')
     .action(() => {
-        showBanner();
+        // showBanner();
         const isInternal = process.env.VANGUARD_INTERNAL === '1';
         console.log(chalk.bold('🔥 Firewall Status:'));
         if (isInternal) {
@@ -94,6 +98,7 @@ program
         await handleAction('CLONE', () => handleClone(url, directory, program.opts()));
     });
 
+showBanner(pkg.version);
 program.parse(process.argv);
 
 // Default action: if no command provided, check config
@@ -103,7 +108,7 @@ if (!process.argv.slice(2).length) {
         (config.get('AI_PROVIDER') === 'ollama');
 
     if (!isConfigured) {
-        showBanner();
+        // showBanner();
         console.log(chalk.yellow(`🛡️ Vanguard V3 is not fully configured. Starting setup...\n`));
         await runConfigWizard();
     } else {

package/lib/commands/config.js

@@ -5,7 +5,7 @@ import { createSpinner } from '../utils/spinner.js';
 import { showBanner } from '../utils/ui.js';
 
 export async function runConfigWizard() {
-    showBanner();
+    // showBanner();
     console.log('🛰️  Vanguard Configuration Wizard');
     console.log(chalk.dim(`📂 Config Path: ${config.path}\n`));
 

package/lib/commands/scan.js

@@ -41,7 +41,13 @@ export async function handlePull(cmdOptions, programOptions) {
     try {
         analysis = await scanner.scan('git_diff', diff, spinner);
     } catch (err) {
-        spinner.fail(`AI Audit Failed: ${err.message}`);
+        let msg = err.message;
+        if (msg.includes('[GoogleGenerativeAI Error]')) {
+            msg = msg.split('[')[0].trim();
+            if (msg.includes('400')) msg = 'Invalid API Request (400). Check configuration.';
+            else if (msg.length > 100) msg = 'AI Service Error (Check connection/quota)';
+        }
+        spinner.fail(`AI Audit Failed: ${msg}`);
         console.log(chalk.yellow('\n💡 Tip: You might be rate-limited. Try again in 60s or run "vanguard config" to switch to local Ollama.'));
         return;
     }
@@ -125,7 +131,15 @@ export async function handleClone(url, directory, programOptions) {
                 CacheManager.save(file, content, 'SAFE');
             }
         } catch (err) {
-            scanSpinner.fail(`Audit Interrupted: ${err.message}`);
+            let msg = err.message;
+            // Clean up Google's noisy JSON error if it slipped through
+            if (msg.includes('[GoogleGenerativeAI Error]')) {
+                msg = msg.split('[')[0].trim(); // Take the first part or default to simple text
+                if (msg.includes('400')) msg = 'Invalid API Request (400). Check configuration.';
+                else if (msg.length > 100) msg = 'AI Service Error (Check connection/quota)';
+            }
+
+            scanSpinner.fail(`Audit Interrupted: ${msg}`);
             console.log(chalk.yellow('\n⚠️  Service Error. Part of the codebase remains unverified.'));
             await cleanupSandbox(tempPath);
             return;

package/lib/services/scanner.js

@@ -89,12 +89,14 @@ RESPONSE FORMAT (JSON ONLY):
         if (spinner) {
           const originalText = spinner.text;
           for (let i = waitTime; i > 0; i--) {
-            spinner.text = `❄️ Quota hit. Cooling down API (${i}s remaining)...`;
+            // Only update once per second to prevent terminal flickering
+            if (spinner.text.includes(`${i}s`)) continue;
+            spinner.text = `❄️ Quota hit (${i}s). Waiting... (Tip: Ctrl+C -> 'vanguard config' to switch AI)`;
             await sleep(1000);
           }
           spinner.text = originalText;
         } else {
-          console.log(chalk.yellow(`\n⚠️ Rate limit hit. Cooling down for ${waitTime}s (Attempt ${attempt}/${maxAttempts})...`));
+          console.log(chalk.yellow(`\n⚠️ Rate limit hit. Cooling down for ${waitTime}s... (Tip: 'vanguard config' to switch AI)`));
           await sleep(waitTime * 1000);
         }
         return this.scanWithRetry(filePath, content, spinner, attempt + 1);
@@ -110,6 +112,19 @@ RESPONSE FORMAT (JSON ONLY):
         console.log(chalk.cyan('   vanguard config  -> Select "Google Gemini"'));
       }
 
+      const isAuthError =
+        error.message.includes('API key') ||
+        error.message.includes('400') ||
+        error.message.includes('PERMISSION_DENIED');
+
+      if (isAuthError) {
+        if (spinner) spinner.fail('Authentication Failed');
+        console.log(chalk.red('\n❌ Critical: Gemini API Key is invalid, expired, or missing permissions.'));
+        console.log(chalk.yellow('👉 Run "vanguard config" to update your credentials.'));
+        // We fail closed - do not allow the scan to proceed or return 'safe'
+        process.exit(1);
+      }
+
       if (isServerErr && attempt === 1) {
         if (spinner) spinner.text = '🔄 AI Server hiccup. Retrying immediately...';
         return this.scanWithRetry(filePath, content, spinner, attempt + 1);
@@ -123,6 +138,9 @@ RESPONSE FORMAT (JSON ONLY):
     const apiKey = config.get('GEMINI_KEY');
     if (!apiKey) throw new Error('Gemini API Key missing. Run "vanguard config"');
 
+    if (!apiKey || apiKey.trim() === '') {
+      throw new Error('API key is missing.');
+    }
     const genAI = new GoogleGenerativeAI(apiKey.trim());
     // Use the latest stable pro flash model for the best performance/quota ratio
     const model = genAI.getGenerativeModel({ model: 'gemini-2.0-flash' });

package/lib/utils/ui.js

@@ -3,9 +3,10 @@ import chalk from 'chalk';
 import boxen from 'boxen';
 import ora from 'ora';
 
-export function showBanner() {
-  console.log(chalk.cyan(figlet.textSync('VANGUARD', { horizontalLayout: 'full' })));
-  console.log(chalk.dim('🛡️  Software Supply Chain Firewall | AI-Powered Security 🛡️\n'));
+export function showBanner(version) {
+  console.log(chalk.cyan(figlet.textSync('VANGUARD', { font: 'Standard', horizontalLayout: 'full' })));
+  const versionStr = version ? ` v${version}` : '';
+  console.log(chalk.dim(`🛡️  Enterprise AI Supply Chain Firewall${versionStr}\n`));
 }
 
 export function showAlert(analysis) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanguard-cli",
-  "version": "3.1.14",
+  "version": "3.1.16",
   "description": "AI-Powered Supply Chain Firewall for Git",
   "type": "module",
   "bin": {