icoa-cli 2.19.88 → 2.19.89

package/dist/index.js

@@ -98,7 +98,10 @@ async function pauseWithSkip(ms) {
 const program = new Command();
 program
     .name('icoa')
-    .version('1.2.0')
+    // T4-X2: version now reads live from package.json (PKG_VERSION).
+    // Was hardcoded to '1.2.0' which made `icoa --version` misreport on every
+    // release — bug since v1.2.0 era, finally fixed.
+    .version(PKG_VERSION)
     .description('ICOA CLI — CLI-Native CTF Competition Terminal')
     .option('--resume', 'Resume previous session')
     .action(async (opts) => {

package/dist/repl.js

@@ -426,6 +426,9 @@ 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();
         }
         else if (activated) {
@@ -440,8 +443,9 @@ 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'));
+            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('   ─────────────────────────────────────────────'));
+            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();
         }
         else {
@@ -457,7 +461,9 @@ 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();
         }
     }
@@ -971,7 +977,30 @@ export async function startRepl(program, resumeMode) {
                 // Command tried to exit — continue REPL
             }
             else if (msg.includes('commander.unknownCommand')) {
-                console.log(chalk.yellow(`  Unknown command: ${cmd}. Type 'help' for commands.`));
+                // T4-12: typo suggestion via Levenshtein distance. Shorten the
+                // "unknown command" frustration by pointing to the likely-intended
+                // command when the user's input is within 2 edits of a real one.
+                const { distance } = await import('fastest-levenshtein');
+                const KNOWN_CMDS = [
+                    'ctf', 'hint', 'hint-b', 'hint-c', 'hint-budget', 'ref', 'shell',
+                    'files', 'connect', 'note', 'log', 'lang', 'setup', 'env',
+                    'ai4ctf', 'exam', 'ctf4ai', 'tutorial',
+                    'clear', 'cls', 'quit', 'exit', 'back', 'menu', 'help',
+                    'continue', 'activate', 'demo', 'challenges', 'status', 'scoreboard',
+                    'join', 'logout',
+                ];
+                const firstWord = cmd.split(/\s+/)[0] || cmd;
+                let best = { word: '', dist: Infinity };
+                for (const known of KNOWN_CMDS) {
+                    const d = distance(firstWord.toLowerCase(), known);
+                    if (d < best.dist)
+                        best = { word: known, dist: d };
+                }
+                console.log(chalk.yellow(`  Unknown command: ${cmd}.`));
+                if (best.dist > 0 && best.dist <= 2) {
+                    console.log(chalk.gray('  Did you mean: ') + chalk.bold.cyan(best.word) + chalk.gray('?'));
+                }
+                console.log(chalk.gray('  Type ') + chalk.cyan('help') + chalk.gray(' for the full command list.'));
             }
             else if (msg.includes('commander.')) {
                 // Internal Commander errors — ignore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icoa-cli",
-  "version": "2.19.88",
+  "version": "2.19.89",
   "description": "ICOA CLI — The world's first CLI-native CTF competition terminal",
   "type": "module",
   "bin": {
@@ -32,6 +32,7 @@
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
+    "fastest-levenshtein": "^1.0.16",
     "marked": "^15.0.7",
     "marked-terminal": "^7.3.0",
     "ora": "^8.2.0"