ai-secret-scout 2.3.0 → 2.4.0

package/README.fr.md

@@ -18,7 +18,7 @@
     <img src="https://img.shields.io/badge/D%C3%A9pendances-Zero%20External-22c55e?logo=python&amp;logoColor=white" alt="Zéro Dépendance">
     <img src="https://img.shields.io/badge/Watchdog-Temps%20R%C3%A9el%20%26%20Desktop%20Alerts-F59E0B?logo=airplayaudio&amp;logoColor=white" alt="Watchdog Temps Réel">
     <img src="https://img.shields.io/badge/Safe%20Restore-Gestionnaire%20Backups-7C3AED?logo=securityscorecard&amp;logoColor=white" alt="Safe Restore">
-    <img src="https://img.shields.io/badge/Plateforme-Linux%20%7C%20WSL%20(uniquement)-E95420?logo=linux&amp;logoColor=white" alt="Linux | WSL (uniquement)">
+    <img src="https://img.shields.io/badge/Plateforme-Linux%20%7C%20Windows%20%7C%20WSL-0078D6?logo=windows&amp;logoColor=white" alt="Linux | Windows | WSL">
   </p>
 
   <p align="center">
@@ -502,13 +502,9 @@ aiscout --home-dir /home/autre_utilisateur
 
 ## 🏗️ Architecture Technique
 
-* **Langage** : Python 3.10+ standard pur (`os`, `sys`, `re`, `json`, `termios`, `tty`, `select`, `unicodedata`, `shutil`, `argparse`, `subprocess`).
-* **Zéro Dépendance Externe** : Aucun package tiers `pip`. Conçu pour la bibliothèque standard Python 3.
-* **Systèmes Supportés** : **Linux** (natif Wayland / X11) et **WSL / WSL2** sous Windows uniquement pour le moment (macOS et Windows natif non supportés).
-* **Notification System** : Détection automatique de `notify-send` pour alertes desktop natives Wayland / X11.
-* **Emplacement du code** : `/home/dev_redious/Documents/Dev/tools/ai-secret-scout/ai_secret_scout.py`
-* **Configuration** : `~/.config/aiscout/rules.json`
-* **Liens symboliques exécutables** :
-  - `~/.local/bin/aiscout`
-  - `~/.local/bin/ai-secret-scout`
+* **Langage** : Python 3.10+ standard pur (`os`, `sys`, `re`, `json`, `unicodedata`, `shutil`, `argparse`, `subprocess`, avec `msvcrt` sous Windows et `termios`/`tty`/`select` sous POSIX).
+* **Zéro Dépendance Externe** : Aucun package tiers `pip`. Conçu exclusivement avec la bibliothèque standard Python 3.
+* **Systèmes Supportés** : **Linux** (natif Wayland / X11), **Windows 10/11** (natif PowerShell, CMD, Windows Terminal) et **WSL / WSL2**.
+* **Système de Notification** : Détection automatique de `notify-send` sous Linux et toasts natifs PowerShell sous Windows.
+* **Configuration** : `~/.config/aiscout/rules.json` (ou `%APPDATA%\aiscout\rules.json` sous Windows).
 * **Confidentialité absolue** : 100% local, aucun flux réseau sortant, zéro télémétrie.

package/README.md

@@ -18,7 +18,7 @@
     <img src="https://img.shields.io/badge/Dependencies-Zero%20External-22c55e?logo=python&amp;logoColor=white" alt="Zero Dependencies">
     <img src="https://img.shields.io/badge/Watchdog-Real--Time%20%26%20Desktop%20Alerts-F59E0B?logo=airplayaudio&amp;logoColor=white" alt="Real-Time Watchdog">
     <img src="https://img.shields.io/badge/Safe%20Restore-Backup%20Manager-7C3AED?logo=securityscorecard&amp;logoColor=white" alt="Safe Restore">
-    <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20WSL%20(only)-E95420?logo=linux&amp;logoColor=white" alt="Linux | WSL (only)">
+    <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20Windows%20%7C%20WSL-0078D6?logo=windows&amp;logoColor=white" alt="Linux | Windows | WSL">
   </p>
 
   <p align="center">
