icoa-cli 2.19.67 → 2.19.69

package/dist/commands/exam.js

@@ -1898,6 +1898,52 @@ export function registerExamCommand(program) {
         console.log(chalk.gray('  Expected: 1-2 minutes · ~150MB disk'));
         console.log();
         // Step 1: Check Python 3.12+
+        const printPythonInstallGuide = (reason, currentVersion) => {
+            const platform = process.platform;
+            console.log();
+            if (reason === 'missing') {
+                printError('Python 3 not found.');
+            }
+            else {
+                printError(`Python ${currentVersion} found, but 3.12+ required for the exam.`);
+            }
+            console.log();
+            console.log(chalk.bold.white('  How to install Python 3.12:'));
+            console.log();
+            if (platform === 'darwin') {
+                console.log(chalk.yellow('  macOS (Homebrew, recommended):'));
+                console.log(chalk.green('    brew install python@3.12'));
+                console.log();
+                console.log(chalk.gray('  Or download installer:'));
+                console.log(chalk.gray('    https://www.python.org/downloads/macos/'));
+            }
+            else if (platform === 'linux') {
+                console.log(chalk.yellow('  Ubuntu / Debian (deadsnakes PPA):'));
+                console.log(chalk.green('    sudo add-apt-repository ppa:deadsnakes/ppa -y'));
+                console.log(chalk.green('    sudo apt update'));
+                console.log(chalk.green('    sudo apt install -y python3.12 python3.12-venv python3.12-distutils'));
+                console.log(chalk.gray('    sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1'));
+                console.log();
+                console.log(chalk.yellow('  Fedora / RHEL:'));
+                console.log(chalk.green('    sudo dnf install -y python3.12'));
+                console.log();
+                console.log(chalk.yellow('  Arch / Manjaro:'));
+                console.log(chalk.green('    sudo pacman -S python'));
+            }
+            else if (platform === 'win32') {
+                console.log(chalk.yellow('  Windows (winget, recommended):'));
+                console.log(chalk.green('    winget install Python.Python.3.12'));
+                console.log();
+                console.log(chalk.gray('  Or download installer:'));
+                console.log(chalk.gray('    https://www.python.org/downloads/windows/'));
+            }
+            else {
+                console.log(chalk.gray('    https://www.python.org/downloads/'));
+            }
+            console.log();
+            console.log(chalk.white('  After installing, run: ') + chalk.bold.cyan('exam setup'));
+            console.log();
+        };
         const pythonBin = 'python3';
         let pythonVersion = '';
         try {
@@ -1905,15 +1951,13 @@ export function registerExamCommand(program) {
             pythonVersion = raw.replace('Python ', '');
             const parts = pythonVersion.split('.').map(Number);
             if (parts[0] < 3 || (parts[0] === 3 && parts[1] < 12)) {
-                printError(`Python ${pythonVersion} found, but 3.12+ required.`);
-                printInfo('Install: https://www.python.org/downloads/');
+                printPythonInstallGuide('too_old', pythonVersion);
                 return;
             }
             console.log(chalk.green(`  ✓ Python ${pythonVersion}`));
         }
         catch {
-            printError('Python 3 not found.');
-            printInfo('Install: https://www.python.org/downloads/');
+            printPythonInstallGuide('missing');
             return;
         }
         // Step 2: Check pip

package/dist/repl.js

@@ -6,7 +6,7 @@ import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, r
 import { setReplMode } from './lib/ui.js';
 import { isChatActive, handleChatMessage } from './commands/ai4ctf.js';
 import { isCtf4aiActive, handleCtf4aiMessage } from './commands/ctf4ai-demo.js';
-import { getExamState } from './lib/exam-state.js';
+import { getExamState, getRealExamState, getDemoState } from './lib/exam-state.js';
 import { getDemoStats } from './lib/demo-stats.js';
 import { isExamSetupComplete } from './lib/exam-setup.js';
 import { DEMO_PICK_SIZE, DEMO_POOL_SIZE } from './lib/demo-exam.js';
@@ -17,6 +17,16 @@ import { startLogSync, stopLogSync } from './lib/log-sync.js';
 import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+// Compute the REPL prompt based on current state.
+// Real exam wins over demo (matches getExamState() priority). Chat modes have
+// their own prompts and are handled separately.
+function computePrompt() {
+    if (getRealExamState())
+        return chalk.cyan('exam> ');
+    if (getDemoState())
+        return chalk.yellow('demo> ');
+    return chalk.green('icoa> ');
+}
 // Competition workspace — all system commands restricted here
 const WORKSPACE = join(homedir(), 'icoa-workspace');
 function ensureWorkspace() {
@@ -91,6 +101,23 @@ export async function startRepl(program, resumeMode) {
     const connected = isConnected();
     const realExit = process.exit.bind(process);
     const activated = isActivated();
+    // Auto-cleanup: clear demo state once per version upgrade.
+    // Demo is free practice with no time pressure, no scoring, no real loss
+    // for users. Old versions may have left demo state in incompatible formats
+    // (pre-v2.19.45 shared state, pre-v2.19.67 timestamp confusion, etc.).
+    // Real exam state is NEVER auto-cleared — it may contain in-progress answers.
+    if (config.demoCleanedForVersion !== VERSION) {
+        try {
+            const { existsSync, unlinkSync } = await import('node:fs');
+            const { join } = await import('node:path');
+            const { getIcoaDir } = await import('./lib/config.js');
+            const demoFile = join(getIcoaDir(), 'demo-state.json');
+            if (existsSync(demoFile))
+                unlinkSync(demoFile);
+        }
+        catch { }
+        saveConfig({ demoCleanedForVersion: VERSION });
+    }
     // ─── Mode selection (every launch) ───
     const { select: selectMode, confirm: confirmMode } = await import('@inquirer/prompts');
     const savedMode = config.mode || '';
@@ -334,19 +361,29 @@ export async function startRepl(program, resumeMode) {
     const rl = createInterface({
         input: process.stdin,
         output: process.stdout,
-        prompt: chalk.green('icoa> '),
+        prompt: computePrompt(),
         terminal: true,
     });
     let processing = false;
     setReplMode(true);
     startLogSync();
+    // Wrap rl.prompt() so it always picks up current state (icoa/demo/exam mode).
+    // This keeps the prompt accurate after exam token entry, exam submit, demo finish, etc.
+    // Chat modes (ai4ctf/ctf4ai) set their own prompt via setPrompt and bypass this.
+    const _origPrompt = rl.prompt.bind(rl);
+    rl.prompt = (preserveCursor) => {
+        if (!isChatActive() && !isCtf4aiActive()) {
+            rl.setPrompt(computePrompt());
+        }
+        _origPrompt(preserveCursor);
+    };
     rl.prompt();
     rl.on('line', async (line) => {
         if (processing)
             return;
         const input = line.trim();
         if (!input) {
-            rl.setPrompt(isChatActive() ? chalk.magenta('ai4ctf> ') : chalk.green('icoa> '));
+            rl.setPrompt(isChatActive() ? chalk.magenta('ai4ctf> ') : computePrompt());
             rl.prompt();
             return;
         }
@@ -356,7 +393,7 @@ export async function startRepl(program, resumeMode) {
             const result = await handleChatMessage(input);
             processing = false;
             if (result === 'exit') {
-                rl.setPrompt(chalk.green('icoa> '));
+                rl.setPrompt(computePrompt());
             }
             rl.prompt();
             return;
@@ -367,7 +404,7 @@ export async function startRepl(program, resumeMode) {
             const result = await handleCtf4aiMessage(input);
             processing = false;
             if (result === 'exit' || result === 'solved') {
-                rl.setPrompt(chalk.green('icoa> '));
+                rl.setPrompt(computePrompt());
             }
             rl.prompt();
             return;

package/dist/types/index.d.ts

@@ -101,6 +101,7 @@ export interface IcoaConfig {
     accessToken: string;
     deviceFingerprint: string;
     lastVersion: string;
+    demoCleanedForVersion?: string;
     sessionCookie: string;
     country: string;
     mode: IcoaMode | '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icoa-cli",
-  "version": "2.19.67",
+  "version": "2.19.69",
   "description": "ICOA CLI — The world's first CLI-native CTF competition terminal",
   "type": "module",
   "bin": {