ai-secret-scout 2.4.2 → 2.4.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devredious
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.fr.md

@@ -9,7 +9,7 @@
        ◈  A I   S E C R E T   S C O U T  ◈
   </pre>
 
-  <h2>AI Secret Scout (<code>aiscout</code>) — v2.4.0</h2>
+  <h2>AI Secret Scout (<code>aiscout</code>) — v2.4.3</h2>
 
   <p align="center">
     <!-- Ligne 1 : badges techno & plateforme -->
@@ -178,7 +178,7 @@ Le moteur TUI autonome d'`aiscout` (pure bibliothèque standard Python) s'adapte
 ### 1. Tableau de bord & Menu d'accueil interactif (Hub central)
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
 
                  █████╗ ██╗   ███████╗ ██████╗ ██████╗ ██╗   ██╗████████╗
                 ██╔══██╗██║   ██╔════╝██╔════╝██╔═══██╗██║   ██║╚══██╔══╝
@@ -214,7 +214,7 @@ Le moteur TUI autonome d'`aiscout` (pure bibliothèque standard Python) s'adapte
 La vue tableau permet de parcourir l'intégralité des fuites identifiées avec pagination fluide, tri multi-critères et recherche plein texte instantanée :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
 
    📋 EXPLORATEUR DE SECRETS (1/21) — Mode : MASQUÉ 🛡️ │ Tri : Sévérité (🔴 > 🟡 > 🔵)
 
@@ -235,7 +235,7 @@ La vue tableau permet de parcourir l'intégralité des fuites identifiées avec
 En appuyant sur `/`, une boîte de saisie inline s'ouvre sur la barre inférieure. Le tableau se met à jour en temps réel (filtre instantané sur la catégorie, l'outil, le projet, le fichier ou la valeur du secret) :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
 
    📋 EXPLORATEUR DE SECRETS (1/3) — Mode : MASQUÉ 🛡️ │ Tri : Sévérité (🔴 > 🟡 > 🔵)
          🔍 Recherche active : "github" (3 secrets trouvés) │ [Backspace/Esc] Effacer 
@@ -255,7 +255,7 @@ En appuyant sur `/`, une boîte de saisie inline s'ouvre sur la barre inférieur
 En pressant `Entrée` sur une ligne du tableau, une fiche d'audit chirurgicale s'affiche avec le contexte exact d'usage et l'extrait de log :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
 
    ╭──────────────────────────────────────────────────────────────────────────────────╮
    │  FICHE D'AUDIT DU SECRET DÉTECTÉ                                                 │
@@ -284,7 +284,7 @@ En pressant `Entrée` sur une ligne du tableau, une fiche d'audit chirurgicale s
 Lors de l'audit initial, du caviardage ou de l'exportation des dossiers d'audit, une animation à 100ms affiche l'étape en cours et la progression :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:30
 
                  █████╗ ██╗   ███████╗ ██████╗ ██████╗ ██╗   ██╗████████╗
                 ██╔══██╗██║   ██╔════╝██╔════╝██╔═══██╗██║   ██║╚══██╔══╝
