icoa-cli 1.6.0 → 1.6.1

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  v1.6.0')}
+   ${chalk.gray('CLI-Native Competition Terminal  v1.6.1')}
 
 ${LINE}
 `;

package/dist/lib/access.d.ts

@@ -1,3 +1,5 @@
+export declare function isFirstRunOrUpgrade(currentVersion: string): boolean;
+export declare function markVersionSeen(version: string): void;
 export declare function validateToken(token: string): boolean;
 export declare function isActivated(): boolean;
 export type ActivateResult = 'ok' | 'invalid' | 'already_bound';

package/dist/lib/access.js

@@ -107,6 +107,14 @@ const TOKEN_HASHES = new Set([
     "cde02309ad295648d86fa4acefdf7224809abb2ab9b025f14ae41e021512c5ed",
     "39835a1337c2afd9a9690cb9946752899a110df312d9d3aa68e10f85fad49dea",
 ]);
+// Check if first run or version upgrade
+export function isFirstRunOrUpgrade(currentVersion) {
+    const config = getConfig();
+    return config.lastVersion !== currentVersion;
+}
+export function markVersionSeen(version) {
+    saveConfig({ lastVersion: version });
+}
 // Free commands that don't require token
 const FREE_COMMANDS = new Set(['ref', 'help', 'exit', 'quit', 'q', 'clear', 'cls', 'activate']);
 function hashToken(token) {

package/dist/repl.d.ts

@@ -1,2 +1,2 @@
 import { Command } from 'commander';
-export declare function startRepl(program: Command, resumeMode: boolean): void;
+export declare function startRepl(program: Command, resumeMode: boolean): Promise<void>;

package/dist/repl.js

@@ -2,15 +2,59 @@ import { createInterface } from 'node:readline';
 import { spawn } from 'node:child_process';
 import chalk from 'chalk';
 import { isConnected, getConfig } from './lib/config.js';
-import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, recordResume } from './lib/access.js';
+import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, recordResume, isFirstRunOrUpgrade, markVersionSeen } from './lib/access.js';
 import { resetTerminalTheme } from './lib/theme.js';
 import { ensureSandbox, runInSandbox, isDockerAvailable } from './lib/sandbox.js';
 const INTERCEPT = '__REPL_NO_EXIT__';
-export function startRepl(program, resumeMode) {
+const VERSION = '1.6.1';
+export async function startRepl(program, resumeMode) {
     const config = getConfig();
     const connected = isConnected();
     const realExit = process.exit.bind(process);
     const activated = isActivated();
+    // First run or upgrade: prompt to install env
+    if (isFirstRunOrUpgrade(VERSION)) {
+        markVersionSeen(VERSION);
+        console.log(chalk.gray('   Checking competition environment...'));
+        // Quick check: count missing Python libs
+        const { execSync } = await import('node:child_process');
+        const checks = [
+            { name: 'pwntools', cmd: 'python3 -c "import pwn"' },
+            { name: 'z3-solver', cmd: 'python3 -c "import z3"' },
+            { name: 'numpy', cmd: 'python3 -c "import numpy"' },
+            { name: 'requests', cmd: 'python3 -c "import requests"' },
+        ];
+        let missing = 0;
+        for (const c of checks) {
+            try {
+                execSync(c.cmd, { stdio: 'ignore' });
+            }
+            catch {
+                missing++;
+            }
+        }
+        if (missing > 0) {
+            console.log(chalk.yellow(`   ${missing} core libraries missing.`));
+            try {
+                const { confirm } = await import('@inquirer/prompts');
+                const yes = await confirm({ message: '  Install competition Python libraries now?', default: true });
+                if (yes) {
+                    console.log();
+                    // Trigger env setup
+                    const { execSync: ex } = await import('node:child_process');
+                    ex('node ' + new URL('../index.js', import.meta.url).pathname + ' env setup', { stdio: 'inherit' });
+                }
+            }
+            catch {
+                console.log(chalk.gray('   Run ') + chalk.white('env setup') + chalk.gray(' later to install.'));
+            }
+            console.log();
+        }
+        else {
+            console.log(chalk.green('   All core libraries ready.'));
+            console.log();
+        }
+    }
     // Handle resume
     if (resumeMode) {
         const info = recordResume();

package/dist/types/index.d.ts

@@ -100,6 +100,7 @@ export interface IcoaConfig {
     geminiModel: string;
     accessToken: string;
     deviceFingerprint: string;
+    lastVersion: string;
 }
 export type CompetitionState = 'pre_competition' | 'demo' | 'live' | 'finished' | 'unknown';
 export type HintLevel = 'A' | 'B' | 'C';

package/dist/types/index.js

@@ -28,5 +28,6 @@ export const DEFAULT_CONFIG = {
     geminiModel: 'gemini-2.5-flash',
     accessToken: '',
     deviceFingerprint: '',
+    lastVersion: '',
 };
 export const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko', 'es'];

package/package.json

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