icoa-cli 2.19.91 → 2.19.93

package/dist/index.js

@@ -15,7 +15,6 @@ import { registerEnvCommand } from './commands/env.js';
 import { registerAi4ctfCommand } from './commands/ai4ctf.js';
 import { registerExamCommand } from './commands/exam.js';
 import { registerCtf4aiDemoCommand } from './commands/ctf4ai-demo.js';
-import { registerTutorialCommand } from './commands/tutorial.js';
 import { registerThemeCommand } from './commands/theme.js';
 import { getConfig, saveConfig } from './lib/config.js';
 import { startRepl } from './repl.js';
@@ -149,7 +148,6 @@ registerEnvCommand(program);
 registerAi4ctfCommand(program);
 registerExamCommand(program);
 registerCtf4aiDemoCommand(program);
-registerTutorialCommand(program);
 registerThemeCommand(program);
 // Hidden command: switch AI model
 program

package/dist/repl.js

@@ -162,8 +162,8 @@ function printSelectionMenu() {
         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.white('     lang') + chalk.gray('            List all supported languages'));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (e.g. lang es, lang zh, lang fr)'));
         console.log(chalk.gray('   ─────────────────────────────────────────────'));
     }
     else if (!setupDone) {
@@ -175,7 +175,8 @@ function printSelectionMenu() {
         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.white('     lang') + chalk.gray('            List all supported languages'));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (e.g. lang es, lang zh, lang fr)'));
         console.log(chalk.gray('   ─────────────────────────────────────────────'));
     }
     else {
@@ -196,15 +197,12 @@ function printSelectionMenu() {
         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.white('     lang es') + chalk.gray('         Switch language (17 supported)'));
+        console.log(chalk.white('     lang') + chalk.gray('            List all supported languages'));
+        console.log(chalk.white('     lang es') + chalk.gray('         Switch language (e.g. lang es, lang zh, lang fr)'));
         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();
@@ -234,12 +232,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.'));
@@ -433,9 +429,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) {
@@ -450,7 +444,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();
@@ -468,7 +462,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();
@@ -991,7 +984,7 @@ export async function startRepl(program, resumeMode) {
                 const KNOWN_CMDS = [
                     'ctf', 'hint', 'hint-b', 'hint-c', 'hint-budget', 'ref', 'shell',
                     'files', 'connect', 'note', 'log', 'lang', 'setup', 'env',
-                    'ai4ctf', 'exam', 'ctf4ai', 'tutorial', 'theme',
+                    'ai4ctf', 'exam', 'ctf4ai', 'theme',
                     'clear', 'cls', 'quit', 'exit', 'back', 'menu', 'help',
                     'continue', 'activate', 'demo', 'challenges', 'status', 'scoreboard',
                     'join', 'logout',

package/package.json

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

package/dist/commands/tutorial.d.ts

@@ -1,12 +0,0 @@
-/**
- * `tutorial` command — a 30-second interactive walk-through for K-12 beginners
- * who have never used a command-line tool before. Explains the 4 core
- * mechanics of ICOA CLI: typing commands, answering questions, getting help,
- * and exiting safely. No real exam state touched — pure narration + press-Enter.
- *
- * Triggered by: typing `tutorial` at the REPL prompt.
- * Advertised in: printSelectionMenu tip footer and help listings.
- */
-import { Command } from 'commander';
-export declare function runTutorial(): Promise<void>;
-export declare function registerTutorialCommand(program: Command): void;

package/dist/commands/tutorial.js

@@ -1,127 +0,0 @@
-/**
- * `tutorial` command — a 30-second interactive walk-through for K-12 beginners
- * who have never used a command-line tool before. Explains the 4 core
- * mechanics of ICOA CLI: typing commands, answering questions, getting help,
- * and exiting safely. No real exam state touched — pure narration + press-Enter.
- *
- * Triggered by: typing `tutorial` at the REPL prompt.
- * Advertised in: printSelectionMenu tip footer and help listings.
- */
-import chalk from 'chalk';
-function waitForEnter(promptText = '  Press Enter to continue... ') {
-    // Raw-stdin read (matches pattern used by exam start + demo confirm).
-    // A second readline on process.stdin fights the parent REPL, so we read
-    // raw bytes and resolve on \n or \r.
-    return new Promise((resolve) => {
-        process.stdout.write(chalk.bold.yellow(promptText));
-        const wasRaw = process.stdin.isTTY ? process.stdin.isRaw : false;
-        if (process.stdin.isTTY && process.stdin.setRawMode) {
-            process.stdin.setRawMode(false);
-        }
-        const onData = (chunk) => {
-            const s = chunk.toString();
-            if (s.includes('\n') || s.includes('\r')) {
-                process.stdin.removeListener('data', onData);
-                if (process.stdin.isTTY && process.stdin.setRawMode) {
-                    process.stdin.setRawMode(wasRaw);
-                }
-                process.stdout.write('\n');
-                resolve();
-            }
-        };
-        process.stdin.on('data', onData);
-        process.stdin.resume();
-    });
-}
-function divider() {
-    console.log(chalk.gray('   ─────────────────────────────────────────────'));
-}
-function screenHeader(n, total, title) {
-    console.log();
-    console.log(chalk.cyan(`   ─── Step ${n} / ${total} · ${title} ───`));
-    console.log();
-}
-export async function runTutorial() {
-    console.log();
-    console.log(chalk.bold.green('   📚  ICOA CLI — 30-Second Tutorial'));
-    console.log(chalk.gray('   Never used a command-line before? You\'ll be fine. 4 steps total.'));
-    console.log();
-    await waitForEnter();
-    // ─── Step 1 ───────────────────────────────────────────────────────
-    screenHeader(1, 4, 'Typing commands');
-    console.log(chalk.white('   The CLI waits for you to ') + chalk.bold('type a command and press Enter') + chalk.white('.'));
-    console.log();
-    console.log(chalk.gray('   For example, when you see the prompt:'));
-    console.log();
-    console.log('      ' + chalk.cyan('icoa> '));
-    console.log();
-    console.log(chalk.gray('   You type a word like ') + chalk.cyan('help') + chalk.gray(' or ') + chalk.cyan('demo') + chalk.gray(' and press Enter.'));
-    console.log(chalk.gray('   If you type something wrong, nothing bad happens — try again.'));
-    console.log();
-    await waitForEnter();
-    // ─── Step 2 ───────────────────────────────────────────────────────
-    screenHeader(2, 4, 'Answering questions');
-    console.log(chalk.white('   Multiple-choice questions show 4 options (A / B / C / D).'));
-    console.log(chalk.gray('   Example:'));
-    console.log();
-    divider();
-    console.log(chalk.white('     Q1. Which command shows the current directory?'));
-    console.log(chalk.gray('       A) cd     B) pwd     C) ls     D) dir'));
-    divider();
-    console.log();
-    console.log(chalk.gray('   To answer, type: ') + chalk.cyan('exam answer 1 B') + chalk.gray('  (question number + letter)'));
-    console.log(chalk.gray('   Or the shortcut:  ') + chalk.cyan('B') + chalk.gray('                 (letter alone on the current question)'));
-    console.log();
-    console.log(chalk.gray('   After you answer, the CLI auto-saves — you won\'t lose work if you exit.'));
-    console.log();
-    await waitForEnter();
-    // ─── Step 3 ───────────────────────────────────────────────────────
-    screenHeader(3, 4, 'Getting help when stuck');
-    console.log(chalk.white('   Stuck? Several ways to get help, from gentlest to most revealing:'));
-    console.log();
-    console.log('   ' + chalk.cyan('help') + chalk.gray('        — list all available commands'));
-    console.log('   ' + chalk.cyan('help        ') + chalk.gray('(or ') + chalk.cyan('?') + chalk.gray(')  — same, shorter to type'));
-    console.log('   ' + chalk.cyan('ref grep') + chalk.gray('    — quick reference for a specific tool'));
-    console.log();
-    console.log(chalk.white('   Inside a question:'));
-    console.log('   ' + chalk.cyan('help') + chalk.gray('        — eliminate one wrong multiple-choice option'));
-    console.log('   ' + chalk.cyan('hint a') + chalk.gray('      — general direction (practical questions only)'));
-    console.log('   ' + chalk.cyan('hint b') + chalk.gray('      — specific technique'));
-    console.log('   ' + chalk.cyan('hint c') + chalk.gray('      — near-solution (masked, 50% revealed)'));
-    console.log();
-    console.log(chalk.gray('   The exam has a budget for each — using one doesn\'t end the question.'));
-    console.log();
-    await waitForEnter();
-    // ─── Step 4 ───────────────────────────────────────────────────────
-    screenHeader(4, 4, 'Exiting & pausing safely');
-    console.log(chalk.white('   Three escape hatches, each with a different meaning:'));
-    console.log();
-    console.log('   ' + chalk.cyan('back') + chalk.gray(' or ') + chalk.cyan('menu') + chalk.gray('   — return to the main menu; exam stays saved, timer keeps running'));
-    console.log('   ' + chalk.cyan('exit') + chalk.gray('           — same as back (from any prompt)'));
-    console.log('   ' + chalk.cyan('quit') + chalk.gray('           — close the CLI entirely; next time use ') + chalk.cyan('icoa --resume'));
-    console.log('   ' + chalk.cyan('Ctrl+C') + chalk.gray('         — pause + show where you are (no data loss)'));
-    console.log();
-    console.log(chalk.gray('   Closing your terminal window is also safe — your answers are on disk.'));
-    console.log();
-    await waitForEnter();
-    // ─── Final ────────────────────────────────────────────────────────
-    console.log();
-    console.log(chalk.bold.green('   ✨  That\'s it. You\'re ready.'));
-    console.log();
-    console.log(chalk.white('   Try next:'));
-    console.log('     ' + chalk.cyan('demo') + chalk.gray('            — free practice (10 questions, no timer)'));
-    console.log('     ' + chalk.cyan('exam <token>') + chalk.gray('    — real exam (when you have an organizer-issued token)'));
-    console.log('     ' + chalk.cyan('lang es') + chalk.gray('         — switch UI language (17 supported)'));
-    console.log('     ' + chalk.cyan('theme high-contrast') + chalk.gray(' — low-vision-friendly colors (restart after)'));
-    console.log();
-    console.log(chalk.gray('   Full beginner guide: ') + chalk.cyan.underline('https://github.com/newaipanda/ICOA_CLI/blob/main/docs/getting-started-k12.md'));
-    console.log();
-}
-export function registerTutorialCommand(program) {
-    program
-        .command('tutorial')
-        .description('30-second walk-through for first-time CLI users')
-        .action(async () => {
-        await runTutorial();
-    });
-}