@@ -303,7 +303,7 @@ Lors de l'audit initial, du caviardage ou de l'exportation des dossiers d'audit,
   Veuillez patienter pendant l'analyse...
 ```
 
-### 🌟 Points forts du moteur TUI (v2.4.0)
+### 🌟 Points forts du moteur TUI
 * **Gestion des flèches & Entrées multiplateforme** : Décodage non bloquant (`msvcrt` sous Windows, `termios`/`tty`/`select` sous POSIX Linux/macOS) avec lookahead 100ms absorbant toutes les séquences d'échappement ANSI (`\x1b[A`, `\x1b[B`, `\x1bOA`, `\x1bOB`, consoles Linux et modificateurs Shift/Ctrl).
 * **Layout auto-adaptatif (zéro coupure)** :
   * Barre supérieure clouée à la **ligne 1**.
@@ -320,7 +320,7 @@ Lors de l'audit initial, du caviardage ou de l'exportation des dossiers d'audit,
 Le mode **Watchdog** transforme `aiscout` en un gardien silencieux en arrière-plan :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:21
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:21
 
              📡 SURVEILLANCE EN TEMPS RÉEL (WATCHDOG)  │  🟢 [VEILLE ACTIVE]
        Détecte les sessions IA en écriture et notifie instantanément sur le bureau (Linux / Windows)
@@ -351,7 +351,7 @@ Le mode **Watchdog** transforme `aiscout` en un gardien silencieux en arrière-p
 Le menu `[7]` offre un contrôle absolu sur les fichiers de sauvegarde générés lors des opérations de caviardage :
 
 ```text
- ◈ AISCOUT v2.4.0 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:22
+ ◈ AISCOUT v2.4.3 │ Utilisateur : dev_redious │ Machine : poste-travail       12/09/2026 22:22
 
              ↩️  GESTIONNAIRE DES SAUVEGARDES & RESTAURATION (.BAK)
           Restaurer les fichiers originaux avant caviardage ou purger les sauvegardes.

package/README.md

@@ -9,7 +9,7 @@
        ◈  A I   S E C R E T   S C O U T  ◈
   </pre>
 
-  <h2>AI Secret Scout (<code>aiscout</code>) — v2.4.0</h2>
+  <h2>AI Secret Scout (<code>aiscout</code>) — v2.4.3</h2>
 
   <p align="center">
     <!-- Row 1: tech & platform badges -->
@@ -178,7 +178,7 @@ The application automatically switches your terminal to an alternate screen buff
 ### 1. Central Hub & Dashboard
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
 
                  █████╗ ██╗   ███████╗ ██████╗ ██████╗ ██╗   ██╗████████╗
                 ██╔══██╗██║   ██╔════╝██╔════╝██╔═══██╗██║   ██║╚══██╔══╝
@@ -214,7 +214,7 @@ The application automatically switches your terminal to an alternate screen buff
 The interactive table allows fluid inspection of all detected secrets with multi-criteria sorting and instantaneous full-text filtering:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
 
    📋 SECRET EXPLORER (1/21) — Mode : MASKED 🛡️ │ Sort : Severity (🔴 > 🟡 > 🔵)
 
@@ -235,7 +235,7 @@ The interactive table allows fluid inspection of all detected secrets with multi
 Pressing `/` opens an inline prompt directly in the status bar. The table updates dynamically with every keystroke:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
 
    📋 SECRET EXPLORER (1/3) — Mode : MASKED 🛡️ │ Sort : Severity (🔴 > 🟡 > 🔵)
          🔍 Active filter: "github" (3 matching secrets) │ [Backspace/Esc] Clear 
@@ -255,7 +255,7 @@ Pressing `/` opens an inline prompt directly in the status bar. The table update
 Pressing `Enter` on any row displays a full diagnostic modal card highlighting the source file, context, and remediation recommendations:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
 
    ╭──────────────────────────────────────────────────────────────────────────────────╮
    │  AUDIT CARD FOR DETECTED SECRET                                                  │
@@ -284,7 +284,7 @@ Pressing `Enter` on any row displays a full diagnostic modal card highlighting t
 During scans, redactions, or reports generation, an animated 100ms spinner displays current scan phase and progress percentage:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:30
 
                  █████╗ ██╗   ███████╗ ██████╗ ██████╗ ██╗   ██╗████████╗
                 ██╔══██╗██║   ██╔════╝██╔════╝██╔═══██╗██║   ██║╚══██╔══╝
@@ -320,7 +320,7 @@ During scans, redactions, or reports generation, an animated 100ms spinner displ
 The **Watchdog** mode turns `aiscout` into a background sentinel:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:21
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:21
 
             📡 REAL-TIME MONITORING (WATCHDOG)  │  🟢 [ACTIVE SENTINEL]
         Detects active AI sessions writing to disk and sends instant desktop alerts
@@ -351,7 +351,7 @@ The **Watchdog** mode turns `aiscout` into a background sentinel:
 TUI Menu `[7]` provides complete control over backup files created prior to sanitization:
 
 ```text
- ◈ AISCOUT v2.4.0 │ User : dev_redious │ Host : workstation                12/09/2026 22:22
+ ◈ AISCOUT v2.4.3 │ User : dev_redious │ Host : workstation                12/09/2026 22:22
 
               ↩️  SAFE RESTORE & BACKUP MANAGER (.BAK)
            Restore original files before redaction or purge stale backup copies.

package/ai_secret_scout.py

@@ -41,7 +41,7 @@ else:
     import termios
     import tty
 
-VERSION = "2.4.2"
+VERSION = "2.4.3"
 
 # --- INTERNATIONALISATION (I18N) ---
 def detect_default_lang() -> str:

package/bin/aiscout.js

@@ -1,36 +1,50 @@
 #!/usr/bin/env node
 
-const { spawn } = require('child_process');
-const path = require('path');
-const { runCheck } = require('./check-environment');
+const { spawn } = require("node:child_process");
+const path = require("node:path");
+const { runCheck } = require("./check-environment");
 
 // Valide la présence et la version de Node (>=16) et Python (>=3.10)
 const pyCmd = runCheck(false);
 
-const pyScript = path.join(__dirname, '..', 'ai_secret_scout.py');
+const pyScript = path.join(__dirname, "..", "ai_secret_scout.py");
 
 const child = spawn(pyCmd, [pyScript, ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  env: process.env,
-  shell: process.platform === 'win32'
+	stdio: "inherit",
+	env: process.env,
+	shell: process.platform === "win32",
 });
 
-child.on('error', (err) => {
-  const isFr = (process.env.LANG || process.env.LC_ALL || '').toLowerCase().includes('fr');
-  if (err.code === 'ENOENT') {
-    if (isFr) {
-      console.error('❌ Erreur : Python 3 (python3) est introuvable sur votre machine.');
-      console.error('AI Secret Scout nécessite Python 3 (bibliothèque standard).');
-    } else {
-      console.error('❌ Error: Python 3 (python3) could not be found on your system.');
-      console.error('AI Secret Scout requires Python 3.10+ (standard library).');
-    }
-  } else {
-    console.error(isFr ? `❌ Erreur lors du lancement d'AI Secret Scout : ${err.message}` : `❌ Error launching AI Secret Scout: ${err.message}`);
-  }
-  process.exit(1);
+child.on("error", (err) => {
+	const isFr = (process.env.LANG || process.env.LC_ALL || "")
+		.toLowerCase()
+		.includes("fr");
+	if (err.code === "ENOENT") {
+		if (isFr) {
+			console.error(
+				"❌ Erreur : Python 3 (python3) est introuvable sur votre machine.",
+			);
+			console.error(
+				"AI Secret Scout nécessite Python 3 (bibliothèque standard).",
+			);
+		} else {
+			console.error(
+				"❌ Error: Python 3 (python3) could not be found on your system.",
+			);
+			console.error(
+				"AI Secret Scout requires Python 3.10+ (standard library).",
+			);
+		}
+	} else {
+		console.error(
+			isFr
+				? `❌ Erreur lors du lancement d'AI Secret Scout : ${err.message}`
+				: `❌ Error launching AI Secret Scout: ${err.message}`,
+		);
+	}
+	process.exit(1);
 });
 
-child.on('exit', (code) => {
-  process.exit(code ?? 0);
+child.on("exit", (code) => {
+	process.exit(code ?? 0);
 });

package/bin/check-environment.js

@@ -1,189 +1,221 @@
 #!/usr/bin/env node
 
-const { execSync } = require('child_process');
-const fs = require('fs');
+const { execSync } = require("node:child_process");
+const fs = require("node:fs");
 
 function isFrenchLocale() {
-  const envLang = (process.env.LANG || process.env.LC_ALL || process.env.LC_MESSAGES || '').toLowerCase();
-  return envLang.includes('fr');
+	const envLang = (
+		process.env.LANG ||
+		process.env.LC_ALL ||
+		process.env.LC_MESSAGES ||
+		""
+	).toLowerCase();
+	return envLang.includes("fr");
 }
 
 function checkNodeVersion() {
-  const nodeVer = process.version;
-  const major = parseInt(process.versions.node.split('.')[0], 10);
-  return {
-    ok: major >= 16,
-    version: nodeVer,
-    major
-  };
+	const nodeVer = process.version;
+	const major = parseInt(process.versions.node.split(".")[0], 10);
+	return {
+		ok: major >= 16,
+		version: nodeVer,
+		major,
+	};
 }
 
 function checkPythonVersion() {
-  const candidates = process.platform === 'win32'
-    ? ['python', 'py', 'python3']
-    : ['python3', 'python'];
-  
-  for (const cmd of candidates) {
-    try {
-      const output = execSync(`${cmd} -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}')"`, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'ignore'],
-        timeout: 3000
-      }).trim();
-      
-      const parts = output.split('.').map(n => parseInt(n, 10));
-      const major = parts[0];
-      const minor = parts[1];
-      
-      if (major === 3 && minor >= 10) {
-        return {
-          ok: true,
-          cmd,
-          version: output,
-          tooOld: false
-        };
-      } else if (major === 3 || major === 2) {
-        return {
-          ok: false,
-          cmd,
-          version: output,
-          tooOld: true
-        };
-      }
-    } catch {
-      // Ignore and try next candidate
-    }
-  }
-
-  return {
-    ok: false,
-    cmd: null,
-    version: null,
-    tooOld: false
-  };
+	const candidates =
+		process.platform === "win32"
+			? ["python", "py", "python3"]
+			: ["python3", "python"];
+
+	for (const cmd of candidates) {
+		try {
+			const output = execSync(
+				`${cmd} -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}')"`,
+				{
+					encoding: "utf-8",
+					stdio: ["pipe", "pipe", "ignore"],
+					timeout: 3000,
+				},
+			).trim();
+
+			const parts = output.split(".").map((n) => parseInt(n, 10));
+			const major = parts[0];
+			const minor = parts[1];
+
+			if (major === 3 && minor >= 10) {
+				return {
+					ok: true,
+					cmd,
+					version: output,
+					tooOld: false,
+				};
+			} else if (major === 3 || major === 2) {
+				return {
+					ok: false,
+					cmd,
+					version: output,
+					tooOld: true,
+				};
+			}
+		} catch {
+			// Ignore and try next candidate
+		}
+	}
+
+	return {
+		ok: false,
+		cmd: null,
+		version: null,
+		tooOld: false,
+	};
 }
 
 function getInstallSuggestion(isFr) {
-  if (process.platform === 'win32') {
-    if (isFr) {
-      return '👉 Sous Windows, vous pouvez installer Python 3.10+ avec winget ou depuis le site officiel :\n     winget install Python.Python.3.12\n     ou téléchargez l\'installeur : https://www.python.org/downloads/';
-    }
-    return '👉 On Windows, you can install Python 3.10+ via winget or from the official website:\n     winget install Python.Python.3.12\n     or download the installer from: https://www.python.org/downloads/';
-  }
-
-  let pkgManager = 'apt';
-  try {
-    if (fs.existsSync('/etc/os-release')) {
-      const osRelease = fs.readFileSync('/etc/os-release', 'utf-8');
-      if (/ID(_LIKE)?=.*(fedora|rhel|centos|nobara)/i.test(osRelease)) {
-        pkgManager = 'dnf';
-      } else if (/ID(_LIKE)?=.*(arch|manjaro)/i.test(osRelease)) {
-        pkgManager = 'pacman';
-      } else if (/ID(_LIKE)?=.*(suse)/i.test(osRelease)) {
-        pkgManager = 'zypper';
-      } else if (/ID(_LIKE)?=.*(alpine)/i.test(osRelease)) {
-        pkgManager = 'apk';
-      }
-    }
-  } catch {
-    // Standard fallback
-  }
-
-  const commands = {
-    dnf: 'sudo dnf install -y python3',
-    apt: 'sudo apt update && sudo apt install -y python3',
-    pacman: 'sudo pacman -S python',
-    zypper: 'sudo zypper install python3',
-    apk: 'apk add python3'
-  };
-
-  const cmd = commands[pkgManager] || 'sudo apt install python3';
-
-  if (isFr) {
-    return `👉 Commande d'installation recommandée pour votre distribution :\n     ${cmd}`;
-  }
-  return `👉 Recommended installation command for your distribution:\n     ${cmd}`;
+	if (process.platform === "win32") {
+		if (isFr) {
+			return "👉 Sous Windows, vous pouvez installer Python 3.10+ avec winget ou depuis le site officiel :\n     winget install Python.Python.3.12\n     ou téléchargez l'installeur : https://www.python.org/downloads/";
+		}
+		return "👉 On Windows, you can install Python 3.10+ via winget or from the official website:\n     winget install Python.Python.3.12\n     or download the installer from: https://www.python.org/downloads/";
+	}
+
+	let pkgManager = "apt";
+	try {
+		if (fs.existsSync("/etc/os-release")) {
+			const osRelease = fs.readFileSync("/etc/os-release", "utf-8");
+			if (/ID(_LIKE)?=.*(fedora|rhel|centos|nobara)/i.test(osRelease)) {
+				pkgManager = "dnf";
+			} else if (/ID(_LIKE)?=.*(arch|manjaro)/i.test(osRelease)) {
+				pkgManager = "pacman";
+			} else if (/ID(_LIKE)?=.*(suse)/i.test(osRelease)) {
+				pkgManager = "zypper";
+			} else if (/ID(_LIKE)?=.*(alpine)/i.test(osRelease)) {
+				pkgManager = "apk";
+			}
+		}
+	} catch {
+		// Standard fallback
+	}
+
+	const commands = {
+		dnf: "sudo dnf install -y python3",
+		apt: "sudo apt update && sudo apt install -y python3",
+		pacman: "sudo pacman -S python",
+		zypper: "sudo zypper install python3",
+		apk: "apk add python3",
+	};
+
+	const cmd = commands[pkgManager] || "sudo apt install python3";
+
+	if (isFr) {
+		return `👉 Commande d'installation recommandée pour votre distribution :\n     ${cmd}`;
+	}
+	return `👉 Recommended installation command for your distribution:\n     ${cmd}`;
 }
 
 function runCheck(isPostinstall = false) {
-  const isFr = isFrenchLocale();
-  const nodeStatus = checkNodeVersion();
-  const pyStatus = checkPythonVersion();
-
-  if (isPostinstall) {
-    // Mode postinstall lors du npm install -g
-    if (nodeStatus.ok && pyStatus.ok) {
-      console.log('\x1b[32m✔ AI Secret Scout - Environment check passed:\x1b[0m');
-      console.log(`  • Node.js : ${nodeStatus.version} (OK)`);
-      console.log(`  • Python  : ${pyStatus.version} (${pyStatus.cmd} - OK)`);
-      console.log('\x1b[36m🚀 AI Secret Scout is ready to run! Type: aiscout\x1b[0m\n');
-      return true;
-    }
-
-    if (!nodeStatus.ok) {
-      console.warn(`\x1b[33m⚠️  Warning: Node.js version ${nodeStatus.version} detected. AI Secret Scout recommends Node.js >= 16.0.0.\x1b[0m`);
-    }
-
-    if (!pyStatus.ok) {
-      console.warn('\x1b[33m──────────────────────────────────────────────────────────────────\x1b[0m');
-      if (pyStatus.tooOld) {
-        console.warn(`\x1b[33m⚠️  Warning: Python ${pyStatus.version} found via '${pyStatus.cmd}', but AI Secret Scout requires Python >= 3.10.\x1b[0m`);
-      } else {
-        console.warn('\x1b[33m⚠️  Warning: Python 3 was not detected on your system.\x1b[0m');
-      }
-      console.warn(isFr
-        ? 'AI Secret Scout nécessite Python 3.10+ pour exécuter le moteur d\'analyse TUI.'
-        : 'AI Secret Scout requires Python 3.10+ to run the core TUI security engine.'
-      );
-      console.warn(getInstallSuggestion(isFr));
-      console.warn('\x1b[33m──────────────────────────────────────────────────────────────────\x1b[0m\n');
-    }
-    return true;
-  }
-
-  // Mode runtime direct (aiscout execution)
-  if (!nodeStatus.ok) {
-    console.error(isFr
-      ? `❌ Erreur : Version de Node.js obsolète (${nodeStatus.version}). Node.js >= 16.0.0 est requis.`
-      : `❌ Error: Outdated Node.js version (${nodeStatus.version}). Node.js >= 16.0.0 is required.`
-    );
-    process.exit(1);
-  }
-
-  if (!pyStatus.ok) {
-    console.error('\x1b[31m──────────────────────────────────────────────────────────────────\x1b[0m');
-    if (pyStatus.tooOld) {
-      console.error(isFr
-        ? `❌ Version de Python trop ancienne : ${pyStatus.version} détecté (${pyStatus.cmd}).\n   AI Secret Scout requiert Python 3.10 ou supérieur.`
-        : `❌ Python version too old: ${pyStatus.version} detected (${pyStatus.cmd}).\n   AI Secret Scout requires Python 3.10 or higher.`
-      );
-    } else {
-      console.error(isFr
-        ? '❌ Python 3 (python3) est introuvable sur votre système.'
-        : '❌ Python 3 (python3) could not be found on your system.'
-      );
-    }
-    console.error('');
-    console.error(getInstallSuggestion(isFr));
-    console.error(isFr
-      ? '💡 Note : Aucun paquet pip externe n\'est requis (seule la bibliothèque standard Python est utilisée).'
-      : '💡 Note: No pip packages required (uses Python standard library only).'
-    );
-    console.error('\x1b[31m──────────────────────────────────────────────────────────────────\x1b[0m');
-    process.exit(1);
-  }
-
-  return pyStatus.cmd;
+	const isFr = isFrenchLocale();
+	const nodeStatus = checkNodeVersion();
+	const pyStatus = checkPythonVersion();
+
+	if (isPostinstall) {
+		// Mode postinstall lors du npm install -g
+		if (nodeStatus.ok && pyStatus.ok) {
+			console.log(
+				"\x1b[32m✔ AI Secret Scout - Environment check passed:\x1b[0m",
+			);
+			console.log(`  • Node.js : ${nodeStatus.version} (OK)`);
+			console.log(`  • Python  : ${pyStatus.version} (${pyStatus.cmd} - OK)`);
+			console.log(
+				"\x1b[36m🚀 AI Secret Scout is ready to run! Type: aiscout\x1b[0m\n",
+			);
+			return true;
+		}
+
+		if (!nodeStatus.ok) {
+			console.warn(
+				`\x1b[33m⚠️  Warning: Node.js version ${nodeStatus.version} detected. AI Secret Scout recommends Node.js >= 16.0.0.\x1b[0m`,
+			);
+		}
+
+		if (!pyStatus.ok) {
+			console.warn(
+				"\x1b[33m──────────────────────────────────────────────────────────────────\x1b[0m",
+			);
+			if (pyStatus.tooOld) {
+				console.warn(
+					`\x1b[33m⚠️  Warning: Python ${pyStatus.version} found via '${pyStatus.cmd}', but AI Secret Scout requires Python >= 3.10.\x1b[0m`,
+				);
+			} else {
+				console.warn(
+					"\x1b[33m⚠️  Warning: Python 3 was not detected on your system.\x1b[0m",
+				);
+			}
+			console.warn(
+				isFr
+					? "AI Secret Scout nécessite Python 3.10+ pour exécuter le moteur d'analyse TUI."
+					: "AI Secret Scout requires Python 3.10+ to run the core TUI security engine.",
+			);
+			console.warn(getInstallSuggestion(isFr));
+			console.warn(
+				"\x1b[33m──────────────────────────────────────────────────────────────────\x1b[0m\n",
+			);
+		}
+		return true;
+	}
+
+	// Mode runtime direct (aiscout execution)
+	if (!nodeStatus.ok) {
+		console.error(
+			isFr
+				? `❌ Erreur : Version de Node.js obsolète (${nodeStatus.version}). Node.js >= 16.0.0 est requis.`
+				: `❌ Error: Outdated Node.js version (${nodeStatus.version}). Node.js >= 16.0.0 is required.`,
+		);
+		process.exit(1);
+	}
+
+	if (!pyStatus.ok) {
+		console.error(
+			"\x1b[31m──────────────────────────────────────────────────────────────────\x1b[0m",
+		);
+		if (pyStatus.tooOld) {
+			console.error(
+				isFr
+					? `❌ Version de Python trop ancienne : ${pyStatus.version} détecté (${pyStatus.cmd}).\n   AI Secret Scout requiert Python 3.10 ou supérieur.`
+					: `❌ Python version too old: ${pyStatus.version} detected (${pyStatus.cmd}).\n   AI Secret Scout requires Python 3.10 or higher.`,
+			);
+		} else {
+			console.error(
+				isFr
+					? "❌ Python 3 (python3) est introuvable sur votre système."
+					: "❌ Python 3 (python3) could not be found on your system.",
+			);
+		}
+		console.error("");
+		console.error(getInstallSuggestion(isFr));
+		console.error(
+			isFr
+				? "💡 Note : Aucun paquet pip externe n'est requis (seule la bibliothèque standard Python est utilisée)."
+				: "💡 Note: No pip packages required (uses Python standard library only).",
+		);
+		console.error(
+			"\x1b[31m──────────────────────────────────────────────────────────────────\x1b[0m",
+		);
+		process.exit(1);
+	}
+
+	return pyStatus.cmd;
 }
 
 if (require.main === module) {
-  const isPostinstall = process.argv.includes('--postinstall');
-  runCheck(isPostinstall);
+	const isPostinstall = process.argv.includes("--postinstall");
+	runCheck(isPostinstall);
 }
 
 module.exports = {
-  checkNodeVersion,
-  checkPythonVersion,
-  getInstallSuggestion,
-  runCheck
+	checkNodeVersion,
+	checkPythonVersion,
+	getInstallSuggestion,
+	runCheck,
 };

package/package.json

@@ -1,41 +1,57 @@
 {
-  "name": "ai-secret-scout",
-  "version": "2.4.2",
-  "description": "Zero-dependency heuristic secret scanner & redaction tool for AI coding assistants (Claude Code, Antigravity, Codex, Copilot, Cursor)",
-  "main": "bin/aiscout.js",
-  "bin": {
-    "aiscout": "bin/aiscout.js",
-    "ai-secret-scout": "bin/aiscout.js"
-  },
-  "files": [
-    "bin",
-    "ai_secret_scout.py",
-    "README.md",
-    "README.fr.md"
-  ],
-  "scripts": {
-    "postinstall": "node ./bin/check-environment.js --postinstall",
-    "start": "node ./bin/aiscout.js"
-  },
-  "keywords": [
-    "security",
-    "secrets",
-    "scanner",
-    "redact",
-    "ai",
-    "claude",
-    "gemini",
-    "antigravity",
-    "codex",
-    "copilot",
-    "cursor",
-    "tui",
-    "cli"
-  ],
-  "author": "devredious",
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "preferGlobal": true
+	"name": "ai-secret-scout",
+	"version": "2.4.3",
+	"description": "Zero-dependency heuristic secret scanner & redaction tool for AI coding assistants (Claude Code, Antigravity, Codex, Copilot, Cursor)",
+	"homepage": "https://github.com/DevRedious/ai-secret-scout#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/DevRedious/ai-secret-scout.git"
+	},
+	"bugs": {
+		"url": "https://github.com/DevRedious/ai-secret-scout/issues"
+	},
+	"main": "bin/aiscout.js",
+	"bin": {
+		"aiscout": "bin/aiscout.js",
+		"ai-secret-scout": "bin/aiscout.js"
+	},
+	"files": [
+		"bin",
+		"ai_secret_scout.py",
+		"README.md",
+		"README.fr.md"
+	],
+	"scripts": {
+		"postinstall": "node ./bin/check-environment.js --postinstall",
+		"start": "node ./bin/aiscout.js",
+		"format": "biome format --write .",
+		"lint": "biome lint .",
+		"check": "biome check --write .",
+		"ci": "biome ci .",
+		"ci:fix": "biome check --write --unsafe ."
+	},
+	"keywords": [
+		"security",
+		"secrets",
+		"scanner",
+		"redact",
+		"ai",
+		"claude",
+		"gemini",
+		"antigravity",
+		"codex",
+		"copilot",
+		"cursor",
+		"tui",
+		"cli"
+	],
+	"author": "devredious",
+	"license": "MIT",
+	"engines": {
+		"node": ">=16.0.0"
+	},
+	"preferGlobal": true,
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.13"
+	}
 }