icoa-cli 2.19.52 → 2.19.54

package/dist/commands/exam.js

@@ -1456,8 +1456,33 @@ export function registerExamCommand(program) {
         const { getRealExamState } = await import('../lib/exam-state.js');
         const existing = getRealExamState();
         if (existing) {
-            printWarning(`Exam "${existing.session.examName}" is already in progress.`);
-            printInfo('Use "exam review" or "exam submit" first.');
+            const answered = Object.keys(existing.answers).length;
+            const total = existing.session.questionCount;
+            const existingToken = existing.session.token;
+            const deadline = getExamDeadline();
+            const remainingMin = deadline ? Math.max(0, Math.round((deadline.getTime() - Date.now()) / 60000)) : null;
+            console.log();
+            console.log(chalk.yellow(`  ⚠  An exam is already in progress on this device.`));
+            console.log();
+            console.log(chalk.gray('  Exam:    ') + chalk.white(existing.session.examName));
+            if (existingToken) {
+                console.log(chalk.gray('  Token:   ') + chalk.white(existingToken) + (existingToken === code ? chalk.green('  (same as you just typed)') : chalk.yellow('  (different from the one you typed)')));
+            }
+            console.log(chalk.gray('  Answers: ') + chalk.white(`${answered}/${total}`));
+            if (remainingMin !== null) {
+                console.log(chalk.gray('  Time:    ') + chalk.white(`${remainingMin} min remaining`));
+            }
+            console.log();
+            console.log(chalk.bold.white('  To continue this exam:'));
+            console.log(chalk.gray('    → ') + chalk.bold.cyan('exam q 1') + chalk.gray('      resume at any question'));
+            console.log(chalk.gray('    → ') + chalk.bold.cyan('exam review') + chalk.gray('   see progress + flagged items'));
+            console.log(chalk.gray('    → ') + chalk.bold.cyan('exam submit') + chalk.gray('   finish and submit'));
+            if (existingToken && existingToken !== code) {
+                console.log();
+                console.log(chalk.yellow('  Note: you typed a different token. Each exam token is bound to'));
+                console.log(chalk.yellow('  one device + one session. You cannot switch tokens mid-exam.'));
+            }
+            console.log();
             return;
         }
         // Gate: require exam setup
@@ -1465,6 +1490,7 @@ export function registerExamCommand(program) {
             console.log();
             printWarning('Pre-exam setup required before entering a token.');
             console.log(chalk.gray('  → ') + chalk.bold.cyan('exam setup'));
+            console.log(chalk.gray('  Or type ') + chalk.bold.cyan('back') + chalk.gray(' to return to the main menu.'));
             console.log();
             return;
         }
@@ -1721,6 +1747,7 @@ export function registerExamCommand(program) {
             }
             console.log();
             console.log(chalk.white('  Next step: ') + chalk.bold.cyan('exam <token>'));
+            console.log(chalk.gray('  Or type ') + chalk.bold.cyan('back') + chalk.gray(' to return to the main menu.'));
             console.log();
             return;
         }
@@ -1857,6 +1884,7 @@ export function registerExamCommand(program) {
         console.log(chalk.cyan('  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
         console.log();
         console.log(chalk.white('  Next step: ') + chalk.bold.cyan('exam <token>'));
+        console.log(chalk.gray('  Or type ') + chalk.bold.cyan('back') + chalk.gray(' to return to the main menu.'));
         console.log();
     });
     // Default action: progressive onboarding dashboard

package/dist/repl.js

@@ -413,19 +413,43 @@ export async function startRepl(program, resumeMode) {
             realExit(0);
             return;
         }
-        // "back" — return to main menu (clear exam state for demo, keep for real)
+        // "back" — return to main menu.
+        //   Real exam:       show "Exam paused", preserve state (server timer is ticking).
+        //   Active demo:     show pause message, keep state so `exam q N` can resume.
+        //   Stale demo:      auto-clear and show menu (demo from a previous session the
+        //                    user long abandoned — hanging state makes the menu lie).
+        //   Nothing:         show selection menu.
+        // A demo is "active" if `startedAt` is within the last 30 minutes. That window
+        // covers an intentional "back to check something and come right back" case but
+        // clears anything left over from a prior session.
         if (input === 'back') {
             const state = getExamState();
-            if (state) {
+            const isRealExam = state && state.session.examId !== 'demo-free';
+            const isActiveDemo = state && state.session.examId === 'demo-free' && (() => {
+                const started = new Date(state.session.startedAt || 0).getTime();
+                return Date.now() - started < 30 * 60 * 1000;
+            })();
+            if (isRealExam) {
                 console.log();
                 console.log(chalk.gray('  Exam paused. Your progress is saved.'));
                 console.log(chalk.white('  Resume: exam q 1') + chalk.gray('  ·  ') + chalk.white('exam review') + chalk.gray('  ·  ') + chalk.white('exam submit'));
                 console.log();
             }
+            else if (isActiveDemo) {
+                const answered = Object.keys(state.answers).length;
+                const total = state.session.questionCount;
+                console.log();
+                console.log(chalk.gray(`  Demo paused (${answered}/${total} answered). Resume with: `) + chalk.white(`exam q 1`));
+                console.log(chalk.gray('  Or type ') + chalk.white('demo') + chalk.gray(' to restart.'));
+                console.log();
+            }
             else {
-                // No active exam — typically this is the "post-report back" choice
-                // after the user has finished the 3-stage demo flow. Report it as a
-                // distinct event so the admin can count retry vs back decisions.
+                // Stale demo state from a past session — clear it so the menu reflects
+                // reality. Demo is free-practice, user can always restart.
+                if (state && state.session.examId === 'demo-free') {
+                    const { clearExamState } = await import('./lib/exam-state.js');
+                    clearExamState('demo-free');
+                }
                 const cfg = getConfig();
                 fetch('https://practice.icoa2026.au/api/icoa/demo-stats', {
                     method: 'POST',
@@ -437,8 +461,6 @@ export async function startRepl(program, resumeMode) {
                     }),
                     signal: AbortSignal.timeout(5000),
                 }).catch(() => { });
-                // Show the National Selection menu so the user always knows what
-                // commands are available (demo / exam setup / exam <token>).
                 if (mode === 'selection') {
                     printSelectionMenu();
                 }

package/package.json

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