icoa-cli 2.19.52 → 2.19.53

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.53",
   "description": "ICOA CLI — The world's first CLI-native CTF competition terminal",
   "type": "module",
   "bin": {