@@ -107,8 +107,8 @@ When using autonomous coding assistants (**Claude Code**, **Google Antigravity /
 
 ## 🚀 Quickstart
 
-> [!IMPORTANT]
-> **Platform Support**: `aiscout` currently supports **Linux** (Wayland & X11) and **WSL / WSL2** (Windows Subsystem for Linux). Native Windows and macOS are not supported at this stage.
+> [!TIP]
+> **Cross-Platform Support**: `aiscout` runs natively on **Linux** (Wayland & X11), **Windows 10/11** (PowerShell, Command Prompt, Windows Terminal), and **WSL / WSL2**. Zero external dependencies required.
 
 `aiscout` can be executed instantly without installation or installed globally:
 
@@ -505,11 +505,11 @@ aiscout --home-dir /home/other_user
 
 ## 🏗️ Technical Architecture
 
-* **Core Engine**: Pure Python 3.10+ standard library (`os`, `sys`, `re`, `json`, `termios`, `tty`, `select`, `unicodedata`, `shutil`, `argparse`, `subprocess`).
+* **Core Engine**: Pure Python 3.10+ standard library (`os`, `sys`, `re`, `json`, `unicodedata`, `shutil`, `argparse`, `subprocess`, with `msvcrt` on Windows and `termios`/`tty`/`select` on POSIX).
 * **Zero External Dependencies**: Zero `pip` dependencies required.
-* **Supported Platforms**: **Linux** (native Wayland / X11) and **WSL / WSL2** on Windows (macOS and native Windows not supported).
-* **Notification System**: Auto-detects `notify-send` for native desktop banners on Wayland & X11.
-* **Configuration Path**: `~/.config/aiscout/rules.json`
+* **Supported Platforms**: **Linux** (native Wayland / X11), **Windows 10/11** (native PowerShell, CMD, Windows Terminal), and **WSL / WSL2**.
+* **Notification System**: Auto-detects `notify-send` on Linux and native PowerShell toast notifications on Windows.
+* **Configuration Path**: `~/.config/aiscout/rules.json` (or `%APPDATA%\aiscout\rules.json` on Windows).
 * **Zero Telemetry**: 100% local execution, zero outbound network traffic, complete privacy guarantee.
 
 ---

package/ai_secret_scout.py

@@ -16,9 +16,7 @@ import time
 import json
 import math
 import shutil
-import select
-import termios
-import tty
+import platform
 import argparse
 import subprocess
 import unicodedata
@@ -27,7 +25,23 @@ from datetime import datetime
 from collections import Counter
 from typing import List, Dict, Any, Optional, Tuple
 
-VERSION = "2.3.0"
+IS_WINDOWS = sys.platform == "win32"
+
+if IS_WINDOWS:
+    import msvcrt
+    # Active les séquences d'échappement VT100 / ANSI sous console Windows
+    os.system("")
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stdin.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+else:
+    import select
+    import termios
+    import tty
+
+VERSION = "2.4.0"
 
 # --- INTERNATIONALISATION (I18N) ---
 def detect_default_lang() -> str:
@@ -554,12 +568,15 @@ PATTERNS = {
     }
 }
 
-# --- CONFIGURATION ET RÈGLES PERSONNALISÉES (~/.config/aiscout/rules.json) ---
-CONFIG_DIR = Path.home() / ".config" / "aiscout"
+# --- CONFIGURATION ET RÈGLES PERSONNALISÉES (rules.json) ---
+if IS_WINDOWS and os.getenv("APPDATA"):
+    CONFIG_DIR = Path(os.getenv("APPDATA")) / "aiscout"
+else:
+    CONFIG_DIR = Path.home() / ".config" / "aiscout"
 CUSTOM_RULES_FILE = CONFIG_DIR / "rules.json"
 
 def load_custom_rules() -> Dict[str, Dict[str, str]]:
-    """Charge les règles personnalisées de l'utilisateur depuis ~/.config/aiscout/rules.json."""
+    """Charge les règles personnalisées de l'utilisateur depuis rules.json."""
     if not CUSTOM_RULES_FILE.exists():
         try:
             CONFIG_DIR.mkdir(parents=True, exist_ok=True)
@@ -596,7 +613,33 @@ def load_custom_rules() -> Dict[str, Dict[str, str]]:
 
 
 def send_desktop_notification(title: str, message: str, severity: str = "normal"):
