icoa-cli 2.19.94 → 2.19.96

package/dist/index.js

@@ -117,10 +117,35 @@ program
     // wondering why "哪个命令..." appears as "????..." on their machine.
     const envLang = process.env.LANG || process.env.LC_ALL || process.env.LC_CTYPE || '';
     if (!/UTF-?8/i.test(envLang)) {
-        console.log(chalk.yellow('⚠ Your terminal locale is not UTF-8 (LANG=' + (envLang || '(unset)') + ').'));
-        console.log(chalk.gray('  Non-English text and box characters may display as "?" or garbled glyphs.'));
-        console.log(chalk.gray('  Fix: ') + chalk.cyan('export LANG=en_US.UTF-8') + chalk.gray(' (or your locale, e.g. ') + chalk.cyan('zh_CN.UTF-8') + chalk.gray(', ') + chalk.cyan('uk_UA.UTF-8') + chalk.gray(')'));
-        console.log();
+        if (process.platform === 'win32') {
+            // Windows cmd.exe default code page (437 US, 936 CN, etc.) mangles
+            // non-Latin script. Fix is `chcp 65001`, not Unix-style `export LANG`.
+            // Skip the warning if the code page is already 65001 (PowerShell +
+            // Windows Terminal often set it automatically).
+            let codepage = '';
+            try {
+                const { execFileSync } = await import('node:child_process');
+                codepage = execFileSync('chcp.com', [], {
+                    encoding: 'utf-8',
+                    timeout: 1500,
+                    stdio: ['ignore', 'pipe', 'ignore'],
+                }).trim();
+            }
+            catch { /* chcp.com unavailable or timed out */ }
+            if (!codepage.includes('65001')) {
+                console.log(chalk.yellow('⚠ Windows terminal is not using UTF-8 (current: ' + (codepage || 'unknown') + ').'));
+                console.log(chalk.gray('  Non-English text (Ukrainian, Chinese, Japanese, etc.) may show as "?" or garbled glyphs.'));
+                console.log(chalk.gray('  Fix (run before ') + chalk.cyan('icoa') + chalk.gray('): ') + chalk.cyan('chcp 65001'));
+                console.log(chalk.gray('  Or stay in English inside the CLI: ') + chalk.cyan('lang en'));
+                console.log();
+            }
+        }
+        else {
+            console.log(chalk.yellow('⚠ Your terminal locale is not UTF-8 (LANG=' + (envLang || '(unset)') + ').'));
+            console.log(chalk.gray('  Non-English text and box characters may display as "?" or garbled glyphs.'));
+            console.log(chalk.gray('  Fix: ') + chalk.cyan('export LANG=en_US.UTF-8') + chalk.gray(' (or your locale, e.g. ') + chalk.cyan('zh_CN.UTF-8') + chalk.gray(', ') + chalk.cyan('uk_UA.UTF-8') + chalk.gray(')'));
+            console.log();
+        }
     }
     console.log(BANNER);
     // If running interactively (no extra args or --resume), start REPL
@@ -181,4 +206,21 @@ program
         console.log();
     }
 });
+// Proctor-only escape hatch: `ICOA_RESET_STATE=1 icoa` wipes any abandoned
+// exam state *before* any subcommand or REPL runs. Fires for ALL invocations
+// (including `icoa exam <token>`) so proctors have a one-liner recovery that
+// works regardless of which subcommand the student would run next.
+// The token itself is untouched server-side.
+if (process.env.ICOA_RESET_STATE === '1') {
+    try {
+        const { clearExamState } = await import('./lib/exam-state.js');
+        clearExamState();
+        console.log(chalk.yellow('⚠ ICOA_RESET_STATE=1 — local exam state wiped.'));
+        console.log(chalk.gray('  (Token NOT revoked server-side. Re-enter a fresh token with `exam <token>`.)'));
+        console.log();
+    }
+    catch (e) {
+        console.log(chalk.red('⚠ ICOA_RESET_STATE: could not clear state — ') + chalk.gray(String(e)));
+    }
+}
 program.parse();

package/dist/repl.js

@@ -106,17 +106,29 @@ function checkPython() {
     // Probe python3.12 first — macOS Homebrew installs python@3.12 alongside a
     // newer default python3, and we don't want to flag a 3.12-ready machine just
     // because the default alias moved to 3.13.
+    // On Windows (cmd/PowerShell), the binary is `python` not `python3`, and the
+    // Python launcher `py -3` is also common. Include these so Windows K-12
+    // students don't get a spurious "Python missing" warning when Python IS
+    // installed. We also stdio: ignore stderr so cmd.exe's "not recognized as
+    // internal or external command" error doesn't leak to the user.
     const probes = [
         'python3.12 --version',
         '/opt/homebrew/opt/python@3.12/bin/python3.12 --version',
         '/usr/local/opt/python@3.12/bin/python3.12 --version',
         'python3 --version',
+        'python --version', // Windows default name
+        'py -3.12 --version', // Windows Python Launcher
+        'py -3 --version', // Windows Python Launcher (any 3.x)
     ];
     let lastVersion = '';
     let lastStatus = 'missing';
     for (const cmd of probes) {
         try {
-            const out = execSyncFn(cmd, { encoding: 'utf-8', timeout: 2000 }).trim();
+            const out = execSyncFn(cmd, {
+                encoding: 'utf-8',
+                timeout: 2000,
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
             const version = out.replace('Python ', '');
             const [maj, min] = version.split('.').map(Number);
             if (maj === 3 && min === 12)
@@ -905,6 +917,24 @@ export async function startRepl(program, resumeMode) {
                     .replace(/^python3?\s/, `${py12} `)
                     .replace(/^(python3|python)$/, py12);
             }
+            else if (process.platform === 'win32') {
+                // Windows: the binary is `python` (not `python3`). Python Launcher `py -3`
+                // is also common. Rewrite `python3 xyz` → `python xyz` or `py -3 xyz` so
+                // students who followed Unix-oriented practical-question hints don't get
+                // "'python3' is not recognized". Prefer `py -3` if the launcher exists
+                // (handles multi-version installs); fall back to plain `python`.
+                const pyCmd = (() => {
+                    try {
+                        execSyncFn('py -3 --version', { stdio: ['ignore', 'ignore', 'ignore'], timeout: 1500 });
+                        return 'py -3';
+                    }
+                    catch { }
+                    return 'python';
+                })();
+                resolvedInput = resolvedInput
+                    .replace(/^python3?(\.\d+)?\s/, `${pyCmd} `)
+                    .replace(/^python3?(\.\d+)?$/, pyCmd);
+            }
             else {
                 // Linux/WSL: python → python3 (or python3.12 if available)
                 const py12 = (() => { try {

package/package.json

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