icoa-cli 2.19.46 → 2.19.48

package/dist/commands/ai4ctf.js

@@ -235,7 +235,14 @@ export async function handleChatMessage(input) {
         console.log(chalk.gray(`  ${t('ai4ctfModel')}: Google Gemma 4 (gemma-4-31b-it)`));
         console.log(chalk.gray('  ─────────────────────────────────────────'));
         console.log();
-        console.log(chalk.white(`  ${t('ai4ctfNext')}`));
+        // Prominent transition to CTF4AI — same style as exam → ai4ctf handoff.
+        console.log(chalk.cyan('  ─────────────────────────────────────────────'));
+        console.log(chalk.white(`  ${t('ai4ctfExitNextTitle')} `) + chalk.bold.red('ctf4ai') + chalk.white(` — ${t('ai4ctfExitNextSub')}`));
+        console.log(chalk.gray(`  ${t('ai4ctfExitNextBody')}`));
+        console.log(chalk.cyan('  ─────────────────────────────────────────────'));
+        console.log();
+        console.log(chalk.bold.red('     ctf4ai') + chalk.gray(`          ${t('ai4ctfExitCmdNext')}`));
+        console.log(chalk.white('     back') + chalk.gray(`            ${t('ai4ctfExitCmdBack')}`));
         console.log();
         return 'exit';
     }

package/dist/commands/ctf4ai-demo.js

@@ -61,9 +61,9 @@ function printDemoReport(ctf4aiSolved, ctf4aiTokens) {
         const tmpl = n === 1 ? t('reportRetryWrongN') : t('reportRetryWrongNPlural');
         console.log(chalk.cyan('    retry') + chalk.gray(`       ${tmpl.replace('{n}', String(n))}`));
     }
+    console.log(chalk.cyan('    exam setup') + chalk.gray(`  ${t('reportExamSetupHint')}`));
     console.log(chalk.white('    back') + chalk.gray(`        ${t('reportBackHint')}`));
     console.log(chalk.white('    demo') + chalk.gray(`        ${t('reportDemo')}`));
-    console.log(chalk.white('    nations') + chalk.gray(`     ${t('reportNations')}`));
     console.log(chalk.white('    about') + chalk.gray(`       ${t('reportAboutHint')}`));
     console.log();
     console.log(chalk.yellow('  ICOA 2026 · Sydney, Australia · Jun 27 - Jul 2'));

package/dist/lib/i18n.d.ts