-    """Envoie une notification de bureau native sous Linux / KDE Plasma Wayland."""
+    """Envoie une notification de bureau native sous Linux / KDE / GNOME ou Windows 10/11."""
+    if IS_WINDOWS:
+        clean_title = title.replace('"', '`"').replace("'", "''")
+        clean_msg = message.replace('"', '`"').replace("'", "''").replace("\n", " ")
+        ps_script = (
+            f'[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms"); '
+            f'$objNotifyIcon = New-Object System.Windows.Forms.NotifyIcon; '
+            f'$objNotifyIcon.Icon = [System.Drawing.SystemIcons]::Shield; '
+            f'$objNotifyIcon.BalloonTipIcon = "Warning"; '
+            f'$objNotifyIcon.BalloonTipTitle = "{clean_title}"; '
+            f'$objNotifyIcon.BalloonTipText = "{clean_msg}"; '
+            f'$objNotifyIcon.Visible = $True; '
+            f'$objNotifyIcon.ShowBalloonTip(5000); '
+            f'Start-Sleep -Seconds 1; '
+            f'$objNotifyIcon.Dispose()'
+        )
+        try:
+            subprocess.Popen(
+                ["powershell", "-NoProfile", "-NonInteractive", "-Command", ps_script],
+                creationflags=subprocess.CREATE_NO_WINDOW if hasattr(subprocess, "CREATE_NO_WINDOW") else 0,
+                stdout=subprocess.DEVNULL,
+                stderr=subprocess.DEVNULL
+            )
+        except Exception:
+            pass
+        return
+
     if shutil.which("notify-send"):
         urgency = "critical" if severity in ("CRITIQUE", "ÉLEVÉ") else "normal"
         try:
@@ -667,7 +710,40 @@ def display_len(s: str) -> int:
 
 
 def read_key() -> str:
-    """Lecture robuste des frappes clavier sans déconnexion intempestive sur les flèches."""
+    """Lecture robuste des frappes clavier (Linux / macOS / Windows natif)."""
+    if IS_WINDOWS:
+        while not msvcrt.kbhit():
+            time.sleep(0.02)
+        ch = msvcrt.getwch()
+        if ch in ("\x00", "\xe0"):
+            # Touche spéciale sous Windows (flèches, pagination, etc.)
+            code = msvcrt.getwch()
+            arrows = {
+                "H": "UP",
+                "P": "DOWN",
+                "K": "LEFT",
+                "M": "RIGHT",
+                "I": "PAGE_UP",
+                "Q": "PAGE_DOWN",
+                "G": "HOME",
+                "O": "END",
+                "S": "DELETE"
+            }
+            return arrows.get(code, "")
+        if ch in ("\r", "\n"):
+            return "ENTER"
+        if ch == " ":
+            return "SPACE"
+        if ch == "\t":
+            return "TAB"
+        if ch in ("\x08", "\x7f"):
+            return "BACKSPACE"
+        if ch == "\x1b":
+            return "ESC"
+        if ch == "\x03":
+            return "CTRL_C"
+        return ch
+
     fd = sys.stdin.fileno()
     old = termios.tcgetattr(fd)
     try:
@@ -813,11 +889,26 @@ class ScoutEngine:
             self.home / ".continue" / "sessions",
             self.home / ".aider.chat.history.md",
         ]
+        # Emplacements Windows spécifiques (%APPDATA% et %USERPROFILE%)
+        appdata = os.getenv("APPDATA")
+        if appdata:
+            ad = Path(appdata)
+            targets.extend([
+                ad / "Cursor" / "User" / "workspaceStorage",
+                ad / "Claude" / "projects",
+                ad / "Code" / "User" / "workspaceStorage"
+            ])
+        localappdata = os.getenv("LOCALAPPDATA")
+        if localappdata:
+            lad = Path(localappdata)
+            targets.extend([
+                lad / "Programs" / "cursor" / "resources"
+            ])
         return [p for p in targets if p.exists()]
 
     def identify_tool(self, file_path: str) -> str:
-        fp = str(file_path)
-        if ".claude" in fp:
+        fp = str(file_path).lower().replace("\\", "/")
+        if ".claude" in fp or "/claude/" in fp:
             return "Claude Code"
         elif ".gemini" in fp or "antigravity" in fp:
             return "Antigravity (Gemini)"
@@ -825,7 +916,7 @@ class ScoutEngine:
             return "Codex"
         elif ".copilot" in fp:
             return "GitHub Copilot"
-        elif ".cursor" in fp:
+        elif ".cursor" in fp or "/cursor/" in fp:
             return "Cursor"
         elif ".continue" in fp:
             return "Continue.dev"
@@ -1203,8 +1294,8 @@ class ScoutTUI:
         return " " * pad + text
 
     def build_top_bar(self, width: int) -> str:
-        user = os.getenv("USER", "user")
-        host = os.uname().nodename
+        user = os.getenv("USER") or os.getenv("USERNAME") or "user"
+        host = platform.node() or "localhost"
         date_str = datetime.now().strftime("%d/%m/%Y %H:%M")
         u_lbl = t("user_label")
         h_lbl = t("host_label")
@@ -1899,11 +1990,12 @@ class ScoutTUI:
 
     def export_markdown(self, path: Path, items: List[Finding]):
         is_fr = (get_lang() == "fr")
