icoa-cli 2.19.66 → 2.19.68

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/lib/exam-state.d.ts

@@ -1,7 +1,7 @@
 import type { ExamState } from '../types/index.js';
-export declare function getExamState(): ExamState | null;
-export declare function getDemoState(): ExamState | null;
 export declare function getRealExamState(): ExamState | null;
+export declare function getDemoState(): ExamState | null;
+export declare function getExamState(): ExamState | null;
 export declare function saveExamState(state: ExamState): void;
 export declare function clearExamState(examId?: string): void;
 export declare function isExamActive(): boolean;

package/dist/lib/exam-state.js

@@ -12,28 +12,8 @@ function demoStateFile() {
 function resolveStateFile(examId) {
     return examId === 'demo-free' ? demoStateFile() : stateFile();
 }
-export function getExamState() {
-    // Check both files, return the most recently active one
-    const files = [stateFile(), demoStateFile()];
-    let latest = null;
-    let latestTime = 0;
-    for (const f of files) {
-        if (!existsSync(f))
-            continue;
-        try {
-            const state = JSON.parse(readFileSync(f, 'utf-8'));
-            const t = new Date(state.session.confirmedAt || state.session.startedAt).getTime();
-            if (t > latestTime) {
-                latest = state;
-                latestTime = t;
-            }
-        }
-        catch { }
-    }
-    return latest;
-}
-export function getDemoState() {
-    const f = demoStateFile();
+export function getRealExamState() {
+    const f = stateFile();
     if (!existsSync(f))
         return null;
     try {
@@ -43,8 +23,8 @@ export function getDemoState() {
         return null;
     }
 }
-export function getRealExamState() {
-    const f = stateFile();
+export function getDemoState() {
+    const f = demoStateFile();
     if (!existsSync(f))
         return null;
     try {
@@ -54,6 +34,18 @@ export function getRealExamState() {
         return null;
     }
 }
+export function getExamState() {
+    // Real exam ALWAYS takes priority over demo when both exist.
+    // Reasoning: real exam is token-gated, has a timer, and represents a serious
+    // commitment. Demo is casual practice. If a real exam is in progress, all
+    // shared commands (exam q N, exam answer, ai4ctf, ctf4ai) must target the
+    // real exam — never silently fall back to demo questions, even if demo was
+    // run more recently. (Demo→Exam→Finals progression principle, exam.md §0)
+    const real = getRealExamState();
+    if (real)
+        return real;
+    return getDemoState();
+}
 export function saveExamState(state) {
     const f = resolveStateFile(state.session.examId);
     writeFileSync(f, JSON.stringify(state, null, 2));

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() {
@@ -334,19 +344,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 +376,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 +387,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/package.json

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