icoa-cli 2.1.1 → 2.1.3

package/dist/index.js

@@ -36,7 +36,7 @@ ${LINE}
    ${chalk.white('Sydney, Australia')}  ${chalk.gray('Jun 27 - Jul 2, 2026')}
    ${chalk.cyan.underline('https://icoa2026.au')}
 
-   ${chalk.gray('CLI-Native Competition Terminal  v2.1.1')}
+   ${chalk.gray('CLI-Native Competition Terminal  v2.1.3')}
 
 ${LINE}
 `;

package/dist/repl.js

@@ -1,5 +1,5 @@
 import { createInterface } from 'node:readline';
-import { spawn } from 'node:child_process';
+import { spawn, execSync as execSyncFn } from 'node:child_process';
 import chalk from 'chalk';
 import { isConnected, getConfig } from './lib/config.js';
 import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, recordResume, isFirstRunOrUpgrade, markVersionSeen } from './lib/access.js';
@@ -27,7 +27,7 @@ const BLOCKED_COMMANDS = new Set([
     'iptables', 'ufw', // firewall
 ]);
 const INTERCEPT = '__REPL_NO_EXIT__';
-const VERSION = '2.1.1';
+const VERSION = '2.1.3';
 export async function startRepl(program, resumeMode) {
     const config = getConfig();
     const connected = isConnected();
@@ -221,7 +221,7 @@ export async function startRepl(program, resumeMode) {
                 rl.prompt();
                 return;
             }
-            // Force Python 3.12 — rewrite python3/python to 3.12 binaries
+            // Force Python 3.12 — rewrite python/python3 to correct binary
             let resolvedInput = input;
             if (process.platform === 'darwin') {
                 const py12 = '/opt/homebrew/opt/python@3.12/bin/python3.12';
@@ -229,6 +229,19 @@ export async function startRepl(program, resumeMode) {
                     .replace(/^python3?\s/, `${py12} `)
                     .replace(/^(python3|python)$/, py12);
             }
+            else {
+                // Linux/WSL: python → python3 (or python3.12 if available)
+                const py12 = (() => { try {
+                    execSyncFn('which python3.12', { stdio: 'ignore' });
+                    return 'python3.12';
+                }
+                catch {
+                    return 'python3';
+                } })();
+                resolvedInput = resolvedInput
+                    .replace(/^python\s/, `${py12} `)
+                    .replace(/^python$/, py12);
+            }
             // Ensure workspace directory
             const cwd = ensureWorkspace();
             // Route to Docker sandbox if available, otherwise system shell (in workspace)

package/package.json

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

package/refs/hint.txt

@@ -21,8 +21,14 @@ LEVELS
     - No flags
     - Requires confirmation before use
 
+COMMANDS
+  hint <question>        Level A hint
+  hint-b <question>      Level B hint
+  hint-c <question>      Level C hint (requires confirmation)
+  hint budget            Check remaining budget
+
 USAGE TIPS
-  1. Open a challenge first: icoa ctf open <id>
+  1. Open a challenge first: open <id>
      This sets context for better hints.
 
   2. Be specific in your question:
@@ -33,7 +39,7 @@ USAGE TIPS
   3. Start with Level A — it's cheap (50 uses).
      Only escalate to B/C when A isn't enough.
 
-  4. Check your budget: icoa hint budget
+  4. Check your budget: hint budget
 
 TOKEN CAP
   All AI usage shares a 50,000 token cap.

package/refs/icoa.txt

@@ -1,36 +1,58 @@
-ICOA CLI — Quick Reference
-==========================
-
-COMPETITION COMMANDS
-  icoa ctf join <url>          Connect to CTFd instance
-  icoa ctf activate <code>     Validate competition code
-  icoa ctf challenges          List all challenges
-  icoa ctf open <id>           View challenge details
-  icoa ctf submit <id> <flag>  Submit a flag
-  icoa ctf scoreboard          View scoreboard / rankings
-  icoa ctf status              Show hint budget, score, rank, time
-  icoa ctf time                Competition countdown timer
-
-AI HINT SYSTEM
-  icoa hint <question>         Level A — General guidance (50 uses)
-  icoa hint-b <question>       Level B — Deep analysis (10 uses)
-  icoa hint-c <question>       Level C — Critical assist (2 uses)
-  icoa hint budget             Show remaining hint budget
-
-TOOLS & FILES
-  icoa shell                   Open Docker sandbox environment
-  icoa ref <topic>             Quick reference (this system)
-  icoa files <id>              Download challenge files
-  icoa connect <id>            Connect to remote target
-  icoa note <text>             Add personal note
-  icoa log                     View session history
-
-LANGUAGE
-  icoa lang <code>             Switch language (en/zh/ja/ko/es)
+ICOA CLI v2 — Quick Reference
+==============================
+
+GETTING STARTED
+  activate <token>       Unlock with your access token
+  join <url>             Connect to CTFd competition
+  env                    Check tool environment (109 commands)
+  env setup              One-click install all tools
+  help                   Show all commands
+
+COMPETITION
+  challenges (ch)        List all challenges
+  open <id>              View challenge details
+  submit <id> <flag>     Submit a flag
+  scoreboard (sb)        View rankings
+  status                 Hint budget, score, rank, time
+  time                   Competition countdown
+
+AI HINTS
+  hint <question>        Level A — General guidance (50 uses)
+  hint-b <question>      Level B — Deep analysis (10 uses)
+  hint-c <question>      Level C — Critical assist (2 uses)
+  hint budget            Show remaining budget
+
+TOOLS
+  ref <topic>            Quick reference (38 topics)
+  files <id>             Download challenge files
+  connect <id>           Connect to remote target
+  note <text>            Personal notepad
+  log                    Session history
+  log stats              Session statistics
+  log export             Export audit trail (JSON)
+
+SYSTEM COMMANDS
+  python solve.py        Run Python (forced to 3.12.13)
+  nano solve.py          Edit files
+  gcc -o pwn pwn.c       Compile code
+  Any Linux command      Runs in ~/icoa-workspace/
+
+SETTINGS
+  setup                  Configure API keys
+  lang <code>            Switch language (en/zh/ja/ko/es)
+  clear                  Clear screen
+  exit                   Save session & quit
+
+SHORTCUTS
+  ch = challenges
+  sb = scoreboard
+  flag = submit
 
 TIPS
-  - Use 'icoa ctf open <id>' before 'icoa hint' to set challenge context
-  - Level A hints are cheap — use them freely for direction
+  - Use 'open <id>' before 'hint' to set challenge context
+  - Level A hints are cheap — use freely for direction
   - Level C hints require confirmation — use wisely
-  - All prompts are logged automatically
-  - Use 'icoa ref <topic>' for zero-cost tool references
+  - All commands are logged for audit
+  - python/python3 always uses Python 3.12.13
+  - System commands run in ~/icoa-workspace/ (sandboxed)
+  - Use 'ref <topic>' for zero-cost tool references