+        user_name = os.getenv("USER") or os.getenv("USERNAME") or "user"
         with open(path, "w", encoding="utf-8") as f:
             if is_fr:
                 f.write(f"# Rapport d'Audit de Sécurité — Transcriptions d'IA\n\n")
                 f.write(f"- **Généré le** : {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n")
-                f.write(f"- **Utilisateur** : `{os.getenv('USER')}`\n")
+                f.write(f"- **Utilisateur** : `{user_name}`\n")
                 f.write(f"- **Total secrets identifiés** : {len(items)}\n\n")
                 f.write("## Synthèse par Niveau de Sévérité\n\n")
                 f.write(f"- **Critique** : {sum(1 for x in items if x.severity in ('CRITIQUE', 'CRITICAL'))}\n")
@@ -1917,7 +2009,7 @@ class ScoutTUI:
             else:
                 f.write(f"# Security Audit Report — AI Assistant Histories\n\n")
                 f.write(f"- **Generated on** : {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n")
-                f.write(f"- **User** : `{os.getenv('USER')}`\n")
+                f.write(f"- **User** : `{user_name}`\n")
                 f.write(f"- **Total exposed secrets** : {len(items)}\n\n")
                 f.write("## Summary by Severity Level\n\n")
                 f.write(f"- **Critical** : {sum(1 for x in items if x.severity in ('CRITIQUE', 'CRITICAL'))}\n")
@@ -2147,10 +2239,12 @@ class ScoutTUI:
         scans_count = 0
         pulse = False
 
-        fd = sys.stdin.fileno()
-        old_term = termios.tcgetattr(fd)
-        try:
+        if not IS_WINDOWS:
+            fd = sys.stdin.fileno()
+            old_term = termios.tcgetattr(fd)
             tty.setraw(fd)
+
+        try:
             while True:
                 pulse = not pulse
                 width = self.get_width()
@@ -2207,11 +2301,23 @@ class ScoutTUI:
                 sys.stdout.flush()
 
                 # Attente non-bloquante d'une frappe clavier (1.0 seconde)
-                r, _, _ = select.select([fd], [], [], 1.0)
-                if r:
-                    key_bytes = os.read(fd, 32)
-                    if key_bytes in (b"q", b"Q", b"\x1b", b"\x03"):
-                        break
+                interrupted = False
+                if IS_WINDOWS:
+                    for _ in range(10):
+                        if msvcrt.kbhit():
+                            ch = msvcrt.getwch()
+                            if ch in ("q", "Q", "\x1b", "\x03"):
+                                interrupted = True
+                                break
+                        time.sleep(0.1)
+                else:
+                    r, _, _ = select.select([fd], [], [], 1.0)
+                    if r:
+                        key_bytes = os.read(fd, 32)
+                        if key_bytes in (b"q", b"Q", b"\x1b", b"\x03"):
+                            interrupted = True
+                if interrupted:
+                    break
 
                 # Analyse des répertoires pour détecter fichiers nouveaux ou modifiés
                 current_files = []
@@ -2262,7 +2368,8 @@ class ScoutTUI:
                     events_log = events_log[-50:]
 
         finally:
-            termios.tcsetattr(fd, termios.TCSADRAIN, old_term)
+            if not IS_WINDOWS:
+                termios.tcsetattr(fd, termios.TCSADRAIN, old_term)
 
 
 # --- POINT D'ENTRÉE ---

package/bin/aiscout.js

@@ -2,12 +2,17 @@
 
 const { spawn } = require('child_process');
 const path = require('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 child = spawn('python3', [pyScript, ...process.argv.slice(2)], {
+const child = spawn(pyCmd, [pyScript, ...process.argv.slice(2)], {
   stdio: 'inherit',
-  env: process.env
+  env: process.env,
+  shell: process.platform === 'win32'
 });
 
 child.on('error', (err) => {

package/bin/check-environment.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+
+function isFrenchLocale() {
+  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
+  };
+}
+
+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
+  };
+}
+
+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}`;
+}
+
+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;
+}
+
+if (require.main === module) {
+  const isPostinstall = process.argv.includes('--postinstall');
+  runCheck(isPostinstall);
+}
+
+module.exports = {
+  checkNodeVersion,
+  checkPythonVersion,
+  getInstallSuggestion,
+  runCheck
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-secret-scout",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Zero-dependency heuristic secret scanner & redaction tool for AI coding assistants (Claude Code, Antigravity, Codex, Copilot, Cursor)",
   "main": "bin/aiscout.js",
   "bin": {
@@ -14,6 +14,7 @@
     "README.fr.md"
   ],
   "scripts": {
+    "postinstall": "node ./bin/check-environment.js --postinstall",
     "start": "node ./bin/aiscout.js"
   },
   "keywords": [