@@ -147,6 +147,12 @@ export declare const EN: {
     reportRetryWrongNPlural: string;
     reportBackHint: string;
     reportAboutHint: string;
+    reportExamSetupHint: string;
+    ai4ctfExitNextTitle: string;
+    ai4ctfExitNextSub: string;
+    ai4ctfExitNextBody: string;
+    ai4ctfExitCmdNext: string;
+    ai4ctfExitCmdBack: string;
     ai4ctfWelcomeCta: string;
     ai4ctfHintNudge: string;
     ai4ctfHintTechnique: string;

package/dist/lib/i18n.js

@@ -163,6 +163,13 @@ export const EN = {
     reportRetryWrongNPlural: 'retry the {n} wrong questions',
     reportBackHint: 'return to main menu',
     reportAboutHint: 'Learn more about ICOA 2026',
+    reportExamSetupHint: 'next level: prepare tools for national selection',
+    // AI4CTF exit → CTF4AI transition (v2.19.47)
+    ai4ctfExitNextTitle: 'Next:',
+    ai4ctfExitNextSub: 'Challenge the AI (Prompt Injection)',
+    ai4ctfExitNextBody: 'Can you make an AI violate its own safety rules?',
+    ai4ctfExitCmdNext: 'start the next challenge',
+    ai4ctfExitCmdBack: 'return to main menu',
     // ai4ctf welcome / CTA (v2.19.30–32)
     ai4ctfWelcomeCta: '👉 New here? Start with the hints in order:',
     ai4ctfHintNudge: 'nudge',

package/dist/repl.js

@@ -7,6 +7,9 @@ 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 { 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';
 import { resetTerminalTheme } from './lib/theme.js';
 import { ensureSandbox, runInSandbox, isDockerAvailable } from './lib/sandbox.js';
 import { logCommand } from './lib/logger.js';
@@ -32,6 +35,57 @@ const BLOCKED_COMMANDS = new Set([
 ]);
 const INTERCEPT = '__REPL_NO_EXIT__';
 const VERSION = '2.5.1';
+// National Selection main menu — shown on REPL entry and when user types `back`
+// after finishing the demo flow. Progressive onboarding per spec
+// docs/superpowers/specs/2026-04-13-exam-national-selection-design.md §4.1:
+//   State 0 (no demo yet): recommend demo, hide exam setup / exam <token>
+//   State 1 (demo done, no setup): show demo completion + setup CTA, hide token
+//   State 2 (demo done + setup done): show token entry CTA
+function printSelectionMenu() {
+    const stats = getDemoStats();
+    const setupDone = isExamSetupComplete();
+    const demoLine = `Free practice — ${DEMO_PICK_SIZE} questions (from pool of ${DEMO_POOL_SIZE})`;
+    console.log();
+    console.log('   ' + chalk.cyan.bold('[Selection Mode]'));
+    console.log();
+    if (stats.attempts === 0) {
+        // State 0: brand new user. Only demo matters right now.
+        console.log(chalk.white('   New here? Start with ') + chalk.bold.cyan('demo') + chalk.white(' — it takes a few minutes.'));
+        console.log();
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+        console.log(chalk.bold.cyan('     demo') + chalk.gray(`            ${demoLine}`));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (17 supported)'));
+        console.log(chalk.gray('                     e.g. lang es (Español), lang zh, lang fr'));
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+    }
+    else if (!setupDone) {
+        // State 1: demo done at least once, but exam environment not installed.
+        const plural = stats.attempts === 1 ? 'attempt' : 'attempts';
+        console.log(chalk.green('   ✓ Demo completed ') + chalk.gray(`(${stats.attempts} ${plural}${stats.bestPercentage > 0 ? ` · best ${stats.bestPercentage}%` : ''})`));
+        console.log(chalk.yellow('   → Next: prepare your environment for the real exam.'));
+        console.log();
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+        console.log(chalk.white('     demo') + chalk.gray(`            ${demoLine}`));
+        console.log(chalk.bold.yellow('     exam setup') + chalk.gray('      Install tools for national selection (~150MB)'));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (17 supported)'));
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+    }
+    else {
+        // State 2: fully prepared. Show the token entry CTA.
+        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();
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+        console.log(chalk.white('     demo') + chalk.gray(`            ${demoLine}`));
+        console.log(chalk.bold.yellow('     exam <token>') + chalk.gray('    Enter exam with access token'));
+        console.log(chalk.white('     exam setup') + chalk.gray('      Re-verify tool environment'));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (17 supported)'));
+        console.log(chalk.gray('   ─────────────────────────────────────────────'));
+    }
+    console.log();
+}
 export async function startRepl(program, resumeMode) {
     const config = getConfig();
     const connected = isConnected();
@@ -173,18 +227,7 @@ export async function startRepl(program, resumeMode) {
     }
     // ─── Mode-specific welcome ───
     if (mode === 'selection') {
-        const modeLabel = chalk.cyan.bold('[Selection Mode]');
-        console.log('   ' + modeLabel);
-        console.log();
-        console.log(chalk.white('   Ready to start? Just type ') + chalk.bold.cyan('demo') + chalk.white(' and press ') + chalk.yellow('Enter') + chalk.white('!'));
-        console.log();
-        console.log(chalk.gray('   ─────────────────────────────────────────────'));
-        console.log(chalk.bold.cyan('     demo') + chalk.gray('            Free practice exam (15 questions)'));
-        console.log(chalk.white('     exam <token>') + chalk.gray('    Enter exam with access token'));
-        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (15 supported)'));
-        console.log(chalk.gray('                     e.g. lang es (Español), lang zh, lang fr'));
-        console.log(chalk.gray('   ─────────────────────────────────────────────'));
-        console.log();
+        printSelectionMenu();
     }
     else if (mode === 'organizer') {
         console.log(chalk.yellow.bold('   [National/Regional Partner]'));
@@ -374,7 +417,14 @@ export async function startRepl(program, resumeMode) {
                     }),
                     signal: AbortSignal.timeout(5000),
                 }).catch(() => { });
-                console.log(chalk.gray('  Already at main menu.'));
+                // Show the National Selection menu so the user always knows what
+                // commands are available (demo / exam setup / exam <token>).
+                if (mode === 'selection') {
+                    printSelectionMenu();
+                }
+                else {
+                    console.log(chalk.gray('  Already at main menu.'));
+                }
             }
             rl.prompt();
             return;

package/package.json

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