icoa-cli 2.19.90 → 2.19.92

package/dist/repl.js

@@ -179,25 +179,28 @@ function printSelectionMenu() {
         console.log(chalk.gray('   ─────────────────────────────────────────────'));
     }
     else {
-        // State 2: fully prepared. Show the token entry CTA.
+        // State 2: fully prepared. Exam entry is the primary CTA — list it FIRST
+        // and make the token format + origin obvious. Students landing here have
+        // already done demo; without a concrete example they stare at "<token>"
+        // and don't know what to type or where the token comes from.
         const plural = stats.attempts === 1 ? 'attempt' : 'attempts';
         console.log(chalk.green('   ✓ Demo completed ') + chalk.gray(`(${stats.attempts} ${plural})`));
         console.log(chalk.green('   ✓ Environment ready'));
         console.log(chalk.yellow('   → Enter your exam token to begin.'));
+        console.log(chalk.gray('     (10-char code from your organizer, starts with your country code like ') + chalk.cyan('UA') + chalk.gray(' — case-insensitive)'));
         console.log();
         console.log(chalk.gray('   ─────────────────────────────────────────────'));
+        console.log(chalk.bold.yellow('     exam <token>') + chalk.gray('    Enter exam (primary action — use your organizer-issued token)'));
+        console.log(chalk.gray('                     format: ') + chalk.white('exam UAxxxxxxxx') + chalk.gray('  (2-letter country prefix + 8 chars)'));
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+        console.log(chalk.gray('   Other commands:'));
         console.log(chalk.white('     demo') + chalk.gray(`            ${demoLine}`));
         console.log(chalk.white('     exam setup') + chalk.gray('      Re-verify tool environment'));
-        console.log(chalk.bold.yellow('     exam <token>') + chalk.gray('    Enter exam with access token'));
         console.log(chalk.white('     lang es') + chalk.gray('         Switch language (17 supported)'));
         console.log(chalk.gray('   ─────────────────────────────────────────────'));
     }
-    // Beginner-friendly safety net: make it obvious how to pause / exit / get help.
-    // This is the first place a new K-12 user lands, so the three escape hatches
-    // need to be visible without cluttering the main command list above.
     console.log(chalk.gray('   ') +
         chalk.gray('Tip: ') + chalk.cyan('help') + chalk.gray(' for commands · ') +
-        chalk.cyan('tutorial') + chalk.gray(' for 30-sec walkthrough · ') +
         chalk.cyan('Ctrl+C') + chalk.gray(' pauses · ') +
         chalk.cyan('quit') + chalk.gray(' closes'));
     console.log();
@@ -227,12 +230,10 @@ export async function startRepl(program, resumeMode) {
     // ─── Mode selection (every launch) ───
     const { select: selectMode, confirm: confirmMode } = await import('@inquirer/prompts');
     const savedMode = config.mode || '';
-    // T3-10: Mode labels clarified for K-12 newcomers who don't know the
-    // difference between "selection" and "olympiad" at first glance.
     const modeChoices = [
-        { name: `  ${chalk.bold('National Selection')}         ${chalk.gray('·')}  ${chalk.green('K-12 recommended')} ${chalk.gray('— demo, exam, lightweight')}`, value: 'selection' },
-        { name: `  ${chalk.bold('International Olympiad')}     ${chalk.gray('·')}  ${chalk.yellow('Advanced')} ${chalk.gray('— CTF x AI (~500MB)')}`, value: 'olympiad' },
-        { name: `  ${chalk.bold('National/Regional Partner')}  ${chalk.gray('·')}  ${chalk.cyan('Organizers')} ${chalk.gray('— token & competition mgmt')}`, value: 'organizer' },
+        { name: `  ${chalk.bold('National Selection')}         ${chalk.gray('—')}  ${chalk.gray('demo, exam (lightweight)')}`, value: 'selection' },
+        { name: `  ${chalk.bold('International Olympiad')}     ${chalk.gray('—')}  ${chalk.gray('CTF × AI (~500MB, advanced)')}`, value: 'olympiad' },
+        { name: `  ${chalk.bold('National/Regional Partner')}  ${chalk.gray('—')}  ${chalk.gray('organizer tools (tokens, competitions)')}`, value: 'organizer' },
         { name: `  ${chalk.gray('About ICOA')}                 ${chalk.gray('·')}  ${chalk.gray('Info & contact')}`, value: 'about' },
     ];
     console.log(chalk.gray('   Use ') + chalk.yellow('↑') + chalk.gray(' or ') + chalk.yellow('↓') + chalk.gray(' to select, ') + chalk.yellow('Enter') + chalk.gray(' to confirm.'));
@@ -426,9 +427,7 @@ export async function startRepl(program, resumeMode) {
             console.log(chalk.white('     scoreboard') + chalk.gray('     Live rankings'));
             console.log(chalk.white('     help') + chalk.gray('           Full command list'));
             console.log(chalk.gray('   ─────────────────────────────────────────────'));
-            // T4-X1: parity with Selection-mode footer — give Olympiad users the
-            // same beginner escape-hatch hint so newcomers don't get stuck.
-            console.log(chalk.gray('   Tip: ') + chalk.cyan('help') + chalk.gray(' · ') + chalk.cyan('tutorial') + chalk.gray(' 30-sec tour · ') + chalk.cyan('Ctrl+C') + chalk.gray(' pauses · ') + chalk.cyan('quit') + chalk.gray(' closes'));
+            console.log(chalk.gray('   Tip: ') + chalk.cyan('help') + chalk.gray(' · ') + chalk.cyan('Ctrl+C') + chalk.gray(' pauses · ') + chalk.cyan('quit') + chalk.gray(' closes'));
             console.log();
         }
         else if (activated) {
@@ -443,7 +442,7 @@ export async function startRepl(program, resumeMode) {
             console.log(chalk.white('   Step 2  ') + chalk.bold.cyan('challenges') + chalk.gray('   Browse & solve challenges'));
             console.log(chalk.white('   Step 3  ') + chalk.bold.cyan('hint') + chalk.gray('         Ask AI when stuck'));
             console.log();
-            console.log(chalk.gray('   Also: ') + chalk.white('env') + chalk.gray(' check tools  ') + chalk.white('help') + chalk.gray(' all commands  ') + chalk.white('tutorial') + chalk.gray(' 30-sec tour'));
+            console.log(chalk.gray('   Also: ') + chalk.white('env') + chalk.gray(' check tools  ') + chalk.white('help') + chalk.gray(' all commands'));
             console.log(chalk.gray('   ─────────────────────────────────────────────'));
             console.log(chalk.gray('   Tip: ') + chalk.cyan('Ctrl+C') + chalk.gray(' pauses · ') + chalk.cyan('exit') + chalk.gray(' → menu · ') + chalk.cyan('quit') + chalk.gray(' closes CLI'));
             console.log();
@@ -461,7 +460,6 @@ export async function startRepl(program, resumeMode) {
             console.log(chalk.white('     ref web') + chalk.gray('         Quick reference for Web'));
             console.log(chalk.white('     env') + chalk.gray('             Check your tools'));
             console.log(chalk.white('     help') + chalk.gray('            All available commands'));
-            console.log(chalk.white('     tutorial') + chalk.gray('        30-second walkthrough for first-timers'));
             console.log(chalk.gray('   ─────────────────────────────────────────────'));
             console.log(chalk.gray('   Tip: ') + chalk.cyan('Ctrl+C') + chalk.gray(' pauses · ') + chalk.cyan('exit') + chalk.gray(' → menu · ') + chalk.cyan('quit') + chalk.gray(' closes CLI'));
             console.log();

package/package.json

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