icoa-cli 1.4.4 → 1.5.0

package/dist/index.js

@@ -37,7 +37,7 @@ ${B}                                                          ${B}
 ${B}   ${chalk.white('Sydney, Australia')}  ${chalk.gray('Jun 27 - Jul 2, 2026')}                ${B}
 ${B}   ${chalk.cyan.underline('https://icoa2026.au')}                                    ${B}
 ${B}                                                          ${B}
-${B}   ${chalk.gray('CLI-Native Competition Terminal  v1.4.4')}                ${B}
+${B}   ${chalk.gray('CLI-Native Competition Terminal  v1.5.0')}                ${B}
 ${B}                                                          ${B}
 ${chalk.cyan('╚══════════════════════════════════════════════════════════╝')}
 `;

package/dist/lib/sandbox.d.ts

@@ -0,0 +1,7 @@
+export declare function isDockerAvailable(): boolean;
+export declare function isSandboxRunning(): boolean;
+export declare function ensureSandbox(): Promise<boolean>;
+export declare function runInSandbox(command: string, rl: {
+    pause: () => void;
+    resume: () => void;
+}): Promise<void>;

package/dist/lib/sandbox.js

@@ -0,0 +1,93 @@
+import { execSync, spawn } from 'node:child_process';
+import chalk from 'chalk';
+const IMAGE = 'icoa/sandbox:2026';
+const CONTAINER = 'icoa-sandbox';
+export function isDockerAvailable() {
+    try {
+        execSync('docker info', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isSandboxRunning() {
+    try {
+        const out = execSync(`docker inspect -f '{{.State.Running}}' ${CONTAINER} 2>/dev/null`, {
+            encoding: 'utf-8',
+        });
+        return out.trim() === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensureSandbox() {
+    if (!isDockerAvailable()) {
+        console.log(chalk.yellow('  Docker not found. Install Docker Desktop to use sandbox tools.'));
+        console.log(chalk.gray('  https://www.docker.com/products/docker-desktop'));
+        return false;
+    }
+    if (isSandboxRunning())
+        return true;
+    // Check if container exists but stopped
+    try {
+        execSync(`docker start ${CONTAINER}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        // Container doesn't exist, create it
+    }
+    // Check if image exists
+    try {
+        execSync(`docker image inspect ${IMAGE}`, { stdio: 'ignore' });
+    }
+    catch {
+        console.log(chalk.gray('  Pulling sandbox image (first time only)...'));
+        try {
+            execSync(`docker pull ${IMAGE}`, { stdio: 'inherit' });
+        }
+        catch {
+            // Image not on registry yet, try building locally
+            console.log(chalk.gray('  Building sandbox from local Dockerfile...'));
+            try {
+                const dockerDir = new URL('../../docker', import.meta.url).pathname;
+                execSync(`docker build -t ${IMAGE} ${dockerDir}`, { stdio: 'inherit' });
+            }
+            catch {
+                console.log(chalk.red('  Failed to set up sandbox.'));
+                return false;
+            }
+        }
+    }
+    // Create and start container
+    try {
+        execSync(`docker run -d --name ${CONTAINER} ` +
+            `-v icoa-challenges:/home/competitor/challenges ` +
+            `--network host ` +
+            `${IMAGE} sleep infinity`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        console.log(chalk.red('  Failed to start sandbox container.'));
+        return false;
+    }
+}
+export function runInSandbox(command, rl) {
+    return new Promise((resolve) => {
+        rl.pause();
+        const opts = {
+            stdio: 'inherit',
+            shell: true,
+        };
+        const child = spawn('docker', ['exec', '-it', CONTAINER, 'bash', '-c', command], opts);
+        child.on('close', () => {
+            rl.resume();
+            resolve();
+        });
+        child.on('error', () => {
+            rl.resume();
+            resolve();
+        });
+    });
+}

package/dist/repl.js

@@ -4,6 +4,7 @@ import chalk from 'chalk';
 import { isConnected, getConfig } from './lib/config.js';
 import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, recordResume } 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 config = getConfig();
@@ -127,10 +128,21 @@ export function startRepl(program, resumeMode) {
             'lang', 'setup', 'model', 'ctf',
         ];
         if (!knownCommands.includes(cmd)) {
-            // Pass through to system shell
+            // Route to Docker sandbox if available, otherwise system shell
             processing = true;
             try {
-                await runSystemCommand(input, rl);
+                if (isDockerAvailable()) {
+                    const ready = await ensureSandbox();
+                    if (ready) {
+                        await runInSandbox(input, rl);
+                    }
+                    else {
+                        await runSystemCommand(input, rl);
+                    }
+                }
+                else {
+                    await runSystemCommand(input, rl);
+                }
             }
             catch {
                 console.log(chalk.yellow(`  Command failed: ${cmd}`));

package/package.json

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