icoa-cli 2.19.53 → 2.19.55

package/dist/commands/exam.js

@@ -1453,11 +1453,54 @@ export function registerExamCommand(program) {
         .description('Enter exam with access token (no login needed)')
         .action(async (code) => {
         logCommand(`exam token ${code}`);
-        const { getRealExamState } = await import('../lib/exam-state.js');
+        const { getRealExamState, saveExamState: saveExamStateFn } = 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 existingToken = existing.session.token;
+            // Migration path: pre-v2.19.55 sessions didn't persist the token on
+            // state. Those sessions can't use `lang` or submit via the new token
+            // path. If the user re-types the matching token, attach it so the
+            // session can reach the server again. Device binding on the server
+            // means only the original token holder can do this.
+            if (!existingToken && code) {
+                existing.session.token = code.trim();
+                saveExamStateFn(existing);
+                console.log();
+                console.log(chalk.green('  ✓ Token re-attached to your in-progress exam.'));
+                console.log(chalk.gray('    You can now use: ') + chalk.white('lang <code>') + chalk.gray(' · ') + chalk.white('exam submit'));
+                console.log();
+                console.log(chalk.bold.white('  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();
+                return;
+            }
+            const answered = Object.keys(existing.answers).length;
+            const total = existing.session.questionCount;
+            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 +1508,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;
         }
@@ -1545,6 +1589,11 @@ export function registerExamCommand(program) {
             // ── Timer starts NOW ──
             const confirmedAt = new Date().toISOString();
             session.confirmedAt = confirmedAt;
+            // Store the token on session so lang switching, exam submit, and
+            // resume can reach the server without re-prompting. Device binding
+            // means the token alone is useless on another machine, so keeping
+            // it in exam-state.json is safe.
+            session.token = code.trim();
             saveExamState({ session, questions, answers: {}, interactions: [], aiUsage: { ai4ctf: 0, ctf4ai: 0 } });
             console.log();
             printSuccess('Exam started! Timer is running.');
@@ -1721,6 +1770,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 +1907,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/package.json

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